@assistant-ui/core 0.2.23 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.2.23",
+  "version": "0.3.0",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -59,14 +59,14 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.28",
+    "assistant-stream": "^0.3.29",
     "nanoid": "^6.0.0"
   },
   "optionalDevDependencies": {
     "@assistant-ui/x-generative-compiler": ">=0.0.3"
   },
   "peerDependencies": {
-    "@assistant-ui/store": "^0.2.13",
+    "@assistant-ui/store": "^0.3.0",
     "@assistant-ui/tap": "^0.9.0",
     "@types/react": "*",
     "react": "^18 || ^19",
@@ -95,8 +95,8 @@
     "react-dom": "^19.2.8",
     "vitest": "^4.1.10",
     "zustand": "^5.0.14",
-    "@assistant-ui/store": "0.2.22",
-    "@assistant-ui/tap": "0.9.6",
+    "@assistant-ui/store": "0.3.0",
+    "@assistant-ui/tap": "0.9.7",
     "@assistant-ui/vite": "0.0.11",
     "@assistant-ui/x-buildutils": "0.0.20",
     "assistant-cloud": "0.1.37"

package/src/react/adapters/LocalStorageThreadListAdapter.tsx

@@ -297,7 +297,7 @@ class AsyncStorageHistoryAdapter implements ThreadHistoryAdapter {
   }
 
   async load(): Promise<ExportedMessageRepository> {
-    const remoteId = this.aui.threadListItem().getState().remoteId;
+    const remoteId = this.aui.threadListItem.getState().remoteId;
     if (!remoteId) return { messages: [] };
 
     const raw = await this.storage.getItem(this._messagesKey(remoteId));
@@ -305,7 +305,7 @@ class AsyncStorageHistoryAdapter implements ThreadHistoryAdapter {
   }
 
   async append(item: ExportedMessageRepositoryItem): Promise<void> {
-    const { remoteId } = await this.aui.threadListItem().initialize();
+    const { remoteId } = await this.aui.threadListItem.initialize();
 
     const key = this._messagesKey(remoteId);
     await this.mutationQueue.run(key, async () => {

package/src/react/client/Tools.ts

@@ -48,13 +48,6 @@ const useTools = ({
     (): ToolsState => ({
       toolUIs,
       mcpApp: mcpAppOutput,
-      // Deprecated component-only view, derived from `toolUIs`. Removed in v0.15.
-      tools: Object.fromEntries(
-        Object.entries(toolUIs).map(([name, regs]) => [
-          name,
-          regs.map((r) => r.render),
-        ]),
-      ),
     }),
     [toolUIs, mcpAppOutput],
   );

package/src/react/interactables-legacy/useAssistantInteractable.ts

@@ -42,7 +42,7 @@ export const useAssistantInteractable = (
   initialStateRef.current = config.initialState;
 
   useEffect(() => {
-    return aui.interactables().register({
+    return aui.interactables.register({
       id,
       name,
       description: config.description,

package/src/react/interactables-legacy/useInteractableState.ts

@@ -35,7 +35,7 @@ export const useInteractableState = <TState>(
 
   const setState = useCallback(
     (updater: StateUpdater<TState>) => {
-      aui.interactables().setState(id, (prev) => {
+      aui.interactables.setState(id, (prev) => {
         if (typeof updater === "function") {
           return (updater as (prev: TState) => TState)(prev as TState);
         }
@@ -47,12 +47,12 @@ export const useInteractableState = <TState>(
 
   const setSelected = useCallback(
     (selected: boolean) => {
-      aui.interactables().setSelected(id, selected);
+      aui.interactables.setSelected(id, selected);
     },
     [aui, id],
   );
 
-  const flush = useCallback(() => aui.interactables().flush(), [aui]);
+  const flush = useCallback(() => aui.interactables.flush(), [aui]);
 
   return [
     state,

package/src/react/model-context/useAssistantContext.ts

@@ -13,7 +13,7 @@ export const useAssistantContext = (config: AssistantContextConfig) => {
   useEffect(() => {
     if (disabled) return;
 
-    return aui.modelContext().register({
+    return aui.modelContext.register({
       getModelContext: () => ({
         system: getContextRef.current(),
       }),

package/src/react/model-context/useAssistantDataUI.ts

@@ -20,6 +20,6 @@ export const useAssistantDataUI = (dataUI: AssistantDataUIProps | null) => {
   const aui = useAui();
   useEffect(() => {
     if (!dataUI?.name || !dataUI?.render) return undefined;
-    return aui.dataRenderers().setDataUI(dataUI.name, dataUI.render);
+    return aui.dataRenderers.setDataUI(dataUI.name, dataUI.render);
   }, [aui, dataUI?.name, dataUI?.render]);
 };

package/src/react/model-context/useAssistantInstructions.ts

@@ -23,7 +23,7 @@ export const useAssistantInstructions = (
     const config = {
       system: instruction,
     };
-    return aui.modelContext().register({
+    return aui.modelContext.register({
       getModelContext: () => config,
     });
   }, [aui, instruction, disabled]);

package/src/react/model-context/useAssistantTool.ts

@@ -77,7 +77,7 @@ export const useAssistantTool = <
 
   useEffect(() => {
     if (!render) return undefined;
-    return aui.tools().setToolUI(tool.toolName, render, { standalone });
+    return aui.tools.setToolUI(tool.toolName, render, { standalone });
   }, [aui, tool.toolName, render, standalone]);
 
   useEffect(() => {
@@ -89,7 +89,7 @@ export const useAssistantTool = <
         [toolName]: rest,
       },
     };
-    return aui.modelContext().register({
+    return aui.modelContext.register({
       getModelContext: () => context,
     });
   }, [aui, tool]);

package/src/react/model-context/useAssistantToolUI.ts

@@ -41,6 +41,6 @@ export const useAssistantToolUI = (
   const standalone = tool?.display === "standalone";
   useEffect(() => {
     if (!tool?.toolName || !tool?.render) return undefined;
-    return aui.tools().setToolUI(tool.toolName, tool.render, { standalone });
+    return aui.tools.setToolUI(tool.toolName, tool.render, { standalone });
   }, [aui, tool?.toolName, tool?.render, standalone]);
 };

package/src/react/model-context/useAuiToolOverrides.ts

@@ -28,7 +28,7 @@ export function useAuiToolOverrides(overrides: AuiToolOverrides): void {
   overridesRef.current = overrides;
 
   useEffect(() => {
-    return aui.modelContext().register({
+    return aui.modelContext.register({
       getModelContext: () => ({
         priority: 1000,
         tools: overridesRef.current as Record<string, Tool<any, any>>,

package/src/react/model-context/useInteractable.ts

@@ -123,7 +123,7 @@ const useInteractable = <TSchema extends Unstable_InteractableStateSchema>(
   const initialStateRef = useRef(config.initialState);
   initialStateRef.current = config.initialState;
 
-  const interactables = useAuiState(() => aui.unstable_interactables());
+  const interactables = useAuiState(() => aui.unstable_interactables);
 
   useEffect(() => {
     return interactables.register({

package/src/react/model-context/useInteractableState.ts

@@ -28,7 +28,7 @@ const useInteractableState = <TState>(
 
   const setState = useCallback(
     (updater: StateUpdater<TState>) => {
-      aui.unstable_interactables().setState(id, (prev) => {
+      aui.unstable_interactables.setState(id, (prev) => {
         if (typeof updater === "function") {
           return (updater as (prev: TState) => TState)(prev as TState);
         }
@@ -38,7 +38,7 @@ const useInteractableState = <TState>(
     [aui, id],
   );
 
-  const flush = useCallback(() => aui.unstable_interactables().flush(), [aui]);
+  const flush = useCallback(() => aui.unstable_interactables.flush(), [aui]);
 
   return [
     state,

package/src/react/primitive-hooks/useActionBarCopy.test.ts

@@ -18,10 +18,10 @@ const mocks = vi.hoisted(() => {
       },
     },
     aui: {
-      message: () => ({
+      message: {
         getCopyText: () => "Hello",
         setIsCopied,
-      }),
+      },
     },
   };
 });

package/src/react/primitive-hooks/useActionBarCopy.ts

@@ -25,15 +25,15 @@ export const useActionBarCopy = ({
   const copy = useCallback(() => {
     if (!copyToClipboard) return;
 
-    const valueToCopy = isEditing ? composerValue : aui.message().getCopyText();
+    const valueToCopy = isEditing ? composerValue : aui.message.getCopyText();
     if (!valueToCopy) return;
 
     // The rejection handler swallows clipboard write failures (permission denied,
     // API unavailable) so they don't surface as unhandled promise rejections.
     Promise.resolve(copyToClipboard(valueToCopy)).then(
       () => {
-        aui.message().setIsCopied(true);
-        setTimeout(() => aui.message().setIsCopied(false), copiedDuration);
+        aui.message.setIsCopied(true);
+        setTimeout(() => aui.message.setIsCopied(false), copiedDuration);
       },
       () => {},
     );

package/src/react/primitive-hooks/useActionBarEdit.ts

@@ -6,7 +6,7 @@ export const useActionBarEdit = () => {
   const disabled = useAuiState((s) => s.composer.isEditing);
 
   const edit = useCallback(() => {
-    aui.composer().beginEdit();
+    aui.composer.beginEdit();
   }, [aui]);
 
   return { edit, disabled };

package/src/react/primitive-hooks/useActionBarFeedback.ts

@@ -8,7 +8,7 @@ export const useActionBarFeedbackPositive = () => {
   );
 
   const submit = useCallback(() => {
-    aui.message().submitFeedback({ type: "positive" });
+    aui.message.submitFeedback({ type: "positive" });
   }, [aui]);
 
   return { submit, isSubmitted };
@@ -21,7 +21,7 @@ export const useActionBarFeedbackNegative = () => {
   );
 
   const submit = useCallback(() => {
-    aui.message().submitFeedback({ type: "negative" });
+    aui.message.submitFeedback({ type: "negative" });
   }, [aui]);
 
   return { submit, isSubmitted };

package/src/react/primitive-hooks/useActionBarReload.ts

@@ -11,7 +11,7 @@ export const useActionBarReload = () => {
   );
 
   const reload = useCallback(() => {
-    aui.message().reload();
+    aui.message.reload();
   }, [aui]);
 
   return { reload, disabled };

package/src/react/primitive-hooks/useActionBarSpeak.ts

@@ -13,7 +13,7 @@ export const useActionBarSpeak = () => {
   });
 
   const speak = useCallback(async () => {
-    aui.message().speak();
+    aui.message.speak();
   }, [aui]);
 
   return { speak, disabled };

package/src/react/primitive-hooks/useActionBarStopSpeaking.ts

@@ -6,7 +6,7 @@ export const useActionBarStopSpeaking = () => {
   const disabled = useAuiState((s) => s.message.speech == null);
 
   const stopSpeaking = useCallback(() => {
-    aui.message().stopSpeaking();
+    aui.message.stopSpeaking();
   }, [aui]);
 
   return { stopSpeaking, disabled };

package/src/react/primitive-hooks/useBranchPickerNext.ts

@@ -12,7 +12,7 @@ export const useBranchPickerNext = () => {
   });
 
   const next = useCallback(() => {
-    aui.message().switchToBranch({ position: "next" });
+    aui.message.switchToBranch({ position: "next" });
   }, [aui]);
 
   return { next, disabled };

package/src/react/primitive-hooks/useBranchPickerPrevious.ts

@@ -12,7 +12,7 @@ export const useBranchPickerPrevious = () => {
   });
 
   const previous = useCallback(() => {
-    aui.message().switchToBranch({ position: "previous" });
+    aui.message.switchToBranch({ position: "previous" });
   }, [aui]);
 
   return { previous, disabled };

package/src/react/primitive-hooks/useComposerAddAttachment.ts

@@ -8,7 +8,7 @@ export const useComposerAddAttachment = () => {
 
   const addAttachment = useCallback(
     (file: File | CreateAttachment) => {
-      return aui.composer().addAttachment(file);
+      return aui.composer.addAttachment(file);
     },
     [aui],
   );

package/src/react/primitive-hooks/useComposerCancel.ts

@@ -6,7 +6,7 @@ export const useComposerCancel = () => {
   const disabled = useAuiState((s) => !s.composer.canCancel);
 
   const cancel = useCallback(() => {
-    aui.composer().cancel();
+    aui.composer.cancel();
   }, [aui]);
 
   return { cancel, disabled };

package/src/react/primitive-hooks/useComposerDictate.ts

@@ -11,7 +11,7 @@ export const useComposerDictate = () => {
   );
 
   const startDictation = useCallback(() => {
-    aui.composer().startDictation();
+    aui.composer.startDictation();
   }, [aui]);
 
   return { startDictation, disabled };

package/src/react/primitive-hooks/useComposerSend.ts

@@ -12,7 +12,7 @@ export const useComposerSend = () => {
 
   const send = useCallback(
     (opts?: ComposerSendOptions) => {
-      aui.composer().send(opts);
+      aui.composer.send(opts);
     },
     [aui],
   );

package/src/react/primitive-hooks/useEditComposerCancel.ts

@@ -5,7 +5,7 @@ export const useEditComposerCancel = () => {
   const aui = useAui();
 
   const cancel = useCallback(() => {
-    aui.composer().cancel();
+    aui.composer.cancel();
   }, [aui]);
 
   return { cancel };

package/src/react/primitive-hooks/useEditComposerSend.ts

@@ -6,7 +6,7 @@ export const useEditComposerSend = () => {
   const disabled = useAuiState((s) => s.composer.isEmpty);
 
   const send = useCallback(() => {
-    aui.composer().send();
+    aui.composer.send();
   }, [aui]);
 
   return { send, disabled };

package/src/react/primitive-hooks/useMessageBranching.ts

@@ -7,11 +7,11 @@ export const useMessageBranching = () => {
   const branchCount = useAuiState((s) => s.message.branchCount);
 
   const goToPrev = useCallback(() => {
-    aui.message().switchToBranch({ position: "previous" });
+    aui.message.switchToBranch({ position: "previous" });
   }, [aui]);
 
   const goToNext = useCallback(() => {
-    aui.message().switchToBranch({ position: "next" });
+    aui.message.switchToBranch({ position: "next" });
   }, [aui]);
 
   return { branchNumber, branchCount, goToPrev, goToNext };

package/src/react/primitive-hooks/useMessageReload.ts

@@ -6,7 +6,7 @@ export const useMessageReload = () => {
   const canReload = useAuiState((s) => s.message.role === "assistant");
 
   const reload = useCallback(() => {
-    aui.message().reload();
+    aui.message.reload();
   }, [aui]);
 
   return { reload, canReload };

package/src/react/primitive-hooks/useSuggestionTrigger.ts

@@ -17,24 +17,24 @@ export const useSuggestionTrigger = ({
   const resolvedSend = send ?? false;
 
   const trigger = useCallback(() => {
-    const isRunning = aui.thread().getState().isRunning;
+    const isRunning = aui.thread.getState().isRunning;
 
     if (resolvedSend && !isRunning) {
-      aui.thread().append({
+      aui.thread.append({
         content: [{ type: "text", text: prompt }],
-        runConfig: aui.composer().getState().runConfig,
+        runConfig: aui.composer.getState().runConfig,
       });
       if (clearComposer) {
-        aui.composer().setText("");
+        aui.composer.setText("");
       }
     } else {
       if (clearComposer) {
-        aui.composer().setText(prompt);
+        aui.composer.setText(prompt);
       } else {
-        const currentText = aui.composer().getState().text;
-        aui
-          .composer()
-          .setText(currentText.trim() ? `${currentText} ${prompt}` : prompt);
+        const currentText = aui.composer.getState().text;
+        aui.composer.setText(
+          currentText.trim() ? `${currentText} ${prompt}` : prompt,
+        );
       }
     }
   }, [aui, resolvedSend, clearComposer, prompt]);

package/src/react/primitive-hooks/useThreadListItemArchive.ts

@@ -5,7 +5,7 @@ export const useThreadListItemArchive = () => {
   const aui = useAui();
 
   const archive = useCallback(() => {
-    aui.threadListItem().archive();
+    aui.threadListItem.archive();
   }, [aui]);
 
   return { archive };

package/src/react/primitive-hooks/useThreadListItemDelete.ts

@@ -5,7 +5,7 @@ export const useThreadListItemDelete = () => {
   const aui = useAui();
 
   const deleteThread = useCallback(() => {
-    aui.threadListItem().delete();
+    aui.threadListItem.delete();
   }, [aui]);
 
   return { delete: deleteThread };

package/src/react/primitive-hooks/useThreadListItemTrigger.ts

@@ -5,7 +5,7 @@ export const useThreadListItemTrigger = () => {
   const aui = useAui();
 
   const switchTo = useCallback(() => {
-    aui.threadListItem().switchTo();
+    aui.threadListItem.switchTo();
   }, [aui]);
 
   return { switchTo };

package/src/react/primitive-hooks/useThreadListItemUnarchive.ts

@@ -5,7 +5,7 @@ export const useThreadListItemUnarchive = () => {
   const aui = useAui();
 
   const unarchive = useCallback(() => {
-    aui.threadListItem().unarchive();
+    aui.threadListItem.unarchive();
   }, [aui]);
 
   return { unarchive };

package/src/react/primitive-hooks/useThreadListLoadMore.ts

@@ -8,7 +8,7 @@ export const useThreadListLoadMore = () => {
   );
 
   const loadMore = useCallback(() => {
-    aui.threads().loadMore();
+    aui.threads.loadMore();
   }, [aui]);
 
   return { loadMore, disabled };

package/src/react/primitive-hooks/useThreadListNew.ts

@@ -5,7 +5,7 @@ export const useThreadListNew = () => {
   const aui = useAui();
 
   const switchToNewThread = useCallback(() => {
-    aui.threads().switchToNewThread();
+    aui.threads.switchToNewThread();
   }, [aui]);
 
   return { switchToNewThread };

package/src/react/primitive-hooks/useVoice.ts

@@ -10,7 +10,7 @@ const getServerVolume = () => 0;
 
 export const useVoiceVolume = (): number => {
   const aui = useAui();
-  const thread = aui.thread();
+  const thread = aui.thread;
   return useSyncExternalStore(
     thread.subscribeVoiceVolume,
     thread.getVoiceVolume,
@@ -22,19 +22,19 @@ export const useVoiceControls = () => {
   const aui = useAui();
 
   const connect = useCallback(() => {
-    aui.thread().connectVoice();
+    aui.thread.connectVoice();
   }, [aui]);
 
   const disconnect = useCallback(() => {
-    aui.thread().disconnectVoice();
+    aui.thread.disconnectVoice();
   }, [aui]);
 
   const mute = useCallback(() => {
-    aui.thread().muteVoice();
+    aui.thread.muteVoice();
   }, [aui]);
 
   const unmute = useCallback(() => {
-    aui.thread().unmuteVoice();
+    aui.thread.unmuteVoice();
   }, [aui]);
 
   return { connect, disconnect, mute, unmute };

package/src/react/primitives/chainOfThought/ChainOfThoughtParts.tsx

@@ -51,7 +51,7 @@ const ChainOfThoughtPrimitivePartsInner: FC<{
       Array.from({ length: partsLength }, (_, index) => (
         <ChainOfThoughtPartByIndexProvider key={index} index={index}>
           <RenderChildrenWithAccessor
-            getItemState={(aui) => aui.part().getState()}
+            getItemState={(aui) => aui.part.getState()}
           >
             {(getItem) =>
               children({

package/src/react/primitives/composer/ComposerAttachments.tsx

@@ -99,7 +99,7 @@ const ComposerPrimitiveAttachmentsInner: FC<{
         <ComposerAttachmentByIndexProvider key={index} index={index}>
           <RenderChildrenWithAccessor
             getItemState={(aui) =>
-              aui.composer().attachment({ index }).getState()
+              aui.composer.attachment({ index }).getState()
             }
           >
             {(getItem) =>

package/src/react/primitives/composer/ComposerQueue.tsx

@@ -20,9 +20,7 @@ const ComposerPrimitiveQueueInner: FC<{
       Array.from({ length: queue }, (_, index) => (
         <QueueItemByIndexProvider key={index} index={index}>
           <RenderChildrenWithAccessor
-            getItemState={(aui) =>
-              aui.composer().queueItem({ index }).getState()
-            }
+            getItemState={(aui) => aui.composer.queueItem({ index }).getState()}
           >
             {(getItem) =>
               children({

package/src/react/primitives/message/MessageAttachments.tsx

@@ -101,9 +101,7 @@ const MessagePrimitiveAttachmentsInner: FC<{
       Array.from({ length: attachmentsCount }, (_, index) => (
         <MessageAttachmentByIndexProvider key={index} index={index}>
           <RenderChildrenWithAccessor
-            getItemState={(aui) =>
-              aui.message().attachment({ index }).getState()
-            }
+            getItemState={(aui) => aui.message.attachment({ index }).getState()}
           >
             {(getItem) =>
               children({

package/src/react/primitives/message/MessageParts.tsx

@@ -415,9 +415,9 @@ export const MessagePartComponent: FC<MessagePartComponentProps> = ({
 
   const type = part.type;
   if (type === "tool-call") {
-    const addResult = aui.part().addToolResult;
-    const resume = aui.part().resumeToolCall;
-    const respondToApproval = aui.part().respondToToolApproval;
+    const addResult = aui.part.addToolResult;
+    const resume = aui.part.resumeToolCall;
+    const respondToApproval = aui.part.respondToToolApproval;
     if ("Override" in tools)
       return (
         <tools.Override
@@ -636,9 +636,9 @@ const RegisteredToolUI: FC = () => {
   return (
     <Render
       {...part}
-      addResult={aui.part().addToolResult}
-      resume={aui.part().resumeToolCall}
-      respondToApproval={aui.part().respondToToolApproval}
+      addResult={aui.part.addToolResult}
+      resume={aui.part.resumeToolCall}
+      respondToApproval={aui.part.respondToToolApproval}
     />
   );
 };
@@ -743,16 +743,16 @@ const MessagePartChildrenInner: FC<
 
   return (
     <RenderChildrenWithAccessor
-      getItemState={(client) => client.part().getState()}
+      getItemState={(client) => client.part.getState()}
     >
       {(getItem) =>
         children({
           get part() {
             const state = getItem();
             if (state.type === "tool-call") {
-              const toolsState = aui.tools().getState();
+              const toolsState = aui.tools.getState();
               const hasUI = resolveToolRender(toolsState, state) !== null;
-              const partMethods = aui.part();
+              const partMethods = aui.part;
               return {
                 ...state,
                 toolUI: hasUI ? <RegisteredToolUI /> : null,

package/src/react/primitives/thread/ThreadMessages.tsx

@@ -247,7 +247,7 @@ const ThreadPrimitiveMessagesInner: FC<{
     return Array.from({ length: messagesLength }, (_, index) => (
       <MessageByIndexProvider key={index} index={index}>
         <RenderChildrenWithAccessor
-          getItemState={(aui) => aui.thread().message({ index }).getState()}
+          getItemState={(aui) => aui.thread.message({ index }).getState()}
         >
           {(getItem) =>
             children({

package/src/react/primitives/thread/ThreadSuggestions.tsx

@@ -77,7 +77,7 @@ const ThreadPrimitiveSuggestionsInner: FC<{
       <SuggestionByIndexProvider key={index} index={index}>
         <RenderChildrenWithAccessor
           getItemState={(aui) =>
-            aui.suggestions().suggestion({ index }).getState()
+            aui.suggestions.suggestion({ index }).getState()
           }
         >
           {(getItem) =>