@assistant-ui/core 0.3.7 → 0.3.9

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","names":["ReadonlyJSONObject","ReadonlyJSONValue","ToolCallTiming","ToolModelContentPart","CompleteAttachment","PartProviderMetadata","providerName","TextMessagePart","type","text","status","MessagePartStreamStatus","providerMetadata","parentId","ReasoningMessagePart","SourceProviderMetadata","SourceMessagePart","sourceType","id","url","title","mediaType","filename","ImageMessagePart","image","FileMessagePart","data","mimeType","Unstable_AudioMessagePart","audio","format","DataMessagePart","name","T","GenerativeUINode","component","props","Record","children","key","GenerativeUISpec","root","GenerativeUIMessagePart","spec","McpAppMetadata","resourceUri","visibility","serverId","MCP_APP_URI_SCHEME","isMcpAppUri","uri","startsWith","ToolCallMessagePartMcpMetadata","app","ToolApprovalOptionKind","ToolApprovalOption","kind","label","description","grants","confirm","ToolApprovalResponse","approved","reason","optionId","ToolCallMessagePart","toolCallId","toolName","args","TArgs","result","TResult","isError","argsText","artifact","timing","mcp","modelContent","interrupt","payload","approval","isAutomatic","options","resolution","messages","ThreadMessage","ThreadUserMessagePart","ThreadAssistantMessagePart","MessagePartStatus","error","ToolCallMessagePartStatus","MessageStatus","MessageTiming","streamStartTime","firstTokenTime","totalStreamTime","tokenCount","tokensPerSecond","totalChunks","toolCallCount","ThreadStep","messageId","usage","inputTokens","outputTokens","MessageCommonProps","createdAt","Date","ThreadSystemMessage","role","content","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","custom","ThreadUserMessage","attachments","isOptimistic","ThreadAssistantMessage","BaseThreadMessage","MessageRole","RunConfig","AppendMessage","Omit","sourceId","runConfig","startRun","steer"],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolCallTiming, ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { ToolCallTiming, ToolModelContentPart };\n\nexport type PartProviderMetadata = {\n  readonly [providerName: string]: ReadonlyJSONObject;\n};\n\nexport type TextMessagePart = {\n  readonly type: \"text\";\n  readonly text: string;\n  readonly status?: MessagePartStreamStatus;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type ReasoningMessagePart = {\n  readonly type: \"reasoning\";\n  readonly text: string;\n  readonly status?: MessagePartStreamStatus;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type SourceProviderMetadata = PartProviderMetadata;\n\nexport type SourceMessagePart =\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"url\";\n      readonly id: string;\n      readonly url: string;\n      readonly title?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    }\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"document\";\n      readonly id: string;\n      readonly url?: undefined;\n      readonly title: string;\n      readonly mediaType: string;\n      readonly filename?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    };\n\nexport type ImageMessagePart = {\n  readonly type: \"image\";\n  readonly image: string;\n  readonly filename?: string;\n};\n\nexport type FileMessagePart = {\n  readonly type: \"file\";\n  readonly filename?: string;\n  readonly data: string;\n  readonly mimeType: string;\n  /** How `data` goes on the wire: a url or id reference; omitted = inferred (http(s) → url, else base64). \"url\" is honored by the LangChain-family, A2A, AG-UI, and Google ADK runtimes; \"id\" by the LangChain family only. */\n  readonly sourceType?: \"url\" | \"id\";\n  readonly parentId?: string;\n};\n\n/**\n * @deprecated Use {@link FileMessagePart} with an `audio/*` mime type. `file`\n * is the carrier for every non-image binary modality: it is a member of both\n * the user and assistant unions, carries a filename, and can declare how its\n * payload goes on the wire, none of which this shape can express. The payload\n * form a `file` part needs is still adapter specific; see the Part Types\n * section of the message primitive docs. Honored everywhere it is accepted; it\n * will not gain fields.\n */\nexport type Unstable_AudioMessagePart = {\n  readonly type: \"audio\";\n  readonly audio: {\n    readonly data: string;\n    readonly format: \"mp3\" | \"wav\";\n  };\n};\n\nexport type DataMessagePart<T = any> = {\n  readonly type: \"data\";\n  readonly name: string;\n  readonly data: T;\n};\n\n/**\n * A JSON spec describing a tree of UI components to render.\n *\n * The agent emits a {@link GenerativeUIMessagePart} containing this spec, and\n * the consumer-provided component allowlist is used to resolve `component`\n * names. Any component referenced that is not present in the allowlist is\n * rejected with a typed error — the allowlist is the security boundary in the\n * default same-realm rendering path.\n */\nexport type GenerativeUINode =\n  | string\n  | {\n      /** Allowlisted component name (resolved against the consumer registry). */\n      readonly component: string;\n      /** Props passed to the resolved component (must be JSON-serializable). */\n      readonly props?: Record<string, unknown>;\n      /** Optional children — strings render as text, objects recurse. */\n      readonly children?: readonly GenerativeUINode[];\n      /** Optional stable key for React reconciliation. */\n      readonly key?: string;\n    };\n\n/**\n * The root spec for a generative UI tree.\n */\nexport type GenerativeUISpec = {\n  /** Root node(s) to render. */\n  readonly root: GenerativeUINode | readonly GenerativeUINode[];\n};\n\n/**\n * A message part that carries a JSON spec describing UI to render.\n *\n * Render with `<MessagePrimitive.GenerativeUI components={...} />`. The\n * primitive resolves component names against the consumer-provided allowlist\n * — any unknown name throws a typed error rather than rendering. Stream-\n * friendly: a partially-streamed spec renders progressively.\n */\nexport type GenerativeUIMessagePart = {\n  readonly type: \"generative-ui\";\n  /** The JSON spec describing the UI tree. */\n  readonly spec: GenerativeUISpec;\n  /** Optional id (useful for replays / stable keys). */\n  readonly id?: string;\n  readonly parentId?: string;\n};\n\nexport type McpAppMetadata = {\n  readonly resourceUri: string;\n  readonly mimeType?: string;\n  readonly visibility?: readonly (\"model\" | \"app\")[];\n  /** Routable server identity emitted by the agent stack when multiple MCP servers back one agent; for @ag-ui/mcp-apps-middleware this is the configured serverId, falling back to its serverHash. */\n  readonly serverId?: string;\n};\n\nexport const MCP_APP_URI_SCHEME = \"ui://\";\n\nexport const isMcpAppUri = (uri: string | undefined): boolean =>\n  !!uri?.startsWith(MCP_APP_URI_SCHEME);\n\nexport type ToolCallMessagePartMcpMetadata = {\n  readonly app?: McpAppMetadata;\n};\n\nexport type ToolApprovalOptionKind =\n  | \"allow-once\"\n  | \"allow-always\"\n  | \"reject-once\"\n  | \"reject-always\";\n\nexport type ToolApprovalOption = {\n  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */\n  readonly id: string;\n  /**\n   * Decision class. Drives approved-resolution and default rendering.\n   * Open union: `_`-prefixed custom kinds are never auto-resolved and the\n   * default kit skips them; they must be answered with an explicit\n   * `approved` value (optionally alongside the `optionId`).\n   */\n  readonly kind: ToolApprovalOptionKind | (string & {});\n  /** Human label. Renderers supply defaults per kind when omitted. */\n  readonly label?: string;\n  readonly description?: string;\n  /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */\n  readonly grants?: readonly string[];\n  /** Opt-in confirmation step before this option resolves. */\n  readonly confirm?: boolean | { title?: string; description?: string };\n};\n\nexport type ToolApprovalResponse =\n  | { readonly approved: boolean; readonly reason?: string }\n  | { readonly optionId: string; readonly reason?: string }\n  | {\n      readonly approved: boolean;\n      readonly optionId: string;\n      readonly reason?: string;\n    };\n\nexport type ToolCallMessagePart<\n  TArgs = ReadonlyJSONObject,\n  TResult = unknown,\n> = {\n  /** Identifies this part as a tool call. */\n  readonly type: \"tool-call\";\n  /** Stable identifier for this invocation of the tool. */\n  readonly toolCallId: string;\n  /** Name of the tool requested by the model. */\n  readonly toolName: string;\n  /**\n   * Arguments supplied by the model. During streaming this is a partial parse:\n   * fields may be missing or incomplete. From a tool-call renderer, use\n   * `useToolArgsStatus` to detect which fields are still arriving.\n   */\n  readonly args: TArgs;\n  /** Result returned by the tool, if it has completed. */\n  readonly result?: TResult | undefined;\n  /** Whether the result represents a tool execution error. */\n  readonly isError?: boolean | undefined;\n  /** Raw JSON argument text streamed by the model. */\n  readonly argsText: string;\n  /** UI-only artifact associated with the tool result. */\n  readonly artifact?: unknown;\n  /** Wall-clock timing for this call, when the runtime or host tracks it. */\n  readonly timing?: ToolCallTiming;\n  /** MCP app metadata associated with this tool call, when present. */\n  readonly mcp?: ToolCallMessagePartMcpMetadata;\n  /** Provider metadata associated with this tool call, when present. */\n  readonly providerMetadata?: PartProviderMetadata;\n  /** Content returned to the model for this tool result. */\n  readonly modelContent?: readonly ToolModelContentPart[] | undefined;\n  /** Human-input request that must be resolved before the run can continue. */\n  readonly interrupt?: { type: \"human\"; payload: unknown };\n  /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */\n  readonly approval?: {\n    readonly id: string;\n    readonly approved?: boolean;\n    readonly reason?: string;\n    readonly isAutomatic?: boolean;\n    /** Available decisions for this call. Absent: a plain allow / deny pair. */\n    readonly options?: readonly ToolApprovalOption[];\n    /** The option chosen at resolution, when options were present. */\n    readonly optionId?: string;\n    /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */\n    readonly resolution?: \"cancelled\" | \"expired\";\n  };\n  /** Parent message-part ID when this part belongs to a nested structure. */\n  readonly parentId?: string;\n  /**\n   * Nested thread messages produced by this tool call, for example a sub-agent\n   * conversation.\n   */\n  readonly messages?: readonly ThreadMessage[];\n};\n\nexport type ThreadUserMessagePart =\n  | TextMessagePart\n  | ImageMessagePart\n  | FileMessagePart\n  | DataMessagePart\n  | Unstable_AudioMessagePart;\n\nexport type ThreadAssistantMessagePart =\n  | TextMessagePart\n  | ReasoningMessagePart\n  | ToolCallMessagePart\n  | SourceMessagePart\n  | FileMessagePart\n  | ImageMessagePart\n  | DataMessagePart\n  | GenerativeUIMessagePart;\n\nexport type MessagePartStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: unknown;\n    };\n\nexport type MessagePartStreamStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n    };\n\nexport type ToolCallMessagePartStatus =\n  | {\n      /** The tool call is waiting for UI or human input before continuing. */\n      readonly type: \"requires-action\";\n      /** Reason the tool call requires action. */\n      readonly reason: \"interrupt\";\n    }\n  | MessagePartStatus;\n\nexport type MessageStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"requires-action\";\n      readonly reason: \"tool-calls\" | \"interrupt\";\n    }\n  | {\n      readonly type: \"complete\";\n      readonly reason: \"stop\" | \"unknown\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"tool-calls\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: ReadonlyJSONValue;\n    };\n\nexport type MessageTiming = {\n  readonly streamStartTime: number;\n  readonly firstTokenTime?: number;\n  readonly totalStreamTime?: number;\n  readonly tokenCount?: number;\n  readonly tokensPerSecond?: number;\n  readonly totalChunks: number;\n  readonly toolCallCount: number;\n};\n\nexport type ThreadStep = {\n  readonly messageId?: string;\n  readonly usage?:\n    | {\n        readonly inputTokens: number;\n        readonly outputTokens: number;\n      }\n    | undefined;\n};\n\ntype MessageCommonProps = {\n  readonly id: string;\n  readonly createdAt: Date;\n};\n\nexport type ThreadSystemMessage = MessageCommonProps & {\n  readonly role: \"system\";\n  readonly content: readonly [TextMessagePart];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadUserMessage = MessageCommonProps & {\n  readonly role: \"user\";\n  readonly content: readonly ThreadUserMessagePart[];\n  readonly attachments: readonly CompleteAttachment[];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadAssistantMessage = MessageCommonProps & {\n  readonly role: \"assistant\";\n  readonly content: readonly ThreadAssistantMessagePart[];\n  readonly status: MessageStatus;\n  readonly metadata: {\n    readonly unstable_state: ReadonlyJSONValue;\n    readonly unstable_annotations: readonly ReadonlyJSONValue[];\n    readonly unstable_data: readonly ReadonlyJSONValue[];\n    readonly steps: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    /**\n     * Marks a client-side optimistic placeholder. Such messages are evicted\n     * once off the head branch and are never persisted.\n     */\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\ntype BaseThreadMessage = {\n  readonly status?: ThreadAssistantMessage[\"status\"];\n  readonly metadata: {\n    readonly unstable_state?: ReadonlyJSONValue;\n    readonly unstable_annotations?: readonly ReadonlyJSONValue[];\n    readonly unstable_data?: readonly ReadonlyJSONValue[];\n    readonly steps?: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n  readonly attachments?: ThreadUserMessage[\"attachments\"];\n};\n\nexport type ThreadMessage = BaseThreadMessage &\n  (ThreadSystemMessage | ThreadUserMessage | ThreadAssistantMessage);\n\nexport type MessageRole = ThreadMessage[\"role\"];\n\nexport type RunConfig = {\n  readonly custom?: Record<string, unknown>;\n};\n\nexport type AppendMessage = Omit<ThreadMessage, \"id\"> & {\n  parentId: string | null;\n\n  /** The ID of the message that was edited or undefined. */\n  sourceId: string | null;\n  runConfig: RunConfig | undefined;\n  startRun?: boolean | undefined;\n  /** Process this message next; only meaningful for queue-capable runtimes. */\n  steer?: boolean | undefined;\n};\n"],"mappings":";AAmJA,MAAagD,qBAAqB;AAElC,MAAaC,eAAeC,QAC1B,CAAC,CAACA,KAAKC,WAAWH,kBAAkB"}
+{"version":3,"file":"message.js","names":["ReadonlyJSONObject","ReadonlyJSONValue","ToolCallTiming","ToolModelContentPart","CompleteAttachment","PartProviderMetadata","providerName","TextMessagePart","type","text","status","MessagePartStreamStatus","providerMetadata","parentId","ReasoningMessagePart","unstable_summary","SourceProviderMetadata","SourceMessagePart","sourceType","id","url","title","mediaType","filename","ImageMessagePart","image","FileMessagePart","data","mimeType","Unstable_AudioMessagePart","audio","format","DataMessagePart","name","T","GenerativeUINode","component","props","Record","children","key","GenerativeUISpec","root","GenerativeUIMessagePart","spec","McpAppMetadata","resourceUri","visibility","serverId","MCP_APP_URI_SCHEME","isMcpAppUri","uri","startsWith","ToolCallMessagePartMcpMetadata","app","ToolApprovalOptionKind","ToolApprovalOption","kind","label","description","grants","confirm","ToolApprovalResponse","approved","reason","optionId","ToolCallMessagePart","toolCallId","toolName","args","TArgs","result","TResult","isError","argsText","artifact","timing","mcp","modelContent","interrupt","payload","approval","isAutomatic","options","resolution","messages","ThreadMessage","ThreadUserMessagePart","ThreadAssistantMessagePart","MessagePartStatus","error","ToolCallMessagePartStatus","MessageStatus","MessageTiming","streamStartTime","firstTokenTime","totalStreamTime","tokenCount","tokensPerSecond","totalChunks","toolCallCount","ThreadStep","messageId","usage","inputTokens","outputTokens","MessageCommonProps","createdAt","Date","ThreadSystemMessage","role","content","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","custom","ThreadUserMessage","attachments","isOptimistic","ThreadAssistantMessage","BaseThreadMessage","MessageRole","RunConfig","AppendMessage","Omit","sourceId","runConfig","startRun","steer"],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolCallTiming, ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { ToolCallTiming, ToolModelContentPart };\n\nexport type PartProviderMetadata = {\n  readonly [providerName: string]: ReadonlyJSONObject;\n};\n\nexport type TextMessagePart = {\n  readonly type: \"text\";\n  readonly text: string;\n  readonly status?: MessagePartStreamStatus;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type ReasoningMessagePart = {\n  readonly type: \"reasoning\";\n  readonly text: string;\n  readonly status?: MessagePartStreamStatus;\n  readonly unstable_summary?: string;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type SourceProviderMetadata = PartProviderMetadata;\n\nexport type SourceMessagePart =\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"url\";\n      readonly id: string;\n      readonly url: string;\n      readonly title?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    }\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"document\";\n      readonly id: string;\n      readonly url?: undefined;\n      readonly title: string;\n      readonly mediaType: string;\n      readonly filename?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    };\n\nexport type ImageMessagePart = {\n  readonly type: \"image\";\n  readonly image: string;\n  readonly filename?: string;\n};\n\nexport type FileMessagePart = {\n  readonly type: \"file\";\n  readonly filename?: string;\n  readonly data: string;\n  readonly mimeType: string;\n  /** How `data` goes on the wire: a url or id reference; omitted = inferred (http(s) → url, else base64). \"url\" is honored by the LangChain-family, A2A, AG-UI, and Google ADK runtimes; \"id\" by the LangChain family only. */\n  readonly sourceType?: \"url\" | \"id\";\n  readonly parentId?: string;\n};\n\n/**\n * @deprecated Use {@link FileMessagePart} with an `audio/*` mime type. `file`\n * is the carrier for every non-image binary modality: it is a member of both\n * the user and assistant unions, carries a filename, and can declare how its\n * payload goes on the wire, none of which this shape can express. The payload\n * form a `file` part needs is still adapter specific; see the Part Types\n * section of the message primitive docs. Honored everywhere it is accepted; it\n * will not gain fields.\n */\nexport type Unstable_AudioMessagePart = {\n  readonly type: \"audio\";\n  readonly audio: {\n    readonly data: string;\n    readonly format: \"mp3\" | \"wav\";\n  };\n};\n\nexport type DataMessagePart<T = any> = {\n  readonly type: \"data\";\n  readonly name: string;\n  readonly data: T;\n};\n\n/**\n * A JSON spec describing a tree of UI components to render.\n *\n * The agent emits a {@link GenerativeUIMessagePart} containing this spec, and\n * the consumer-provided component allowlist is used to resolve `component`\n * names. Any component referenced that is not present in the allowlist is\n * rejected with a typed error — the allowlist is the security boundary in the\n * default same-realm rendering path.\n */\nexport type GenerativeUINode =\n  | string\n  | {\n      /** Allowlisted component name (resolved against the consumer registry). */\n      readonly component: string;\n      /** Props passed to the resolved component (must be JSON-serializable). */\n      readonly props?: Record<string, unknown>;\n      /** Optional children — strings render as text, objects recurse. */\n      readonly children?: readonly GenerativeUINode[];\n      /** Optional stable key for React reconciliation. */\n      readonly key?: string;\n    };\n\n/**\n * The root spec for a generative UI tree.\n */\nexport type GenerativeUISpec = {\n  /** Root node(s) to render. */\n  readonly root: GenerativeUINode | readonly GenerativeUINode[];\n};\n\n/**\n * A message part that carries a JSON spec describing UI to render.\n *\n * Render with `<MessagePrimitive.GenerativeUI components={...} />`. The\n * primitive resolves component names against the consumer-provided allowlist\n * — any unknown name throws a typed error rather than rendering. Stream-\n * friendly: a partially-streamed spec renders progressively.\n */\nexport type GenerativeUIMessagePart = {\n  readonly type: \"generative-ui\";\n  /** The JSON spec describing the UI tree. */\n  readonly spec: GenerativeUISpec;\n  /** Optional id (useful for replays / stable keys). */\n  readonly id?: string;\n  readonly parentId?: string;\n};\n\nexport type McpAppMetadata = {\n  readonly resourceUri: string;\n  readonly mimeType?: string;\n  readonly visibility?: readonly (\"model\" | \"app\")[];\n  /** Routable server identity emitted by the agent stack when multiple MCP servers back one agent; for @ag-ui/mcp-apps-middleware this is the configured serverId, falling back to its serverHash. */\n  readonly serverId?: string;\n};\n\nexport const MCP_APP_URI_SCHEME = \"ui://\";\n\nexport const isMcpAppUri = (uri: string | undefined): boolean =>\n  !!uri?.startsWith(MCP_APP_URI_SCHEME);\n\nexport type ToolCallMessagePartMcpMetadata = {\n  readonly app?: McpAppMetadata;\n};\n\nexport type ToolApprovalOptionKind =\n  | \"allow-once\"\n  | \"allow-always\"\n  | \"reject-once\"\n  | \"reject-always\";\n\nexport type ToolApprovalOption = {\n  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */\n  readonly id: string;\n  /**\n   * Decision class. Drives approved-resolution and default rendering.\n   * Open union: `_`-prefixed custom kinds are never auto-resolved and the\n   * default kit skips them; they must be answered with an explicit\n   * `approved` value (optionally alongside the `optionId`).\n   */\n  readonly kind: ToolApprovalOptionKind | (string & {});\n  /** Human label. Renderers supply defaults per kind when omitted. */\n  readonly label?: string;\n  readonly description?: string;\n  /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */\n  readonly grants?: readonly string[];\n  /** Opt-in confirmation step before this option resolves. */\n  readonly confirm?: boolean | { title?: string; description?: string };\n};\n\nexport type ToolApprovalResponse =\n  | { readonly approved: boolean; readonly reason?: string }\n  | { readonly optionId: string; readonly reason?: string }\n  | {\n      readonly approved: boolean;\n      readonly optionId: string;\n      readonly reason?: string;\n    };\n\nexport type ToolCallMessagePart<\n  TArgs = ReadonlyJSONObject,\n  TResult = unknown,\n> = {\n  /** Identifies this part as a tool call. */\n  readonly type: \"tool-call\";\n  /** Stable identifier for this invocation of the tool. */\n  readonly toolCallId: string;\n  /** Name of the tool requested by the model. */\n  readonly toolName: string;\n  /**\n   * Arguments supplied by the model. During streaming this is a partial parse:\n   * fields may be missing or incomplete. From a tool-call renderer, use\n   * `useToolArgsStatus` to detect which fields are still arriving.\n   */\n  readonly args: TArgs;\n  /** Result returned by the tool, if it has completed. */\n  readonly result?: TResult | undefined;\n  /** Whether the result represents a tool execution error. */\n  readonly isError?: boolean | undefined;\n  /** Raw JSON argument text streamed by the model. */\n  readonly argsText: string;\n  /** UI-only artifact associated with the tool result. */\n  readonly artifact?: unknown;\n  /** Wall-clock timing for this call, when the runtime or host tracks it. */\n  readonly timing?: ToolCallTiming;\n  /** MCP app metadata associated with this tool call, when present. */\n  readonly mcp?: ToolCallMessagePartMcpMetadata;\n  /** Provider metadata associated with this tool call, when present. */\n  readonly providerMetadata?: PartProviderMetadata;\n  /** Content returned to the model for this tool result. */\n  readonly modelContent?: readonly ToolModelContentPart[] | undefined;\n  /** Human-input request that must be resolved before the run can continue. */\n  readonly interrupt?: { type: \"human\"; payload: unknown };\n  /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */\n  readonly approval?: {\n    readonly id: string;\n    readonly approved?: boolean;\n    readonly reason?: string;\n    readonly isAutomatic?: boolean;\n    /** Available decisions for this call. Absent: a plain allow / deny pair. */\n    readonly options?: readonly ToolApprovalOption[];\n    /** The option chosen at resolution, when options were present. */\n    readonly optionId?: string;\n    /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */\n    readonly resolution?: \"cancelled\" | \"expired\";\n  };\n  /** Parent message-part ID when this part belongs to a nested structure. */\n  readonly parentId?: string;\n  /**\n   * Nested thread messages produced by this tool call, for example a sub-agent\n   * conversation.\n   */\n  readonly messages?: readonly ThreadMessage[];\n};\n\nexport type ThreadUserMessagePart =\n  | TextMessagePart\n  | ImageMessagePart\n  | FileMessagePart\n  | DataMessagePart\n  | Unstable_AudioMessagePart;\n\nexport type ThreadAssistantMessagePart =\n  | TextMessagePart\n  | ReasoningMessagePart\n  | ToolCallMessagePart\n  | SourceMessagePart\n  | FileMessagePart\n  | ImageMessagePart\n  | DataMessagePart\n  | GenerativeUIMessagePart;\n\nexport type MessagePartStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: unknown;\n    };\n\nexport type MessagePartStreamStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n    };\n\nexport type ToolCallMessagePartStatus =\n  | {\n      /** The tool call is waiting for UI or human input before continuing. */\n      readonly type: \"requires-action\";\n      /** Reason the tool call requires action. */\n      readonly reason: \"interrupt\";\n    }\n  | MessagePartStatus;\n\nexport type MessageStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"requires-action\";\n      readonly reason: \"tool-calls\" | \"interrupt\";\n    }\n  | {\n      readonly type: \"complete\";\n      readonly reason: \"stop\" | \"unknown\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"tool-calls\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: ReadonlyJSONValue;\n    };\n\nexport type MessageTiming = {\n  readonly streamStartTime: number;\n  readonly firstTokenTime?: number;\n  readonly totalStreamTime?: number;\n  readonly tokenCount?: number;\n  readonly tokensPerSecond?: number;\n  readonly totalChunks: number;\n  readonly toolCallCount: number;\n};\n\nexport type ThreadStep = {\n  readonly messageId?: string;\n  readonly usage?:\n    | {\n        readonly inputTokens: number;\n        readonly outputTokens: number;\n      }\n    | undefined;\n};\n\ntype MessageCommonProps = {\n  readonly id: string;\n  readonly createdAt: Date;\n};\n\nexport type ThreadSystemMessage = MessageCommonProps & {\n  readonly role: \"system\";\n  readonly content: readonly [TextMessagePart];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadUserMessage = MessageCommonProps & {\n  readonly role: \"user\";\n  readonly content: readonly ThreadUserMessagePart[];\n  readonly attachments: readonly CompleteAttachment[];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadAssistantMessage = MessageCommonProps & {\n  readonly role: \"assistant\";\n  readonly content: readonly ThreadAssistantMessagePart[];\n  readonly status: MessageStatus;\n  readonly metadata: {\n    readonly unstable_state: ReadonlyJSONValue;\n    readonly unstable_annotations: readonly ReadonlyJSONValue[];\n    readonly unstable_data: readonly ReadonlyJSONValue[];\n    readonly steps: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    /**\n     * Marks a client-side optimistic placeholder. Such messages are evicted\n     * once off the head branch and are never persisted.\n     */\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\ntype BaseThreadMessage = {\n  readonly status?: ThreadAssistantMessage[\"status\"];\n  readonly metadata: {\n    readonly unstable_state?: ReadonlyJSONValue;\n    readonly unstable_annotations?: readonly ReadonlyJSONValue[];\n    readonly unstable_data?: readonly ReadonlyJSONValue[];\n    readonly steps?: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n  readonly attachments?: ThreadUserMessage[\"attachments\"];\n};\n\nexport type ThreadMessage = BaseThreadMessage &\n  (ThreadSystemMessage | ThreadUserMessage | ThreadAssistantMessage);\n\nexport type MessageRole = ThreadMessage[\"role\"];\n\nexport type RunConfig = {\n  readonly custom?: Record<string, unknown>;\n};\n\nexport type AppendMessage = Omit<ThreadMessage, \"id\"> & {\n  parentId: string | null;\n\n  /** The ID of the message that was edited or undefined. */\n  sourceId: string | null;\n  runConfig: RunConfig | undefined;\n  startRun?: boolean | undefined;\n  /** Process this message next; only meaningful for queue-capable runtimes. */\n  steer?: boolean | undefined;\n};\n"],"mappings":";AAoJA,MAAaiD,qBAAqB;AAElC,MAAaC,eAAeC,QAC1B,CAAC,CAACA,KAAKC,WAAWH,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -58,14 +58,8 @@
     "README.md"
   ],
   "sideEffects": false,
-  "scripts": {
-    "build": "aui-build",
-    "test": "vitest run",
-    "test:react-compiler": "vitest run --config vitest.react-compiler.config.ts",
-    "test:watch": "vitest"
-  },
   "dependencies": {
-    "assistant-stream": "^0.3.34",
+    "assistant-stream": "^0.3.35",
     "nanoid": "^6.0.0"
   },
   "optionalDevDependencies": {
@@ -94,18 +88,18 @@
     }
   },
   "devDependencies": {
-    "@assistant-ui/store": "workspace:*",
-    "@assistant-ui/tap": "workspace:*",
-    "@assistant-ui/vite": "workspace:*",
-    "@assistant-ui/x-buildutils": "workspace:*",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
-    "assistant-cloud": "workspace:*",
     "jsdom": "^29.1.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "vitest": "^4.1.10",
-    "zustand": "^5.0.14"
+    "zustand": "^5.0.14",
+    "@assistant-ui/tap": "0.9.10",
+    "@assistant-ui/vite": "0.0.11",
+    "@assistant-ui/store": "0.3.7",
+    "@assistant-ui/x-buildutils": "0.0.21",
+    "assistant-cloud": "0.1.38"
   },
   "publishConfig": {
     "access": "public",
@@ -119,5 +113,11 @@
   },
   "bugs": {
     "url": "https://github.com/assistant-ui/assistant-ui/issues"
+  },
+  "scripts": {
+    "build": "aui-build",
+    "test": "vitest run",
+    "test:react-compiler": "vitest run --config vitest.react-compiler.config.ts",
+    "test:watch": "vitest"
   }
-}
+}

package/src/react/runtimes/cloud/auiV0.ts

@@ -32,6 +32,7 @@ type AuiV0MessagePart =
   | {
       readonly type: "reasoning";
       readonly text: string;
+      readonly unstable_summary?: string;
     }
   | {
       readonly type: "source";
@@ -226,7 +227,13 @@ export function auiV0Encode(message: ThreadMessage): AuiV0Message {
           return { type: "text", text: part.text };
 
         case "reasoning":
-          return { type: "reasoning", text: part.text };
+          return {
+            type: "reasoning",
+            text: part.text,
+            ...(part.unstable_summary !== undefined
+              ? { unstable_summary: part.unstable_summary }
+              : undefined),
+          };
 
         case "source":
           if (part.sourceType === "url") {

package/src/runtime/base/default-edit-composer-runtime-core.ts

@@ -1,7 +1,7 @@
 import type { AppendMessage, ThreadMessage } from "../../types/message";
 import type { CompleteAttachment } from "../../types/attachment";
 import { getThreadMessageText } from "../../utils/text";
-import { attachmentsEqual, liftNonTextParts } from "../../adapters/attachment";
+import { liftNonTextParts } from "../../adapters/attachment";
 import type { AttachmentAdapter } from "../../adapters/attachment";
 import type { DictationAdapter } from "../../adapters/speech";
 import type { SendOptions } from "../interfaces/composer-runtime-core";
@@ -26,8 +26,6 @@ export class DefaultEditComposerRuntimeCore extends BaseComposerRuntimeCore {
     return this.runtime.adapters?.dictation;
   }
 
-  private _previousText;
-  private _previousAttachments: readonly CompleteAttachment[];
   private _nonTextPassthrough: readonly ThreadMessage["content"][number][];
   private _parentId: string | null;
   private _sourceId: string | null;
@@ -58,24 +56,24 @@ export class DefaultEditComposerRuntimeCore extends BaseComposerRuntimeCore {
     this.endEditCallback = endEditCallback;
     this._parentId = parentId;
     this._sourceId = message.id;
-    this._previousText = getThreadMessageText(message);
-    this.setText(this._previousText);
+    this.setText(getThreadMessageText(message));
 
     this.setRole(message.role);
 
+    let attachments: readonly CompleteAttachment[];
     if (message.role === "user") {
-      this._previousAttachments = [
+      attachments = [
         ...(message.attachments ?? []),
         ...liftNonTextParts(message.content),
       ];
       this._nonTextPassthrough = [];
     } else {
-      this._previousAttachments = message.attachments ?? [];
+      attachments = message.attachments ?? [];
       this._nonTextPassthrough = message.content.filter(
         (p) => p.type !== "text",
       );
     }
-    this.setAttachments(this._previousAttachments);
+    this.setAttachments(attachments);
 
     this.setRunConfig({ ...runtime.composer.runConfig });
   }
@@ -92,49 +90,33 @@ export class DefaultEditComposerRuntimeCore extends BaseComposerRuntimeCore {
     message: Omit<AppendMessage, "parentId" | "sourceId">,
     options?: SendOptions,
   ) {
-    let appendTask: void | Promise<void> = undefined;
-    const text = getThreadMessageText(message as AppendMessage);
-    const attachmentsChanged = !attachmentsEqual(
-      message.attachments ?? [],
-      this._previousAttachments,
+    const content =
+      this._nonTextPassthrough.length > 0
+        ? ([
+            ...message.content,
+            ...this._nonTextPassthrough,
+          ] as AppendMessage["content"])
+        : message.content;
+    // Gate live state against the new branch's prefix (messages up to the
+    // parent): an unchanged interactable re-stamps the prior baseline, an
+    // interactable edited since the original message stamps its newest state.
+    const messages = this.runtime.messages;
+    const parentIndex =
+      this._parentId === null
+        ? -1
+        : messages.findIndex((m) => m.id === this._parentId);
+    const composerMetadata = gateInteractableComposerMetadata(
+      this.runtime.getModelContext().unstable_composerMetadata,
+      messages.slice(0, parentIndex + 1),
     );
-
-    if (
-      text !== this._previousText ||
-      attachmentsChanged ||
-      options?.startRun
-    ) {
-      const content =
-        this._nonTextPassthrough.length > 0
-          ? ([
-              ...message.content,
-              ...this._nonTextPassthrough,
-            ] as AppendMessage["content"])
-          : message.content;
-      // Gate live state against the new branch's prefix (messages up to the
-      // parent): an unchanged interactable re-stamps the prior baseline, an
-      // interactable edited since the original message stamps its newest state.
-      const messages = this.runtime.messages;
-      const parentIndex =
-        this._parentId === null
-          ? -1
-          : messages.findIndex((m) => m.id === this._parentId);
-      const composerMetadata = gateInteractableComposerMetadata(
-        this.runtime.getModelContext().unstable_composerMetadata,
-        messages.slice(0, parentIndex + 1),
-      );
-      const enriched = this.enrichWithComposerMetadata(
-        message,
-        composerMetadata,
-      );
-      appendTask = this.runtime.append({
-        ...enriched,
-        content,
-        parentId: this._parentId,
-        sourceId: this._sourceId,
-        startRun: options?.startRun,
-      });
-    }
+    const enriched = this.enrichWithComposerMetadata(message, composerMetadata);
+    const appendTask = this.runtime.append({
+      ...enriched,
+      content,
+      parentId: this._parentId,
+      sourceId: this._sourceId,
+      startRun: options?.startRun,
+    });
 
     this.handleCancel();
     return appendTask;

package/src/runtime/utils/thread-message-like.ts

@@ -160,10 +160,14 @@ export const fromThreadMessageLike = (
             const type = part.type;
             switch (type) {
               case "text":
-              case "reasoning":
                 if (!part.text?.trim()) return null;
                 return part;
 
+              case "reasoning":
+                if (!part.text?.trim() && !part.unstable_summary?.trim())
+                  return null;
+                return part;
+
               case "file":
               case "source":
                 return part;

package/src/runtimes/external-store/external-store-thread-runtime-core.ts

@@ -466,7 +466,11 @@ export class ExternalStoreThreadRuntimeCore
   }
 
   public async append(message: AppendMessage): Promise<void> {
-    const isEdit = message.parentId !== (this.messages.at(-1)?.id ?? null);
+    // sourceId marks an edit send; the parent may coincide with the head
+    // after a resync (e.g. cancelRun dropped the edited message).
+    const isEdit =
+      message.sourceId != null ||
+      message.parentId !== (this.messages.at(-1)?.id ?? null);
 
     // Buffering does not start a run, so the tool-abort below must wait until
     // the queue flushes. By then the prior run (and its tools) has settled.

package/src/store/runtime-clients/lookup-domains.test.ts

@@ -0,0 +1,109 @@
+import { describe, expect, it } from "vitest";
+import { AuiConfig, createAssistantClient } from "@assistant-ui/store/client";
+import { RuntimeAdapter, Suggestions } from "../index";
+import { ExternalStoreRuntimeCore } from "../../runtimes/internal";
+import { AssistantRuntimeImpl } from "../../runtime/internal";
+import type { ExternalStoreAdapter } from "../../runtimes/external-store/external-store-adapter";
+
+type DemoMessage = { id: string; role: "user" | "assistant"; text: string };
+
+const createClient = () => {
+  const adapter: ExternalStoreAdapter<DemoMessage> = {
+    messages: [
+      { id: "u1", role: "user", text: "hi" },
+      { id: "a1", role: "assistant", text: "hello" },
+    ],
+    convertMessage: (message) => ({
+      id: message.id,
+      role: message.role,
+      content: [{ type: "text", text: message.text }],
+    }),
+    onNew: async () => {},
+    adapters: {
+      threadList: {
+        threadId: "t1",
+        threads: [{ status: "regular", id: "t1", title: "one" }],
+        archivedThreads: [{ status: "archived", id: "t2", title: "two" }],
+      },
+    },
+  };
+  const runtime = new AssistantRuntimeImpl(
+    new ExternalStoreRuntimeCore(adapter),
+  );
+  return createAssistantClient(
+    AuiConfig({
+      threads: RuntimeAdapter(runtime),
+      suggestions: Suggestions([
+        { title: "a", label: "a", prompt: "a" },
+        { title: "b", label: "b", prompt: "b" },
+      ]),
+    }),
+  );
+};
+
+/**
+ * Pins each by-index lookup's valid domain to the state array that backs it.
+ * Consumers (the vue by-index providers) guard with `index < array.length`
+ * against these arrays; a lookup changing its backing array must fail here.
+ */
+describe("by-index lookup domains", () => {
+  it("thread.message is indexed by thread.getState().messages", () => {
+    const handle = createClient();
+    const aui = handle.getClient();
+    const length = aui.thread.getState().messages.length;
+    expect(length).toBe(2);
+    expect(aui.thread.message({ index: length - 1 }).getState().id).toBe("a1");
+    expect(() => aui.thread.message({ index: length }).getState()).toThrow(
+      /out of bounds/,
+    );
+    handle.destroy();
+  });
+
+  it("message.part is indexed by message.getState().parts", () => {
+    const handle = createClient();
+    const aui = handle.getClient();
+    const message = aui.thread.message({ index: 1 });
+    const length = message.getState().parts.length;
+    expect(length).toBe(1);
+    expect(message.part({ index: length - 1 }).getState().type).toBe("text");
+    expect(() => message.part({ index: length }).getState()).toThrow(
+      /out of bounds/,
+    );
+    handle.destroy();
+  });
+
+  it("suggestions.suggestion is indexed by suggestions.getState().suggestions", () => {
+    const handle = createClient();
+    const aui = handle.getClient();
+    const length = aui.suggestions.getState().suggestions.length;
+    expect(length).toBe(2);
+    expect(
+      aui.suggestions.suggestion({ index: length - 1 }).getState().title,
+    ).toBe("b");
+    expect(() =>
+      aui.suggestions.suggestion({ index: length }).getState(),
+    ).toThrow(/out of bounds/);
+    handle.destroy();
+  });
+
+  it("threads.item is indexed by threadIds and archivedThreadIds", () => {
+    const handle = createClient();
+    const aui = handle.getClient();
+    const state = aui.threads.getState();
+    expect(state.threadIds).toHaveLength(1);
+    expect(state.archivedThreadIds).toHaveLength(1);
+    expect(aui.threads.item({ index: 0, archived: false }).getState().id).toBe(
+      "t1",
+    );
+    expect(aui.threads.item({ index: 0, archived: true }).getState().id).toBe(
+      "t2",
+    );
+    expect(() =>
+      aui.threads.item({ index: 1, archived: false }).getState(),
+    ).toThrow(/not found|out of bounds/);
+    expect(() =>
+      aui.threads.item({ index: 1, archived: true }).getState(),
+    ).toThrow(/not found|out of bounds/);
+    handle.destroy();
+  });
+});

package/src/tests/auiV0Encode.test.ts

@@ -236,6 +236,33 @@ describe("auiV0Encode", () => {
     ]);
   });
 
+  it("preserves reasoning summaries and omits absent summaries", () => {
+    const encoded = auiV0Encode({
+      id: "m1",
+      createdAt: new Date("2026-03-15T00:00:00.000Z"),
+      role: "assistant",
+      status: { type: "complete", reason: "stop" },
+      metadata: {
+        unstable_state: null,
+        unstable_annotations: [],
+        unstable_data: [],
+        steps: [],
+        custom: {},
+      },
+      content: [
+        { type: "reasoning", text: "thinking", unstable_summary: "Planning" },
+        { type: "reasoning", text: "more thinking", unstable_summary: "" },
+        { type: "reasoning", text: "no summary" },
+      ],
+    });
+
+    expect(encoded.content).toEqual([
+      { type: "reasoning", text: "thinking", unstable_summary: "Planning" },
+      { type: "reasoning", text: "more thinking", unstable_summary: "" },
+      { type: "reasoning", text: "no summary" },
+    ]);
+  });
+
   it("drops per-part status from attachment content in the core cloud encoder", () => {
     const encoded = auiV0Encode({
       id: "m1",
@@ -306,6 +333,76 @@ describe("auiV0Encode", () => {
 });
 
 describe("auiV0Decode", () => {
+  it("round-trips a reasoning summary", () => {
+    const encoded = auiV0Encode({
+      id: "local",
+      createdAt: new Date("2026-03-15T00:00:00.000Z"),
+      role: "assistant",
+      status: { type: "complete", reason: "stop" },
+      metadata: {
+        unstable_state: null,
+        unstable_annotations: [],
+        unstable_data: [],
+        steps: [],
+        custom: {},
+      },
+      content: [
+        { type: "reasoning", text: "thinking", unstable_summary: "Planning" },
+      ],
+    });
+
+    const { message } = auiV0Decode({
+      id: "cloud",
+      parent_id: null,
+      format: "aui/v0",
+      content: encoded,
+      created_at: new Date("2026-03-15T00:00:00.000Z"),
+    } as unknown as Parameters<typeof auiV0Decode>[0]);
+
+    expect(message.content).toEqual([
+      { type: "reasoning", text: "thinking", unstable_summary: "Planning" },
+    ]);
+  });
+
+  it("round-trips a reasoning summary without text", () => {
+    const encoded = auiV0Encode({
+      id: "local",
+      createdAt: new Date("2026-03-15T00:00:00.000Z"),
+      role: "assistant",
+      status: { type: "complete", reason: "stop" },
+      metadata: {
+        unstable_state: null,
+        unstable_annotations: [],
+        unstable_data: [],
+        steps: [],
+        custom: {},
+      },
+      content: [
+        {
+          type: "reasoning",
+          text: "",
+          unstable_summary: "Searching the codebase",
+        },
+      ],
+    });
+
+    const { message } = auiV0Decode({
+      id: "cloud",
+      parent_id: null,
+      format: "aui/v0",
+      content: encoded,
+      created_at: new Date("2026-03-15T00:00:00.000Z"),
+    } as unknown as Parameters<typeof auiV0Decode>[0]);
+
+    expect(message.content).toEqual([
+      {
+        type: "reasoning",
+        text: "",
+        unstable_summary: "Searching the codebase",
+      },
+    ]);
+  });
+
   it("round-trips a pending tool-call approval so a paused run stays resumable", () => {
     const content = auiV0Encode({
       id: "local",

package/src/tests/default-edit-composer-runtime-core.test.ts

@@ -132,7 +132,7 @@ describe("DefaultEditComposerRuntimeCore", () => {
   });
 
   describe("send behavior", () => {
-    it("does not call append when nothing changed", async () => {
+    it("calls append even when nothing changed, branching with the same message", async () => {
       const { runtime, append } = makeRuntime();
       const composer = new DefaultEditComposerRuntimeCore(runtime, () => {}, {
         parentId: "p1",
@@ -141,7 +141,11 @@ describe("DefaultEditComposerRuntimeCore", () => {
         }),
       });
       await composer.send();
-      expect(append).not.toHaveBeenCalled();
+      expect(append).toHaveBeenCalledTimes(1);
+      const appended = append.mock.calls[0]![0] as AppendMessage;
+      expect(appended.content).toEqual([{ type: "text", text: "same" }]);
+      expect(appended.parentId).toBe("p1");
+      expect(appended.sourceId).toBe("msg-1");
     });
 
     it("calls append when text changes", async () => {

package/src/tests/external-store-thread-runtime-core.test.ts

@@ -883,6 +883,42 @@ describe("ExternalStoreThreadRuntimeCore - message queue", () => {
     expect(queue.steer).toHaveBeenCalledTimes(1);
   });
 
+  it("routes an edit send to onEdit even when anchored at the head", async () => {
+    const queue = makeQueue();
+    const onNew = vi.fn();
+    const onEdit = vi.fn();
+    const runtime = new ExternalStoreThreadRuntimeCore(
+      mockContextProvider,
+      makeStore({ queue, onNew, onEdit }),
+    );
+
+    await runtime.append(appendMessage({ sourceId: "u1" }));
+
+    expect(onEdit).toHaveBeenCalledTimes(1);
+    expect(onEdit.mock.calls[0]![0]).toMatchObject({
+      sourceId: "u1",
+      parentId: null,
+    });
+    expect(onNew).not.toHaveBeenCalled();
+    expect(queue.enqueue).not.toHaveBeenCalled();
+    expect(queue.steer).not.toHaveBeenCalled();
+  });
+
+  it("throws the edit capability error for an edit send instead of queueing it", async () => {
+    const queue = makeQueue();
+    const onNew = vi.fn();
+    const runtime = new ExternalStoreThreadRuntimeCore(
+      mockContextProvider,
+      makeStore({ queue, onNew }),
+    );
+
+    await expect(
+      runtime.append(appendMessage({ sourceId: "u1" })),
+    ).rejects.toThrow("Runtime does not support editing messages.");
+    expect(onNew).not.toHaveBeenCalled();
+    expect(queue.enqueue).not.toHaveBeenCalled();
+  });
+
   it("defaults a mid-run send to steer and an idle send to enqueue", async () => {
     const queue = makeQueue();
     const running = new ExternalStoreThreadRuntimeCore(

package/src/tests/thread-message-like.test.ts

@@ -147,6 +147,49 @@ describe("fromThreadMessageLike", () => {
       expect(result.content).toEqual([{ type: "reasoning", text: "hi" }]);
     });
 
+    it("keeps a reasoning part with a summary and no text", () => {
+      const result = fromThreadMessageLike(
+        {
+          role: "assistant",
+          content: [
+            {
+              type: "reasoning",
+              text: "",
+              unstable_summary: "Searching the codebase",
+            },
+          ],
+        },
+        fallbackId,
+        fallbackStatus,
+      );
+
+      expect(result.content).toEqual([
+        {
+          type: "reasoning",
+          text: "",
+          unstable_summary: "Searching the codebase",
+        },
+      ]);
+    });
+
+    it("drops a reasoning part with neither text nor a summary to show", () => {
+      // the transport layers round-trip an empty summary faithfully; this is
+      // the display normalizer, so it drops a part with nothing to render for
+      // the same reason it drops whitespace-only text.
+      const message = fromThreadMessageLike(
+        {
+          role: "assistant",
+          content: [
+            { type: "reasoning", text: "", unstable_summary: "" },
+            { type: "reasoning", text: "  ", unstable_summary: "   " },
+          ],
+        },
+        "m1",
+        { type: "complete", reason: "unknown" },
+      );
+
+      expect(message.content).toEqual([]);
+    });
     it("drops an assistant image part whose image is undefined", () => {
       const result = fromThreadMessageLike(
         {