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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentbaseAI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,30 @@
-# Temporary Holding Version
+# `@ulearning/ai-sdk-adapter`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vercel AI SDK integration for `@ulearning/ai-sdk`. Wraps the AI SDK chat in an assistant-ui runtime and forwards system messages and frontend tools through `AssistantChatTransport`. Each release line targets the AI SDK major pinned in its dependencies.
+
+## Installation
+
+```bash
+npm install @ulearning/ai-sdk @ulearning/ai-sdk-adapter ai
+```
+
+## Usage
+
+```tsx
+"use client";
+
+import { AssistantRuntimeProvider } from "@ulearning/ai-sdk";
+import { useChatRuntime } from "@ulearning/ai-sdk-adapter";
+import { Thread } from "@/components/assistant-ui/elements/thread.aui";
+
+export function Chat() {
+  const runtime = useChatRuntime();
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+`useChatRuntime` defaults to `AssistantChatTransport`, which forwards frontend system messages and tool definitions to your backend. To customize the API URL, the cache, or other transport settings, pass a configured `AssistantChatTransport` to keep that forwarding behavior; pass `DefaultChatTransport` to opt out.

package/dist/adapters/aiSDKFormatAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { UIMessage } from "ai";
+import type { MessageFormatAdapter } from "@ulearning/ai-core";
+export type AISDKStorageFormat = Omit<UIMessage, "id">;
+/** The stored form of an AI SDK message: the message without its id. */
+export declare const aiSDKV6FormatAdapter: MessageFormatAdapter<UIMessage, AISDKStorageFormat>;
+//# sourceMappingURL=aiSDKFormatAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiSDKFormatAdapter.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB;AAE9D,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;AAEtD;AACA,eAAO,MAAM,oBAAoB,EAAE,oBAAoB,CACrD,SAAS,EACT,kBAAkB,CASnB","names":[],"ignoreList":[],"sources":["../../src/adapters/aiSDKFormatAdapter.ts"],"sourcesContent":[null]}

package/dist/adapters/aiSDKFormatAdapter.js

@@ -0,0 +1,17 @@
+// src/adapters/aiSDKFormatAdapter.ts
+/** The stored form of an AI SDK message: the message without its id. */
+const aiSDKV6FormatAdapter = {
+	format: "ai-sdk/v6",
+	encode: ({ message: { id: _id, ...message } }) => message,
+	decode: (stored) => ({
+		parentId: stored.parent_id,
+		message: {
+			id: stored.id,
+			...stored.content
+		}
+	}),
+	getId: (message) => message.id
+};
+export { aiSDKV6FormatAdapter };
+
+//# sourceMappingURL=aiSDKFormatAdapter.js.map

package/dist/adapters/aiSDKFormatAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSDKFormatAdapter.js","names":[],"sources":["../../src/adapters/aiSDKFormatAdapter.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\nimport type { MessageFormatAdapter } from \"@ulearning/ai-core\";\n\nexport type AISDKStorageFormat = Omit<UIMessage, \"id\">;\n\n/** The stored form of an AI SDK message: the message without its id. */\nexport const aiSDKV6FormatAdapter: MessageFormatAdapter<\n  UIMessage,\n  AISDKStorageFormat\n> = {\n  format: \"ai-sdk/v6\",\n  encode: ({ message: { id: _id, ...message } }) => message,\n  decode: (stored) => ({\n    parentId: stored.parent_id,\n    message: { id: stored.id, ...stored.content } as UIMessage,\n  }),\n  getId: (message) => message.id,\n};\n"],"mappings":";;AAMA,MAAa,uBAGT;CACF,QAAQ;CACR,SAAS,EAAE,SAAS,EAAE,IAAI,KAAK,GAAG,gBAAgB;CAClD,SAAS,YAAY;EACnB,UAAU,OAAO;EACjB,SAAS;GAAE,IAAI,OAAO;GAAI,GAAG,OAAO;EAAQ;CAC9C;CACA,QAAQ,YAAY,QAAQ;AAC9B"}

package/dist/adapters/vercelAttachmentAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { AttachmentAdapter } from "@ulearning/ai-core";
+export declare const vercelAttachmentAdapter: AttachmentAdapter;
+//# sourceMappingURL=vercelAttachmentAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vercelAttachmentAdapter.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB;AAI3D,eAAO,MAAM,uBAAuB,EAAE,iBA+BrC","names":[],"ignoreList":[],"sources":["../../src/adapters/vercelAttachmentAdapter.ts"],"sourcesContent":[null]}

package/dist/adapters/vercelAttachmentAdapter.js

@@ -0,0 +1,36 @@
+import { getFileDataURL } from "@ulearning/ai-core/internal";
+import { generateId } from "ai";
+// src/adapters/vercelAttachmentAdapter.ts
+const vercelAttachmentAdapter = {
+	accept: "*",
+	async add({ file }) {
+		return {
+			id: generateId(),
+			type: file.type.startsWith("image/") ? "image" : "file",
+			name: file.name,
+			file,
+			contentType: file.type,
+			content: [],
+			status: {
+				type: "requires-action",
+				reason: "composer-send"
+			}
+		};
+	},
+	async send(attachment, options) {
+		return {
+			...attachment,
+			status: { type: "complete" },
+			content: [{
+				type: "file",
+				mimeType: attachment.contentType ?? "",
+				filename: attachment.name,
+				data: await getFileDataURL(attachment.file, options)
+			}]
+		};
+	},
+	async remove() {}
+};
+export { vercelAttachmentAdapter };
+
+//# sourceMappingURL=vercelAttachmentAdapter.js.map

package/dist/adapters/vercelAttachmentAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercelAttachmentAdapter.js","names":[],"sources":["../../src/adapters/vercelAttachmentAdapter.ts"],"sourcesContent":["import type { AttachmentAdapter } from \"@ulearning/ai-core\";\nimport { getFileDataURL } from \"@ulearning/ai-core/internal\";\nimport { generateId } from \"ai\";\n\nexport const vercelAttachmentAdapter: AttachmentAdapter = {\n  accept: \"*\",\n  async add({ file }) {\n    return {\n      id: generateId(),\n      type: file.type.startsWith(\"image/\") ? \"image\" : \"file\",\n      name: file.name,\n      file,\n      contentType: file.type,\n      content: [],\n      status: { type: \"requires-action\", reason: \"composer-send\" },\n    };\n  },\n  async send(attachment, options) {\n    // noop\n    return {\n      ...attachment,\n      status: { type: \"complete\" },\n      content: [\n        {\n          type: \"file\",\n          mimeType: attachment.contentType ?? \"\",\n          filename: attachment.name,\n          data: await getFileDataURL(attachment.file, options),\n        },\n      ],\n    };\n  },\n  async remove() {\n    // noop\n  },\n};\n"],"mappings":";;;AAIA,MAAa,0BAA6C;CACxD,QAAQ;CACR,MAAM,IAAI,EAAE,QAAQ;EAClB,OAAO;GACL,IAAI,WAAW;GACf,MAAM,KAAK,KAAK,WAAW,QAAQ,IAAI,UAAU;GACjD,MAAM,KAAK;GACX;GACA,aAAa,KAAK;GAClB,SAAS,CAAC;GACV,QAAQ;IAAE,MAAM;IAAmB,QAAQ;GAAgB;EAC7D;CACF;CACA,MAAM,KAAK,YAAY,SAAS;EAE9B,OAAO;GACL,GAAG;GACH,QAAQ,EAAE,MAAM,WAAW;GAC3B,SAAS,CACP;IACE,MAAM;IACN,UAAU,WAAW,eAAe;IACpC,UAAU,WAAW;IACrB,MAAM,MAAM,eAAe,WAAW,MAAM,OAAO;GACrD,CACF;EACF;CACF;CACA,MAAM,SAAS,CAEf;AACF"}

package/dist/aiSDKExtras.d.ts

@@ -0,0 +1,13 @@
+import type { AbstractChat, UIMessage } from "ai";
+/** Framework independent advanced chat surface, preserving the AI SDK 7 methods. */
+export type AISDKChatHelpers<UI_MESSAGE extends UIMessage = UIMessage> = {
+    readonly id: string;
+    setMessages: (messages: UI_MESSAGE[] | ((messages: UI_MESSAGE[]) => UI_MESSAGE[])) => void;
+    error: Error | undefined;
+} & Pick<AbstractChat<UI_MESSAGE>, "sendMessage" | "regenerate" | "stop" | "resumeStream" | "addToolResult" | "addToolOutput" | "addToolApprovalResponse" | "status" | "messages" | "clearError">;
+export type AISDKRuntimeExtras = {
+    chat: AISDKChatHelpers<UIMessage>;
+    error: Error | undefined;
+};
+export declare const aiSDKExtras: import("@ulearning/ai-core/vue").RuntimeExtras<AISDKRuntimeExtras>;
+//# sourceMappingURL=aiSDKExtras.d.ts.map

package/dist/aiSDKExtras.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSDKExtras.d.ts","mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,IAAI;AAEjD;AACA,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IAAI;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,WAAW,EAAE,CACX,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,CAAC,KAChE,IAAI;IACT,KAAK,EAAE,KAAK,GAAG,SAAS;CACzB,GAAG,IAAI,CACN,YAAY,CAAC,UAAU,CAAC,EACtB,aAAa,GACb,YAAY,GACZ,MAAM,GACN,cAAc,GACd,eAAe,GACf,eAAe,GACf,yBAAyB,GACzB,QAAQ,GACR,UAAU,GACV,YAAY,CACf;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;IACjC,KAAK,EAAE,KAAK,GAAG,SAAS;CACzB;AAED,eAAO,MAAM,WAAW,oEACoC","names":[],"ignoreList":[],"sources":["../src/aiSDKExtras.ts"],"sourcesContent":[null]}

package/dist/aiSDKExtras.js

@@ -0,0 +1,6 @@
+import { createRuntimeExtras } from "@ulearning/ai-core/vue";
+// src/aiSDKExtras.ts
+const aiSDKExtras = createRuntimeExtras("useAISDKRuntime");
+export { aiSDKExtras };
+
+//# sourceMappingURL=aiSDKExtras.js.map

package/dist/aiSDKExtras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSDKExtras.js","names":[],"sources":["../src/aiSDKExtras.ts"],"sourcesContent":["import { createRuntimeExtras } from \"@ulearning/ai-core/vue\";\nimport type { AbstractChat, UIMessage } from \"ai\";\n\n/** Framework independent advanced chat surface, preserving the AI SDK 7 methods. */\nexport type AISDKChatHelpers<UI_MESSAGE extends UIMessage = UIMessage> = {\n  readonly id: string;\n  setMessages: (\n    messages: UI_MESSAGE[] | ((messages: UI_MESSAGE[]) => UI_MESSAGE[]),\n  ) => void;\n  error: Error | undefined;\n} & Pick<\n  AbstractChat<UI_MESSAGE>,\n  | \"sendMessage\"\n  | \"regenerate\"\n  | \"stop\"\n  | \"resumeStream\"\n  | \"addToolResult\"\n  | \"addToolOutput\"\n  | \"addToolApprovalResponse\"\n  | \"status\"\n  | \"messages\"\n  | \"clearError\"\n>;\n\nexport type AISDKRuntimeExtras = {\n  chat: AISDKChatHelpers<UIMessage>;\n  error: Error | undefined;\n};\n\nexport const aiSDKExtras =\n  createRuntimeExtras<AISDKRuntimeExtras>(\"useAISDKRuntime\");\n"],"mappings":";;AA6BA,MAAa,cACX,oBAAwC,iBAAiB"}

package/dist/converters/convertMessage.d.ts

@@ -0,0 +1,44 @@
+import { type UIMessage } from "ai";
+import { type useExternalMessageConverter } from "@ulearning/ai-core/vue";
+import { type McpAppMetadata, type RespondToToolApprovalOptions, type Unstable_ToolInteractionLog } from "@ulearning/ai-core";
+import { type ReadonlyJSONObject } from "@ulearning/ai-stream/utils";
+export type AISDKMessageConverterMetadata = useExternalMessageConverter.Metadata & {
+    createdAtCache?: Map<string, Date>;
+    toolArgsKeyOrderCache?: Map<string, Map<string, string[]>>;
+    /**
+     * Frozen text and completion-marked args keyed weakly by a settled tool
+     * call's input object, then by call, since the text carries its streamed key
+     * order. A known call/input pair skips serialization and parsing; entries
+     * become collectible once the input is unreachable.
+     */
+    toolArgsTextCache?: WeakMap<ReadonlyJSONObject, Map<string, {
+        argsText: string;
+        args: ReadonlyJSONObject;
+    }>>;
+    toolLastInputCache?: Map<string, ReadonlyJSONObject>;
+    mcpAppMetadataCache?: Map<string, McpAppMetadata>;
+    toolArtifacts?: ReadonlyMap<string, unknown>;
+    toolInteractions?: ReadonlyMap<string, Unstable_ToolInteractionLog>;
+    supportsRichToolApprovalResponses?: boolean;
+    toolApprovalResponses?: ReadonlyMap<string, RespondToToolApprovalOptions>;
+    cancelledToolApprovalIds?: ReadonlySet<string>;
+    cancelledStatusMessageIds?: ReadonlySet<string>;
+    /** Id of the currently-streaming message, flagged optimistic (#4037). */
+    optimisticMessageId?: string | undefined;
+};
+export declare const convertAISDKMessage: useExternalMessageConverter.Callback<UIMessage>;
+export declare const AISDKMessageConverter: {
+    useThreadMessages: (input: import("vue").MaybeRefOrGetter<{
+        messages: UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[];
+        isRunning: boolean;
+        joinStrategy?: import("@ulearning/ai-core/store").JoinStrategy | undefined;
+        metadata?: useExternalMessageConverter.Metadata;
+    }>) => import("vue").ComputedRef<import("@ulearning/ai-core").ThreadMessage[]>;
+    toThreadMessages: (messages: UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[], isRunning?: boolean, metadata?: useExternalMessageConverter.Metadata) => import("@ulearning/ai-core").ThreadMessage[];
+    toOriginalMessages: (input: import("@ulearning/ai-core").ThreadRuntimeState | import("@ulearning/ai-core").ThreadMessage | import("@ulearning/ai-core").ThreadMessage["content"][number]) => unknown[];
+    toOriginalMessage: (input: import("@ulearning/ai-core").ThreadRuntimeState | import("@ulearning/ai-core").ThreadMessage | import("@ulearning/ai-core").ThreadMessage["content"][number]) => {};
+    useOriginalMessage: () => import("vue").ComputedRef<{}>;
+    useOriginalMessages: () => import("vue").ComputedRef<unknown[]>;
+};
+export declare const createAISDKMetadataKey: () => useExternalMessageConverter.GetMetadataKey<UIMessage>;
+//# sourceMappingURL=convertMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertMessage.d.ts","mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,IAAI;AACX,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB;AAC/B,OAAO,EAcL,KAAK,cAAc,EAEnB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EACjC,MAAM,oBAAoB;AAQ3B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B;AA6BnC,MAAM,MAAM,6BAA6B,GACvC,2BAA2B,CAAC,QAAQ,GAAG;IACrC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;IAClC,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D;;;;;;IAMA,iBAAiB,CAAC,EAAE,OAAO,CACzB,kBAAkB,EAClB,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM;QAAE,IAAI,EAAE,kBAAkB;KAAE,CAAC,CAC5D;IACD,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpD,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IACjD,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5C,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,2BAA2B,CAAC;IACnE,iCAAiC,CAAC,EAAE,OAAO;IAC3C,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,4BAA4B,CAAC;IACzE,wBAAwB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAC9C,yBAAyB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAC/C;IACA,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS;CACzC;AA8pBH,eAAO,MAAM,mBAAmB,EAAE,2BAA2B,CAAC,QAAQ,CACpE,SAAS,CAsFV;AAED,eAAO,MAAM,qBAAqB;;;;;;;;+HArzBlC,qDACe;8HAGO,qDACb;;;CAizB6C;AAkCtD,eAAO,MAAM,sBAAsB,QAC7B,2BAA2B,CAAC,cAAc,CAAC,SAAS,CA6BpD","names":[],"ignoreList":[],"sources":["../../src/converters/convertMessage.ts"],"sourcesContent":[null]}