agentops-cockpit 0.3.0__tar.gz → 0.4.1__tar.gz

agentops_cockpit-0.4.1/A2A_GUIDE.md

@@ -0,0 +1,58 @@
+# 📡 Agent-to-Agent (A2A) Transmission Standard
+
+Building a single agent is easy. Building a **Swarm** of agents that communicate securely and efficiently is the next frontier of AgentOps. The Cockpit implements the **A2A Transmission Standard** to ensure that your "Agent Trinity" remains Well-Architected.
+
+## 🏛️ The A2A Protocol Stack
+
+| Layer | Responsibility | Protocol / Spec |
+| :--- | :--- | :--- |
+| **Surface** | Human-Agent Interaction | [A2UI Spec](/docs/a2ui) |
+| **Memory** | Cross-Agent Knowledge | [Vector Workspace (Hive Mind)](/src/backend/cache) |
+| **Logic** | Tool & Reasoning Handshake | [A2P Handshake](#a2p-handshake) |
+| **Security** | Identity & Permissions | [GCP Workload Identity](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity) |
+
+---
+
+## 🤝 The A2P Handshake (Agent-to-Proxy)
+
+When one agent calls another tool, it shouldn't just send raw text. It must send a **Reasoning Evidence Packet**.
+
+### ❌ The "Old" Way (Brittle)
+```json
+{
+  "query": "What is the budget?",
+  "output": "The budget is $500k."
+}
+```
+
+### ✅ The "Cockpit" Way (Well-Architected)
+```json
+{
+  "trace_id": "tr-9942-x",
+  "reasoning_path": ["Fetch Schema", "Query BigQuery", "Apply PIIScrubber"],
+  "evidence": [
+    { "source": "bq://finance.budget_2026", "assurance_score": 0.98 }
+  ],
+  "content": {
+    "text": "The approved budget is $500k.",
+    "a2ui_surface": "DynamicBudgetChart"
+  }
+}
+```
+
+## 🛡️ Governance-as-Code for Swarms
+
+On the Cockpit, every A2A transmission is automatically:
+1.  **Scrubbed**: PII is removed before leaving the Engine's VPC.
+2.  **Cached**: Similar cross-agent queries hit the **Hive Mind** instead of expensive LLM reasoning.
+3.  **Audited**: The `arch-review` tool verifies that your multi-agent graph doesn't have "Shadow Loops" (recursive infinite spend).
+
+---
+
+## ⚡ Get Started with A2A
+Use the Cockpit CLI to verify your multi-agent communication:
+```bash
+agent-ops audit --mode swarm --file multi_agent_entry.py
+```
+
+*This standard is being proposed to the Google Well-Architected Framework for AI Agents committee.*

agentops_cockpit-0.4.1/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: agentops-cockpit
+Version: 0.4.1
+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 <enrique@example.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: gitpython>=3.1.0
+Requires-Dist: mcp>=0.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# 🕹️ AgentOps Cockpit
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/enriquekalven/agent-cockpit/main/public/og-image.png" alt="AgentOps Cockpit Social Preview" 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/Google-Well--Architected-4285F4?style=for-the-badge&logo=google-cloud" alt="Google Well-Architected" />
+  <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, optimizing, and securing AI agents on Google Cloud.</p>
+</div>
+
+---
+
+## 📽️ The Mission
+Most AI agent templates stop at a single Python file and an API key. **The AgentOps Cockpit** is for developers moving into production. It provides framework-agnostic governance, safety, and cost guardrails for the entire agentic ecosystem.
+
+### Key Pillars:
+- **Governance-as-Code**: Audit your agent against [Google Well-Architected](/docs/google-architecture) best practices.
+- **Agentic Trinity**: Dedicated layers for the Engine (Logic), Face (UX), and Cockpit (Ops).
+- **A2A Connectivity**: Implements the [Agent-to-Agent Transmission Standard](/A2A_GUIDE.md) for secure swarm orchestration.
+
+---
+
+## 🏗️ The Agentic Trinity
+We divide the complexity of production agents into three focused pillars:
+
+- **⚙️ The Engine**: The reasoning core. Built with **ADK**, FastAPI, and Vertex AI.
+- **🎭 The Face**: The user experience. Adaptive UI surfaces and **GenUI** standards via the A2UI spec.
+- **🕹️ The Cockpit**: The operational brain. Cost control, semantic caching, shadow routing, and adversarial audits.
+
+---
+
+## 🌐 Framework Agnostic Governance
+The Cockpit isn't just for ADK. It provides **Best Practices as Code** across all major agentic frameworks:
+
+<div align="center">
+  <img src="https://img.shields.io/badge/OpenAI_Agentkit-412991?style=for-the-badge&logo=openai" alt="OpenAI Agentkit" />
+  <img src="https://img.shields.io/badge/Anthropic_Claude-D97757?style=for-the-badge&logo=anthropic" alt="Anthropic" />
+  <img src="https://img.shields.io/badge/Microsoft_AutoGen-0078d4?style=for-the-badge&logo=microsoft" alt="Microsoft" />
+  <img src="https://img.shields.io/badge/AWS_Bedrock-FF9900?style=for-the-badge&logo=amazon-aws" alt="AWS" />
+  <img src="https://img.shields.io/badge/CopilotKit.ai-6366f1?style=for-the-badge" alt="CopilotKit" />
+  <img src="https://img.shields.io/badge/LangChain-1C3C3C?style=for-the-badge" alt="LangChain" />
+  <img src="https://img.shields.io/badge/ADK-4285F4?style=for-the-badge&logo=google-cloud" alt="ADK" />
+</div>
+
+<div align="center">
+  <img src="https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python" />
+  <img src="https://img.shields.io/badge/Go-00ADD8?style=flat-square&logo=go&logoColor=white" alt="Go" />
+  <img src="https://img.shields.io/badge/NodeJS-339933?style=flat-square&logo=node.js&logoColor=white" alt="NodeJS" />
+  <img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" />
+  <img src="https://img.shields.io/badge/Streamlit-FF4B4B?style=flat-square&logo=streamlit&logoColor=white" alt="Streamlit" />
+  <img src="https://img.shields.io/badge/Angular-DD0031?style=flat-square&logo=angular&logoColor=white" alt="Angular" />
+  <img src="https://img.shields.io/badge/Lit-324FFF?style=flat-square&logo=lit&logoColor=white" alt="Lit" />
+</div>
+
+Whether you are building a swarm in **CrewAI**, a Go-based high-perf engine, or a **Streamlit** dashboard, the Cockpit ensures your agent maps to the **Google Well-Architected Framework**.
+
+
+---
+
+## 🚀 Key Innovation: The "Intelligence" Layer
+
+### 🛡️ Red Team Auditor (Self-Hacking)
+Don't wait for your users to find prompt injections. Use the built-in Adversarial Evaluator to launch self-attacks against your agent, testing for PII leaks, instruction overrides, and safety filter bypasses.
+
+### 🧠 Hive Mind (Semantic Caching)
+**Reduce LLM costs by up to 40%.** The Hive Mind checks for semantically similar queries in 10ms, serving cached answers for common questions without calling the LLM.
+
+### 🏛️ Arch Review & Framework Detection
+Every agent in the cockpit is graded against a framework-aware checklist. The Cockpit intelligently detects your stack—**Google ADK**, **OpenAI Agentkit**, **Anthropic Claude**, **Microsoft AutoGen/Semantic Kernel**, **AWS Bedrock Agents**, or **CopilotKit**—and runs a tailored audit against corresponding production standards. Use `make arch-review` to verify your **Governance-as-Code**.
+
+### 🕹️ MCP Connectivity Hub (Model Context Protocol)
+Stop building one-off tool integrations. The Cockpit provides a unified hub for **MCP Servers**. Connect to Google Search, Slack, or your internal databases via the standardized Model Context Protocol for secure, audited tool execution.
+
+### 🧗 Quality Hill Climbing (ADK Evaluation)
+Following **Google ADK Evaluation** best practices, the Cockpit provides an iterative optimization loop. `make quality-baseline` runs your agent against a "Golden Dataset" using **LLM-as-a-Judge** scoring (Response Match & Tool Trajectory), climbing the quality curve until production-grade fidelity is reached.
+
+---
+
+## ⌨️ Quick Start
+
+The Cockpit is available as a first-class CLI on PyPI. 
+
+```bash
+# 1. Install the Cockpit globally
+pip install agentops-cockpit
+
+# 2. Audit your existing agent design
+agent-ops arch-review
+
+# 3. Stress test your endpoint
+agent-ops load-test --requests 100 --concurrency 10
+
+# 4. Scaffold a new Well-Architected app
+agent-ops create my-agent --ui a2ui
+```
+
+You can also use `uvx` for one-off commands without installation:
+```bash
+uvx agentops-cockpit arch-review
+```
+
+---
+
+## 📊 Local Development
+The Cockpit provides a unified "Mission Control" to evaluate your agents instantly.
+
+```bash
+make audit-all         # 🕹️ Run ALL audits and generate a Final Report
+make reliability       # 🛡️ Run unit tests and regression suite
+make dev               # Start the local Engine + Face stack
+make arch-review   # 🏛️ Run the Google Well-Architected design review
+make quality-baseline # 🧗 Run iterative 'Hill Climbing' quality audit
+make audit         # 🔍 Run the Interactive Agent Optimizer
+make red-team      # Execute a white-hat security audit
+make deploy-prod   # 🚀 1-click deploy to Google Cloud
+```
+
+---
+
+## 🧭 Roadmap
+- [x] **One-Click GitHub Action**: Automated governance audits on every PR.
+- [x] **Multi-Agent Orchestrator**: Standardized A2A Swarm/Coordinator patterns.
+- [ ] **Visual Mission Control**: Real-time cockpit observability dashboard.
+
+[View full roadmap →](/ROADMAP.md)
+
+---
+
+## 🤝 Community
+- **Star this repo** to help us build the future of AgentOps.
+- **Join the Discussion** for patterns on Google Cloud.
+- **Contribute**: Read our [Contributing Guide](/CONTRIBUTING.md).
+
+---
+*Reference: [Google Cloud Architecture Center - Agentic AI Overview](https://docs.cloud.google.com/architecture/agentic-ai-overview)*

{agentops_cockpit-0.3.0 → agentops_cockpit-0.4.1}/README.md

@@ -1,10 +1,22 @@
 # 🕹️ AgentOps Cockpit
 
 <div align="center">
+  <img src="https://raw.githubusercontent.com/enriquekalven/agent-cockpit/main/public/og-image.png" alt="AgentOps Cockpit Social Preview" 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/Google-Well--Architected-4285F4?style=for-the-badge&logo=google-cloud" alt="Google Well-Architected" />
-  <img src="https://img.shields.io/badge/Status-Day%202%20Operations-10b981?style=for-the-badge" alt="Status" />
+  <img src="https://img.shields.io/badge/A2A_Standard-Enabled-10b981?style=for-the-badge" alt="A2A Standard" />
 </div>
 
 <br />
@@ -17,7 +29,12 @@
 ---
 
 ## 📽️ The Mission
-Most AI agent templates stop at a single Python file and an API key. **The AgentOps Cockpit** is for developers moving into production. While optimized for **ADK**, it provides framework-agnostic governance, safety, and cost guardrails for the entire agentic ecosystem—from CrewAI to LangGraph. Based on the **[Google Well-Architected Framework for Agents](/docs/google-architecture)**.
+Most AI agent templates stop at a single Python file and an API key. **The AgentOps Cockpit** is for developers moving into production. It provides framework-agnostic governance, safety, and cost guardrails for the entire agentic ecosystem.
+
+### Key Pillars:
+- **Governance-as-Code**: Audit your agent against [Google Well-Architected](/docs/google-architecture) best practices.
+- **Agentic Trinity**: Dedicated layers for the Engine (Logic), Face (UX), and Cockpit (Ops).
+- **A2A Connectivity**: Implements the [Agent-to-Agent Transmission Standard](/A2A_GUIDE.md) for secure swarm orchestration.
 
 ---
 
@@ -69,6 +86,9 @@ Don't wait for your users to find prompt injections. Use the built-in Adversaria
 ### 🏛️ Arch Review & Framework Detection
 Every agent in the cockpit is graded against a framework-aware checklist. The Cockpit intelligently detects your stack—**Google ADK**, **OpenAI Agentkit**, **Anthropic Claude**, **Microsoft AutoGen/Semantic Kernel**, **AWS Bedrock Agents**, or **CopilotKit**—and runs a tailored audit against corresponding production standards. Use `make arch-review` to verify your **Governance-as-Code**.
 
+### 🕹️ MCP Connectivity Hub (Model Context Protocol)
+Stop building one-off tool integrations. The Cockpit provides a unified hub for **MCP Servers**. Connect to Google Search, Slack, or your internal databases via the standardized Model Context Protocol for secure, audited tool execution.
+
 ### 🧗 Quality Hill Climbing (ADK Evaluation)
 Following **Google ADK Evaluation** best practices, the Cockpit provides an iterative optimization loop. `make quality-baseline` runs your agent against a "Golden Dataset" using **LLM-as-a-Judge** scoring (Response Match & Tool Trajectory), climbing the quality curve until production-grade fidelity is reached.
 
@@ -116,9 +136,9 @@ make deploy-prod   # 🚀 1-click deploy to Google Cloud
 ---
 
 ## 🧭 Roadmap
-- [ ] **One-Click GitHub Action**: Automated audits on every PR.
-- [ ] **Multi-Agent Orchestrator**: Support for Swarm/Coordinator patterns.
-- [ ] **Visual Mission Control**: Real-time observability dashboard.
+- [x] **One-Click GitHub Action**: Automated governance audits on every PR.
+- [x] **Multi-Agent Orchestrator**: Standardized A2A Swarm/Coordinator patterns.
+- [ ] **Visual Mission Control**: Real-time cockpit observability dashboard.
 
 [View full roadmap →](/ROADMAP.md)
 

agentops_cockpit-0.4.1/public/A2A_GUIDE.md

@@ -0,0 +1,58 @@
+# 📡 Agent-to-Agent (A2A) Transmission Standard
+
+Building a single agent is easy. Building a **Swarm** of agents that communicate securely and efficiently is the next frontier of AgentOps. The Cockpit implements the **A2A Transmission Standard** to ensure that your "Agent Trinity" remains Well-Architected.
+
+## 🏛️ The A2A Protocol Stack
+
+| Layer | Responsibility | Protocol / Spec |
+| :--- | :--- | :--- |
+| **Surface** | Human-Agent Interaction | [A2UI Spec](/docs/a2ui) |
+| **Memory** | Cross-Agent Knowledge | [Vector Workspace (Hive Mind)](/src/backend/cache) |
+| **Logic** | Tool & Reasoning Handshake | [A2P Handshake](#a2p-handshake) |
+| **Security** | Identity & Permissions | [GCP Workload Identity](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity) |
+
+---
+
+## 🤝 The A2P Handshake (Agent-to-Proxy)
+
+When one agent calls another tool, it shouldn't just send raw text. It must send a **Reasoning Evidence Packet**.
+
+### ❌ The "Old" Way (Brittle)
+```json
+{
+  "query": "What is the budget?",
+  "output": "The budget is $500k."
+}
+```
+
+### ✅ The "Cockpit" Way (Well-Architected)
+```json
+{
+  "trace_id": "tr-9942-x",
+  "reasoning_path": ["Fetch Schema", "Query BigQuery", "Apply PIIScrubber"],
+  "evidence": [
+    { "source": "bq://finance.budget_2026", "assurance_score": 0.98 }
+  ],
+  "content": {
+    "text": "The approved budget is $500k.",
+    "a2ui_surface": "DynamicBudgetChart"
+  }
+}
+```
+
+## 🛡️ Governance-as-Code for Swarms
+
+On the Cockpit, every A2A transmission is automatically:
+1.  **Scrubbed**: PII is removed before leaving the Engine's VPC.
+2.  **Cached**: Similar cross-agent queries hit the **Hive Mind** instead of expensive LLM reasoning.
+3.  **Audited**: The `arch-review` tool verifies that your multi-agent graph doesn't have "Shadow Loops" (recursive infinite spend).
+
+---
+
+## ⚡ Get Started with A2A
+Use the Cockpit CLI to verify your multi-agent communication:
+```bash
+agent-ops audit --mode swarm --file multi_agent_entry.py
+```
+
+*This standard is being proposed to the Google Well-Architected Framework for AI Agents committee.*

agentops_cockpit-0.4.1/public/BE_INTEGRATION_GUIDE.md

@@ -0,0 +1,35 @@
+# ⚙️ Engine Integration: The Day 0 Brain
+
+The **Engine** is the reasoning core of your Agentic Stack. We use **FastAPI** and Google’s **Agent Development Kit (ADK)** to build agents that are fast, tool-capable, and "Well-Architected."
+
+## 🧩 Middleware Components
+The Engine comes pre-installed with the **Cockpit Middleware Stack**:
+
+1. **`CostOptimizer`**: Real-time token tracking and savings recommendations.
+2. **`PIIScrubber`**: Automatic masking of sensitive user data.
+3. **`SemanticCache`**: Integrated with the "Hive Mind" for 40%+ cost reduction.
+4. **`MemoryOptimizer`**: Automates context truncation and summarization.
+
+## 🛠️ Tool Orchestration (ADK)
+We recommend building your tools as **MCP (Model Context Protocol)** or **ADK Extensions**. This ensures that the agent can discover and invoke them with high reliability.
+
+```python
+# Example Tool in src/backend/tools/search.py
+from adk import Tool
+
+@Tool
+def search_docs(query: str):
+    """Searches the knowledge base for agent-ops documentation."""
+    return get_search_results(query)
+```
+
+## 🏗️ The Agentic Flow
+A "Well-Architected" flow always follows this sequence:
+1. **Sanitize**: Input passes through the `PIIScrubber`.
+2. **Cache Check**: `Hive Mind` checks for a semantic hit.
+3. **Reason**: Gemini 2.0 reasoning loop via Vertex AI.
+4. **Action**: Tool execution via ADK.
+5. **Pack**: Final output is wrapped in an `EvidencePacket` for transparency.
+
+## 🏛️ Grounding
+To prevent hallucinations, ensure all tool outputs are grounded in your data sources. Use the `EvidenceNode` class to report the sources used in your final response.

agentops_cockpit-0.4.1/public/CLI_COMMANDS.md

@@ -0,0 +1,85 @@
+# Optimized Agent Stack: CLI & Cockpit Reference
+
+The **Optimized Agent Stack** provides a comprehensive set of tools for both building (Scaffolding) and managing (Operations) AI agents.
+
+## 1. Installation & Scaffolding (Day 0)
+
+The AgentOps Cockpit is available as a professional CLI on PyPI.
+
+### Install globally:
+```bash
+pip install agentops-cockpit
+```
+
+### Scaffold a new project:
+```bash
+# Creates a new Well-Architected agent repo
+agent-ops create my-agent --ui a2ui
+```
+
+---
+
+## 2. Operations & Auditing (The Cockpit)
+
+Run these commands inside any agent repository to verify governance-as-code.
+
+### `agent-ops arch-review`
+Audits agent design against the **Google Well-Architected Framework**.
+*   **Detection**: Automatically detects frameworks (LangGraph, ADK, CrewAI).
+*   **Gap Analysis**: Identifies architectural weaknesses in security, cost, and reliability.
+
+### `agent-ops audit`
+Runs the **Interactive Agent Optimizer** on specific logic files.
+*   **Scanning**: Checks for token waste, missing cache, or inefficient model routing.
+*   **Proposals**: Suggests localized code improvements with an interactive diff viewer.
+*   **Optimization**: Defaults to `agent.py`.
+
+### `agent-ops red-team`
+Unleashes adversarial security evaluations.
+*   **Stress Test**: Simulates prompt injections, PII leaks, and jailbreak attempts.
+*   **Safety Grade**: Provides a pass/fail grade for production readiness.
+
+### `agent-ops report`
+The "Full Mission Sweep". Runs all audits (Arch, Quality, Security, Cost) and generates a comprehensive `cockpit_final_report.md`.
+
+---
+
+### Tool Usage Optimization (MCP Hub)
+Instead of using fragmented Tool APIs, the **Optimized Agent Stack** provides a unified **MCP (Model Context Protocol) Hub**. This allows you to connect to any industry-standard tool server (Google Search, SQL, Slack) with a single interface.
+
+```python
+from agent_ops_cockpit.ops.mcp_hub import global_mcp_hub
+
+# 1. Register an MCP server (e.g., Google Search)
+global_mcp_hub.register_server(
+    "google-search", 
+    "npx", 
+    ["-y", "@modelcontextprotocol/server-google-search"]
+)
+
+# 2. Execute tools via standardized MCP protocol
+result = await global_mcp_hub.execute_tool("search", {"q": "Vertex AI updates"})
+```
+Govern all execution metrics via the Cockpit dashboard.
+
+---
+
+## 3. Operations Dashboard (Cockpit UI)
+
+Navigate to `/ops` on your deployed or local instance to access the **Control Plane**.
+
+*   **Shadow Mode Router**: Compare v1 vs v2 responses in real-time.
+*   **Flight Recorder**: Step-through visual scrubber for agent thought chains.
+*   **Semantic Cache Stats**: Real-time visualization of cost savings from the "Hive Mind" cache.
+*   **MCP Hub Status**: Monitor the health of standardized tool connections.
+
+---
+
+## 4. Google Cloud Setup
+
+To initialize the environment for the first time, use the setup script:
+```bash
+chmod +x setup_gcp.sh
+./setup_gcp.sh
+```
+This configures Artifact Registry, enables APIs, and runs the initial security evaluation.

agentops_cockpit-0.4.1/public/DEPLOYMENT.md

@@ -0,0 +1,84 @@
+# 🚀 Production Deployment
+
+Deploying a "Well-Architected" agent requires orchestration across two primary Google Cloud environments.
+
+## ⚙️ The Engine (Cloud Run)
+The Python backend (FastAPI) is deployed as a serverless service.
+- **Scaling**: We default to scale-to-zero to minimize costs during idle time.
+- **Regions**: Always deploy to `us-central1` or your local equivalent for lowest latency to Vertex AI endpoints.
+- **Best Practice**: Enable **Startup CPU Boost** to reduce cold-start latency by up to 50%.
+
+## 🧠 Agent Engine (Vertex AI Reasoning Engine)
+Recommended for agents that require deep integration with the Google Cloud agentic ecosystem.
+- **Why**: Provides a managed runtime that handles serialization, versioning, and built-in tracing.
+- **Best Practice**: Use **Context Caching** for agents with extremely long system instructions (>32k tokens).
+
+## ☸️ Enterprise Engine (GKE)
+Recommended for agents with specialized isolation needs or high-intensity workloads.
+- **Why**: Provides the highest level of control over networking (Service Mesh) and compute resources (GPUs).
+- **Best Practice**: Use **Workload Identity** to assign fine-grained IAM roles to your K8s service accounts.
+
+---
+
+## 📊 Infrastructure Decision Matrix
+
+| Feature | Agent Engine | Cloud Run | GKE |
+| :--- | :--- | :--- | :--- |
+| **Orchestration** | Managed (ADK) | Custom (FastAPI) | Custom (K8s) |
+| **Scaling** | Automatic | Scale-to-Zero | Dynamic / GPU |
+| **Observability** | Vertex AI Traces | Cloud Logging/Trace | Prometheus / Istio |
+| **Best Case** | Fast ADK Prototyping | Standard Web Agents | High-Perf Enterprise |
+
+---
+
+## 🎭 The Face (Firebase Hosting)
+The React/Vite frontend is deployed to Firebase for globally distributed edge performance.
+- **Protocol**: Ensure all components use the **A2UI Protocol** for consistent engine-driven rendering.
+- **Responsiveness**: Use mobile-first breakpoints to support iOS and Android high-density displays.
+- **Accessibility**: All interactive elements must have `aria-labels` to support automated testing in the Cockpit.
+- **Performance**: Split large components (>300 lines) to optimize React's virtual DOM reconciliation.
+
+---
+
+## 🏗️ Deployment Workflow
+
+We use a **1-click deployment** strategy that builds safety into the process:
+
+```bash
+make deploy-prod
+```
+
+### The "Safe-Build" Sequence:
+1. **Audit Phase**: The Cockpit runs `arch-review` (design) and `audit` (cost). 
+2. **Security Phase**: Executes `red-team` to ensure no public breaches exist in the latest code.
+3. **Build Phase**: Compiles the React application and optimizes static assets.
+4. **Push Phase**: 
+    - Containerizes the Engine and pushes to **Artifact Registry**.
+    - Deploys the container to **Cloud Run**.
+    - Deploys static assets to **Firebase Hosting**.
+
+## 🛡️ Staging & Traffic Splitting
+We recommend using Cloud Run **Revisions** for canary deployments:
+- Deploy 5% of traffic to your new Revision.
+- Monitor the **Cockpit Dashboard** for error rate anomalies.
+- Promote to 100% when satisfied.
+
+## 🤖 Automated CI/CD (GitHub Actions)
+
+The AgentOps Cockpit is designed for "Policy-as-Code." Every commit to `main` triggers an automated governance pipeline that ensures your agent never regresses in quality or security.
+
+![CI/CD Workflow](/public/cicd-workflow.png)
+
+### The Automated Pipeline:
+1.  **Architecture Audit**: Scans for design alignment with the detected framework (LangGraph, ADK, etc.).
+2.  **Red Team Evaluation**: Automatically tests for prompt injection and instruction overrides on every PR.
+3.  **Token Optimization**: Identifies non-cached prompts and expensive model routing before deployment.
+4.  **Reliability Suite**: Runs all unit tests and regression checks against the core engine.
+
+Refer to `.github/workflows/agent-ops-audit.yml` for the full pipeline definition.
+
+
+## 🔑 Secret Management
+Never commit `.env` files. Use **Google Cloud Secret Manager**:
+- Store your `GOOGLE_API_KEY` and third-party tool tokens.
+- Map them as environment variables in your Cloud Run configuration.

agentops_cockpit-0.3.0/PKG-INFO → agentops_cockpit-0.4.1/public/README.md

@@ -1,27 +1,20 @@
-Metadata-Version: 2.4
-Name: agentops-cockpit
-Version: 0.3.0
-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 <enrique@example.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: gitpython>=3.1.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: typer>=0.9.0
-Description-Content-Type: text/markdown
-
 # 🕹️ AgentOps Cockpit
 
 <div align="center">
+  <img src="https://raw.githubusercontent.com/enriquekalven/agent-cockpit/main/public/og-image.png" alt="AgentOps Cockpit Social Preview" width="100%" />
+</div>
+
+<div align="center">
+  <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/Google-Well--Architected-4285F4?style=for-the-badge&logo=google-cloud" alt="Google Well-Architected" />
-  <img src="https://img.shields.io/badge/Status-Day%202%20Operations-10b981?style=for-the-badge" alt="Status" />
+  <img src="https://img.shields.io/badge/A2A_Standard-Enabled-10b981?style=for-the-badge" alt="A2A Standard" />
 </div>
 
 <br />
@@ -34,7 +27,12 @@ Description-Content-Type: text/markdown
 ---
 
 ## 📽️ The Mission
-Most AI agent templates stop at a single Python file and an API key. **The AgentOps Cockpit** is for developers moving into production. While optimized for **ADK**, it provides framework-agnostic governance, safety, and cost guardrails for the entire agentic ecosystem—from CrewAI to LangGraph. Based on the **[Google Well-Architected Framework for Agents](/docs/google-architecture)**.
+Most AI agent templates stop at a single Python file and an API key. **The AgentOps Cockpit** is for developers moving into production. It provides framework-agnostic governance, safety, and cost guardrails for the entire agentic ecosystem.
+
+### Key Pillars:
+- **Governance-as-Code**: Audit your agent against [Google Well-Architected](/docs/google-architecture) best practices.
+- **Agentic Trinity**: Dedicated layers for the Engine (Logic), Face (UX), and Cockpit (Ops).
+- **A2A Connectivity**: Implements the [Agent-to-Agent Transmission Standard](/A2A_GUIDE.md) for secure swarm orchestration.
 
 ---
 
@@ -86,6 +84,9 @@ Don't wait for your users to find prompt injections. Use the built-in Adversaria
 ### 🏛️ Arch Review & Framework Detection
 Every agent in the cockpit is graded against a framework-aware checklist. The Cockpit intelligently detects your stack—**Google ADK**, **OpenAI Agentkit**, **Anthropic Claude**, **Microsoft AutoGen/Semantic Kernel**, **AWS Bedrock Agents**, or **CopilotKit**—and runs a tailored audit against corresponding production standards. Use `make arch-review` to verify your **Governance-as-Code**.
 
+### 🕹️ MCP Connectivity Hub (Model Context Protocol)
+Stop building one-off tool integrations. The Cockpit provides a unified hub for **MCP Servers**. Connect to Google Search, Slack, or your internal databases via the standardized Model Context Protocol for secure, audited tool execution.
+
 ### 🧗 Quality Hill Climbing (ADK Evaluation)
 Following **Google ADK Evaluation** best practices, the Cockpit provides an iterative optimization loop. `make quality-baseline` runs your agent against a "Golden Dataset" using **LLM-as-a-Judge** scoring (Response Match & Tool Trajectory), climbing the quality curve until production-grade fidelity is reached.
 

{agentops_cockpit-0.3.0 → agentops_cockpit-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentops-cockpit"
-version = "0.3.0"
+version = "0.4.1"
 description = "Production-grade Agent Operations (AgentOps) Platform"
 readme = "README.md"
 authors = [
@@ -20,6 +20,7 @@ dependencies = [
     "typer>=0.9.0",
     "rich>=13.0.0",
     "GitPython>=3.1.0",
+    "mcp>=0.1.0",
 ]
 
 [project.urls]