@assistant-ui/core 0.2.9 → 0.2.11

package/dist/utils/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":["import type { AppendMessage, ThreadMessage } from \"../types/message\";\nimport type { TextMessagePart } from \"../types/message\";\n\nexport const getThreadMessageText = (\n  message: ThreadMessage | AppendMessage,\n) => {\n  const textParts = message.content.filter(\n    (part) => part.type === \"text\",\n  ) as TextMessagePart[];\n\n  return textParts.map((part) => part.text).join(\"\\n\\n\");\n};\n"],"mappings":";AAGA,MAAa,wBACX,YACG;CAKH,OAJkB,QAAQ,QAAQ,QAC/B,SAAS,KAAK,SAAS,MAGX,EAAE,KAAK,SAAS,KAAK,IAAI,EAAE,KAAK,MAAM;AACvD"}
+{"version":3,"file":"text.js","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":["import type { AppendMessage, ThreadMessage } from \"../types/message\";\nimport type { TextMessagePart } from \"../types/message\";\n\nexport const getThreadMessageText = (\n  message: ThreadMessage | AppendMessage,\n) => {\n  const textParts = message.content.filter(\n    (part) => part.type === \"text\",\n  ) as TextMessagePart[];\n\n  return textParts.map((part) => part.text).join(\"\\n\\n\");\n};\n"],"mappings":";AAGA,MAAa,wBACX,YACG;CAKH,OAJkB,QAAQ,QAAQ,QAC/B,SAAS,KAAK,SAAS,MAGX,CAAC,CAAC,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,KAAK,MAAM;AACvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -59,15 +59,18 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.19",
+    "assistant-stream": "^0.3.21",
     "nanoid": "^5.1.11"
   },
+  "optionalDevDependencies": {
+    "@assistant-ui/x-generative-compiler": ">=0.0.3"
+  },
   "peerDependencies": {
     "@assistant-ui/store": "^0.2.13",
-    "@assistant-ui/tap": "^0.5.14",
+    "@assistant-ui/tap": "^0.6.0",
     "@types/react": "*",
     "react": "^18 || ^19",
-    "assistant-cloud": "^0.1.30",
+    "assistant-cloud": "^0.1.31",
     "zustand": "^5.0.11"
   },
   "peerDependenciesMeta": {
@@ -85,14 +88,15 @@
     }
   },
   "devDependencies": {
-    "@types/react": "^19.2.15",
-    "react": "^19.2.6",
-    "vitest": "^4.1.7",
+    "@types/react": "^19.2.17",
+    "react": "^19.2.7",
+    "vitest": "^4.1.8",
     "zustand": "^5.0.14",
-    "@assistant-ui/store": "0.2.13",
-    "@assistant-ui/tap": "0.5.14",
-    "@assistant-ui/x-buildutils": "0.0.10",
-    "assistant-cloud": "0.1.30"
+    "@assistant-ui/store": "0.2.14",
+    "@assistant-ui/tap": "0.6.0",
+    "@assistant-ui/vite": "0.0.4",
+    "@assistant-ui/x-buildutils": "0.0.12",
+    "assistant-cloud": "0.1.32"
   },
   "publishConfig": {
     "access": "public",

package/src/adapters/attachment.ts

@@ -49,13 +49,29 @@ export class SimpleImageAttachmentAdapter implements AttachmentAdapter {
   }
 }
 
-const getFileDataURL = (file: File) =>
-  new Promise<string>((resolve, reject) => {
+const bytesToBase64 = (bytes: Uint8Array): string =>
+  (
+    globalThis as {
+      Buffer: {
+        from(bytes: Uint8Array): { toString(encoding: string): string };
+      };
+    }
+  ).Buffer.from(bytes).toString("base64");
+
+// React Native's Blob polyfill has FileReader but not file.text()/arrayBuffer(); Node has
+// the reverse. Prefer FileReader when present, falling back to the Blob methods otherwise.
+const getFileDataURL = async (file: File): Promise<string> => {
+  if (typeof FileReader === "undefined") {
+    const buffer = await file.arrayBuffer();
+    return `data:${file.type};base64,${bytesToBase64(new Uint8Array(buffer))}`;
+  }
+  return new Promise<string>((resolve, reject) => {
     const reader = new FileReader();
     reader.onload = () => resolve(reader.result as string);
     reader.onerror = (error) => reject(error);
     reader.readAsDataURL(file);
   });
+};
 
 export class SimpleTextAttachmentAdapter implements AttachmentAdapter {
   public accept =
@@ -92,13 +108,17 @@ export class SimpleTextAttachmentAdapter implements AttachmentAdapter {
   }
 }
 
-const getFileText = (file: File) =>
-  new Promise<string>((resolve, reject) => {
+const getFileText = async (file: File): Promise<string> => {
+  if (typeof FileReader === "undefined") {
+    return file.text();
+  }
+  return new Promise<string>((resolve, reject) => {
     const reader = new FileReader();
     reader.onload = () => resolve(reader.result as string);
     reader.onerror = (error) => reject(error);
     reader.readAsText(file);
   });
+};
 
 export function fileMatchesAccept(
   file: { name: string; type: string },

package/src/index.ts

@@ -285,6 +285,14 @@ export type {
 export type { ExternalStoreSharedOptions } from "./runtimes/external-store/external-store-shared-options";
 export { pickExternalStoreSharedOptions } from "./runtimes/external-store/external-store-shared-options";
 
+// Message queue
+export type { ExternalThreadQueueAdapter } from "./runtime/queue/external-thread-queue-adapter";
+export {
+  createMessageQueue,
+  type MessageQueueDriver,
+  type MessageQueueController,
+} from "./runtime/queue/message-queue";
+
 // Remote Thread List (user-facing)
 export type {
   RemoteThreadListAdapter,

package/src/model-context/tool.ts

@@ -7,7 +7,7 @@ import type { Tool } from "assistant-stream";
  * optional model-output conversion.
  *
  * This helper keeps reusable tool definitions type-checked and convenient to
- * export for a {@link Toolkit}, {@link Tools}, or {@link useAssistantTool}.
+ * export for a {@link Toolkit} registered with {@link Tools}.
  * Inference from parameter schemas is currently limited, so provide generic
  * arguments when you need precise args or result types.
  *

package/src/model-context/types.ts

@@ -55,7 +55,10 @@ export const mergeModelContexts = (
     .map((c) => c.getModelContext())
     .sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
 
+  const toolPriorities: Record<string, number> = {};
+
   return configs.reduce((acc, config) => {
+    const priority = config.priority ?? 0;
     if (config.system) {
       if (acc.system) {
         acc.system += `\n\n${config.system}`;
@@ -67,13 +70,28 @@ export const mergeModelContexts = (
       for (const [name, tool] of Object.entries(config.tools)) {
         const existing = acc.tools?.[name];
         if (existing && existing !== tool) {
-          throw new Error(
-            `You tried to define a tool with the name ${name}, but it already exists.`,
-          );
+          const existingPriority = toolPriorities[name]!;
+          if (existingPriority === priority) {
+            throw new Error(
+              `You tried to define a tool with the name ${name}, but it already exists.`,
+            );
+          }
+
+          const higherPriorityTool =
+            existingPriority > priority ? existing : tool;
+          const lowerPriorityTool =
+            existingPriority > priority ? tool : existing;
+          acc.tools![name] = {
+            ...lowerPriorityTool,
+            ...higherPriorityTool,
+          } as Tool<any, any>;
+          toolPriorities[name] = Math.max(existingPriority, priority);
+          continue;
         }
 
         if (!acc.tools) acc.tools = {};
         acc.tools[name] = tool;
+        toolPriorities[name] ??= priority;
       }
     }
     if (config.config) {

package/src/react/RuntimeAdapter.ts

@@ -1,4 +1,4 @@
-import { resource, tapResource } from "@assistant-ui/tap";
+import { useResource, resource } from "@assistant-ui/tap";
 import type { AssistantRuntime } from "..";
 import {
   RuntimeAdapterResource,
@@ -8,9 +8,11 @@ import { attachTransformScopes } from "@assistant-ui/store";
 import { DataRenderers } from "./client/DataRenderers";
 import { Tools } from "./client/Tools";
 
-export const RuntimeAdapter = resource((runtime: AssistantRuntime) =>
-  tapResource(RuntimeAdapterResource(runtime)),
-);
+export const RuntimeAdapter = resource(function RuntimeAdapter(
+  runtime: AssistantRuntime,
+) {
+  return useResource(RuntimeAdapterResource(runtime));
+});
 
 attachTransformScopes(RuntimeAdapter, (scopes, parent) => {
   baseRuntimeAdapterTransformScopes(scopes, parent);

package/src/react/adapters/LocalStorageThreadListAdapter.tsx

@@ -28,13 +28,12 @@ type LocalStorageAdapterOptions = {
   titleGenerator?: TitleGenerationAdapter | undefined;
 };
 
-// `RemoteThreadMetadata.custom` is intentionally not persisted; consumers that
-// need it across reloads should fork this adapter or use a remote backend.
 type StoredThreadMetadata = {
   remoteId: string;
   externalId?: string;
   status: "regular" | "archived";
   title?: string;
+  custom?: Record<string, unknown> | undefined;
 };
 
 class AsyncStorageHistoryAdapter implements ThreadHistoryAdapter {
@@ -131,6 +130,7 @@ export const createLocalStorageAdapter = (
           externalId: t.externalId,
           status: t.status,
           title: t.title,
+          custom: t.custom,
         })),
       };
     },
@@ -162,6 +162,18 @@ export const createLocalStorageAdapter = (
       }
     },
 
+    async updateCustom(
+      remoteId: string,
+      custom: Record<string, unknown> | undefined,
+    ): Promise<void> {
+      const threads = await loadThreadMetadata();
+      const thread = threads.find((t) => t.remoteId === remoteId);
+      if (thread) {
+        thread.custom = custom;
+        await saveThreadMetadata(threads);
+      }
+    },
+
     async archive(remoteId: string): Promise<void> {
       const threads = await loadThreadMetadata();
       const thread = threads.find((t) => t.remoteId === remoteId);
@@ -196,6 +208,7 @@ export const createLocalStorageAdapter = (
         externalId: thread.externalId,
         status: thread.status,
         title: thread.title,
+        custom: thread.custom,
       };
     },
 

package/src/react/client/DataRenderers.ts

@@ -1,4 +1,5 @@
-import { resource, tapState, tapCallback } from "@assistant-ui/tap";
+import { useState, useCallback } from "react";
+import { resource } from "@assistant-ui/tap";
 import type { ClientOutput } from "@assistant-ui/store";
 import type { DataRenderersState } from "../types/scopes/dataRenderers";
 import type { DataMessagePartComponent } from "../types/MessagePartComponentTypes";
@@ -10,56 +11,61 @@ import type { DataMessagePartComponent } from "../types/MessagePartComponentType
  * directly for a renderer scope, or prefer {@link useAssistantDataUI} /
  * {@link makeAssistantDataUI} when registering from React components.
  */
-export const DataRenderers = resource((): ClientOutput<"dataRenderers"> => {
-  const [state, setState] = tapState<DataRenderersState>(() => ({
-    renderers: {},
-    fallbacks: [],
-  }));
-
-  const setDataUI = tapCallback(
-    (name: string, render: DataMessagePartComponent) => {
-      setState((prev) => {
-        return {
-          ...prev,
-          renderers: {
-            ...prev.renderers,
-            [name]: [...(prev.renderers[name] ?? []), render],
-          },
-        };
-      });
+export const DataRenderers = resource(
+  function DataRenderers(): ClientOutput<"dataRenderers"> {
+    const [state, setState] = useState<DataRenderersState>(() => ({
+      renderers: {},
+      fallbacks: [],
+    }));
 
-      return () => {
+    const setDataUI = useCallback(
+      (name: string, render: DataMessagePartComponent) => {
         setState((prev) => {
           return {
             ...prev,
             renderers: {
               ...prev.renderers,
-              [name]: prev.renderers[name]?.filter((r) => r !== render) ?? [],
+              [name]: [...(prev.renderers[name] ?? []), render],
             },
           };
         });
-      };
-    },
-    [],
-  );
 
-  const setFallbackDataUI = tapCallback((render: DataMessagePartComponent) => {
-    setState((prev) => ({
-      ...prev,
-      fallbacks: [...prev.fallbacks, render],
-    }));
+        return () => {
+          setState((prev) => {
+            return {
+              ...prev,
+              renderers: {
+                ...prev.renderers,
+                [name]: prev.renderers[name]?.filter((r) => r !== render) ?? [],
+              },
+            };
+          });
+        };
+      },
+      [],
+    );
 
-    return () => {
-      setState((prev) => ({
-        ...prev,
-        fallbacks: prev.fallbacks.filter((r) => r !== render),
-      }));
-    };
-  }, []);
+    const setFallbackDataUI = useCallback(
+      (render: DataMessagePartComponent) => {
+        setState((prev) => ({
+          ...prev,
+          fallbacks: [...prev.fallbacks, render],
+        }));
+
+        return () => {
+          setState((prev) => ({
+            ...prev,
+            fallbacks: prev.fallbacks.filter((r) => r !== render),
+          }));
+        };
+      },
+      [],
+    );
 
-  return {
-    getState: () => state,
-    setDataUI,
-    setFallbackDataUI,
-  };
-});
+    return {
+      getState: () => state,
+      setDataUI,
+      setFallbackDataUI,
+    };
+  },
+);