Metadata-Version: 2.4
Name: agentops-cockpit
Version: 2.0.6
Summary: Production-grade Agent Operations (AgentOps) Platform
Project-URL: Homepage, https://github.com/enriquekalven/agent-ops-cockpit
Project-URL: Bug Tracker, https://github.com/enriquekalven/agent-ops-cockpit/issues
Author-email: Enrique <enriquekalven@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: agent-starter-pack>=0.34.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: chromadb>=0.5.0
Requires-Dist: crewai>=1.0.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: google-adk>=1.24.0
Requires-Dist: langchain>=0.2.0
Requires-Dist: langgraph>=1.0.8
Requires-Dist: langsmith>=0.7.0
Requires-Dist: libcst>=1.1.0
Requires-Dist: llama-index>=0.14.0
Requires-Dist: mcp>=0.1.0
Requires-Dist: ollama>=0.1.7
Requires-Dist: packaging>=23.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: pytest-asyncio>=0.23.0
Requires-Dist: pytest>=8.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tenacity>=8.0.0
Requires-Dist: typer>=0.9.0
Requires-Dist: uvicorn>=0.20.0
Provides-Extra: eval
Requires-Dist: google-adk[eval]>=1.24.0; extra == 'eval'
Provides-Extra: lint
Requires-Dist: codespell>=2.2.0; extra == 'lint'
Requires-Dist: ruff>=0.1.0; extra == 'lint'
Requires-Dist: ty>=0.0.1; extra == 'lint'
Description-Content-Type: text/markdown

# 🕹️ AgentOps Cockpit (v2.0.4 Sovereign Evolution)

<div align="center">
  <img src="public/assets/trinity_v2.png" alt="AgentOps Cockpit Trinity" width="100%" />
</div>

<div align="center">
  <br />
  <a href="https://agent-cockpit.web.app" target="_blank"><strong>🌐 Official Website & Live Demo</strong></a>
  <br /><br />
  <a href="https://deploy.cloud.google.com?repo=https://github.com/enriquekalven/agent-cockpit">
    <img src="https://deploy.cloud.google.com/button.svg" alt="Deploy to Google Cloud" />
  </a>
  <br />
  <br />
  <img src="https://img.shields.io/github/stars/enriquekalven/agent-cockpit?style=for-the-badge&color=ffd700" alt="GitHub Stars" />
  <img src="https://img.shields.io/github/license/enriquekalven/agent-cockpit?style=for-the-badge&color=007bff" alt="License" />
  <img src="https://img.shields.io/badge/Sovereign-v2.0.4-10b981?style=for-the-badge" alt="Sovereign v2.0.4" />
  <img src="https://img.shields.io/badge/A2A_Standard-Enabled-10b981?style=for-the-badge" alt="A2A Standard" />
</div>

<br />

<div align="center">
  <h3>"Infrastructure gives you the pipes. We give you the Intelligence."</h3>
  <p>The developer distribution for building, governing, and scaling Sovereign AI agents.</p>
</div>

---

## 🚀 The Sovereign Mission
Most AI templates stop at a single Python script. **The AgentOps Cockpit** is for developers moving into production. It provides framework-agnostic governance, multi-cloud mobility, and real-time security for the entire agentic ecosystem.

- **🏛️ The Governing Board**: Every repository is audited by a panel of [**Principal SME Personas**](docs/TECHNICAL_AUDIT_GUIDE.md) (SecOps, FinOps, SRE, Architect) using **SME Reasoning**.
- **🌉 Sovereign Bridge**: Multi-cloud orchestration layer for GCP, AWS, and Azure.
- **The Cockpit**: Python CLI, **Sovereign Gateway**, Semantic Caching, Red Team Eval.
- **Integrations**: [LangChain](/docs/LANGCHAIN_INTEGRATION.md), CrewAI, LangGraph.
- **Deployment**: Firebase Hosting (Face), Google Cloud Run / GKE (Engine/Cockpit).
- **🕹️ Agentic Trinity 2.0**: Specialized layers for the **Engine** (Logic), **Face** (UX), and **Cockpit** (Ops).

---

## ⚡ Quick Start: One Command to Rule Them All

The Cockpit is designed for high-velocity fleet management. If you are overwhelmed by the options, just remember **one command**:

```bash
# 🕹️ Master Audit: Launch the Governing Board & Personal SME Review
ops report
```

### 🏹 The Sovereign Workflow
1. **Explore**: `cockpit` (Launch the Mission Control Dashboard)
2. **Audit**: `ops report` (Deep SME Reasoning Review)
3. **Remediate**: `make apply-fixes` (Autonomous code hardening via the **Closer Engine**)
4. **Deploy**: `ops deploy sovereign` (Multi-cloud Factory Deployment)

## 🗺️ Project Roadmap
- [x] **v2.0.4**: Sovereign Lifecycle (Certification, Blast Radius Guard, LangChain Integration).
- [ ] **v2.0.5**: Collaborative Governance (Multi-Persona Benchmarking, MCP Hub v2).

---

## 🏗️ The Agentic Trinity
We divide the complexity of production agents into three focused pillars:

```mermaid
graph TD
   subgraph Trinity [The Agentic Trinity 2.0]
       E(The Engine: Reasoning)
       F(The Face: Interface)
       C(The Cockpit: Operations)
       S{Sovereignty & Compliance}
   end
   E <--> C
   F <--> C
   E <--> F
   E -.-> S
   F -.-> S
   C -.-> S
   style Trinity fill:#f8fafc,stroke:#334155,stroke-width:2px
   style S fill:#10b981,color:#fff,stroke:#059669
```

- **⚙️ The Engine**: The reasoning core. Built with **ADK**, FastAPI, and Vertex AI.
- **🎭 The Face**: The user experience. [Sovereign UX (A2UI)](docs/TECHNICAL_UX_GUIDE.md) and rich GenUI standards.
- **🕹️ The Cockpit**: The operational brain. [Cost control (FinOps)](docs/TECHNICAL_FINOPS_GUIDE.md), semantic caching, and [adversarial audits (Red Team)](docs/TECHNICAL_REDTEAM_GUIDE.md).

---

## 🏛️ v2.0.2: The "Sovereign Evolution" Release
Evolving into the industry standard for production governance. See the [**CHNGELOG.md**](/CHANGELOG.md).

- **🛡️ Sovereign Gateway**: Real-time PII scrubbing and [**Sovereign Security**](docs/TECHNICAL_REDTEAM_GUIDE.md).
- **🌉 Sovereign Bridge**: Multi-cloud deployment to GCP, AWS, and Azure.
- **🧠 Semantic Hive Mind**: Distributed caching that reduces LLM costs by up to 40%.
- **🖇️ A2A Evidence Packets**: Cryptographically signed reasoning traces for multi-agent trust.
- **🔧 Closer Engine 2.0**: Autonomous remediation of code gaps and architectural debt.

---

## 🏛️ Multi-Persona Governance Board
The Cockpit allows you to view your codebase through the lens of a Principal Engineer:
*   [**🏛️ Architecture**](docs/TECHNICAL_ARCH_REVIEW.md)
*   [**⚖️ Compliance**](docs/TECHNICAL_COMPLIANCE_GUIDE.md)
*   [**💰 FinOps**](docs/TECHNICAL_FINOPS_GUIDE.md)
*   [**🛡️ Red Team**](docs/TECHNICAL_REDTEAM_GUIDE.md)
*   [**🧗 Quality**](docs/TECHNICAL_QUALITY_GUIDE.md)
*   [**🌐 SRE & Infra**](docs/TECHNICAL_INFRA_GUIDE.md)
*   [**🎭 UX (A2UI)**](docs/TECHNICAL_UX_GUIDE.md)

---

## 🛡️ Privacy & Telemetry
The AgentOps Cockpit follows a **Privacy-First, Sovereign Standard**. 

By default, the CLI sends anonymous operational metrics (e.g., command names, OS type) to help us understand fleet health. **We do not collect PII, code snippets, secrets, or folder paths.**

### 🌑 How to Opt-Out
Disable telemetry by setting:
```bash
export AGENTOPS_TELEMETRY_ENABLED=false
```
Or update your `cockpit.yaml`:
```yaml
telemetry:
  enabled: false
```

---

## 🤝 Ecosystem & Attribution
The AgentOps Cockpit leverages and secures the best-of-breed tools in the ecosystem:

*   **[Google ADK](https://github.com/GoogleCloudPlatform/agent-starter-pack/)**: Core reference for agent patterns.
*   **[A2UI Protocol](https://github.com/GoogleCloudPlatform/agent-starter-pack/tree/main/src/a2ui)**: Standardized Generative UI handshake.
*   **[A2A Standard](https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/A2A_GUIDE.md)**: Agent-to-Agent Transmission Protocol.
*   **[Model Context Protocol (MCP)](https://modelcontextprotocol.io)**: Unified tool execution standard.
*   **[Vertex AI SDK](https://cloud.google.com/vertex-ai/docs/python-sdk)**: Backbone for frontier reasoning.
*   **[Firebase](https://firebase.google.com/)**: Enterprise hosting for the **Face** layer.

---
*Generated by the AgentOps Cockpit. Sovereign Systems Division (v2.0.4 Evolution).*
