@assistant-ui/core 0.2.7 → 0.2.8

package/dist/adapters/attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.d.ts","names":[],"sources":["../../src/adapters/attachment.ts"],"mappings":";;;;KAQY,iBAAA;EACV,MAAA;EACA,GAAA,CAAI,KAAA;IACF,IAAA,EAAM,IAAA;EAAA,IACJ,OAAA,CAAQ,iBAAA,IAAqB,cAAA,CAAe,iBAAA;EAChD,MAAA,CAAO,UAAA,EAAY,UAAA,GAAa,OAAA;EAChC,IAAA,CAAK,UAAA,EAAY,iBAAA,GAAoB,OAAA,CAAQ,kBAAA;AAAA;AAAA,cAGlC,4BAAA,YAAwC,iBAAA;EAC5C,MAAA;EAEM,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAS,OAAA,CAAQ,iBAAA;EAWpC,IAAA,CACX,UAAA,EAAY,iBAAA,GACX,OAAA,CAAQ,kBAAA;EAaE,MAAA,CAAA,GAAM,OAAA;AAAA;AAAA,cAaR,2BAAA,YAAuC,iBAAA;EAC3C,MAAA;EAGM,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAS,OAAA,CAAQ,iBAAA;EAWpC,IAAA,CACX,UAAA,EAAY,iBAAA,GACX,OAAA,CAAQ,kBAAA;EAaE,MAAA,CAAA,GAAM,OAAA;AAAA;AAAA,iBAaL,iBAAA,CACd,IAAA;EAAQ,IAAA;EAAc,IAAA;AAAA,GACtB,YAAA;AAAA,iBAiCc,gBAAA,CACd,CAAA,WAAY,kBAAA,IACZ,CAAA,WAAY,kBAAkB;AAAA,iBAMhB,wBAAA,CACd,IAAA,EAAM,OAAA,CAAQ,qBAAA;EAAyB,IAAA;AAAA,KACtC,kBAAA;AAAA,iBA4Ca,gBAAA,CACd,OAAA,WAAkB,qBAAA,KACjB,kBAAkB;AAAA,cAUR,0BAAA,YAAsC,iBAAA;EAAA,QACzC,SAAA;EAED,MAAA;cAEK,QAAA,EAAU,iBAAA;EAgBf,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAM,OAAA,CAAA,iBAAA,IAAA,cAAA,CAAA,iBAAA;EASnB,IAAA,CAAK,UAAA,EAAY,iBAAA,GAAiB,OAAA,CAAA,kBAAA;EAUlC,MAAA,CAAO,UAAA,EAAY,UAAA,GAAU,OAAA;AAAA"}
+{"version":3,"file":"attachment.d.ts","names":[],"sources":["../../src/adapters/attachment.ts"],"mappings":";;;;KAQY,iBAAA;EACV,MAAA;EACA,GAAA,CAAI,KAAA;IACF,IAAA,EAAM,IAAA;EAAA,IACJ,OAAA,CAAQ,iBAAA,IAAqB,cAAA,CAAe,iBAAA;EAChD,MAAA,CAAO,UAAA,EAAY,UAAA,GAAa,OAAA;EAChC,IAAA,CAAK,UAAA,EAAY,iBAAA,GAAoB,OAAA,CAAQ,kBAAA;AAAA;AAAA,cAGlC,4BAAA,YAAwC,iBAAA;EAC5C,MAAA;EAEM,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAS,OAAA,CAAQ,iBAAA;EAWpC,IAAA,CACX,UAAA,EAAY,iBAAA,GACX,OAAA,CAAQ,kBAAA;EAaE,MAAA,IAAM,OAAA;AAAA;AAAA,cAaR,2BAAA,YAAuC,iBAAA;EAC3C,MAAA;EAGM,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAS,OAAA,CAAQ,iBAAA;EAWpC,IAAA,CACX,UAAA,EAAY,iBAAA,GACX,OAAA,CAAQ,kBAAA;EAaE,MAAA,IAAM,OAAA;AAAA;AAAA,iBAaL,iBAAA,CACd,IAAA;EAAQ,IAAA;EAAc,IAAA;AAAA,GACtB,YAAA;AAAA,iBAiCc,gBAAA,CACd,CAAA,WAAY,kBAAA,IACZ,CAAA,WAAY,kBAAkB;AAAA,iBAMhB,wBAAA,CACd,IAAA,EAAM,OAAA,CAAQ,qBAAA;EAAyB,IAAA;AAAA,KACtC,kBAAA;AAAA,iBA4Ca,gBAAA,CACd,OAAA,WAAkB,qBAAA,KACjB,kBAAkB;AAAA,cAUR,0BAAA,YAAsC,iBAAA;EAAA,QACzC,SAAA;EAED,MAAA;cAEK,QAAA,EAAU,iBAAA;EAgBf,GAAA,CAAI,KAAA;IAAS,IAAA,EAAM,IAAA;EAAA,IAAM,OAAA,CAAA,iBAAA,IAAA,cAAA,CAAA,iBAAA;EASnB,IAAA,CAAK,UAAA,EAAY,iBAAA,GAAiB,OAAA,CAAA,kBAAA;EAUlC,MAAA,CAAO,UAAA,EAAY,UAAA,GAAU,OAAA;AAAA"}

package/dist/adapters/speech.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speech.d.ts","names":[],"sources":["../../src/adapters/speech.ts"],"mappings":";;;kBAEiB,sBAAA;EAAA,KACH,MAAA;IAEN,IAAA;EAAA;IAGA,IAAA;IACA,MAAA;IACA,KAAA;EAAA;EAAA,KAGM,SAAA;IACV,MAAA,EAAQ,MAAA;IACR,MAAA;IACA,SAAA,GAAY,QAAA,iBAAyB,WAAW;EAAA;AAAA;AAAA,KAIxC,sBAAA;EACV,KAAA,GAAQ,IAAA,aAAiB,sBAAA,CAAuB,SAAS;AAAA;AAAA,kBAG1C,gBAAA;EAAA,KACH,MAAA;IAEN,IAAA;EAAA;IAGA,IAAA;IACA,MAAA;EAAA;EAAA,KAGM,MAAA;IACV,UAAA;IACA,OAAA;EAAA;EAAA,KAGU,OAAA;IACV,MAAA,EAAQ,MAAA;IACR,IAAA,QAAY,OAAA;IACZ,MAAA;IACA,aAAA,GAAgB,QAAA,iBAAyB,WAAA;IACzC,WAAA,GAAc,QAAA,GAAW,MAAA,EAAQ,MAAA,cAAoB,WAAA;IACrD,QAAA,GAAW,QAAA,GAAW,MAAA,EAAQ,MAAA,cAAoB,WAAA;EAAA;AAAA;AAAA,KAI1C,gBAAA;EACV,MAAA,QAAc,gBAAA,CAAiB,OAAO;EACtC,2BAAA;AAAA;AAAA,cAGW,yBAAA,YAAqC,sBAAsB;EACtE,KAAA,CAAM,IAAA,WAAe,sBAAA,CAAuB,SAAA;AAAA;AAAA,UA2EpC,yBAAA,SAAkC,WAAW;EACrD,IAAA;EACA,UAAA;EACA,cAAA;EACA,KAAA;EACA,IAAA;EACA,KAAA;AAAA;AAAA,UAGQ,4BAAA;EAAA,QACA,yBAAyB;AAAA;AAAA,QAG3B,MAAA;EAAA,UACI,MAAA;IACR,iBAAA,GAAoB,4BAAA;IACpB,uBAAA,GAA0B,4BAA4B;EAAA;AAAA;AAAA,cAW7C,yBAAA,YAAqC,gBAAgB;EAAA,QACxD,SAAA;EAAA,QACA,WAAA;EAAA,QACA,eAAA;cAGN,OAAA;IACE,QAAA;IACA,UAAA;IACA,cAAA;EAAA;EAAA,OAYG,WAAA,CAAA;EAIP,MAAA,CAAA,GAAU,gBAAA,CAAiB,OAAA;AAAA"}
+{"version":3,"file":"speech.d.ts","names":[],"sources":["../../src/adapters/speech.ts"],"mappings":";;;kBAEiB,sBAAA;EAAA,KACH,MAAA;IAEN,IAAA;EAAA;IAGA,IAAA;IACA,MAAA;IACA,KAAA;EAAA;EAAA,KAGM,SAAA;IACV,MAAA,EAAQ,MAAA;IACR,MAAA;IACA,SAAA,GAAY,QAAA,iBAAyB,WAAW;EAAA;AAAA;AAAA,KAIxC,sBAAA;EACV,KAAA,GAAQ,IAAA,aAAiB,sBAAA,CAAuB,SAAS;AAAA;AAAA,kBAG1C,gBAAA;EAAA,KACH,MAAA;IAEN,IAAA;EAAA;IAGA,IAAA;IACA,MAAA;EAAA;EAAA,KAGM,MAAA;IACV,UAAA;IACA,OAAA;EAAA;EAAA,KAGU,OAAA;IACV,MAAA,EAAQ,MAAA;IACR,IAAA,QAAY,OAAA;IACZ,MAAA;IACA,aAAA,GAAgB,QAAA,iBAAyB,WAAA;IACzC,WAAA,GAAc,QAAA,GAAW,MAAA,EAAQ,MAAA,cAAoB,WAAA;IACrD,QAAA,GAAW,QAAA,GAAW,MAAA,EAAQ,MAAA,cAAoB,WAAA;EAAA;AAAA;AAAA,KAI1C,gBAAA;EACV,MAAA,QAAc,gBAAA,CAAiB,OAAO;EACtC,2BAAA;AAAA;AAAA,cAGW,yBAAA,YAAqC,sBAAsB;EACtE,KAAA,CAAM,IAAA,WAAe,sBAAA,CAAuB,SAAA;AAAA;AAAA,UA0EpC,yBAAA,SAAkC,WAAW;EACrD,IAAA;EACA,UAAA;EACA,cAAA;EACA,KAAA;EACA,IAAA;EACA,KAAA;AAAA;AAAA,UAGQ,4BAAA;EAAA,QACA,yBAAyB;AAAA;AAAA,QAG3B,MAAA;EAAA,UACI,MAAA;IACR,iBAAA,GAAoB,4BAAA;IACpB,uBAAA,GAA0B,4BAA4B;EAAA;AAAA;AAAA,cAW7C,yBAAA,YAAqC,gBAAgB;EAAA,QACxD,SAAA;EAAA,QACA,WAAA;EAAA,QACA,eAAA;cAGN,OAAA;IACE,QAAA;IACA,UAAA;IACA,cAAA;EAAA;EAAA,OAYG,WAAA;EAIP,MAAA,IAAU,gBAAA,CAAiB,OAAA;AAAA"}

package/dist/adapters/speech.js.map

@@ -1 +1 @@
-{"version":3,"file":"speech.js","names":[],"sources":["../../src/adapters/speech.ts"],"sourcesContent":["import type { Unsubscribe } from \"../types/unsubscribe\";\n\nexport namespace SpeechSynthesisAdapter {\n  export type Status =\n    | {\n        type: \"starting\" | \"running\";\n      }\n    | {\n        type: \"ended\";\n        reason: \"finished\" | \"cancelled\" | \"error\";\n        error?: unknown;\n      };\n\n  export type Utterance = {\n    status: Status;\n    cancel: () => void;\n    subscribe: (callback: () => void) => Unsubscribe;\n  };\n}\n\nexport type SpeechSynthesisAdapter = {\n  speak: (text: string) => SpeechSynthesisAdapter.Utterance;\n};\n\nexport namespace DictationAdapter {\n  export type Status =\n    | {\n        type: \"starting\" | \"running\";\n      }\n    | {\n        type: \"ended\";\n        reason: \"stopped\" | \"cancelled\" | \"error\";\n      };\n\n  export type Result = {\n    transcript: string;\n    isFinal?: boolean;\n  };\n\n  export type Session = {\n    status: Status;\n    stop: () => Promise<void>;\n    cancel: () => void;\n    onSpeechStart: (callback: () => void) => Unsubscribe;\n    onSpeechEnd: (callback: (result: Result) => void) => Unsubscribe;\n    onSpeech: (callback: (result: Result) => void) => Unsubscribe;\n  };\n}\n\nexport type DictationAdapter = {\n  listen: () => DictationAdapter.Session;\n  disableInputDuringDictation?: boolean;\n};\n\nexport class WebSpeechSynthesisAdapter implements SpeechSynthesisAdapter {\n  speak(text: string): SpeechSynthesisAdapter.Utterance {\n    const utterance = new SpeechSynthesisUtterance(text);\n\n    const subscribers = new Set<() => void>();\n    const handleEnd = (\n      reason: \"finished\" | \"error\" | \"cancelled\",\n      error?: unknown,\n    ) => {\n      if (res.status.type === \"ended\") return;\n\n      res.status = { type: \"ended\", reason, error };\n      // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach callback intentionally has no return\n      subscribers.forEach((handler) => handler());\n    };\n\n    utterance.addEventListener(\"end\", () => handleEnd(\"finished\"));\n    utterance.addEventListener(\"error\", (e) => handleEnd(\"error\", e.error));\n\n    window.speechSynthesis.speak(utterance);\n\n    const res: SpeechSynthesisAdapter.Utterance = {\n      status: { type: \"running\" },\n      cancel: () => {\n        window.speechSynthesis.cancel();\n        handleEnd(\"cancelled\");\n      },\n      subscribe: (callback) => {\n        if (res.status.type === \"ended\") {\n          let cancelled = false;\n          queueMicrotask(() => {\n            if (!cancelled) callback();\n          });\n          return () => {\n            cancelled = true;\n          };\n        } else {\n          subscribers.add(callback);\n          return () => {\n            subscribers.delete(callback);\n          };\n        }\n      },\n    };\n    return res;\n  }\n}\n\ninterface SpeechRecognitionResultItem {\n  transcript: string;\n  confidence: number;\n}\n\ninterface SpeechRecognitionResult {\n  readonly length: number;\n  item(index: number): SpeechRecognitionResultItem;\n  readonly isFinal: boolean;\n  [index: number]: SpeechRecognitionResultItem;\n}\n\ninterface SpeechRecognitionResultList {\n  readonly length: number;\n  item(index: number): SpeechRecognitionResult;\n  [index: number]: SpeechRecognitionResult;\n}\n\ninterface SpeechRecognitionEvent extends Event {\n  readonly resultIndex: number;\n  readonly results: SpeechRecognitionResultList;\n}\n\ninterface SpeechRecognitionErrorEvent extends Event {\n  readonly error: string;\n  readonly message: string;\n}\n\ninterface SpeechRecognitionInstance extends EventTarget {\n  lang: string;\n  continuous: boolean;\n  interimResults: boolean;\n  start(): void;\n  stop(): void;\n  abort(): void;\n}\n\ninterface SpeechRecognitionConstructor {\n  new (): SpeechRecognitionInstance;\n}\n\ndeclare global {\n  interface Window {\n    SpeechRecognition?: SpeechRecognitionConstructor;\n    webkitSpeechRecognition?: SpeechRecognitionConstructor;\n  }\n}\n\nconst getSpeechRecognitionAPI = ():\n  | SpeechRecognitionConstructor\n  | undefined => {\n  if (typeof window === \"undefined\") return undefined;\n  return window.SpeechRecognition ?? window.webkitSpeechRecognition;\n};\n\nexport class WebSpeechDictationAdapter implements DictationAdapter {\n  private _language: string;\n  private _continuous: boolean;\n  private _interimResults: boolean;\n\n  constructor(\n    options: {\n      language?: string;\n      continuous?: boolean;\n      interimResults?: boolean;\n    } = {},\n  ) {\n    const defaultLanguage =\n      typeof navigator !== \"undefined\" && navigator.language\n        ? navigator.language\n        : \"en-US\";\n    this._language = options.language ?? defaultLanguage;\n    this._continuous = options.continuous ?? true;\n    this._interimResults = options.interimResults ?? true;\n  }\n\n  static isSupported(): boolean {\n    return getSpeechRecognitionAPI() !== undefined;\n  }\n\n  listen(): DictationAdapter.Session {\n    const SpeechRecognitionAPI = getSpeechRecognitionAPI();\n    if (!SpeechRecognitionAPI) {\n      throw new Error(\n        \"SpeechRecognition is not supported in this browser. \" +\n          \"Try using Chrome, Edge, or Safari.\",\n      );\n    }\n\n    const recognition = new SpeechRecognitionAPI();\n    recognition.lang = this._language;\n    recognition.continuous = this._continuous;\n    recognition.interimResults = this._interimResults;\n\n    const speechStartCallbacks = new Set<() => void>();\n    const speechEndCallbacks = new Set<\n      (result: DictationAdapter.Result) => void\n    >();\n    const speechCallbacks = new Set<\n      (result: DictationAdapter.Result) => void\n    >();\n\n    let finalTranscript = \"\";\n\n    const session: DictationAdapter.Session = {\n      status: { type: \"starting\" },\n\n      stop: async () => {\n        recognition.stop();\n        return new Promise<void>((resolve) => {\n          const checkEnded = () => {\n            if (session.status.type === \"ended\") {\n              resolve();\n            } else {\n              setTimeout(checkEnded, 50);\n            }\n          };\n          checkEnded();\n        });\n      },\n\n      cancel: () => {\n        recognition.abort();\n      },\n\n      onSpeechStart: (callback: () => void): Unsubscribe => {\n        speechStartCallbacks.add(callback);\n        return () => {\n          speechStartCallbacks.delete(callback);\n        };\n      },\n\n      onSpeechEnd: (\n        callback: (result: DictationAdapter.Result) => void,\n      ): Unsubscribe => {\n        speechEndCallbacks.add(callback);\n        return () => {\n          speechEndCallbacks.delete(callback);\n        };\n      },\n\n      onSpeech: (\n        callback: (result: DictationAdapter.Result) => void,\n      ): Unsubscribe => {\n        speechCallbacks.add(callback);\n        return () => {\n          speechCallbacks.delete(callback);\n        };\n      },\n    };\n\n    const updateStatus = (newStatus: DictationAdapter.Status) => {\n      session.status = newStatus;\n    };\n\n    recognition.addEventListener(\"speechstart\", () => {\n      for (const cb of speechStartCallbacks) cb();\n    });\n\n    recognition.addEventListener(\"start\", () => {\n      updateStatus({ type: \"running\" });\n    });\n\n    recognition.addEventListener(\"result\", (event) => {\n      const speechEvent = event as unknown as SpeechRecognitionEvent;\n\n      for (\n        let i = speechEvent.resultIndex;\n        i < speechEvent.results.length;\n        i++\n      ) {\n        const result = speechEvent.results[i];\n        if (!result) continue;\n\n        const transcript = result[0]?.transcript ?? \"\";\n\n        if (result.isFinal) {\n          finalTranscript += transcript;\n          for (const cb of speechCallbacks) cb({ transcript, isFinal: true });\n        } else {\n          for (const cb of speechCallbacks) cb({ transcript, isFinal: false });\n        }\n      }\n    });\n\n    recognition.addEventListener(\"speechend\", () => {\n      // speechend fires when user stops speaking, but 'end' handles final cleanup\n    });\n\n    recognition.addEventListener(\"end\", () => {\n      const currentStatus = session.status;\n      if (currentStatus.type !== \"ended\") {\n        updateStatus({ type: \"ended\", reason: \"stopped\" });\n      }\n      if (finalTranscript) {\n        for (const cb of speechEndCallbacks)\n          cb({ transcript: finalTranscript });\n        finalTranscript = \"\";\n      }\n    });\n\n    recognition.addEventListener(\"error\", (event) => {\n      const errorEvent = event as unknown as SpeechRecognitionErrorEvent;\n      if (errorEvent.error === \"aborted\") {\n        updateStatus({ type: \"ended\", reason: \"cancelled\" });\n      } else {\n        updateStatus({ type: \"ended\", reason: \"error\" });\n        console.error(\"Dictation error:\", errorEvent.error, errorEvent.message);\n      }\n    });\n\n    try {\n      recognition.start();\n    } catch (error) {\n      updateStatus({ type: \"ended\", reason: \"error\" });\n      throw error;\n    }\n\n    return session;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"speech.js","names":[],"sources":["../../src/adapters/speech.ts"],"sourcesContent":["import type { Unsubscribe } from \"../types/unsubscribe\";\n\nexport namespace SpeechSynthesisAdapter {\n  export type Status =\n    | {\n        type: \"starting\" | \"running\";\n      }\n    | {\n        type: \"ended\";\n        reason: \"finished\" | \"cancelled\" | \"error\";\n        error?: unknown;\n      };\n\n  export type Utterance = {\n    status: Status;\n    cancel: () => void;\n    subscribe: (callback: () => void) => Unsubscribe;\n  };\n}\n\nexport type SpeechSynthesisAdapter = {\n  speak: (text: string) => SpeechSynthesisAdapter.Utterance;\n};\n\nexport namespace DictationAdapter {\n  export type Status =\n    | {\n        type: \"starting\" | \"running\";\n      }\n    | {\n        type: \"ended\";\n        reason: \"stopped\" | \"cancelled\" | \"error\";\n      };\n\n  export type Result = {\n    transcript: string;\n    isFinal?: boolean;\n  };\n\n  export type Session = {\n    status: Status;\n    stop: () => Promise<void>;\n    cancel: () => void;\n    onSpeechStart: (callback: () => void) => Unsubscribe;\n    onSpeechEnd: (callback: (result: Result) => void) => Unsubscribe;\n    onSpeech: (callback: (result: Result) => void) => Unsubscribe;\n  };\n}\n\nexport type DictationAdapter = {\n  listen: () => DictationAdapter.Session;\n  disableInputDuringDictation?: boolean;\n};\n\nexport class WebSpeechSynthesisAdapter implements SpeechSynthesisAdapter {\n  speak(text: string): SpeechSynthesisAdapter.Utterance {\n    const utterance = new SpeechSynthesisUtterance(text);\n\n    const subscribers = new Set<() => void>();\n    const handleEnd = (\n      reason: \"finished\" | \"error\" | \"cancelled\",\n      error?: unknown,\n    ) => {\n      if (res.status.type === \"ended\") return;\n\n      res.status = { type: \"ended\", reason, error };\n      subscribers.forEach((handler) => handler());\n    };\n\n    utterance.addEventListener(\"end\", () => handleEnd(\"finished\"));\n    utterance.addEventListener(\"error\", (e) => handleEnd(\"error\", e.error));\n\n    window.speechSynthesis.speak(utterance);\n\n    const res: SpeechSynthesisAdapter.Utterance = {\n      status: { type: \"running\" },\n      cancel: () => {\n        window.speechSynthesis.cancel();\n        handleEnd(\"cancelled\");\n      },\n      subscribe: (callback) => {\n        if (res.status.type === \"ended\") {\n          let cancelled = false;\n          queueMicrotask(() => {\n            if (!cancelled) callback();\n          });\n          return () => {\n            cancelled = true;\n          };\n        } else {\n          subscribers.add(callback);\n          return () => {\n            subscribers.delete(callback);\n          };\n        }\n      },\n    };\n    return res;\n  }\n}\n\ninterface SpeechRecognitionResultItem {\n  transcript: string;\n  confidence: number;\n}\n\ninterface SpeechRecognitionResult {\n  readonly length: number;\n  item(index: number): SpeechRecognitionResultItem;\n  readonly isFinal: boolean;\n  [index: number]: SpeechRecognitionResultItem;\n}\n\ninterface SpeechRecognitionResultList {\n  readonly length: number;\n  item(index: number): SpeechRecognitionResult;\n  [index: number]: SpeechRecognitionResult;\n}\n\ninterface SpeechRecognitionEvent extends Event {\n  readonly resultIndex: number;\n  readonly results: SpeechRecognitionResultList;\n}\n\ninterface SpeechRecognitionErrorEvent extends Event {\n  readonly error: string;\n  readonly message: string;\n}\n\ninterface SpeechRecognitionInstance extends EventTarget {\n  lang: string;\n  continuous: boolean;\n  interimResults: boolean;\n  start(): void;\n  stop(): void;\n  abort(): void;\n}\n\ninterface SpeechRecognitionConstructor {\n  new (): SpeechRecognitionInstance;\n}\n\ndeclare global {\n  interface Window {\n    SpeechRecognition?: SpeechRecognitionConstructor;\n    webkitSpeechRecognition?: SpeechRecognitionConstructor;\n  }\n}\n\nconst getSpeechRecognitionAPI = ():\n  | SpeechRecognitionConstructor\n  | undefined => {\n  if (typeof window === \"undefined\") return undefined;\n  return window.SpeechRecognition ?? window.webkitSpeechRecognition;\n};\n\nexport class WebSpeechDictationAdapter implements DictationAdapter {\n  private _language: string;\n  private _continuous: boolean;\n  private _interimResults: boolean;\n\n  constructor(\n    options: {\n      language?: string;\n      continuous?: boolean;\n      interimResults?: boolean;\n    } = {},\n  ) {\n    const defaultLanguage =\n      typeof navigator !== \"undefined\" && navigator.language\n        ? navigator.language\n        : \"en-US\";\n    this._language = options.language ?? defaultLanguage;\n    this._continuous = options.continuous ?? true;\n    this._interimResults = options.interimResults ?? true;\n  }\n\n  static isSupported(): boolean {\n    return getSpeechRecognitionAPI() !== undefined;\n  }\n\n  listen(): DictationAdapter.Session {\n    const SpeechRecognitionAPI = getSpeechRecognitionAPI();\n    if (!SpeechRecognitionAPI) {\n      throw new Error(\n        \"SpeechRecognition is not supported in this browser. \" +\n          \"Try using Chrome, Edge, or Safari.\",\n      );\n    }\n\n    const recognition = new SpeechRecognitionAPI();\n    recognition.lang = this._language;\n    recognition.continuous = this._continuous;\n    recognition.interimResults = this._interimResults;\n\n    const speechStartCallbacks = new Set<() => void>();\n    const speechEndCallbacks = new Set<\n      (result: DictationAdapter.Result) => void\n    >();\n    const speechCallbacks = new Set<\n      (result: DictationAdapter.Result) => void\n    >();\n\n    let finalTranscript = \"\";\n\n    const session: DictationAdapter.Session = {\n      status: { type: \"starting\" },\n\n      stop: async () => {\n        recognition.stop();\n        return new Promise<void>((resolve) => {\n          const checkEnded = () => {\n            if (session.status.type === \"ended\") {\n              resolve();\n            } else {\n              setTimeout(checkEnded, 50);\n            }\n          };\n          checkEnded();\n        });\n      },\n\n      cancel: () => {\n        recognition.abort();\n      },\n\n      onSpeechStart: (callback: () => void): Unsubscribe => {\n        speechStartCallbacks.add(callback);\n        return () => {\n          speechStartCallbacks.delete(callback);\n        };\n      },\n\n      onSpeechEnd: (\n        callback: (result: DictationAdapter.Result) => void,\n      ): Unsubscribe => {\n        speechEndCallbacks.add(callback);\n        return () => {\n          speechEndCallbacks.delete(callback);\n        };\n      },\n\n      onSpeech: (\n        callback: (result: DictationAdapter.Result) => void,\n      ): Unsubscribe => {\n        speechCallbacks.add(callback);\n        return () => {\n          speechCallbacks.delete(callback);\n        };\n      },\n    };\n\n    const updateStatus = (newStatus: DictationAdapter.Status) => {\n      session.status = newStatus;\n    };\n\n    recognition.addEventListener(\"speechstart\", () => {\n      for (const cb of speechStartCallbacks) cb();\n    });\n\n    recognition.addEventListener(\"start\", () => {\n      updateStatus({ type: \"running\" });\n    });\n\n    recognition.addEventListener(\"result\", (event) => {\n      const speechEvent = event as unknown as SpeechRecognitionEvent;\n\n      for (\n        let i = speechEvent.resultIndex;\n        i < speechEvent.results.length;\n        i++\n      ) {\n        const result = speechEvent.results[i];\n        if (!result) continue;\n\n        const transcript = result[0]?.transcript ?? \"\";\n\n        if (result.isFinal) {\n          finalTranscript += transcript;\n          for (const cb of speechCallbacks) cb({ transcript, isFinal: true });\n        } else {\n          for (const cb of speechCallbacks) cb({ transcript, isFinal: false });\n        }\n      }\n    });\n\n    recognition.addEventListener(\"speechend\", () => {\n      // speechend fires when user stops speaking, but 'end' handles final cleanup\n    });\n\n    recognition.addEventListener(\"end\", () => {\n      const currentStatus = session.status;\n      if (currentStatus.type !== \"ended\") {\n        updateStatus({ type: \"ended\", reason: \"stopped\" });\n      }\n      if (finalTranscript) {\n        for (const cb of speechEndCallbacks)\n          cb({ transcript: finalTranscript });\n        finalTranscript = \"\";\n      }\n    });\n\n    recognition.addEventListener(\"error\", (event) => {\n      const errorEvent = event as unknown as SpeechRecognitionErrorEvent;\n      if (errorEvent.error === \"aborted\") {\n        updateStatus({ type: \"ended\", reason: \"cancelled\" });\n      } else {\n        updateStatus({ type: \"ended\", reason: \"error\" });\n        console.error(\"Dictation error:\", errorEvent.error, errorEvent.message);\n      }\n    });\n\n    try {\n      recognition.start();\n    } catch (error) {\n      updateStatus({ type: \"ended\", reason: \"error\" });\n      throw error;\n    }\n\n    return session;\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -42,6 +42,7 @@ import { ExternalStoreAdapter, ExternalStoreMessageConverter, ExternalStoreThrea
 import { RemoteThreadInitializeResponse, RemoteThreadListAdapter, RemoteThreadListOptions, RemoteThreadListPageOptions, RemoteThreadListResponse, RemoteThreadMetadata } from "./runtimes/remote-thread-list/types.js";
 import { CreateAppendMessage, CreateResumeRunConfig, CreateStartRunConfig, ThreadRuntime, ThreadState } from "./runtime/api/thread-runtime.js";
 import { AssistantRuntime } from "./runtime/api/assistant-runtime.js";
+import { ExternalStoreSharedOptions, pickExternalStoreSharedOptions } from "./runtimes/external-store/external-store-shared-options.js";
 import { InMemoryThreadListAdapter } from "./runtimes/remote-thread-list/adapter/in-memory.js";
 import { createRequestHeaders } from "./runtimes/assistant-transport/utils.js";
-export { type AddToolResultOptions, type AppendMessage, type AssistantContextConfig, AssistantFrameHost, AssistantFrameProvider, type AssistantInstructionsConfig, type AssistantRuntime, type AssistantRuntimeCore, type AssistantToolProps, type Attachment, type AttachmentAdapter, type AttachmentAddErrorEvent, type AttachmentAddErrorReason, type AttachmentRuntime, type AttachmentRuntimePath, type AttachmentState, type AttachmentStatus, type ChatModelAdapter, type ChatModelRunOptions, type ChatModelRunResult, type ChatModelRunUpdate, type CompleteAttachment, type CompleteAttachmentStatus, type ComposerRuntime, type ComposerRuntimeCore, type ComposerRuntimeEventCallback, type ComposerRuntimeEventPayload, type ComposerRuntimeEventType, type ComposerRuntimePath, type ComposerState, CompositeAttachmentAdapter, type CoreChatModelRunResult, type CreateAppendMessage, type CreateAttachment, type CreateResumeRunConfig, type CreateStartRunConfig, type DataMessagePart, type DictationAdapter, type DictationState, type EditComposerRuntime, type EditComposerRuntimeCore, type EditComposerState, ExportedMessageRepository, type ExportedMessageRepositoryItem, type ExternalStoreAdapter, type ExternalStoreMessageConverter, type ExternalStoreThreadData, type ExternalStoreThreadListAdapter, FRAME_MESSAGE_CHANNEL, type FeedbackAdapter, type FileMessagePart, type FrameMessage, type FrameMessageType, type GenerativeUIMessagePart, type GenerativeUINode, type GenerativeUISpec, type GenericThreadHistoryAdapter, type ImageMessagePart, InMemoryThreadListAdapter, type LanguageModelConfig, type LanguageModelV1CallSettings, type LocalRuntimeOptionsBase, MCP_APP_URI_SCHEME, type McpAppMetadata, type MessageFormatAdapter, type MessageFormatItem, type MessageFormatRepository, type MessagePartRuntime, type MessagePartRuntimePath, type MessagePartState, type MessagePartStatus, type MessageRole, type MessageRuntime, type MessageRuntimePath, type MessageState, type MessageStatus, type MessageStorageEntry, type MessageTiming, type ModelContext, type ModelContextProvider, ModelContextRegistry, type ModelContextRegistryInstructionHandle, type ModelContextRegistryProviderHandle, type ModelContextRegistryToolHandle, type PendingAttachment, type PendingAttachmentStatus, type QuoteInfo, type RealtimeVoiceAdapter, type ReasoningMessagePart, type RemoteThreadInitializeResponse, type RemoteThreadListAdapter, type RemoteThreadListOptions, type RemoteThreadListPageOptions, type RemoteThreadListResponse, type RemoteThreadMetadata, type RespondToToolApprovalOptions, type ResumeRunConfig, type ResumeToolCallOptions, type RunConfig, type RuntimeCapabilities, type SendOptions, type SerializedModelContext, type SerializedTool, SimpleImageAttachmentAdapter, SimpleTextAttachmentAdapter, type SourceMessagePart, type SourceProviderMetadata, type SpeechState, type SpeechSynthesisAdapter, type StartRunConfig, type SubmitFeedbackOptions, type SubmittedFeedback, type SuggestionAdapter, type TextMessagePart, type ThreadAssistantMessage, type ThreadAssistantMessagePart, type ThreadComposerRuntime, type ThreadComposerRuntimeCore, type ThreadComposerState, type ThreadHistoryAdapter, type ThreadListItemCoreState, type ThreadListItemEventCallback, type ThreadListItemEventPayload, type ThreadListItemEventType, type ThreadListItemRuntime, type ThreadListItemRuntimePath, type ThreadListItemState, type ThreadListItemStatus, type ThreadListRuntime, type ThreadListRuntimeCore, type ThreadListState, type ThreadMessage, type ThreadMessageLike, type ThreadRuntime, type ThreadRuntimeCore, type ThreadRuntimeEventCallback, type ThreadRuntimeEventPayload, type ThreadRuntimeEventType, type ThreadRuntimePath, type ThreadState, type ThreadStep, type ThreadSuggestion, type ThreadSystemMessage, type ThreadUserMessage, type ThreadUserMessagePart, type ToolCallMessagePart, type ToolCallMessagePartMcpMetadata, type ToolCallMessagePartStatus, type ToolExecutionStatus, type ToolModelContentPart, type Unstable_AudioMessagePart, type Unstable_DirectiveFormatter, type Unstable_DirectiveSegment, type Unstable_TriggerAdapter, type Unstable_TriggerCategory, type Unstable_TriggerItem, type Unsubscribe, type VoiceSessionControls, type VoiceSessionHelpers, type VoiceSessionState, WebSpeechDictationAdapter, WebSpeechSynthesisAdapter, bindExternalStoreMessage, createRequestHeaders, createVoiceSession, getExternalStoreMessages, isMcpAppUri, mergeModelContexts, tool, unstable_defaultDirectiveFormatter };
+export { type AddToolResultOptions, type AppendMessage, type AssistantContextConfig, AssistantFrameHost, AssistantFrameProvider, type AssistantInstructionsConfig, type AssistantRuntime, type AssistantRuntimeCore, type AssistantToolProps, type Attachment, type AttachmentAdapter, type AttachmentAddErrorEvent, type AttachmentAddErrorReason, type AttachmentRuntime, type AttachmentRuntimePath, type AttachmentState, type AttachmentStatus, type ChatModelAdapter, type ChatModelRunOptions, type ChatModelRunResult, type ChatModelRunUpdate, type CompleteAttachment, type CompleteAttachmentStatus, type ComposerRuntime, type ComposerRuntimeCore, type ComposerRuntimeEventCallback, type ComposerRuntimeEventPayload, type ComposerRuntimeEventType, type ComposerRuntimePath, type ComposerState, CompositeAttachmentAdapter, type CoreChatModelRunResult, type CreateAppendMessage, type CreateAttachment, type CreateResumeRunConfig, type CreateStartRunConfig, type DataMessagePart, type DictationAdapter, type DictationState, type EditComposerRuntime, type EditComposerRuntimeCore, type EditComposerState, ExportedMessageRepository, type ExportedMessageRepositoryItem, type ExternalStoreAdapter, type ExternalStoreMessageConverter, type ExternalStoreSharedOptions, type ExternalStoreThreadData, type ExternalStoreThreadListAdapter, FRAME_MESSAGE_CHANNEL, type FeedbackAdapter, type FileMessagePart, type FrameMessage, type FrameMessageType, type GenerativeUIMessagePart, type GenerativeUINode, type GenerativeUISpec, type GenericThreadHistoryAdapter, type ImageMessagePart, InMemoryThreadListAdapter, type LanguageModelConfig, type LanguageModelV1CallSettings, type LocalRuntimeOptionsBase, MCP_APP_URI_SCHEME, type McpAppMetadata, type MessageFormatAdapter, type MessageFormatItem, type MessageFormatRepository, type MessagePartRuntime, type MessagePartRuntimePath, type MessagePartState, type MessagePartStatus, type MessageRole, type MessageRuntime, type MessageRuntimePath, type MessageState, type MessageStatus, type MessageStorageEntry, type MessageTiming, type ModelContext, type ModelContextProvider, ModelContextRegistry, type ModelContextRegistryInstructionHandle, type ModelContextRegistryProviderHandle, type ModelContextRegistryToolHandle, type PendingAttachment, type PendingAttachmentStatus, type QuoteInfo, type RealtimeVoiceAdapter, type ReasoningMessagePart, type RemoteThreadInitializeResponse, type RemoteThreadListAdapter, type RemoteThreadListOptions, type RemoteThreadListPageOptions, type RemoteThreadListResponse, type RemoteThreadMetadata, type RespondToToolApprovalOptions, type ResumeRunConfig, type ResumeToolCallOptions, type RunConfig, type RuntimeCapabilities, type SendOptions, type SerializedModelContext, type SerializedTool, SimpleImageAttachmentAdapter, SimpleTextAttachmentAdapter, type SourceMessagePart, type SourceProviderMetadata, type SpeechState, type SpeechSynthesisAdapter, type StartRunConfig, type SubmitFeedbackOptions, type SubmittedFeedback, type SuggestionAdapter, type TextMessagePart, type ThreadAssistantMessage, type ThreadAssistantMessagePart, type ThreadComposerRuntime, type ThreadComposerRuntimeCore, type ThreadComposerState, type ThreadHistoryAdapter, type ThreadListItemCoreState, type ThreadListItemEventCallback, type ThreadListItemEventPayload, type ThreadListItemEventType, type ThreadListItemRuntime, type ThreadListItemRuntimePath, type ThreadListItemState, type ThreadListItemStatus, type ThreadListRuntime, type ThreadListRuntimeCore, type ThreadListState, type ThreadMessage, type ThreadMessageLike, type ThreadRuntime, type ThreadRuntimeCore, type ThreadRuntimeEventCallback, type ThreadRuntimeEventPayload, type ThreadRuntimeEventType, type ThreadRuntimePath, type ThreadState, type ThreadStep, type ThreadSuggestion, type ThreadSystemMessage, type ThreadUserMessage, type ThreadUserMessagePart, type ToolCallMessagePart, type ToolCallMessagePartMcpMetadata, type ToolCallMessagePartStatus, type ToolExecutionStatus, type ToolModelContentPart, type Unstable_AudioMessagePart, type Unstable_DirectiveFormatter, type Unstable_DirectiveSegment, type Unstable_TriggerAdapter, type Unstable_TriggerCategory, type Unstable_TriggerItem, type Unsubscribe, type VoiceSessionControls, type VoiceSessionHelpers, type VoiceSessionState, WebSpeechDictationAdapter, WebSpeechSynthesisAdapter, bindExternalStoreMessage, createRequestHeaders, createVoiceSession, getExternalStoreMessages, isMcpAppUri, mergeModelContexts, pickExternalStoreSharedOptions, tool, unstable_defaultDirectiveFormatter };

package/dist/index.js

@@ -12,11 +12,12 @@ import { createVoiceSession } from "./adapters/voice.js";
 import { unstable_defaultDirectiveFormatter } from "./adapters/directive-formatter.js";
 import { bindExternalStoreMessage, getExternalStoreMessages } from "./runtime/utils/external-store-message.js";
 import { ExportedMessageRepository } from "./runtime/utils/message-repository.js";
+import { pickExternalStoreSharedOptions } from "./runtimes/external-store/external-store-shared-options.js";
 import { InMemoryThreadListAdapter } from "./runtimes/remote-thread-list/adapter/in-memory.js";
 import { createRequestHeaders } from "./runtimes/assistant-transport/utils.js";
 //#region src/index.ts
 if (process.env.NODE_ENV !== "production") checkDuplicateCore();
 //#endregion
-export { AssistantFrameHost, AssistantFrameProvider, CompositeAttachmentAdapter, ExportedMessageRepository, FRAME_MESSAGE_CHANNEL, InMemoryThreadListAdapter, MCP_APP_URI_SCHEME, ModelContextRegistry, SimpleImageAttachmentAdapter, SimpleTextAttachmentAdapter, WebSpeechDictationAdapter, WebSpeechSynthesisAdapter, bindExternalStoreMessage, createRequestHeaders, createVoiceSession, getExternalStoreMessages, isMcpAppUri, mergeModelContexts, tool, unstable_defaultDirectiveFormatter };
+export { AssistantFrameHost, AssistantFrameProvider, CompositeAttachmentAdapter, ExportedMessageRepository, FRAME_MESSAGE_CHANNEL, InMemoryThreadListAdapter, MCP_APP_URI_SCHEME, ModelContextRegistry, SimpleImageAttachmentAdapter, SimpleTextAttachmentAdapter, WebSpeechDictationAdapter, WebSpeechSynthesisAdapter, bindExternalStoreMessage, createRequestHeaders, createVoiceSession, getExternalStoreMessages, isMcpAppUri, mergeModelContexts, pickExternalStoreSharedOptions, tool, unstable_defaultDirectiveFormatter };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// @assistant-ui/core - Framework-agnostic core runtime (public API)\n\n/// <reference path=\"./store/scope-registration.ts\" />\n\nimport { checkDuplicateCore } from \"./internal/duplicate-detection\";\n\nif (process.env.NODE_ENV !== \"production\") {\n  checkDuplicateCore();\n}\n\nexport type {\n  // Message parts\n  TextMessagePart,\n  ReasoningMessagePart,\n  SourceProviderMetadata,\n  SourceMessagePart,\n  ImageMessagePart,\n  FileMessagePart,\n  DataMessagePart,\n  GenerativeUIMessagePart,\n  GenerativeUINode,\n  GenerativeUISpec,\n  Unstable_AudioMessagePart,\n  ToolCallMessagePart,\n  ToolCallMessagePartMcpMetadata,\n  McpAppMetadata,\n  ToolModelContentPart,\n  ThreadUserMessagePart,\n  ThreadAssistantMessagePart,\n  // Message status\n  MessagePartStatus,\n  ToolCallMessagePartStatus,\n  MessageStatus,\n  // Thread messages\n  MessageTiming,\n  ThreadStep,\n  ThreadSystemMessage,\n  ThreadUserMessage,\n  ThreadAssistantMessage,\n  ThreadMessage,\n  MessageRole,\n  // Config\n  RunConfig,\n  AppendMessage,\n} from \"./types/message\";\n\nexport { MCP_APP_URI_SCHEME, isMcpAppUri } from \"./types/message\";\n\nexport type {\n  Attachment,\n  PendingAttachment,\n  PendingAttachmentStatus,\n  CompleteAttachment,\n  CompleteAttachmentStatus,\n  AttachmentStatus,\n  CreateAttachment,\n} from \"./types/attachment\";\n\nexport type { Unsubscribe } from \"./types/unsubscribe\";\n\nexport type { QuoteInfo } from \"./types/quote\";\n\nexport type {\n  Unstable_DirectiveSegment,\n  Unstable_DirectiveFormatter,\n} from \"./types/directive\";\n\nexport type {\n  Unstable_TriggerItem,\n  Unstable_TriggerCategory,\n} from \"./types/trigger\";\n\nexport type { Unstable_TriggerAdapter } from \"./adapters/trigger\";\n\nexport type {\n  // Language model settings\n  LanguageModelV1CallSettings,\n  LanguageModelConfig,\n  // Model context\n  ModelContext,\n  ModelContextProvider,\n  // Tool & instruction config\n  AssistantToolProps,\n  AssistantInstructionsConfig,\n  AssistantContextConfig,\n} from \"./model-context/types\";\nexport { mergeModelContexts } from \"./model-context/types\";\n\nexport { tool } from \"./model-context/tool\";\n\nexport type { ToolExecutionStatus } from \"./runtimes/tool-invocations/ToolInvocationTracker\";\n\nexport { ModelContextRegistry } from \"./model-context/registry\";\nexport type {\n  ModelContextRegistryToolHandle,\n  ModelContextRegistryInstructionHandle,\n  ModelContextRegistryProviderHandle,\n} from \"./model-context/registry-handles\";\n\nexport { AssistantFrameHost } from \"./model-context/frame/host\";\nexport { AssistantFrameProvider } from \"./model-context/frame/provider\";\nexport type {\n  SerializedTool,\n  SerializedModelContext,\n  FrameMessageType,\n  FrameMessage,\n} from \"./model-context/frame/types\";\nexport { FRAME_MESSAGE_CHANNEL } from \"./model-context/frame/types\";\n\n// Attachment adapters\nexport type { AttachmentAdapter } from \"./adapters/attachment\";\nexport {\n  SimpleImageAttachmentAdapter,\n  SimpleTextAttachmentAdapter,\n  CompositeAttachmentAdapter,\n} from \"./adapters/attachment\";\n\n// Speech adapters\nexport type {\n  SpeechSynthesisAdapter,\n  DictationAdapter,\n} from \"./adapters/speech\";\nexport {\n  WebSpeechSynthesisAdapter,\n  WebSpeechDictationAdapter,\n} from \"./adapters/speech\";\n\n// Voice adapter\nexport type { RealtimeVoiceAdapter } from \"./adapters/voice\";\nexport { createVoiceSession } from \"./adapters/voice\";\nexport type {\n  VoiceSessionControls,\n  VoiceSessionHelpers,\n} from \"./adapters/voice\";\n\n// Feedback adapter\nexport type { FeedbackAdapter } from \"./adapters/feedback\";\n\n// Suggestion adapter\nexport type { SuggestionAdapter } from \"./adapters/suggestion\";\n\n// Directive formatter\nexport { unstable_defaultDirectiveFormatter } from \"./adapters/directive-formatter\";\n\n// Thread history adapters\nexport type {\n  ThreadHistoryAdapter,\n  GenericThreadHistoryAdapter,\n  MessageFormatAdapter,\n  MessageFormatItem,\n  MessageFormatRepository,\n  MessageStorageEntry,\n} from \"./adapters/thread-history\";\n\n// Path Types\nexport type {\n  ThreadListItemRuntimePath,\n  ThreadRuntimePath,\n  MessageRuntimePath,\n  MessagePartRuntimePath,\n  AttachmentRuntimePath,\n  ComposerRuntimePath,\n} from \"./runtime/api/paths\";\n\n// Runtime Core Interface Types\nexport type {\n  AttachmentAddErrorEvent,\n  AttachmentAddErrorReason,\n  ComposerRuntimeCore,\n  ComposerRuntimeEventCallback,\n  ComposerRuntimeEventPayload,\n  ComposerRuntimeEventType,\n  DictationState,\n  EditComposerRuntimeCore,\n  SendOptions,\n  ThreadComposerRuntimeCore,\n} from \"./runtime/interfaces/composer-runtime-core\";\n\nexport type {\n  RuntimeCapabilities,\n  AddToolResultOptions,\n  ResumeToolCallOptions,\n  RespondToToolApprovalOptions,\n  SubmitFeedbackOptions,\n  ThreadSuggestion,\n  SpeechState,\n  VoiceSessionState,\n  SubmittedFeedback,\n  ThreadRuntimeEventCallback,\n  ThreadRuntimeEventPayload,\n  ThreadRuntimeEventType,\n  StartRunConfig,\n  ResumeRunConfig,\n  ThreadRuntimeCore,\n} from \"./runtime/interfaces/thread-runtime-core\";\n\nexport type {\n  ThreadListItemStatus,\n  ThreadListItemCoreState,\n  ThreadListRuntimeCore,\n} from \"./runtime/interfaces/thread-list-runtime-core\";\n\nexport type { AssistantRuntimeCore } from \"./runtime/interfaces/assistant-runtime-core\";\n\n// Public Runtime Types\nexport type { AssistantRuntime } from \"./runtime/api/assistant-runtime\";\n\nexport type {\n  CreateStartRunConfig,\n  CreateResumeRunConfig,\n  CreateAppendMessage,\n  ThreadState,\n  ThreadRuntime,\n} from \"./runtime/api/thread-runtime\";\n\nexport type {\n  ThreadListState,\n  ThreadListRuntime,\n} from \"./runtime/api/thread-list-runtime\";\n\nexport type {\n  ThreadListItemEventCallback,\n  ThreadListItemEventPayload,\n  ThreadListItemEventType,\n  ThreadListItemRuntime,\n} from \"./runtime/api/thread-list-item-runtime\";\n\nexport type { ThreadListItemState } from \"./runtime/api/bindings\";\n\nexport type {\n  MessageState,\n  MessageRuntime,\n} from \"./runtime/api/message-runtime\";\nexport type {\n  MessagePartState,\n  MessagePartRuntime,\n} from \"./runtime/api/message-part-runtime\";\n\nexport type {\n  ThreadComposerState,\n  EditComposerState,\n  ComposerState,\n  ComposerRuntime,\n  ThreadComposerRuntime,\n  EditComposerRuntime,\n} from \"./runtime/api/composer-runtime\";\n\nexport type {\n  AttachmentState,\n  AttachmentRuntime,\n} from \"./runtime/api/attachment-runtime\";\n\n// ChatModel Types\nexport type {\n  ChatModelRunUpdate,\n  ChatModelRunResult,\n  CoreChatModelRunResult,\n  ChatModelRunOptions,\n  ChatModelAdapter,\n} from \"./runtime/utils/chat-model-adapter\";\n\n// ThreadMessageLike\nexport type { ThreadMessageLike } from \"./runtime/utils/thread-message-like\";\n\n// External Store Message Utilities\nexport {\n  getExternalStoreMessages,\n  bindExternalStoreMessage,\n} from \"./runtime/utils/external-store-message\";\n\n// ExportedMessageRepository\nexport type { ExportedMessageRepositoryItem } from \"./runtime/utils/message-repository\";\nexport { ExportedMessageRepository } from \"./runtime/utils/message-repository\";\n\n// Local Runtime Options\nexport type { LocalRuntimeOptionsBase } from \"./runtimes/local/local-runtime-options\";\n\n// External Store Adapter Types (user-facing)\nexport type {\n  ExternalStoreAdapter,\n  ExternalStoreMessageConverter,\n  ExternalStoreThreadListAdapter,\n  ExternalStoreThreadData,\n} from \"./runtimes/external-store/external-store-adapter\";\n\n// Remote Thread List (user-facing)\nexport type {\n  RemoteThreadListAdapter,\n  RemoteThreadListOptions,\n  RemoteThreadInitializeResponse,\n  RemoteThreadMetadata,\n  RemoteThreadListResponse,\n  RemoteThreadListPageOptions,\n} from \"./runtimes/remote-thread-list/types\";\n\nexport { InMemoryThreadListAdapter } from \"./runtimes/remote-thread-list/adapter/in-memory\";\n\n// Assistant Transport Utilities\nexport { createRequestHeaders } from \"./runtimes/assistant-transport/utils\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAMA,IAAI,QAAQ,IAAI,aAAa,cAC3B,mBAAmB"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// @assistant-ui/core - Framework-agnostic core runtime (public API)\n\n/// <reference path=\"./store/scope-registration.ts\" />\n\nimport { checkDuplicateCore } from \"./internal/duplicate-detection\";\n\nif (process.env.NODE_ENV !== \"production\") {\n  checkDuplicateCore();\n}\n\nexport type {\n  // Message parts\n  TextMessagePart,\n  ReasoningMessagePart,\n  SourceProviderMetadata,\n  SourceMessagePart,\n  ImageMessagePart,\n  FileMessagePart,\n  DataMessagePart,\n  GenerativeUIMessagePart,\n  GenerativeUINode,\n  GenerativeUISpec,\n  Unstable_AudioMessagePart,\n  ToolCallMessagePart,\n  ToolCallMessagePartMcpMetadata,\n  McpAppMetadata,\n  ToolModelContentPart,\n  ThreadUserMessagePart,\n  ThreadAssistantMessagePart,\n  // Message status\n  MessagePartStatus,\n  ToolCallMessagePartStatus,\n  MessageStatus,\n  // Thread messages\n  MessageTiming,\n  ThreadStep,\n  ThreadSystemMessage,\n  ThreadUserMessage,\n  ThreadAssistantMessage,\n  ThreadMessage,\n  MessageRole,\n  // Config\n  RunConfig,\n  AppendMessage,\n} from \"./types/message\";\n\nexport { MCP_APP_URI_SCHEME, isMcpAppUri } from \"./types/message\";\n\nexport type {\n  Attachment,\n  PendingAttachment,\n  PendingAttachmentStatus,\n  CompleteAttachment,\n  CompleteAttachmentStatus,\n  AttachmentStatus,\n  CreateAttachment,\n} from \"./types/attachment\";\n\nexport type { Unsubscribe } from \"./types/unsubscribe\";\n\nexport type { QuoteInfo } from \"./types/quote\";\n\nexport type {\n  Unstable_DirectiveSegment,\n  Unstable_DirectiveFormatter,\n} from \"./types/directive\";\n\nexport type {\n  Unstable_TriggerItem,\n  Unstable_TriggerCategory,\n} from \"./types/trigger\";\n\nexport type { Unstable_TriggerAdapter } from \"./adapters/trigger\";\n\nexport type {\n  // Language model settings\n  LanguageModelV1CallSettings,\n  LanguageModelConfig,\n  // Model context\n  ModelContext,\n  ModelContextProvider,\n  // Tool & instruction config\n  AssistantToolProps,\n  AssistantInstructionsConfig,\n  AssistantContextConfig,\n} from \"./model-context/types\";\nexport { mergeModelContexts } from \"./model-context/types\";\n\nexport { tool } from \"./model-context/tool\";\n\nexport type { ToolExecutionStatus } from \"./runtimes/tool-invocations/ToolInvocationTracker\";\n\nexport { ModelContextRegistry } from \"./model-context/registry\";\nexport type {\n  ModelContextRegistryToolHandle,\n  ModelContextRegistryInstructionHandle,\n  ModelContextRegistryProviderHandle,\n} from \"./model-context/registry-handles\";\n\nexport { AssistantFrameHost } from \"./model-context/frame/host\";\nexport { AssistantFrameProvider } from \"./model-context/frame/provider\";\nexport type {\n  SerializedTool,\n  SerializedModelContext,\n  FrameMessageType,\n  FrameMessage,\n} from \"./model-context/frame/types\";\nexport { FRAME_MESSAGE_CHANNEL } from \"./model-context/frame/types\";\n\n// Attachment adapters\nexport type { AttachmentAdapter } from \"./adapters/attachment\";\nexport {\n  SimpleImageAttachmentAdapter,\n  SimpleTextAttachmentAdapter,\n  CompositeAttachmentAdapter,\n} from \"./adapters/attachment\";\n\n// Speech adapters\nexport type {\n  SpeechSynthesisAdapter,\n  DictationAdapter,\n} from \"./adapters/speech\";\nexport {\n  WebSpeechSynthesisAdapter,\n  WebSpeechDictationAdapter,\n} from \"./adapters/speech\";\n\n// Voice adapter\nexport type { RealtimeVoiceAdapter } from \"./adapters/voice\";\nexport { createVoiceSession } from \"./adapters/voice\";\nexport type {\n  VoiceSessionControls,\n  VoiceSessionHelpers,\n} from \"./adapters/voice\";\n\n// Feedback adapter\nexport type { FeedbackAdapter } from \"./adapters/feedback\";\n\n// Suggestion adapter\nexport type { SuggestionAdapter } from \"./adapters/suggestion\";\n\n// Directive formatter\nexport { unstable_defaultDirectiveFormatter } from \"./adapters/directive-formatter\";\n\n// Thread history adapters\nexport type {\n  ThreadHistoryAdapter,\n  GenericThreadHistoryAdapter,\n  MessageFormatAdapter,\n  MessageFormatItem,\n  MessageFormatRepository,\n  MessageStorageEntry,\n} from \"./adapters/thread-history\";\n\n// Path Types\nexport type {\n  ThreadListItemRuntimePath,\n  ThreadRuntimePath,\n  MessageRuntimePath,\n  MessagePartRuntimePath,\n  AttachmentRuntimePath,\n  ComposerRuntimePath,\n} from \"./runtime/api/paths\";\n\n// Runtime Core Interface Types\nexport type {\n  AttachmentAddErrorEvent,\n  AttachmentAddErrorReason,\n  ComposerRuntimeCore,\n  ComposerRuntimeEventCallback,\n  ComposerRuntimeEventPayload,\n  ComposerRuntimeEventType,\n  DictationState,\n  EditComposerRuntimeCore,\n  SendOptions,\n  ThreadComposerRuntimeCore,\n} from \"./runtime/interfaces/composer-runtime-core\";\n\nexport type {\n  RuntimeCapabilities,\n  AddToolResultOptions,\n  ResumeToolCallOptions,\n  RespondToToolApprovalOptions,\n  SubmitFeedbackOptions,\n  ThreadSuggestion,\n  SpeechState,\n  VoiceSessionState,\n  SubmittedFeedback,\n  ThreadRuntimeEventCallback,\n  ThreadRuntimeEventPayload,\n  ThreadRuntimeEventType,\n  StartRunConfig,\n  ResumeRunConfig,\n  ThreadRuntimeCore,\n} from \"./runtime/interfaces/thread-runtime-core\";\n\nexport type {\n  ThreadListItemStatus,\n  ThreadListItemCoreState,\n  ThreadListRuntimeCore,\n} from \"./runtime/interfaces/thread-list-runtime-core\";\n\nexport type { AssistantRuntimeCore } from \"./runtime/interfaces/assistant-runtime-core\";\n\n// Public Runtime Types\nexport type { AssistantRuntime } from \"./runtime/api/assistant-runtime\";\n\nexport type {\n  CreateStartRunConfig,\n  CreateResumeRunConfig,\n  CreateAppendMessage,\n  ThreadState,\n  ThreadRuntime,\n} from \"./runtime/api/thread-runtime\";\n\nexport type {\n  ThreadListState,\n  ThreadListRuntime,\n} from \"./runtime/api/thread-list-runtime\";\n\nexport type {\n  ThreadListItemEventCallback,\n  ThreadListItemEventPayload,\n  ThreadListItemEventType,\n  ThreadListItemRuntime,\n} from \"./runtime/api/thread-list-item-runtime\";\n\nexport type { ThreadListItemState } from \"./runtime/api/bindings\";\n\nexport type {\n  MessageState,\n  MessageRuntime,\n} from \"./runtime/api/message-runtime\";\nexport type {\n  MessagePartState,\n  MessagePartRuntime,\n} from \"./runtime/api/message-part-runtime\";\n\nexport type {\n  ThreadComposerState,\n  EditComposerState,\n  ComposerState,\n  ComposerRuntime,\n  ThreadComposerRuntime,\n  EditComposerRuntime,\n} from \"./runtime/api/composer-runtime\";\n\nexport type {\n  AttachmentState,\n  AttachmentRuntime,\n} from \"./runtime/api/attachment-runtime\";\n\n// ChatModel Types\nexport type {\n  ChatModelRunUpdate,\n  ChatModelRunResult,\n  CoreChatModelRunResult,\n  ChatModelRunOptions,\n  ChatModelAdapter,\n} from \"./runtime/utils/chat-model-adapter\";\n\n// ThreadMessageLike\nexport type { ThreadMessageLike } from \"./runtime/utils/thread-message-like\";\n\n// External Store Message Utilities\nexport {\n  getExternalStoreMessages,\n  bindExternalStoreMessage,\n} from \"./runtime/utils/external-store-message\";\n\n// ExportedMessageRepository\nexport type { ExportedMessageRepositoryItem } from \"./runtime/utils/message-repository\";\nexport { ExportedMessageRepository } from \"./runtime/utils/message-repository\";\n\n// Local Runtime Options\nexport type { LocalRuntimeOptionsBase } from \"./runtimes/local/local-runtime-options\";\n\n// External Store Adapter Types (user-facing)\nexport type {\n  ExternalStoreAdapter,\n  ExternalStoreMessageConverter,\n  ExternalStoreThreadListAdapter,\n  ExternalStoreThreadData,\n} from \"./runtimes/external-store/external-store-adapter\";\nexport type { ExternalStoreSharedOptions } from \"./runtimes/external-store/external-store-shared-options\";\nexport { pickExternalStoreSharedOptions } from \"./runtimes/external-store/external-store-shared-options\";\n\n// Remote Thread List (user-facing)\nexport type {\n  RemoteThreadListAdapter,\n  RemoteThreadListOptions,\n  RemoteThreadInitializeResponse,\n  RemoteThreadMetadata,\n  RemoteThreadListResponse,\n  RemoteThreadListPageOptions,\n} from \"./runtimes/remote-thread-list/types\";\n\nexport { InMemoryThreadListAdapter } from \"./runtimes/remote-thread-list/adapter/in-memory\";\n\n// Assistant Transport Utilities\nexport { createRequestHeaders } from \"./runtimes/assistant-transport/utils\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAMA,IAAI,QAAQ,IAAI,aAAa,cAC3B,mBAAmB"}

package/dist/internal/duplicate-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duplicate-detection.d.ts","names":[],"sources":["../../src/internal/duplicate-detection.ts"],"mappings":";iBAYgB,kBAAA,CAAA"}
+{"version":3,"file":"duplicate-detection.d.ts","names":[],"sources":["../../src/internal/duplicate-detection.ts"],"mappings":";iBAYgB,kBAAA"}

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
 import { fromThreadMessageLike } from "./runtime/utils/thread-message-like.js";
 import { ExportedMessageRepository, ExportedMessageRepositoryItem, MessageRepository } from "./runtime/utils/message-repository.js";
 import { BaseSubject, BaseSubscribable, EventSubscribable, EventSubscriptionSubject, LazyMemoizeSubject, NestedSubscribable, NestedSubscriptionSubject, SKIP_UPDATE, ShallowMemoizeSubject, Subscribable, SubscribableWithState } from "./subscribable/subscribable.js";
-import { generateErrorMessageId, generateId, generateOptimisticId, isErrorMessageId, isOptimisticId } from "./utils/id.js";
+import { generateErrorMessageId, generateId, isErrorMessageId } from "./utils/id.js";
 import { getThreadMessageText } from "./utils/text.js";
 import { CompositeContextProvider } from "./utils/composite-context-provider.js";
 import { ComposerRuntimeCoreBinding, EditComposerRuntimeCoreBinding, MessageStateBinding, ThreadComposerRuntimeCoreBinding } from "./runtime/api/bindings.js";
@@ -34,4 +34,4 @@ import { RemoteThreadInitializeResponse, RemoteThreadListOptions } from "./runti
 import { RemoteThreadData, RemoteThreadState, THREAD_MAPPING_ID, createThreadMappingId, getThreadData, updateStatusReducer } from "./runtimes/remote-thread-list/remote-thread-state.js";
 import { ThreadListItemRuntimeBinding, ThreadRuntimeCoreBinding, ThreadRuntimeImpl, getThreadState } from "./runtime/api/thread-runtime.js";
 import { AssistantRuntimeImpl } from "./runtime/api/assistant-runtime.js";
-export { AssistantRuntimeImpl, AttachmentRuntimeImpl, BaseAssistantRuntimeCore, BaseComposerRuntimeCore, BaseSubject, BaseSubscribable, BaseThreadRuntimeCore, type ComposerRuntimeCoreBinding, ComposerRuntimeImpl, CompositeContextProvider, type ConverterCallback, DefaultEditComposerRuntimeCore, DefaultThreadComposerRuntimeCore, EMPTY_THREAD_CORE, EditComposerAttachmentRuntimeImpl, type EditComposerRuntimeCoreBinding, EditComposerRuntimeImpl, type EventSubscribable, EventSubscriptionSubject, ExportedMessageRepository, type ExportedMessageRepositoryItem, ExternalStoreRuntimeCore, type ExternalStoreThreadFactory, ExternalStoreThreadListRuntimeCore, ExternalStoreThreadRuntimeCore, LazyMemoizeSubject, LocalRuntimeCore, type LocalRuntimeOptionsBase, type LocalThreadFactory, LocalThreadListRuntimeCore, LocalThreadRuntimeCore, MessageAttachmentRuntimeImpl, MessagePartRuntimeImpl, MessageRepository, MessageRuntimeImpl, type MessageStateBinding, type NestedSubscribable, NestedSubscriptionSubject, OptimisticState, ReadonlyThreadRuntimeCore, type RemoteThreadData, type RemoteThreadInitializeResponse, type RemoteThreadListOptions, type RemoteThreadState, SKIP_UPDATE, type SKIP_UPDATE as SKIP_UPDATE_TYPE, ShallowMemoizeSubject, type Subscribable, type SubscribableWithState, type THREAD_MAPPING_ID, ThreadComposerAttachmentRuntimeImpl, type ThreadComposerRuntimeCoreBinding, ThreadComposerRuntimeImpl, type ThreadListItemRuntimeBinding, ThreadListItemRuntimeImpl, type ThreadListItemStateBinding, type ThreadListRuntimeCoreBinding, ThreadListRuntimeImpl, ThreadMessageConverter, type ThreadRuntimeCoreBinding, ThreadRuntimeImpl, createThreadMappingId, fromThreadMessageLike, generateErrorMessageId, generateId, generateOptimisticId, getAutoStatus, getThreadData, getThreadMessageText, getThreadState, hasUpcomingMessage, isAutoStatus, isErrorMessageId, isOptimisticId, shouldContinue, symbolInnerMessage, updateStatusReducer };
+export { AssistantRuntimeImpl, AttachmentRuntimeImpl, BaseAssistantRuntimeCore, BaseComposerRuntimeCore, BaseSubject, BaseSubscribable, BaseThreadRuntimeCore, type ComposerRuntimeCoreBinding, ComposerRuntimeImpl, CompositeContextProvider, type ConverterCallback, DefaultEditComposerRuntimeCore, DefaultThreadComposerRuntimeCore, EMPTY_THREAD_CORE, EditComposerAttachmentRuntimeImpl, type EditComposerRuntimeCoreBinding, EditComposerRuntimeImpl, type EventSubscribable, EventSubscriptionSubject, ExportedMessageRepository, type ExportedMessageRepositoryItem, ExternalStoreRuntimeCore, type ExternalStoreThreadFactory, ExternalStoreThreadListRuntimeCore, ExternalStoreThreadRuntimeCore, LazyMemoizeSubject, LocalRuntimeCore, type LocalRuntimeOptionsBase, type LocalThreadFactory, LocalThreadListRuntimeCore, LocalThreadRuntimeCore, MessageAttachmentRuntimeImpl, MessagePartRuntimeImpl, MessageRepository, MessageRuntimeImpl, type MessageStateBinding, type NestedSubscribable, NestedSubscriptionSubject, OptimisticState, ReadonlyThreadRuntimeCore, type RemoteThreadData, type RemoteThreadInitializeResponse, type RemoteThreadListOptions, type RemoteThreadState, SKIP_UPDATE, type SKIP_UPDATE as SKIP_UPDATE_TYPE, ShallowMemoizeSubject, type Subscribable, type SubscribableWithState, type THREAD_MAPPING_ID, ThreadComposerAttachmentRuntimeImpl, type ThreadComposerRuntimeCoreBinding, ThreadComposerRuntimeImpl, type ThreadListItemRuntimeBinding, ThreadListItemRuntimeImpl, type ThreadListItemStateBinding, type ThreadListRuntimeCoreBinding, ThreadListRuntimeImpl, ThreadMessageConverter, type ThreadRuntimeCoreBinding, ThreadRuntimeImpl, createThreadMappingId, fromThreadMessageLike, generateErrorMessageId, generateId, getAutoStatus, getThreadData, getThreadMessageText, getThreadState, hasUpcomingMessage, isAutoStatus, isErrorMessageId, shouldContinue, symbolInnerMessage, updateStatusReducer };

package/dist/internal.js

@@ -1,4 +1,4 @@
-import { generateErrorMessageId, generateId, generateOptimisticId, isErrorMessageId, isOptimisticId } from "./utils/id.js";
+import { generateErrorMessageId, generateId, isErrorMessageId } from "./utils/id.js";
 import { symbolInnerMessage } from "./runtime/utils/external-store-message.js";
 import { getAutoStatus, isAutoStatus } from "./runtime/utils/auto-status.js";
 import { fromThreadMessageLike } from "./runtime/utils/thread-message-like.js";
@@ -31,4 +31,4 @@ import { ReadonlyThreadRuntimeCore } from "./runtimes/readonly/ReadonlyThreadRun
 import { OptimisticState } from "./runtimes/remote-thread-list/optimistic-state.js";
 import { EMPTY_THREAD_CORE } from "./runtimes/remote-thread-list/empty-thread-core.js";
 import { createThreadMappingId, getThreadData, updateStatusReducer } from "./runtimes/remote-thread-list/remote-thread-state.js";
-export { AssistantRuntimeImpl, AttachmentRuntimeImpl, BaseAssistantRuntimeCore, BaseComposerRuntimeCore, BaseSubject, BaseSubscribable, BaseThreadRuntimeCore, ComposerRuntimeImpl, CompositeContextProvider, DefaultEditComposerRuntimeCore, DefaultThreadComposerRuntimeCore, EMPTY_THREAD_CORE, EditComposerAttachmentRuntimeImpl, EditComposerRuntimeImpl, EventSubscriptionSubject, ExportedMessageRepository, ExternalStoreRuntimeCore, ExternalStoreThreadListRuntimeCore, ExternalStoreThreadRuntimeCore, LazyMemoizeSubject, LocalRuntimeCore, LocalThreadListRuntimeCore, LocalThreadRuntimeCore, MessageAttachmentRuntimeImpl, MessagePartRuntimeImpl, MessageRepository, MessageRuntimeImpl, NestedSubscriptionSubject, OptimisticState, ReadonlyThreadRuntimeCore, SKIP_UPDATE, ShallowMemoizeSubject, ThreadComposerAttachmentRuntimeImpl, ThreadComposerRuntimeImpl, ThreadListItemRuntimeImpl, ThreadListRuntimeImpl, ThreadMessageConverter, ThreadRuntimeImpl, createThreadMappingId, fromThreadMessageLike, generateErrorMessageId, generateId, generateOptimisticId, getAutoStatus, getThreadData, getThreadMessageText, getThreadState, hasUpcomingMessage, isAutoStatus, isErrorMessageId, isOptimisticId, shouldContinue, symbolInnerMessage, updateStatusReducer };
+export { AssistantRuntimeImpl, AttachmentRuntimeImpl, BaseAssistantRuntimeCore, BaseComposerRuntimeCore, BaseSubject, BaseSubscribable, BaseThreadRuntimeCore, ComposerRuntimeImpl, CompositeContextProvider, DefaultEditComposerRuntimeCore, DefaultThreadComposerRuntimeCore, EMPTY_THREAD_CORE, EditComposerAttachmentRuntimeImpl, EditComposerRuntimeImpl, EventSubscriptionSubject, ExportedMessageRepository, ExternalStoreRuntimeCore, ExternalStoreThreadListRuntimeCore, ExternalStoreThreadRuntimeCore, LazyMemoizeSubject, LocalRuntimeCore, LocalThreadListRuntimeCore, LocalThreadRuntimeCore, MessageAttachmentRuntimeImpl, MessagePartRuntimeImpl, MessageRepository, MessageRuntimeImpl, NestedSubscriptionSubject, OptimisticState, ReadonlyThreadRuntimeCore, SKIP_UPDATE, ShallowMemoizeSubject, ThreadComposerAttachmentRuntimeImpl, ThreadComposerRuntimeImpl, ThreadListItemRuntimeImpl, ThreadListRuntimeImpl, ThreadMessageConverter, ThreadRuntimeImpl, createThreadMappingId, fromThreadMessageLike, generateErrorMessageId, generateId, getAutoStatus, getThreadData, getThreadMessageText, getThreadState, hasUpcomingMessage, isAutoStatus, isErrorMessageId, shouldContinue, symbolInnerMessage, updateStatusReducer };

package/dist/model-context/frame/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","names":[],"sources":["../../../src/model-context/frame/host.ts"],"mappings":";;;;cA0Ca,kBAAA,YAA8B,oBAAA;EAAA,QACjC,QAAA;EAAA,QACA,YAAA;EAAA,QACA,gBAAA;EAAA,QAOA,eAAA;EAAA,QACA,aAAA;EAAA,QACA,aAAA;cAEI,YAAA,EAAc,MAAA,EAAQ,YAAA;EAAA,QAU1B,aAAA;EAAA,QA6BA,aAAA;EAAA,QAmBA,QAAA;EAAA,QAaA,WAAA;EAAA,QAqCA,cAAA;EAAA,QAYA,iBAAA;EAKR,eAAA,CAAA,GAAmB,YAAA;EAInB,SAAA,CAAU,QAAA,eAAuB,WAAA;EAKjC,OAAA,CAAA;AAAA"}
+{"version":3,"file":"host.d.ts","names":[],"sources":["../../../src/model-context/frame/host.ts"],"mappings":";;;;cA0Ca,kBAAA,YAA8B,oBAAA;EAAA,QACjC,QAAA;EAAA,QACA,YAAA;EAAA,QACA,gBAAA;EAAA,QAOA,eAAA;EAAA,QACA,aAAA;EAAA,QACA,aAAA;cAEI,YAAA,EAAc,MAAA,EAAQ,YAAA;EAAA,QAU1B,aAAA;EAAA,QA6BA,aAAA;EAAA,QAmBA,QAAA;EAAA,QAaA,WAAA;EAAA,QAqCA,cAAA;EAAA,QAYA,iBAAA;EAIR,eAAA,IAAmB,YAAA;EAInB,SAAA,CAAU,QAAA,eAAuB,WAAA;EAKjC,OAAA;AAAA"}

package/dist/model-context/frame/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":[],"sources":["../../../src/model-context/frame/host.ts"],"sourcesContent":["import type { ModelContextProvider, ModelContext } from \"../types\";\nimport type { Unsubscribe } from \"../../types/unsubscribe\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n  type FrameMessage,\n  FRAME_MESSAGE_CHANNEL,\n  type SerializedModelContext,\n  type SerializedTool,\n} from \"./types\";\n\n/**\n * Deserializes tools from JSON Schema format back to Tool objects\n */\nconst deserializeTool = (serializedTool: SerializedTool): Tool<any, any> =>\n  ({\n    parameters: serializedTool.parameters,\n    ...(serializedTool.description && {\n      description: serializedTool.description,\n    }),\n    ...(serializedTool.disabled !== undefined && {\n      disabled: serializedTool.disabled,\n    }),\n    ...(serializedTool.type && { type: serializedTool.type }),\n  }) as Tool<any, any>;\n\n/**\n * Deserializes a ModelContext from transmission format\n */\nconst deserializeModelContext = (\n  serialized: SerializedModelContext,\n): ModelContext => ({\n  ...(serialized.system !== undefined && { system: serialized.system }),\n  ...(serialized.tools && {\n    tools: Object.fromEntries(\n      Object.entries(serialized.tools).map(([name, tool]) => [\n        name,\n        deserializeTool(tool),\n      ]),\n    ),\n  }),\n});\n\nexport class AssistantFrameHost implements ModelContextProvider {\n  private _context: ModelContext = {};\n  private _subscribers = new Set<() => void>();\n  private _pendingRequests = new Map<\n    string,\n    {\n      resolve: (value: any) => void;\n      reject: (error: any) => void;\n    }\n  >();\n  private _requestCounter = 0;\n  private _iframeWindow: Window;\n  private _targetOrigin: string;\n\n  constructor(iframeWindow: Window, targetOrigin: string = \"*\") {\n    this._iframeWindow = iframeWindow;\n    this._targetOrigin = targetOrigin;\n\n    this.handleMessage = this.handleMessage.bind(this);\n    window.addEventListener(\"message\", this.handleMessage);\n\n    this.requestContext();\n  }\n\n  private handleMessage(event: MessageEvent) {\n    if (this._targetOrigin !== \"*\" && event.origin !== this._targetOrigin)\n      return;\n    if (event.source !== this._iframeWindow) return;\n    if (event.data?.channel !== FRAME_MESSAGE_CHANNEL) return;\n\n    const message = event.data.message as FrameMessage;\n\n    switch (message.type) {\n      case \"model-context-update\": {\n        this.updateContext(message.context);\n        break;\n      }\n\n      case \"tool-result\": {\n        const pending = this._pendingRequests.get(message.id);\n        if (pending) {\n          if (message.error) {\n            pending.reject(new Error(message.error));\n          } else {\n            pending.resolve(message.result);\n          }\n          this._pendingRequests.delete(message.id);\n        }\n        break;\n      }\n    }\n  }\n\n  private updateContext(serializedContext: SerializedModelContext) {\n    const context = deserializeModelContext(serializedContext);\n    this._context = {\n      ...context,\n      tools:\n        context.tools &&\n        Object.fromEntries(\n          Object.entries(context.tools).map(([name, tool]) => [\n            name,\n            {\n              ...tool,\n              execute: (args: any) => this.callTool(name, args),\n            } as Tool<any, any>,\n          ]),\n        ),\n    };\n    this.notifySubscribers();\n  }\n\n  private callTool(toolName: string, args: any): Promise<any> {\n    return this.sendRequest(\n      {\n        type: \"tool-call\",\n        id: `tool-${this._requestCounter++}`,\n        toolName,\n        args,\n      },\n      30000,\n      `Tool call \"${toolName}\" timed out`,\n    );\n  }\n\n  private sendRequest<T extends FrameMessage & { id: string }>(\n    message: T,\n    timeout = 30000,\n    timeoutMessage = \"Request timed out\",\n  ): Promise<any> {\n    return new Promise((resolve, reject) => {\n      this._pendingRequests.set(message.id, { resolve, reject });\n\n      this._iframeWindow.postMessage(\n        { channel: FRAME_MESSAGE_CHANNEL, message },\n        this._targetOrigin,\n      );\n\n      const timeoutId = setTimeout(() => {\n        const pending = this._pendingRequests.get(message.id);\n        if (pending) {\n          pending.reject(new Error(timeoutMessage));\n          this._pendingRequests.delete(message.id);\n        }\n      }, timeout);\n\n      const originalResolve = this._pendingRequests.get(message.id)!.resolve;\n      const originalReject = this._pendingRequests.get(message.id)!.reject;\n\n      this._pendingRequests.set(message.id, {\n        resolve: (value: any) => {\n          clearTimeout(timeoutId);\n          originalResolve(value);\n        },\n        reject: (error: any) => {\n          clearTimeout(timeoutId);\n          originalReject(error);\n        },\n      });\n    });\n  }\n\n  private requestContext() {\n    this._iframeWindow.postMessage(\n      {\n        channel: FRAME_MESSAGE_CHANNEL,\n        message: {\n          type: \"model-context-request\",\n        } as FrameMessage,\n      },\n      this._targetOrigin,\n    );\n  }\n\n  private notifySubscribers() {\n    // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach callback intentionally has no return\n    this._subscribers.forEach((callback) => callback());\n  }\n\n  getModelContext(): ModelContext {\n    return this._context;\n  }\n\n  subscribe(callback: () => void): Unsubscribe {\n    this._subscribers.add(callback);\n    return () => this._subscribers.delete(callback);\n  }\n\n  dispose() {\n    window.removeEventListener(\"message\", this.handleMessage);\n    this._subscribers.clear();\n    this._pendingRequests.clear();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"host.js","names":[],"sources":["../../../src/model-context/frame/host.ts"],"sourcesContent":["import type { ModelContextProvider, ModelContext } from \"../types\";\nimport type { Unsubscribe } from \"../../types/unsubscribe\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n  type FrameMessage,\n  FRAME_MESSAGE_CHANNEL,\n  type SerializedModelContext,\n  type SerializedTool,\n} from \"./types\";\n\n/**\n * Deserializes tools from JSON Schema format back to Tool objects\n */\nconst deserializeTool = (serializedTool: SerializedTool): Tool<any, any> =>\n  ({\n    parameters: serializedTool.parameters,\n    ...(serializedTool.description && {\n      description: serializedTool.description,\n    }),\n    ...(serializedTool.disabled !== undefined && {\n      disabled: serializedTool.disabled,\n    }),\n    ...(serializedTool.type && { type: serializedTool.type }),\n  }) as Tool<any, any>;\n\n/**\n * Deserializes a ModelContext from transmission format\n */\nconst deserializeModelContext = (\n  serialized: SerializedModelContext,\n): ModelContext => ({\n  ...(serialized.system !== undefined && { system: serialized.system }),\n  ...(serialized.tools && {\n    tools: Object.fromEntries(\n      Object.entries(serialized.tools).map(([name, tool]) => [\n        name,\n        deserializeTool(tool),\n      ]),\n    ),\n  }),\n});\n\nexport class AssistantFrameHost implements ModelContextProvider {\n  private _context: ModelContext = {};\n  private _subscribers = new Set<() => void>();\n  private _pendingRequests = new Map<\n    string,\n    {\n      resolve: (value: any) => void;\n      reject: (error: any) => void;\n    }\n  >();\n  private _requestCounter = 0;\n  private _iframeWindow: Window;\n  private _targetOrigin: string;\n\n  constructor(iframeWindow: Window, targetOrigin: string = \"*\") {\n    this._iframeWindow = iframeWindow;\n    this._targetOrigin = targetOrigin;\n\n    this.handleMessage = this.handleMessage.bind(this);\n    window.addEventListener(\"message\", this.handleMessage);\n\n    this.requestContext();\n  }\n\n  private handleMessage(event: MessageEvent) {\n    if (this._targetOrigin !== \"*\" && event.origin !== this._targetOrigin)\n      return;\n    if (event.source !== this._iframeWindow) return;\n    if (event.data?.channel !== FRAME_MESSAGE_CHANNEL) return;\n\n    const message = event.data.message as FrameMessage;\n\n    switch (message.type) {\n      case \"model-context-update\": {\n        this.updateContext(message.context);\n        break;\n      }\n\n      case \"tool-result\": {\n        const pending = this._pendingRequests.get(message.id);\n        if (pending) {\n          if (message.error) {\n            pending.reject(new Error(message.error));\n          } else {\n            pending.resolve(message.result);\n          }\n          this._pendingRequests.delete(message.id);\n        }\n        break;\n      }\n    }\n  }\n\n  private updateContext(serializedContext: SerializedModelContext) {\n    const context = deserializeModelContext(serializedContext);\n    this._context = {\n      ...context,\n      tools:\n        context.tools &&\n        Object.fromEntries(\n          Object.entries(context.tools).map(([name, tool]) => [\n            name,\n            {\n              ...tool,\n              execute: (args: any) => this.callTool(name, args),\n            } as Tool<any, any>,\n          ]),\n        ),\n    };\n    this.notifySubscribers();\n  }\n\n  private callTool(toolName: string, args: any): Promise<any> {\n    return this.sendRequest(\n      {\n        type: \"tool-call\",\n        id: `tool-${this._requestCounter++}`,\n        toolName,\n        args,\n      },\n      30000,\n      `Tool call \"${toolName}\" timed out`,\n    );\n  }\n\n  private sendRequest<T extends FrameMessage & { id: string }>(\n    message: T,\n    timeout = 30000,\n    timeoutMessage = \"Request timed out\",\n  ): Promise<any> {\n    return new Promise((resolve, reject) => {\n      this._pendingRequests.set(message.id, { resolve, reject });\n\n      this._iframeWindow.postMessage(\n        { channel: FRAME_MESSAGE_CHANNEL, message },\n        this._targetOrigin,\n      );\n\n      const timeoutId = setTimeout(() => {\n        const pending = this._pendingRequests.get(message.id);\n        if (pending) {\n          pending.reject(new Error(timeoutMessage));\n          this._pendingRequests.delete(message.id);\n        }\n      }, timeout);\n\n      const originalResolve = this._pendingRequests.get(message.id)!.resolve;\n      const originalReject = this._pendingRequests.get(message.id)!.reject;\n\n      this._pendingRequests.set(message.id, {\n        resolve: (value: any) => {\n          clearTimeout(timeoutId);\n          originalResolve(value);\n        },\n        reject: (error: any) => {\n          clearTimeout(timeoutId);\n          originalReject(error);\n        },\n      });\n    });\n  }\n\n  private requestContext() {\n    this._iframeWindow.postMessage(\n      {\n        channel: FRAME_MESSAGE_CHANNEL,\n        message: {\n          type: \"model-context-request\",\n        } as FrameMessage,\n      },\n      this._targetOrigin,\n    );\n  }\n\n  private notifySubscribers() {\n    this._subscribers.forEach((callback) => callback());\n  }\n\n  getModelContext(): ModelContext {\n    return this._context;\n  }\n\n  subscribe(callback: () => void): Unsubscribe {\n    this._subscribers.add(callback);\n    return () => this._subscribers.delete(callback);\n  }\n\n  dispose() {\n    window.removeEventListener(\"message\", this.handleMessage);\n    this._subscribers.clear();\n    this._pendingRequests.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/model-context/frame/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","names":[],"sources":["../../../src/model-context/frame/provider.ts"],"mappings":";;;;cA+Ba,sBAAA;EAAA,eACI,SAAA;EAAA,QAEP,UAAA;EAAA,QACA,qBAAA;EAAA,QAIA,aAAA;EAAA,QAED,WAAA,CAAA;EAAA,eAQQ,WAAA;EAAA,QASP,aAAA;EAAA,QAqBM,cAAA;EAAA,QAoCN,WAAA;EAAA,QAOA,eAAA;EAAA,QAkBA,eAAA;EAAA,OAcD,uBAAA,CACL,QAAA,EAAU,oBAAA,EACV,YAAA,YACC,WAAW;EAAA,OAmBP,OAAA,CAAA;AAAA"}
+{"version":3,"file":"provider.d.ts","names":[],"sources":["../../../src/model-context/frame/provider.ts"],"mappings":";;;;cA+Ba,sBAAA;EAAA,eACI,SAAA;EAAA,QAEP,UAAA;EAAA,QACA,qBAAA;EAAA,QAIA,aAAA;EAAA,QAED,WAAA;EAAA,eAQQ,WAAA;EAAA,QASP,aAAA;EAAA,QAqBM,cAAA;EAAA,QAoCN,WAAA;EAAA,QAOA,eAAA;EAAA,QAkBA,eAAA;EAAA,OAcD,uBAAA,CACL,QAAA,EAAU,oBAAA,EACV,YAAA,YACC,WAAW;EAAA,OAmBP,OAAA;AAAA"}

package/dist/model-context/frame/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../../src/model-context/frame/provider.ts"],"sourcesContent":["import type { ModelContextProvider, ModelContext } from \"../types\";\nimport type { Unsubscribe } from \"../../types/unsubscribe\";\nimport { type Tool, toJSONSchema } from \"assistant-stream\";\nimport {\n  type FrameMessage,\n  FRAME_MESSAGE_CHANNEL,\n  type SerializedModelContext,\n  type SerializedTool,\n} from \"./types\";\n\nconst serializeTool = (tool: Tool<any, any>): SerializedTool => ({\n  ...(tool.description && { description: tool.description }),\n  parameters: tool.parameters ? toJSONSchema(tool.parameters) : undefined,\n  ...(tool.disabled !== undefined && { disabled: tool.disabled }),\n  ...(tool.type && { type: tool.type }),\n});\n\nconst serializeModelContext = (\n  context: ModelContext,\n): SerializedModelContext => ({\n  ...(context.system !== undefined && { system: context.system }),\n  ...(context.tools && {\n    tools: Object.fromEntries(\n      Object.entries(context.tools).map(([name, tool]) => [\n        name,\n        serializeTool(tool),\n      ]),\n    ),\n  }),\n});\n\nexport class AssistantFrameProvider {\n  private static _instance: AssistantFrameProvider | null = null;\n\n  private _providers = new Set<ModelContextProvider>();\n  private _providerUnsubscribes = new Map<\n    ModelContextProvider,\n    Unsubscribe | undefined\n  >();\n  private _targetOrigin: string;\n\n  private constructor(targetOrigin: string = \"*\") {\n    this._targetOrigin = targetOrigin;\n    this.handleMessage = this.handleMessage.bind(this);\n    window.addEventListener(\"message\", this.handleMessage);\n\n    setTimeout(() => this.broadcastUpdate(), 0);\n  }\n\n  private static getInstance(targetOrigin?: string): AssistantFrameProvider {\n    if (!AssistantFrameProvider._instance) {\n      AssistantFrameProvider._instance = new AssistantFrameProvider(\n        targetOrigin,\n      );\n    }\n    return AssistantFrameProvider._instance;\n  }\n\n  private handleMessage(event: MessageEvent) {\n    if (this._targetOrigin !== \"*\" && event.origin !== this._targetOrigin)\n      return;\n    if (event.data?.channel !== FRAME_MESSAGE_CHANNEL) return;\n\n    const message = event.data.message as FrameMessage;\n\n    switch (message.type) {\n      case \"model-context-request\":\n        this.sendMessage(event, {\n          type: \"model-context-update\",\n          context: serializeModelContext(this.getModelContext()),\n        });\n        break;\n\n      case \"tool-call\":\n        this.handleToolCall(message, event);\n        break;\n    }\n  }\n\n  private async handleToolCall(\n    message: Extract<FrameMessage, { type: \"tool-call\" }>,\n    event: MessageEvent,\n  ) {\n    const tool = this.getModelContext().tools?.[message.toolName];\n\n    let result: any;\n    let error: string | undefined;\n\n    if (!tool) {\n      error = `Tool \"${message.toolName}\" not found`;\n    } else {\n      try {\n        result = tool.execute\n          ? await tool.execute(message.args, {\n              toolCallId: message.id,\n              abortSignal: new AbortController().signal,\n              human: async () => {\n                throw new Error(\n                  \"Tool human input is not supported in frame context\",\n                );\n              },\n            })\n          : undefined;\n      } catch (e) {\n        error = e instanceof Error ? e.message : String(e);\n      }\n    }\n\n    this.sendMessage(event, {\n      type: \"tool-result\",\n      id: message.id,\n      ...(error ? { error } : { result }),\n    });\n  }\n\n  private sendMessage(event: MessageEvent, message: FrameMessage) {\n    event.source?.postMessage(\n      { channel: FRAME_MESSAGE_CHANNEL, message },\n      { targetOrigin: event.origin },\n    );\n  }\n\n  private getModelContext(): ModelContext {\n    const contexts = Array.from(this._providers).map((p) =>\n      p.getModelContext(),\n    );\n\n    return contexts.reduce(\n      (merged, context) => ({\n        system: context.system\n          ? merged.system\n            ? `${merged.system}\\n\\n${context.system}`\n            : context.system\n          : merged.system,\n        tools: { ...(merged.tools || {}), ...(context.tools || {}) },\n      }),\n      {} as ModelContext,\n    );\n  }\n\n  private broadcastUpdate() {\n    if (window.parent && window.parent !== window) {\n      const updateMessage: FrameMessage = {\n        type: \"model-context-update\",\n        context: serializeModelContext(this.getModelContext()),\n      };\n\n      window.parent.postMessage(\n        { channel: FRAME_MESSAGE_CHANNEL, message: updateMessage },\n        this._targetOrigin,\n      );\n    }\n  }\n\n  static addModelContextProvider(\n    provider: ModelContextProvider,\n    targetOrigin?: string,\n  ): Unsubscribe {\n    const instance = AssistantFrameProvider.getInstance(targetOrigin);\n    instance._providers.add(provider);\n\n    const unsubscribe = provider.subscribe?.(() => instance.broadcastUpdate());\n    if (unsubscribe) {\n      instance._providerUnsubscribes.set(provider, unsubscribe);\n    }\n\n    instance.broadcastUpdate();\n\n    return () => {\n      instance._providers.delete(provider);\n      instance._providerUnsubscribes.get(provider)?.();\n      instance._providerUnsubscribes.delete(provider);\n      instance.broadcastUpdate();\n    };\n  }\n\n  static dispose() {\n    if (AssistantFrameProvider._instance) {\n      const instance = AssistantFrameProvider._instance;\n      window.removeEventListener(\"message\", instance.handleMessage);\n\n      // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach callback intentionally has no return\n      instance._providerUnsubscribes.forEach((unsubscribe) => unsubscribe?.());\n      instance._providerUnsubscribes.clear();\n      instance._providers.clear();\n\n      AssistantFrameProvider._instance = null;\n    }\n  }\n}\n"],"mappings":";;;AAUA,MAAM,iBAAiB,UAA0C;CAC/D,GAAI,KAAK,eAAe,EAAE,aAAa,KAAK,YAAY;CACxD,YAAY,KAAK,aAAa,aAAa,KAAK,UAAU,IAAI,KAAA;CAC9D,GAAI,KAAK,aAAa,KAAA,KAAa,EAAE,UAAU,KAAK,SAAS;CAC7D,GAAI,KAAK,QAAQ,EAAE,MAAM,KAAK,KAAK;AACrC;AAEA,MAAM,yBACJ,aAC4B;CAC5B,GAAI,QAAQ,WAAW,KAAA,KAAa,EAAE,QAAQ,QAAQ,OAAO;CAC7D,GAAI,QAAQ,SAAS,EACnB,OAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,KAAK,EAAE,KAAK,CAAC,MAAM,UAAU,CAClD,MACA,cAAc,IAAI,CACpB,CAAC,CACH,EACF;AACF;AAEA,IAAa,yBAAb,MAAa,uBAAuB;CAClC,OAAe,YAA2C;CAE1D,6BAAqB,IAAI,IAA0B;CACnD,wCAAgC,IAAI,IAGlC;CACF;CAEA,YAAoB,eAAuB,KAAK;EAC9C,KAAK,gBAAgB;EACrB,KAAK,gBAAgB,KAAK,cAAc,KAAK,IAAI;EACjD,OAAO,iBAAiB,WAAW,KAAK,aAAa;EAErD,iBAAiB,KAAK,gBAAgB,GAAG,CAAC;CAC5C;CAEA,OAAe,YAAY,cAA+C;EACxE,IAAI,CAAC,uBAAuB,WAC1B,uBAAuB,YAAY,IAAI,uBACrC,YACF;EAEF,OAAO,uBAAuB;CAChC;CAEA,cAAsB,OAAqB;EACzC,IAAI,KAAK,kBAAkB,OAAO,MAAM,WAAW,KAAK,eACtD;EACF,IAAI,MAAM,MAAM,YAAA,sBAAmC;EAEnD,MAAM,UAAU,MAAM,KAAK;EAE3B,QAAQ,QAAQ,MAAhB;GACE,KAAK;IACH,KAAK,YAAY,OAAO;KACtB,MAAM;KACN,SAAS,sBAAsB,KAAK,gBAAgB,CAAC;IACvD,CAAC;IACD;GAEF,KAAK;IACH,KAAK,eAAe,SAAS,KAAK;IAClC;EACJ;CACF;CAEA,MAAc,eACZ,SACA,OACA;EACA,MAAM,OAAO,KAAK,gBAAgB,EAAE,QAAQ,QAAQ;EAEpD,IAAI;EACJ,IAAI;EAEJ,IAAI,CAAC,MACH,QAAQ,SAAS,QAAQ,SAAS;OAElC,IAAI;GACF,SAAS,KAAK,UACV,MAAM,KAAK,QAAQ,QAAQ,MAAM;IAC/B,YAAY,QAAQ;IACpB,aAAa,IAAI,gBAAgB,EAAE;IACnC,OAAO,YAAY;KACjB,MAAM,IAAI,MACR,oDACF;IACF;GACF,CAAC,IACD,KAAA;EACN,SAAS,GAAG;GACV,QAAQ,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;EACnD;EAGF,KAAK,YAAY,OAAO;GACtB,MAAM;GACN,IAAI,QAAQ;GACZ,GAAI,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO;EACnC,CAAC;CACH;CAEA,YAAoB,OAAqB,SAAuB;EAC9D,MAAM,QAAQ,YACZ;GAAE,SAAS;GAAuB;EAAQ,GAC1C,EAAE,cAAc,MAAM,OAAO,CAC/B;CACF;CAEA,kBAAwC;EAKtC,OAJiB,MAAM,KAAK,KAAK,UAAU,EAAE,KAAK,MAChD,EAAE,gBAAgB,CAGN,EAAE,QACb,QAAQ,aAAa;GACpB,QAAQ,QAAQ,SACZ,OAAO,SACL,GAAG,OAAO,OAAO,MAAM,QAAQ,WAC/B,QAAQ,SACV,OAAO;GACX,OAAO;IAAE,GAAI,OAAO,SAAS,CAAC;IAAI,GAAI,QAAQ,SAAS,CAAC;GAAG;EAC7D,IACA,CAAC,CACH;CACF;CAEA,kBAA0B;EACxB,IAAI,OAAO,UAAU,OAAO,WAAW,QAAQ;GAC7C,MAAM,gBAA8B;IAClC,MAAM;IACN,SAAS,sBAAsB,KAAK,gBAAgB,CAAC;GACvD;GAEA,OAAO,OAAO,YACZ;IAAE,SAAS;IAAuB,SAAS;GAAc,GACzD,KAAK,aACP;EACF;CACF;CAEA,OAAO,wBACL,UACA,cACa;EACb,MAAM,WAAW,uBAAuB,YAAY,YAAY;EAChE,SAAS,WAAW,IAAI,QAAQ;EAEhC,MAAM,cAAc,SAAS,kBAAkB,SAAS,gBAAgB,CAAC;EACzE,IAAI,aACF,SAAS,sBAAsB,IAAI,UAAU,WAAW;EAG1D,SAAS,gBAAgB;EAEzB,aAAa;GACX,SAAS,WAAW,OAAO,QAAQ;GACnC,SAAS,sBAAsB,IAAI,QAAQ,IAAI;GAC/C,SAAS,sBAAsB,OAAO,QAAQ;GAC9C,SAAS,gBAAgB;EAC3B;CACF;CAEA,OAAO,UAAU;EACf,IAAI,uBAAuB,WAAW;GACpC,MAAM,WAAW,uBAAuB;GACxC,OAAO,oBAAoB,WAAW,SAAS,aAAa;GAG5D,SAAS,sBAAsB,SAAS,gBAAgB,cAAc,CAAC;GACvE,SAAS,sBAAsB,MAAM;GACrC,SAAS,WAAW,MAAM;GAE1B,uBAAuB,YAAY;EACrC;CACF;AACF"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/model-context/frame/provider.ts"],"sourcesContent":["import type { ModelContextProvider, ModelContext } from \"../types\";\nimport type { Unsubscribe } from \"../../types/unsubscribe\";\nimport { type Tool, toJSONSchema } from \"assistant-stream\";\nimport {\n  type FrameMessage,\n  FRAME_MESSAGE_CHANNEL,\n  type SerializedModelContext,\n  type SerializedTool,\n} from \"./types\";\n\nconst serializeTool = (tool: Tool<any, any>): SerializedTool => ({\n  ...(tool.description && { description: tool.description }),\n  parameters: tool.parameters ? toJSONSchema(tool.parameters) : undefined,\n  ...(tool.disabled !== undefined && { disabled: tool.disabled }),\n  ...(tool.type && { type: tool.type }),\n});\n\nconst serializeModelContext = (\n  context: ModelContext,\n): SerializedModelContext => ({\n  ...(context.system !== undefined && { system: context.system }),\n  ...(context.tools && {\n    tools: Object.fromEntries(\n      Object.entries(context.tools).map(([name, tool]) => [\n        name,\n        serializeTool(tool),\n      ]),\n    ),\n  }),\n});\n\nexport class AssistantFrameProvider {\n  private static _instance: AssistantFrameProvider | null = null;\n\n  private _providers = new Set<ModelContextProvider>();\n  private _providerUnsubscribes = new Map<\n    ModelContextProvider,\n    Unsubscribe | undefined\n  >();\n  private _targetOrigin: string;\n\n  private constructor(targetOrigin: string = \"*\") {\n    this._targetOrigin = targetOrigin;\n    this.handleMessage = this.handleMessage.bind(this);\n    window.addEventListener(\"message\", this.handleMessage);\n\n    setTimeout(() => this.broadcastUpdate(), 0);\n  }\n\n  private static getInstance(targetOrigin?: string): AssistantFrameProvider {\n    if (!AssistantFrameProvider._instance) {\n      AssistantFrameProvider._instance = new AssistantFrameProvider(\n        targetOrigin,\n      );\n    }\n    return AssistantFrameProvider._instance;\n  }\n\n  private handleMessage(event: MessageEvent) {\n    if (this._targetOrigin !== \"*\" && event.origin !== this._targetOrigin)\n      return;\n    if (event.data?.channel !== FRAME_MESSAGE_CHANNEL) return;\n\n    const message = event.data.message as FrameMessage;\n\n    switch (message.type) {\n      case \"model-context-request\":\n        this.sendMessage(event, {\n          type: \"model-context-update\",\n          context: serializeModelContext(this.getModelContext()),\n        });\n        break;\n\n      case \"tool-call\":\n        this.handleToolCall(message, event);\n        break;\n    }\n  }\n\n  private async handleToolCall(\n    message: Extract<FrameMessage, { type: \"tool-call\" }>,\n    event: MessageEvent,\n  ) {\n    const tool = this.getModelContext().tools?.[message.toolName];\n\n    let result: any;\n    let error: string | undefined;\n\n    if (!tool) {\n      error = `Tool \"${message.toolName}\" not found`;\n    } else {\n      try {\n        result = tool.execute\n          ? await tool.execute(message.args, {\n              toolCallId: message.id,\n              abortSignal: new AbortController().signal,\n              human: async () => {\n                throw new Error(\n                  \"Tool human input is not supported in frame context\",\n                );\n              },\n            })\n          : undefined;\n      } catch (e) {\n        error = e instanceof Error ? e.message : String(e);\n      }\n    }\n\n    this.sendMessage(event, {\n      type: \"tool-result\",\n      id: message.id,\n      ...(error ? { error } : { result }),\n    });\n  }\n\n  private sendMessage(event: MessageEvent, message: FrameMessage) {\n    event.source?.postMessage(\n      { channel: FRAME_MESSAGE_CHANNEL, message },\n      { targetOrigin: event.origin },\n    );\n  }\n\n  private getModelContext(): ModelContext {\n    const contexts = Array.from(this._providers).map((p) =>\n      p.getModelContext(),\n    );\n\n    return contexts.reduce(\n      (merged, context) => ({\n        system: context.system\n          ? merged.system\n            ? `${merged.system}\\n\\n${context.system}`\n            : context.system\n          : merged.system,\n        tools: { ...(merged.tools || {}), ...(context.tools || {}) },\n      }),\n      {} as ModelContext,\n    );\n  }\n\n  private broadcastUpdate() {\n    if (window.parent && window.parent !== window) {\n      const updateMessage: FrameMessage = {\n        type: \"model-context-update\",\n        context: serializeModelContext(this.getModelContext()),\n      };\n\n      window.parent.postMessage(\n        { channel: FRAME_MESSAGE_CHANNEL, message: updateMessage },\n        this._targetOrigin,\n      );\n    }\n  }\n\n  static addModelContextProvider(\n    provider: ModelContextProvider,\n    targetOrigin?: string,\n  ): Unsubscribe {\n    const instance = AssistantFrameProvider.getInstance(targetOrigin);\n    instance._providers.add(provider);\n\n    const unsubscribe = provider.subscribe?.(() => instance.broadcastUpdate());\n    if (unsubscribe) {\n      instance._providerUnsubscribes.set(provider, unsubscribe);\n    }\n\n    instance.broadcastUpdate();\n\n    return () => {\n      instance._providers.delete(provider);\n      instance._providerUnsubscribes.get(provider)?.();\n      instance._providerUnsubscribes.delete(provider);\n      instance.broadcastUpdate();\n    };\n  }\n\n  static dispose() {\n    if (AssistantFrameProvider._instance) {\n      const instance = AssistantFrameProvider._instance;\n      window.removeEventListener(\"message\", instance.handleMessage);\n\n      instance._providerUnsubscribes.forEach((unsubscribe) => unsubscribe?.());\n      instance._providerUnsubscribes.clear();\n      instance._providers.clear();\n\n      AssistantFrameProvider._instance = null;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/model-context/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/model-context/registry.ts"],"mappings":";;;;;cAea,oBAAA,YAAgC,oBAAA;EAAA,QACnC,MAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;EAAA,QACA,YAAA;EAAA,QACA,qBAAA;EAER,eAAA,CAAA,GAAmB,YAAA;EA4CnB,SAAA,CAAU,QAAA,eAAuB,WAAA;EAAA,QAKzB,iBAAA;EAMR,OAAA,eAAsB,MAAA,2BAAA,CACpB,IAAA,EAAM,kBAAA,CAAmB,KAAA,EAAO,OAAA,IAC/B,8BAAA,CAA+B,KAAA,EAAO,OAAA;EAoBzC,cAAA,CACE,MAAA,WAAiB,2BAAA,GAChB,qCAAA;EAiCH,WAAA,CACE,QAAA,EAAU,oBAAA,GACT,kCAAA;AAAA"}
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/model-context/registry.ts"],"mappings":";;;;;cAea,oBAAA,YAAgC,oBAAA;EAAA,QACnC,MAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;EAAA,QACA,YAAA;EAAA,QACA,qBAAA;EAER,eAAA,IAAmB,YAAA;EA4CnB,SAAA,CAAU,QAAA,eAAuB,WAAA;EAAA,QAKzB,iBAAA;EAMR,OAAA,eAAsB,MAAA,4BACpB,IAAA,EAAM,kBAAA,CAAmB,KAAA,EAAO,OAAA,IAC/B,8BAAA,CAA+B,KAAA,EAAO,OAAA;EAoBzC,cAAA,CACE,MAAA,WAAiB,2BAAA,GAChB,qCAAA;EAiCH,WAAA,CACE,QAAA,EAAU,oBAAA,GACT,kCAAA;AAAA"}

package/dist/model-context/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","names":[],"sources":["../../src/model-context/tool.ts"],"mappings":";;;;;AA6BA;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,IAAA,eAAmB,MAAA,iCAAA,CACjC,IAAA,EAAM,IAAA,CAAK,KAAA,EAAO,OAAA,IACjB,IAAA,CAAK,KAAA,EAAO,OAAA"}
+{"version":3,"file":"tool.d.ts","names":[],"sources":["../../src/model-context/tool.ts"],"mappings":";;;;;AA6BA;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,IAAA,eAAmB,MAAA,kCACjC,IAAA,EAAM,IAAA,CAAK,KAAA,EAAO,OAAA,IACjB,IAAA,CAAK,KAAA,EAAO,OAAA"}

package/dist/react/client/Interactables.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interactables.js","names":[],"sources":["../../../src/react/client/Interactables.ts"],"sourcesContent":["import {\n  resource,\n  tapState,\n  tapEffect,\n  tapCallback,\n  tapRef,\n  tapMemo,\n} from \"@assistant-ui/tap\";\nimport {\n  tapAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type {\n  InteractablesState,\n  InteractableRegistration,\n  InteractableStateSchema,\n  InteractablePersistedState,\n  InteractablePersistenceAdapter,\n} from \"../types/scopes/interactables\";\nimport { toJSONSchema, toPartialJSONSchema } from \"assistant-stream\";\nimport { ModelContext } from \"../../store\";\nimport { buildInteractableModelContext } from \"./interactable-model-context\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\nexport const Interactables = resource((): ClientOutput<\"interactables\"> => {\n  const [state, setState] = tapState<InteractablesState>(() => ({\n    definitions: {},\n    persistence: {},\n  }));\n\n  const clientRef = tapAssistantClientRef();\n\n  const stateRef = tapRef(state);\n  tapEffect(() => {\n    stateRef.current = state;\n  }, [state]);\n\n  const subscribersRef = tapRef(new Set<() => void>());\n  const partialSchemaCacheRef = tapRef(\n    new Map<string, InteractableStateSchema>(),\n  );\n  const detachedStateRef = tapRef(new Map<string, unknown>());\n\n  const adapterRef = tapRef<InteractablePersistenceAdapter | undefined>(\n    undefined,\n  );\n  const debounceTimerRef = tapRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = tapRef(0);\n  const hasPendingLocalChangeRef = tapRef(false);\n  const flushResolversRef = tapRef<Array<() => void>>([]);\n  const dirtyIdsRef = tapRef(new Set<string>());\n\n  const runPersistence = tapCallback(async () => {\n    const adapter = adapterRef.current;\n    if (!adapter) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n      return;\n    }\n\n    const seq = ++syncSeqRef.current;\n    const dirtyIds = new Set(dirtyIdsRef.current);\n    dirtyIdsRef.current.clear();\n    hasPendingLocalChangeRef.current = true;\n\n    // Snapshot before any await so unregistered definitions are still included.\n    const exported = stateRef.current.definitions;\n    const payload: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(exported)) {\n      payload[id] = { name: def.name, state: def.state };\n    }\n\n    setState((prev) => ({\n      ...prev,\n      persistence: {\n        ...prev.persistence,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      },\n    }));\n\n    try {\n      await adapter.save(payload);\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => {\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) delete persistence[id];\n          return { ...prev, persistence };\n        });\n      }\n    } catch (e) {\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => ({\n          ...prev,\n          persistence: {\n            ...prev.persistence,\n            ...Object.fromEntries(\n              [...dirtyIds].map((id) => [id, { isPending: false, error: e }]),\n            ),\n          },\n        }));\n      }\n    } finally {\n      if (dirtyIdsRef.current.size > 0 && adapterRef.current) {\n        runPersistence();\n      } else {\n        for (const resolve of flushResolversRef.current) resolve();\n        flushResolversRef.current = [];\n      }\n    }\n  }, []);\n\n  const schedulePersistence = tapCallback(\n    (id: string) => {\n      if (!adapterRef.current) return;\n      dirtyIdsRef.current.add(id);\n      if (debounceTimerRef.current !== undefined) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = undefined;\n        if (!hasPendingLocalChangeRef.current) {\n          runPersistence();\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            runPersistence();\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [runPersistence],\n  );\n\n  const exportState = tapCallback((): InteractablePersistedState => {\n    const result: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(stateRef.current.definitions)) {\n      result[id] = { name: def.name, state: def.state };\n    }\n    return result;\n  }, []);\n\n  const importState = tapCallback((saved: InteractablePersistedState) => {\n    for (const [id, entry] of Object.entries(saved)) {\n      detachedStateRef.current.set(id, entry.state);\n    }\n    setState((prev) => {\n      let changed = false;\n      const definitions = { ...prev.definitions };\n      for (const [id, entry] of Object.entries(saved)) {\n        if (definitions[id]) {\n          definitions[id] = { ...definitions[id], state: entry.state };\n          changed = true;\n        }\n      }\n      return changed ? { ...prev, definitions } : prev;\n    });\n  }, []);\n\n  const setPersistenceAdapter = tapCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      adapterRef.current = adapter;\n    },\n    [],\n  );\n\n  const flush = tapCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (!adapterRef.current) return;\n    if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0)\n      return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (!hasPendingLocalChangeRef.current) {\n      runPersistence();\n    }\n    return p;\n  }, [runPersistence]);\n\n  const flushIfPending = tapCallback(() => {\n    if (adapterRef.current && debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n      runPersistence();\n    }\n  }, [runPersistence]);\n\n  const setDefState = tapCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setState((prev) => {\n        const existing = prev.definitions[id];\n        if (!existing) return prev;\n        return {\n          ...prev,\n          definitions: {\n            ...prev.definitions,\n            [id]: { ...existing, state: updater(existing.state) },\n          },\n        };\n      });\n      if (stateRef.current.definitions[id]) schedulePersistence(id);\n    },\n    [schedulePersistence],\n  );\n\n  const setDefSelected = tapCallback((id: string, selected: boolean) => {\n    setState((prev) => {\n      const existing = prev.definitions[id];\n      if (!existing) return prev;\n      return {\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [id]: { ...existing, selected },\n        },\n      };\n    });\n  }, []);\n\n  const provider = tapMemo(\n    () => ({\n      getModelContext: () => {\n        const defs = stateRef.current.definitions;\n        return (\n          buildInteractableModelContext(\n            defs,\n            partialSchemaCacheRef.current,\n            setDefState,\n          ) ?? {}\n        );\n      },\n      subscribe: (callback: () => void) => {\n        subscribersRef.current.add(callback);\n        return () => {\n          subscribersRef.current.delete(callback);\n        };\n      },\n    }),\n    [setDefState],\n  );\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: state dep triggers notification\n  tapEffect(() => {\n    for (const cb of subscribersRef.current) cb();\n  }, [state]);\n\n  tapEffect(() => {\n    return clientRef.current!.modelContext().register(provider);\n  }, [clientRef, provider]);\n\n  const register = tapCallback(\n    (def: InteractableRegistration) => {\n      try {\n        const jsonSchema = toJSONSchema(def.stateSchema);\n        partialSchemaCacheRef.current.set(\n          def.id,\n          toPartialJSONSchema(jsonSchema),\n        );\n      } catch (e) {\n        console.warn(\n          `[Interactables] Failed to create partial schema for \"${def.name}\". The update tool will require all fields.`,\n          e,\n        );\n      }\n\n      const detached = detachedStateRef.current.get(def.id);\n      detachedStateRef.current.delete(def.id);\n\n      setState((prev) => ({\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [def.id]: {\n            id: def.id,\n            name: def.name,\n            description: def.description,\n            stateSchema: def.stateSchema,\n            state:\n              prev.definitions[def.id]?.state ?? detached ?? def.initialState,\n            selected: def.selected,\n          },\n        },\n      }));\n\n      return () => {\n        flushIfPending();\n        setState((prev) => {\n          const existing = prev.definitions[def.id];\n          if (existing) {\n            detachedStateRef.current.set(def.id, existing.state);\n          }\n          partialSchemaCacheRef.current.delete(def.id);\n          const { [def.id]: _, ...rest } = prev.definitions;\n          const { [def.id]: __, ...restPersistence } = prev.persistence;\n          return { ...prev, definitions: rest, persistence: restPersistence };\n        });\n      };\n    },\n    [flushIfPending],\n  );\n\n  return {\n    getState: () => state,\n    register,\n    setState: setDefState,\n    setSelected: setDefSelected,\n    exportState,\n    importState,\n    setPersistenceAdapter,\n    flush,\n  };\n});\n\nattachTransformScopes(Interactables, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":"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"}
+{"version":3,"file":"Interactables.js","names":[],"sources":["../../../src/react/client/Interactables.ts"],"sourcesContent":["import {\n  resource,\n  tapState,\n  tapEffect,\n  tapCallback,\n  tapRef,\n  tapMemo,\n} from \"@assistant-ui/tap\";\nimport {\n  tapAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type {\n  InteractablesState,\n  InteractableRegistration,\n  InteractableStateSchema,\n  InteractablePersistedState,\n  InteractablePersistenceAdapter,\n} from \"../types/scopes/interactables\";\nimport { toJSONSchema, toPartialJSONSchema } from \"assistant-stream\";\nimport { ModelContext } from \"../../store\";\nimport { buildInteractableModelContext } from \"./interactable-model-context\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\nexport const Interactables = resource((): ClientOutput<\"interactables\"> => {\n  const [state, setState] = tapState<InteractablesState>(() => ({\n    definitions: {},\n    persistence: {},\n  }));\n\n  const clientRef = tapAssistantClientRef();\n\n  const stateRef = tapRef(state);\n  tapEffect(() => {\n    stateRef.current = state;\n  }, [state]);\n\n  const subscribersRef = tapRef(new Set<() => void>());\n  const partialSchemaCacheRef = tapRef(\n    new Map<string, InteractableStateSchema>(),\n  );\n  const detachedStateRef = tapRef(new Map<string, unknown>());\n\n  const adapterRef = tapRef<InteractablePersistenceAdapter | undefined>(\n    undefined,\n  );\n  const debounceTimerRef = tapRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = tapRef(0);\n  const hasPendingLocalChangeRef = tapRef(false);\n  const flushResolversRef = tapRef<Array<() => void>>([]);\n  const dirtyIdsRef = tapRef(new Set<string>());\n\n  const runPersistence = tapCallback(async () => {\n    const adapter = adapterRef.current;\n    if (!adapter) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n      return;\n    }\n\n    const seq = ++syncSeqRef.current;\n    const dirtyIds = new Set(dirtyIdsRef.current);\n    dirtyIdsRef.current.clear();\n    hasPendingLocalChangeRef.current = true;\n\n    // Snapshot before any await so unregistered definitions are still included.\n    const exported = stateRef.current.definitions;\n    const payload: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(exported)) {\n      payload[id] = { name: def.name, state: def.state };\n    }\n\n    setState((prev) => ({\n      ...prev,\n      persistence: {\n        ...prev.persistence,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      },\n    }));\n\n    try {\n      await adapter.save(payload);\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => {\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) delete persistence[id];\n          return { ...prev, persistence };\n        });\n      }\n    } catch (e) {\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => ({\n          ...prev,\n          persistence: {\n            ...prev.persistence,\n            ...Object.fromEntries(\n              [...dirtyIds].map((id) => [id, { isPending: false, error: e }]),\n            ),\n          },\n        }));\n      }\n    } finally {\n      if (dirtyIdsRef.current.size > 0 && adapterRef.current) {\n        runPersistence();\n      } else {\n        for (const resolve of flushResolversRef.current) resolve();\n        flushResolversRef.current = [];\n      }\n    }\n  }, []);\n\n  const schedulePersistence = tapCallback(\n    (id: string) => {\n      if (!adapterRef.current) return;\n      dirtyIdsRef.current.add(id);\n      if (debounceTimerRef.current !== undefined) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = undefined;\n        if (!hasPendingLocalChangeRef.current) {\n          runPersistence();\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            runPersistence();\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [runPersistence],\n  );\n\n  const exportState = tapCallback((): InteractablePersistedState => {\n    const result: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(stateRef.current.definitions)) {\n      result[id] = { name: def.name, state: def.state };\n    }\n    return result;\n  }, []);\n\n  const importState = tapCallback((saved: InteractablePersistedState) => {\n    for (const [id, entry] of Object.entries(saved)) {\n      detachedStateRef.current.set(id, entry.state);\n    }\n    setState((prev) => {\n      let changed = false;\n      const definitions = { ...prev.definitions };\n      for (const [id, entry] of Object.entries(saved)) {\n        if (definitions[id]) {\n          definitions[id] = { ...definitions[id], state: entry.state };\n          changed = true;\n        }\n      }\n      return changed ? { ...prev, definitions } : prev;\n    });\n  }, []);\n\n  const setPersistenceAdapter = tapCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      adapterRef.current = adapter;\n    },\n    [],\n  );\n\n  const flush = tapCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (!adapterRef.current) return;\n    if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0)\n      return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (!hasPendingLocalChangeRef.current) {\n      runPersistence();\n    }\n    return p;\n  }, [runPersistence]);\n\n  const flushIfPending = tapCallback(() => {\n    if (adapterRef.current && debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n      runPersistence();\n    }\n  }, [runPersistence]);\n\n  const setDefState = tapCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setState((prev) => {\n        const existing = prev.definitions[id];\n        if (!existing) return prev;\n        return {\n          ...prev,\n          definitions: {\n            ...prev.definitions,\n            [id]: { ...existing, state: updater(existing.state) },\n          },\n        };\n      });\n      if (stateRef.current.definitions[id]) schedulePersistence(id);\n    },\n    [schedulePersistence],\n  );\n\n  const setDefSelected = tapCallback((id: string, selected: boolean) => {\n    setState((prev) => {\n      const existing = prev.definitions[id];\n      if (!existing) return prev;\n      return {\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [id]: { ...existing, selected },\n        },\n      };\n    });\n  }, []);\n\n  const provider = tapMemo(\n    () => ({\n      getModelContext: () => {\n        const defs = stateRef.current.definitions;\n        return (\n          buildInteractableModelContext(\n            defs,\n            partialSchemaCacheRef.current,\n            setDefState,\n          ) ?? {}\n        );\n      },\n      subscribe: (callback: () => void) => {\n        subscribersRef.current.add(callback);\n        return () => {\n          subscribersRef.current.delete(callback);\n        };\n      },\n    }),\n    [setDefState],\n  );\n\n  tapEffect(() => {\n    for (const cb of subscribersRef.current) cb();\n  }, [state]);\n\n  tapEffect(() => {\n    return clientRef.current!.modelContext().register(provider);\n  }, [clientRef, provider]);\n\n  const register = tapCallback(\n    (def: InteractableRegistration) => {\n      try {\n        const jsonSchema = toJSONSchema(def.stateSchema);\n        partialSchemaCacheRef.current.set(\n          def.id,\n          toPartialJSONSchema(jsonSchema),\n        );\n      } catch (e) {\n        console.warn(\n          `[Interactables] Failed to create partial schema for \"${def.name}\". The update tool will require all fields.`,\n          e,\n        );\n      }\n\n      const detached = detachedStateRef.current.get(def.id);\n      detachedStateRef.current.delete(def.id);\n\n      setState((prev) => ({\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [def.id]: {\n            id: def.id,\n            name: def.name,\n            description: def.description,\n            stateSchema: def.stateSchema,\n            state:\n              prev.definitions[def.id]?.state ?? detached ?? def.initialState,\n            selected: def.selected,\n          },\n        },\n      }));\n\n      return () => {\n        flushIfPending();\n        setState((prev) => {\n          const existing = prev.definitions[def.id];\n          if (existing) {\n            detachedStateRef.current.set(def.id, existing.state);\n          }\n          partialSchemaCacheRef.current.delete(def.id);\n          const { [def.id]: _, ...rest } = prev.definitions;\n          const { [def.id]: __, ...restPersistence } = prev.persistence;\n          return { ...prev, definitions: rest, persistence: restPersistence };\n        });\n      };\n    },\n    [flushIfPending],\n  );\n\n  return {\n    getState: () => state,\n    register,\n    setState: setDefState,\n    setSelected: setDefSelected,\n    exportState,\n    importState,\n    setPersistenceAdapter,\n    flush,\n  };\n});\n\nattachTransformScopes(Interactables, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":";;;;;;AAwBA,MAAM,0BAA0B;AAEhC,MAAa,gBAAgB,eAA8C;CACzE,MAAM,CAAC,OAAO,YAAY,gBAAoC;EAC5D,aAAa,CAAC;EACd,aAAa,CAAC;CAChB,EAAE;CAEF,MAAM,YAAY,sBAAsB;CAExC,MAAM,WAAW,OAAO,KAAK;CAC7B,gBAAgB;EACd,SAAS,UAAU;CACrB,GAAG,CAAC,KAAK,CAAC;CAEV,MAAM,iBAAiB,uBAAO,IAAI,IAAgB,CAAC;CACnD,MAAM,wBAAwB,uBAC5B,IAAI,IAAqC,CAC3C;CACA,MAAM,mBAAmB,uBAAO,IAAI,IAAqB,CAAC;CAE1D,MAAM,aAAa,OACjB,KAAA,CACF;CACA,MAAM,mBAAmB,OACvB,KAAA,CACF;CACA,MAAM,aAAa,OAAO,CAAC;CAC3B,MAAM,2BAA2B,OAAO,KAAK;CAC7C,MAAM,oBAAoB,OAA0B,CAAC,CAAC;CACtD,MAAM,cAAc,uBAAO,IAAI,IAAY,CAAC;CAE5C,MAAM,iBAAiB,YAAY,YAAY;EAC7C,MAAM,UAAU,WAAW;EAC3B,IAAI,CAAC,SAAS;GACZ,KAAK,MAAM,WAAW,kBAAkB,SAAS,QAAQ;GACzD,kBAAkB,UAAU,CAAC;GAC7B;EACF;EAEA,MAAM,MAAM,EAAE,WAAW;EACzB,MAAM,WAAW,IAAI,IAAI,YAAY,OAAO;EAC5C,YAAY,QAAQ,MAAM;EAC1B,yBAAyB,UAAU;EAGnC,MAAM,WAAW,SAAS,QAAQ;EAClC,MAAM,UAAsC,CAAC;EAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,OAAO,QAAQ,QAAQ,GAC7C,QAAQ,MAAM;GAAE,MAAM,IAAI;GAAM,OAAO,IAAI;EAAM;EAGnD,UAAU,UAAU;GAClB,GAAG;GACH,aAAa;IACX,GAAG,KAAK;IACR,GAAG,OAAO,YACR,CAAC,GAAG,QAAQ,EAAE,KAAK,OAAO,CACxB,IACA;KAAE,WAAW;KAAM,OAAO,KAAA;IAAU,CACtC,CAAC,CACH;GACF;EACF,EAAE;EAEF,IAAI;GACF,MAAM,QAAQ,KAAK,OAAO;GAC1B,IAAI,WAAW,YAAY,KAAK;IAC9B,yBAAyB,UAAU;IACnC,UAAU,SAAS;KACjB,MAAM,cAAc,EAAE,GAAG,KAAK,YAAY;KAC1C,KAAK,MAAM,MAAM,UAAU,OAAO,YAAY;KAC9C,OAAO;MAAE,GAAG;MAAM;KAAY;IAChC,CAAC;GACH;EACF,SAAS,GAAG;GACV,IAAI,WAAW,YAAY,KAAK;IAC9B,yBAAyB,UAAU;IACnC,UAAU,UAAU;KAClB,GAAG;KACH,aAAa;MACX,GAAG,KAAK;MACR,GAAG,OAAO,YACR,CAAC,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI;OAAE,WAAW;OAAO,OAAO;MAAE,CAAC,CAAC,CAChE;KACF;IACF,EAAE;GACJ;EACF,UAAU;GACR,IAAI,YAAY,QAAQ,OAAO,KAAK,WAAW,SAC7C,eAAe;QACV;IACL,KAAK,MAAM,WAAW,kBAAkB,SAAS,QAAQ;IACzD,kBAAkB,UAAU,CAAC;GAC/B;EACF;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,sBAAsB,aACzB,OAAe;EACd,IAAI,CAAC,WAAW,SAAS;EACzB,YAAY,QAAQ,IAAI,EAAE;EAC1B,IAAI,iBAAiB,YAAY,KAAA,GAC/B,aAAa,iBAAiB,OAAO;EAEvC,iBAAiB,UAAU,iBAAiB;GAC1C,iBAAiB,UAAU,KAAA;GAC3B,IAAI,CAAC,yBAAyB,SAC5B,eAAe;QAEf,iBAAiB,UAAU,iBAAiB;IAC1C,iBAAiB,UAAU,KAAA;IAC3B,eAAe;GACjB,GAAG,uBAAuB;EAE9B,GAAG,uBAAuB;CAC5B,GACA,CAAC,cAAc,CACjB;CAEA,MAAM,cAAc,kBAA8C;EAChE,MAAM,SAAqC,CAAC;EAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,OAAO,QAAQ,SAAS,QAAQ,WAAW,GACjE,OAAO,MAAM;GAAE,MAAM,IAAI;GAAM,OAAO,IAAI;EAAM;EAElD,OAAO;CACT,GAAG,CAAC,CAAC;CAEL,MAAM,cAAc,aAAa,UAAsC;EACrE,KAAK,MAAM,CAAC,IAAI,UAAU,OAAO,QAAQ,KAAK,GAC5C,iBAAiB,QAAQ,IAAI,IAAI,MAAM,KAAK;EAE9C,UAAU,SAAS;GACjB,IAAI,UAAU;GACd,MAAM,cAAc,EAAE,GAAG,KAAK,YAAY;GAC1C,KAAK,MAAM,CAAC,IAAI,UAAU,OAAO,QAAQ,KAAK,GAC5C,IAAI,YAAY,KAAK;IACnB,YAAY,MAAM;KAAE,GAAG,YAAY;KAAK,OAAO,MAAM;IAAM;IAC3D,UAAU;GACZ;GAEF,OAAO,UAAU;IAAE,GAAG;IAAM;GAAY,IAAI;EAC9C,CAAC;CACH,GAAG,CAAC,CAAC;CAEL,MAAM,wBAAwB,aAC3B,YAAwD;EACvD,WAAW,UAAU;CACvB,GACA,CAAC,CACH;CAEA,MAAM,QAAQ,YAAY,YAAY;EACpC,IAAI,iBAAiB,YAAY,KAAA,GAAW;GAC1C,aAAa,iBAAiB,OAAO;GACrC,iBAAiB,UAAU,KAAA;EAC7B;EACA,IAAI,CAAC,WAAW,SAAS;EACzB,IAAI,CAAC,yBAAyB,WAAW,YAAY,QAAQ,SAAS,GACpE;EACF,MAAM,IAAI,IAAI,SAAe,YAAY;GACvC,kBAAkB,QAAQ,KAAK,OAAO;EACxC,CAAC;EACD,IAAI,CAAC,yBAAyB,SAC5B,eAAe;EAEjB,OAAO;CACT,GAAG,CAAC,cAAc,CAAC;CAEnB,MAAM,iBAAiB,kBAAkB;EACvC,IAAI,WAAW,WAAW,iBAAiB,YAAY,KAAA,GAAW;GAChE,aAAa,iBAAiB,OAAO;GACrC,iBAAiB,UAAU,KAAA;GAC3B,eAAe;EACjB;CACF,GAAG,CAAC,cAAc,CAAC;CAEnB,MAAM,cAAc,aACjB,IAAY,YAAwC;EACnD,UAAU,SAAS;GACjB,MAAM,WAAW,KAAK,YAAY;GAClC,IAAI,CAAC,UAAU,OAAO;GACtB,OAAO;IACL,GAAG;IACH,aAAa;KACX,GAAG,KAAK;MACP,KAAK;MAAE,GAAG;MAAU,OAAO,QAAQ,SAAS,KAAK;KAAE;IACtD;GACF;EACF,CAAC;EACD,IAAI,SAAS,QAAQ,YAAY,KAAK,oBAAoB,EAAE;CAC9D,GACA,CAAC,mBAAmB,CACtB;CAEA,MAAM,iBAAiB,aAAa,IAAY,aAAsB;EACpE,UAAU,SAAS;GACjB,MAAM,WAAW,KAAK,YAAY;GAClC,IAAI,CAAC,UAAU,OAAO;GACtB,OAAO;IACL,GAAG;IACH,aAAa;KACX,GAAG,KAAK;MACP,KAAK;MAAE,GAAG;MAAU;KAAS;IAChC;GACF;EACF,CAAC;CACH,GAAG,CAAC,CAAC;CAEL,MAAM,WAAW,eACR;EACL,uBAAuB;GACrB,MAAM,OAAO,SAAS,QAAQ;GAC9B,OACE,8BACE,MACA,sBAAsB,SACtB,WACF,KAAK,CAAC;EAEV;EACA,YAAY,aAAyB;GACnC,eAAe,QAAQ,IAAI,QAAQ;GACnC,aAAa;IACX,eAAe,QAAQ,OAAO,QAAQ;GACxC;EACF;CACF,IACA,CAAC,WAAW,CACd;CAEA,gBAAgB;EACd,KAAK,MAAM,MAAM,eAAe,SAAS,GAAG;CAC9C,GAAG,CAAC,KAAK,CAAC;CAEV,gBAAgB;EACd,OAAO,UAAU,QAAS,aAAa,EAAE,SAAS,QAAQ;CAC5D,GAAG,CAAC,WAAW,QAAQ,CAAC;CAqDxB,OAAO;EACL,gBAAgB;EAChB,UArDe,aACd,QAAkC;GACjC,IAAI;IACF,MAAM,aAAa,aAAa,IAAI,WAAW;IAC/C,sBAAsB,QAAQ,IAC5B,IAAI,IACJ,oBAAoB,UAAU,CAChC;GACF,SAAS,GAAG;IACV,QAAQ,KACN,wDAAwD,IAAI,KAAK,8CACjE,CACF;GACF;GAEA,MAAM,WAAW,iBAAiB,QAAQ,IAAI,IAAI,EAAE;GACpD,iBAAiB,QAAQ,OAAO,IAAI,EAAE;GAEtC,UAAU,UAAU;IAClB,GAAG;IACH,aAAa;KACX,GAAG,KAAK;MACP,IAAI,KAAK;MACR,IAAI,IAAI;MACR,MAAM,IAAI;MACV,aAAa,IAAI;MACjB,aAAa,IAAI;MACjB,OACE,KAAK,YAAY,IAAI,KAAK,SAAS,YAAY,IAAI;MACrD,UAAU,IAAI;KAChB;IACF;GACF,EAAE;GAEF,aAAa;IACX,eAAe;IACf,UAAU,SAAS;KACjB,MAAM,WAAW,KAAK,YAAY,IAAI;KACtC,IAAI,UACF,iBAAiB,QAAQ,IAAI,IAAI,IAAI,SAAS,KAAK;KAErD,sBAAsB,QAAQ,OAAO,IAAI,EAAE;KAC3C,MAAM,GAAG,IAAI,KAAK,GAAG,GAAG,SAAS,KAAK;KACtC,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,oBAAoB,KAAK;KAClD,OAAO;MAAE,GAAG;MAAM,aAAa;MAAM,aAAa;KAAgB;IACpE,CAAC;GACH;EACF,GACA,CAAC,cAAc,CAKR;EACP,UAAU;EACV,aAAa;EACb;EACA;EACA;EACA;CACF;AACF,CAAC;AAED,sBAAsB,gBAAgB,QAAQ,WAAW;CACvD,IAAI,CAAC,OAAO,gBAAgB,OAAO,aAAa,WAAW,MACzD,OAAO,eAAe,aAAa;AAEvC,CAAC"}

package/dist/react/client/Tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tools.d.ts","names":[],"sources":["../../../src/react/client/Tools.ts"],"mappings":";;;;;;;AA+BA;;;;;;;cAAa,KAAA,GAAK,KAAA;EAQW,gFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA;kFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA"}
+{"version":3,"file":"Tools.d.ts","names":[],"sources":["../../../src/react/client/Tools.ts"],"mappings":";;;;;;;AAkCA;;;;;;;cAAa,KAAA,GAAK,KAAA;EAQW,gFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA;kFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA"}

package/dist/react/client/Tools.js

@@ -1,4 +1,5 @@
 import { ModelContext } from "../../store/clients/model-context-client.js";
+import { isStandaloneToolDisplay } from "../model-context/toolbox.js";
 import { attachTransformScopes, tapAssistantClientRef } from "@assistant-ui/store";
 import { resource, tapCallback, tapEffect, tapMemo, tapResources, tapState, withKey } from "@assistant-ui/tap";
 //#region src/react/client/Tools.ts
@@ -12,30 +13,40 @@ import { resource, tapCallback, tapEffect, tapMemo, tapResources, tapState, with
 */
 const Tools = resource(({ toolkit, mcpApp }) => {
 	const mcpAppOutput = tapResources(() => mcpApp ? [withKey("mcpApp", mcpApp)] : [], [mcpApp])[0];
-	const [toolsState, setToolsState] = tapState(() => ({ tools: {} }));
+	const [toolUIs, setToolUIs] = tapState(() => ({}));
 	const state = tapMemo(() => ({
-		tools: toolsState.tools,
-		mcpApp: mcpAppOutput
-	}), [toolsState, mcpAppOutput]);
+		toolUIs,
+		mcpApp: mcpAppOutput,
+		tools: Object.fromEntries(Object.entries(toolUIs).map(([name, regs]) => [name, regs.map((r) => r.render)]))
+	}), [toolUIs, mcpAppOutput]);
 	const clientRef = tapAssistantClientRef();
-	const setToolUI = tapCallback((toolName, render) => {
-		setToolsState((prev) => ({ tools: {
-			...prev.tools,
-			[toolName]: [...prev.tools[toolName] ?? [], render]
-		} }));
+	const setToolUI = tapCallback((toolName, render, options) => {
+		const registration = {
+			render,
+			standalone: options?.standalone ?? false
+		};
+		setToolUIs((prev) => ({
+			...prev,
+			[toolName]: [...prev[toolName] ?? [], registration]
+		}));
 		return () => {
-			setToolsState((prev) => ({ tools: {
-				...prev.tools,
-				[toolName]: prev.tools[toolName]?.filter((r) => r !== render) ?? []
-			} }));
+			setToolUIs((prev) => {
+				const next = prev[toolName]?.filter((r) => r !== registration) ?? [];
+				if (next.length > 0) return {
+					...prev,
+					[toolName]: next
+				};
+				const { [toolName]: _removed, ...rest } = prev;
+				return rest;
+			});
 		};
 	}, []);
 	tapEffect(() => {
 		if (!toolkit) return;
 		const unsubscribes = [];
-		for (const [toolName, tool] of Object.entries(toolkit)) if (tool.render) unsubscribes.push(setToolUI(toolName, tool.render));
+		for (const [toolName, tool] of Object.entries(toolkit)) if (tool.render) unsubscribes.push(setToolUI(toolName, tool.render, { standalone: isStandaloneToolDisplay(tool) }));
 		const toolsWithoutRender = Object.entries(toolkit).reduce((acc, [name, tool]) => {
-			const { render, ...rest } = tool;
+			const { render, display, ...rest } = tool;
 			acc[name] = rest;
 			return acc;
 		}, {});

package/dist/react/client/Tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tools.js","names":[],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import {\n  resource,\n  tapState,\n  tapEffect,\n  tapCallback,\n  tapMemo,\n  tapResources,\n  withKey,\n  type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n  tapAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport type { Toolkit } from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/**\n * Registers tools with model context and installs tool-call renderers.\n *\n * Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n */\nexport const Tools = resource(\n  ({\n    toolkit,\n    mcpApp,\n  }: {\n    /** Tools to expose to the model and optional renderers to install. */\n    toolkit?: Toolkit;\n    /** Optional MCP app resource whose tools should be merged into context. */\n    mcpApp?: ResourceElement<McpAppResourceOutput> | undefined;\n  }): ClientOutput<\"tools\"> => {\n    const mcpAppOutputs = tapResources(\n      () => (mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []),\n      [mcpApp],\n    );\n    const mcpAppOutput = mcpAppOutputs[0];\n\n    const [toolsState, setToolsState] = tapState<{\n      tools: ToolsState[\"tools\"];\n    }>(() => ({\n      tools: {},\n    }));\n\n    const state = tapMemo(\n      (): ToolsState => ({ tools: toolsState.tools, mcpApp: mcpAppOutput }),\n      [toolsState, mcpAppOutput],\n    );\n\n    const clientRef = tapAssistantClientRef();\n\n    const setToolUI = tapCallback(\n      (toolName: string, render: ToolCallMessagePartComponent) => {\n        setToolsState((prev) => ({\n          tools: {\n            ...prev.tools,\n            [toolName]: [...(prev.tools[toolName] ?? []), render],\n          },\n        }));\n\n        return () => {\n          setToolsState((prev) => ({\n            tools: {\n              ...prev.tools,\n              [toolName]:\n                prev.tools[toolName]?.filter((r) => r !== render) ?? [],\n            },\n          }));\n        };\n      },\n      [],\n    );\n\n    tapEffect(() => {\n      if (!toolkit) return;\n      const unsubscribes: (() => void)[] = [];\n\n      // Register tool UIs (exclude symbols)\n      for (const [toolName, tool] of Object.entries(toolkit)) {\n        if (tool.render) {\n          unsubscribes.push(setToolUI(toolName, tool.render));\n        }\n      }\n\n      // Register tools with model context (exclude symbols)\n      const toolsWithoutRender = Object.entries(toolkit).reduce(\n        (acc, [name, tool]) => {\n          const { render, ...rest } = tool;\n          acc[name] = rest;\n          return acc;\n        },\n        {} as Record<string, Tool<any, any>>,\n      );\n\n      const modelContextProvider = {\n        getModelContext: () => ({\n          tools: toolsWithoutRender,\n        }),\n      };\n\n      unsubscribes.push(\n        clientRef.current!.modelContext().register(modelContextProvider),\n      );\n\n      return () => {\n        // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach callback intentionally has no return\n        unsubscribes.forEach((fn) => fn());\n      };\n    }, [toolkit, setToolUI, clientRef]);\n\n    return {\n      getState: () => state,\n      setToolUI,\n    };\n  },\n);\n\nattachTransformScopes(Tools, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":";;;;;;;;;;;;AA+BA,MAAa,QAAQ,UAClB,EACC,SACA,aAM2B;CAK3B,MAAM,eAJgB,mBACb,SAAS,CAAC,QAAQ,UAAU,MAAM,CAAC,IAAI,CAAC,GAC/C,CAAC,MAAM,CAEwB,EAAE;CAEnC,MAAM,CAAC,YAAY,iBAAiB,gBAE1B,EACR,OAAO,CAAC,EACV,EAAE;CAEF,MAAM,QAAQ,eACO;EAAE,OAAO,WAAW;EAAO,QAAQ;CAAa,IACnE,CAAC,YAAY,YAAY,CAC3B;CAEA,MAAM,YAAY,sBAAsB;CAExC,MAAM,YAAY,aACf,UAAkB,WAAyC;EAC1D,eAAe,UAAU,EACvB,OAAO;GACL,GAAG,KAAK;IACP,WAAW,CAAC,GAAI,KAAK,MAAM,aAAa,CAAC,GAAI,MAAM;EACtD,EACF,EAAE;EAEF,aAAa;GACX,eAAe,UAAU,EACvB,OAAO;IACL,GAAG,KAAK;KACP,WACC,KAAK,MAAM,WAAW,QAAQ,MAAM,MAAM,MAAM,KAAK,CAAC;GAC1D,EACF,EAAE;EACJ;CACF,GACA,CAAC,CACH;CAEA,gBAAgB;EACd,IAAI,CAAC,SAAS;EACd,MAAM,eAA+B,CAAC;EAGtC,KAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,OAAO,GACnD,IAAI,KAAK,QACP,aAAa,KAAK,UAAU,UAAU,KAAK,MAAM,CAAC;EAKtD,MAAM,qBAAqB,OAAO,QAAQ,OAAO,EAAE,QAChD,KAAK,CAAC,MAAM,UAAU;GACrB,MAAM,EAAE,QAAQ,GAAG,SAAS;GAC5B,IAAI,QAAQ;GACZ,OAAO;EACT,GACA,CAAC,CACH;EAQA,aAAa,KACX,UAAU,QAAS,aAAa,EAAE,SAAS,EAN3C,wBAAwB,EACtB,OAAO,mBACT,GAI8D,CAAC,CACjE;EAEA,aAAa;GAEX,aAAa,SAAS,OAAO,GAAG,CAAC;EACnC;CACF,GAAG;EAAC;EAAS;EAAW;CAAS,CAAC;CAElC,OAAO;EACL,gBAAgB;EAChB;CACF;AACF,CACF;AAEA,sBAAsB,QAAQ,QAAQ,WAAW;CAC/C,IAAI,CAAC,OAAO,gBAAgB,OAAO,aAAa,WAAW,MACzD,OAAO,eAAe,aAAa;AAEvC,CAAC"}
+{"version":3,"file":"Tools.js","names":[],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import {\n  resource,\n  tapState,\n  tapEffect,\n  tapCallback,\n  tapMemo,\n  tapResources,\n  withKey,\n  type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n  tapAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n  isStandaloneToolDisplay,\n  type Toolkit,\n} from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/**\n * Registers tools with model context and installs tool-call renderers.\n *\n * Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n */\nexport const Tools = resource(\n  ({\n    toolkit,\n    mcpApp,\n  }: {\n    /** Tools to expose to the model and optional renderers to install. */\n    toolkit?: Toolkit;\n    /** Optional MCP app resource whose tools should be merged into context. */\n    mcpApp?: ResourceElement<McpAppResourceOutput> | undefined;\n  }): ClientOutput<\"tools\"> => {\n    const mcpAppOutputs = tapResources(\n      () => (mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []),\n      [mcpApp],\n    );\n    const mcpAppOutput = mcpAppOutputs[0];\n\n    const [toolUIs, setToolUIs] = tapState<ToolsState[\"toolUIs\"]>(() => ({}));\n\n    const state = tapMemo(\n      (): ToolsState => ({\n        toolUIs,\n        mcpApp: mcpAppOutput,\n        // Deprecated component-only view, derived from `toolUIs`. Removed in v0.15.\n        tools: Object.fromEntries(\n          Object.entries(toolUIs).map(([name, regs]) => [\n            name,\n            regs.map((r) => r.render),\n          ]),\n        ),\n      }),\n      [toolUIs, mcpAppOutput],\n    );\n\n    const clientRef = tapAssistantClientRef();\n\n    const setToolUI = tapCallback(\n      (\n        toolName: string,\n        render: ToolCallMessagePartComponent,\n        options?: { standalone?: boolean },\n      ) => {\n        // One registration object per call; identity is the removal key, so\n        // the per-name list stays correctly ref-counted across re-registers.\n        const registration = {\n          render,\n          standalone: options?.standalone ?? false,\n        };\n\n        setToolUIs((prev) => ({\n          ...prev,\n          [toolName]: [...(prev[toolName] ?? []), registration],\n        }));\n\n        return () => {\n          setToolUIs((prev) => {\n            const next =\n              prev[toolName]?.filter((r) => r !== registration) ?? [];\n            if (next.length > 0) return { ...prev, [toolName]: next };\n            // Drop the key entirely so repeatedly mounted/unmounted tools\n            // don't leave empty arrays accumulating across a long session.\n            const { [toolName]: _removed, ...rest } = prev;\n            return rest;\n          });\n        };\n      },\n      [],\n    );\n\n    tapEffect(() => {\n      if (!toolkit) return;\n      const unsubscribes: (() => void)[] = [];\n\n      // Register tool UIs (exclude symbols)\n      for (const [toolName, tool] of Object.entries(toolkit)) {\n        if (tool.render) {\n          unsubscribes.push(\n            setToolUI(toolName, tool.render, {\n              standalone: isStandaloneToolDisplay(tool),\n            }),\n          );\n        }\n      }\n\n      // Register tools with model context (exclude symbols). `render` and\n      // `display` are client-only presentation concerns and never reach the\n      // model.\n      const toolsWithoutRender = Object.entries(toolkit).reduce(\n        (acc, [name, tool]) => {\n          const { render, display, ...rest } = tool;\n          acc[name] = rest;\n          return acc;\n        },\n        {} as Record<string, Tool<any, any>>,\n      );\n\n      const modelContextProvider = {\n        getModelContext: () => ({\n          tools: toolsWithoutRender,\n        }),\n      };\n\n      unsubscribes.push(\n        clientRef.current!.modelContext().register(modelContextProvider),\n      );\n\n      return () => {\n        unsubscribes.forEach((fn) => fn());\n      };\n    }, [toolkit, setToolUI, clientRef]);\n\n    return {\n      getState: () => state,\n      setToolUI,\n    };\n  },\n);\n\nattachTransformScopes(Tools, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":";;;;;;;;;;;;;AAkCA,MAAa,QAAQ,UAClB,EACC,SACA,aAM2B;CAK3B,MAAM,eAJgB,mBACb,SAAS,CAAC,QAAQ,UAAU,MAAM,CAAC,IAAI,CAAC,GAC/C,CAAC,MAAM,CAEwB,EAAE;CAEnC,MAAM,CAAC,SAAS,cAAc,gBAAuC,CAAC,EAAE;CAExE,MAAM,QAAQ,eACO;EACjB;EACA,QAAQ;EAER,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,EAAE,KAAK,CAAC,MAAM,UAAU,CAC5C,MACA,KAAK,KAAK,MAAM,EAAE,MAAM,CAC1B,CAAC,CACH;CACF,IACA,CAAC,SAAS,YAAY,CACxB;CAEA,MAAM,YAAY,sBAAsB;CAExC,MAAM,YAAY,aAEd,UACA,QACA,YACG;EAGH,MAAM,eAAe;GACnB;GACA,YAAY,SAAS,cAAc;EACrC;EAEA,YAAY,UAAU;GACpB,GAAG;IACF,WAAW,CAAC,GAAI,KAAK,aAAa,CAAC,GAAI,YAAY;EACtD,EAAE;EAEF,aAAa;GACX,YAAY,SAAS;IACnB,MAAM,OACJ,KAAK,WAAW,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC;IACxD,IAAI,KAAK,SAAS,GAAG,OAAO;KAAE,GAAG;MAAO,WAAW;IAAK;IAGxD,MAAM,GAAG,WAAW,UAAU,GAAG,SAAS;IAC1C,OAAO;GACT,CAAC;EACH;CACF,GACA,CAAC,CACH;CAEA,gBAAgB;EACd,IAAI,CAAC,SAAS;EACd,MAAM,eAA+B,CAAC;EAGtC,KAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,OAAO,GACnD,IAAI,KAAK,QACP,aAAa,KACX,UAAU,UAAU,KAAK,QAAQ,EAC/B,YAAY,wBAAwB,IAAI,EAC1C,CAAC,CACH;EAOJ,MAAM,qBAAqB,OAAO,QAAQ,OAAO,EAAE,QAChD,KAAK,CAAC,MAAM,UAAU;GACrB,MAAM,EAAE,QAAQ,SAAS,GAAG,SAAS;GACrC,IAAI,QAAQ;GACZ,OAAO;EACT,GACA,CAAC,CACH;EAQA,aAAa,KACX,UAAU,QAAS,aAAa,EAAE,SAAS,EAN3C,wBAAwB,EACtB,OAAO,mBACT,GAI8D,CAAC,CACjE;EAEA,aAAa;GACX,aAAa,SAAS,OAAO,GAAG,CAAC;EACnC;CACF,GAAG;EAAC;EAAS;EAAW;CAAS,CAAC;CAElC,OAAO;EACL,gBAAgB;EAChB;CACF;AACF,CACF;AAEA,sBAAsB,QAAQ,QAAQ,WAAW;CAC/C,IAAI,CAAC,OAAO,gBAAgB,OAAO,aAAa,WAAW,MACzD,OAAO,eAAe,aAAa;AAEvC,CAAC"}

package/dist/react/index.d.ts

@@ -10,7 +10,7 @@ import { DataRenderers } from "./client/DataRenderers.js";
 import { Interactables } from "./client/Interactables.js";
 import { DataMessagePartComponent, DataMessagePartProps, EmptyMessagePartComponent, EmptyMessagePartProps, FileMessagePartComponent, FileMessagePartProps, GenerativeUIComponentRegistry, GenerativeUIMessagePartComponent, GenerativeUIMessagePartProps, GenerativeUIRenderProps, ImageMessagePartComponent, ImageMessagePartProps, QuoteMessagePartComponent, QuoteMessagePartProps, ReasoningGroupComponent, ReasoningGroupProps, ReasoningMessagePartComponent, ReasoningMessagePartProps, SourceMessagePartComponent, SourceMessagePartProps, TextMessagePartComponent, TextMessagePartProps, ToolCallMessagePartComponent, ToolCallMessagePartProps, Unstable_AudioMessagePartComponent, Unstable_AudioMessagePartProps } from "./types/MessagePartComponentTypes.js";
 import { McpAppResourceOutput, ToolsClientSchema, ToolsMethods, ToolsState } from "./types/scopes/tools.js";
-import { ToolDefinition, Toolkit } from "./model-context/toolbox.js";
+import { ToolDefinition, Toolkit, ToolkitDeclaration, ToolkitDeclarationDefinition } from "./model-context/toolbox.js";
 import { Tools } from "./client/Tools.js";
 import { InteractableDefinition, InteractablePersistedState, InteractablePersistenceAdapter, InteractablePersistenceStatus, InteractableRegistration, InteractableStateSchema, InteractablesClientSchema, InteractablesMethods, InteractablesState } from "./types/scopes/interactables.js";
 import { AssistantToolProps, useAssistantTool } from "./model-context/useAssistantTool.js";
@@ -39,6 +39,7 @@ import { QueueItemByIndexProvider, QueueItemByIndexProviderProps } from "./provi
 import { ReadonlyThreadProvider } from "./providers/ReadonlyThreadProvider.js";
 import { RuntimeAdapterProvider, RuntimeAdapters, useRuntimeAdapters } from "./runtimes/RuntimeAdapterProvider.js";
 import { useExternalStoreRuntime } from "./runtimes/useExternalStoreRuntime.js";
+import { useExternalStoreSharedOptions } from "./runtimes/useExternalStoreSharedOptions.js";
 import { convertExternalMessages, useExternalMessageConverter } from "./runtimes/external-message-converter.js";
 import { createMessageConverter } from "./runtimes/createMessageConverter.js";
 import { RemoteThreadListHookInstanceManager } from "./runtimes/RemoteThreadListHookInstanceManager.js";
@@ -50,8 +51,8 @@ import { CloudFileAttachmentAdapter } from "./runtimes/cloud/CloudFileAttachment
 import { PartState } from "../store/scopes/part.js";
 import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl } from "./primitives/thread/ThreadMessages.js";
 import { EnrichedPartState, MessagePartComponent, MessagePrimitivePartByIndex, MessagePrimitiveParts, defaultComponents } from "./primitives/message/MessageParts.js";
+import { GroupByContext, groupPartByType } from "./utils/groupParts.js";
 import { MessagePrimitiveGroupedParts } from "./primitives/message/MessageGroupedParts.js";
-import { groupPartByType } from "./utils/groupParts.js";
 import { GenerativeUIRender, GenerativeUIRenderError, MessagePrimitiveGenerativeUI } from "./primitives/generativeUI/GenerativeUI.js";
 import { MessagePrimitiveQuote } from "./primitives/message/MessageQuote.js";
 import { MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments } from "./primitives/message/MessageAttachments.js";
@@ -94,4 +95,4 @@ import { useEditComposerCancel } from "./primitive-hooks/useEditComposerCancel.j
 import { useEditComposerSend } from "./primitive-hooks/useEditComposerSend.js";
 import { useMessageError } from "./primitive-hooks/useMessageError.js";
 import { LocalRuntimeOptions, splitLocalRuntimeOptions, useLocalRuntime } from "./runtimes/useLocalRuntime.js";
-export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type LocalRuntimeOptions, type McpAppResourceOutput, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolDefinition, type Toolkit, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, getMessageQuote, getRenderComponent, groupPartByType, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, splitLocalRuntimeOptions, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };
+export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type GroupByContext, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type LocalRuntimeOptions, type McpAppResourceOutput, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolDefinition, type Toolkit, type ToolkitDeclaration, type ToolkitDeclarationDefinition, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, getMessageQuote, getRenderComponent, groupPartByType, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, splitLocalRuntimeOptions, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };