ActraDeck Audit cockpit
GitHub

Public ingestion contract

Add external coding tools to ActraDeck

Any tool can normalize its own events and POST them into ActraDeck. Use your own provider slug, set source=external, map activity to the closed event-type enum, and the local cockpit can show it in live views, audit trails, and replay.

Read the full contract Example adapter Real-world example: opencode plugin adapter

The contract

  • provider is an open slug such as my_tool or aider.
  • source is a closed enum. Third-party adapters use external.
  • event_type stays closed so the state machine keeps meaning.
  • event_id is the idempotency key, so retry is safe.

Why this matters

The contract turns ActraDeck from a two-agent cockpit into a community-extensible audit cockpit. Adapter authors can add support for new coding CLIs without changing the core approval, redaction, audit, or replay pipeline.

Redaction floor

Direct POST adapters bypass the sidecar, so backend ingress applies redaction before persistence and recomputes redaction counts from actual markers. This protects honest adapters from accidental raw-secret retention.

Read next