Sales acks external-actions handler-execution topology and queue contract v1.2.0; POST /api/external-actions/execute is roadmap work
What
Ack on 2026-05-22-platform-external-actions-handler-execution-topology and the external-actions queue contract v1.2.0. No issues with the design. The HTTP-callback direction is the right call for the same reasons Delivery named: a per-domain runner fragments the single-runner guarantee ADR-0011 committed to, and vendoring handler code into Platform's runner couples Platform to every provider SDK. The inbound-side dispatcher webhook fanout is a well-understood precedent and the HMAC-signed callback mirrors it cleanly.
Sales' position on the new obligation
Sales has no external-actions producer work currently in flight. The near-term external-actions surface for Sales is the Quo/SMS comms path, which has not been taken on as an active initiative. Sales' POST /api/external-actions/execute endpoint is roadmap work, deferred until Sales picks up an external-actions handler.
When Sales does build the endpoint, we will model the implementation on Delivery's — lib/external-actions/verify-execute-request.ts for the HMAC verification and HandlerContext mapping, with the Next.js adapter at app/api/external-actions/execute/route.ts. Delivery's implementation was filed on 2026-05-22-delivery-external-actions-handler-execution-ack and is the reference shape we'll copy against contract §7.5.
In the interim, EXTERNAL_ACTIONS_DEV_STUB covers the gap. Platform's runner treating a domain with no endpoint as a non-failing skip is the right safe default; Sales will not accumulate dead-letters before the endpoint exists.
Standing note
Sales' comms-routing note from 2026-05-06-sales-adr-0011-ack-with-comms-routing-note is unchanged. Any Sales-produced Quo or SMS action must satisfy the Sales Guardian comms-routing rule before enqueue, and the payload must carry the routed recipient decision or enough immutable context to prove routing at enqueue time. That obligation applies when Sales implements the execute endpoint and registers its handlers; it is not affected by this contract bump.
References
- Parent memo:
2026-05-22-platform-external-actions-handler-execution-topology - Delivery's ack and execute implementation:
2026-05-22-delivery-external-actions-handler-execution-ack - External Actions Queue contract v1.2.0:
contracts/external-actions/README.md - ADR-0011 and Amendment 2026-05-22:
adrs/ADR-0011-external-actions-at-platform.md - Sales' prior ADR-0011 ack with comms-routing note:
2026-05-06-sales-adr-0011-ack-with-comms-routing-note