@assistant-ui/core 0.3.19 → 0.3.20

package/dist/runtime/utils/thread-message-like.d.ts

@@ -6,7 +6,7 @@ type DataPrefixedPart = {
   readonly type: `data-${string}`;
   readonly data: any;
 };
-type ThreadMessageLike = {
+export type ThreadMessageLike = {
   readonly role: "assistant" | "user" | "system";
   readonly content: string | readonly (TextMessagePart | ReasoningMessagePart | SourceMessagePart | ImageMessagePart | FileMessagePart | DataMessagePart | GenerativeUIMessagePart | Unstable_AudioMessagePart | DataPrefixedPart | {
     readonly type: "tool-call";
@@ -35,14 +35,15 @@ type ThreadMessageLike = {
     readonly content: readonly (ThreadUserMessagePart | DataPrefixedPart)[];
   })[] | undefined;
   readonly metadata?: {
-    readonly unstable_state?: ReadonlyJSONValue;
+    readonly unstable_state?: ReadonlyJSONValue | undefined;
     readonly unstable_annotations?: readonly ReadonlyJSONValue[] | undefined;
     readonly unstable_data?: readonly ReadonlyJSONValue[] | undefined;
     readonly steps?: readonly ThreadStep[] | undefined;
     readonly timing?: MessageTiming | undefined;
     readonly submittedFeedback?: {
       readonly type: "positive" | "negative";
-    };
+      readonly comment?: string;
+    } | undefined;
     readonly isOptimistic?: boolean | undefined;
     readonly modality?: MessageModality | undefined;
     readonly custom?: Record<string, unknown> | undefined;
@@ -51,7 +52,6 @@ type ThreadMessageLike = {
 /**
  * @deprecated This API is experimental and may change without notice.
  */
-declare const fromThreadMessageLike: (like: ThreadMessageLike, fallbackId: string, fallbackStatus: MessageStatus) => ThreadMessage;
+export declare const fromThreadMessageLike: (like: ThreadMessageLike, fallbackId: string, fallbackStatus: MessageStatus) => ThreadMessage;
 //#endregion
-export { ThreadMessageLike, fromThreadMessageLike };
 //# sourceMappingURL=thread-message-like.d.ts.map

package/dist/runtime/utils/thread-message-like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread-message-like.d.ts","names":[],"sources":["../../../src/runtime/utils/thread-message-like.ts"],"mappings":";;;;KAmCK;WACM;WACA;;KAGC;WACD;WACA,4BAGD,kBACA,uBACA,oBACA,mBACA,kBACA,kBACA,0BACA,4BACA;aAEW;aACA;aACA;aACA,OAAO;aACP;aACA;aACA;aACA;aACA;aACA,oBAAoB;aACpB;MAAc;MAAe;;aAC7B,SAAS;aACT,MAAM;aACN,mBAAmB;aACnB,WAAW,YAAY;;WAGjC;WACA,YAAY;WACZ,SAAS;WACT,wBACK,KAAK;aACJ,mBAAmB,wBAAwB;;WAGjD;aAEM,iBAAiB;aACjB,gCACI;aAEJ,yBAAyB;aACzB,iBAAiB;aACjB,SAAS;aACT;eAA+B;;aAC/B;aACA,WAAW;aACX,SAAS;;;;;;cAgBb,wBACX,MAAM,mBACN,oBACA,gBAAgB,kBACf"}
+{"version":3,"file":"thread-message-like.d.ts","names":[],"sources":["../../../src/runtime/utils/thread-message-like.ts"],"mappings":";;;;KAmCK;WACM;WACA;;YAGC;WACD;WACA,4BAGD,kBACA,uBACA,oBACA,mBACA,kBACA,kBACA,0BACA,4BACA;aAEW;aACA;aACA;aACA,OAAO;aACP;aACA;aACA;aACA;aACA;aACA,oBAAoB;aACpB;MAAc;MAAe;;aAC7B,SAAS;aACT,MAAM;aACN,mBAAmB;aACnB,WAAW,YAAY;;WAGjC;WACA,YAAY;WACZ,SAAS;WACT,wBACK,KAAK;aACJ,mBAAmB,wBAAwB;;WAGjD;aAEM,iBAAiB;aACjB,gCACI;aAEJ,yBAAyB;aACzB,iBAAiB;aACjB,SAAS;aACT;eAEM;eACA;;aAGN;aACA,WAAW;aACX,SAAS;;;;;;qBAgBb,wBACX,MAAM,mBACN,oBACA,gBAAgB,kBACf"}

package/dist/runtime/utils/thread-message-like.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread-message-like.js","names":["parsePartialJsonObject","generateId","parseDataUrl","ReasoningMessagePart","SourceMessagePart","ThreadStep","MessageStatus","ImageMessagePart","ThreadMessage","ThreadAssistantMessagePart","ThreadAssistantMessage","ThreadUserMessagePart","ThreadUserMessage","ThreadSystemMessage","FileMessagePart","DataMessagePart","GenerativeUIMessagePart","Unstable_AudioMessagePart","CompleteAttachment","MessageModality","MessageTiming","PartProviderMetadata","TextMessagePart","ToolCallTiming","ToolCallMessagePart","ToolCallMessagePartMcpMetadata","ReadonlyJSONObject","ReadonlyJSONValue","DataPrefixedPart","type","data","ThreadMessageLike","role","content","toolCallId","toolName","args","argsText","artifact","result","isError","parentId","messages","interrupt","payload","timing","mcp","providerMetadata","approval","NonNullable","id","createdAt","Date","status","attachments","Omit","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","isOptimistic","modality","custom","Record","convertDataPrefixedPart","startsWith","undefined","name","substring","fromThreadMessageLike","like","fallbackId","fallbackStatus","common","const","text","sanitizeImageContent","image","rest","mimeType","test","console","warn","length","Error","map","part","trim","unstable_summary","basePart","commonProps","JSON","stringify","converted","filter","c","att","unsupportedRole"],"sources":["../../../src/runtime/utils/thread-message-like.ts"],"sourcesContent":["import { parsePartialJsonObject } from \"assistant-stream/utils\";\nimport { generateId } from \"../../utils/id\";\nimport { parseDataUrl } from \"../../utils/data-url\";\nimport type {\n  ReasoningMessagePart,\n  SourceMessagePart,\n  ThreadStep,\n  MessageStatus,\n  ImageMessagePart,\n  ThreadMessage,\n  ThreadAssistantMessagePart,\n  ThreadAssistantMessage,\n  ThreadUserMessagePart,\n  ThreadUserMessage,\n  ThreadSystemMessage,\n  FileMessagePart,\n  DataMessagePart,\n  GenerativeUIMessagePart,\n  Unstable_AudioMessagePart,\n} from \"../../types/message\";\nimport type { CompleteAttachment } from \"../../types/attachment\";\nimport type {\n  MessageModality,\n  MessageTiming,\n  PartProviderMetadata,\n  TextMessagePart,\n  ToolCallTiming,\n  ToolCallMessagePart,\n  ToolCallMessagePartMcpMetadata,\n} from \"../../types/message\";\nimport type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\n\ntype DataPrefixedPart = {\n  readonly type: `data-${string}`;\n  readonly data: any;\n};\n\nexport type ThreadMessageLike = {\n  readonly role: \"assistant\" | \"user\" | \"system\";\n  readonly content:\n    | string\n    | readonly (\n        | TextMessagePart\n        | ReasoningMessagePart\n        | SourceMessagePart\n        | ImageMessagePart\n        | FileMessagePart\n        | DataMessagePart\n        | GenerativeUIMessagePart\n        | Unstable_AudioMessagePart\n        | DataPrefixedPart\n        | {\n            readonly type: \"tool-call\";\n            readonly toolCallId?: string;\n            readonly toolName: string;\n            readonly args?: ReadonlyJSONObject;\n            readonly argsText?: string;\n            readonly artifact?: any;\n            readonly result?: any | undefined;\n            readonly isError?: boolean | undefined;\n            readonly parentId?: string | undefined;\n            readonly messages?: readonly ThreadMessage[] | undefined;\n            readonly interrupt?: { type: \"human\"; payload: unknown };\n            readonly timing?: ToolCallTiming;\n            readonly mcp?: ToolCallMessagePartMcpMetadata;\n            readonly providerMetadata?: PartProviderMetadata;\n            readonly approval?: NonNullable<ToolCallMessagePart[\"approval\"]>;\n          }\n      )[];\n  readonly id?: string | undefined;\n  readonly createdAt?: Date | undefined;\n  readonly status?: MessageStatus | undefined;\n  readonly attachments?:\n    | readonly (Omit<CompleteAttachment, \"content\"> & {\n        readonly content: readonly (ThreadUserMessagePart | DataPrefixedPart)[];\n      })[]\n    | undefined;\n  readonly metadata?:\n    | {\n        readonly unstable_state?: ReadonlyJSONValue;\n        readonly unstable_annotations?:\n          | readonly ReadonlyJSONValue[]\n          | undefined;\n        readonly unstable_data?: readonly ReadonlyJSONValue[] | undefined;\n        readonly steps?: readonly ThreadStep[] | undefined;\n        readonly timing?: MessageTiming | undefined;\n        readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n        readonly isOptimistic?: boolean | undefined;\n        readonly modality?: MessageModality | undefined;\n        readonly custom?: Record<string, unknown> | undefined;\n      }\n    | undefined;\n};\n\nconst convertDataPrefixedPart = (\n  type: string,\n  data: unknown,\n): DataMessagePart | undefined => {\n  if (!type.startsWith(\"data-\")) return undefined;\n  return { type: \"data\", name: type.substring(5), data };\n};\n\n/**\n * @deprecated This API is experimental and may change without notice.\n */\nexport const fromThreadMessageLike = (\n  like: ThreadMessageLike,\n  fallbackId: string,\n  fallbackStatus: MessageStatus,\n): ThreadMessage => {\n  const { role, id, createdAt, attachments, status, metadata } = like;\n  const common = {\n    id: id ?? fallbackId,\n    createdAt: createdAt ?? new Date(),\n  };\n\n  const content =\n    typeof like.content === \"string\"\n      ? [{ type: \"text\" as const, text: like.content }]\n      : like.content;\n\n  const sanitizeImageContent = ({\n    image,\n    ...rest\n  }: ImageMessagePart): ImageMessagePart | null => {\n    if (typeof image !== \"string\") return null;\n    if (parseDataUrl(image)?.mimeType.startsWith(\"image/\")) {\n      return { ...rest, image };\n    }\n    if (/^(https:\\/\\/|blob:)/i.test(image)) {\n      return { ...rest, image };\n    }\n    console.warn(`Invalid image data format detected`);\n    return null;\n  };\n\n  if (role !== \"user\" && attachments?.length)\n    throw new Error(\"attachments are only supported for user messages\");\n\n  if (role !== \"assistant\" && status)\n    throw new Error(\"status is only supported for assistant messages\");\n\n  if (role !== \"assistant\" && metadata?.steps)\n    throw new Error(\"metadata.steps is only supported for assistant messages\");\n\n  switch (role) {\n    case \"assistant\":\n      return {\n        ...common,\n        role,\n        content: content\n          .map((part): ThreadAssistantMessagePart | null => {\n            const type = part.type;\n            switch (type) {\n              case \"text\":\n                if (!part.text?.trim()) return null;\n                return part;\n\n              case \"reasoning\":\n                if (!part.text?.trim() && !part.unstable_summary?.trim())\n                  return null;\n                return part;\n\n              case \"file\":\n              case \"source\":\n                return part;\n\n              case \"image\":\n                return sanitizeImageContent(part);\n\n              case \"data\":\n                return part;\n\n              case \"generative-ui\":\n                return part;\n\n              case \"tool-call\": {\n                const { parentId, messages, ...basePart } = part;\n                const commonProps = {\n                  ...basePart,\n                  toolCallId: part.toolCallId || `tool-${generateId()}`,\n                  ...(parentId !== undefined && { parentId }),\n                  ...(messages !== undefined && { messages }),\n                };\n\n                if (part.args) {\n                  return {\n                    ...commonProps,\n                    args: part.args,\n                    argsText: part.argsText ?? JSON.stringify(part.args),\n                  };\n                }\n                return {\n                  ...commonProps,\n                  args: parsePartialJsonObject(part.argsText ?? \"\") ?? {},\n                  argsText: part.argsText ?? \"\",\n                };\n              }\n\n              default: {\n                const converted = convertDataPrefixedPart(\n                  type,\n                  (part as DataPrefixedPart).data,\n                );\n                if (converted) return converted;\n                throw new Error(\n                  `Unsupported assistant message part type: ${type}`,\n                );\n              }\n            }\n          })\n          .filter((c) => !!c),\n        status: status ?? fallbackStatus,\n        metadata: {\n          unstable_state: metadata?.unstable_state ?? null,\n          unstable_annotations: metadata?.unstable_annotations ?? [],\n          unstable_data: metadata?.unstable_data ?? [],\n          custom: metadata?.custom ?? {},\n          steps: metadata?.steps ?? [],\n          ...(metadata?.timing && { timing: metadata.timing }),\n          ...(metadata?.submittedFeedback && {\n            submittedFeedback: metadata.submittedFeedback,\n          }),\n          ...(metadata?.isOptimistic && { isOptimistic: true }),\n          ...(metadata?.modality && { modality: metadata.modality }),\n        },\n      } satisfies ThreadAssistantMessage;\n\n    case \"user\":\n      return {\n        ...common,\n        role,\n        content: content.map((part): ThreadUserMessagePart => {\n          const type = part.type;\n          switch (type) {\n            case \"text\":\n            case \"image\":\n            case \"audio\":\n            case \"file\":\n            case \"data\":\n              return part;\n\n            default: {\n              const converted = convertDataPrefixedPart(\n                type,\n                (part as DataPrefixedPart).data,\n              );\n              if (converted) return converted;\n              throw new Error(`Unsupported user message part type: ${type}`);\n            }\n          }\n        }),\n        attachments: (attachments ?? []).map((att) => ({\n          ...att,\n          content: att.content.map((part): ThreadUserMessagePart => {\n            const converted = convertDataPrefixedPart(\n              part.type,\n              (part as DataPrefixedPart).data,\n            );\n            return converted ?? (part as ThreadUserMessagePart);\n          }),\n        })),\n        metadata: {\n          custom: metadata?.custom ?? {},\n          ...(metadata?.isOptimistic && { isOptimistic: true }),\n          ...(metadata?.modality && { modality: metadata.modality }),\n        },\n      } satisfies ThreadUserMessage;\n\n    case \"system\":\n      if (content.length !== 1 || content[0]!.type !== \"text\")\n        throw new Error(\n          \"System messages must have exactly one text message part.\",\n        );\n\n      return {\n        ...common,\n        role,\n        content: content as [TextMessagePart],\n        metadata: {\n          custom: metadata?.custom ?? {},\n        },\n      } satisfies ThreadSystemMessage;\n\n    default: {\n      const unsupportedRole: never = role;\n      throw new Error(`Unknown message role: ${unsupportedRole}`);\n    }\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"thread-message-like.js","names":["parsePartialJsonObject","generateId","parseDataUrl","ReasoningMessagePart","SourceMessagePart","ThreadStep","MessageStatus","ImageMessagePart","ThreadMessage","ThreadAssistantMessagePart","ThreadAssistantMessage","ThreadUserMessagePart","ThreadUserMessage","ThreadSystemMessage","FileMessagePart","DataMessagePart","GenerativeUIMessagePart","Unstable_AudioMessagePart","CompleteAttachment","MessageModality","MessageTiming","PartProviderMetadata","TextMessagePart","ToolCallTiming","ToolCallMessagePart","ToolCallMessagePartMcpMetadata","ReadonlyJSONObject","ReadonlyJSONValue","DataPrefixedPart","type","data","ThreadMessageLike","role","content","toolCallId","toolName","args","argsText","artifact","result","isError","parentId","messages","interrupt","payload","timing","mcp","providerMetadata","approval","NonNullable","id","createdAt","Date","status","attachments","Omit","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","comment","isOptimistic","modality","custom","Record","convertDataPrefixedPart","startsWith","undefined","name","substring","fromThreadMessageLike","like","fallbackId","fallbackStatus","common","const","text","sanitizeImageContent","image","rest","mimeType","test","console","warn","length","Error","map","part","trim","unstable_summary","basePart","commonProps","JSON","stringify","converted","filter","c","att","unsupportedRole"],"sources":["../../../src/runtime/utils/thread-message-like.ts"],"sourcesContent":["import { parsePartialJsonObject } from \"assistant-stream/utils\";\nimport { generateId } from \"../../utils/id\";\nimport { parseDataUrl } from \"../../utils/data-url\";\nimport type {\n  ReasoningMessagePart,\n  SourceMessagePart,\n  ThreadStep,\n  MessageStatus,\n  ImageMessagePart,\n  ThreadMessage,\n  ThreadAssistantMessagePart,\n  ThreadAssistantMessage,\n  ThreadUserMessagePart,\n  ThreadUserMessage,\n  ThreadSystemMessage,\n  FileMessagePart,\n  DataMessagePart,\n  GenerativeUIMessagePart,\n  Unstable_AudioMessagePart,\n} from \"../../types/message\";\nimport type { CompleteAttachment } from \"../../types/attachment\";\nimport type {\n  MessageModality,\n  MessageTiming,\n  PartProviderMetadata,\n  TextMessagePart,\n  ToolCallTiming,\n  ToolCallMessagePart,\n  ToolCallMessagePartMcpMetadata,\n} from \"../../types/message\";\nimport type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\n\ntype DataPrefixedPart = {\n  readonly type: `data-${string}`;\n  readonly data: any;\n};\n\nexport type ThreadMessageLike = {\n  readonly role: \"assistant\" | \"user\" | \"system\";\n  readonly content:\n    | string\n    | readonly (\n        | TextMessagePart\n        | ReasoningMessagePart\n        | SourceMessagePart\n        | ImageMessagePart\n        | FileMessagePart\n        | DataMessagePart\n        | GenerativeUIMessagePart\n        | Unstable_AudioMessagePart\n        | DataPrefixedPart\n        | {\n            readonly type: \"tool-call\";\n            readonly toolCallId?: string;\n            readonly toolName: string;\n            readonly args?: ReadonlyJSONObject;\n            readonly argsText?: string;\n            readonly artifact?: any;\n            readonly result?: any | undefined;\n            readonly isError?: boolean | undefined;\n            readonly parentId?: string | undefined;\n            readonly messages?: readonly ThreadMessage[] | undefined;\n            readonly interrupt?: { type: \"human\"; payload: unknown };\n            readonly timing?: ToolCallTiming;\n            readonly mcp?: ToolCallMessagePartMcpMetadata;\n            readonly providerMetadata?: PartProviderMetadata;\n            readonly approval?: NonNullable<ToolCallMessagePart[\"approval\"]>;\n          }\n      )[];\n  readonly id?: string | undefined;\n  readonly createdAt?: Date | undefined;\n  readonly status?: MessageStatus | undefined;\n  readonly attachments?:\n    | readonly (Omit<CompleteAttachment, \"content\"> & {\n        readonly content: readonly (ThreadUserMessagePart | DataPrefixedPart)[];\n      })[]\n    | undefined;\n  readonly metadata?:\n    | {\n        readonly unstable_state?: ReadonlyJSONValue | undefined;\n        readonly unstable_annotations?:\n          | readonly ReadonlyJSONValue[]\n          | undefined;\n        readonly unstable_data?: readonly ReadonlyJSONValue[] | undefined;\n        readonly steps?: readonly ThreadStep[] | undefined;\n        readonly timing?: MessageTiming | undefined;\n        readonly submittedFeedback?:\n          | {\n              readonly type: \"positive\" | \"negative\";\n              readonly comment?: string;\n            }\n          | undefined;\n        readonly isOptimistic?: boolean | undefined;\n        readonly modality?: MessageModality | undefined;\n        readonly custom?: Record<string, unknown> | undefined;\n      }\n    | undefined;\n};\n\nconst convertDataPrefixedPart = (\n  type: string,\n  data: unknown,\n): DataMessagePart | undefined => {\n  if (!type.startsWith(\"data-\")) return undefined;\n  return { type: \"data\", name: type.substring(5), data };\n};\n\n/**\n * @deprecated This API is experimental and may change without notice.\n */\nexport const fromThreadMessageLike = (\n  like: ThreadMessageLike,\n  fallbackId: string,\n  fallbackStatus: MessageStatus,\n): ThreadMessage => {\n  const { role, id, createdAt, attachments, status, metadata } = like;\n  const common = {\n    id: id ?? fallbackId,\n    createdAt: createdAt ?? new Date(),\n  };\n\n  const content =\n    typeof like.content === \"string\"\n      ? [{ type: \"text\" as const, text: like.content }]\n      : like.content;\n\n  const sanitizeImageContent = ({\n    image,\n    ...rest\n  }: ImageMessagePart): ImageMessagePart | null => {\n    if (typeof image !== \"string\") return null;\n    if (parseDataUrl(image)?.mimeType.startsWith(\"image/\")) {\n      return { ...rest, image };\n    }\n    if (/^(https:\\/\\/|blob:)/i.test(image)) {\n      return { ...rest, image };\n    }\n    console.warn(`Invalid image data format detected`);\n    return null;\n  };\n\n  if (role !== \"user\" && attachments?.length)\n    throw new Error(\"attachments are only supported for user messages\");\n\n  if (role !== \"assistant\" && status)\n    throw new Error(\"status is only supported for assistant messages\");\n\n  if (role !== \"assistant\" && metadata?.steps)\n    throw new Error(\"metadata.steps is only supported for assistant messages\");\n\n  switch (role) {\n    case \"assistant\":\n      return {\n        ...common,\n        role,\n        content: content\n          .map((part): ThreadAssistantMessagePart | null => {\n            const type = part.type;\n            switch (type) {\n              case \"text\":\n                if (!part.text?.trim()) return null;\n                return part;\n\n              case \"reasoning\":\n                if (!part.text?.trim() && !part.unstable_summary?.trim())\n                  return null;\n                return part;\n\n              case \"file\":\n              case \"source\":\n                return part;\n\n              case \"image\":\n                return sanitizeImageContent(part);\n\n              case \"data\":\n                return part;\n\n              case \"generative-ui\":\n                return part;\n\n              case \"tool-call\": {\n                const { parentId, messages, ...basePart } = part;\n                const commonProps = {\n                  ...basePart,\n                  toolCallId: part.toolCallId || `tool-${generateId()}`,\n                  ...(parentId !== undefined && { parentId }),\n                  ...(messages !== undefined && { messages }),\n                };\n\n                if (part.args) {\n                  return {\n                    ...commonProps,\n                    args: part.args,\n                    argsText: part.argsText ?? JSON.stringify(part.args),\n                  };\n                }\n                return {\n                  ...commonProps,\n                  args: parsePartialJsonObject(part.argsText ?? \"\") ?? {},\n                  argsText: part.argsText ?? \"\",\n                };\n              }\n\n              default: {\n                const converted = convertDataPrefixedPart(\n                  type,\n                  (part as DataPrefixedPart).data,\n                );\n                if (converted) return converted;\n                throw new Error(\n                  `Unsupported assistant message part type: ${type}`,\n                );\n              }\n            }\n          })\n          .filter((c) => !!c),\n        status: status ?? fallbackStatus,\n        metadata: {\n          unstable_state: metadata?.unstable_state ?? null,\n          unstable_annotations: metadata?.unstable_annotations ?? [],\n          unstable_data: metadata?.unstable_data ?? [],\n          custom: metadata?.custom ?? {},\n          steps: metadata?.steps ?? [],\n          ...(metadata?.timing && { timing: metadata.timing }),\n          ...(metadata?.submittedFeedback && {\n            submittedFeedback: metadata.submittedFeedback,\n          }),\n          ...(metadata?.isOptimistic && { isOptimistic: true }),\n          ...(metadata?.modality && { modality: metadata.modality }),\n        },\n      } satisfies ThreadAssistantMessage;\n\n    case \"user\":\n      return {\n        ...common,\n        role,\n        content: content.map((part): ThreadUserMessagePart => {\n          const type = part.type;\n          switch (type) {\n            case \"text\":\n            case \"image\":\n            case \"audio\":\n            case \"file\":\n            case \"data\":\n              return part;\n\n            default: {\n              const converted = convertDataPrefixedPart(\n                type,\n                (part as DataPrefixedPart).data,\n              );\n              if (converted) return converted;\n              throw new Error(`Unsupported user message part type: ${type}`);\n            }\n          }\n        }),\n        attachments: (attachments ?? []).map((att) => ({\n          ...att,\n          content: att.content.map((part): ThreadUserMessagePart => {\n            const converted = convertDataPrefixedPart(\n              part.type,\n              (part as DataPrefixedPart).data,\n            );\n            return converted ?? (part as ThreadUserMessagePart);\n          }),\n        })),\n        metadata: {\n          custom: metadata?.custom ?? {},\n          ...(metadata?.isOptimistic && { isOptimistic: true }),\n          ...(metadata?.modality && { modality: metadata.modality }),\n        },\n      } satisfies ThreadUserMessage;\n\n    case \"system\":\n      if (content.length !== 1 || content[0]!.type !== \"text\")\n        throw new Error(\n          \"System messages must have exactly one text message part.\",\n        );\n\n      return {\n        ...common,\n        role,\n        content: content as [TextMessagePart],\n        metadata: {\n          custom: metadata?.custom ?? {},\n        },\n      } satisfies ThreadSystemMessage;\n\n    default: {\n      const unsupportedRole: never = role;\n      throw new Error(`Unknown message role: ${unsupportedRole}`);\n    }\n  }\n};\n"],"mappings":"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"}

package/dist/runtime/utils/thread-runtime-lifecycle.d.ts

@@ -1,8 +1,7 @@
 import { ThreadRuntimeCore } from "../interfaces/thread-runtime-core.js";
 //#region src/runtime/utils/thread-runtime-lifecycle.d.ts
-declare const captureThreadRuntimeGeneration: (runtime: ThreadRuntimeCore) => number;
-declare const isThreadRuntimeGenerationCurrent: (runtime: ThreadRuntimeCore, generation: number) => boolean;
-declare const invalidateThreadRuntime: (runtime: ThreadRuntimeCore) => void;
+export declare const captureThreadRuntimeGeneration: (runtime: ThreadRuntimeCore) => number;
+export declare const isThreadRuntimeGenerationCurrent: (runtime: ThreadRuntimeCore, generation: number) => boolean;
+export declare const invalidateThreadRuntime: (runtime: ThreadRuntimeCore) => void;
 //#endregion
-export { captureThreadRuntimeGeneration, invalidateThreadRuntime, isThreadRuntimeGenerationCurrent };
 //# sourceMappingURL=thread-runtime-lifecycle.d.ts.map

package/dist/runtime/utils/thread-runtime-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread-runtime-lifecycle.d.ts","names":[],"sources":["../../../src/runtime/utils/thread-runtime-lifecycle.ts"],"mappings":";;cAOa,iCAAkC,SAAS;cAG3C,mCACX,SAAS,mBACT;cAGW,0BAA2B,SAAS"}
+{"version":3,"file":"thread-runtime-lifecycle.d.ts","names":[],"sources":["../../../src/runtime/utils/thread-runtime-lifecycle.ts"],"mappings":";;qBAOa,iCAAkC,SAAS;qBAG3C,mCACX,SAAS,mBACT;qBAGW,0BAA2B,SAAS"}

package/dist/runtime/utils/tool-call-tree.d.ts

@@ -1,6 +1,6 @@
 import { ThreadAssistantMessagePart, ThreadMessage, ToolCallMessagePart } from "../../types/message.js";
 //#region src/runtime/utils/tool-call-tree.d.ts
-type ToolCallTreeEntry = {
+export type ToolCallTreeEntry = {
   readonly part: ToolCallMessagePart;
   /** Id of the message whose content directly holds `part`. */
   readonly messageId: string;
@@ -18,22 +18,21 @@ type ToolCallTreeEntry = {
  * {@link mapToolCallPartsDeep} rewrites under, so a part this reports is always
  * a part that can be written back.
  */
-declare function walkToolCallTree(messages: readonly ThreadMessage[]): Generator<ToolCallTreeEntry>;
+export declare function walkToolCallTree(messages: readonly ThreadMessage[]): Generator<ToolCallTreeEntry>;
 /**
  * Content-level form of {@link walkToolCallTree}, for a caller that already
  * holds one assistant message's content and does not need the owning id.
  */
-declare function iterateToolCallParts(content: readonly ThreadAssistantMessagePart[]): Generator<ToolCallMessagePart>;
+export declare function iterateToolCallParts(content: readonly ThreadAssistantMessagePart[]): Generator<ToolCallMessagePart>;
 /**
  * Rebuild `content` with `fn` applied to every tool-call part in the tree.
  * Arrays and nested messages are reused wherever `fn` returned the part it was
  * given, so an unchanged subtree keeps its identity and `changed` reports
  * whether anything moved.
  */
-declare function mapToolCallPartsDeep(content: readonly ThreadAssistantMessagePart[], fn: (part: ToolCallMessagePart) => ToolCallMessagePart): {
+export declare function mapToolCallPartsDeep(content: readonly ThreadAssistantMessagePart[], fn: (part: ToolCallMessagePart) => ToolCallMessagePart): {
   content: readonly ThreadAssistantMessagePart[];
   changed: boolean;
 };
 //#endregion
-export { ToolCallTreeEntry, iterateToolCallParts, mapToolCallPartsDeep, walkToolCallTree };
 //# sourceMappingURL=tool-call-tree.d.ts.map

package/dist/runtime/utils/tool-call-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call-tree.d.ts","names":[],"sources":["../../../src/runtime/utils/tool-call-tree.ts"],"mappings":";;KAOY;WACD,MAAM;;WAEN;;;;;;;;;;;;;;;iBAgBM,iBACf,mBAAmB,kBAClB,UAAU;;;;;iBAiBI,qBACf,kBAAkB,+BACjB,UAAU;;;;;;;iBAkBG,qBACd,kBAAkB,8BAClB,KAAK,MAAM,wBAAwB;EAChC,kBAAkB;EAA8B"}
+{"version":3,"file":"tool-call-tree.d.ts","names":[],"sources":["../../../src/runtime/utils/tool-call-tree.ts"],"mappings":";;YAOY;WACD,MAAM;;WAEN;;;;;;;;;;;;;;;wBAgBM,iBACf,mBAAmB,kBAClB,UAAU;;;;;wBAiBI,qBACf,kBAAkB,+BACjB,UAAU;;;;;;;wBAkBG,qBACd,kBAAkB,8BAClB,KAAK,MAAM,wBAAwB;EAChC,kBAAkB;EAA8B"}

package/dist/runtimes/assistant-transport/utils.d.ts

@@ -1,5 +1,4 @@
 //#region src/runtimes/assistant-transport/utils.d.ts
-declare function createRequestHeaders(headersValue: Record<string, string> | Headers | (() => Promise<Record<string, string> | Headers>)): Promise<Headers>;
+export declare function createRequestHeaders(headersValue: Record<string, string> | Headers | (() => Promise<Record<string, string> | Headers>)): Promise<Headers>;
 //#endregion
-export { createRequestHeaders };
 //# sourceMappingURL=utils.d.ts.map

package/dist/runtimes/assistant-transport/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../../../src/runtimes/assistant-transport/utils.ts"],"mappings":";iBAAsB,qBACpB,cACI,yBACA,iBACO,QAAQ,yBAAyB,YAC3C,QAAQ"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../../src/runtimes/assistant-transport/utils.ts"],"mappings":";wBAAsB,qBACpB,cACI,yBACA,iBACO,QAAQ,yBAAyB,YAC3C,QAAQ"}

package/dist/runtimes/external-store/external-store-adapter.d.ts

@@ -10,7 +10,7 @@ import { AddToolResultOptions, RespondToToolApprovalOptions, ResumeRunConfig, St
 import { ToolExecutionStatus } from "../tool-invocations/ToolInvocationTracker.js";
 import { ReadonlyJSONValue } from "assistant-stream/utils";
 //#region src/runtimes/external-store/external-store-adapter.d.ts
-type ExternalStoreThreadData<TState extends "regular" | "archived"> = {
+export type ExternalStoreThreadData<TState extends "regular" | "archived"> = {
   status: TState;
   id: string;
   remoteId?: string | undefined;
@@ -18,7 +18,7 @@ type ExternalStoreThreadData<TState extends "regular" | "archived"> = {
   title?: string | undefined;
   custom?: Record<string, unknown> | undefined;
 };
-type ExternalStoreThreadListAdapter = {
+export type ExternalStoreThreadListAdapter = {
   /**
    * @deprecated This API is still under active development and might change without notice.
    */
@@ -40,11 +40,11 @@ type ExternalStoreThreadListAdapter = {
   onUnarchive?: ((threadId: string) => Promise<void> | void) | undefined;
   onDelete?: ((threadId: string) => Promise<void> | void) | undefined;
 };
-type ExternalStoreMessageConverter<T> = (message: T, idx: number) => ThreadMessageLike;
+export type ExternalStoreMessageConverter<T> = (message: T, idx: number) => ThreadMessageLike;
 /**
  * @deprecated This API is still under active development and might change without notice.
  */
-type ExternalStoreBranchChange = {
+export type ExternalStoreBranchChange = {
   headId: string | null;
   visibleMessageIds: readonly string[];
 };
@@ -100,6 +100,10 @@ type ExternalStoreAdapterBase<T> = {
    * back, because the runtime cannot see a removal it did not make.
    */
   setMessages?: ((messages: readonly T[]) => void) | undefined;
+  /**
+   * Called with each finalized voice transcript message. The host appends it to its own messages under the same id, which is how the runtime knows the host carries it. A host that does not implement this callback keeps transcripts for the session only.
+   */
+  onVoiceTranscript?: ((message: ThreadMessage) => void) | undefined;
   /**
    * Fires when the user explicitly switches branches via the runtime's
    * `switchToBranch` action (e.g. a BranchPicker click). It does not fire on
@@ -208,7 +212,6 @@ type ExternalStoreAdapterBase<T> = {
    */
   setToolStatuses?: ((statuses: Record<string, ToolExecutionStatus>) => void) | undefined;
 };
-type ExternalStoreAdapter<T = ThreadMessage> = ExternalStoreAdapterBase<T> & (T extends ThreadMessage ? object : ExternalStoreMessageConverterAdapter<T>);
+export type ExternalStoreAdapter<T = ThreadMessage> = ExternalStoreAdapterBase<T> & (T extends ThreadMessage ? object : ExternalStoreMessageConverterAdapter<T>);
 //#endregion
-export { ExternalStoreAdapter, ExternalStoreBranchChange, ExternalStoreMessageConverter, ExternalStoreThreadData, ExternalStoreThreadListAdapter };
 //# sourceMappingURL=external-store-adapter.d.ts.map

package/dist/runtimes/external-store/external-store-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-store-adapter.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-adapter.ts"],"mappings":";;;;;;;;;;;;KA4BY,wBAAwB;EAClC,QAAQ;EACR;EACA;EACA;EACA;EACA,SAAS;;KAGC;;;;EAIV;EACA;EACA,mBAAmB;EACnB,2BAA2B;;;;EAI3B,6BAA6B;;;;EAI7B,qBAAqB,qBAAqB;EAC1C,YACE,kBACA,sBACI;EACN,mBAEM,kBACA,QAAQ,wCACL;EAET,cAAc,qBAAqB;EACnC,gBAAgB,qBAAqB;EACrC,aAAa,qBAAqB;;KAGxB,8BAA8B,MACxC,SAAS,GACT,gBACG;;;;KAKO;EACV;EACA;;KAGG,qCAAqC;EACxC,gBAAgB,8BAA8B;;KAG3C,yBAAyB;;;;;;;EAO5B;;;;;;;;;EASA;;;;;;;;;EASA;EACA;EACA,oBAAoB;EACpB,oBAAoB;;;;;;;;;EASpB,qCAAqC;EACrC,uBAAuB;EACvB,QAAQ;EACR;;;;;;;;EASA,gBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;EAkBnC,4BACM,OAAO;EAEb,aAAa,mBAAmB;EAChC;EACA,wBAAwB;EACxB,QAAQ,SAAS,kBAAkB;;EAEnC,QAAQ;EACR,WAAW,SAAS,kBAAkB;EACtC,aAAa,sBAAsB;EACnC,aACM,yBAAyB,QAAQ,mBAAmB;EAE1D,aAAa,QAAQ,oBAAoB;EACzC,kBAAkB;;;;;;;;;EASlB,yBAAyB;EACzB,oBACM,SAAS,yBAAyB;EAExC,qBACM;IAAW;IAAoB;;EAErC,4BACM,SAAS,iCAAiC;EAEhD,iBAAiB,8BAA8B;EAC/C;IAEM,cAAc;IACd,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;;;;IAIX,aAAa;;EAGnB;IAEM;;;;;;;;;;;;;;;;;;;;;EAsBN;;;;;;;;;;;;;;;;;;EAkBA,8BACM,UAAU;;;;;;;;;;EAWhB,oBACM,UAAU,eAAe;;KAIrB,qBAAqB,IAAI,iBACnC,yBAAyB,MACtB,UAAU,yBAEP,qCAAqC"}
+{"version":3,"file":"external-store-adapter.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-adapter.ts"],"mappings":";;;;;;;;;;;;YA4BY,wBAAwB;EAClC,QAAQ;EACR;EACA;EACA;EACA;EACA,SAAS;;YAGC;;;;EAIV;EACA;EACA,mBAAmB;EACnB,2BAA2B;;;;EAI3B,6BAA6B;;;;EAI7B,qBAAqB,qBAAqB;EAC1C,YACE,kBACA,sBACI;EACN,mBAEM,kBACA,QAAQ,wCACL;EAET,cAAc,qBAAqB;EACnC,gBAAgB,qBAAqB;EACrC,aAAa,qBAAqB;;YAGxB,8BAA8B,MACxC,SAAS,GACT,gBACG;;;;YAKO;EACV;EACA;;KAGG,qCAAqC;EACxC,gBAAgB,8BAA8B;;KAG3C,yBAAyB;;;;;;;EAO5B;;;;;;;;;EASA;;;;;;;;;EASA;EACA;EACA,oBAAoB;EACpB,oBAAoB;;;;;;;;;EASpB,qCAAqC;EACrC,uBAAuB;EACvB,QAAQ;EACR;;;;;;;;EASA,gBAAgB,mBAAmB;;;;EAInC,sBAAsB,SAAS;;;;;;;;;;;;;;;;;;EAkB/B,4BACM,OAAO;EAEb,aAAa,mBAAmB;EAChC;EACA,wBAAwB;EACxB,QAAQ,SAAS,kBAAkB;;EAEnC,QAAQ;EACR,WAAW,SAAS,kBAAkB;EACtC,aAAa,sBAAsB;EACnC,aACM,yBAAyB,QAAQ,mBAAmB;EAE1D,aAAa,QAAQ,oBAAoB;EACzC,kBAAkB;;;;;;;;;EASlB,yBAAyB;EACzB,oBACM,SAAS,yBAAyB;EAExC,qBACM;IAAW;IAAoB;;EAErC,4BACM,SAAS,iCAAiC;EAEhD,iBAAiB,8BAA8B;EAC/C;IAEM,cAAc;IACd,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;;;;IAIX,aAAa;;EAGnB;IAEM;;;;;;;;;;;;;;;;;;;;;EAsBN;;;;;;;;;;;;;;;;;;EAkBA,8BACM,UAAU;;;;;;;;;;EAWhB,oBACM,UAAU,eAAe;;YAIrB,qBAAqB,IAAI,iBACnC,yBAAyB,MACtB,UAAU,yBAEP,qCAAqC"}

package/dist/runtimes/external-store/external-store-runtime-core.d.ts

@@ -2,11 +2,10 @@ import { BaseAssistantRuntimeCore } from "../../runtime/base/base-assistant-runt
 import { ExternalStoreAdapter } from "./external-store-adapter.js";
 import { ExternalStoreThreadListRuntimeCore } from "./external-store-thread-list-runtime-core.js";
 //#region src/runtimes/external-store/external-store-runtime-core.d.ts
-declare class ExternalStoreRuntimeCore extends BaseAssistantRuntimeCore {
+export declare class ExternalStoreRuntimeCore extends BaseAssistantRuntimeCore {
   readonly threads: ExternalStoreThreadListRuntimeCore;
   constructor(adapter: ExternalStoreAdapter<any>);
   setAdapter(adapter: ExternalStoreAdapter<any>): void;
 }
 //#endregion
-export { ExternalStoreRuntimeCore };
 //# sourceMappingURL=external-store-runtime-core.d.ts.map

package/dist/runtimes/external-store/external-store-runtime-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-store-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-runtime-core.ts"],"mappings":";;;;cASa,iCAAiC;WAC5B,SAAO;EAEX,YAAA,SAAS;EAQd,WAAW,SAAS"}
+{"version":3,"file":"external-store-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-runtime-core.ts"],"mappings":";;;;qBASa,iCAAiC;WAC5B,SAAO;EAEX,YAAA,SAAS;EAQd,WAAW,SAAS"}

package/dist/runtimes/external-store/external-store-shared-options.d.ts

@@ -1,7 +1,6 @@
 import { ExternalStoreAdapter } from "./external-store-adapter.js";
 //#region src/runtimes/external-store/external-store-shared-options.d.ts
-type ExternalStoreSharedOptions = Pick<ExternalStoreAdapter, "isDisabled" | "isSendDisabled" | "unstable_capabilities" | "suggestions">;
-declare const pickExternalStoreSharedOptions: (options: ExternalStoreSharedOptions) => ExternalStoreSharedOptions;
+export type ExternalStoreSharedOptions = Pick<ExternalStoreAdapter, "isDisabled" | "isSendDisabled" | "unstable_capabilities" | "suggestions">;
+export declare const pickExternalStoreSharedOptions: (options: ExternalStoreSharedOptions) => ExternalStoreSharedOptions;
 //#endregion
-export { ExternalStoreSharedOptions, pickExternalStoreSharedOptions };
 //# sourceMappingURL=external-store-shared-options.d.ts.map

package/dist/runtimes/external-store/external-store-shared-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-store-shared-options.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-shared-options.ts"],"mappings":";;KAEY,6BAA6B,KACvC;cAIW,iCACX,SAAS,+BACR"}
+{"version":3,"file":"external-store-shared-options.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-shared-options.ts"],"mappings":";;YAEY,6BAA6B,KACvC;qBAIW,iCACX,SAAS,+BACR"}

package/dist/runtimes/external-store/external-store-thread-list-runtime-core.d.ts

@@ -3,8 +3,8 @@ import { BaseSubscribable } from "../../subscribable/subscribable.js";
 import { ExternalStoreThreadListAdapter } from "./external-store-adapter.js";
 import { ExternalStoreThreadRuntimeCore } from "./external-store-thread-runtime-core.js";
 //#region src/runtimes/external-store/external-store-thread-list-runtime-core.d.ts
-type ExternalStoreThreadFactory = () => ExternalStoreThreadRuntimeCore;
-declare class ExternalStoreThreadListRuntimeCore extends BaseSubscribable implements ThreadListRuntimeCore {
+export type ExternalStoreThreadFactory = () => ExternalStoreThreadRuntimeCore;
+export declare class ExternalStoreThreadListRuntimeCore extends BaseSubscribable implements ThreadListRuntimeCore {
   private _mainThreadId;
   private _threads;
   private _archivedThreads;
@@ -42,5 +42,4 @@ declare class ExternalStoreThreadListRuntimeCore extends BaseSubscribable implem
   generateTitle(): never;
 }
 //#endregion
-export { ExternalStoreThreadFactory, ExternalStoreThreadListRuntimeCore };
 //# sourceMappingURL=external-store-thread-list-runtime-core.d.ts.map

package/dist/runtimes/external-store/external-store-thread-list-runtime-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-store-thread-list-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-thread-list-runtime-core.ts"],"mappings":";;;;;KAUY,mCAAmC;cAkBlC,2CACH,4BACG;UAEH;UACA;UACA;UACA;UAEA;MAEG;MAIA;MAIA;MAIA;MAIA,eAAW,SAAA,eAAA;EAIf,yBAAqB;UAIpB;MAEG;UAIH;EAGN,YAAA,SAAS,4CACT,eAAe;EAOV,4BAAwB;EAIxB;EAIA,YAAY,mBAAgB;EAM5B,sBACL,SAAS,gCACT;EAsFW,oBAAoB;EASpB,eACX,kBACA;IAAa;MACZ;EAUU,qBAAqB;EAUrB,OAAO,kBAAkB,mBAAmB;EAQ5C,aACX,kBACA,QAAQ,sCACP;EAUU,UAAU;EAIV,QAAQ,mBAAmB;EAQ3B,UAAU,mBAAmB;EAQ7B,OAAO,mBAAmB;EAQhC,WACL,mBACC;IAAU;IAAkB;;EAIxB"}
+{"version":3,"file":"external-store-thread-list-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-thread-list-runtime-core.ts"],"mappings":";;;;;YAUY,mCAAmC;qBAkBlC,2CACH,4BACG;UAEH;UACA;UACA;UACA;UAEA;MAEG;MAIA;MAIA;MAIA;MAIA,eAAW,SAAA,eAAA;EAIf,yBAAqB;UAIpB;MAEG;UAIH;EAGN,YAAA,SAAS,4CACT,eAAe;EAOV,4BAAwB;EAIxB;EAIA,YAAY,mBAAgB;EAM5B,sBACL,SAAS,gCACT;EAsFW,oBAAoB;EASpB,eACX,kBACA;IAAa;MACZ;EAUU,qBAAqB;EAUrB,OAAO,kBAAkB,mBAAmB;EAQ5C,aACX,kBACA,QAAQ,sCACP;EAUU,UAAU;EAIV,QAAQ,mBAAmB;EAQ3B,UAAU,mBAAmB;EAQ7B,OAAO,mBAAmB;EAQhC,WACL,mBACC;IAAU;IAAkB;;EAIxB"}

package/dist/runtimes/external-store/external-store-thread-runtime-core.d.ts

@@ -14,8 +14,8 @@ import { ExternalStoreAdapter, ExternalStoreThreadListAdapter } from "./external
 import "../../store/index.js";
 import "../../index.js";
 //#region src/runtimes/external-store/external-store-thread-runtime-core.d.ts
-declare const hasUpcomingMessage: (isRunning: boolean, messages: readonly ThreadMessage[]) => boolean;
-declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore implements ThreadRuntimeCore {
+export declare const hasUpcomingMessage: (isRunning: boolean, messages: readonly ThreadMessage[]) => boolean;
+export declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore implements ThreadRuntimeCore {
   private _capabilities;
   get capabilities(): RuntimeCapabilities;
   private _messages;
@@ -98,8 +98,10 @@ declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore imple
    */
   private _notifyBranchChange;
   append(rawMessage: AppendMessage): Promise<void>;
+  protected _commitVoiceMessage(message: ThreadMessage): void;
   deleteMessage(messageId: string): Promise<void>;
   private _evictDeletedMessage;
+  private _publishRepositoryMessages;
   getQueueItems(): readonly QueueItemState[];
   getSteerQueueItems(): readonly QueueItemState[];
   moveQueueItem(queueItemId: string, placement: QueuePlacement): void;
@@ -124,5 +126,4 @@ declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore imple
   private updateMessages;
 }
 //#endregion
-export { ExternalStoreThreadRuntimeCore, hasUpcomingMessage };
 //# sourceMappingURL=external-store-thread-runtime-core.d.ts.map

package/dist/runtimes/external-store/external-store-thread-runtime-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-store-thread-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-thread-runtime-core.ts"],"mappings":";;;;;;;;;;;;;;;;cAyEa,qBACX,oBACA,mBAAmB;cAKR,uCACH,iCACG;UAEH;MAiBG,gBAAY;UAIf;EACD;EACA;MACI;MAIA;YAKQ,6BAA6B;MAI5B,sEAAK,sDAAA;MAId;kBARqC;;;;;;;MAarC,iCAAiC;EAKrC,sBAAsB;EACtB;UAEC;UAUA;UAKA;UAEA;UAEA;EAED,mCACL,kBAAkB;UAKZ;;;;;UAMA;UACA;UACA;UACA;UACA;;;;;;;;UASA;UAaA;UAQA;UASA;EAIQ,UAAU;EAQxB,YAAA,iBAAiB,sBACjB,OAAO;EAMF,sBAAsB,OAAO;UAM5B;;;;;;;UA4PA;;;;;UAoFA;UACA;;;;;;;UAQA;EAWQ,eAAe;;;;;;;;;UA8BvB;EAaK,OAAO,YAAY,gBAAgB;EAuEnC,cAAc,oBAAoB;UA0CvC;EAkBD,0BA5DwC;EAkExC,+BANa;EAUb,cAAc,qBAAqB,WAAW;EAI9C,gBAAgB;EAIV,SAAS,QAAQ,iBAAiB;EAgBlC,UAAU,QAAQ,kBAAkB;EAS1C;EAOA,oBAAoB;;;;;;EAqBpB;EAKA;UAmFC;EAOD,cAAc,SAAS;EASvB,eAAe,SAAS;EAoBxB,sBACL,SAAS,+BACR;EAkCa,MAAM,2BAA2B;EAMjC,OAAO,MAAM;UAQrB"}
+{"version":3,"file":"external-store-thread-runtime-core.d.ts","names":[],"sources":["../../../src/runtimes/external-store/external-store-thread-runtime-core.ts"],"mappings":";;;;;;;;;;;;;;;;qBAyEa,qBACX,oBACA,mBAAmB;qBAKR,uCACH,iCACG;UAEH;MAiBG,gBAAY;UAIf;EACD;EACA;MACI;MAIA;YAKQ,6BAA6B;MAI5B,sEAAK,sDAAA;MAId;kBARqC;;;;;;;MAarC,iCAAiC;EAKrC,sBAAsB;EACtB;UAEC;UAUA;UAKA;UAEA;UAEA;EAED,mCACL,kBAAkB;UAKZ;;;;;UAMA;UACA;UACA;UACA;UACA;;;;;;;;UASA;UAaA;UAQA;UASA;EAIQ,UAAU;EAQxB,YAAA,iBAAiB,sBACjB,OAAO;EAMF,sBAAsB,OAAO;UAM5B;;;;;;;UAuQA;;;;;UAoFA;UACA;;;;;;;UAQA;EAWQ,eAAe;;;;;;;;;UA8BvB;EAaK,OAAO,YAAY,gBAAgB;YA+E7B,oBAAoB,SAAS;EAInC,cAAc,oBAAoB;UA0CvC;UAmBA;EAMD,0BAnEwC;EAyExC,+BANa;EAUb,cAAc,qBAAqB,WAAW;EAI9C,gBAAgB;EAIV,SAAS,QAAQ,iBAAiB;EAkBlC,UAAU,QAAQ,kBAAkB;EAW1C;EAOA,oBAAoB;;;;;;EAqBpB;EAKA;UAoFC;EAOD,cAAc,SAAS;EASvB,eAAe,SAAS;EAoBxB,sBACL,SAAS,+BACR;EAkCa,MAAM,2BAA2B;EAMjC,OAAO,MAAM;UAQrB"}

package/dist/runtimes/external-store/external-store-thread-runtime-core.js

@@ -278,6 +278,14 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 		this.repository.resetHead(optimisticId ?? messages.at(-1)?.id ?? null);
 		const messagesSnapshot = this.repository.getMessages();
 		if (!this._messages || !shallowArrayEqual(this._messages, messagesSnapshot)) this._messages = messagesSnapshot;
+		if (this._voiceMessages.length > 0) {
+			const hostIds = new Set(this._messages.map((message) => message.id));
+			const remaining = this._voiceMessages.filter((message) => !hostIds.has(message.id));
+			if (remaining.length !== this._voiceMessages.length) {
+				this._voiceMessages = remaining;
+				this._markVoiceMessagesDirty();
+			}
+		}
 		if (repositoryChanged) this._runTrackerUpdate(() => this._toolInvocations?.reset());
 		this._runTrackerUpdate(() => this._driveToolInvocations());
 		this._notifySubscribers();
@@ -382,9 +390,14 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 		});
 	}
 	async append(rawMessage) {
-		if (this._isVoiceMessage(rawMessage.sourceId)) throw new Error("Voice transcript messages cannot be edited");
-		const isEdit = rawMessage.sourceId != null || rawMessage.parentId !== (this.messages.at(-1)?.id ?? null);
-		const message = !isEdit && this._store.queue && this._store.queue === this._transformedQueue ? rawMessage : this.enrichAppendMetadata(rawMessage);
+		let message = {
+			...rawMessage,
+			parentId: this._resolveAppendParent(rawMessage.parentId)
+		};
+		if (this.voice) throw new Error("Cannot send a text message while a voice session is connected");
+		if (this._isVoiceMessage(message.sourceId)) throw new Error("Voice transcript messages cannot be edited");
+		const isEdit = message.sourceId != null || message.parentId !== (this._getBaseMessages().at(-1)?.id ?? null);
+		message = !isEdit && this._store.queue && this._store.queue === this._transformedQueue ? message : this.enrichAppendMetadata(message);
 		const generation = captureThreadRuntimeGeneration(this);
 		this.ensureInitialized();
 		const initPromise = this._getInitializePromise?.();
@@ -404,6 +417,9 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 			await this._store.onEdit(message);
 		} else await this._store.onNew(message);
 	}
+	_commitVoiceMessage(message) {
+		this._store.onVoiceTranscript?.(message);
+	}
 	async deleteMessage(messageId) {
 		if (this._store.onDelete) {
 			if (this.repository.getMessages().some((m) => m.id === messageId)) this._pendingDeleteEvictions.add(messageId);
@@ -431,7 +447,11 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 			return;
 		}
 		this.repository.deleteMessage(messageId);
-		this._messages = this.repository.getMessages();
+		this._publishRepositoryMessages();
+	}
+	_publishRepositoryMessages() {
+		const messages = this.repository.getMessages();
+		if (!shallowArrayEqual(this._messages, messages)) this._messages = messages;
 		this._notifySubscribers();
 	}
 	getQueueItems() {
@@ -448,6 +468,7 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 	}
 	async startRun(config) {
 		if (!this._store.onReload) throw new Error("Runtime does not support reloading messages.");
+		if (this.voice) throw new Error("Cannot start a run while a voice session is connected");
 		if (this._isVoiceMessage(config.sourceId)) throw new Error("Voice transcript messages cannot be reloaded");
 		this._pendingDeleteEvictions.clear();
 		await this._toolInvocations?.abort({ discardPending: true });
@@ -455,6 +476,7 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 	}
 	async resumeRun(config) {
 		if (!this._store.onResume) throw new Error("Runtime does not support resuming runs.");
+		if (this.voice) throw new Error("Cannot start a run while a voice session is connected");
 		if (this._isVoiceMessage(config.sourceId)) throw new Error("Voice transcript messages cannot be reloaded");
 		await this._store.onResume(config);
 	}
@@ -501,7 +523,7 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 				};
 			}
 		}
-		if (!movedLeaf) this._notifySubscribers();
+		this._publishRepositoryMessages();
 		setTimeout(() => {
 			if (!isThreadRuntimeGenerationCurrent(this, generation)) return;
 			this.dropEmptyOptimisticHead();
@@ -510,7 +532,8 @@ var ExternalStoreThreadRuntimeCore = class extends BaseThreadRuntimeCore {
 				if (current.at(-1)?.id === movedLeaf.id) this.repository.deleteMessage(movedLeaf.id);
 				else if (current.some((m) => m.id === movedLeaf.id)) this.composer.retractDraft(movedLeaf.draft);
 			}
-			this.updateMessages(this.repository.getMessages());
+			this._publishRepositoryMessages();
+			this.updateMessages(this._messages);
 		}, 0);
 	}
 	dropEmptyOptimisticHead() {