@assistant-ui/core 0.3.16 → 0.3.17

package/dist/runtime/utils/external-message-conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"external-message-conversion.js","names":["ReadonlyJSONValue","ToolExecutionStatus","ThreadAssistantMessage","ThreadMessage","ToolCallMessagePart","MessageTiming","generateErrorMessageId","isJSONValueEqual","getAutoStatus","isAutoStatus","isInterruptedToolCall","isPendingToolCall","bindExternalStoreMessage","FALLBACK_ID_PREFIX","getExternalStoreMessages","symbolInnerMessage","fromThreadMessageLike","ThreadMessageLike","JoinStrategy","ExternalMessageConverterMessage","convertConfig","joinStrategy","role","toolCallId","toolName","result","artifact","isError","messages","ExternalMessageConverterMetadata","toolStatuses","Record","error","messageTiming","ExternalMessageConverterCallback","message","T","metadata","ExternalMessageConverterCallbackResult","input","outputs","ExternalMessageConverterChunk","inputs","Mutable","P","stringifyForError","value","text","Error","String","JSON","stringify","length","slice","toCallbackOutputs","output","Array","isArray","o","valid","content","filter","warnedDroppedToolResults","has","add","console","warn","WeakSet","convertExternalMessageCallback","callback","mergeInnerMessages","existing","incoming","joinExternalMessages","assistantMessage","Omit","Exclude","toolCallIdx","findIndex","c","type","toolCall","const","map","id","createdAt","status","attachments","unstable_state","undefined","unstable_annotations","unstable_data","steps","custom","timing","submittedFeedback","isOptimistic","part","existingIdx","parentId","push","unsupportedRole","chunkExternalMessages","callbackResults","results","isAssistant","pendingNone","flush","callbackResult","at","shallowArrayEqual","a","b","i","ExternalMessageConversionCache","generatedFallbackMessages","convertExternalMessageChunk","idx","chunkCount","isRunning","cache","isLast","joined","hasInterruptedToolCalls","some","hasPendingToolCalls","autoStatus","fallbackId","cachedMessage","reason","updated","newMessage","createErrorAssistantMessage","msg","Date","completeExternalMessageConversion","lastMessage","convertExternalMessages","WeakKey","chunks"],"sources":["../../../src/runtime/utils/external-message-conversion.ts"],"sourcesContent":["import type { ReadonlyJSONValue } from \"assistant-stream/utils\";\nimport type { ToolExecutionStatus } from \"../../runtimes/tool-invocations/ToolInvocationTracker\";\nimport type {\n  ThreadAssistantMessage,\n  ThreadMessage,\n  ToolCallMessagePart,\n} from \"../../types/message\";\nimport type { MessageTiming } from \"../../types/message\";\nimport { generateErrorMessageId } from \"../../utils/id\";\nimport { isJSONValueEqual } from \"../../utils/json/is-json-equal\";\nimport {\n  getAutoStatus,\n  isAutoStatus,\n  isInterruptedToolCall,\n  isPendingToolCall,\n} from \"./auto-status\";\nimport {\n  bindExternalStoreMessage,\n  FALLBACK_ID_PREFIX,\n  getExternalStoreMessages,\n  symbolInnerMessage,\n} from \"./external-store-message\";\nimport {\n  fromThreadMessageLike,\n  type ThreadMessageLike,\n} from \"./thread-message-like\";\n\nexport type JoinStrategy = \"concat-content\" | \"none\";\n\nexport type ExternalMessageConverterMessage =\n  | (ThreadMessageLike & {\n      readonly convertConfig?: {\n        readonly joinStrategy?: JoinStrategy;\n      };\n    })\n  | {\n      role: \"tool\";\n      toolCallId: string;\n      toolName?: string | undefined;\n      result: any;\n      artifact?: any;\n      isError?: boolean;\n      messages?: readonly ThreadMessage[];\n    };\n\nexport type ExternalMessageConverterMetadata = {\n  readonly toolStatuses?: Record<string, ToolExecutionStatus>;\n  readonly error?: ReadonlyJSONValue;\n  readonly messageTiming?: Record<string, MessageTiming>;\n};\n\nexport type ExternalMessageConverterCallback<T> = (\n  message: T,\n  metadata: ExternalMessageConverterMetadata,\n) => ExternalMessageConverterMessage | ExternalMessageConverterMessage[];\n\nexport type ExternalMessageConverterCallbackResult<T> = {\n  input: T;\n  outputs: ExternalMessageConverterMessage[];\n};\n\nexport type ExternalMessageConverterChunk<T> = {\n  inputs: T[];\n  outputs: ExternalMessageConverterMessage[];\n};\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nconst stringifyForError = (value: unknown) => {\n  let text;\n  try {\n    text = value instanceof Error ? String(value) : JSON.stringify(value);\n  } catch {\n    /* circular */\n  }\n  text ??= String(value);\n  return text.length > 200 ? `${text.slice(0, 200)}…` : text;\n};\n\nconst toCallbackOutputs = (\n  output: ExternalMessageConverterMessage | ExternalMessageConverterMessage[],\n  input: unknown,\n): ExternalMessageConverterMessage[] => {\n  const outputs = Array.isArray(output) ? output : [output];\n  for (const o of outputs) {\n    const valid =\n      typeof o === \"object\" &&\n      o !== null &&\n      (o.role === \"tool\" ||\n        ((o.role === \"assistant\" || o.role === \"user\" || o.role === \"system\") &&\n          (typeof o.content === \"string\" || Array.isArray(o.content))));\n    if (!valid)\n      throw new Error(\n        `External message converter: the converter callback returned an invalid message (${stringifyForError(o)}) for input ${stringifyForError(input)}. Return an empty array to skip a message.`,\n      );\n  }\n  // Providers can emit tool results without a usable id (react-langchain maps\n  // a missing tool_call_id to \"\"); converters must not throw on those, so the\n  // result is dropped like any other orphaned tool output.\n  return outputs.filter((o) => {\n    if (o.role !== \"tool\") return true;\n    if (typeof o.toolCallId === \"string\" && o.toolCallId.length > 0)\n      return true;\n    if (!warnedDroppedToolResults.has(o)) {\n      warnedDroppedToolResults.add(o);\n      console.warn(\n        `External message converter: dropping a tool result without a toolCallId (${stringifyForError(o)}) for input ${stringifyForError(input)}.`,\n      );\n    }\n    return false;\n  });\n};\n\nconst warnedDroppedToolResults = new WeakSet<object>();\n\nexport const convertExternalMessageCallback = <T>(\n  input: T,\n  callback: ExternalMessageConverterCallback<T>,\n  metadata: ExternalMessageConverterMetadata,\n): ExternalMessageConverterCallbackResult<T> => ({\n  input,\n  outputs: toCallbackOutputs(callback(input, metadata), input),\n});\n\nconst mergeInnerMessages = (existing: object, incoming: object) => ({\n  [symbolInnerMessage]: [\n    ...((existing as any)[symbolInnerMessage] ?? []),\n    ...((incoming as any)[symbolInnerMessage] ?? []),\n  ],\n});\n\nexport const joinExternalMessages = (\n  messages: readonly ExternalMessageConverterMessage[],\n): ThreadMessageLike => {\n  const assistantMessage: Mutable<Omit<ThreadMessageLike, \"metadata\">> & {\n    content: Exclude<ThreadMessageLike[\"content\"][0], string>[];\n    metadata?: Mutable<ThreadMessageLike[\"metadata\"]>;\n  } = {\n    role: \"assistant\",\n    content: [],\n  };\n  for (const output of messages) {\n    if (output.role === \"tool\") {\n      const toolCallIdx = assistantMessage.content.findIndex(\n        (c) => c.type === \"tool-call\" && c.toolCallId === output.toolCallId,\n      );\n      // Ignore orphaned tool results so one bad tool message does not\n      // prevent rendering the rest of the conversation.\n      if (toolCallIdx !== -1) {\n        const toolCall = assistantMessage.content[\n          toolCallIdx\n        ]! as ToolCallMessagePart;\n        if (output.toolName != null) {\n          if (toolCall.toolName !== output.toolName)\n            throw new Error(\n              `Tool call name ${output.toolCallId} ${output.toolName} does not match existing tool call ${toolCall.toolName}`,\n            );\n        }\n        assistantMessage.content[toolCallIdx] = {\n          ...toolCall,\n          ...{\n            [symbolInnerMessage]: [\n              ...((toolCall as any)[symbolInnerMessage] ?? []),\n              output,\n            ],\n          },\n          result: output.result,\n          artifact: output.artifact,\n          isError: output.isError,\n          messages: output.messages,\n        };\n      }\n    } else {\n      const role = output.role;\n      const content = (\n        typeof output.content === \"string\"\n          ? [{ type: \"text\" as const, text: output.content }]\n          : output.content\n      ).map((c) => ({\n        ...c,\n        ...{ [symbolInnerMessage]: [output] },\n      }));\n      switch (role) {\n        case \"system\":\n        case \"user\":\n          return {\n            ...output,\n            content,\n          };\n        case \"assistant\":\n          if (assistantMessage.content.length === 0) {\n            assistantMessage.id = output.id;\n            assistantMessage.createdAt ??= output.createdAt;\n            assistantMessage.status ??= output.status;\n\n            if (output.attachments) {\n              assistantMessage.attachments = [\n                ...(assistantMessage.attachments ?? []),\n                ...output.attachments,\n              ];\n            }\n          }\n\n          if (output.metadata) {\n            assistantMessage.metadata ??= {};\n            if (output.metadata.unstable_state !== undefined) {\n              assistantMessage.metadata.unstable_state =\n                output.metadata.unstable_state;\n            }\n            if (output.metadata.unstable_annotations) {\n              assistantMessage.metadata.unstable_annotations = [\n                ...(assistantMessage.metadata.unstable_annotations ?? []),\n                ...output.metadata.unstable_annotations,\n              ];\n            }\n            if (output.metadata.unstable_data) {\n              assistantMessage.metadata.unstable_data = [\n                ...(assistantMessage.metadata.unstable_data ?? []),\n                ...output.metadata.unstable_data,\n              ];\n            }\n            if (output.metadata.steps) {\n              assistantMessage.metadata.steps = [\n                ...(assistantMessage.metadata.steps ?? []),\n                ...output.metadata.steps,\n              ];\n            }\n            if (output.metadata.custom) {\n              assistantMessage.metadata.custom = {\n                ...(assistantMessage.metadata.custom ?? {}),\n                ...output.metadata.custom,\n              };\n            }\n\n            if (output.metadata.timing) {\n              assistantMessage.metadata.timing = output.metadata.timing;\n            }\n\n            if (output.metadata.submittedFeedback) {\n              assistantMessage.metadata.submittedFeedback =\n                output.metadata.submittedFeedback;\n            }\n\n            if (output.metadata.isOptimistic) {\n              assistantMessage.metadata.isOptimistic = true;\n            }\n            // TODO keep this in sync with ThreadMessageLike[\"metadata\"] / fromThreadMessageLike\n          }\n\n          // Add content parts, merging reasoning parts with same parentId\n          for (const part of content) {\n            if (part.type === \"tool-call\") {\n              const existingIdx = assistantMessage.content.findIndex(\n                (c) =>\n                  c.type === \"tool-call\" && c.toolCallId === part.toolCallId,\n              );\n              if (existingIdx !== -1) {\n                const existing = assistantMessage.content[\n                  existingIdx\n                ] as typeof part;\n                assistantMessage.content[existingIdx] = {\n                  ...existing,\n                  ...part,\n                  ...mergeInnerMessages(existing, part),\n                };\n                continue;\n              }\n            }\n\n            if (\n              part.type === \"reasoning\" &&\n              \"parentId\" in part &&\n              part.parentId\n            ) {\n              const existingIdx = assistantMessage.content.findIndex(\n                (c) =>\n                  c.type === \"reasoning\" &&\n                  \"parentId\" in c &&\n                  c.parentId === part.parentId,\n              );\n              if (existingIdx !== -1) {\n                const existing = assistantMessage.content[\n                  existingIdx\n                ] as typeof part;\n                assistantMessage.content[existingIdx] = {\n                  ...existing,\n                  text: `${existing.text}\\n\\n${part.text}`,\n                  ...mergeInnerMessages(existing, part),\n                };\n                continue;\n              }\n            }\n            assistantMessage.content.push(part);\n          }\n          break;\n        default: {\n          const unsupportedRole: never = role;\n          throw new Error(`Unknown message role: ${unsupportedRole}`);\n        }\n      }\n    }\n  }\n  return assistantMessage;\n};\n\nexport const chunkExternalMessages = <T>(\n  callbackResults: ExternalMessageConverterCallbackResult<T>[],\n  joinStrategy?: JoinStrategy,\n) => {\n  const results: ExternalMessageConverterChunk<T>[] = [];\n  let isAssistant = false;\n  let pendingNone = false; // true if the previous assistant message had joinStrategy \"none\"\n  let inputs: T[] = [];\n  let outputs: ExternalMessageConverterMessage[] = [];\n\n  const flush = () => {\n    if (outputs.length) {\n      results.push({\n        inputs,\n        outputs,\n      });\n    }\n    inputs = [];\n    outputs = [];\n    isAssistant = false;\n    pendingNone = false;\n  };\n\n  for (const callbackResult of callbackResults) {\n    for (const output of callbackResult.outputs) {\n      if (\n        (pendingNone && output.role !== \"tool\") ||\n        !isAssistant ||\n        output.role === \"user\" ||\n        output.role === \"system\"\n      ) {\n        flush();\n      }\n      isAssistant = output.role === \"assistant\" || output.role === \"tool\";\n\n      if (inputs.at(-1) !== callbackResult.input) {\n        inputs.push(callbackResult.input);\n      }\n      outputs.push(output);\n\n      if (\n        output.role === \"assistant\" &&\n        (output.convertConfig?.joinStrategy === \"none\" ||\n          joinStrategy === \"none\")\n      ) {\n        pendingNone = true;\n      }\n    }\n  }\n  flush();\n  return results;\n};\n\nexport const shallowArrayEqual = (a: unknown[], b: unknown[]) => {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n};\n\ntype ExternalMessageConversionCache = {\n  message: ThreadMessage | undefined;\n  generatedFallbackMessages: WeakSet<object>;\n};\n\nexport const convertExternalMessageChunk = <T>(\n  message: ExternalMessageConverterChunk<T>,\n  idx: number,\n  chunkCount: number,\n  isRunning: boolean,\n  error: ReadonlyJSONValue | undefined,\n  cache?: ExternalMessageConversionCache,\n) => {\n  const isLast = idx === chunkCount - 1;\n  const joined = joinExternalMessages(message.outputs);\n  const hasInterruptedToolCalls =\n    typeof joined.content === \"object\" &&\n    joined.content.some(isInterruptedToolCall);\n  const hasPendingToolCalls =\n    typeof joined.content === \"object\" &&\n    joined.content.some(isPendingToolCall);\n  const autoStatus = getAutoStatus(\n    isLast,\n    isRunning,\n    hasInterruptedToolCalls,\n    hasPendingToolCalls,\n    isLast ? error : undefined,\n  );\n  const fallbackId = `${FALLBACK_ID_PREFIX}${idx}`;\n\n  const cachedMessage = cache?.message;\n  if (\n    cachedMessage &&\n    (cachedMessage.role !== \"assistant\" ||\n      !isAutoStatus(cachedMessage.status) ||\n      cachedMessage.status === autoStatus ||\n      (cachedMessage.status.type === \"incomplete\" &&\n        cachedMessage.status.reason === \"error\" &&\n        cachedMessage.status.error !== undefined &&\n        autoStatus.type === \"incomplete\" &&\n        autoStatus.reason === \"error\" &&\n        autoStatus.error !== undefined &&\n        (cachedMessage.status.error === autoStatus.error ||\n          isJSONValueEqual(cachedMessage.status.error, autoStatus.error))))\n  ) {\n    const inputs = getExternalStoreMessages<T>(cachedMessage);\n    if (shallowArrayEqual(inputs, message.inputs)) {\n      // A positional fallback id goes stale when messages are prepended\n      // or reordered; serving it unchanged makes two messages collide on\n      // one id and the dedup downstream drops one of them.\n      if (\n        cache.generatedFallbackMessages.has(cachedMessage) &&\n        cachedMessage.id !== fallbackId\n      ) {\n        const updated = { ...cachedMessage, id: fallbackId };\n        cache.generatedFallbackMessages.add(updated);\n        bindExternalStoreMessage(updated, message.inputs);\n        return updated;\n      }\n      return cachedMessage;\n    }\n  }\n\n  const newMessage = fromThreadMessageLike(joined, fallbackId, autoStatus);\n  if (cache && joined.id == null) {\n    cache.generatedFallbackMessages.add(newMessage);\n  }\n  bindExternalStoreMessage(newMessage, message.inputs);\n  return newMessage;\n};\n\nfunction createErrorAssistantMessage(\n  error: ReadonlyJSONValue,\n): ThreadAssistantMessage {\n  const msg: ThreadAssistantMessage = {\n    id: generateErrorMessageId(),\n    role: \"assistant\",\n    content: [],\n    status: { type: \"incomplete\", reason: \"error\", error },\n    createdAt: new Date(),\n    metadata: {\n      unstable_state: null,\n      unstable_annotations: [],\n      unstable_data: [],\n      custom: {},\n      steps: [],\n    },\n  };\n  bindExternalStoreMessage(msg, []);\n  return msg;\n}\n\nexport const completeExternalMessageConversion = (\n  messages: ThreadMessage[],\n  error: ReadonlyJSONValue | undefined,\n) => {\n  if (error) {\n    const lastMessage = messages.at(-1);\n    if (!lastMessage || lastMessage.role !== \"assistant\") {\n      messages.push(createErrorAssistantMessage(error));\n    }\n  }\n  return messages;\n};\n\nexport const convertExternalMessages = <T extends WeakKey>(\n  messages: T[],\n  callback: ExternalMessageConverterCallback<T>,\n  isRunning: boolean,\n  metadata: ExternalMessageConverterMetadata,\n) => {\n  const callbackResults = messages.map((message) =>\n    convertExternalMessageCallback(message, callback, metadata),\n  );\n  const chunks = chunkExternalMessages(callbackResults);\n  const result = chunks.map((message, idx) =>\n    convertExternalMessageChunk(\n      message,\n      idx,\n      chunks.length,\n      isRunning,\n      metadata.error,\n    ),\n  );\n  return completeExternalMessageConversion(result, metadata.error);\n};\n"],"mappings":";;;;;;AAsEA,MAAM6C,qBAAqBC,UAAmB;CAC5C,IAAIC;CACJ,IAAI;EACFA,OAAOD,iBAAiBE,QAAQC,OAAOH,KAAK,IAAII,KAAKC,UAAUL,KAAK;CACtE,QAAQ,CACN;CAEFC,SAASE,OAAOH,KAAK;CACrB,OAAOC,KAAKK,SAAS,MAAM,GAAGL,KAAKM,MAAM,GAAG,GAAG,EAAC,KAAMN;AACxD;AAEA,MAAMO,qBACJC,QACAhB,UACsC;CACtC,MAAMC,UAAUgB,MAAMC,QAAQF,MAAM,IAAIA,SAAS,CAACA,MAAM;CACxD,KAAK,MAAMG,KAAKlB,SAOd,IAAI,EALF,OAAOkB,MAAM,YACbA,MAAM,SACLA,EAAEpC,SAAS,WACRoC,EAAEpC,SAAS,eAAeoC,EAAEpC,SAAS,UAAUoC,EAAEpC,SAAS,cACzD,OAAOoC,EAAEE,YAAY,YAAYJ,MAAMC,QAAQC,EAAEE,OAAO,MAE7D,MAAM,IAAIZ,MACR,mFAAmFH,kBAAkBa,CAAC,EAAC,cAAeb,kBAAkBN,KAAK,EAAC,2CAChJ;CAKJ,OAAOC,QAAQqB,QAAQH,MAAM;EAC3B,IAAIA,EAAEpC,SAAS,QAAQ,OAAO;EAC9B,IAAI,OAAOoC,EAAEnC,eAAe,YAAYmC,EAAEnC,WAAW6B,SAAS,GAC5D,OAAO;EACT,IAAI,CAACU,yBAAyBC,IAAIL,CAAC,GAAG;GACpCI,yBAAyBE,IAAIN,CAAC;GAC9BO,QAAQC,KACN,4EAA4ErB,kBAAkBa,CAAC,EAAC,cAAeb,kBAAkBN,KAAK,EAAC,EACzI;EACF;EACA,OAAO;CACT,CAAC;AACH;AAEA,MAAMuB,2CAA2B,IAAIK,QAAgB;AAErD,MAAaC,kCACX7B,OACA8B,UACAhC,cAC+C;CAC/CE;CACAC,SAASc,kBAAkBe,SAAS9B,OAAOF,QAAQ,GAAGE,KAAK;AAC7D;AAEA,MAAM+B,sBAAsBC,UAAkBC,cAAsB,GACjEzD,qBAAqB,CACpB,GAAKwD,SAAiBxD,uBAAuB,CAAA,GAC7C,GAAKyD,SAAiBzD,uBAAuB,CAAA,CAAG,EAEpD;AAEA,MAAa0D,wBACX7C,aACsB;CACtB,MAAM8C,mBAGF;EACFpD,MAAM;EACNsC,SAAS,CAAA;CACX;CACA,KAAK,MAAML,UAAU3B,UACnB,IAAI2B,OAAOjC,SAAS,QAAQ;EAC1B,MAAMuD,cAAcH,iBAAiBd,QAAQkB,WAC1CC,MAAMA,EAAEC,SAAS,eAAeD,EAAExD,eAAegC,OAAOhC,UAC3D;EAGA,IAAIsD,gBAAgB,IAAI;GACtB,MAAMI,WAAWP,iBAAiBd,QAChCiB;GAEF,IAAItB,OAAO/B,YAAY,MACjByD;QAAAA,SAASzD,aAAa+B,OAAO/B,UAC/B,MAAM,IAAIwB,MACR,kBAAkBO,OAAOhC,WAAU,GAAIgC,OAAO/B,SAAQ,qCAAsCyD,SAASzD,UACvG;GAAA;GAEJkD,iBAAiBd,QAAQiB,eAAe;IACtC,GAAGI;KAEAlE,qBAAqB,CACpB,GAAKkE,SAAiBlE,uBAAuB,CAAA,GAC7CwC,MAAM;IAGV9B,QAAQ8B,OAAO9B;IACfC,UAAU6B,OAAO7B;IACjBC,SAAS4B,OAAO5B;IAChBC,UAAU2B,OAAO3B;GACnB;EACF;CACF,OAAO;EACL,MAAMN,OAAOiC,OAAOjC;EACpB,MAAMsC,WACJ,OAAOL,OAAOK,YAAY,WACtB,CAAC;GAAEoB,MAAM;GAAiBjC,MAAMQ,OAAOK;EAAQ,CAAC,IAChDL,OAAOK,QAAAA,CACXuB,KAAKJ,OAAO;GACZ,GAAGA;IACGhE,qBAAqB,CAACwC,MAAM;EACpC,EAAE;EACF,QAAQjC,MAAR;GACE,KAAK;GACL,KAAK,QACH,OAAO;IACL,GAAGiC;IACHK;GACF;GACF,KAAK;IACH,IAAIc,iBAAiBd,QAAQR,WAAW,GAAG;KACzCsB,iBAAiBU,KAAK7B,OAAO6B;KAC7BV,iBAAiBW,cAAc9B,OAAO8B;KACtCX,iBAAiBY,WAAW/B,OAAO+B;KAEnC,IAAI/B,OAAOgC,aACTb,iBAAiBa,cAAc,CAC7B,GAAIb,iBAAiBa,eAAe,CAAA,GACpC,GAAGhC,OAAOgC,WAAW;IAG3B;IAEA,IAAIhC,OAAOlB,UAAU;KACnBqC,iBAAiBrC,aAAa,CAAC;KAC/B,IAAIkB,OAAOlB,SAASmD,mBAAmBC,KAAAA,GACrCf,iBAAiBrC,SAASmD,iBACxBjC,OAAOlB,SAASmD;KAEpB,IAAIjC,OAAOlB,SAASqD,sBAClBhB,iBAAiBrC,SAASqD,uBAAuB,CAC/C,GAAIhB,iBAAiBrC,SAASqD,wBAAwB,CAAA,GACtD,GAAGnC,OAAOlB,SAASqD,oBAAoB;KAG3C,IAAInC,OAAOlB,SAASsD,eAClBjB,iBAAiBrC,SAASsD,gBAAgB,CACxC,GAAIjB,iBAAiBrC,SAASsD,iBAAiB,CAAA,GAC/C,GAAGpC,OAAOlB,SAASsD,aAAa;KAGpC,IAAIpC,OAAOlB,SAASuD,OAClBlB,iBAAiBrC,SAASuD,QAAQ,CAChC,GAAIlB,iBAAiBrC,SAASuD,SAAS,CAAA,GACvC,GAAGrC,OAAOlB,SAASuD,KAAK;KAG5B,IAAIrC,OAAOlB,SAASwD,QAClBnB,iBAAiBrC,SAASwD,SAAS;MACjC,GAAInB,iBAAiBrC,SAASwD,UAAU,CAAC;MACzC,GAAGtC,OAAOlB,SAASwD;KACrB;KAGF,IAAItC,OAAOlB,SAASyD,QAClBpB,iBAAiBrC,SAASyD,SAASvC,OAAOlB,SAASyD;KAGrD,IAAIvC,OAAOlB,SAAS0D,mBAClBrB,iBAAiBrC,SAAS0D,oBACxBxC,OAAOlB,SAAS0D;KAGpB,IAAIxC,OAAOlB,SAAS2D,cAClBtB,iBAAiBrC,SAAS2D,eAAe;IAG7C;IAGA,KAAK,MAAMC,QAAQrC,SAAS;KAC1B,IAAIqC,KAAKjB,SAAS,aAAa;MAC7B,MAAMkB,cAAcxB,iBAAiBd,QAAQkB,WAC1CC,MACCA,EAAEC,SAAS,eAAeD,EAAExD,eAAe0E,KAAK1E,UACpD;MACA,IAAI2E,gBAAgB,IAAI;OACtB,MAAM3B,WAAWG,iBAAiBd,QAChCsC;OAEFxB,iBAAiBd,QAAQsC,eAAe;QACtC,GAAG3B;QACH,GAAG0B;QACH,GAAG3B,mBAAmBC,UAAU0B,IAAI;OACtC;OACA;MACF;KACF;KAEA,IACEA,KAAKjB,SAAS,eACd,cAAciB,QACdA,KAAKE,UACL;MACA,MAAMD,cAAcxB,iBAAiBd,QAAQkB,WAC1CC,MACCA,EAAEC,SAAS,eACX,cAAcD,KACdA,EAAEoB,aAAaF,KAAKE,QACxB;MACA,IAAID,gBAAgB,IAAI;OACtB,MAAM3B,WAAWG,iBAAiBd,QAChCsC;OAEFxB,iBAAiBd,QAAQsC,eAAe;QACtC,GAAG3B;QACHxB,MAAM,GAAGwB,SAASxB,KAAI,MAAOkD,KAAKlD;QAClC,GAAGuB,mBAAmBC,UAAU0B,IAAI;OACtC;OACA;MACF;KACF;KACAvB,iBAAiBd,QAAQwC,KAAKH,IAAI;IACpC;IACA;GACF,SAEE,MAAM,IAAIjD,MAAM,yBAAyBqD,MAAiB;EAE9D;CACF;CAEF,OAAO3B;AACT;AAEA,MAAa4B,yBACXC,iBACAlF,iBACG;CACH,MAAMmF,UAA8C,CAAA;CACpD,IAAIC,cAAc;CAClB,IAAIC,cAAc;CAClB,IAAIhE,SAAc,CAAA;CAClB,IAAIF,UAA6C,CAAA;CAEjD,MAAMmE,cAAc;EAClB,IAAInE,QAAQY,QACVoD,QAAQJ,KAAK;GACX1D;GACAF;EACF,CAAC;EAEHE,SAAS,CAAA;EACTF,UAAU,CAAA;EACViE,cAAc;EACdC,cAAc;CAChB;CAEA,KAAK,MAAME,kBAAkBL,iBAC3B,KAAK,MAAMhD,UAAUqD,eAAepE,SAAS;EAC3C,IACGkE,eAAenD,OAAOjC,SAAS,UAChC,CAACmF,eACDlD,OAAOjC,SAAS,UAChBiC,OAAOjC,SAAS,UAEhBqF,MAAM;EAERF,cAAclD,OAAOjC,SAAS,eAAeiC,OAAOjC,SAAS;EAE7D,IAAIoB,OAAOmE,GAAG,EAAE,MAAMD,eAAerE,OACnCG,OAAO0D,KAAKQ,eAAerE,KAAK;EAElCC,QAAQ4D,KAAK7C,MAAM;EAEnB,IACEA,OAAOjC,SAAS,gBACfiC,OAAOnC,eAAeC,iBAAiB,UACtCA,iBAAiB,SAEnBqF,cAAc;CAElB;CAEFC,MAAM;CACN,OAAOH;AACT;AAEA,MAAaM,qBAAqBC,GAAcC,MAAiB;CAC/D,IAAID,EAAE3D,WAAW4D,EAAE5D,QAAQ,OAAO;CAClC,KAAK,IAAI6D,IAAI,GAAGA,IAAIF,EAAE3D,QAAQ6D,KAC5B,IAAIF,EAAEE,OAAOD,EAAEC,IAAI,OAAO;CAE5B,OAAO;AACT;AAOA,MAAaG,+BACXjF,SACAkF,KACAC,YACAC,WACAvF,OACAwF,UACG;CACH,MAAMC,SAASJ,QAAQC,aAAa;CACpC,MAAMI,SAASjD,qBAAqBtC,QAAQK,OAAO;CACnD,MAAMmF,0BACJ,OAAOD,OAAO9D,YAAY,YAC1B8D,OAAO9D,QAAQgE,KAAKlH,qBAAqB;CAC3C,MAAMmH,sBACJ,OAAOH,OAAO9D,YAAY,YAC1B8D,OAAO9D,QAAQgE,KAAKjH,iBAAiB;CACvC,MAAMmH,aAAatH,cACjBiH,QACAF,WACAI,yBACAE,qBACAJ,SAASzF,QAAQyD,KAAAA,CACnB;CACA,MAAMsC,aAAa,GAAGlH,qBAAqBwG;CAE3C,MAAMW,gBAAgBR,OAAOrF;CAC7B,IACE6F,kBACCA,cAAc1G,SAAS,eACtB,CAACb,aAAauH,cAAc1C,MAAM,KAClC0C,cAAc1C,WAAWwC,cACxBE,cAAc1C,OAAON,SAAS,gBAC7BgD,cAAc1C,OAAO2C,WAAW,WAChCD,cAAc1C,OAAOtD,UAAUyD,KAAAA,KAC/BqC,WAAW9C,SAAS,gBACpB8C,WAAWG,WAAW,WACtBH,WAAW9F,UAAUyD,KAAAA,MACpBuC,cAAc1C,OAAOtD,UAAU8F,WAAW9F,SACzCzB,iBAAiByH,cAAc1C,OAAOtD,OAAO8F,WAAW9F,KAAK,KACnE;EACA,MAAMU,SAAS5B,yBAA4BkH,aAAa;EACxD,IAAIlB,kBAAkBpE,QAAQP,QAAQO,MAAM,GAAG;GAI7C,IACE8E,MAAML,0BAA0BpD,IAAIiE,aAAa,KACjDA,cAAc5C,OAAO2C,YACrB;IACA,MAAMG,UAAU;KAAE,GAAGF;KAAe5C,IAAI2C;IAAW;IACnDP,MAAML,0BAA0BnD,IAAIkE,OAAO;IAC3CtH,yBAAyBsH,SAAS/F,QAAQO,MAAM;IAChD,OAAOwF;GACT;GACA,OAAOF;EACT;CACF;CAEA,MAAMG,aAAanH,sBAAsB0G,QAAQK,YAAYD,UAAU;CACvE,IAAIN,SAASE,OAAOtC,MAAM,MACxBoC,MAAML,0BAA0BnD,IAAImE,UAAU;CAEhDvH,yBAAyBuH,YAAYhG,QAAQO,MAAM;CACnD,OAAOyF;AACT;AAEA,SAASC,4BACPpG,OACwB;CACxB,MAAMqG,MAA8B;EAClCjD,IAAI9E,uBAAuB;EAC3BgB,MAAM;EACNsC,SAAS,CAAA;EACT0B,QAAQ;GAAEN,MAAM;GAAciD,QAAQ;GAASjG;EAAM;EACrDqD,2BAAW,IAAIiD,KAAK;EACpBjG,UAAU;GACRmD,gBAAgB;GAChBE,sBAAsB,CAAA;GACtBC,eAAe,CAAA;GACfE,QAAQ,CAAC;GACTD,OAAO,CAAA;EACT;CACF;CACAhF,yBAAyByH,KAAK,CAAA,CAAE;CAChC,OAAOA;AACT;AAEA,MAAaE,qCACX3G,UACAI,UACG;CACH,IAAIA,OAAO;EACT,MAAMwG,cAAc5G,SAASiF,GAAG,EAAE;EAClC,IAAI,CAAC2B,eAAeA,YAAYlH,SAAS,aACvCM,SAASwE,KAAKgC,4BAA4BpG,KAAK,CAAC;CAEpD;CACA,OAAOJ;AACT;AAEA,MAAa6G,2BACX7G,UACAyC,UACAkD,WACAlF,aACG;CACH,MAAMkE,kBAAkB3E,SAASuD,KAAKhD,YACpCiC,+BAA+BjC,SAASkC,UAAUhC,QAAQ,CAC5D;CACA,MAAMsG,SAASrC,sBAAsBC,eAAe;CACpD,MAAM9E,SAASkH,OAAOxD,KAAKhD,SAASkF,QAClCD,4BACEjF,SACAkF,KACAsB,OAAOvF,QACPmE,WACAlF,SAASL,KACX,CACF;CACA,OAAOuG,kCAAkC9G,QAAQY,SAASL,KAAK;AACjE"}
+{"version":3,"file":"external-message-conversion.js","names":["ReadonlyJSONValue","ToolExecutionStatus","ThreadAssistantMessage","ThreadMessage","ToolCallMessagePart","MessageTiming","generateErrorMessageId","isJSONValueEqual","getAutoStatus","isAutoStatus","isInterruptedToolCall","isPendingToolCall","bindExternalStoreMessage","FALLBACK_ID_PREFIX","getExternalStoreMessages","symbolInnerMessage","fromThreadMessageLike","ThreadMessageLike","JoinStrategy","ExternalMessageConverterMessage","convertConfig","joinStrategy","role","toolCallId","toolName","result","artifact","isError","messages","ExternalMessageConverterMetadata","toolStatuses","Record","error","cancelledMessageIds","ReadonlySet","messageTiming","ExternalMessageConverterCallback","message","T","metadata","ExternalMessageConverterCallbackResult","input","outputs","ExternalMessageConverterChunk","inputs","Mutable","P","stringifyForError","value","text","Error","String","JSON","stringify","length","slice","toCallbackOutputs","output","Array","isArray","o","valid","content","filter","warnedDroppedToolResults","has","add","console","warn","WeakSet","convertExternalMessageCallback","callback","mergeInnerMessages","existing","incoming","joinExternalMessages","assistantMessage","Omit","Exclude","toolCallIdx","findIndex","c","type","toolCall","const","map","id","createdAt","status","attachments","unstable_state","undefined","unstable_annotations","unstable_data","steps","custom","timing","submittedFeedback","isOptimistic","part","existingIdx","parentId","push","unsupportedRole","chunkExternalMessages","callbackResults","results","isAssistant","pendingNone","flush","callbackResult","at","shallowArrayEqual","a","b","i","ExternalMessageConversionCache","generatedFallbackMessages","convertExternalMessageChunk","idx","chunkCount","isRunning","cache","isLast","joined","isCancelled","some","hasInterruptedToolCalls","hasPendingToolCalls","autoStatus","fallbackId","cachedMessage","reason","updated","newMessage","createErrorAssistantMessage","msg","Date","completeExternalMessageConversion","lastMessage","convertExternalMessages","WeakKey","chunks"],"sources":["../../../src/runtime/utils/external-message-conversion.ts"],"sourcesContent":["import type { ReadonlyJSONValue } from \"assistant-stream/utils\";\nimport type { ToolExecutionStatus } from \"../../runtimes/tool-invocations/ToolInvocationTracker\";\nimport type {\n  ThreadAssistantMessage,\n  ThreadMessage,\n  ToolCallMessagePart,\n} from \"../../types/message\";\nimport type { MessageTiming } from \"../../types/message\";\nimport { generateErrorMessageId } from \"../../utils/id\";\nimport { isJSONValueEqual } from \"../../utils/json/is-json-equal\";\nimport {\n  getAutoStatus,\n  isAutoStatus,\n  isInterruptedToolCall,\n  isPendingToolCall,\n} from \"./auto-status\";\nimport {\n  bindExternalStoreMessage,\n  FALLBACK_ID_PREFIX,\n  getExternalStoreMessages,\n  symbolInnerMessage,\n} from \"./external-store-message\";\nimport {\n  fromThreadMessageLike,\n  type ThreadMessageLike,\n} from \"./thread-message-like\";\n\nexport type JoinStrategy = \"concat-content\" | \"none\";\n\nexport type ExternalMessageConverterMessage =\n  | (ThreadMessageLike & {\n      readonly convertConfig?: {\n        readonly joinStrategy?: JoinStrategy;\n      };\n    })\n  | {\n      role: \"tool\";\n      toolCallId: string;\n      toolName?: string | undefined;\n      result: any;\n      artifact?: any;\n      isError?: boolean;\n      messages?: readonly ThreadMessage[];\n    };\n\nexport type ExternalMessageConverterMetadata = {\n  readonly toolStatuses?: Record<string, ToolExecutionStatus>;\n  readonly error?: ReadonlyJSONValue;\n  readonly cancelledMessageIds?: ReadonlySet<string>;\n  readonly messageTiming?: Record<string, MessageTiming>;\n};\n\nexport type ExternalMessageConverterCallback<T> = (\n  message: T,\n  metadata: ExternalMessageConverterMetadata,\n) => ExternalMessageConverterMessage | ExternalMessageConverterMessage[];\n\nexport type ExternalMessageConverterCallbackResult<T> = {\n  input: T;\n  outputs: ExternalMessageConverterMessage[];\n};\n\nexport type ExternalMessageConverterChunk<T> = {\n  inputs: T[];\n  outputs: ExternalMessageConverterMessage[];\n};\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nconst stringifyForError = (value: unknown) => {\n  let text;\n  try {\n    text = value instanceof Error ? String(value) : JSON.stringify(value);\n  } catch {\n    /* circular */\n  }\n  text ??= String(value);\n  return text.length > 200 ? `${text.slice(0, 200)}…` : text;\n};\n\nconst toCallbackOutputs = (\n  output: ExternalMessageConverterMessage | ExternalMessageConverterMessage[],\n  input: unknown,\n): ExternalMessageConverterMessage[] => {\n  const outputs = Array.isArray(output) ? output : [output];\n  for (const o of outputs) {\n    const valid =\n      typeof o === \"object\" &&\n      o !== null &&\n      (o.role === \"tool\" ||\n        ((o.role === \"assistant\" || o.role === \"user\" || o.role === \"system\") &&\n          (typeof o.content === \"string\" || Array.isArray(o.content))));\n    if (!valid)\n      throw new Error(\n        `External message converter: the converter callback returned an invalid message (${stringifyForError(o)}) for input ${stringifyForError(input)}. Return an empty array to skip a message.`,\n      );\n  }\n  // Providers can emit tool results without a usable id (react-langchain maps\n  // a missing tool_call_id to \"\"); converters must not throw on those, so the\n  // result is dropped like any other orphaned tool output.\n  return outputs.filter((o) => {\n    if (o.role !== \"tool\") return true;\n    if (typeof o.toolCallId === \"string\" && o.toolCallId.length > 0)\n      return true;\n    if (!warnedDroppedToolResults.has(o)) {\n      warnedDroppedToolResults.add(o);\n      console.warn(\n        `External message converter: dropping a tool result without a toolCallId (${stringifyForError(o)}) for input ${stringifyForError(input)}.`,\n      );\n    }\n    return false;\n  });\n};\n\nconst warnedDroppedToolResults = new WeakSet<object>();\n\nexport const convertExternalMessageCallback = <T>(\n  input: T,\n  callback: ExternalMessageConverterCallback<T>,\n  metadata: ExternalMessageConverterMetadata,\n): ExternalMessageConverterCallbackResult<T> => ({\n  input,\n  outputs: toCallbackOutputs(callback(input, metadata), input),\n});\n\nconst mergeInnerMessages = (existing: object, incoming: object) => ({\n  [symbolInnerMessage]: [\n    ...((existing as any)[symbolInnerMessage] ?? []),\n    ...((incoming as any)[symbolInnerMessage] ?? []),\n  ],\n});\n\nexport const joinExternalMessages = (\n  messages: readonly ExternalMessageConverterMessage[],\n): ThreadMessageLike => {\n  const assistantMessage: Mutable<Omit<ThreadMessageLike, \"metadata\">> & {\n    content: Exclude<ThreadMessageLike[\"content\"][0], string>[];\n    metadata?: Mutable<ThreadMessageLike[\"metadata\"]>;\n  } = {\n    role: \"assistant\",\n    content: [],\n  };\n  for (const output of messages) {\n    if (output.role === \"tool\") {\n      const toolCallIdx = assistantMessage.content.findIndex(\n        (c) => c.type === \"tool-call\" && c.toolCallId === output.toolCallId,\n      );\n      // Ignore orphaned tool results so one bad tool message does not\n      // prevent rendering the rest of the conversation.\n      if (toolCallIdx !== -1) {\n        const toolCall = assistantMessage.content[\n          toolCallIdx\n        ]! as ToolCallMessagePart;\n        if (output.toolName != null) {\n          if (toolCall.toolName !== output.toolName)\n            throw new Error(\n              `Tool call name ${output.toolCallId} ${output.toolName} does not match existing tool call ${toolCall.toolName}`,\n            );\n        }\n        assistantMessage.content[toolCallIdx] = {\n          ...toolCall,\n          ...{\n            [symbolInnerMessage]: [\n              ...((toolCall as any)[symbolInnerMessage] ?? []),\n              output,\n            ],\n          },\n          result: output.result,\n          artifact: output.artifact,\n          isError: output.isError,\n          messages: output.messages,\n        };\n      }\n    } else {\n      const role = output.role;\n      const content = (\n        typeof output.content === \"string\"\n          ? [{ type: \"text\" as const, text: output.content }]\n          : output.content\n      ).map((c) => ({\n        ...c,\n        ...{ [symbolInnerMessage]: [output] },\n      }));\n      switch (role) {\n        case \"system\":\n        case \"user\":\n          return {\n            ...output,\n            content,\n          };\n        case \"assistant\":\n          if (assistantMessage.content.length === 0) {\n            assistantMessage.id = output.id;\n            assistantMessage.createdAt ??= output.createdAt;\n            assistantMessage.status ??= output.status;\n\n            if (output.attachments) {\n              assistantMessage.attachments = [\n                ...(assistantMessage.attachments ?? []),\n                ...output.attachments,\n              ];\n            }\n          }\n\n          if (output.metadata) {\n            assistantMessage.metadata ??= {};\n            if (output.metadata.unstable_state !== undefined) {\n              assistantMessage.metadata.unstable_state =\n                output.metadata.unstable_state;\n            }\n            if (output.metadata.unstable_annotations) {\n              assistantMessage.metadata.unstable_annotations = [\n                ...(assistantMessage.metadata.unstable_annotations ?? []),\n                ...output.metadata.unstable_annotations,\n              ];\n            }\n            if (output.metadata.unstable_data) {\n              assistantMessage.metadata.unstable_data = [\n                ...(assistantMessage.metadata.unstable_data ?? []),\n                ...output.metadata.unstable_data,\n              ];\n            }\n            if (output.metadata.steps) {\n              assistantMessage.metadata.steps = [\n                ...(assistantMessage.metadata.steps ?? []),\n                ...output.metadata.steps,\n              ];\n            }\n            if (output.metadata.custom) {\n              assistantMessage.metadata.custom = {\n                ...(assistantMessage.metadata.custom ?? {}),\n                ...output.metadata.custom,\n              };\n            }\n\n            if (output.metadata.timing) {\n              assistantMessage.metadata.timing = output.metadata.timing;\n            }\n\n            if (output.metadata.submittedFeedback) {\n              assistantMessage.metadata.submittedFeedback =\n                output.metadata.submittedFeedback;\n            }\n\n            if (output.metadata.isOptimistic) {\n              assistantMessage.metadata.isOptimistic = true;\n            }\n            // TODO keep this in sync with ThreadMessageLike[\"metadata\"] / fromThreadMessageLike\n          }\n\n          // Add content parts, merging reasoning parts with same parentId\n          for (const part of content) {\n            if (part.type === \"tool-call\") {\n              const existingIdx = assistantMessage.content.findIndex(\n                (c) =>\n                  c.type === \"tool-call\" && c.toolCallId === part.toolCallId,\n              );\n              if (existingIdx !== -1) {\n                const existing = assistantMessage.content[\n                  existingIdx\n                ] as typeof part;\n                assistantMessage.content[existingIdx] = {\n                  ...existing,\n                  ...part,\n                  ...mergeInnerMessages(existing, part),\n                };\n                continue;\n              }\n            }\n\n            if (\n              part.type === \"reasoning\" &&\n              \"parentId\" in part &&\n              part.parentId\n            ) {\n              const existingIdx = assistantMessage.content.findIndex(\n                (c) =>\n                  c.type === \"reasoning\" &&\n                  \"parentId\" in c &&\n                  c.parentId === part.parentId,\n              );\n              if (existingIdx !== -1) {\n                const existing = assistantMessage.content[\n                  existingIdx\n                ] as typeof part;\n                assistantMessage.content[existingIdx] = {\n                  ...existing,\n                  text: `${existing.text}\\n\\n${part.text}`,\n                  ...mergeInnerMessages(existing, part),\n                };\n                continue;\n              }\n            }\n            assistantMessage.content.push(part);\n          }\n          break;\n        default: {\n          const unsupportedRole: never = role;\n          throw new Error(`Unknown message role: ${unsupportedRole}`);\n        }\n      }\n    }\n  }\n  return assistantMessage;\n};\n\nexport const chunkExternalMessages = <T>(\n  callbackResults: ExternalMessageConverterCallbackResult<T>[],\n  joinStrategy?: JoinStrategy,\n) => {\n  const results: ExternalMessageConverterChunk<T>[] = [];\n  let isAssistant = false;\n  let pendingNone = false; // true if the previous assistant message had joinStrategy \"none\"\n  let inputs: T[] = [];\n  let outputs: ExternalMessageConverterMessage[] = [];\n\n  const flush = () => {\n    if (outputs.length) {\n      results.push({\n        inputs,\n        outputs,\n      });\n    }\n    inputs = [];\n    outputs = [];\n    isAssistant = false;\n    pendingNone = false;\n  };\n\n  for (const callbackResult of callbackResults) {\n    for (const output of callbackResult.outputs) {\n      if (\n        (pendingNone && output.role !== \"tool\") ||\n        !isAssistant ||\n        output.role === \"user\" ||\n        output.role === \"system\"\n      ) {\n        flush();\n      }\n      isAssistant = output.role === \"assistant\" || output.role === \"tool\";\n\n      if (inputs.at(-1) !== callbackResult.input) {\n        inputs.push(callbackResult.input);\n      }\n      outputs.push(output);\n\n      if (\n        output.role === \"assistant\" &&\n        (output.convertConfig?.joinStrategy === \"none\" ||\n          joinStrategy === \"none\")\n      ) {\n        pendingNone = true;\n      }\n    }\n  }\n  flush();\n  return results;\n};\n\nexport const shallowArrayEqual = (\n  a: readonly unknown[],\n  b: readonly unknown[],\n) => {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n};\n\ntype ExternalMessageConversionCache = {\n  message: ThreadMessage | undefined;\n  generatedFallbackMessages: WeakSet<object>;\n};\n\nexport const convertExternalMessageChunk = <T>(\n  message: ExternalMessageConverterChunk<T>,\n  idx: number,\n  chunkCount: number,\n  isRunning: boolean,\n  error: ReadonlyJSONValue | undefined,\n  cache?: ExternalMessageConversionCache,\n  cancelledMessageIds?: ReadonlySet<string>,\n) => {\n  const isLast = idx === chunkCount - 1;\n  const joined = joinExternalMessages(message.outputs);\n  const isCancelled =\n    cancelledMessageIds !== undefined &&\n    message.outputs.some(\n      (output) =>\n        output.role !== \"tool\" &&\n        output.id != null &&\n        cancelledMessageIds.has(output.id),\n    );\n  const hasInterruptedToolCalls =\n    typeof joined.content === \"object\" &&\n    joined.content.some(isInterruptedToolCall);\n  const hasPendingToolCalls =\n    typeof joined.content === \"object\" &&\n    joined.content.some(isPendingToolCall);\n  const autoStatus = getAutoStatus(\n    isLast,\n    isRunning,\n    hasInterruptedToolCalls,\n    hasPendingToolCalls,\n    isLast ? error : undefined,\n    isCancelled,\n  );\n  const fallbackId = `${FALLBACK_ID_PREFIX}${idx}`;\n\n  const cachedMessage = cache?.message;\n  if (\n    cachedMessage &&\n    (cachedMessage.role !== \"assistant\" ||\n      !isAutoStatus(cachedMessage.status) ||\n      cachedMessage.status === autoStatus ||\n      (cachedMessage.status.type === \"incomplete\" &&\n        cachedMessage.status.reason === \"error\" &&\n        cachedMessage.status.error !== undefined &&\n        autoStatus.type === \"incomplete\" &&\n        autoStatus.reason === \"error\" &&\n        autoStatus.error !== undefined &&\n        (cachedMessage.status.error === autoStatus.error ||\n          isJSONValueEqual(cachedMessage.status.error, autoStatus.error))))\n  ) {\n    const inputs = getExternalStoreMessages<T>(cachedMessage);\n    if (shallowArrayEqual(inputs, message.inputs)) {\n      // A positional fallback id goes stale when messages are prepended\n      // or reordered; serving it unchanged makes two messages collide on\n      // one id and the dedup downstream drops one of them.\n      if (\n        cache.generatedFallbackMessages.has(cachedMessage) &&\n        cachedMessage.id !== fallbackId\n      ) {\n        const updated = { ...cachedMessage, id: fallbackId };\n        cache.generatedFallbackMessages.add(updated);\n        bindExternalStoreMessage(updated, message.inputs);\n        return updated;\n      }\n      return cachedMessage;\n    }\n  }\n\n  const newMessage = fromThreadMessageLike(joined, fallbackId, autoStatus);\n  if (cache && joined.id == null) {\n    cache.generatedFallbackMessages.add(newMessage);\n  }\n  bindExternalStoreMessage(newMessage, message.inputs);\n  return newMessage;\n};\n\nfunction createErrorAssistantMessage(\n  error: ReadonlyJSONValue,\n): ThreadAssistantMessage {\n  const msg: ThreadAssistantMessage = {\n    id: generateErrorMessageId(),\n    role: \"assistant\",\n    content: [],\n    status: { type: \"incomplete\", reason: \"error\", error },\n    createdAt: new Date(),\n    metadata: {\n      unstable_state: null,\n      unstable_annotations: [],\n      unstable_data: [],\n      custom: {},\n      steps: [],\n    },\n  };\n  bindExternalStoreMessage(msg, []);\n  return msg;\n}\n\nexport const completeExternalMessageConversion = (\n  messages: ThreadMessage[],\n  error: ReadonlyJSONValue | undefined,\n) => {\n  if (error) {\n    const lastMessage = messages.at(-1);\n    if (!lastMessage || lastMessage.role !== \"assistant\") {\n      messages.push(createErrorAssistantMessage(error));\n    }\n  }\n  return messages;\n};\n\nexport const convertExternalMessages = <T extends WeakKey>(\n  messages: T[],\n  callback: ExternalMessageConverterCallback<T>,\n  isRunning: boolean,\n  metadata: ExternalMessageConverterMetadata,\n) => {\n  const callbackResults = messages.map((message) =>\n    convertExternalMessageCallback(message, callback, metadata),\n  );\n  const chunks = chunkExternalMessages(callbackResults);\n  const result = chunks.map((message, idx) =>\n    convertExternalMessageChunk(\n      message,\n      idx,\n      chunks.length,\n      isRunning,\n      metadata.error,\n      undefined,\n      metadata.cancelledMessageIds,\n    ),\n  );\n  return completeExternalMessageConversion(result, metadata.error);\n};\n"],"mappings":"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"}

package/dist/runtime/utils/resolveToolApprovalResponse.d.ts

@@ -1,12 +1,15 @@
-import { ToolApprovalOption, ToolApprovalResponse } from "../../types/message.js";
+import { ToolApprovalDisplay, ToolApprovalOption, ToolApprovalResponse } from "../../types/message.js";
 import { RespondToToolApprovalOptions } from "../interfaces/thread-runtime-core.js";
 //#region src/runtime/utils/resolveToolApprovalResponse.d.ts
 /**
- * Resolves a renderer-facing approval response (boolean or optionId form)
- * against the approval's option list into the runtime-facing decision shape.
+ * Resolves a renderer-facing approval response (boolean, optionId, or
+ * free-form answer) against the approval's request shape into the
+ * runtime-facing decision shape.
  */
 declare const resolveToolApprovalResponse: (approval: {
   readonly id: string;
+  readonly display?: ToolApprovalDisplay;
+  readonly allowFreeform?: boolean;
   readonly options?: readonly ToolApprovalOption[];
 }, response: ToolApprovalResponse) => RespondToToolApprovalOptions;
 //#endregion

package/dist/runtime/utils/resolveToolApprovalResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveToolApprovalResponse.d.ts","names":[],"sources":["../../../src/runtime/utils/resolveToolApprovalResponse.ts"],"mappings":";;;;;;;cAiBa,8BACX;WACW;WACA,mBAAmB;GAE9B,UAAU,yBACT"}
+{"version":3,"file":"resolveToolApprovalResponse.d.ts","names":[],"sources":["../../../src/runtime/utils/resolveToolApprovalResponse.ts"],"mappings":";;;;;;;;cAoBa,8BACX;WACW;WACA,UAAU;WACV;WACA,mBAAmB;GAE9B,UAAU,yBACT"}

package/dist/runtime/utils/resolveToolApprovalResponse.js

@@ -1,3 +1,4 @@
+import { toolApprovalAcceptsText } from "../../types/message.js";
 //#region src/runtime/utils/resolveToolApprovalResponse.ts
 const APPROVED_BY_KIND = {
 	"allow-once": true,
@@ -6,10 +7,13 @@ const APPROVED_BY_KIND = {
 	"reject-always": false
 };
 /**
-* Resolves a renderer-facing approval response (boolean or optionId form)
-* against the approval's option list into the runtime-facing decision shape.
+* Resolves a renderer-facing approval response (boolean, optionId, or
+* free-form answer) against the approval's request shape into the
+* runtime-facing decision shape.
 */
 const resolveToolApprovalResponse = (approval, response) => {
+	const text = response.text;
+	if (text !== void 0 && !toolApprovalAcceptsText(approval)) throw new Error(`Tool approval "${approval.id}" does not accept a free-form answer; the request must declare display "text" or allowFreeform`);
 	let approved;
 	let optionId;
 	if ("optionId" in response) {
@@ -21,11 +25,16 @@ const resolveToolApprovalResponse = (approval, response) => {
 			approved = APPROVED_BY_KIND[option.kind];
 		}
 		optionId = option.id;
-	} else approved = response.approved;
+	} else if ("approved" in response) approved = response.approved;
+	else {
+		if (approval.display !== "text" && approval.display !== "select") throw new Error(`Tool approval "${approval.id}" is a decision, not a question; respond with an explicit approved value, optionally alongside the answer`);
+		approved = true;
+	}
 	return {
 		approvalId: approval.id,
 		approved,
 		...optionId !== void 0 && { optionId },
+		...text !== void 0 && { text },
 		...response.reason != null && { reason: response.reason }
 	};
 };

package/dist/runtime/utils/resolveToolApprovalResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveToolApprovalResponse.js","names":["ToolApprovalOption","ToolApprovalResponse","RespondToToolApprovalOptions","APPROVED_BY_KIND","Record","resolveToolApprovalResponse","approval","id","options","response","approved","optionId","option","find","o","Error","Object","hasOwn","kind","approvalId","undefined","reason"],"sources":["../../../src/runtime/utils/resolveToolApprovalResponse.ts"],"sourcesContent":["import type {\n  ToolApprovalOption,\n  ToolApprovalResponse,\n} from \"../../types/message\";\nimport type { RespondToToolApprovalOptions } from \"../interfaces/thread-runtime-core\";\n\nconst APPROVED_BY_KIND: Record<string, boolean> = {\n  \"allow-once\": true,\n  \"allow-always\": true,\n  \"reject-once\": false,\n  \"reject-always\": false,\n};\n\n/**\n * Resolves a renderer-facing approval response (boolean or optionId form)\n * against the approval's option list into the runtime-facing decision shape.\n */\nexport const resolveToolApprovalResponse = (\n  approval: {\n    readonly id: string;\n    readonly options?: readonly ToolApprovalOption[];\n  },\n  response: ToolApprovalResponse,\n): RespondToToolApprovalOptions => {\n  let approved: boolean;\n  let optionId: string | undefined;\n\n  if (\"optionId\" in response) {\n    const option = approval.options?.find((o) => o.id === response.optionId);\n    if (!option)\n      throw new Error(\n        `Tool approval has no option with id \"${response.optionId}\"`,\n      );\n\n    if (\"approved\" in response) {\n      approved = response.approved;\n    } else {\n      if (!Object.hasOwn(APPROVED_BY_KIND, option.kind))\n        throw new Error(\n          `Tool approval option \"${option.id}\" has a custom kind \"${option.kind}\"; respond with an explicit approved value instead`,\n        );\n      approved = APPROVED_BY_KIND[option.kind]!;\n    }\n    optionId = option.id;\n  } else {\n    approved = response.approved;\n  }\n\n  return {\n    approvalId: approval.id,\n    approved,\n    ...(optionId !== undefined && { optionId }),\n    ...(response.reason != null && { reason: response.reason }),\n  };\n};\n"],"mappings":";AAMA,MAAMG,mBAA4C;CAChD,cAAc;CACd,gBAAgB;CAChB,eAAe;CACf,iBAAiB;AACnB;;;;;AAMA,MAAaE,+BACXC,UAIAG,aACiC;CACjC,IAAIC;CACJ,IAAIC;CAEJ,IAAI,cAAcF,UAAU;EAC1B,MAAMG,SAASN,SAASE,SAASK,MAAMC,MAAMA,EAAEP,OAAOE,SAASE,QAAQ;EACvE,IAAI,CAACC,QACH,MAAM,IAAIG,MACR,wCAAwCN,SAASE,SAAQ,EAC3D;EAEF,IAAI,cAAcF,UAChBC,WAAWD,SAASC;OACf;GACL,IAAI,CAACM,OAAOC,OAAOd,kBAAkBS,OAAOM,IAAI,GAC9C,MAAM,IAAIH,MACR,yBAAyBH,OAAOL,GAAE,uBAAwBK,OAAOM,KAAI,mDACvE;GACFR,WAAWP,iBAAiBS,OAAOM;EACrC;EACAP,WAAWC,OAAOL;CACpB,OACEG,WAAWD,SAASC;CAGtB,OAAO;EACLS,YAAYb,SAASC;EACrBG;EACA,GAAIC,aAAaS,KAAAA,KAAa,EAAET,SAAS;EACzC,GAAIF,SAASY,UAAU,QAAQ,EAAEA,QAAQZ,SAASY,OAAO;CAC3D;AACF"}
+{"version":3,"file":"resolveToolApprovalResponse.js","names":["toolApprovalAcceptsText","ToolApprovalDisplay","ToolApprovalOption","ToolApprovalResponse","RespondToToolApprovalOptions","APPROVED_BY_KIND","Record","resolveToolApprovalResponse","approval","id","display","allowFreeform","options","response","text","undefined","Error","approved","optionId","option","find","o","Object","hasOwn","kind","approvalId","reason"],"sources":["../../../src/runtime/utils/resolveToolApprovalResponse.ts"],"sourcesContent":["import {\n  toolApprovalAcceptsText,\n  type ToolApprovalDisplay,\n  type ToolApprovalOption,\n  type ToolApprovalResponse,\n} from \"../../types/message\";\nimport type { RespondToToolApprovalOptions } from \"../interfaces/thread-runtime-core\";\n\nconst APPROVED_BY_KIND: Record<string, boolean> = {\n  \"allow-once\": true,\n  \"allow-always\": true,\n  \"reject-once\": false,\n  \"reject-always\": false,\n};\n\n/**\n * Resolves a renderer-facing approval response (boolean, optionId, or\n * free-form answer) against the approval's request shape into the\n * runtime-facing decision shape.\n */\nexport const resolveToolApprovalResponse = (\n  approval: {\n    readonly id: string;\n    readonly display?: ToolApprovalDisplay;\n    readonly allowFreeform?: boolean;\n    readonly options?: readonly ToolApprovalOption[];\n  },\n  response: ToolApprovalResponse,\n): RespondToToolApprovalOptions => {\n  const text = response.text;\n  if (text !== undefined && !toolApprovalAcceptsText(approval))\n    throw new Error(\n      `Tool approval \"${approval.id}\" does not accept a free-form answer; the request must declare display \"text\" or allowFreeform`,\n    );\n\n  let approved: boolean;\n  let optionId: string | undefined;\n\n  if (\"optionId\" in response) {\n    const option = approval.options?.find((o) => o.id === response.optionId);\n    if (!option)\n      throw new Error(\n        `Tool approval has no option with id \"${response.optionId}\"`,\n      );\n\n    if (\"approved\" in response) {\n      approved = response.approved;\n    } else {\n      if (!Object.hasOwn(APPROVED_BY_KIND, option.kind))\n        throw new Error(\n          `Tool approval option \"${option.id}\" has a custom kind \"${option.kind}\"; respond with an explicit approved value instead`,\n        );\n      approved = APPROVED_BY_KIND[option.kind]!;\n    }\n    optionId = option.id;\n  } else if (\"approved\" in response) {\n    approved = response.approved;\n  } else {\n    // A bare answer resolves a question, where answering is not refusing. On a\n    // decision the approval itself is the authorization, so inferring one from\n    // a typed note would let the note authorize the call.\n    if (approval.display !== \"text\" && approval.display !== \"select\")\n      throw new Error(\n        `Tool approval \"${approval.id}\" is a decision, not a question; respond with an explicit approved value, optionally alongside the answer`,\n      );\n    approved = true;\n  }\n\n  return {\n    approvalId: approval.id,\n    approved,\n    ...(optionId !== undefined && { optionId }),\n    ...(text !== undefined && { text }),\n    ...(response.reason != null && { reason: response.reason }),\n  };\n};\n"],"mappings":";;AAQA,MAAMK,mBAA4C;CAChD,cAAc;CACd,gBAAgB;CAChB,eAAe;CACf,iBAAiB;AACnB;;;;;;AAOA,MAAaE,+BACXC,UAMAK,aACiC;CACjC,MAAMC,OAAOD,SAASC;CACtB,IAAIA,SAASC,KAAAA,KAAa,CAACf,wBAAwBQ,QAAQ,GACzD,MAAM,IAAIQ,MACR,kBAAkBR,SAASC,GAAE,+FAC/B;CAEF,IAAIQ;CACJ,IAAIC;CAEJ,IAAI,cAAcL,UAAU;EAC1B,MAAMM,SAASX,SAASI,SAASQ,MAAMC,MAAMA,EAAEZ,OAAOI,SAASK,QAAQ;EACvE,IAAI,CAACC,QACH,MAAM,IAAIH,MACR,wCAAwCH,SAASK,SAAQ,EAC3D;EAEF,IAAI,cAAcL,UAChBI,WAAWJ,SAASI;OACf;GACL,IAAI,CAACK,OAAOC,OAAOlB,kBAAkBc,OAAOK,IAAI,GAC9C,MAAM,IAAIR,MACR,yBAAyBG,OAAOV,GAAE,uBAAwBU,OAAOK,KAAI,mDACvE;GACFP,WAAWZ,iBAAiBc,OAAOK;EACrC;EACAN,WAAWC,OAAOV;CACpB,OAAO,IAAI,cAAcI,UACvBI,WAAWJ,SAASI;MACf;EAIL,IAAIT,SAASE,YAAY,UAAUF,SAASE,YAAY,UACtD,MAAM,IAAIM,MACR,kBAAkBR,SAASC,GAAE,0GAC/B;EACFQ,WAAW;CACb;CAEA,OAAO;EACLQ,YAAYjB,SAASC;EACrBQ;EACA,GAAIC,aAAaH,KAAAA,KAAa,EAAEG,SAAS;EACzC,GAAIJ,SAASC,KAAAA,KAAa,EAAED,KAAK;EACjC,GAAID,SAASa,UAAU,QAAQ,EAAEA,QAAQb,SAASa,OAAO;CAC3D;AACF"}

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

@@ -1,4 +1,4 @@
-import { DataMessagePart, FileMessagePart, GenerativeUIMessagePart, ImageMessagePart, MessageStatus, MessageTiming, PartProviderMetadata, ReasoningMessagePart, SourceMessagePart, TextMessagePart, ThreadMessage, ThreadStep, ThreadUserMessagePart, ToolApprovalOption, ToolCallMessagePartMcpMetadata, ToolCallTiming, Unstable_AudioMessagePart } from "../../types/message.js";
+import { DataMessagePart, FileMessagePart, GenerativeUIMessagePart, ImageMessagePart, MessageStatus, MessageTiming, PartProviderMetadata, ReasoningMessagePart, SourceMessagePart, TextMessagePart, ThreadMessage, ThreadStep, ThreadUserMessagePart, ToolCallMessagePart, ToolCallMessagePartMcpMetadata, ToolCallTiming, Unstable_AudioMessagePart } from "../../types/message.js";
 import { CompleteAttachment } from "../../types/attachment.js";
 import { ReadonlyJSONObject, ReadonlyJSONValue } from "assistant-stream/utils";
 //#region src/runtime/utils/thread-message-like.d.ts
@@ -26,15 +26,7 @@ type ThreadMessageLike = {
     readonly timing?: ToolCallTiming;
     readonly mcp?: ToolCallMessagePartMcpMetadata;
     readonly providerMetadata?: PartProviderMetadata;
-    readonly approval?: {
-      readonly id: string;
-      readonly approved?: boolean;
-      readonly reason?: string;
-      readonly isAutomatic?: boolean;
-      readonly options?: readonly ToolApprovalOption[];
-      readonly optionId?: string;
-      readonly resolution?: "cancelled" | "expired";
-    };
+    readonly approval?: NonNullable<ToolCallMessagePart["approval"]>;
   })[];
   readonly id?: string | undefined;
   readonly createdAt?: Date | undefined;

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":";;;;KAkCK;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;eACE;eACA;eACA;eACA;eACA,mBAAmB;eACnB;eACA;;;WAIZ;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,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":";;;;KAkCK;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,SAAS;;;;;;cAgBb,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","MessageTiming","PartProviderMetadata","TextMessagePart","ToolApprovalOption","ToolCallTiming","ToolCallMessagePartMcpMetadata","ReadonlyJSONObject","ReadonlyJSONValue","DataPrefixedPart","type","data","ThreadMessageLike","role","content","toolCallId","toolName","args","argsText","artifact","result","isError","parentId","messages","interrupt","payload","timing","mcp","providerMetadata","approval","id","approved","reason","isAutomatic","options","optionId","resolution","createdAt","Date","status","attachments","Omit","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","isOptimistic","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  MessageTiming,\n  PartProviderMetadata,\n  TextMessagePart,\n  ToolApprovalOption,\n  ToolCallTiming,\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?: {\n              readonly id: string;\n              readonly approved?: boolean;\n              readonly reason?: string;\n              readonly isAutomatic?: boolean;\n              readonly options?: readonly ToolApprovalOption[];\n              readonly optionId?: string;\n              readonly resolution?: \"cancelled\" | \"expired\";\n            };\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 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        },\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        },\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","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","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  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 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        },\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        },\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/tool-call-tree.d.ts

@@ -0,0 +1,39 @@
+import { ThreadAssistantMessagePart, ThreadMessage, ToolCallMessagePart } from "../../types/message.js";
+//#region src/runtime/utils/tool-call-tree.d.ts
+type ToolCallTreeEntry = {
+  readonly part: ToolCallMessagePart;
+  /** Id of the message whose content directly holds `part`. */
+  readonly messageId: string;
+};
+/**
+ * Walk every tool-call part reachable from `messages`. A tool call projects a
+ * child run as nested messages on `ToolCallMessagePart.messages`, so a
+ * subagent's own calls live below the top-level content and a seam that only
+ * scans the top level cannot reach them.
+ *
+ * Parts arrive in document order, each one ahead of its own descendants.
+ * `messageId` names the message that directly holds the part, which for a
+ * nested call is the child run's message rather than the top-level message the
+ * tree hangs from. Only assistant messages are descended, the same rule
+ * {@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>;
+/**
+ * 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>;
+/**
+ * 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): {
+  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

@@ -0,0 +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"}

package/dist/runtime/utils/tool-call-tree.js

@@ -0,0 +1,85 @@
+//#region src/runtime/utils/tool-call-tree.ts
+/**
+* Walk every tool-call part reachable from `messages`. A tool call projects a
+* child run as nested messages on `ToolCallMessagePart.messages`, so a
+* subagent's own calls live below the top-level content and a seam that only
+* scans the top level cannot reach them.
+*
+* Parts arrive in document order, each one ahead of its own descendants.
+* `messageId` names the message that directly holds the part, which for a
+* nested call is the child run's message rather than the top-level message the
+* tree hangs from. Only assistant messages are descended, the same rule
+* {@link mapToolCallPartsDeep} rewrites under, so a part this reports is always
+* a part that can be written back.
+*/
+function* walkToolCallTree(messages) {
+	for (const message of messages) {
+		if (message?.role !== "assistant" || !Array.isArray(message.content)) continue;
+		for (const part of message.content) {
+			if (!part || part.type !== "tool-call") continue;
+			yield {
+				part,
+				messageId: message.id
+			};
+			if (part.messages?.length) yield* walkToolCallTree(part.messages);
+		}
+	}
+}
+/**
+* Content-level form of {@link walkToolCallTree}, for a caller that already
+* holds one assistant message's content and does not need the owning id.
+*/
+function* iterateToolCallParts(content) {
+	for (const part of content) {
+		if (!part || part.type !== "tool-call") continue;
+		yield part;
+		if (part.messages?.length) for (const entry of walkToolCallTree(part.messages)) yield entry.part;
+	}
+}
+/**
+* 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.
+*/
+function mapToolCallPartsDeep(content, fn) {
+	let changed = false;
+	const next = content.map((part) => {
+		if (part.type !== "tool-call") return part;
+		let mapped = fn(part);
+		if (mapped.messages !== void 0) {
+			let nestedChanged = false;
+			const nestedMessages = mapped.messages.map((nested) => {
+				if (nested.role !== "assistant" || !Array.isArray(nested.content)) return nested;
+				const assistant = nested;
+				const result = mapToolCallPartsDeep(assistant.content, fn);
+				if (!result.changed) return nested;
+				nestedChanged = true;
+				return {
+					...assistant,
+					content: result.content
+				};
+			});
+			if (nestedChanged) mapped = mapped === part ? {
+				...part,
+				messages: nestedMessages
+			} : {
+				...mapped,
+				messages: nestedMessages
+			};
+		}
+		if (mapped !== part) changed = true;
+		return mapped;
+	});
+	return changed ? {
+		content: next,
+		changed
+	} : {
+		content,
+		changed
+	};
+}
+//#endregion
+export { iterateToolCallParts, mapToolCallPartsDeep, walkToolCallTree };
+
+//# sourceMappingURL=tool-call-tree.js.map

package/dist/runtime/utils/tool-call-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-tree.js","names":["ThreadAssistantMessage","ThreadAssistantMessagePart","ThreadMessage","ToolCallMessagePart","ToolCallTreeEntry","part","messageId","walkToolCallTree","messages","Generator","message","role","Array","isArray","content","type","id","length","iterateToolCallParts","entry","mapToolCallPartsDeep","fn","changed","next","map","mapped","undefined","nestedChanged","nestedMessages","nested","assistant","result"],"sources":["../../../src/runtime/utils/tool-call-tree.ts"],"sourcesContent":["import type {\n  ThreadAssistantMessage,\n  ThreadAssistantMessagePart,\n  ThreadMessage,\n  ToolCallMessagePart,\n} from \"../../types/message\";\n\nexport type ToolCallTreeEntry = {\n  readonly part: ToolCallMessagePart;\n  /** Id of the message whose content directly holds `part`. */\n  readonly messageId: string;\n};\n\n/**\n * Walk every tool-call part reachable from `messages`. A tool call projects a\n * child run as nested messages on `ToolCallMessagePart.messages`, so a\n * subagent's own calls live below the top-level content and a seam that only\n * scans the top level cannot reach them.\n *\n * Parts arrive in document order, each one ahead of its own descendants.\n * `messageId` names the message that directly holds the part, which for a\n * nested call is the child run's message rather than the top-level message the\n * tree hangs from. Only assistant messages are descended, the same rule\n * {@link mapToolCallPartsDeep} rewrites under, so a part this reports is always\n * a part that can be written back.\n */\nexport function* walkToolCallTree(\n  messages: readonly ThreadMessage[],\n): Generator<ToolCallTreeEntry> {\n  for (const message of messages) {\n    if (message?.role !== \"assistant\" || !Array.isArray(message.content)) {\n      continue;\n    }\n    for (const part of message.content) {\n      if (!part || part.type !== \"tool-call\") continue;\n      yield { part, messageId: message.id };\n      if (part.messages?.length) yield* walkToolCallTree(part.messages);\n    }\n  }\n}\n\n/**\n * Content-level form of {@link walkToolCallTree}, for a caller that already\n * holds one assistant message's content and does not need the owning id.\n */\nexport function* iterateToolCallParts(\n  content: readonly ThreadAssistantMessagePart[],\n): Generator<ToolCallMessagePart> {\n  for (const part of content) {\n    if (!part || part.type !== \"tool-call\") continue;\n    yield part;\n    if (part.messages?.length) {\n      for (const entry of walkToolCallTree(part.messages)) {\n        yield entry.part;\n      }\n    }\n  }\n}\n\n/**\n * Rebuild `content` with `fn` applied to every tool-call part in the tree.\n * Arrays and nested messages are reused wherever `fn` returned the part it was\n * given, so an unchanged subtree keeps its identity and `changed` reports\n * whether anything moved.\n */\nexport function mapToolCallPartsDeep(\n  content: readonly ThreadAssistantMessagePart[],\n  fn: (part: ToolCallMessagePart) => ToolCallMessagePart,\n): { content: readonly ThreadAssistantMessagePart[]; changed: boolean } {\n  let changed = false;\n  const next = content.map((part): ThreadAssistantMessagePart => {\n    if (part.type !== \"tool-call\") return part;\n    let mapped = fn(part);\n    if (mapped.messages !== undefined) {\n      let nestedChanged = false;\n      const nestedMessages = mapped.messages.map((nested) => {\n        if (nested.role !== \"assistant\" || !Array.isArray(nested.content)) {\n          return nested;\n        }\n        const assistant = nested as ThreadAssistantMessage;\n        const result = mapToolCallPartsDeep(assistant.content, fn);\n        if (!result.changed) return nested;\n        nestedChanged = true;\n        return { ...assistant, content: result.content };\n      });\n      if (nestedChanged) {\n        mapped =\n          mapped === part\n            ? { ...part, messages: nestedMessages }\n            : { ...mapped, messages: nestedMessages };\n      }\n    }\n    if (mapped !== part) changed = true;\n    return mapped;\n  });\n  return changed ? { content: next, changed } : { content, changed };\n}\n"],"mappings":";;;;;;;;;;;;;;AA0BA,UAAiBO,iBACfC,UAC8B;CAC9B,KAAK,MAAME,WAAWF,UAAU;EAC9B,IAAIE,SAASC,SAAS,eAAe,CAACC,MAAMC,QAAQH,QAAQI,OAAO,GACjE;EAEF,KAAK,MAAMT,QAAQK,QAAQI,SAAS;GAClC,IAAI,CAACT,QAAQA,KAAKU,SAAS,aAAa;GACxC,MAAM;IAAEV;IAAMC,WAAWI,QAAQM;GAAG;GACpC,IAAIX,KAAKG,UAAUS,QAAQ,OAAOV,iBAAiBF,KAAKG,QAAQ;EAClE;CACF;AACF;;;;;AAMA,UAAiBU,qBACfJ,SACgC;CAChC,KAAK,MAAMT,QAAQS,SAAS;EAC1B,IAAI,CAACT,QAAQA,KAAKU,SAAS,aAAa;EACxC,MAAMV;EACN,IAAIA,KAAKG,UAAUS,QACjB,KAAK,MAAME,SAASZ,iBAAiBF,KAAKG,QAAQ,GAChD,MAAMW,MAAMd;CAGlB;AACF;;;;;;;AAQA,SAAgBe,qBACdN,SACAO,IACsE;CACtE,IAAIC,UAAU;CACd,MAAMC,OAAOT,QAAQU,KAAKnB,SAAqC;EAC7D,IAAIA,KAAKU,SAAS,aAAa,OAAOV;EACtC,IAAIoB,SAASJ,GAAGhB,IAAI;EACpB,IAAIoB,OAAOjB,aAAakB,KAAAA,GAAW;GACjC,IAAIC,gBAAgB;GACpB,MAAMC,iBAAiBH,OAAOjB,SAASgB,KAAKK,WAAW;IACrD,IAAIA,OAAOlB,SAAS,eAAe,CAACC,MAAMC,QAAQgB,OAAOf,OAAO,GAC9D,OAAOe;IAET,MAAMC,YAAYD;IAClB,MAAME,SAASX,qBAAqBU,UAAUhB,SAASO,EAAE;IACzD,IAAI,CAACU,OAAOT,SAAS,OAAOO;IAC5BF,gBAAgB;IAChB,OAAO;KAAE,GAAGG;KAAWhB,SAASiB,OAAOjB;IAAQ;GACjD,CAAC;GACD,IAAIa,eACFF,SACEA,WAAWpB,OACP;IAAE,GAAGA;IAAMG,UAAUoB;GAAe,IACpC;IAAE,GAAGH;IAAQjB,UAAUoB;GAAe;EAEhD;EACA,IAAIH,WAAWpB,MAAMiB,UAAU;EAC/B,OAAOG;CACT,CAAC;CACD,OAAOH,UAAU;EAAER,SAASS;EAAMD;CAAQ,IAAI;EAAER;EAASQ;CAAQ;AACnE"}

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

@@ -1,10 +1,10 @@
-import { AppendMessage, ThreadMessage } from "../../types/message.js";
+import { AppendMessage, ThreadMessage, ToolCallMessagePart } from "../../types/message.js";
 import { AttachmentAdapter } from "../../adapters/attachment.js";
 import { FeedbackAdapter } from "../../adapters/feedback.js";
 import { DictationAdapter, SpeechSynthesisAdapter } from "../../adapters/speech.js";
 import { RealtimeVoiceAdapter } from "../../adapters/voice.js";
 import { ThreadMessageLike } from "../../runtime/utils/thread-message-like.js";
-import { ExportedMessageRepository } from "../../runtime/utils/message-repository.js";
+import { ExportedMessageRepository, MessageRepository } from "../../runtime/utils/message-repository.js";
 import { ExternalThreadQueueAdapter } from "../../runtime/queue/external-thread-queue-adapter.js";
 import { AddToolResultOptions, RespondToToolApprovalOptions, ResumeRunConfig, StartRunConfig, ThreadSuggestion } from "../../runtime/interfaces/thread-runtime-core.js";
 import { ToolExecutionStatus } from "../tool-invocations/ToolInvocationTracker.js";
@@ -80,6 +80,15 @@ type ExternalStoreAdapterBase<T> = {
   isLoading?: boolean | undefined;
   messages?: readonly T[];
   messageRepository?: ExportedMessageRepository;
+  /**
+   * An externally owned message repository instance. When provided, the
+   * thread runtime adopts it as its branch store and swaps to it atomically
+   * whenever a different instance is passed, so hosts that route multiple
+   * conversations through one runtime keep each conversation's history and
+   * branches isolated in its own instance. Omit it to keep the runtime's own
+   * repository.
+   */
+  unstable_messageRepositoryInstance?: MessageRepository | undefined;
   suggestions?: readonly ThreadSuggestion[] | undefined;
   state?: ReadonlyJSONValue | undefined;
   extras?: unknown;
@@ -170,6 +179,24 @@ type ExternalStoreAdapterBase<T> = {
    * `modelContent` populated when present.
    */
   unstable_enableToolInvocations?: boolean | undefined;
+  /**
+   * Decides whether a tool call's result is produced on the client. Only
+   * consulted when `unstable_enableToolInvocations` is `true`.
+   *
+   * A provider that runs tools itself answers its own calls, and its result
+   * arrives one or more snapshots after the call's arguments complete. In
+   * that window the call is complete and result-less, so a registered tool
+   * of the same name would otherwise execute locally and produce a result
+   * the provider never asked for. An adapter that can tell the two apart
+   * supplies this predicate; it is read once per tool call, when the call is
+   * first observed live.
+   *
+   * The predicate is also what licenses running a frontend tool while the
+   * provider's run is still open. Without it, ownership is unknown until the
+   * run ends, so a registered tool executes only once the run's outcome is
+   * known and cannot fire on a call the provider was about to answer or gate.
+   */
+  unstable_isClientToolCall?: ((toolCall: ToolCallMessagePart) => boolean) | undefined;
   /**
    * Receives the current per-tool-call execution status map whenever it
    * changes. Only invoked when `unstable_enableToolInvocations` is `true`

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":";;;;;;;;;;;;KAqBY,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;EACpB,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;;;;;;;;;;EAUA,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":";;;;;;;;;;;;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"}

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

@@ -38,6 +38,7 @@ declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore imple
   extras: unknown;
   private _converter;
   private _pendingDeleteEvictions;
+  private _optimistic;
   private _store;
   private _getInitializePromise?;
   __internal_setGetInitializePromise(getPromise: () => Promise<unknown> | undefined): void;
@@ -117,7 +118,7 @@ declare class ExternalStoreThreadRuntimeCore extends BaseThreadRuntimeCore imple
   private dropEmptyOptimisticHead;
   addToolResult(options: AddToolResultOptions): void;
   resumeToolCall(options: ResumeToolCallOptions): void;
-  respondToToolApproval(options: RespondToToolApprovalOptions): void;
+  respondToToolApproval(options: RespondToToolApprovalOptions): Promise<void>;
   reset(initialMessages?: readonly ThreadMessageLike[]): void;
   import(data: ExportedMessageRepository): void;
   private updateMessages;

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":";;;;;;;;;;;;;;;;cA+Ea,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;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;;;;;;;UAgOA;;;;;UAmFA;UACA;;;;;;;UAQA;EAmBQ,eAAe;;;;;;;;;UA8BvB;EAaK,OAAO,YAAY,gBAAgB;EAqEnC,cAAc,oBAAoB;UA0CvC;EAkBD,0BA5DwC;EAkExC,+BANa;EAUb,cAAc,qBAAqB,WAAW;EAI9C,gBAAgB;EAIV,SAAS,QAAQ,iBAAiB;EAclC,UAAU,QAAQ,kBAAkB;EAO1C;EAOA,oBAAoB;;;;;;EAqBpB;EAKA;UAmFC;EAOD,cAAc,SAAS;EASvB,eAAe,SAAS;EAoBxB,sBAAsB,SAAS;EAStB,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":";;;;;;;;;;;;;;;;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;EAqEnC,cAAc,oBAAoB;UA0CvC;EAkBD,0BA5DwC;EAkExC,+BANa;EAUb,cAAc,qBAAqB,WAAW;EAI9C,gBAAgB;EAIV,SAAS,QAAQ,iBAAiB;EAclC,UAAU,QAAQ,kBAAkB;EAO1C;EAOA,oBAAoB;;;;;;EAqBpB;EAKA;UAmFC;EAOD,cAAc,SAAS;EASvB,eAAe,SAAS;EAoBxB,sBACL,SAAS,+BACR;EAUa,MAAM,2BAA2B;EAMjC,OAAO,MAAM;UAQrB"}