How google/cybernetic-agent-governance-engine works
CAGE is a domain-agnostic runtime governance platform: requests enter through the gateway, are evaluated by the governance runtime and its safety mechanisms, then receive a decision that can gate execution, defer for human review, and produce sealed evidence. Domain plugins and regional postures extend the kernel; the compliance bridge exposes audit and evidence workflows. The financial advisor is an illustrative application, not part of the core. Some links below follow README-level descriptions because their implementation was not sampled.
Main entry points: pipeline.py Stage pipeline · governance_middleware.py Governance middleware · governor.py Governor runtime · hybrid_server.py Gateway server
Components 19
Gateway ingress
- Gateway server
src/gateway/server/hybrid_server.py - Governance middleware
src/gateway/server/governance_middleware.py
Governance kernel
- Governor runtime
src/gateway/governance/governor/governor.py - Stage pipeline
src/gateway/governance/governor/pipeline.py - Action contracts
src/gateway/governance/contracts.py - Decision verdicts
src/gateway/governance/governor/verdicts.py - Safety mechanisms
src/gateway/governance/safety/cbf_engine.py - Consensus arbitration
src/gateway/governance/consensus/engine.py - Deferred review
src/gateway/governance/defer_queue.py - Routing seal
src/gateway/governance/routing_seal.py
Policies and extensions
- Domain plugins
src/cage_finance/plugin.py - Regional posture
src/gateway/governance/env_posture.py
Evidence and compliance
- Evidence stream
src/gateway/governance/evidence/stream.py - Evidence cold store
src/gateway/governance/evidence/cold_store.py - Compliance bridge
src/compliance_bridge/main.py - Audit workflow
src/compliance_bridge/audit_workflow.py
Reference application
- Financial advisor
src/governed_financial_advisor/server.py - Advisor graph
src/governed_financial_advisor/graph/graph.py
Other components
- Agent caller
Connections 16
- Agent caller → Gateway server: submits request
README.md - Gateway server → Governance middleware: routes through
README.md - Governance middleware → Governor runtime: enforces governance
README.md - Governor runtime → Stage pipeline: orchestrates stages
README.md - Stage pipeline → Action contracts: evaluates actions
src/gateway/governance/governor/pipeline.py - Governor runtime → Decision verdicts: routes decisions
README.md - Stage pipeline → Safety mechanisms: checks safety
- Stage pipeline → Consensus arbitration: arbitrates actions
- Decision verdicts → Deferred review: defers review
README.md - Governance middleware → Routing seal: seals evidence
README.md - Governance middleware → Evidence stream: records refusal proof
README.md - Evidence stream → Evidence cold store: archives evidence
- Stage pipeline → Domain plugins: loads domain tiers
README.md - Governor runtime → Regional posture: selects posture
README.md - Compliance bridge → Audit workflow: serves audit workflow
src/compliance_bridge/main.py - Financial advisor → Advisor graph: invokes graph
src/governed_financial_advisor/server.py