Skip to content

Add authenticated durable workflow delivery API - #6846

Draft
loganj wants to merge 4 commits into
larry/workflow-delivery-db-v2from
larry/workflow-delivery-api-d-reconciled
Draft

Add authenticated durable workflow delivery API#6846
loganj wants to merge 4 commits into
larry/workflow-delivery-db-v2from
larry/workflow-delivery-api-d-reconciled

Conversation

@loganj

@loganj loganj commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

🤖 Larry here.

Summary

  • Gives a managed agent an authenticated, durable way to claim one workflow message, keep its lease alive, and report the outcome without exposing private workflow inputs.
  • Adds a relay-signed receipt proving which workflow revision, run, step, trigger, target, and visible message the delivery belongs to.

Details

  • Every read or mutation requires a fresh signed HTTP request from the delivery's exact target agent.
  • Claim, read, renew, and finish reject the wrong workspace, target, workflow/run/step binding, lease generation, expired lease, or conflicting terminal replay.
  • The claimed delivery includes the exact signed workflow definition, visible message, and a relay-signed verification receipt. The receipt carries only public references and a hash of the visible message; it never contains trigger context, webhook fields, prior-step outputs, execution traces, or secrets.
  • Receipt issuance revalidates the trigger against durable authority. Scheduled runs must match their claimed schedule slot, event-triggered runs must reference an existing signed event, and webhook runs use a payload-free invocation record bound to the workspace, workflow, and run.
  • The webhook authority schema is additive for existing deployments.

Scope

This draft remains dormant. It adds no delivery producer, automatic poller, ACP dispatch, or production activation; those stay in later dependent changes.

@loganj
loganj force-pushed the larry/workflow-delivery-api-d-reconciled branch from 6b80091 to a97b573 Compare August 26, 2026 16:30
@loganj
loganj force-pushed the larry/workflow-delivery-db-v2 branch from 3949325 to 6892c50 Compare August 26, 2026 16:30
loganj and others added 4 commits August 26, 2026 16:33
Co-authored-by: Larry <8cf5a83f590ec0955b11647d1c88f796a98e088c30a492c58e0e46c3026ae7a4@buzz.block.builderlab.xyz>
Signed-off-by: Logan Johnson <loganj@squareup.com>
Co-authored-by: Larry <8cf5a83f590ec0955b11647d1c88f796a98e088c30a492c58e0e46c3026ae7a4@buzz.block.builderlab.xyz>
Signed-off-by: Logan Johnson <loganj@squareup.com>
Co-authored-by: Larry <8cf5a83f590ec0955b11647d1c88f796a98e088c30a492c58e0e46c3026ae7a4@buzz.block.builderlab.xyz>
Signed-off-by: Logan Johnson <loganj@squareup.com>
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 larry/workflow-delivery-db-v2 branch from 6892c50 to 6202549 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