@assistant-ui/react 0.11.23 → 0.11.25

package/dist/types/MessagePartTypes.d.ts

@@ -1,4 +1,5 @@
 import { ReadonlyJSONObject } from "assistant-stream/utils";
+import type { ThreadMessage } from "./AssistantTypes";
 export type TextMessagePart = {
     readonly type: "text";
     readonly text: string;
@@ -49,6 +50,7 @@ export type ToolCallMessagePart<TArgs = ReadonlyJSONObject, TResult = unknown> =
         payload: unknown;
     };
     readonly parentId?: string;
+    readonly messages?: readonly ThreadMessage[];
 };
 export type ThreadUserMessagePart = TextMessagePart | ImageMessagePart | FileMessagePart | Unstable_AudioMessagePart;
 export type ThreadAssistantMessagePart = TextMessagePart | ReasoningMessagePart | ToolCallMessagePart | SourceMessagePart | FileMessagePart | ImageMessagePart;

package/dist/types/MessagePartTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessagePartTypes.d.ts","sourceRoot":"","sources":["../../src/types/MessagePartTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAC7B,KAAK,GAAG,kBAAkB,EAC1B,OAAO,GAAG,OAAO,IACf;IACF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,yBAAyB,CAAC;AAE9B,MAAM,MAAM,0BAA0B,GAClC,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,CAAC"}
+{"version":3,"file":"MessagePartTypes.d.ts","sourceRoot":"","sources":["../../src/types/MessagePartTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAC7B,KAAK,GAAG,kBAAkB,EAC1B,OAAO,GAAG,OAAO,IACf;IACF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,yBAAyB,CAAC;AAE9B,MAAM,MAAM,0BAA0B,GAClC,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,CAAC"}

package/package.json

@@ -28,7 +28,7 @@
     "conversational-ui",
     "conversational-ai"
   ],
-  "version": "0.11.23",
+  "version": "0.11.25",
   "license": "MIT",
   "type": "module",
   "exports": {

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

@@ -87,7 +87,10 @@ export function useToolInvocations({
           humanInputRef.current.set(toolCallId, { resolve, reject });
           setToolStatuses((prev) => ({
             ...prev,
-            [toolCallId]: { type: "interrupt", payload: { type: "human", payload } },
+            [toolCallId]: {
+              type: "interrupt",
+              payload: { type: "human", payload },
+            },
           }));
         });
       },
@@ -130,78 +133,86 @@ export function useToolInvocations({
   const isInititialState = useRef(true);
 
   useEffect(() => {
-    if (isInititialState.current) {
-      state.messages.forEach((message) => {
+    const processMessages = (
+      messages: readonly (typeof state.messages)[number][],
+    ) => {
+      messages.forEach((message) => {
         message.content.forEach((content) => {
           if (content.type === "tool-call") {
-            ignoredToolIds.current.add(content.toolCallId);
-          }
-        });
-      });
-      isInititialState.current = false;
-    } else {
-      state.messages.forEach((message) => {
-        message.content.forEach((content) => {
-          if (content.type === "tool-call") {
-            if (ignoredToolIds.current.has(content.toolCallId)) {
-              return;
-            }
-            let lastState = lastToolStates.current[content.toolCallId];
-            if (!lastState) {
-              const toolCallController = controller.addToolCallPart({
-                toolName: content.toolName,
-                toolCallId: content.toolCallId,
-              });
-              lastState = {
-                argsText: "",
-                hasResult: false,
-                controller: toolCallController,
-              };
-              lastToolStates.current[content.toolCallId] = lastState;
-            }
+            if (isInititialState.current) {
+              ignoredToolIds.current.add(content.toolCallId);
+            } else {
+              if (ignoredToolIds.current.has(content.toolCallId)) {
+                return;
+              }
+              let lastState = lastToolStates.current[content.toolCallId];
+              if (!lastState) {
+                const toolCallController = controller.addToolCallPart({
+                  toolName: content.toolName,
+                  toolCallId: content.toolCallId,
+                });
+                lastState = {
+                  argsText: "",
+                  hasResult: false,
+                  controller: toolCallController,
+                };
+                lastToolStates.current[content.toolCallId] = lastState;
+              }
+
+              if (content.argsText !== lastState.argsText) {
+                if (!content.argsText.startsWith(lastState.argsText)) {
+                  throw new Error(
+                    `Tool call argsText can only be appended, not updated: ${content.argsText} does not start with ${lastState.argsText}`,
+                  );
+                }
 
-            if (content.argsText !== lastState.argsText) {
-              if (!content.argsText.startsWith(lastState.argsText)) {
-                throw new Error(
-                  `Tool call argsText can only be appended, not updated: ${content.argsText} does not start with ${lastState.argsText}`,
+                const argsTextDelta = content.argsText.slice(
+                  lastState.argsText.length,
                 );
-              }
+                lastState.controller.argsText.append(argsTextDelta);
 
-              const argsTextDelta = content.argsText.slice(
-                lastState.argsText.length,
-              );
-              lastState.controller.argsText.append(argsTextDelta);
+                if (isArgsTextComplete(content.argsText)) {
+                  lastState.controller.argsText.close();
+                }
 
-              if (isArgsTextComplete(content.argsText)) {
-                lastState.controller.argsText.close();
+                lastToolStates.current[content.toolCallId] = {
+                  argsText: content.argsText,
+                  hasResult: lastState.hasResult,
+                  controller: lastState.controller,
+                };
               }
 
-              lastToolStates.current[content.toolCallId] = {
-                argsText: content.argsText,
-                hasResult: lastState.hasResult,
-                controller: lastState.controller,
-              };
+              if (content.result !== undefined && !lastState.hasResult) {
+                lastState.controller.setResponse(
+                  new ToolResponse({
+                    result: content.result as ReadonlyJSONValue,
+                    artifact: content.artifact as ReadonlyJSONValue | undefined,
+                    isError: content.isError,
+                  }),
+                );
+                lastState.controller.close();
+
+                lastToolStates.current[content.toolCallId] = {
+                  hasResult: true,
+                  argsText: lastState.argsText,
+                  controller: lastState.controller,
+                };
+              }
             }
 
-            if (content.result !== undefined && !lastState.hasResult) {
-              lastState.controller.setResponse(
-                new ToolResponse({
-                  result: content.result as ReadonlyJSONValue,
-                  artifact: content.artifact as ReadonlyJSONValue | undefined,
-                  isError: content.isError,
-                }),
-              );
-              lastState.controller.close();
-
-              lastToolStates.current[content.toolCallId] = {
-                hasResult: true,
-                argsText: lastState.argsText,
-                controller: lastState.controller,
-              };
+            // Recursively process nested messages
+            if (content.messages) {
+              processMessages(content.messages);
             }
           }
         });
       });
+    };
+
+    processMessages(state.messages);
+
+    if (isInititialState.current) {
+      isInititialState.current = false;
     }
   }, [state, controller, onResult]);
 
@@ -233,7 +244,9 @@ export function useToolInvocations({
         });
         handlers.resolve(payload);
       } else {
-        throw new Error(`Tool call ${toolCallId} is not waiting for human input`);
+        throw new Error(
+          `Tool call ${toolCallId} is not waiting for human input`,
+        );
       }
     },
   };

package/src/primitives/thread/ThreadSuggestion.tsx

@@ -10,23 +10,61 @@ import { useAssistantState, useAssistantApi } from "../../context";
 
 const useThreadSuggestion = ({
   prompt,
+  send,
+  clearComposer = true,
   autoSend,
+  method: _method,
 }: {
+  /** The suggestion prompt. */
   prompt: string;
-  method?: "replace";
+
+  /**
+   * When true, automatically sends the message.
+   * When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`.
+   */
+  send?: boolean | undefined;
+
+  /**
+   * Whether to clear the composer after sending.
+   * When send is set to false, determines if composer text is replaced with suggestion (true, default),
+   * or if it's appended to the composer text (false).
+   *
+   * @default true
+   */
+  clearComposer?: boolean | undefined;
+
+  /** @deprecated Use `send` instead. */
   autoSend?: boolean | undefined;
+
+  /** @deprecated Use `clearComposer` instead. */
+  method?: "replace";
 }) => {
   const api = useAssistantApi();
   const disabled = useAssistantState(({ thread }) => thread.isDisabled);
 
+  // ========== Deprecation Mapping ==========
+  const resolvedSend = send ?? autoSend ?? false;
+  // ==========================================
+
   const callback = useCallback(() => {
     const isRunning = api.thread().getState().isRunning;
-    if (autoSend && !isRunning) {
+
+    if (resolvedSend && !isRunning) {
       api.thread().append(prompt);
+      if (clearComposer) {
+        api.composer().setText("");
+      }
     } else {
-      api.composer().setText(prompt);
+      if (clearComposer) {
+        api.composer().setText(prompt);
+      } else {
+        const currentText = api.composer().getState().text;
+        api
+          .composer()
+          .setText(currentText.trim() ? `${currentText} ${prompt}` : prompt);
+      }
     }
-  }, [api, autoSend, prompt]);
+  }, [api, resolvedSend, clearComposer, prompt]);
 
   if (disabled) return null;
   return callback;
@@ -40,5 +78,5 @@ export namespace ThreadPrimitiveSuggestion {
 export const ThreadPrimitiveSuggestion = createActionButton(
   "ThreadPrimitive.Suggestion",
   useThreadSuggestion,
-  ["prompt", "autoSend", "method"],
+  ["prompt", "send", "clearComposer", "autoSend", "method"],
 );

package/src/types/MessagePartTypes.ts

@@ -1,4 +1,5 @@
 import { ReadonlyJSONObject } from "assistant-stream/utils";
+import type { ThreadMessage } from "./AssistantTypes";
 
 export type TextMessagePart = {
   readonly type: "text";
@@ -56,6 +57,7 @@ export type ToolCallMessagePart<
   readonly artifact?: unknown;
   readonly interrupt?: { type: "human"; payload: unknown };
   readonly parentId?: string;
+  readonly messages?: readonly ThreadMessage[];
 };
 
 export type ThreadUserMessagePart =