@ulearning/ai-sdk-adapter 0.0.0-stage → 1.0.0-next.0

package/dist/converters/toCreateMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toCreateMessage.js","names":[],"sources":["../../src/converters/toCreateMessage.ts"],"sourcesContent":["import type { AppendMessage } from \"@ulearning/ai-core\";\nimport {\n  resolveFileMediaType,\n  resolveFilePartSource,\n  resolveImageMediaType,\n  toMediaWireUrl,\n} from \"@ulearning/ai-core/internal\";\nimport type {\n  CreateUIMessage,\n  UIDataTypes,\n  UIMessage,\n  UIMessagePart,\n  UITools,\n} from \"ai\";\n\ntype InputPart = AppendMessage[\"content\"][number] & {\n  readonly contentType?: string | undefined;\n  readonly filename?: string | undefined;\n};\n\nexport const toCreateMessage = <UI_MESSAGE extends UIMessage = UIMessage>(\n  message: AppendMessage,\n): CreateUIMessage<UI_MESSAGE> => {\n  const inputParts: InputPart[] = [\n    ...message.content,\n    ...(message.attachments?.flatMap((a) =>\n      a.content.map((c) => ({\n        ...c,\n        filename: a.name,\n        contentType: a.contentType,\n      })),\n    ) ?? []),\n  ];\n\n  const parts = inputParts.map((part): UIMessagePart<UIDataTypes, UITools> => {\n    switch (part.type) {\n      case \"text\":\n        return {\n          type: \"text\",\n          text: part.text,\n          ...(part.providerMetadata != null && {\n            providerMetadata: part.providerMetadata,\n          }),\n        };\n      case \"image\": {\n        const mediaType = resolveImageMediaType(part.image, part.contentType);\n        return {\n          type: \"file\",\n          url: toMediaWireUrl(part.image, mediaType),\n          ...(part.filename && { filename: part.filename }),\n          mediaType,\n          ...(part.providerMetadata != null && {\n            providerMetadata: part.providerMetadata,\n          }),\n        };\n      }\n      case \"file\": {\n        // `mimeType` is a plain string, and an adapter reading `file.type` on a\n        // file the OS cannot type yields \"\". Same ladder as images: declared,\n        // then the envelope, then the floor.\n        const mediaType = resolveFileMediaType(part.data, part.mimeType);\n        return {\n          type: \"file\",\n          // An `id` reference is an opaque provider handle, not base64, and\n          // this adapter has no way to send one. Left unwrapped so it fails\n          // loudly upstream rather than shipping a corrupt payload.\n          url:\n            part.sourceType === \"id\"\n              ? part.data\n              : toMediaWireUrl(part.data, mediaType),\n          mediaType,\n          ...(part.filename && { filename: part.filename }),\n          ...(part.providerMetadata != null && {\n            providerMetadata: part.providerMetadata,\n          }),\n        };\n      }\n      case \"audio\": {\n        // A data URL's own media type wins over `mediaType` downstream, so the\n        // envelope is rebuilt from the typed format rather than forwarded.\n        const mediaType = `audio/${part.audio.format}`;\n        const data = part.audio.data;\n        const source = resolveFilePartSource({ data, mimeType: mediaType });\n        return {\n          type: \"file\",\n          url:\n            source.kind === \"url\"\n              ? source.url\n              : `data:${mediaType};base64,${source.data}`,\n          mediaType,\n          ...(part.filename && { filename: part.filename }),\n        };\n      }\n      case \"data\":\n        return {\n          type: `data-${part.name}`,\n          data: part.data,\n          ...(part.id !== undefined && { id: part.id }),\n        };\n      default:\n        throw new Error(`Unsupported part type: ${part.type}`);\n    }\n  });\n\n  return {\n    role: message.role,\n    parts,\n    metadata: message.metadata,\n  } satisfies CreateUIMessage<UIMessage> as CreateUIMessage<UI_MESSAGE>;\n};\n"],"mappings":";;AAoBA,MAAa,mBACX,YACgC;CAYhC,MAAM,QAAQ,CAVZ,GAAG,QAAQ,SACX,GAAI,QAAQ,aAAa,SAAS,MAChC,EAAE,QAAQ,KAAK,OAAO;EACpB,GAAG;EACH,UAAU,EAAE;EACZ,aAAa,EAAE;CACjB,EAAE,CACJ,KAAK,CAAC,CAGe,CAAC,CAAC,KAAK,SAA8C;EAC1E,QAAQ,KAAK,MAAb;GACE,KAAK,QACH,OAAO;IACL,MAAM;IACN,MAAM,KAAK;IACX,GAAI,KAAK,oBAAoB,QAAQ,EACnC,kBAAkB,KAAK,iBACzB;GACF;GACF,KAAK,SAAS;IACZ,MAAM,YAAY,sBAAsB,KAAK,OAAO,KAAK,WAAW;IACpE,OAAO;KACL,MAAM;KACN,KAAK,eAAe,KAAK,OAAO,SAAS;KACzC,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAS;KAC/C;KACA,GAAI,KAAK,oBAAoB,QAAQ,EACnC,kBAAkB,KAAK,iBACzB;IACF;GACF;GACA,KAAK,QAAQ;IAIX,MAAM,YAAY,qBAAqB,KAAK,MAAM,KAAK,QAAQ;IAC/D,OAAO;KACL,MAAM;KAIN,KACE,KAAK,eAAe,OAChB,KAAK,OACL,eAAe,KAAK,MAAM,SAAS;KACzC;KACA,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAS;KAC/C,GAAI,KAAK,oBAAoB,QAAQ,EACnC,kBAAkB,KAAK,iBACzB;IACF;GACF;GACA,KAAK,SAAS;IAGZ,MAAM,YAAY,SAAS,KAAK,MAAM;IACtC,MAAM,OAAO,KAAK,MAAM;IACxB,MAAM,SAAS,sBAAsB;KAAE;KAAM,UAAU;IAAU,CAAC;IAClE,OAAO;KACL,MAAM;KACN,KACE,OAAO,SAAS,QACZ,OAAO,MACP,QAAQ,UAAU,UAAU,OAAO;KACzC;KACA,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAS;IACjD;GACF;GACA,KAAK,QACH,OAAO;IACL,MAAM,QAAQ,KAAK;IACnB,MAAM,KAAK;IACX,GAAI,KAAK,OAAO,KAAA,KAAa,EAAE,IAAI,KAAK,GAAG;GAC7C;GACF,SACE,MAAM,IAAI,MAAM,0BAA0B,KAAK,MAAM;EACzD;CACF,CAAC;CAED,OAAO;EACL,MAAM,QAAQ;EACd;EACA,UAAU,QAAQ;CACpB;AACF"}

package/dist/converters/toolApprovalAnswers.d.ts

@@ -0,0 +1,3 @@
+import type { ToolApprovalAnswer } from "@ulearning/ai-core";
+export declare const normalizeToolApprovalAnswers: (answers: unknown) => Readonly<Record<string, ToolApprovalAnswer>> | undefined;
+//# sourceMappingURL=toolApprovalAnswers.d.ts.map

package/dist/converters/toolApprovalAnswers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolApprovalAnswers.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB;AAE5D,eAAO,MAAM,4BAA4B,GACvC,SAAS,OAAO,KACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GAAG,SAsBjD","names":[],"ignoreList":[],"sources":["../../src/converters/toolApprovalAnswers.ts"],"sourcesContent":[null]}

package/dist/converters/toolApprovalAnswers.js

@@ -0,0 +1,16 @@
+// src/converters/toolApprovalAnswers.ts
+const normalizeToolApprovalAnswers = (answers) => {
+	if (!answers || typeof answers !== "object" || Array.isArray(answers)) return void 0;
+	return Object.fromEntries(Object.entries(answers).flatMap(([id, value]) => {
+		if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+		const { optionIds, text } = value;
+		const answer = {
+			...Array.isArray(optionIds) && { optionIds: optionIds.filter((optionId) => typeof optionId === "string") },
+			...typeof text === "string" && { text }
+		};
+		return answer.optionIds?.length || answer.text !== void 0 ? [[id, answer]] : [];
+	}));
+};
+export { normalizeToolApprovalAnswers };
+
+//# sourceMappingURL=toolApprovalAnswers.js.map

package/dist/converters/toolApprovalAnswers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolApprovalAnswers.js","names":[],"sources":["../../src/converters/toolApprovalAnswers.ts"],"sourcesContent":["import type { ToolApprovalAnswer } from \"@ulearning/ai-core\";\n\nexport const normalizeToolApprovalAnswers = (\n  answers: unknown,\n): Readonly<Record<string, ToolApprovalAnswer>> | undefined => {\n  if (!answers || typeof answers !== \"object\" || Array.isArray(answers))\n    return undefined;\n\n  return Object.fromEntries(\n    Object.entries(answers).flatMap(([id, value]) => {\n      if (!value || typeof value !== \"object\" || Array.isArray(value))\n        return [];\n      const { optionIds, text } = value as Record<string, unknown>;\n      const answer: ToolApprovalAnswer = {\n        ...(Array.isArray(optionIds) && {\n          optionIds: optionIds.filter(\n            (optionId): optionId is string => typeof optionId === \"string\",\n          ),\n        }),\n        ...(typeof text === \"string\" && { text }),\n      };\n      return answer.optionIds?.length || answer.text !== undefined\n        ? [[id, answer]]\n        : [];\n    }),\n  );\n};\n"],"mappings":";AAEA,MAAa,gCACX,YAC6D;CAC7D,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAClE,OAAO,KAAA;CAET,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,WAAW;EAC/C,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAC5D,OAAO,CAAC;EACV,MAAM,EAAE,WAAW,SAAS;EAC5B,MAAM,SAA6B;GACjC,GAAI,MAAM,QAAQ,SAAS,KAAK,EAC9B,WAAW,UAAU,QAClB,aAAiC,OAAO,aAAa,QACxD,EACF;GACA,GAAI,OAAO,SAAS,YAAY,EAAE,KAAK;EACzC;EACA,OAAO,OAAO,WAAW,UAAU,OAAO,SAAS,KAAA,IAC/C,CAAC,CAAC,IAAI,MAAM,CAAC,IACb,CAAC;CACP,CAAC,CACH;AACF"}

package/dist/hooks.d.ts

@@ -0,0 +1,17 @@
+import type { ShallowRef } from "vue";
+import type { UIMessage } from "ai";
+import { type AISDKChatHelpers } from "./aiSDKExtras.js";
+/**
+ * Read the last AI SDK chat error object from the runtime extras.
+ * The readonly Ref contains `undefined` when there is no error or the current thread is not backed by
+ * the AI SDK runtime.
+ */
+export declare const useAISDKError: () => Readonly<ShallowRef<Error | undefined>>;
+/**
+ * The underlying `useChat` helpers object, for advanced views — reach
+ * `resumeStream`, `clearError`, or the raw `sendMessage` without forking the
+ * runtime hook. Read `.value`; it is `undefined` when the thread is not backed by the AI
+ * SDK runtime.
+ */
+export declare const useAISDKChat: <UI_MESSAGE extends UIMessage = UIMessage>() => Readonly<ShallowRef<AISDKChatHelpers<UI_MESSAGE> | undefined>>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AACnC,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,kBAAe;AAElE;;;;;AAKA,eAAO,MAAM,aAAa,+CAAmD;AAE7E;;;;;;AAMA,eAAO,MAAM,YAAY,GACvB,UAAU,SAAS,SAAS,GAAG,SAAS,OACrC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAI/D","names":[],"ignoreList":[],"sources":["../src/hooks.ts"],"sourcesContent":[null]}

package/dist/hooks.js

@@ -0,0 +1,19 @@
+"use client";
+import { aiSDKExtras } from "./aiSDKExtras.js";
+// src/hooks.ts
+/**
+* Read the last AI SDK chat error object from the runtime extras.
+* The readonly Ref contains `undefined` when there is no error or the current thread is not backed by
+* the AI SDK runtime.
+*/
+const useAISDKError = () => aiSDKExtras.use((e) => e.error, void 0);
+/**
+* The underlying `useChat` helpers object, for advanced views — reach
+* `resumeStream`, `clearError`, or the raw `sendMessage` without forking the
+* runtime hook. Read `.value`; it is `undefined` when the thread is not backed by the AI
+* SDK runtime.
+*/
+const useAISDKChat = () => aiSDKExtras.use((e) => e.chat, void 0);
+export { useAISDKChat, useAISDKError };
+
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks.ts"],"sourcesContent":["\"use client\";\n\nimport type { ShallowRef } from \"vue\";\nimport type { UIMessage } from \"ai\";\nimport { aiSDKExtras, type AISDKChatHelpers } from \"./aiSDKExtras\";\n\n/**\n * Read the last AI SDK chat error object from the runtime extras.\n * The readonly Ref contains `undefined` when there is no error or the current thread is not backed by\n * the AI SDK runtime.\n */\nexport const useAISDKError = () => aiSDKExtras.use((e) => e.error, undefined);\n\n/**\n * The underlying `useChat` helpers object, for advanced views — reach\n * `resumeStream`, `clearError`, or the raw `sendMessage` without forking the\n * runtime hook. Read `.value`; it is `undefined` when the thread is not backed by the AI\n * SDK runtime.\n */\nexport const useAISDKChat = <\n  UI_MESSAGE extends UIMessage = UIMessage,\n>(): Readonly<ShallowRef<AISDKChatHelpers<UI_MESSAGE> | undefined>> =>\n  aiSDKExtras.use(\n    (e) => e.chat as unknown as AISDKChatHelpers<UI_MESSAGE>,\n    undefined,\n  );\n"],"mappings":";;;;;;;;AAWA,MAAa,sBAAsB,YAAY,KAAK,MAAM,EAAE,OAAO,KAAA,CAAS;;;;;;;AAQ5E,MAAa,qBAGX,YAAY,KACT,MAAM,EAAE,MACT,KAAA,CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="@ulearning/ai-core/vue" preserve="true" />
+export { useAISDKRuntime } from "./runtime/useAISDKRuntime.js";
+export { useChatRuntime } from "./runtime/useChatRuntime.js";
+export type { UseChatRuntimeOptions } from "./runtime/useChatRuntime.js";
+export { AssistantChatTransport } from "./transport/AssistantChatTransport.js";
+export { RESUMABLE_STREAM_ID_HEADER, createResumableSessionStorage, } from "./transport/resumable.js";
+export type { AssistantChatResumableOptions, ResumableClientStorage, } from "./transport/resumable.js";
+export { frontendTools, type FrontendTools } from "@ulearning/ai-stream/ai-sdk";
+export { injectQuoteContext } from "./model-context/injectQuoteContext.js";
+export { unstable_injectInteractableContext } from "./model-context/injectInteractableContext.js";
+export type { ThreadTokenUsage, TokenUsageExtractableMessage } from "./usage.js";
+export { getThreadMessageTokenUsage, useThreadTokenUsage } from "./usage.js";
+export { useAISDKChat, useAISDKError } from "./hooks.js";
+export { AISDKToolkit, generativeTools, type AISDKToolkitOptions, type AISDKToolkitToolsOptions, type GenerativeToolsOptions, } from "./tools/generativeTools.js";
+export { AISDKChat, type AISDKChatOptions } from "./runtime/AISDKChat.js";
+export { AISDKThreads, type AISDKThreadsOptions } from "./runtime/AISDKThreads.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA2B;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA0B;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA0B;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAoC;AAC3E,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,0BAAuB;AAC9B,YAAY,EACV,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,0BAAuB;AAC9B,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAoC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,8CAA2C;AAC9F,YAAY,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,YAAS;AAC7E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,YAAS;AACzE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAS;AACrD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,4BAAyB;AAChC,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAqB;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAAwB","names":[],"ignoreList":[],"sources":["../src/index.ts"],"sourcesContent":[null]}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { useAISDKChat, useAISDKError } from "./hooks.js";
+import { useAISDKRuntime } from "./runtime/useAISDKRuntime.js";
+import { RESUMABLE_STREAM_ID_HEADER, createResumableSessionStorage } from "./transport/resumable.js";
+import { AssistantChatTransport } from "./transport/AssistantChatTransport.js";
+import { useChatRuntime } from "./runtime/useChatRuntime.js";
+import { injectQuoteContext } from "./model-context/injectQuoteContext.js";
+import { unstable_injectInteractableContext } from "./model-context/injectInteractableContext.js";
+import { getThreadMessageTokenUsage, useThreadTokenUsage } from "./usage.js";
+import { AISDKToolkit, generativeTools } from "./tools/generativeTools.js";
+import { AISDKChat } from "./runtime/AISDKChat.js";
+import { AISDKThreads } from "./runtime/AISDKThreads.js";
+import { frontendTools } from "@ulearning/ai-stream/ai-sdk";
+export { AISDKChat, AISDKThreads, AISDKToolkit, AssistantChatTransport, RESUMABLE_STREAM_ID_HEADER, createResumableSessionStorage, frontendTools, generativeTools, getThreadMessageTokenUsage, injectQuoteContext, unstable_injectInteractableContext, useAISDKChat, useAISDKError, useAISDKRuntime, useChatRuntime, useThreadTokenUsage };

package/dist/model-context/injectInteractableContext.d.ts

@@ -0,0 +1,37 @@
+import type { UIMessage } from "ai";
+import { type Unstable_InteractableSnapshotEntry } from "@ulearning/ai-core";
+/**
+ * Injects interactable state snapshots into messages as model-visible text.
+ *
+ * Mirrors {@link injectQuoteContext}: reads the frozen snapshot stamped on a user
+ * message's `metadata.custom.interactables` (by the interactables scope at send
+ * time) and prepends a text part. Run this in your route handler before
+ * `convertToModelMessages`, which otherwise ignores `metadata.custom`.
+ *
+ * Wording is consumer-owned — pass `format` to control how each snapshot reads.
+ * A snapshot may originate from a user edit or an agent `update_*` call, so the
+ * default phrasing is neutral. Keep the instance id visible in custom wording:
+ * the model needs it to address the `update_*` tool's `id` parameter. A custom
+ * `format` must also handle entries with `partial: true`, whose `state` carries
+ * only the fields that changed since the model's last known state.
+ *
+ * @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+ *
+ * @example
+ * ```ts
+ * import { convertToModelMessages, streamText } from "ai";
+ * import { unstable_injectInteractableContext } from "@ulearning/ai-sdk-adapter";
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *   const result = streamText({
+ *     abortSignal: req.signal,
+ *     model: myModel,
+ *     messages: await convertToModelMessages(unstable_injectInteractableContext(messages)),
+ *   });
+ *   return result.toUIMessageStreamResponse();
+ * }
+ * ```
+ */
+export declare function unstable_injectInteractableContext(messages: UIMessage[], format?: (item: Unstable_InteractableSnapshotEntry) => string): UIMessage[];
+//# sourceMappingURL=injectInteractableContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injectInteractableContext.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AACnC,OAAO,EAGL,KAAK,kCAAkC,EACxC,MAAM,oBAAoB;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,GAAE,CACN,IAAI,EAAE,kCAAkC,KACrC,MAA4C,GAChD,SAAS,EAAE","names":[],"ignoreList":[],"sources":["../../src/model-context/injectInteractableContext.ts"],"sourcesContent":[null]}

package/dist/model-context/injectInteractableContext.js

@@ -0,0 +1,54 @@
+import { unstable_formatInteractableSnapshot, unstable_getInteractableSnapshots } from "@ulearning/ai-core";
+// src/model-context/injectInteractableContext.ts
+/**
+* Injects interactable state snapshots into messages as model-visible text.
+*
+* Mirrors {@link injectQuoteContext}: reads the frozen snapshot stamped on a user
+* message's `metadata.custom.interactables` (by the interactables scope at send
+* time) and prepends a text part. Run this in your route handler before
+* `convertToModelMessages`, which otherwise ignores `metadata.custom`.
+*
+* Wording is consumer-owned — pass `format` to control how each snapshot reads.
+* A snapshot may originate from a user edit or an agent `update_*` call, so the
+* default phrasing is neutral. Keep the instance id visible in custom wording:
+* the model needs it to address the `update_*` tool's `id` parameter. A custom
+* `format` must also handle entries with `partial: true`, whose `state` carries
+* only the fields that changed since the model's last known state.
+*
+* @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
+*
+* @example
+* ```ts
+* import { convertToModelMessages, streamText } from "ai";
+* import { unstable_injectInteractableContext } from "@ulearning/ai-sdk-adapter";
+*
+* export async function POST(req: Request) {
+*   const { messages } = await req.json();
+*   const result = streamText({
+*     abortSignal: req.signal,
+*     model: myModel,
+*     messages: await convertToModelMessages(unstable_injectInteractableContext(messages)),
+*   });
+*   return result.toUIMessageStreamResponse();
+* }
+* ```
+*/
+function unstable_injectInteractableContext(messages, format = unstable_formatInteractableSnapshot) {
+	return messages.map((msg) => {
+		if (msg.role !== "user") return msg;
+		const items = unstable_getInteractableSnapshots(msg);
+		if (!items?.length) return msg;
+		const text = `${items.map(format).join("\n")}\n\n`;
+		if (msg.parts?.[0]?.type === "text" && msg.parts[0].text === text) return msg;
+		return {
+			...msg,
+			parts: [{
+				type: "text",
+				text
+			}, ...msg.parts ?? []]
+		};
+	});
+}
+export { unstable_injectInteractableContext };
+
+//# sourceMappingURL=injectInteractableContext.js.map

package/dist/model-context/injectInteractableContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectInteractableContext.js","names":[],"sources":["../../src/model-context/injectInteractableContext.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\nimport {\n  unstable_formatInteractableSnapshot,\n  unstable_getInteractableSnapshots,\n  type Unstable_InteractableSnapshotEntry,\n} from \"@ulearning/ai-core\";\n\n/**\n * Injects interactable state snapshots into messages as model-visible text.\n *\n * Mirrors {@link injectQuoteContext}: reads the frozen snapshot stamped on a user\n * message's `metadata.custom.interactables` (by the interactables scope at send\n * time) and prepends a text part. Run this in your route handler before\n * `convertToModelMessages`, which otherwise ignores `metadata.custom`.\n *\n * Wording is consumer-owned — pass `format` to control how each snapshot reads.\n * A snapshot may originate from a user edit or an agent `update_*` call, so the\n * default phrasing is neutral. Keep the instance id visible in custom wording:\n * the model needs it to address the `update_*` tool's `id` parameter. A custom\n * `format` must also handle entries with `partial: true`, whose `state` carries\n * only the fields that changed since the model's last known state.\n *\n * @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.\n *\n * @example\n * ```ts\n * import { convertToModelMessages, streamText } from \"ai\";\n * import { unstable_injectInteractableContext } from \"@ulearning/ai-sdk-adapter\";\n *\n * export async function POST(req: Request) {\n *   const { messages } = await req.json();\n *   const result = streamText({\n *     abortSignal: req.signal,\n *     model: myModel,\n *     messages: await convertToModelMessages(unstable_injectInteractableContext(messages)),\n *   });\n *   return result.toUIMessageStreamResponse();\n * }\n * ```\n */\nexport function unstable_injectInteractableContext(\n  messages: UIMessage[],\n  format: (\n    item: Unstable_InteractableSnapshotEntry,\n  ) => string = unstable_formatInteractableSnapshot,\n): UIMessage[] {\n  return messages.map((msg) => {\n    if (msg.role !== \"user\") return msg;\n\n    const items = unstable_getInteractableSnapshots(msg);\n    if (!items?.length) return msg;\n\n    const text = `${items.map(format).join(\"\\n\")}\\n\\n`;\n\n    const alreadyInjected =\n      msg.parts?.[0]?.type === \"text\" && msg.parts[0].text === text;\n    if (alreadyInjected) return msg;\n\n    return {\n      ...msg,\n      parts: [{ type: \"text\" as const, text }, ...(msg.parts ?? [])],\n    };\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,mCACd,UACA,SAEc,qCACD;CACb,OAAO,SAAS,KAAK,QAAQ;EAC3B,IAAI,IAAI,SAAS,QAAQ,OAAO;EAEhC,MAAM,QAAQ,kCAAkC,GAAG;EACnD,IAAI,CAAC,OAAO,QAAQ,OAAO;EAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE;EAI7C,IADE,IAAI,QAAQ,EAAE,EAAE,SAAS,UAAU,IAAI,MAAM,EAAE,CAAC,SAAS,MACtC,OAAO;EAE5B,OAAO;GACL,GAAG;GACH,OAAO,CAAC;IAAE,MAAM;IAAiB;GAAK,GAAG,GAAI,IAAI,SAAS,CAAC,CAAE;EAC/D;CACF,CAAC;AACH"}

package/dist/model-context/injectQuoteContext.d.ts

@@ -0,0 +1,25 @@
+import type { UIMessage } from "ai";
+/**
+ * Injects quote context into messages as markdown blockquotes.
+ *
+ * Use this in your route handler before `convertToModelMessages` so the LLM
+ * sees the quoted text that the user is referring to.
+ *
+ * @example
+ * ```ts
+ * import { convertToModelMessages, streamText } from "ai";
+ * import { injectQuoteContext } from "@ulearning/ai-sdk-adapter";
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *   const result = streamText({
+ *     abortSignal: req.signal,
+ *     model: myModel,
+ *     messages: await convertToModelMessages(injectQuoteContext(messages)),
+ *   });
+ *   return result.toUIMessageStreamResponse();
+ * }
+ * ```
+ */
+export declare function injectQuoteContext(messages: UIMessage[]): UIMessage[];
+//# sourceMappingURL=injectQuoteContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injectQuoteContext.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AAenC;;;;;;;;;;;;;;;;;;;;;;AAsBA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE","names":[],"ignoreList":[],"sources":["../../src/model-context/injectQuoteContext.ts"],"sourcesContent":[null]}

package/dist/model-context/injectQuoteContext.js

@@ -0,0 +1,51 @@
+// src/model-context/injectQuoteContext.ts
+const getQuoteText = (metadata) => {
+	if (!metadata || typeof metadata !== "object") return void 0;
+	const custom = metadata.custom;
+	if (!custom || typeof custom !== "object") return void 0;
+	const quote = custom.quote;
+	if (!quote || typeof quote !== "object") return void 0;
+	const text = quote.text;
+	return typeof text === "string" ? text : void 0;
+};
+/**
+* Injects quote context into messages as markdown blockquotes.
+*
+* Use this in your route handler before `convertToModelMessages` so the LLM
+* sees the quoted text that the user is referring to.
+*
+* @example
+* ```ts
+* import { convertToModelMessages, streamText } from "ai";
+* import { injectQuoteContext } from "@ulearning/ai-sdk-adapter";
+*
+* export async function POST(req: Request) {
+*   const { messages } = await req.json();
+*   const result = streamText({
+*     abortSignal: req.signal,
+*     model: myModel,
+*     messages: await convertToModelMessages(injectQuoteContext(messages)),
+*   });
+*   return result.toUIMessageStreamResponse();
+* }
+* ```
+*/
+function injectQuoteContext(messages) {
+	return messages.map((msg) => {
+		if (msg.role !== "user") return msg;
+		const text = getQuoteText(msg.metadata);
+		if (!text) return msg;
+		const blockquote = text.split(/\r?\n/).map((line) => `> ${line}`).join("\n");
+		if (msg.parts?.[0]?.type === "text" && msg.parts[0].text === `${blockquote}\n\n`) return msg;
+		return {
+			...msg,
+			parts: [{
+				type: "text",
+				text: `${blockquote}\n\n`
+			}, ...msg.parts ?? []]
+		};
+	});
+}
+export { injectQuoteContext };
+
+//# sourceMappingURL=injectQuoteContext.js.map

package/dist/model-context/injectQuoteContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectQuoteContext.js","names":[],"sources":["../../src/model-context/injectQuoteContext.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\n\nconst getQuoteText = (metadata: unknown): string | undefined => {\n  if (!metadata || typeof metadata !== \"object\") return undefined;\n\n  const custom = (metadata as Record<string, unknown>).custom;\n  if (!custom || typeof custom !== \"object\") return undefined;\n\n  const quote = (custom as Record<string, unknown>).quote;\n  if (!quote || typeof quote !== \"object\") return undefined;\n\n  const text = (quote as Record<string, unknown>).text;\n  return typeof text === \"string\" ? text : undefined;\n};\n\n/**\n * Injects quote context into messages as markdown blockquotes.\n *\n * Use this in your route handler before `convertToModelMessages` so the LLM\n * sees the quoted text that the user is referring to.\n *\n * @example\n * ```ts\n * import { convertToModelMessages, streamText } from \"ai\";\n * import { injectQuoteContext } from \"@ulearning/ai-sdk-adapter\";\n *\n * export async function POST(req: Request) {\n *   const { messages } = await req.json();\n *   const result = streamText({\n *     abortSignal: req.signal,\n *     model: myModel,\n *     messages: await convertToModelMessages(injectQuoteContext(messages)),\n *   });\n *   return result.toUIMessageStreamResponse();\n * }\n * ```\n */\nexport function injectQuoteContext(messages: UIMessage[]): UIMessage[] {\n  return messages.map((msg) => {\n    if (msg.role !== \"user\") return msg;\n\n    const text = getQuoteText(msg.metadata);\n    if (!text) return msg;\n\n    const blockquote = text\n      .split(/\\r?\\n/)\n      .map((line) => `> ${line}`)\n      .join(\"\\n\");\n\n    const alreadyInjected =\n      msg.parts?.[0]?.type === \"text\" &&\n      msg.parts[0].text === `${blockquote}\\n\\n`;\n    if (alreadyInjected) return msg;\n\n    return {\n      ...msg,\n      parts: [\n        { type: \"text\" as const, text: `${blockquote}\\n\\n` },\n        ...(msg.parts ?? []),\n      ],\n    };\n  });\n}\n"],"mappings":";AAEA,MAAM,gBAAgB,aAA0C;CAC9D,IAAI,CAAC,YAAY,OAAO,aAAa,UAAU,OAAO,KAAA;CAEtD,MAAM,SAAU,SAAqC;CACrD,IAAI,CAAC,UAAU,OAAO,WAAW,UAAU,OAAO,KAAA;CAElD,MAAM,QAAS,OAAmC;CAClD,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO,KAAA;CAEhD,MAAM,OAAQ,MAAkC;CAChD,OAAO,OAAO,SAAS,WAAW,OAAO,KAAA;AAC3C;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,mBAAmB,UAAoC;CACrE,OAAO,SAAS,KAAK,QAAQ;EAC3B,IAAI,IAAI,SAAS,QAAQ,OAAO;EAEhC,MAAM,OAAO,aAAa,IAAI,QAAQ;EACtC,IAAI,CAAC,MAAM,OAAO;EAElB,MAAM,aAAa,KAChB,MAAM,OAAO,CAAC,CACd,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,KAAK,IAAI;EAKZ,IAFE,IAAI,QAAQ,EAAE,EAAE,SAAS,UACzB,IAAI,MAAM,EAAE,CAAC,SAAS,GAAG,WAAW,OACjB,OAAO;EAE5B,OAAO;GACL,GAAG;GACH,OAAO,CACL;IAAE,MAAM;IAAiB,MAAM,GAAG,WAAW;GAAM,GACnD,GAAI,IAAI,SAAS,CAAC,CACpB;EACF;CACF,CAAC;AACH"}

package/dist/runtime/AISDKChat.d.ts

@@ -0,0 +1,13 @@
+import type { UIMessage } from "ai";
+import { type ChatThreadOptions } from "./useChatThread.js";
+export type AISDKChatOptions<UI_MESSAGE extends UIMessage = UIMessage> = ChatThreadOptions<UI_MESSAGE>;
+/**
+ * `AuiConfig` entry that runs the AI SDK chat as the `threads` scope. Hosts the
+ * same orchestration as `useChatRuntime` inside the client's own resource tree,
+ * so it works with any `AssistantClient` host, React or not. Single thread; the
+ * multi-thread surface is {@link AISDKThreads}. The chat
+ * id is captured when the entry mounts, so a later `id` change in the options
+ * has no effect.
+ */
+export declare const AISDKChat: <UI_MESSAGE extends UIMessage = UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>(options?: AISDKChatOptions<UI_MESSAGE> | undefined) => import("@ulearning/ai-tap").ResourceElement<import("@ulearning/ai-store").ClientOutput<"threads">>;
+//# sourceMappingURL=AISDKChat.d.ts.map

package/dist/runtime/AISDKChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISDKChat.d.ts","mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AAMnC,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,oBAAiB;AAEvE,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IACnE,iBAAiB,CAAC,UAAU,CAAC;AAkB/B;;;;;;;;AAQA,eAAO,MAAM,SAAS,GAxBA,UAAU,SAAS,SAAS,gOAwBH","names":[],"ignoreList":[],"sources":["../../src/runtime/AISDKChat.ts"],"sourcesContent":[null]}

package/dist/runtime/AISDKChat.js

@@ -0,0 +1,34 @@
+"use client";
+import { useChatThread } from "./useChatThread.js";
+import { generateId } from "ai";
+import { resource, useResource, useState } from "@ulearning/ai-tap";
+import { RuntimeAdapter, runtimeAdapterTransformScopes } from "@ulearning/ai-core/store";
+import { attachTransformScopes } from "@ulearning/ai-store/client";
+// src/runtime/AISDKChat.ts
+const useAISDKChat = (options) => {
+	const [id] = useState(() => options?.id ?? generateId());
+	const [threadListItem] = useState(() => ({ initialize: async () => ({
+		remoteId: id,
+		externalId: void 0
+	}) }));
+	const runtime = useChatThread(options, {
+		id,
+		isMainThread: true,
+		getThreadListItem: () => threadListItem,
+		stopOnClientDestroy: true
+	});
+	return useResource(RuntimeAdapter(runtime));
+};
+/**
+* `AuiConfig` entry that runs the AI SDK chat as the `threads` scope. Hosts the
+* same orchestration as `useChatRuntime` inside the client's own resource tree,
+* so it works with any `AssistantClient` host, React or not. Single thread; the
+* multi-thread surface is {@link AISDKThreads}. The chat
+* id is captured when the entry mounts, so a later `id` change in the options
+* has no effect.
+*/
+const AISDKChat = resource(useAISDKChat);
+attachTransformScopes(useAISDKChat, runtimeAdapterTransformScopes);
+export { AISDKChat };
+
+//# sourceMappingURL=AISDKChat.js.map

package/dist/runtime/AISDKChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISDKChat.js","names":[],"sources":["../../src/runtime/AISDKChat.ts"],"sourcesContent":["\"use client\";\n\nimport { resource, useResource } from \"@ulearning/ai-tap\";\nimport { useState } from \"@ulearning/ai-tap\";\nimport { generateId } from \"ai\";\nimport type { UIMessage } from \"ai\";\nimport {\n  RuntimeAdapter,\n  runtimeAdapterTransformScopes,\n} from \"@ulearning/ai-core/store\";\nimport { attachTransformScopes } from \"@ulearning/ai-store/client\";\nimport { useChatThread, type ChatThreadOptions } from \"./useChatThread\";\n\nexport type AISDKChatOptions<UI_MESSAGE extends UIMessage = UIMessage> =\n  ChatThreadOptions<UI_MESSAGE>;\n\nconst useAISDKChat = <UI_MESSAGE extends UIMessage = UIMessage>(\n  options?: AISDKChatOptions<UI_MESSAGE>,\n) => {\n  const [id] = useState(() => options?.id ?? generateId());\n  const [threadListItem] = useState(() => ({\n    initialize: async () => ({ remoteId: id, externalId: undefined }),\n  }));\n  const runtime = useChatThread(options, {\n    id,\n    isMainThread: true,\n    getThreadListItem: () => threadListItem,\n    stopOnClientDestroy: true,\n  });\n  return useResource(RuntimeAdapter(runtime));\n};\n\n/**\n * `AuiConfig` entry that runs the AI SDK chat as the `threads` scope. Hosts the\n * same orchestration as `useChatRuntime` inside the client's own resource tree,\n * so it works with any `AssistantClient` host, React or not. Single thread; the\n * multi-thread surface is {@link AISDKThreads}. The chat\n * id is captured when the entry mounts, so a later `id` change in the options\n * has no effect.\n */\nexport const AISDKChat = resource(useAISDKChat);\n\nattachTransformScopes(useAISDKChat, runtimeAdapterTransformScopes);\n"],"mappings":";;;;;;;AAgBA,MAAM,gBACJ,YACG;CACH,MAAM,CAAC,MAAM,eAAe,SAAS,MAAM,WAAW,CAAC;CACvD,MAAM,CAAC,kBAAkB,gBAAgB,EACvC,YAAY,aAAa;EAAE,UAAU;EAAI,YAAY,KAAA;CAAU,GACjE,EAAE;CACF,MAAM,UAAU,cAAc,SAAS;EACrC;EACA,cAAc;EACd,yBAAyB;EACzB,qBAAqB;CACvB,CAAC;CACD,OAAO,YAAY,eAAe,OAAO,CAAC;AAC5C;;;;;;;;;AAUA,MAAa,YAAY,SAAS,YAAY;AAE9C,sBAAsB,cAAc,6BAA6B"}

package/dist/runtime/AISDKThreads.d.ts

@@ -0,0 +1,24 @@
+import type { UIMessage } from "ai";
+import type { ChatTransport } from "ai";
+import { type ChatThreadOptions } from "./useChatThread.js";
+export type AISDKThreadsOptions<UI_MESSAGE extends UIMessage = UIMessage> = Omit<ChatThreadOptions<UI_MESSAGE>, "id" | "transport" | "messages"> & {
+    /**
+     * The transport threads send through. A factory is invoked once per
+     * thread so each thread owns its instance. A plain
+     * `AssistantChatTransport` instance is cloned per thread (its
+     * assistant-ui wiring is per thread); any other transport instance is
+     * shared as-is. Defaults to one `AssistantChatTransport` per thread.
+     */
+    transport?: ChatTransport<UI_MESSAGE> | (() => ChatTransport<UI_MESSAGE>) | undefined;
+};
+/**
+ * `AuiConfig` entry that runs one AI SDK chat per thread. Hosts the same
+ * per-thread orchestration as {@link AISDKChat} inside the client's own
+ * resource tree, so it works with any `AssistantClient` host, React or not.
+ * Threads live in memory for the client's lifetime and keep
+ * their history across switches; only the visible thread is mounted, and a
+ * switched-away chat keeps streaming into its stored state until it settles
+ * or the thread is deleted. Model context is registered on each mounted thread.
+ */
+export declare const AISDKThreads: <UI_MESSAGE extends UIMessage = UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>(options?: AISDKThreadsOptions<UI_MESSAGE> | undefined) => import("@ulearning/ai-tap").ResourceElement<import("@ulearning/ai-store").ClientOutput<"threads">>;
+//# sourceMappingURL=AISDKThreads.d.ts.map

package/dist/runtime/AISDKThreads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISDKThreads.d.ts","mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI;AAYvC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,oBAAiB;AAIxB,MAAM,MAAM,mBAAmB,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IACtE,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,UAAU,CAAC,GAAG;IACrE;;;;;;;IAOA,SAAS,CAAC,EACN,aAAa,CAAC,UAAU,CAAC,GACzB,CAAC,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC,GACjC,SAAS;CACd;AA8IH;;;;;;;;;AASA,eAAO,MAAM,YAAY,GAlDA,UAAU,SAAS,SAAS,mOAkDA","names":[],"ignoreList":[],"sources":["../../src/runtime/AISDKThreads.ts"],"sourcesContent":[null]}

package/dist/runtime/AISDKThreads.js

@@ -0,0 +1,92 @@
+"use client";
+import { AssistantChatTransport } from "../transport/AssistantChatTransport.js";
+import { useResourceCleanup } from "./useResourceCleanup.js";
+import { createChat, splitChatThreadOptions, useChatThread } from "./useChatThread.js";
+import { MessageRepository } from "@ulearning/ai-core/internal";
+import { resource, useEffect, useMemo, useResource, useState } from "@ulearning/ai-tap";
+import { InMemoryThreadList, inMemoryThreadListTransformScopes } from "@ulearning/ai-core/store";
+import { attachTransformScopes, useAssistantClientRef, useAssistantScopeEffect } from "@ulearning/ai-store/client";
+import { ThreadClient } from "@ulearning/ai-core/store/internal";
+// src/runtime/AISDKThreads.ts
+const createChatEntry = (threadId, options) => {
+	const optionsRef = { current: options };
+	const { chatInit } = splitChatThreadOptions(options);
+	const transport = typeof options?.transport === "function" ? options.transport() : options?.transport === void 0 ? new AssistantChatTransport() : options.transport instanceof AssistantChatTransport ? options.transport.__internal_clone() : options.transport;
+	return {
+		chat: createChat({
+			...chatInit,
+			id: threadId,
+			transport
+		}, optionsRef),
+		transport,
+		repository: new MessageRepository(),
+		optionsRef
+	};
+};
+const getOrCreateChatEntry = (threadId, options, chats) => {
+	const existing = chats.get(threadId);
+	if (existing) return existing;
+	const created = createChatEntry(threadId, options);
+	chats.set(threadId, created);
+	return created;
+};
+const useAISDKChatThread = ({ threadId, options, chats }) => {
+	const { chat, transport, repository } = getOrCreateChatEntry(threadId, options, chats);
+	const fallbackItem = useMemo(() => ({ initialize: async () => ({
+		remoteId: threadId,
+		externalId: void 0
+	}) }), [threadId]);
+	const runtime = useChatThread({
+		...options,
+		transport
+	}, {
+		id: threadId,
+		isMainThread: true,
+		getThreadListItem: () => fallbackItem,
+		chat,
+		messageRepositoryInstance: repository,
+		stopOnClientDestroy: false
+	});
+	const clientRef = useAssistantClientRef();
+	useAssistantScopeEffect("modelContext", () => runtime.registerModelContextProvider(clientRef.current.modelContext()), [runtime]);
+	return useResource(ThreadClient({ runtime: runtime.thread }));
+};
+const AISDKChatThread = resource(useAISDKChatThread);
+const useAISDKThreads = (options) => {
+	const threadOptions = options;
+	const [chats] = useState(() => /* @__PURE__ */ new Map());
+	useEffect(() => {
+		for (const { optionsRef } of chats.values()) optionsRef.current = threadOptions;
+	});
+	useResourceCleanup(true, () => {
+		for (const { chat } of chats.values()) chat.stop().catch(() => {});
+	});
+	const thread = (id) => {
+		return AISDKChatThread({
+			threadId: id,
+			options: threadOptions,
+			chats
+		});
+	};
+	return useResource(InMemoryThreadList({
+		thread,
+		onDelete: (id) => {
+			chats.get(id)?.chat.stop().catch(() => {});
+			chats.delete(id);
+		}
+	}));
+};
+/**
+* `AuiConfig` entry that runs one AI SDK chat per thread. Hosts the same
+* per-thread orchestration as {@link AISDKChat} inside the client's own
+* resource tree, so it works with any `AssistantClient` host, React or not.
+* Threads live in memory for the client's lifetime and keep
+* their history across switches; only the visible thread is mounted, and a
+* switched-away chat keeps streaming into its stored state until it settles
+* or the thread is deleted. Model context is registered on each mounted thread.
+*/
+const AISDKThreads = resource(useAISDKThreads);
+attachTransformScopes(useAISDKThreads, inMemoryThreadListTransformScopes);
+export { AISDKThreads };
+
+//# sourceMappingURL=AISDKThreads.js.map

package/dist/runtime/AISDKThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISDKThreads.js","names":[],"sources":["../../src/runtime/AISDKThreads.ts"],"sourcesContent":["\"use client\";\n\nimport { resource, useResource } from \"@ulearning/ai-tap\";\nimport { useEffect, useMemo, useState } from \"@ulearning/ai-tap\";\nimport type { Chat } from \"@ai-sdk/vue\";\nimport type { UIMessage } from \"ai\";\nimport type { ChatTransport } from \"ai\";\nimport {\n  InMemoryThreadList,\n  inMemoryThreadListTransformScopes,\n} from \"@ulearning/ai-core/store\";\nimport { ThreadClient } from \"@ulearning/ai-core/store/internal\";\nimport {\n  attachTransformScopes,\n  useAssistantClientRef,\n  useAssistantScopeEffect,\n} from \"@ulearning/ai-store/client\";\nimport { AssistantChatTransport } from \"../transport/AssistantChatTransport\";\nimport {\n  createChat,\n  splitChatThreadOptions,\n  useChatThread,\n  type ChatThreadOptions,\n} from \"./useChatThread\";\nimport { MessageRepository } from \"@ulearning/ai-core/internal\";\nimport { useResourceCleanup } from \"./useResourceCleanup\";\n\nexport type AISDKThreadsOptions<UI_MESSAGE extends UIMessage = UIMessage> =\n  Omit<ChatThreadOptions<UI_MESSAGE>, \"id\" | \"transport\" | \"messages\"> & {\n    /**\n     * The transport threads send through. A factory is invoked once per\n     * thread so each thread owns its instance. A plain\n     * `AssistantChatTransport` instance is cloned per thread (its\n     * assistant-ui wiring is per thread); any other transport instance is\n     * shared as-is. Defaults to one `AssistantChatTransport` per thread.\n     */\n    transport?:\n      | ChatTransport<UI_MESSAGE>\n      | (() => ChatTransport<UI_MESSAGE>)\n      | undefined;\n  };\n\ntype AISDKThreadChatOptions<UI_MESSAGE extends UIMessage = UIMessage> =\n  AISDKThreadsOptions<UI_MESSAGE>;\n\ntype ChatOptionsRef<UI_MESSAGE extends UIMessage> = {\n  current: AISDKThreadChatOptions<UI_MESSAGE> | undefined;\n};\n\ntype ChatEntry<UI_MESSAGE extends UIMessage> = {\n  chat: Chat<UI_MESSAGE>;\n  transport: ChatTransport<UI_MESSAGE>;\n  repository: MessageRepository;\n  optionsRef: ChatOptionsRef<UI_MESSAGE>;\n};\n\nconst createChatEntry = <UI_MESSAGE extends UIMessage>(\n  threadId: string,\n  options: AISDKThreadChatOptions<UI_MESSAGE> | undefined,\n): ChatEntry<UI_MESSAGE> => {\n  const optionsRef: ChatOptionsRef<UI_MESSAGE> = { current: options };\n  const { chatInit } = splitChatThreadOptions(\n    options as ChatThreadOptions<UI_MESSAGE> | undefined,\n  );\n  const transport =\n    typeof options?.transport === \"function\"\n      ? options.transport()\n      : options?.transport === undefined\n        ? new AssistantChatTransport()\n        : options.transport instanceof AssistantChatTransport\n          ? options.transport.__internal_clone()\n          : options.transport;\n  return {\n    chat: createChat({ ...chatInit, id: threadId, transport }, optionsRef),\n    transport,\n    repository: new MessageRepository(),\n    optionsRef,\n  };\n};\n\nconst getOrCreateChatEntry = <UI_MESSAGE extends UIMessage>(\n  threadId: string,\n  options: AISDKThreadChatOptions<UI_MESSAGE> | undefined,\n  chats: Map<string, ChatEntry<UI_MESSAGE>>,\n): ChatEntry<UI_MESSAGE> => {\n  const existing = chats.get(threadId);\n  if (existing) return existing;\n  const created = createChatEntry(threadId, options);\n  chats.set(threadId, created);\n  return created;\n};\n\nconst useAISDKChatThread = <UI_MESSAGE extends UIMessage = UIMessage>({\n  threadId,\n  options,\n  chats,\n}: {\n  threadId: string;\n  options: AISDKThreadChatOptions<UI_MESSAGE> | undefined;\n  chats: Map<string, ChatEntry<UI_MESSAGE>>;\n}) => {\n  const { chat, transport, repository } = getOrCreateChatEntry(\n    threadId,\n    options,\n    chats,\n  );\n\n  const fallbackItem = useMemo(\n    () => ({\n      initialize: async () => ({\n        remoteId: threadId,\n        externalId: undefined,\n      }),\n    }),\n    [threadId],\n  );\n  const runtime = useChatThread(\n    { ...options, transport } as ChatThreadOptions<UI_MESSAGE>,\n    {\n      id: threadId,\n      isMainThread: true,\n      getThreadListItem: () => fallbackItem,\n      chat,\n      messageRepositoryInstance: repository,\n      stopOnClientDestroy: false,\n    },\n  );\n\n  const clientRef = useAssistantClientRef();\n  useAssistantScopeEffect(\n    \"modelContext\",\n    () =>\n      runtime.registerModelContextProvider(clientRef.current!.modelContext()),\n    [runtime],\n  );\n\n  return useResource(ThreadClient({ runtime: runtime.thread }));\n};\n\nconst AISDKChatThread = resource(useAISDKChatThread);\n\nconst useAISDKThreads = <UI_MESSAGE extends UIMessage = UIMessage>(\n  options?: AISDKThreadsOptions<UI_MESSAGE>,\n) => {\n  const threadOptions = options;\n  const [chats] = useState(() => new Map<string, ChatEntry<UI_MESSAGE>>());\n\n  useEffect(() => {\n    for (const { optionsRef } of chats.values()) {\n      optionsRef.current = threadOptions;\n    }\n  });\n\n  useResourceCleanup(true, () => {\n    for (const { chat } of chats.values()) {\n      void chat.stop().catch(() => {});\n    }\n  });\n\n  const thread = (id: string) => {\n    const element = AISDKChatThread({\n      threadId: id,\n      options: threadOptions,\n      chats,\n    });\n    return element;\n  };\n\n  return useResource(\n    InMemoryThreadList({\n      thread,\n      onDelete: (id) => {\n        void chats\n          .get(id)\n          ?.chat.stop()\n          .catch(() => {});\n        chats.delete(id);\n      },\n    }),\n  );\n};\n\n/**\n * `AuiConfig` entry that runs one AI SDK chat per thread. Hosts the same\n * per-thread orchestration as {@link AISDKChat} inside the client's own\n * resource tree, so it works with any `AssistantClient` host, React or not.\n * Threads live in memory for the client's lifetime and keep\n * their history across switches; only the visible thread is mounted, and a\n * switched-away chat keeps streaming into its stored state until it settles\n * or the thread is deleted. Model context is registered on each mounted thread.\n */\nexport const AISDKThreads = resource(useAISDKThreads);\n\nattachTransformScopes(useAISDKThreads, inMemoryThreadListTransformScopes);\n"],"mappings":";;;;;;;;;;AAwDA,MAAM,mBACJ,UACA,YAC0B;CAC1B,MAAM,aAAyC,EAAE,SAAS,QAAQ;CAClE,MAAM,EAAE,aAAa,uBACnB,OACF;CACA,MAAM,YACJ,OAAO,SAAS,cAAc,aAC1B,QAAQ,UAAU,IAClB,SAAS,cAAc,KAAA,IACrB,IAAI,uBAAuB,IAC3B,QAAQ,qBAAqB,yBAC3B,QAAQ,UAAU,iBAAiB,IACnC,QAAQ;CAClB,OAAO;EACL,MAAM,WAAW;GAAE,GAAG;GAAU,IAAI;GAAU;EAAU,GAAG,UAAU;EACrE;EACA,YAAY,IAAI,kBAAkB;EAClC;CACF;AACF;AAEA,MAAM,wBACJ,UACA,SACA,UAC0B;CAC1B,MAAM,WAAW,MAAM,IAAI,QAAQ;CACnC,IAAI,UAAU,OAAO;CACrB,MAAM,UAAU,gBAAgB,UAAU,OAAO;CACjD,MAAM,IAAI,UAAU,OAAO;CAC3B,OAAO;AACT;AAEA,MAAM,sBAAgE,EACpE,UACA,SACA,YAKI;CACJ,MAAM,EAAE,MAAM,WAAW,eAAe,qBACtC,UACA,SACA,KACF;CAEA,MAAM,eAAe,eACZ,EACL,YAAY,aAAa;EACvB,UAAU;EACV,YAAY,KAAA;CACd,GACF,IACA,CAAC,QAAQ,CACX;CACA,MAAM,UAAU,cACd;EAAE,GAAG;EAAS;CAAU,GACxB;EACE,IAAI;EACJ,cAAc;EACd,yBAAyB;EACzB;EACA,2BAA2B;EAC3B,qBAAqB;CACvB,CACF;CAEA,MAAM,YAAY,sBAAsB;CACxC,wBACE,sBAEE,QAAQ,6BAA6B,UAAU,QAAS,aAAa,CAAC,GACxE,CAAC,OAAO,CACV;CAEA,OAAO,YAAY,aAAa,EAAE,SAAS,QAAQ,OAAO,CAAC,CAAC;AAC9D;AAEA,MAAM,kBAAkB,SAAS,kBAAkB;AAEnD,MAAM,mBACJ,YACG;CACH,MAAM,gBAAgB;CACtB,MAAM,CAAC,SAAS,+BAAe,IAAI,IAAmC,CAAC;CAEvE,gBAAgB;EACd,KAAK,MAAM,EAAE,gBAAgB,MAAM,OAAO,GACxC,WAAW,UAAU;CAEzB,CAAC;CAED,mBAAmB,YAAY;EAC7B,KAAK,MAAM,EAAE,UAAU,MAAM,OAAO,GAClC,KAAU,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CAEnC,CAAC;CAED,MAAM,UAAU,OAAe;EAM7B,OALgB,gBAAgB;GAC9B,UAAU;GACV,SAAS;GACT;EACF,CACa;CACf;CAEA,OAAO,YACL,mBAAmB;EACjB;EACA,WAAW,OAAO;GAChB,MACG,IAAI,EAAE,CAAC,EACN,KAAK,KAAK,CAAC,CACZ,YAAY,CAAC,CAAC;GACjB,MAAM,OAAO,EAAE;EACjB;CACF,CAAC,CACH;AACF;;;;;;;;;;AAWA,MAAa,eAAe,SAAS,eAAe;AAEpD,sBAAsB,iBAAiB,iCAAiC"}

package/dist/runtime/DynamicChatTransport.d.ts

@@ -0,0 +1,50 @@
+import type { AssistantRuntime } from "@ulearning/ai-core";
+import type { UIMessage } from "ai";
+import type { ChatTransport } from "ai";
+import { type InitializableThreadListItem } from "../transport/AssistantChatTransport.js";
+import type { ResumableClientStorage } from "../transport/resumable.js";
+export declare const getResumedStreamIds: (storage: ResumableClientStorage | undefined) => Set<string>;
+declare class DynamicResumableStorage implements ResumableClientStorage {
+    private readonly subscriptions;
+    private storage;
+    private resumedStreamIds;
+    private hasPendingNotification;
+    constructor(storage: ResumableClientStorage | undefined);
+    setStorage(storage: ResumableClientStorage | undefined): void;
+    flushChange(): void;
+    getResumedStreamIds(): Set<string>;
+    getStreamId(threadId?: string): string | null;
+    setStreamId(id: string, threadId?: string): void;
+    clear(threadId?: string): void;
+    subscribe(listener: () => void, threadId?: string): () => void;
+}
+type ThreadTransportBinding = {
+    runtime: AssistantRuntime;
+    getThreadListItem: () => InitializableThreadListItem | undefined;
+};
+export declare class DynamicChatTransport<UI_MESSAGE extends UIMessage> implements ChatTransport<UI_MESSAGE> {
+    private readonly threadContexts;
+    private transport;
+    private readonly resumableStorage;
+    constructor(transport: ChatTransport<UI_MESSAGE>);
+    readonly sendMessages: ChatTransport<UI_MESSAGE>["sendMessages"];
+    readonly reconnectToStream: ChatTransport<UI_MESSAGE>["reconnectToStream"];
+    get resumeStreamIsReplay(): boolean;
+    readonly getCurrentTransport: (chatId: string) => ChatTransport<UI_MESSAGE>;
+    readonly getCurrentResumableStorage: () => DynamicResumableStorage;
+    readonly getResumedStreamIds: () => Set<string>;
+    createThreadProxy(owner: object, getBinding: () => ThreadTransportBinding): ChatTransport<UI_MESSAGE>;
+    setTransport(transport: ChatTransport<UI_MESSAGE>): void;
+    flushTransportChange(): void;
+    registerThread(chatId: string, owner: object): void;
+    setThreadContext(chatId: string, owner: object, runtime: AssistantRuntime, getThreadListItem: () => InitializableThreadListItem | undefined): void;
+    unregisterThread(chatId: string, owner: object): void;
+    private getTransport;
+    private getBoundTransport;
+    private getOrCreateBoundTransport;
+    private getThreadTransport;
+    private createThreadTransport;
+    private wireTransport;
+}
+export {};
+//# sourceMappingURL=DynamicChatTransport.d.ts.map

package/dist/runtime/DynamicChatTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicChatTransport.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI;AACvC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,wCAAqC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAAwB;AAQpE,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,GAAG,SAAS,gBAS5C;AAQD,cAAM,uBAAwB,YAAW,sBAAsB;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,sBAAsB;gBAElB,OAAO,EAAE,sBAAsB,GAAG,SAAS;IAKhD,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS;IAWtD,WAAW;IAaX,mBAAmB;IAInB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;IAI7B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAIzC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM;IAIvB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM;;AAwB1D,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,gBAAgB;IACzB,iBAAiB,EAAE,MAAM,2BAA2B,GAAG,SAAS;CACjE;AAED,qBAAa,oBAAoB,CAC/B,UAAU,SAAS,SAAS,CAC5B,YAAW,aAAa,CAAC,UAAU,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAI/B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAErB,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC;IAOhD,SAAgB,YAAY,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC;IAIvE,SAAgB,iBAAiB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,mBAAmB,CAAC;IAGjF,IAAW,oBAAoB;IAI/B,SAAgB,mBAAmB,GAAI,QAAQ,MAAM;IAGrD,SAAgB,0BAA0B;IAE1C,SAAgB,mBAAmB;IAG5B,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,sBAAsB,GACvC,aAAa,CAAC,UAAU,CAAC;IAqBrB,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC;IAMjD,oBAAoB;IAIpB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAQ5C,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,MAAM,2BAA2B,GAAG,SAAS;IAkB3D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAMrD,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,aAAa","names":[],"ignoreList":[],"sources":["../../src/runtime/DynamicChatTransport.ts"],"sourcesContent":[null]}