elliot35/deterministic-agent-control-protocol

View on GitHub ↗

Governance gateway for AI agents — bounded, auditable, session-aware control with MCP proxy, shell proxy & HTTP API. Works with Cursor, Claude Code, Codex, and any MCP-compatible agent.

87 ★6 forksTypeScriptUpdated 6mo ago

What you need to know

Governance gateway for AI agents that makes every action bounded, auditable, reversible, and explainable by evaluating requests against a YAML policy before execution.

Install

npm i @det-acp/core
npx det-acp init cursor
npx det-acp init codex
npx det-acp init claude-code

Usage

  • Define a policy in agent.policy.yaml (capabilities, limits, gates, forbidden, session)
  • npx det-acp proxy --policy ./policy.yaml
  • npx det-acp exec ./agent.policy.yaml <command>
  • npx det-acp proxy --policy ./policy.yaml --evolve

Key features

  • Policy DSL covering capabilities, scopes, budgets, gates, evidence, forbidden patterns, and session limits
  • MCP proxy, shell proxy, HTTP session server, and TypeScript library SDK integration modes
  • Tamper-evident audit ledger with SHA-256 hash chaining
  • Rollback manager with compensation plans for file, git, and network operations
  • Policy self-evolution on denials with add-to-policy / allow-once / deny choices
  • Ready-built policies for coding agent, devops deploy, video upscaler, data analyst, security audit, infrastructure manager

Best for

Teams wanting to enforce, audit, and human-gate what AI coding agents can do in a workspace

Caveats

  • Does not execute actions itself; you must perform execution after an allow verdict
  • Soft governance modes rely on instructions that a creative prompt could bypass
  • Policy self-evolution suggestions require user approval and are only for permission/scope denials
Platforms: macOS · Linux · WindowsClients: Cursor · Claude Code · Codex · OpenClaw
Documentation ↗

Reviewed 2026-08-11

Topics

agent-controlagent-governanceai-agentai-governanceai-safetyai-securityai-toolsaudit-logclaude-codecodexcursordeterministicgatewayllmmcpmcp-servermodel-context-protocolnodejspolicy-enginetypescript
Stars
87★
Forks
6
Language
TypeScript
License
MIT
Created
2026-02-07
Last push
2026-02-12