Skip to content

feat(acp): isolated workflow-delivery verifier (node E) - #6824

Draft
loganj wants to merge 1 commit into
larry/workflow-delivery-api-d-reconciledfrom
wakko/workflow-acp-verifier
Draft

feat(acp): isolated workflow-delivery verifier (node E)#6824
loganj wants to merge 1 commit into
larry/workflow-delivery-api-d-reconciledfrom
wakko/workflow-acp-verifier

Conversation

@loganj

@loganj loganj commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

🤖 Larry here.

Summary

Workflow messages can include private webhook data or outputs from earlier steps. Agents should be able to confirm that a message is authentic without receiving those private inputs.

This change adds a dormant, pure verifier for the ACP agent harness. It verifies the exact signed workflow definition, the visible message, and the relay's signed delivery receipt before returning a dispatchable message. It performs no network or database I/O and is not wired into production yet.

Details

  • Verifies the delivery's community, workflow, run, step, target agent, signed definition, visible message, and trigger-cause reference against the signed receipt.
  • Requires the message's dedicated workflow-delivery recipient marker; an ordinary mention cannot admit a delivery.
  • Treats live wake events as identifier-only hints. They do not grant claim or execution authority.
  • Keeps private trigger context, webhook fields, prior-step outputs, execution traces, and secrets out of the agent-facing contract.
  • Distinguishes permanent mismatches from temporarily unavailable public artifacts so the later runtime can fail closed or retry correctly.
  • Preserves the signed workflow owner as the principal used by the existing owner-only dispatch gate.

Scope

This is node E of the dormant workflow-delivery stack and is based on the authenticated delivery API in #6846. A later capability-gated runtime will call it; this PR adds no producer, poller, claim loop, ACP dispatch, or production activation. PRs #2737 and #6697 remain unchanged.

Validation

At exact head a36b3462842fb9bcfcfa2e946843fc7bbe22e255:

  • cargo fmt --check
  • cargo clippy -p buzz-acp --all-targets -- -D warnings
  • cargo test -p buzz-acp — 813 unit tests and 9 integration tests passed

@loganj
loganj force-pushed the wakko/workflow-acp-verifier branch 2 times, most recently from d4f5cda to c8b89d3 Compare August 25, 2026 21:23
@loganj
loganj force-pushed the darryl/delivery-protocol-vocabulary branch 2 times, most recently from 092f9fb to 9c87908 Compare August 26, 2026 16:30
@loganj
loganj force-pushed the wakko/workflow-acp-verifier branch from c8b89d3 to a36b346 Compare August 26, 2026 16:42
@loganj
loganj changed the base branch from darryl/delivery-protocol-vocabulary to larry/workflow-delivery-api-d-reconciled August 26, 2026 16:42
Verify exact signed definitions, visible messages, and relay-signed delivery receipts without exposing private workflow inputs.

Co-authored-by: Larry <8cf5a83f590ec0955b11647d1c88f796a98e088c30a492c58e0e46c3026ae7a4@buzz.block.builderlab.xyz>
Signed-off-by: Logan Johnson <loganj@squareup.com>
@loganj
loganj force-pushed the larry/workflow-delivery-api-d-reconciled branch from a97b573 to 813cd53 Compare August 26, 2026 20:41
@loganj
loganj force-pushed the wakko/workflow-acp-verifier branch from a36b346 to 1899340 Compare August 26, 2026 20:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant