Skip to content

docs(agent): specify reliable job lifecycle - #5523

Draft
samiriasbeck wants to merge 1 commit into
block:mainfrom
samiriasbeck:proposal/reliable-multi-agent-workflows
Draft

docs(agent): specify reliable job lifecycle#5523
samiriasbeck wants to merge 1 commit into
block:mainfrom
samiriasbeck:proposal/reliable-multi-agent-workflows

Conversation

@samiriasbeck

Copy link
Copy Markdown

Summary

This draft specifies a fail-closed reliability contract for the existing Buzz
agent job kinds (43001 through 43006). It covers:

  • bounded, same-channel context packs;
  • authenticated attachment materialization with digest/size verification and
    explicit text/image inspection status;
  • monotonic lifecycle receipts with terminal latency and failure reasons;
  • exact two-agent debate semantics where N cycles require 2N correlated turns;
  • per-channel authorization for context, attachments, participants, and results.

No runtime behavior or event kind is changed by this documentation-only draft.

Why a draft

The proposal touches several active design areas. Opening it as a draft gives
maintainers one concrete, reviewable contract while implementation work can stay
split into focused follow-up changes.

Related work

Validation

  • git diff --check
  • DCO sign-off present
  • Manual privacy scan: no private relay URLs, local paths, credentials, customer
    names, or deployment-specific identifiers

Signed-off-by: Samir Iasbeck <samiriasbeck@users.noreply.github.com>
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