Generic Agent Adapter SDK And Action Taxonomy

Generic Agent Adapter SDK And Action Taxonomy

CAVRA R6.2 expands runtime authority beyond coding agents. Generic adapters let non-coding agents request a CAVRA decision before they mutate CRM records, identity roles, data exports, model promotions, support workflows, customer communications, or financial operations.

sequenceDiagram
  participant Agent as Non-coding agent
  participant Adapter as Generic adapter
  participant CAVRA as CAVRA Runtime Authority
  participant Human as Approver
  participant System as Business system
  Agent->>Adapter: proposed action
  Adapter->>CAVRA: normalized action + tenant/workspace scope
  CAVRA-->>Adapter: allow / require_approval / block
  alt allow
    Adapter->>System: execute action
  else require approval
    Adapter->>Human: approval request
    Human-->>Adapter: approved or denied
  else block
    Adapter-->>Agent: stop action
  end
  Adapter->>CAVRA: evidence reference

Loading

Public Taxonomy

Action type	Domain	Effect	Default
knowledge.search	data	read	allow
ticket.summarize	support	read	allow
crm.update_record	sales	write	require approval
customer.email_send	communications	send	require approval
data.export_dataset	data	export	require approval
model.promote	model governance	promote	require approval
identity.grant_role	identity	grant	block
finance.release_payment	finance	approve	block
workflow.close_control	workflow	approve	require approval

Runtime-native actions such as file, command, Git, and MCP checks route back to RuntimeGuard.

Commands

cavra adapter taxonomy
cavra adapter manifest-validate examples/generic-adapters/reference-business-agent.manifest.json
cavra adapter evaluate examples/generic-adapters/non-coding-agent-actions.sample.json
cavra adapter export --output-dir dist/generic-agent-adapter
cavra adapter readiness examples/generic-adapters/enterprise-generic-agent-adapter.live.sanitized.example.json --require-live

Evidence Artifacts

• src/cavra/generic_agent_adapter.py
• scripts/validate_generic_agent_adapter.py
• examples/generic-adapters/action-taxonomy.json
• examples/generic-adapters/reference-business-agent.manifest.json
• examples/generic-adapters/non-coding-agent-actions.sample.json
• examples/generic-adapters/enterprise-generic-agent-adapter.sample.json
• examples/generic-adapters/enterprise-generic-agent-adapter.live.sanitized.example.json
• .github/workflows/generic-agent-adapter.yml
• tests/test_generic_agent_adapter.py

Live Gate

The live gate is accepted only when the packet supplies real CI, taxonomy, adapter-test, and non-coding scenario evidence and returns:

{
  "ready_for_live_generic_adapter_sdk": true,
  "blocker_count": 0
}