RFC-001: Agent Governance Control Plane (AGCP)¶
Version: 1.1 Status: Approved Authors: CapiscIO Core Team Created: 2025-12-05 Updated: 2026-04-30
1. Executive Summary & Threat Model¶
1.1 The Product Goal¶
To establish CapiscIO as the enforcement plane for Level 2 Agentic Contexts. We provide the infrastructure to move enterprise governance from static, perimeter-based access control to verifiable Transitive Authority.
The Strategic Wedge:
Level 1 risks are prompt injection. Level 2 risks are when Agent B empties your bank account because Agent A asked it to "help with finances." We are not a firewall for hallucinations; we are the control plane for systems of interacting agents.
Governing Principle:
"LLMs can propose actions. They cannot define what is allowed."
CapiscIO treats the LLM layer as an untrusted signal source. All authorization decisions are made by the deterministic enforcement plane โ the Policy Enforcement Point (PEP) โ operating against cryptographically verifiable artifacts. No LLM output, reasoning trace, or chain-of-thought can authorize an action. Declared intent, not inferred intent, governs what agents are permitted to do.
1.2 Threat Model Summary¶
| Threat | Status | Mechanism |
|---|---|---|
| Authority Escalation | ๐ก๏ธ Blocked | Transitive Intersection (Golden Rule) |
| Context/Orchestration Drift | ๐ก๏ธ Blocked | Signed Trace ID + Intent Locking |
| Forged Delegation | ๐ก๏ธ Blocked | SVID Signature Validation |
| Confused Deputy | ๐ก๏ธ Blocked | Monotonic narrowing via Authority Envelopes (RFC-008); a high-privilege agent cannot be manipulated by a low-privilege caller into exercising authority the caller does not hold. Delegation chains are cryptographically bound. |
| Rogue/Revoked Agent | ๐ก๏ธ Blocked | Short-lived TTL + Revocation Lists |
| Prompt Injection | โ Out of Scope | Handled by Model Firewall |
| Data Exfiltration | โ Out of Scope | Handled by DLP / Egress Filtering |
| LLM-based authorization bypass | ๐ก๏ธ Blocked by design | RFC-010 classifier outputs are advisory signal only. They MUST NOT be the sole basis for a DENY decision. The RFC-009 PEP is the sole authoritative enforcement boundary. Classifier verdicts enrich enforcement; they do not make authorization decisions. |
1.3 What CapiscIO Is NOT¶
To avoid category confusion:
- NOT a Model Firewall (we do not inspect prompt syntax).
- NOT a DLP Tool (we do not scan packets for PII regex).
- NOT a Service Mesh (we govern permissions, not packets).
- IS: The governance enforcement layer for systems of interacting agents.
2. Core Architecture: The "Trace & Enforce" Pattern¶
Diagram Required: [Engineering Action] A sequence diagram showing: User โ Planner Agent โ Executor Agent โ Database, with Trace ID propagation and Authority Intersection at each hop. Each arrow should show the "Effective Scope" shrinking.
2.1 The Invariant (The "Golden Rule")¶
We abstract implementation complexity into a single, verifiable security guarantee:
"No agent can take an action that exceeds the authority of the human or system identity that triggered the workflow."
Implementation: The effective authority at any hop is the intersection of the Originator's scope, every Intermediate Agent's maximum scope, and the Requested Action.
2.2 Originator Types (Defining "Intent")¶
- Human Originator: Intent is derived from a verifiable user action (authenticated via IdP).
- System Originator: Intent must be declared and signed before execution.
- Example: A nightly batch job declares intent
generate_quarterly_reportand is signed bysystem:finance-automation. Any agent invoked by this job inherits this scope and cannot exceed it.
- Example: A nightly batch job declares intent
Scope Boundary โ Automated Intent Classification:
CapiscIO does not perform automated intent classification from natural language requests. Reliable automated mapping of open-ended natural language to bounded, cryptographically enforceable capability classes is an unsolved problem in the general case. CapiscIO solves the enforcement layer: given a declared intent, enforce it deterministically. How a system maps a user's expressed goal to a declared capability class before issuing an Authority Envelope (RFC-008) is the responsibility of the orchestration layer above CapiscIO.
For purpose-built agents with bounded tool surfaces, declared intent is specified at registration time via the Pre-Authorized Action Manifest (RFC-009). For open-ended conversational agents, the orchestration layer must supply a structured intent declaration before root envelope issuance. CapiscIO enforces what is declared; it does not classify what was meant.
3. Component Deep Dive¶
3.1 The Agent Registry (The Foundation)¶
The Registry is the authoritative locus of truth for identity, authority, and delegation rights. Without it, verifiable transitive enforcement is impossible.
- Trust Graph: Defines who may delegate authority, not who may communicate.
- Crucial Distinction: Agent A being allowed to call Agent B (network) does not mean Agent A can delegate authority to Agent B (governance). Communication โ Delegation.
3.2 The Trace ID (Structured Evidence)¶
The Trace ID is a cryptographically signed envelope containing the full execution lineage.
Schema:
{
"trace_id": "uuid-v4",
"originator": {
"type": "human",
"id": "user:[email protected]",
"initial_scope_hash": "sha256:a7f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1"
},
"delegation_chain": [
{
"agent_id": "agent:planner-v1",
"timestamp": 1715000000,
"effective_scope_hash": "sha256:b3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4",
"signature": "sig_planner_v1..."
}
]
}
3.3 The Policy Decision Point (PDP)¶
- Role: OPA is the executor. CapiscIO defines the governance primitives: Originator, Delegation Chain, Intent Class, and Authority Envelope.
- Intent Classes: Governance-defined categories (e.g.,
financial_write), not LLM-inferred semantics. We do not guess intent; we enforce declared intent.
4. Enforcement Strategy & Guarantees¶
4.1 Integration Patterns¶
We guarantee that every external action and every A2A handoff is subject to the same transitive authority check.
| Pattern | Use Case | Implementation |
|---|---|---|
| 1. In-Process SDK | Core. LangChain, AutoGen. | capiscio.guard() wrapper acting as PEP. |
| 2. Sidecar Proxy | Containerized Agents. | Envoy filter/Sidecar intercepting egress. |
| 3. API Gateway | SaaS/Black-Box. | Middleware at ingress/egress boundary. |
| 4. Serverless | Cloud Functions. | Function Decorator validating Trace ID. |
4.2 Failure Modes and Guarantees¶
The system fails securely by default.
- Missing Trace ID โ AUTOMATIC DENY.
- Forged Trace ID (Signature Mismatch) โ DENY + ALERT (Sev 1).
- Delegation path not permitted in Trust Graph โ DENY.
- Scope Intersection resolves to Empty Set โ DENY.
4.3 Revocation (The Kill Switch)¶
Identities and policies must be revocable mid-flight.
- Short-Lived SVIDs: Default TTL is 1 hour.
- Revocation Propagation: PEPs consume a lightweight CRL/OCSP stream (polled every 30s) or a Push-Notification channel for "Emergency Stop" events (sub-second propagation).
- Result: An agent detected as "rogue" is cryptographically barred from further delegation within <60 seconds.
5. Audit & Compliance¶
Value Proposition:
"This is the first audit trail that can explain multi-agent decisions deterministically."
Log Schema:
trace_id: Global transaction reference.originator_identity: The root source of authority.authority_at_decision: The specific intersection of permissions used.policy_version: Exact version of the rules engine used.decision:ALLOW|DENY
Immutability: Audit reconstruction requires policies to be versioned immutably. Policy bundles cannot be mutated retroactively. A decision made today must be reconstructible 3 years from now using Policy_v1.2 and the signed Trace_ID.
6. Technical Defaults (Reference Implementation)¶
- Trust Model: PKI with SPIFFE.
- Latency Budget: <5ms p95 (Warm Cache).
- Note: Cold start latency (bundle fetch) <50ms. Bundle TTL default is 60s.
- Deployment: Hybrid. Control Plane (Registry/PDP) is SaaS; Data Plane (PEPs) lives in the Customer VPC.
Co-Located PDP Deployment (Non-Normative)
A valid deployment variant embeds the PDP within the same process as the PEP (e.g., an OPA evaluator embedded in the CapiscIO server). In this configuration, policy evaluation is in-process with no network hop, reducing decision latency to sub-millisecond. The co-located PDP implements the same PDPClient interface as an external PDP; the PEP middleware is unaware of whether the PDP is local or remote. See RFC-005 Appendix B for the reference implementation details.
Changelog¶
- v1.1 (2026-04-30): Added Governing Principle statement (ยง1.1). Added Confused Deputy and LLM-based authorization bypass threat rows (ยง1.2). Added intent classification scope boundary (ยง2.2).
- v1.0 (2025-12-05): Initial public release