Repository navigation
feat(ag-ui): keep earlier child agents and continue a paused child - #1681
Merged
Merged
Conversation
AgentSession and AgentSnapshot take a second type parameter for application
state. The snapshot gains an optional, deeply readonly `state`, and `submit`
accepts `{ message, state }` with a partial state as well as plain text.
A session is told its state type by one declaration: `type<T>()` for the type
alone, or any Standard Schema value to also check each state as it arrives.
`readState` runs that check for session implementations. The fake session
holds, sets and validates state the same way.
No backend session supplies `state` yet; LangGraph and AG-UI follow.
createSession takes a stateType, either type<T>() or a Standard Schema. createAgentSession publishes the state document as the typed state of the core snapshot, checks it once per document when a schema is declared, and reports a rejected document in stateIssues without failing the run. A session created without a state reports none until one is supplied.
The session createSession returns now publishes the core snapshot itself: messages, tool calls, error, usage and typed state beside the protocol evidence. createAgentSession is removed. retry rejects when the failure leaves the backend outcome open, as the core contract requires, and the literal state document a request sends is no longer published.
…ntract The snapshot gains optional interrupts and subagents, and the session an optional resume(responses) that answers pending interrupts by id. The fake session publishes both fields and records resume calls.
Every published interrupt has an id, and resume takes the core contract's responses in place of a bare value. One pending interrupt receives its response's value; several are answered as one map keyed by backend id. Callers in the cockpit examples, the native conversation example and the parity fixtures move to the new command.
…he client only The raw session has loaded nothing at that point, so its resume rejects for a missing pause, not for the unmatched id. The session's own specs cover the rejection; the diagnostic keeps the provider routing evidence.
…already merged by its final head)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…blish core child agents
…d by its final head)
…separate reused run ids
…ed by its final head)
This was referenced Nov 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Three changes to the child agents the AG-UI session publishes in
snapshot.subagents, each a product decision made after #1677.#1677 has merged, so this PR now targets
maindirectly and its diff is only its own change.What changed
suspendedoutcome paused and can continue. It now readsrunningin its own run and while a later run is going, andunknownonce a later run ends without continuing it. Before, it readcomplete.subagentsnow holds every child the session knows: children of earlier root runs first, markedearlier: true, then the current run's. Before, the list emptied at each new run, so a view reading the core field lost its cards on the next turn.earlierSubagentsis unchanged and still holds bare evidence.How it works
The session records the transcript length at which each root invocation begins, beside the evidence rather than in it, so the published evidence keeps its shape. A child's records are those with its run id inside its invocation's span. Retry and regenerate rebuild the history, and the span starts from the rebuilt one.
Breaking
snapshot.subagentson an AG-UI session now includes earlier children. Code that needs only the current run's filters on!child.earlier; the subagents cockpit app does this.Verification
nx run-many -t runtime-quality,runtime-type-tests,test,type-tests,lint -p core,ag-ui,react,angularpasses.nx run-many -t test,lintfor the 10 AG-UI and runtime cockpit React apps passes; all cockpit React apps and the AG-UI fixtures type-check against source.verify-ag-ui-candidate.mjspassed locally on feat(ag-ui): answer interrupts through the core resume command #1677's branch.)🤖 Generated with Claude Code