@assistant-ui/react 0.12.1 → 0.12.3

package/dist/types/scopes/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/types/scopes/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAqB;AAEtD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,IAAI,gBAAgB,CAAC;IAC7B,UAAU,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC"}

package/dist/types/scopes/suggestions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suggestions.js.map

package/dist/types/scopes/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../../src/types/scopes/suggestions.ts"],"names":[],"mappings":""}

package/dist/types/store-augmentation.d.ts

@@ -8,6 +8,8 @@ import type { ComposerClientSchema } from "./scopes/composer.js";
 import type { AttachmentClientSchema } from "./scopes/attachment.js";
 import type { ToolsClientSchema } from "./scopes/tools.js";
 import type { ModelContextClientSchema } from "./scopes/modelContext.js";
+import type { SuggestionsClientSchema } from "./scopes/suggestions.js";
+import type { SuggestionClientSchema } from "./scopes/suggestion.js";
 declare module "@assistant-ui/store" {
     interface ClientRegistry {
         threads: ThreadsClientSchema;
@@ -19,6 +21,8 @@ declare module "@assistant-ui/store" {
         attachment: AttachmentClientSchema;
         tools: ToolsClientSchema;
         modelContext: ModelContextClientSchema;
+        suggestions: SuggestionsClientSchema;
+        suggestion: SuggestionClientSchema;
     }
 }
 //# sourceMappingURL=store-augmentation.d.ts.map

package/dist/types/store-augmentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-augmentation.d.ts","sourceRoot":"","sources":["../../src/types/store-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAgC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAAwB;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAsB;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,6BAA0B;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAuB;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iCAA8B;AAEtE,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,cAAc;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,cAAc,EAAE,0BAA0B,CAAC;QAC3C,MAAM,EAAE,kBAAkB,CAAC;QAC3B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,IAAI,EAAE,gBAAgB,CAAC;QACvB,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,KAAK,EAAE,iBAAiB,CAAC;QACzB,YAAY,EAAE,wBAAwB,CAAC;KACxC;CACF"}
+{"version":3,"file":"store-augmentation.d.ts","sourceRoot":"","sources":["../../src/types/store-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAgC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAAwB;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAAyB;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAsB;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,6BAA0B;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAuB;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iCAA8B;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,gCAA6B;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,+BAA4B;AAElE,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,cAAc;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,cAAc,EAAE,0BAA0B,CAAC;QAC3C,MAAM,EAAE,kBAAkB,CAAC;QAC3B,OAAO,EAAE,mBAAmB,CAAC;QAC7B,IAAI,EAAE,gBAAgB,CAAC;QACvB,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,KAAK,EAAE,iBAAiB,CAAC;QACzB,YAAY,EAAE,wBAAwB,CAAC;QACvC,WAAW,EAAE,uBAAuB,CAAC;QACrC,UAAU,EAAE,sBAAsB,CAAC;KACpC;CACF"}

package/dist/utils/idUtils.d.ts

@@ -1,4 +1,6 @@
 export declare const generateId: (size?: number) => string;
 export declare const generateOptimisticId: () => string;
 export declare const isOptimisticId: (id: string) => boolean;
+export declare const generateErrorMessageId: () => string;
+export declare const isErrorMessageId: (id: string) => boolean;
 //# sourceMappingURL=idUtils.d.ts.map

package/dist/utils/idUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idUtils.d.ts","sourceRoot":"","sources":["../../src/utils/idUtils.tsx"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,2BAGtB,CAAC;AAGF,eAAO,MAAM,oBAAoB,cAA6C,CAAC;AAC/E,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,YAAoC,CAAC"}
+{"version":3,"file":"idUtils.d.ts","sourceRoot":"","sources":["../../src/utils/idUtils.tsx"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,2BAGtB,CAAC;AAGF,eAAO,MAAM,oBAAoB,cAA6C,CAAC;AAC/E,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,YAAoC,CAAC;AAG9E,eAAO,MAAM,sBAAsB,cAAwC,CAAC;AAC5E,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,YAA+B,CAAC"}

package/dist/utils/idUtils.js

@@ -3,4 +3,7 @@ export const generateId = customAlphabet("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZab
 const optimisticPrefix = "__optimistic__";
 export const generateOptimisticId = () => `${optimisticPrefix}${generateId()}`;
 export const isOptimisticId = (id) => id.startsWith(optimisticPrefix);
+const errorPrefix = "__error__";
+export const generateErrorMessageId = () => `${errorPrefix}${generateId()}`;
+export const isErrorMessageId = (id) => id.startsWith(errorPrefix);
 //# sourceMappingURL=idUtils.js.map

package/dist/utils/idUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"idUtils.js","sourceRoot":"","sources":["../../src/utils/idUtils.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CACtC,gEAAgE,EAChE,CAAC,CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,GAAG,UAAU,EAAE,EAAE,CAAC;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"idUtils.js","sourceRoot":"","sources":["../../src/utils/idUtils.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CACtC,gEAAgE,EAChE,CAAC,CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC,GAAG,gBAAgB,GAAG,UAAU,EAAE,EAAE,CAAC;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAE9E,MAAM,WAAW,GAAG,WAAW,CAAC;AAChC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAAC,GAAG,WAAW,GAAG,UAAU,EAAE,EAAE,CAAC;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "TypeScript/React library for AI Chat",
   "keywords": [
     "radix-ui",
@@ -49,9 +49,9 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-cloud": "^0.1.13",
-    "@assistant-ui/tap": "^0.4.0",
-    "@assistant-ui/store": "^0.1.0",
+    "assistant-cloud": "^0.1.15",
+    "@assistant-ui/tap": "^0.4.2",
+    "@assistant-ui/store": "^0.1.2",
     "@radix-ui/primitive": "^1.1.3",
     "@radix-ui/react-compose-refs": "^1.1.2",
     "@radix-ui/react-context": "^1.1.3",
@@ -61,10 +61,10 @@
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-use-callback-ref": "^1.1.1",
     "@radix-ui/react-use-escape-keydown": "^1.1.1",
-    "assistant-stream": "^0.2.47",
+    "assistant-stream": "^0.3.0",
     "nanoid": "^5.1.6",
     "react-textarea-autosize": "^8.5.9",
-    "zod": "^4.3.5",
+    "zod": "^4.3.6",
     "zustand": "^5.0.10"
   },
   "peerDependencies": {
@@ -83,12 +83,12 @@
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "@types/react": "^19.2.9",
     "@types/react-dom": "^19.2.3",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "vitest": "^4.0.17",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "vitest": "^4.0.18",
     "@assistant-ui/x-buildutils": "0.0.1"
   },
   "publishConfig": {

package/src/client/Suggestions.ts

@@ -0,0 +1,74 @@
+import { resource, tapState, withKey } from "@assistant-ui/tap";
+import { type ClientOutput, tapClientLookup } from "@assistant-ui/store";
+import type { SuggestionsState, SuggestionState } from "../types/scopes";
+
+export type SuggestionConfig =
+  | string
+  | { title: string; label: string; prompt: string };
+
+const SuggestionClient = resource(
+  (state: SuggestionState): ClientOutput<"suggestion"> => {
+    return {
+      state,
+      methods: {
+        getState: () => state,
+      },
+    };
+  },
+);
+
+const SuggestionsResource = resource(
+  (suggestions?: SuggestionConfig[]): ClientOutput<"suggestions"> => {
+    const [state] = tapState<SuggestionsState>(() => {
+      const normalizedSuggestions = (suggestions ?? []).map((s) => {
+        if (typeof s === "string") {
+          return {
+            title: s,
+            label: "",
+            prompt: s,
+          };
+        }
+        return {
+          title: s.title,
+          label: s.label,
+          prompt: s.prompt,
+        };
+      });
+
+      return {
+        suggestions: normalizedSuggestions,
+      };
+    });
+
+    const suggestionClients = tapClientLookup(
+      () =>
+        state.suggestions.map((suggestion, index) =>
+          withKey(index, SuggestionClient(suggestion)),
+        ),
+      [state.suggestions],
+    );
+
+    return {
+      state,
+      methods: {
+        getState: () => state,
+        suggestion: ({ index }: { index: number }) => {
+          return suggestionClients.get({ index });
+        },
+      },
+    };
+  },
+);
+
+export const Suggestions: {
+  (): import("@assistant-ui/tap").ResourceElement<
+    ClientOutput<"suggestions">,
+    undefined
+  >;
+  (
+    suggestions: SuggestionConfig[],
+  ): import("@assistant-ui/tap").ResourceElement<
+    ClientOutput<"suggestions">,
+    SuggestionConfig[]
+  >;
+} = SuggestionsResource as any;

package/src/client/Tools.ts

@@ -1,9 +1,14 @@
 import { resource, tapState, tapEffect, tapCallback } from "@assistant-ui/tap";
-import { tapAssistantClientRef, type ClientOutput } from "@assistant-ui/store";
+import {
+  tapAssistantClientRef,
+  type ClientOutput,
+  attachDefaultPeers,
+} from "@assistant-ui/store";
 import { ToolsState } from "../types/scopes";
 import type { Tool } from "assistant-stream";
 import { type Toolkit } from "../model-context/toolbox";
 import { ToolCallMessagePartComponent } from "../types";
+import { ModelContext } from "./ModelContextClient";
 
 export const Tools = resource(
   ({ toolkit }: { toolkit?: Toolkit }): ClientOutput<"tools"> => {
@@ -86,3 +91,7 @@ export const Tools = resource(
     };
   },
 );
+
+attachDefaultPeers(Tools, {
+  modelContext: ModelContext(),
+});

package/src/context/providers/SuggestionByIndexProvider.tsx

@@ -0,0 +1,23 @@
+"use client";
+
+import { type FC, type PropsWithChildren } from "react";
+import { AuiProvider, Derived, useAui } from "@assistant-ui/store";
+
+export type SuggestionByIndexProviderProps = PropsWithChildren<{
+  index: number;
+}>;
+
+export const SuggestionByIndexProvider: FC<SuggestionByIndexProviderProps> = ({
+  index,
+  children,
+}) => {
+  const aui = useAui({
+    suggestion: Derived({
+      source: "suggestions",
+      query: { index },
+      get: (aui) => aui.suggestions().suggestion({ index }),
+    }),
+  });
+
+  return <AuiProvider value={aui}>{children}</AuiProvider>;
+};

package/src/context/providers/index.ts

@@ -4,6 +4,7 @@ export {
   ThreadListItemRuntimeProvider,
 } from "./ThreadListItemProvider";
 export { MessageByIndexProvider } from "./MessageByIndexProvider";
+export { SuggestionByIndexProvider } from "./SuggestionByIndexProvider";
 export { PartByIndexProvider } from "./PartByIndexProvider";
 export {
   MessageAttachmentByIndexProvider,

package/src/legacy-runtime/AssistantRuntimeProvider.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { FC, memo, PropsWithChildren } from "react";
-import { useAui, AuiProvider } from "@assistant-ui/store";
+import { useAui, AuiProvider, AssistantClient } from "@assistant-ui/store";
 import { AssistantRuntime } from "./runtime/AssistantRuntime";
 import { AssistantRuntimeCore } from "./runtime-cores/core/AssistantRuntimeCore";
 import { RuntimeAdapter } from "./RuntimeAdapter";
@@ -13,6 +13,11 @@ export namespace AssistantRuntimeProvider {
      * The runtime to provide to the rest of your app.
      */
     runtime: AssistantRuntime;
+
+    /**
+     * The aui instance to extend. If not provided, a new aui instance will be created.
+     */
+    aui?: AssistantClient;
   }>;
 }
 
@@ -22,10 +27,8 @@ const getRenderComponent = (runtime: AssistantRuntime) => {
 
 export const AssistantRuntimeProviderImpl: FC<
   AssistantRuntimeProvider.Props
-> = ({ children, runtime }) => {
-  const aui = useAui({
-    threads: RuntimeAdapter(runtime),
-  });
+> = ({ children, aui: parent = null, runtime }) => {
+  const aui = useAui({ threads: RuntimeAdapter(runtime) }, { parent: parent });
 
   const RenderComponent = getRenderComponent(runtime);
 

package/src/legacy-runtime/RuntimeAdapter.ts

@@ -7,7 +7,7 @@ import {
   attachDefaultPeers,
 } from "@assistant-ui/store";
 import { ModelContext } from "../client/ModelContextClient";
-import { Tools } from "../model-context";
+import { Tools, Suggestions } from "../model-context";
 
 export const RuntimeAdapter = resource((runtime: AssistantRuntime) => {
   const clientRef = tapAssistantClientRef();
@@ -29,6 +29,7 @@ export const RuntimeAdapter = resource((runtime: AssistantRuntime) => {
 attachDefaultPeers(RuntimeAdapter, {
   modelContext: ModelContext(),
   tools: Tools({}),
+  suggestions: Suggestions(),
   threadListItem: Derived({
     source: "threads",
     query: { type: "main" },

package/src/legacy-runtime/runtime-cores/assistant-transport/useAssistantTransportRuntime.tsx

@@ -15,6 +15,7 @@ import {
   DataStreamDecoder,
   AssistantTransportDecoder,
   unstable_createInitialMessage as createInitialMessage,
+  toToolsJSONSchema,
 } from "assistant-stream";
 import {
   AssistantTransportOptions,
@@ -28,7 +29,7 @@ import { useCommandQueue } from "./commandQueue";
 import { useRunManager } from "./runManager";
 import { useConvertedState } from "./useConvertedState";
 import { ToolExecutionStatus, useToolInvocations } from "./useToolInvocations";
-import { toAISDKTools, getEnabledTools, createRequestHeaders } from "./utils";
+import { createRequestHeaders } from "./utils";
 import { useRemoteThreadListRuntime } from "../remote-thread-list/useRemoteThreadListRuntime";
 import { InMemoryThreadListAdapter } from "../remote-thread-list/adapter/in-memory";
 import { useAui, useAuiState } from "@assistant-ui/store";
@@ -115,9 +116,7 @@ const useAssistantTransportThreadRuntime = <T,>(
             commands,
             state: agentStateRef.current,
             system: context.system,
-            tools: context.tools
-              ? toAISDKTools(getEnabledTools(context.tools))
-              : undefined,
+            tools: context.tools ? toToolsJSONSchema(context.tools) : undefined,
             threadId,
             ...(parentIdRef.current !== undefined && {
               parentId: parentIdRef.current,

package/src/legacy-runtime/runtime-cores/assistant-transport/utils.ts

@@ -1,42 +1,37 @@
-import { Tool } from "assistant-stream";
-import type { JSONSchema7 } from "json-schema";
-import { z } from "zod";
+import { Tool, toToolsJSONSchema, type ToolJSONSchema } from "assistant-stream";
 
-// Convert tools to AI SDK format
-export const toAISDKTools = (tools: Record<string, Tool>) => {
-  return Object.fromEntries(
-    Object.entries(tools).map(([name, tool]) => [
-      name,
-      {
-        ...(tool.description ? { description: tool.description } : undefined),
-        parameters: (tool.parameters instanceof z.ZodType
-          ? z.toJSONSchema(tool.parameters)
-          : tool.parameters) as JSONSchema7,
-      },
-    ]),
-  );
-};
+/**
+ * @deprecated Use `toToolsJSONSchema` from `assistant-stream` instead.
+ */
+export function toAISDKTools(
+  tools: Record<string, Tool>,
+): Record<string, ToolJSONSchema> {
+  return toToolsJSONSchema(tools, { filter: () => true });
+}
 
-// Filter enabled tools
-export const getEnabledTools = (tools: Record<string, Tool>) => {
+/**
+ * @deprecated Use `toToolsJSONSchema` from `assistant-stream` instead, which includes filtering by default.
+ */
+export function getEnabledTools(
+  tools: Record<string, Tool>,
+): Record<string, Tool> {
   return Object.fromEntries(
     Object.entries(tools).filter(
       ([, tool]) => !tool.disabled && tool.type !== "backend",
     ),
   );
-};
+}
 
-// Create headers for fetch request
-export const createRequestHeaders = async (
+export async function createRequestHeaders(
   headersValue:
     | Record<string, string>
     | Headers
     | (() => Promise<Record<string, string> | Headers>),
-): Promise<Headers> => {
+): Promise<Headers> {
   const resolvedHeaders =
     typeof headersValue === "function" ? await headersValue() : headersValue;
 
   const headers = new Headers(resolvedHeaders);
   headers.set("Content-Type", "application/json");
   return headers;
-};
+}

package/src/legacy-runtime/runtime-cores/external-store/external-message-converter.tsx

@@ -11,6 +11,8 @@ import { getAutoStatus, isAutoStatus } from "./auto-status";
 import { ThreadMessage, ToolCallMessagePart } from "../../../types";
 import { ToolExecutionStatus } from "../assistant-transport/useToolInvocations";
 import { ReadonlyJSONValue } from "assistant-stream/utils";
+import { generateErrorMessageId } from "../../../utils/idUtils";
+import { ThreadAssistantMessage } from "../../../types/AssistantTypes";
 
 export namespace useExternalMessageConverter {
   export type Message =
@@ -262,6 +264,28 @@ const chunkExternalMessages = <T,>(
   return results;
 };
 
+function createErrorAssistantMessage(
+  error: ReadonlyJSONValue,
+): ThreadAssistantMessage {
+  return Object.assign<ThreadAssistantMessage, { [symbolInnerMessage]: [] }>(
+    {
+      id: generateErrorMessageId(),
+      role: "assistant",
+      content: [],
+      status: { type: "incomplete", reason: "error", error },
+      createdAt: new Date(),
+      metadata: {
+        unstable_state: null,
+        unstable_annotations: [],
+        unstable_data: [],
+        custom: {},
+        steps: [],
+      },
+    },
+    { [symbolInnerMessage]: [] },
+  );
+}
+
 export const convertExternalMessages = <T extends WeakKey>(
   messages: T[],
   callback: useExternalMessageConverter.Callback<T>,
@@ -278,14 +302,9 @@ export const convertExternalMessages = <T extends WeakKey>(
 
   const chunks = chunkExternalMessages(callbackResults);
 
-  return chunks.map((message, idx) => {
+  const result = chunks.map((message, idx) => {
     const isLast = idx === chunks.length - 1;
     const joined = joinExternalMessages(message.outputs);
-    const hasSuspendedToolCalls =
-      typeof joined.content === "object" &&
-      joined.content.some(
-        (c) => c.type === "tool-call" && c.result === undefined,
-      );
     const hasPendingToolCalls =
       typeof joined.content === "object" &&
       joined.content.some(
@@ -294,7 +313,7 @@ export const convertExternalMessages = <T extends WeakKey>(
     const autoStatus = getAutoStatus(
       isLast,
       isRunning,
-      hasSuspendedToolCalls,
+      hasPendingToolCalls,
       hasPendingToolCalls,
       isLast ? metadata.error : undefined,
     );
@@ -306,6 +325,15 @@ export const convertExternalMessages = <T extends WeakKey>(
     (newMessage as any)[symbolInnerMessage] = message.inputs;
     return newMessage;
   });
+
+  if (metadata.error) {
+    const lastMessage = result.at(-1);
+    if (!lastMessage || lastMessage.role !== "assistant") {
+      result.push(createErrorAssistantMessage(metadata.error));
+    }
+  }
+
+  return result;
 };
 
 export const useExternalMessageConverter = <T extends WeakKey>({
@@ -411,6 +439,13 @@ export const useExternalMessageConverter = <T extends WeakKey>({
       symbolInnerMessage
     ] = messages;
 
+    if (state.metadata.error) {
+      const lastMessage = threadMessages.at(-1);
+      if (!lastMessage || lastMessage.role !== "assistant") {
+        threadMessages.push(createErrorAssistantMessage(state.metadata.error));
+      }
+    }
+
     return threadMessages;
   }, [state, messages, isRunning, joinStrategy]);
 };

package/src/legacy-runtime/runtime-cores/remote-thread-list/BaseSubscribable.tsx

@@ -31,6 +31,9 @@ export class BaseSubscribable {
       if (errors.length === 1) {
         throw errors[0];
       } else {
+        for (const error of errors) {
+          console.error(error);
+        }
         throw new AggregateError(errors);
       }
     }

package/src/model-context/index.ts

@@ -23,5 +23,7 @@ export type { Toolkit, ToolDefinition } from "./toolbox";
 
 export { Tools } from "../client/Tools";
 
+export { Suggestions, type SuggestionConfig } from "../client/Suggestions";
+
 export * from "./registry";
 export * from "./frame";

package/src/primitives/assistantModal/AssistantModalRoot.tsx

@@ -28,7 +28,7 @@ const useAssistantModalOpenState = ({
     return aui.on("thread.runStart", () => {
       setOpen(true);
     });
-  }, [unstable_openOnRunStart, setOpen, aui]);
+  }, [unstable_openOnRunStart, aui]);
 
   return state;
 };

package/src/primitives/index.ts

@@ -8,6 +8,7 @@ export * as MessagePartPrimitive from "./messagePart";
 export * as ErrorPrimitive from "./error";
 export * as MessagePrimitive from "./message";
 export * as ThreadPrimitive from "./thread";
+export * as SuggestionPrimitive from "./suggestion";
 export * as ThreadListPrimitive from "./threadList";
 export * as ThreadListItemPrimitive from "./threadListItem";
 export * as ThreadListItemMorePrimitive from "./threadListItemMore";

package/src/primitives/message/MessageParts.tsx

@@ -242,6 +242,17 @@ export namespace MessagePrimitiveParts {
           ReasoningGroup?: ReasoningGroupComponent;
         }
       | undefined;
+    /**
+     * When enabled, shows the Empty component if the last part in the message
+     * is anything other than Text or Reasoning.
+     *
+     * This can be useful to ensure there's always a visible element at the end
+     * of messages that end with non-text content like tool calls or images.
+     *
+     * @experimental This API is experimental and may change in future versions.
+     * @default true
+     */
+    unstable_showEmptyOnNonTextEnd?: boolean | undefined;
   };
 }
 
@@ -429,6 +440,30 @@ const EmptyParts = memo(
     prev.components?.Text === next.components?.Text,
 );
 
+const ConditionalEmptyImpl: FC<{
+  components: MessagePrimitiveParts.Props["components"];
+  enabled: boolean;
+}> = ({ components, enabled }) => {
+  const shouldShowEmpty = useAuiState(({ message }) => {
+    if (!enabled) return false;
+    if (message.parts.length === 0) return false;
+
+    const lastPart = message.parts[message.parts.length - 1];
+    return lastPart?.type !== "text" && lastPart?.type !== "reasoning";
+  });
+
+  if (!shouldShowEmpty) return null;
+  return <EmptyParts components={components} />;
+};
+
+const ConditionalEmpty = memo(
+  ConditionalEmptyImpl,
+  (prev, next) =>
+    prev.enabled === next.enabled &&
+    prev.components?.Empty === next.components?.Empty &&
+    prev.components?.Text === next.components?.Text,
+);
+
 /**
  * Renders the parts of a message with support for multiple content types.
  *
@@ -455,6 +490,7 @@ const EmptyParts = memo(
  */
 export const MessagePrimitiveParts: FC<MessagePrimitiveParts.Props> = ({
   components,
+  unstable_showEmptyOnNonTextEnd = true,
 }) => {
   const contentLength = useAuiState(({ message }) => message.parts.length);
   const messageRanges = useMessagePartsGroups();
@@ -520,7 +556,15 @@ export const MessagePrimitiveParts: FC<MessagePrimitiveParts.Props> = ({
     });
   }, [messageRanges, components, contentLength]);
 
-  return <>{partsElements}</>;
+  return (
+    <>
+      {partsElements}
+      <ConditionalEmpty
+        components={components}
+        enabled={unstable_showEmptyOnNonTextEnd}
+      />
+    </>
+  );
 };
 
 MessagePrimitiveParts.displayName = "MessagePrimitive.Parts";

package/src/primitives/suggestion/SuggestionDescription.tsx

@@ -0,0 +1,33 @@
+"use client";
+
+import { Primitive } from "@radix-ui/react-primitive";
+import { type ElementRef, forwardRef, ComponentPropsWithoutRef } from "react";
+import { useAuiState } from "@assistant-ui/store";
+
+export namespace SuggestionPrimitiveDescription {
+  export type Element = ElementRef<typeof Primitive.span>;
+  export type Props = ComponentPropsWithoutRef<typeof Primitive.span>;
+}
+
+/**
+ * Renders the description/label of the suggestion.
+ *
+ * @example
+ * ```tsx
+ * <SuggestionPrimitive.Description />
+ * ```
+ */
+export const SuggestionPrimitiveDescription = forwardRef<
+  SuggestionPrimitiveDescription.Element,
+  SuggestionPrimitiveDescription.Props
+>((props, ref) => {
+  const label = useAuiState(({ suggestion }) => suggestion.label);
+
+  return (
+    <Primitive.span {...props} ref={ref}>
+      {props.children ?? label}
+    </Primitive.span>
+  );
+});
+
+SuggestionPrimitiveDescription.displayName = "SuggestionPrimitive.Description";

package/src/primitives/suggestion/SuggestionTitle.tsx

@@ -0,0 +1,33 @@
+"use client";
+
+import { Primitive } from "@radix-ui/react-primitive";
+import { type ElementRef, forwardRef, ComponentPropsWithoutRef } from "react";
+import { useAuiState } from "@assistant-ui/store";
+
+export namespace SuggestionPrimitiveTitle {
+  export type Element = ElementRef<typeof Primitive.span>;
+  export type Props = ComponentPropsWithoutRef<typeof Primitive.span>;
+}
+
+/**
+ * Renders the title of the suggestion.
+ *
+ * @example
+ * ```tsx
+ * <SuggestionPrimitive.Title />
+ * ```
+ */
+export const SuggestionPrimitiveTitle = forwardRef<
+  SuggestionPrimitiveTitle.Element,
+  SuggestionPrimitiveTitle.Props
+>((props, ref) => {
+  const title = useAuiState(({ suggestion }) => suggestion.title);
+
+  return (
+    <Primitive.span {...props} ref={ref}>
+      {props.children ?? title}
+    </Primitive.span>
+  );
+});
+
+SuggestionPrimitiveTitle.displayName = "SuggestionPrimitive.Title";