@tanstack/ai
Version:
Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.
46 lines (45 loc) • 1.89 kB
TypeScript
import { ModelMessage, RunAgentResumeItem, SubagentStatus, UIMessage } from '../../../types.js';
type AnyMessage = UIMessage | ModelMessage;
export interface SubagentTurnChild {
subagentRunId: string;
name: string;
status: SubagentStatus;
parentToolCallId?: string;
/** The child's own messages from the earlier run. */
messages: Array<AnyMessage>;
/** Text the child wrote. */
text: string;
/** Resume entries for this child and its nested children. */
resume: Array<RunAgentResumeItem>;
}
/** The interrupted turn that a resume continues. */
export interface SubagentTurn {
/**
* Messages up to and including the last top-level user message. Child wire
* messages do not count.
*/
before: Array<AnyMessage>;
/** Direct children of the parent in that turn. */
children: Array<SubagentTurnChild>;
/** Resume entries that no child owns. They belong to the parent run. */
rest: Array<RunAgentResumeItem>;
/** The router plan of the earlier run, from the children's metadata. */
plan?: unknown;
}
/** Key of the router plan in `SUBAGENT_STARTED` metadata (`metadata.tanstack`). */
export declare const SUBAGENT_PLAN_KEY = "subagentPlan";
/**
* The subagent cards in `messages`: UI subagent parts, then wire groups.
* Nested cards stay inside their parent card.
*/
export declare function subagentCards(messages: ReadonlyArray<AnyMessage>): Array<Omit<SubagentTurnChild, 'resume'> & {
/** The interrupt ids of the child and its nested children. */
ids: Set<string>;
plan: unknown;
}>;
/**
* Find the children of the trailing assistant turn that `resume` answers.
* Returns undefined when no child owns a resume entry.
*/
export declare function readSubagentTurn(messages: ReadonlyArray<AnyMessage>, resume: ReadonlyArray<RunAgentResumeItem> | undefined): SubagentTurn | undefined;
export {};