Start

What you can rely on

The fit table, the guarantee table, and the status of 0.1.x.

This page is the honest boundary of the project: what agentsparty proves, what it checks at run time, and what it deliberately leaves to you. Read it before you build anything on top.

Fit

Use agentsparty whenLook elsewhere when
The allowed interaction shape is known up frontOne agent with a free tool set is enough
Every role must act only on messages it actually receivesThe route must be discovered at runtime by the model
Projection has to fail closed before the first model callYou need a large catalogue of vendor integrations out of the box
Tools are roles with a protocol surface, not free function-callingYou require a stable API before 1.0
Sessions must resume from recorded decisions without re-askingYou need multi-process or multi-machine transport

The runtime is in-process only. Distributed multi-host orchestration is not shipped, and roles are never invented mid-run: topology is known at bind time.

What is checked, and when

PropertyResultStage
Declared labels onlyGuaranteedconstruction, projection, runtime decode
Knowledge of altGuaranteedprojection
Well-formed recursionGuaranteedclose, projection, analysis
Payload shapeGuaranteed at the boundarycodec decode
Endpoint conformanceGuaranteed when checkedsubtype / bind
Replay of authored decisionsGuaranteed for journaled decisionsresume
Deadlock freedomNot generally guaranteed
LivenessNot guaranteed
TerminationPredicate only (may_terminate, must_terminate)
Exactly-once external effectsNot guaranteed
Distributed deliveryNot shipped

The negative claims are part of the contract. Projection can reject a protocol before a model call; it cannot make a model answer, make a human respond, or make an external API idempotent. A participant can still fail or wait.

Status of 0.1.x

  • Research framework at 0.1.x. The public surface is tiered.
  • Exception types are stable; exception message text and journal formats are not.
  • Removing a public export, changing a public signature, or changing protocol meaning is a breaking change and lands in the CHANGELOG.
  • Protocol meaning is introduced in Protocol-first.
Stable