Connector contract: events in, actions out, lookups #1979
Notifications
Due Date
No due date set.
Blocks
Reference: sam/archie#1979
Reference in new issue
Block a user
Every system Archie hears from or acts on is a connector extension. A connector declares its event types (with typed fields), its actions (with input schemas and reversibility), and its lookups (such as ownership). Core contains no vendor-specific code for any of them.
Done when: a connector extension can be installed that provides events, actions and a lookup, and a workflow can use all three without core changes.
Spec: principle 3, R6, R17.
Done. The connector contract declares events (typed schemas), actions (input schema, declared effect, per-action Resolve, idempotency keys, executed digest, unknown outcomes), lookups, deliveries (messages and records, never offered to an agent) and listening (a stream from a connection the connector holds, resumed from a stored cursor). On staging, extensions installed without core changes provide each: Alertmanager events, host lookups, Semaphore template actions, a Prometheus MCP server's lookups, and Telegram deliveries and answer events. The investigate workflow uses events, lookups and actions together.