Skip to content

v0.2.3

Choose a tag to compare

@qiansc qiansc released this 10 Aug 03:09
· 15 commits to main since this release
Immutable release. Only release title and notes can be modified.

What's changed

v0.2.3 introduces current-conversation resource read receipts. Hosts can now avoid repeatedly loading unchanged Skills, procedures, schemas, and other routed resources while still refreshing dynamic context when the selected workflow revision changes.

Highlights

  • Added the public agent-graph.resource-read-receipts.v1 schema for provider-scoped read receipts.
  • Added readState to routed resources:
    • read-required — the Agent must read the resource before acting.
    • current — an exact receipt proves the resource is already present in the current conversation.
  • Static resources remain current only while their resource ID and content digest match.
  • Dynamic Context Views additionally require the selecting Route revision to match, so a workflow change invalidates stale generated context.
  • Action Skills and input/output schemas receive the same read-state annotation as other routed resources.
  • Added route --resource-receipts @resource-read-receipts.json for CLI hosts.
  • Rejects receipt sets created for a different Provider instead of silently reusing unrelated context.

Why it matters

Agent Graph can progressively disclose large bodies of context without asking an Agent to reread unchanged material on every turn. The receipt is only evidence that exact content is available in the current conversation; it does not become a Fact, Outcome, Authority, completion signal, or durable Run state, and it does not change route evaluation.

Adoption

No Provider migration is required. Without a receipt set, routed resources remain read-required, preserving the previous conservative behavior. Hosts may opt in by issuing receipts only after the Agent has actually read the exact resource and must discard them when that conversation no longer contains the content.

This release also includes the public JSON Schema, an end-to-end example, English and Chinese documentation updates, CLI coverage, and deterministic regression tests for static-resource reuse, dynamic-view invalidation, and Provider isolation.

Full Changelog: v0.2.2...v0.2.3