@assistant-ui/core 0.2.2 → 0.2.3

package/dist/react/model-context/useAssistantTool.js

@@ -1,5 +1,35 @@
 import { useEffect } from "react";
 import { useAui } from "@assistant-ui/store";
+/**
+ * Registers a tool with the assistant model context while the component is
+ * mounted.
+ *
+ * If `render` is provided, it is also installed as the renderer for matching
+ * tool-call message parts. The registration is removed automatically when the
+ * component unmounts or the tool definition changes.
+ *
+ * Pass a referentially stable tool object, such as one declared at module
+ * scope or memoized with `useMemo`, to avoid re-registering on every render.
+ *
+ * @param tool - Tool definition and name to register.
+ *
+ * @example
+ * ```tsx
+ * const weatherTool = {
+ *   toolName: "get_weather",
+ *   type: "frontend",
+ *   description: "Get the weather for a city.",
+ *   parameters: weatherSchema,
+ *   execute: async ({ city }: { city: string }) => fetchWeather(city),
+ *   render: WeatherToolUI,
+ * } satisfies AssistantToolProps<{ city: string }, Weather>;
+ *
+ * function WeatherToolRegistration() {
+ *   useAssistantTool(weatherTool);
+ *   return null;
+ * }
+ * ```
+ */
 export const useAssistantTool = (tool) => {
     const aui = useAui();
     useEffect(() => {

package/dist/react/model-context/useAssistantTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantTool.js","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAW7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAI9B,IAAwC,EACxC,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,OAAO,GAAG;YACd,KAAK,EAAE;gBACL,CAAC,QAAQ,CAAC,EAAE,IAAI;aACjB;SACF,CAAC;QACF,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC;YACjC,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO;SAC/B,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"useAssistantTool.js","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAe7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAI9B,IAAwC,EACxC,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,OAAO,GAAG;YACd,KAAK,EAAE;gBACL,CAAC,QAAQ,CAAC,EAAE,IAAI;aACjB;SACF,CAAC;QACF,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC;YACjC,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO;SAC/B,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC"}

package/dist/react/model-context/useAssistantToolUI.d.ts

@@ -1,7 +1,19 @@
 import type { ToolCallMessagePartComponent } from "../types/MessagePartComponentTypes.js";
+/** Props used to register a renderer for tool-call message parts. */
 export type AssistantToolUIProps<TArgs, TResult> = {
+    /** Name of the tool whose calls should use this renderer. */
     toolName: string;
+    /** Component rendered for matching tool-call message parts. */
     render: ToolCallMessagePartComponent<TArgs, TResult>;
 };
+/**
+ * Registers a tool-call renderer while the component is mounted.
+ *
+ * This only affects rendering. Pair it with {@link useAssistantTool},
+ * {@link Tools}, or a backend tool registry to expose the actual tool
+ * definition to the model.
+ *
+ * @param tool - Tool renderer registration, or `null` to skip registration.
+ */
 export declare const useAssistantToolUI: (tool: AssistantToolUIProps<any, any> | null) => void;
 //# sourceMappingURL=useAssistantToolUI.d.ts.map

package/dist/react/model-context/useAssistantToolUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantToolUI.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,8CAA2C;AAEvF,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,OAAO,IAAI;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,SAO5C,CAAC"}
+{"version":3,"file":"useAssistantToolUI.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,8CAA2C;AAEvF,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,OAAO,IAAI;IACjD,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,EAAE,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,SAO5C,CAAC"}

package/dist/react/model-context/useAssistantToolUI.js

@@ -1,5 +1,14 @@
 import { useEffect } from "react";
 import { useAui } from "@assistant-ui/store";
+/**
+ * Registers a tool-call renderer while the component is mounted.
+ *
+ * This only affects rendering. Pair it with {@link useAssistantTool},
+ * {@link Tools}, or a backend tool registry to expose the actual tool
+ * definition to the model.
+ *
+ * @param tool - Tool renderer registration, or `null` to skip registration.
+ */
 export const useAssistantToolUI = (tool) => {
     const aui = useAui();
     useEffect(() => {

package/dist/react/model-context/useAssistantToolUI.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantToolUI.js","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAQ7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAA2C,EAC3C,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QACvD,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC"}
+{"version":3,"file":"useAssistantToolUI.js","sourceRoot":"","sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAW7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAA2C,EAC3C,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QACvD,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC"}

package/dist/react/model-context/useToolArgsStatus.d.ts

@@ -1,8 +1,37 @@
 type PropFieldStatus = "streaming" | "complete";
+/**
+ * Streaming completion status for the arguments of the current tool call.
+ */
 export type ToolArgsStatus<TArgs extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Overall lifecycle state of the tool-call part. */
     status: "running" | "complete" | "incomplete" | "requires-action";
+    /** Per-argument status keyed by argument name. */
     propStatus: Partial<Record<keyof TArgs, PropFieldStatus>>;
 };
+/**
+ * Reads whether each argument field for the current tool-call message part is
+ * still streaming or complete.
+ *
+ * Use inside a tool-call renderer to avoid showing incomplete argument values
+ * as final.
+ *
+ * @throws If called outside a tool-call message part.
+ *
+ * @example
+ * ```tsx
+ * function WeatherToolUI({
+ *   args,
+ * }: ToolCallMessagePartProps<{ city: string }>) {
+ *   const { propStatus } = useToolArgsStatus<{ city: string }>();
+ *
+ *   return (
+ *     <span>
+ *       {propStatus.city === "streaming" ? "Reading city..." : args.city}
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
 export declare const useToolArgsStatus: <TArgs extends Record<string, unknown> = Record<string, unknown>>() => ToolArgsStatus<TArgs>;
 export {};
 //# sourceMappingURL=useToolArgsStatus.d.ts.map

package/dist/react/model-context/useToolArgsStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolArgsStatus.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/useToolArgsStatus.ts"],"names":[],"mappings":"AAOA,KAAK,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC;AAEhD,MAAM,MAAM,cAAc,CACxB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC7D;IACF,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAClE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAC5D,cAAc,CAAC,KAAK,CAgCxB,CAAC"}
+{"version":3,"file":"useToolArgsStatus.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/useToolArgsStatus.ts"],"names":[],"mappings":"AAOA,KAAK,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,cAAc,CACxB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC7D;IACF,qDAAqD;IACrD,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAClE,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAC5D,cAAc,CAAC,KAAK,CAgCxB,CAAC"}

package/dist/react/model-context/useToolArgsStatus.js

@@ -1,6 +1,30 @@
 import { useMemo } from "react";
 import { useAuiState } from "@assistant-ui/store";
 import { getPartialJsonObjectFieldState, getPartialJsonObjectMeta, } from "assistant-stream/utils";
+/**
+ * Reads whether each argument field for the current tool-call message part is
+ * still streaming or complete.
+ *
+ * Use inside a tool-call renderer to avoid showing incomplete argument values
+ * as final.
+ *
+ * @throws If called outside a tool-call message part.
+ *
+ * @example
+ * ```tsx
+ * function WeatherToolUI({
+ *   args,
+ * }: ToolCallMessagePartProps<{ city: string }>) {
+ *   const { propStatus } = useToolArgsStatus<{ city: string }>();
+ *
+ *   return (
+ *     <span>
+ *       {propStatus.city === "streaming" ? "Reading city..." : args.city}
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
 export const useToolArgsStatus = () => {
     const part = useAuiState((s) => s.part);
     return useMemo(() => {

package/dist/react/model-context/useToolArgsStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToolArgsStatus.js","sourceRoot":"","sources":["../../../src/react/model-context/useToolArgsStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAWhC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAEN,EAAE;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAEpC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,KAAK,SAAS,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAA+B,CAAC;QAClD,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAA+B,CAAC,CAAC;QACvE,MAAM,UAAU,GAA6C,EAAE,CAAC;QAEhE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,8BAA8B,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/D,UAAU,CAAC,GAAG,CAAC;oBACb,UAAU,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,UAA2D;SACxE,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"useToolArgsStatus.js","sourceRoot":"","sources":["../../../src/react/model-context/useToolArgsStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAgBhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAEN,EAAE;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAEpC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,KAAK,SAAS,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAA+B,CAAC;QAClD,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAA+B,CAAC,CAAC;QACvE,MAAM,UAAU,GAA6C,EAAE,CAAC;QAEhE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,8BAA8B,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/D,UAAU,CAAC,GAAG,CAAC;oBACb,UAAU,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,UAA2D;SACxE,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC,CAAC"}

package/dist/react/primitive-hooks/useActionBarCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActionBarCopy.d.ts","sourceRoot":"","sources":["../../../src/react/primitive-hooks/useActionBarCopy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,uCAG9B,uBAA4B;;;;CA0B9B,CAAC"}
+{"version":3,"file":"useActionBarCopy.d.ts","sourceRoot":"","sources":["../../../src/react/primitive-hooks/useActionBarCopy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,uCAG9B,uBAA4B;;;;CA8B9B,CAAC"}

package/dist/react/primitive-hooks/useActionBarCopy.js

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

package/dist/react/primitive-hooks/useActionBarCopy.js.map

@@ -1 +1 @@
-{"version":3,"file":"useActionBarCopy.js","sourceRoot":"","sources":["../../../src/react/primitive-hooks/useActionBarCopy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAO1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,cAAc,GAAG,IAAI,EACrB,eAAe,MACY,EAAE,EAAE,EAAE;IACjC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,OAAO,CAAC,CACN,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;YAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC;YACvC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACpE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5E,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,KAAK,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAChC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAErE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC,CAAC"}
+{"version":3,"file":"useActionBarCopy.js","sourceRoot":"","sources":["../../../src/react/primitive-hooks/useActionBarCopy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAO1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,cAAc,GAAG,IAAI,EACrB,eAAe,MACY,EAAE,EAAE,EAAE;IACjC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,OAAO,CAAC,CACN,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;YAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC;YACvC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACpE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5E,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,KAAK,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,8EAA8E;QAC9E,0EAA0E;QAC1E,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CACtC,GAAG,EAAE;YACH,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;QACrE,CAAC,EACD,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAErE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC,CAAC"}

package/dist/react/primitives/messagePart/MessagePartInProgress.d.ts

@@ -0,0 +1,6 @@
+import type { FC, PropsWithChildren } from "react";
+export declare namespace MessagePartPrimitiveInProgress {
+    type Props = PropsWithChildren;
+}
+export declare const MessagePartPrimitiveInProgress: FC<MessagePartPrimitiveInProgress.Props>;
+//# sourceMappingURL=MessagePartInProgress.d.ts.map

package/dist/react/primitives/messagePart/MessagePartInProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagePartInProgress.d.ts","sourceRoot":"","sources":["../../../../src/react/primitives/messagePart/MessagePartInProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGnD,yBAAiB,8BAA8B,CAAC;IAC9C,KAAY,KAAK,GAAG,iBAAiB,CAAC;CACvC;AAED,eAAO,MAAM,8BAA8B,EAAE,EAAE,CAC7C,8BAA8B,CAAC,KAAK,CAIrC,CAAC"}

package/dist/react/primitives/messagePart/MessagePartInProgress.js

@@ -0,0 +1,7 @@
+import { useAuiState } from "@assistant-ui/store";
+export const MessagePartPrimitiveInProgress = ({ children }) => {
+    const isInProgress = useAuiState((s) => s.part.status.type === "running");
+    return isInProgress ? children : null;
+};
+MessagePartPrimitiveInProgress.displayName = "MessagePartPrimitive.InProgress";
+//# sourceMappingURL=MessagePartInProgress.js.map

package/dist/react/primitives/messagePart/MessagePartInProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagePartInProgress.js","sourceRoot":"","sources":["../../../../src/react/primitives/messagePart/MessagePartInProgress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMlD,MAAM,CAAC,MAAM,8BAA8B,GAEvC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACnB,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC,CAAC;AAEF,8BAA8B,CAAC,WAAW,GAAG,iCAAiC,CAAC"}

package/dist/react/runtimes/useToolInvocations.d.ts

@@ -21,10 +21,19 @@ type UseToolInvocationsParams = {
     onResult: (command: AddToolResultCommand) => void;
     setToolStatuses: (updater: Record<string, ToolExecutionStatus> | ((prev: Record<string, ToolExecutionStatus>) => Record<string, ToolExecutionStatus>)) => void;
 };
+/**
+ * Streaming execution state for a frontend tool.
+ *
+ * Custom runtime integrations use this to mirror in-flight tool calls while
+ * `useToolInvocations` executes tools in the browser.
+ */
 export type ToolExecutionStatus = {
+    /** The tool's execute function is currently running. */
     type: "executing";
 } | {
+    /** The tool is waiting for a human input payload before continuing. */
     type: "interrupt";
+    /** Human input request emitted by the tool execution context. */
     payload: {
         type: "human";
         payload: unknown;

package/dist/react/runtimes/useToolInvocations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToolInvocations.d.ts","sourceRoot":"","sources":["../../../src/react/runtimes/useToolInvocations.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,IAAI,EACT,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA4B;AAEzD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzD,CAAC;AA0BF,KAAK,wBAAwB,GAAG;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CACf,OAAO,EACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACnC,CAAC,CACC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,KACtC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,KAC1C,IAAI,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC;AAUxE,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,eAAe,GAChB,EAAE,wBAAwB;;iBAyeP,OAAO,CAAC,IAAI,CAAC;yBA+BR,MAAM,WAAW,OAAO;EAgBhD"}
+{"version":3,"file":"useToolInvocations.d.ts","sourceRoot":"","sources":["../../../src/react/runtimes/useToolInvocations.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,IAAI,EACT,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA4B;AAEzD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzD,CAAC;AA0BF,KAAK,wBAAwB,GAAG;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CACf,OAAO,EACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACnC,CAAC,CACC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,KACtC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,KAC1C,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,wDAAwD;IACxD,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,uEAAuE;IACvE,IAAI,EAAE,WAAW,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9C,CAAC;AAwCN,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,eAAe,GAChB,EAAE,wBAAwB;;iBA+fP,OAAO,CAAC,IAAI,CAAC;yBAkCR,MAAM,WAAW,OAAO;EAgBhD"}