@assistant-ui/react 0.11.22 → 0.11.24

package/dist/types/MessagePartTypes.d.ts

@@ -44,7 +44,10 @@ export type ToolCallMessagePart<TArgs = ReadonlyJSONObject, TResult = unknown> =
     readonly isError?: boolean | undefined;
     readonly argsText: string;
     readonly artifact?: unknown;
-    readonly interrupt?: unknown;
+    readonly interrupt?: {
+        type: "human";
+        payload: unknown;
+    };
     readonly parentId?: string;
 };
 export type ThreadUserMessagePart = TextMessagePart | ImageMessagePart | FileMessagePart | Unstable_AudioMessagePart;

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,OAAO,CAAC;IAC7B,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;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"}

package/package.json

@@ -28,7 +28,7 @@
     "conversational-ui",
     "conversational-ai"
   ],
-  "version": "0.11.22",
+  "version": "0.11.24",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -59,7 +59,7 @@
     "@radix-ui/react-use-callback-ref": "^1.1.1",
     "@radix-ui/react-use-escape-keydown": "^1.1.1",
     "@standard-schema/spec": "^1.0.0",
-    "assistant-stream": "^0.2.32",
+    "assistant-stream": "^0.2.33",
     "json-schema": "^0.4.0",
     "nanoid": "5.1.6",
     "react-textarea-autosize": "^8.5.9",

package/src/client/types/Part.ts

@@ -27,8 +27,8 @@ export type MessagePartClientApi = {
   addToolResult(result: any | ToolResponse<any>): void;
 
   /**
-   * Resume an interrupted tool call with a payload.
-   * This is useful when a tool has interrupted its execution and is waiting for user input.
+   * Resume a tool call that is waiting for human input with a payload.
+   * This is useful when a tool has requested human input and is waiting for a response.
    */
   resumeToolCall(payload: unknown): void;
 

package/src/legacy-runtime/runtime/MessagePartRuntime.ts

@@ -31,8 +31,8 @@ export type MessagePartRuntime = {
   addToolResult(result: any | ToolResponse<any>): void;
 
   /**
-   * Resume an interrupted tool call with a payload.
-   * This is useful when a tool has interrupted its execution and is waiting for user input.
+   * Resume a tool call that is waiting for human input with a payload.
+   * This is useful when a tool has requested human input and is waiting for a response.
    */
   resumeToolCall(payload: unknown): void;
 

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

@@ -39,7 +39,7 @@ type UseToolInvocationsParams = {
 
 export type ToolExecutionStatus =
   | { type: "executing" }
-  | { type: "interrupt"; payload: unknown };
+  | { type: "interrupt"; payload: { type: "human"; payload: unknown } };
 
 export function useToolInvocations({
   state,
@@ -58,7 +58,7 @@ export function useToolInvocations({
     >
   >({});
 
-  const interruptedToolsRef = useRef<
+  const humanInputRef = useRef<
     Map<
       string,
       {
@@ -76,18 +76,21 @@ export function useToolInvocations({
       () => acRef.current?.signal ?? new AbortController().signal,
       (toolCallId: string, payload: unknown) => {
         return new Promise<unknown>((resolve, reject) => {
-          // Reject previous interrupt if it exists
-          const previous = interruptedToolsRef.current.get(toolCallId);
+          // Reject previous human input request if it exists
+          const previous = humanInputRef.current.get(toolCallId);
           if (previous) {
             previous.reject(
-              new Error("Interrupt was superseded by a new interrupt"),
+              new Error("Human input request was superseded by a new request"),
             );
           }
 
-          interruptedToolsRef.current.set(toolCallId, { resolve, reject });
+          humanInputRef.current.set(toolCallId, { resolve, reject });
           setToolStatuses((prev) => ({
             ...prev,
-            [toolCallId]: { type: "interrupt", payload },
+            [toolCallId]: {
+              type: "interrupt",
+              payload: { type: "human", payload },
+            },
           }));
         });
       },
@@ -206,10 +209,10 @@ export function useToolInvocations({
   }, [state, controller, onResult]);
 
   const abort = () => {
-    interruptedToolsRef.current.forEach(({ reject }) => {
+    humanInputRef.current.forEach(({ reject }) => {
       reject(new Error("Tool execution aborted"));
     });
-    interruptedToolsRef.current.clear();
+    humanInputRef.current.clear();
     setToolStatuses({});
 
     acRef.current.abort();
@@ -223,9 +226,9 @@ export function useToolInvocations({
     },
     abort,
     resume: (toolCallId: string, payload: unknown) => {
-      const handlers = interruptedToolsRef.current.get(toolCallId);
+      const handlers = humanInputRef.current.get(toolCallId);
       if (handlers) {
-        interruptedToolsRef.current.delete(toolCallId);
+        humanInputRef.current.delete(toolCallId);
         setToolStatuses((prev) => {
           const next = { ...prev };
           delete next[toolCallId];
@@ -233,7 +236,9 @@ export function useToolInvocations({
         });
         handlers.resolve(payload);
       } else {
-        throw new Error(`Tool call ${toolCallId} is not interrupted`);
+        throw new Error(
+          `Tool call ${toolCallId} is not waiting for human input`,
+        );
       }
     },
   };

package/src/legacy-runtime/runtime-cores/external-store/auto-status.tsx

@@ -11,7 +11,7 @@ const AUTO_STATUS_PENDING = Object.freeze({
   reason: "tool-calls",
 });
 
-const AUTO_STATUS_SUSPENDED = Object.freeze({
+const AUTO_STATUS_INTERRUPT = Object.freeze({
   type: "requires-action",
   reason: "interrupt",
 });
@@ -22,13 +22,13 @@ export const isAutoStatus = (status: MessageStatus) =>
 export const getAutoStatus = (
   isLast: boolean,
   isRunning: boolean,
-  hasSuspendedToolCalls: boolean,
+  hasInterruptedToolCalls: boolean,
   hasPendingToolCalls: boolean,
 ) =>
   isLast && isRunning
     ? AUTO_STATUS_RUNNING
-    : hasSuspendedToolCalls
-      ? AUTO_STATUS_SUSPENDED
+    : hasInterruptedToolCalls
+      ? AUTO_STATUS_INTERRUPT
       : hasPendingToolCalls
         ? AUTO_STATUS_PENDING
         : AUTO_STATUS_COMPLETE;

package/src/model-context/frame/AssistantFrameProvider.ts

@@ -133,9 +133,9 @@ export class AssistantFrameProvider {
           ? await tool.execute(message.args, {
               toolCallId: message.id,
               abortSignal: new AbortController().signal,
-              interrupt: async () => {
+              human: async () => {
                 throw new Error(
-                  "Tool interrupt is not supported in frame context",
+                  "Tool human input is not supported in frame context",
                 );
               },
             })

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

@@ -54,7 +54,7 @@ export type ToolCallMessagePart<
   readonly isError?: boolean | undefined;
   readonly argsText: string;
   readonly artifact?: unknown;
-  readonly interrupt?: unknown;
+  readonly interrupt?: { type: "human"; payload: unknown };
   readonly parentId?: string;
 };