@assistant-ui/core 0.2.22 → 0.3.0

package/dist/react/client/Tools.js

@@ -14,7 +14,7 @@ import { resource, useResources, withKey } from "@assistant-ui/tap";
 * message rendering.
 */
 const useTools = (t0) => {
-	const $ = c(15);
+	const $ = c(12);
 	const { toolkit, mcpApp } = t0;
 	let t1;
 	if ($[0] !== mcpApp) {
@@ -25,28 +25,20 @@ const useTools = (t0) => {
 	const mcpAppOutput = useResources(t1)[0];
 	const [toolUIs, setToolUIs] = useState(_temp);
 	let t2;
-	if ($[2] !== toolUIs) {
-		t2 = Object.fromEntries(Object.entries(toolUIs).map(_temp3));
-		$[2] = toolUIs;
-		$[3] = t2;
-	} else t2 = $[3];
-	let t3;
-	if ($[4] !== mcpAppOutput || $[5] !== t2 || $[6] !== toolUIs) {
-		t3 = {
+	if ($[2] !== mcpAppOutput || $[3] !== toolUIs) {
+		t2 = {
 			toolUIs,
-			mcpApp: mcpAppOutput,
-			tools: t2
+			mcpApp: mcpAppOutput
 		};
-		$[4] = mcpAppOutput;
-		$[5] = t2;
-		$[6] = toolUIs;
-		$[7] = t3;
-	} else t3 = $[7];
-	const state = t3;
+		$[2] = mcpAppOutput;
+		$[3] = toolUIs;
+		$[4] = t2;
+	} else t2 = $[4];
+	const state = t2;
 	const clientRef = useAssistantClientRef();
-	let t4;
-	if ($[8] === Symbol.for("react.memo_cache_sentinel")) {
-		t4 = (toolName, render, options) => {
+	let t3;
+	if ($[5] === Symbol.for("react.memo_cache_sentinel")) {
+		t3 = (toolName, render, options) => {
 			const registration = {
 				render,
 				standalone: options?.standalone ?? false
@@ -57,7 +49,7 @@ const useTools = (t0) => {
 			}));
 			return () => {
 				setToolUIs((prev_0) => {
-					const next = prev_0[toolName]?.filter((r_0) => r_0 !== registration) ?? [];
+					const next = prev_0[toolName]?.filter((r) => r !== registration) ?? [];
 					if (next.length > 0) return {
 						...prev_0,
 						[toolName]: next
@@ -68,13 +60,13 @@ const useTools = (t0) => {
 				});
 			};
 		};
-		$[8] = t4;
-	} else t4 = $[8];
-	const setToolUI = t4;
+		$[5] = t3;
+	} else t3 = $[5];
+	const setToolUI = t3;
+	let t4;
 	let t5;
-	let t6;
-	if ($[9] !== clientRef || $[10] !== toolkit) {
-		t5 = () => {
+	if ($[6] !== clientRef || $[7] !== toolkit) {
+		t4 = () => {
 			if (!toolkit) return;
 			const unsubscribes = [];
 			for (const [toolName_0, tool] of Object.entries(toolkit)) {
@@ -83,36 +75,36 @@ const useTools = (t0) => {
 				const render_0 = toolRender ?? (toolRenderText ? makeToolCallTextComponent(toolRenderText) : void 0);
 				if (render_0) unsubscribes.push(setToolUI(toolName_0, render_0, { standalone: isStandaloneToolDisplay(tool) }));
 			}
-			const toolsWithoutRender = Object.entries(toolkit).reduce(_temp4, {});
+			const toolsWithoutRender = Object.entries(toolkit).reduce(_temp2, {});
 			unsubscribes.push(clientRef.current.modelContext().register({ getModelContext: () => ({ tools: toolsWithoutRender }) }));
 			return () => {
-				unsubscribes.forEach(_temp5);
+				unsubscribes.forEach(_temp3);
 			};
 		};
-		t6 = [
+		t5 = [
 			toolkit,
 			setToolUI,
 			clientRef
 		];
-		$[9] = clientRef;
-		$[10] = toolkit;
-		$[11] = t5;
-		$[12] = t6;
+		$[6] = clientRef;
+		$[7] = toolkit;
+		$[8] = t4;
+		$[9] = t5;
 	} else {
-		t5 = $[11];
-		t6 = $[12];
+		t4 = $[8];
+		t5 = $[9];
 	}
-	useEffect(t5, t6);
-	let t7;
-	if ($[13] !== state) {
-		t7 = {
+	useEffect(t4, t5);
+	let t6;
+	if ($[10] !== state) {
+		t6 = {
 			getState: () => state,
 			setToolUI
 		};
-		$[13] = state;
-		$[14] = t7;
-	} else t7 = $[14];
-	return t7;
+		$[10] = state;
+		$[11] = t6;
+	} else t6 = $[11];
+	return t6;
 };
 const Tools = resource(useTools);
 attachTransformScopes(useTools, (scopes, parent) => {
@@ -121,21 +113,14 @@ attachTransformScopes(useTools, (scopes, parent) => {
 function _temp() {
 	return {};
 }
-function _temp2(r) {
-	return r.render;
-}
-function _temp3(t0) {
-	const [name, regs] = t0;
-	return [name, regs.map(_temp2)];
-}
-function _temp4(acc, t0) {
-	const [name_0, tool_0] = t0;
+function _temp2(acc, t0) {
+	const [name, tool_0] = t0;
 	if (tool_0.type === "mcp") return acc;
 	const { display: _display, render: _render, renderText: _renderText, ...rest_0 } = tool_0;
-	acc[name_0] = rest_0;
+	acc[name] = rest_0;
 	return acc;
 }
-function _temp5(fn) {
+function _temp3(fn) {
 	return fn();
 }
 //#endregion

package/dist/react/client/Tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tools.js","names":["useState","useEffect","useCallback","useMemo","useResources","resource","withKey","ResourceElement","useAssistantClientRef","ClientOutput","attachTransformScopes","McpAppResourceOutput","ToolsState","Tool","isStandaloneToolDisplay","makeToolCallTextComponent","Toolkit","ToolCallMessagePartComponent","ModelContext","useTools","t0","$","_c","toolkit","mcpApp","t1","mcpAppOutputs","mcpAppOutput","toolUIs","setToolUIs","_temp","t2","Object","fromEntries","entries","map","_temp3","t3","tools","state","clientRef","t4","Symbol","for","toolName","render","options","registration","standalone","prev","prev_0","next","filter","r_0","r","length","rest","setToolUI","t5","t6","unsubscribes","toolName_0","tool","toolRender","undefined","toolRenderText","renderText","render_0","push","toolsWithoutRender","reduce","_temp4","Record","modelContextProvider","getModelContext","current","modelContext","register","forEach","_temp5","t7","getState","Tools","scopes","parent","source","_temp2","name","regs","acc","name_0","tool_0","type","display","_display","_render","_renderText","rest_0","fn"],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useMemo } from \"react\";\nimport {\n  useResources,\n  resource,\n  withKey,\n  type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n  useAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n  isStandaloneToolDisplay,\n  makeToolCallTextComponent,\n  type Toolkit,\n} from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/**\n * Registers tools with model context and installs tool-call renderers.\n *\n * Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n */\nconst useTools = ({\n  toolkit,\n  mcpApp,\n}: {\n  /** Tools to expose to the model and optional renderers to install. */\n  toolkit?: Toolkit;\n  /** Optional MCP app resource whose tools should be merged into context. */\n  mcpApp?: ResourceElement<McpAppResourceOutput> | undefined;\n}): ClientOutput<\"tools\"> => {\n  const mcpAppOutputs = useResources(mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []);\n  const mcpAppOutput = mcpAppOutputs[0];\n\n  const [toolUIs, setToolUIs] = useState<ToolsState[\"toolUIs\"]>(() => ({}));\n\n  const state = useMemo(\n    (): ToolsState => ({\n      toolUIs,\n      mcpApp: mcpAppOutput,\n      // Deprecated component-only view, derived from `toolUIs`. Removed in v0.15.\n      tools: Object.fromEntries(\n        Object.entries(toolUIs).map(([name, regs]) => [\n          name,\n          regs.map((r) => r.render),\n        ]),\n      ),\n    }),\n    [toolUIs, mcpAppOutput],\n  );\n\n  const clientRef = useAssistantClientRef();\n\n  const setToolUI = useCallback(\n    (\n      toolName: string,\n      render: ToolCallMessagePartComponent,\n      options?: { standalone?: boolean },\n    ) => {\n      // One registration object per call; identity is the removal key, so\n      // the per-name list stays correctly ref-counted across re-registers.\n      const registration = {\n        render,\n        standalone: options?.standalone ?? false,\n      };\n\n      setToolUIs((prev) => ({\n        ...prev,\n        [toolName]: [...(prev[toolName] ?? []), registration],\n      }));\n\n      return () => {\n        setToolUIs((prev) => {\n          const next = prev[toolName]?.filter((r) => r !== registration) ?? [];\n          if (next.length > 0) return { ...prev, [toolName]: next };\n          // Drop the key entirely so repeatedly mounted/unmounted tools\n          // don't leave empty arrays accumulating across a long session.\n          const rest = { ...prev };\n          delete rest[toolName];\n          return rest;\n        });\n      };\n    },\n    [],\n  );\n\n  useEffect(() => {\n    if (!toolkit) return;\n    const unsubscribes: (() => void)[] = [];\n\n    // Register tool UIs (exclude symbols)\n    for (const [toolName, tool] of Object.entries(toolkit)) {\n      const toolRender = \"render\" in tool ? tool.render : undefined;\n      const toolRenderText = \"renderText\" in tool ? tool.renderText : undefined;\n      const render =\n        toolRender ??\n        (toolRenderText\n          ? makeToolCallTextComponent(toolRenderText)\n          : undefined);\n      if (render) {\n        unsubscribes.push(\n          setToolUI(toolName, render, {\n            standalone: isStandaloneToolDisplay(tool),\n          }),\n        );\n      }\n    }\n\n    // Register tools with model context (exclude symbols). `render`,\n    // `renderText`, and `display` are client-only presentation concerns and\n    // never reach the model.\n    const toolsWithoutRender = Object.entries(toolkit).reduce(\n      (acc, [name, tool]) => {\n        if (tool.type === \"mcp\") return acc;\n        const {\n          display: _display,\n          render: _render,\n          renderText: _renderText,\n          ...rest\n        } = tool as typeof tool & { renderText?: unknown };\n        acc[name] = rest as Tool<any, any>;\n        return acc;\n      },\n      {} as Record<string, Tool<any, any>>,\n    );\n\n    const modelContextProvider = {\n      getModelContext: () => ({\n        tools: toolsWithoutRender,\n      }),\n    };\n\n    unsubscribes.push(\n      clientRef.current!.modelContext().register(modelContextProvider),\n    );\n\n    return () => {\n      unsubscribes.forEach((fn) => fn());\n    };\n  }, [toolkit, setToolUI, clientRef]);\n\n  return {\n    getState: () => state,\n    setToolUI,\n  };\n};\n\nexport const Tools = resource(useTools);\n\nattachTransformScopes(useTools, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":"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"}
+{"version":3,"file":"Tools.js","names":["useState","useEffect","useCallback","useMemo","useResources","resource","withKey","ResourceElement","useAssistantClientRef","ClientOutput","attachTransformScopes","McpAppResourceOutput","ToolsState","Tool","isStandaloneToolDisplay","makeToolCallTextComponent","Toolkit","ToolCallMessagePartComponent","ModelContext","useTools","t0","$","_c","toolkit","mcpApp","t1","mcpAppOutputs","mcpAppOutput","toolUIs","setToolUIs","_temp","t2","state","clientRef","t3","Symbol","for","toolName","render","options","registration","standalone","prev","prev_0","next","filter","r","length","rest","setToolUI","t4","t5","unsubscribes","toolName_0","tool","Object","entries","toolRender","undefined","toolRenderText","renderText","render_0","push","toolsWithoutRender","reduce","_temp2","Record","modelContextProvider","getModelContext","tools","current","modelContext","register","forEach","_temp3","t6","getState","Tools","scopes","parent","source","acc","name","tool_0","type","display","_display","_render","_renderText","rest_0","fn"],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useMemo } from \"react\";\nimport {\n  useResources,\n  resource,\n  withKey,\n  type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n  useAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n  isStandaloneToolDisplay,\n  makeToolCallTextComponent,\n  type Toolkit,\n} from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/**\n * Registers tools with model context and installs tool-call renderers.\n *\n * Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n */\nconst useTools = ({\n  toolkit,\n  mcpApp,\n}: {\n  /** Tools to expose to the model and optional renderers to install. */\n  toolkit?: Toolkit;\n  /** Optional MCP app resource whose tools should be merged into context. */\n  mcpApp?: ResourceElement<McpAppResourceOutput> | undefined;\n}): ClientOutput<\"tools\"> => {\n  const mcpAppOutputs = useResources(mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []);\n  const mcpAppOutput = mcpAppOutputs[0];\n\n  const [toolUIs, setToolUIs] = useState<ToolsState[\"toolUIs\"]>(() => ({}));\n\n  const state = useMemo(\n    (): ToolsState => ({\n      toolUIs,\n      mcpApp: mcpAppOutput,\n    }),\n    [toolUIs, mcpAppOutput],\n  );\n\n  const clientRef = useAssistantClientRef();\n\n  const setToolUI = useCallback(\n    (\n      toolName: string,\n      render: ToolCallMessagePartComponent,\n      options?: { standalone?: boolean },\n    ) => {\n      // One registration object per call; identity is the removal key, so\n      // the per-name list stays correctly ref-counted across re-registers.\n      const registration = {\n        render,\n        standalone: options?.standalone ?? false,\n      };\n\n      setToolUIs((prev) => ({\n        ...prev,\n        [toolName]: [...(prev[toolName] ?? []), registration],\n      }));\n\n      return () => {\n        setToolUIs((prev) => {\n          const next = prev[toolName]?.filter((r) => r !== registration) ?? [];\n          if (next.length > 0) return { ...prev, [toolName]: next };\n          // Drop the key entirely so repeatedly mounted/unmounted tools\n          // don't leave empty arrays accumulating across a long session.\n          const rest = { ...prev };\n          delete rest[toolName];\n          return rest;\n        });\n      };\n    },\n    [],\n  );\n\n  useEffect(() => {\n    if (!toolkit) return;\n    const unsubscribes: (() => void)[] = [];\n\n    // Register tool UIs (exclude symbols)\n    for (const [toolName, tool] of Object.entries(toolkit)) {\n      const toolRender = \"render\" in tool ? tool.render : undefined;\n      const toolRenderText = \"renderText\" in tool ? tool.renderText : undefined;\n      const render =\n        toolRender ??\n        (toolRenderText\n          ? makeToolCallTextComponent(toolRenderText)\n          : undefined);\n      if (render) {\n        unsubscribes.push(\n          setToolUI(toolName, render, {\n            standalone: isStandaloneToolDisplay(tool),\n          }),\n        );\n      }\n    }\n\n    // Register tools with model context (exclude symbols). `render`,\n    // `renderText`, and `display` are client-only presentation concerns and\n    // never reach the model.\n    const toolsWithoutRender = Object.entries(toolkit).reduce(\n      (acc, [name, tool]) => {\n        if (tool.type === \"mcp\") return acc;\n        const {\n          display: _display,\n          render: _render,\n          renderText: _renderText,\n          ...rest\n        } = tool as typeof tool & { renderText?: unknown };\n        acc[name] = rest as Tool<any, any>;\n        return acc;\n      },\n      {} as Record<string, Tool<any, any>>,\n    );\n\n    const modelContextProvider = {\n      getModelContext: () => ({\n        tools: toolsWithoutRender,\n      }),\n    };\n\n    unsubscribes.push(\n      clientRef.current!.modelContext().register(modelContextProvider),\n    );\n\n    return () => {\n      unsubscribes.forEach((fn) => fn());\n    };\n  }, [toolkit, setToolUI, clientRef]);\n\n  return {\n    getState: () => state,\n    setToolUI,\n  };\n};\n\nexport const Tools = resource(useTools);\n\nattachTransformScopes(useTools, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":"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"}

package/dist/react/client/interactable-model-context.js

@@ -1,6 +1,7 @@
 import { isRecord } from "../../utils/json/is-json.js";
 import { interactableToolName, shallowMergeInteractableState } from "../../model-context/interactable-composer-metadata.js";
 import { generateId } from "../../utils/id.js";
+import "assistant-stream";
 //#region src/react/client/interactable-model-context.ts
 const ID_PROPERTY = {
 	type: "string",

package/dist/react/client/interactable-model-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactable-model-context.js","names":["Tool","toJSONSchema","Unstable_InteractableDefinition","interactableToolName","shallowMergeInteractableState","Unstable_InteractableSnapshotEntry","generateId","isRecord","PartialJSONSchema","ReturnType","ID_PROPERTY","type","const","description","hasIdProperty","schema","Record","properties","id","undefined","withRequiredItemId","required","withoutItemId","_omitted","Array","isArray","filter","key","toArrayUpdateSchema","field","itemSchema","items","idKeyed","add","remove","clear","update","additionalProperties","idKeyedArrayFieldNames","Set","names","value","Object","entries","withArrayUpdateSchemas","fromEntries","map","withRequiredId","partial","process","env","NODE_ENV","console","warn","_reserved","buildInteractableModelContext","definitions","partialSchemaCache","Map","setDefState","updater","prev","streamBaselines","targetId","state","tools","unstable_composerMetadata","values","length","byName","def","list","get","name","push","set","instances","toolName","first","partialSchema","idKeyedFields","resolveTarget","parameters","streamCall","reader","toolCallId","partialArgs","args","streamValues","keys","idIndex","indexOf","target","baseline","arrayBaseline","execute","validIds","d","success","error","JSON","stringify","join","delete","addedItemIds","idFactory","itemId","result","interactables"],"sources":["../../../src/react/client/interactable-model-context.ts"],"sourcesContent":["import type { Tool } from \"assistant-stream\";\nimport { toJSONSchema } from \"assistant-stream\";\nimport type { Unstable_InteractableDefinition } from \"../types/scopes/interactables\";\nimport {\n  interactableToolName,\n  shallowMergeInteractableState,\n  type Unstable_InteractableSnapshotEntry,\n} from \"../../model-context/interactable-composer-metadata\";\nimport { generateId } from \"../../utils/id\";\nimport { isRecord } from \"../../utils/json/is-json\";\n\nexport type PartialJSONSchema = ReturnType<typeof toJSONSchema>;\n\nconst ID_PROPERTY = {\n  type: \"string\" as const,\n  description:\n    \"The id of the instance to update, as shown in its state snapshot in the conversation.\",\n};\n\nconst hasIdProperty = (schema: Record<string, unknown>) => {\n  const properties = schema.properties;\n  return isRecord(properties) && properties.id !== undefined;\n};\n\nconst withRequiredItemId = (schema: Record<string, unknown>) => ({\n  ...schema,\n  required: [\"id\"],\n});\n\n// The framework assigns ids to new items, so the model never sees the `id`\n// field when adding (it can't address an item that doesn't exist yet).\nconst withoutItemId = (schema: Record<string, unknown>) => {\n  const { id: _omitted, ...properties } = isRecord(schema.properties)\n    ? schema.properties\n    : {};\n  const required = Array.isArray(schema.required)\n    ? schema.required.filter((key) => key !== \"id\")\n    : schema.required;\n  return { ...schema, properties, required };\n};\n\nconst toArrayUpdateSchema = (schema: unknown, field: string) => {\n  if (!isRecord(schema) || schema.type !== \"array\") return schema;\n  const itemSchema = schema.items;\n  if (Array.isArray(itemSchema) || !isRecord(itemSchema)) return schema;\n\n  const idKeyed = hasIdProperty(itemSchema);\n  const properties: Record<string, unknown> = {\n    add: {\n      type: \"array\",\n      items: idKeyed ? withoutItemId(itemSchema) : itemSchema,\n    },\n    remove: {\n      type: \"array\",\n      items: idKeyed ? ID_PROPERTY : itemSchema,\n    },\n    clear: { type: \"boolean\" },\n  };\n\n  if (idKeyed) {\n    properties.update = {\n      type: \"array\",\n      items: withRequiredItemId(itemSchema),\n    };\n  }\n\n  return {\n    type: \"object\" as const,\n    description:\n      `Operations for array field \"${field}\". To change one item use update ` +\n      `with its id; add new items (their ids are assigned for you), remove items ` +\n      `by id, or clear to empty. Change only the items you mean to — never resend ` +\n      `the whole array to edit one item.`,\n    properties,\n    additionalProperties: false,\n  };\n};\n\n// Top-level array fields whose items carry an `id` — the fields the framework\n// mints ids for on add.\nconst idKeyedArrayFieldNames = (\n  properties: Record<string, unknown>,\n): Set<string> => {\n  const names = new Set<string>();\n  for (const [key, value] of Object.entries(properties)) {\n    if (\n      isRecord(value) &&\n      value.type === \"array\" &&\n      isRecord(value.items) &&\n      hasIdProperty(value.items)\n    ) {\n      names.add(key);\n    }\n  }\n  return names;\n};\n\nconst withArrayUpdateSchemas = (properties: Record<string, unknown>) =>\n  Object.fromEntries(\n    Object.entries(properties).map(([key, value]) => [\n      key,\n      toArrayUpdateSchema(value, key),\n    ]),\n  );\n\n/**\n * Wraps an interactable's partial state schema with the required `id`\n * parameter. Falls back to a permissive schema when the partial conversion\n * failed at registration time.\n */\nfunction withRequiredId(partial: PartialJSONSchema | undefined) {\n  if (!partial || typeof partial !== \"object\" || partial.type !== \"object\") {\n    return {\n      type: \"object\" as const,\n      properties: { id: ID_PROPERTY },\n      required: [\"id\"],\n      additionalProperties: true,\n    };\n  }\n  if (process.env.NODE_ENV !== \"production\" && partial.properties?.id) {\n    console.warn(\n      `[Interactables] a top-level \"id\" field in an interactable's stateSchema is ` +\n        `reserved for instance addressing by the update tool and cannot be updated ` +\n        `by the model. Rename the field to make it model-writable.`,\n    );\n  }\n  const { id: _reserved, ...properties } = partial.properties ?? {};\n  return {\n    ...partial,\n    properties: { id: ID_PROPERTY, ...withArrayUpdateSchemas(properties) },\n    required: [\"id\"],\n  };\n}\n\nexport function buildInteractableModelContext(\n  definitions: Record<string, Unstable_InteractableDefinition>,\n  partialSchemaCache: Map<string, PartialJSONSchema>,\n  setDefState: (id: string, updater: (prev: unknown) => unknown) => void,\n  streamBaselines = new Map<string, { targetId: string; state: unknown }>(),\n):\n  | {\n      tools: Record<string, Tool<any, any>>;\n      unstable_composerMetadata?: Record<string, unknown>;\n    }\n  | undefined {\n  const entries = Object.values(definitions);\n  if (entries.length === 0) return undefined;\n\n  const byName = new Map<string, Unstable_InteractableDefinition[]>();\n  for (const def of entries) {\n    const list = byName.get(def.name) ?? [];\n    list.push(def);\n    byName.set(def.name, list);\n  }\n\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const [name, instances] of byName) {\n    const toolName = interactableToolName(name);\n    if (tools[toolName]) {\n      if (process.env.NODE_ENV !== \"production\") {\n        console.warn(\n          `[Interactables] interactable names \"${name}\" and another registered name ` +\n            `both sanitize to the tool name \"${toolName}\". Rename one of them.`,\n        );\n      }\n      continue;\n    }\n\n    const first = instances[0]!;\n    const partialSchema = partialSchemaCache.get(first.id);\n    const idKeyedFields =\n      partialSchema && isRecord(partialSchema.properties)\n        ? idKeyedArrayFieldNames(partialSchema.properties)\n        : new Set<string>();\n\n    // `id` resolves to a definition of this name; an id-less call is accepted\n    // only while exactly one instance exists.\n    const resolveTarget = (\n      id: unknown,\n    ): Unstable_InteractableDefinition | undefined => {\n      if (typeof id === \"string\") {\n        const def = definitions[id];\n        return def?.name === name ? def : undefined;\n      }\n      return instances.length === 1 ? first : undefined;\n    };\n\n    tools[toolName] = {\n      type: \"frontend\",\n      description:\n        `Update the state of interactable component \"${name}\". ${first.description} ` +\n        `Pass the id of the instance to update — instance ids and current state ` +\n        `appear in the conversation as state snapshots. Only include the fields ` +\n        `you want to change; omitted fields keep their current values.`,\n      parameters: withRequiredId(partialSchema),\n      streamCall: async (reader, { toolCallId }) => {\n        try {\n          for await (const partialArgs of reader.args.streamValues()) {\n            if (!partialArgs || typeof partialArgs !== \"object\") continue;\n            const args = partialArgs as Record<string, unknown>;\n            const keys = Object.keys(args);\n            const idIndex = keys.indexOf(\"id\");\n            if (idIndex === keys.length - 1) continue;\n\n            const { id, ...partial } = args;\n            if (Object.keys(partial).length === 0) continue;\n            const target = resolveTarget(id);\n            if (!target) continue;\n\n            const baseline = streamBaselines.get(toolCallId);\n            const arrayBaseline =\n              baseline?.targetId === target.id ? baseline.state : target.state;\n            if (!baseline || baseline.targetId !== target.id) {\n              streamBaselines.set(toolCallId, {\n                targetId: target.id,\n                state: target.state,\n              });\n            }\n\n            setDefState(target.id, (prev) =>\n              shallowMergeInteractableState(prev, partial, { arrayBaseline }),\n            );\n          }\n        } catch {\n          // Non-fatal: execute handles the final state\n        }\n      },\n      execute: async (args: unknown, { toolCallId }) => {\n        const { id, ...partial } = (args ?? {}) as Record<string, unknown>;\n        const target = resolveTarget(id);\n        if (!target) {\n          const validIds = instances.map((d) => d.id);\n          return {\n            success: false,\n            error: `Unknown id ${JSON.stringify(id)} for interactable \"${name}\". Valid ids: ${validIds.join(\", \")}`,\n          };\n        }\n        const baseline = streamBaselines.get(toolCallId);\n        streamBaselines.delete(toolCallId);\n        const addedItemIds: Record<string, string[]> = {};\n        setDefState(target.id, (prev) =>\n          shallowMergeInteractableState(prev, partial, {\n            arrayBaseline:\n              baseline?.targetId === target.id ? baseline.state : undefined,\n            idFactory: (field) => {\n              const itemId = generateId();\n              (addedItemIds[field] ??= []).push(itemId);\n              return itemId;\n            },\n            idKeyedFields,\n          }),\n        );\n        // The resolved id lets an id-less call's UI (and the model) address\n        // the instance that was actually updated.\n        const result: {\n          success: true;\n          id: string;\n          addedItemIds?: Record<string, string[]>;\n        } = { success: true, id: target.id };\n        if (Object.keys(addedItemIds).length > 0) {\n          result.addedItemIds = addedItemIds;\n        }\n        return result;\n      },\n    };\n  }\n\n  const interactables: Unstable_InteractableSnapshotEntry[] = entries.map(\n    (def) => ({\n      id: def.id,\n      name: def.name,\n      state: def.state,\n    }),\n  );\n  return { tools, unstable_composerMetadata: { interactables } };\n}\n"],"mappings":"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"}
+{"version":3,"file":"interactable-model-context.js","names":["Tool","toJSONSchema","Unstable_InteractableDefinition","interactableToolName","shallowMergeInteractableState","Unstable_InteractableSnapshotEntry","generateId","isRecord","PartialJSONSchema","ReturnType","ID_PROPERTY","type","const","description","hasIdProperty","schema","Record","properties","id","undefined","withRequiredItemId","required","withoutItemId","_omitted","Array","isArray","filter","key","toArrayUpdateSchema","field","itemSchema","items","idKeyed","add","remove","clear","update","additionalProperties","idKeyedArrayFieldNames","Set","names","value","Object","entries","withArrayUpdateSchemas","fromEntries","map","withRequiredId","partial","process","env","NODE_ENV","console","warn","_reserved","buildInteractableModelContext","definitions","partialSchemaCache","Map","setDefState","updater","prev","streamBaselines","targetId","state","tools","unstable_composerMetadata","values","length","byName","def","list","get","name","push","set","instances","toolName","first","partialSchema","idKeyedFields","resolveTarget","parameters","streamCall","reader","toolCallId","partialArgs","args","streamValues","keys","idIndex","indexOf","target","baseline","arrayBaseline","execute","validIds","d","success","error","JSON","stringify","join","delete","addedItemIds","idFactory","itemId","result","interactables"],"sources":["../../../src/react/client/interactable-model-context.ts"],"sourcesContent":["import type { Tool } from \"assistant-stream\";\nimport { toJSONSchema } from \"assistant-stream\";\nimport type { Unstable_InteractableDefinition } from \"../types/scopes/interactables\";\nimport {\n  interactableToolName,\n  shallowMergeInteractableState,\n  type Unstable_InteractableSnapshotEntry,\n} from \"../../model-context/interactable-composer-metadata\";\nimport { generateId } from \"../../utils/id\";\nimport { isRecord } from \"../../utils/json/is-json\";\n\nexport type PartialJSONSchema = ReturnType<typeof toJSONSchema>;\n\nconst ID_PROPERTY = {\n  type: \"string\" as const,\n  description:\n    \"The id of the instance to update, as shown in its state snapshot in the conversation.\",\n};\n\nconst hasIdProperty = (schema: Record<string, unknown>) => {\n  const properties = schema.properties;\n  return isRecord(properties) && properties.id !== undefined;\n};\n\nconst withRequiredItemId = (schema: Record<string, unknown>) => ({\n  ...schema,\n  required: [\"id\"],\n});\n\n// The framework assigns ids to new items, so the model never sees the `id`\n// field when adding (it can't address an item that doesn't exist yet).\nconst withoutItemId = (schema: Record<string, unknown>) => {\n  const { id: _omitted, ...properties } = isRecord(schema.properties)\n    ? schema.properties\n    : {};\n  const required = Array.isArray(schema.required)\n    ? schema.required.filter((key) => key !== \"id\")\n    : schema.required;\n  return { ...schema, properties, required };\n};\n\nconst toArrayUpdateSchema = (schema: unknown, field: string) => {\n  if (!isRecord(schema) || schema.type !== \"array\") return schema;\n  const itemSchema = schema.items;\n  if (Array.isArray(itemSchema) || !isRecord(itemSchema)) return schema;\n\n  const idKeyed = hasIdProperty(itemSchema);\n  const properties: Record<string, unknown> = {\n    add: {\n      type: \"array\",\n      items: idKeyed ? withoutItemId(itemSchema) : itemSchema,\n    },\n    remove: {\n      type: \"array\",\n      items: idKeyed ? ID_PROPERTY : itemSchema,\n    },\n    clear: { type: \"boolean\" },\n  };\n\n  if (idKeyed) {\n    properties.update = {\n      type: \"array\",\n      items: withRequiredItemId(itemSchema),\n    };\n  }\n\n  return {\n    type: \"object\" as const,\n    description:\n      `Operations for array field \"${field}\". To change one item use update ` +\n      `with its id; add new items (their ids are assigned for you), remove items ` +\n      `by id, or clear to empty. Change only the items you mean to — never resend ` +\n      `the whole array to edit one item.`,\n    properties,\n    additionalProperties: false,\n  };\n};\n\n// Top-level array fields whose items carry an `id` — the fields the framework\n// mints ids for on add.\nconst idKeyedArrayFieldNames = (\n  properties: Record<string, unknown>,\n): Set<string> => {\n  const names = new Set<string>();\n  for (const [key, value] of Object.entries(properties)) {\n    if (\n      isRecord(value) &&\n      value.type === \"array\" &&\n      isRecord(value.items) &&\n      hasIdProperty(value.items)\n    ) {\n      names.add(key);\n    }\n  }\n  return names;\n};\n\nconst withArrayUpdateSchemas = (properties: Record<string, unknown>) =>\n  Object.fromEntries(\n    Object.entries(properties).map(([key, value]) => [\n      key,\n      toArrayUpdateSchema(value, key),\n    ]),\n  );\n\n/**\n * Wraps an interactable's partial state schema with the required `id`\n * parameter. Falls back to a permissive schema when the partial conversion\n * failed at registration time.\n */\nfunction withRequiredId(partial: PartialJSONSchema | undefined) {\n  if (!partial || typeof partial !== \"object\" || partial.type !== \"object\") {\n    return {\n      type: \"object\" as const,\n      properties: { id: ID_PROPERTY },\n      required: [\"id\"],\n      additionalProperties: true,\n    };\n  }\n  if (process.env.NODE_ENV !== \"production\" && partial.properties?.id) {\n    console.warn(\n      `[Interactables] a top-level \"id\" field in an interactable's stateSchema is ` +\n        `reserved for instance addressing by the update tool and cannot be updated ` +\n        `by the model. Rename the field to make it model-writable.`,\n    );\n  }\n  const { id: _reserved, ...properties } = partial.properties ?? {};\n  return {\n    ...partial,\n    properties: { id: ID_PROPERTY, ...withArrayUpdateSchemas(properties) },\n    required: [\"id\"],\n  };\n}\n\nexport function buildInteractableModelContext(\n  definitions: Record<string, Unstable_InteractableDefinition>,\n  partialSchemaCache: Map<string, PartialJSONSchema>,\n  setDefState: (id: string, updater: (prev: unknown) => unknown) => void,\n  streamBaselines = new Map<string, { targetId: string; state: unknown }>(),\n):\n  | {\n      tools: Record<string, Tool<any, any>>;\n      unstable_composerMetadata?: Record<string, unknown>;\n    }\n  | undefined {\n  const entries = Object.values(definitions);\n  if (entries.length === 0) return undefined;\n\n  const byName = new Map<string, Unstable_InteractableDefinition[]>();\n  for (const def of entries) {\n    const list = byName.get(def.name) ?? [];\n    list.push(def);\n    byName.set(def.name, list);\n  }\n\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const [name, instances] of byName) {\n    const toolName = interactableToolName(name);\n    if (tools[toolName]) {\n      if (process.env.NODE_ENV !== \"production\") {\n        console.warn(\n          `[Interactables] interactable names \"${name}\" and another registered name ` +\n            `both sanitize to the tool name \"${toolName}\". Rename one of them.`,\n        );\n      }\n      continue;\n    }\n\n    const first = instances[0]!;\n    const partialSchema = partialSchemaCache.get(first.id);\n    const idKeyedFields =\n      partialSchema && isRecord(partialSchema.properties)\n        ? idKeyedArrayFieldNames(partialSchema.properties)\n        : new Set<string>();\n\n    // `id` resolves to a definition of this name; an id-less call is accepted\n    // only while exactly one instance exists.\n    const resolveTarget = (\n      id: unknown,\n    ): Unstable_InteractableDefinition | undefined => {\n      if (typeof id === \"string\") {\n        const def = definitions[id];\n        return def?.name === name ? def : undefined;\n      }\n      return instances.length === 1 ? first : undefined;\n    };\n\n    tools[toolName] = {\n      type: \"frontend\",\n      description:\n        `Update the state of interactable component \"${name}\". ${first.description} ` +\n        `Pass the id of the instance to update — instance ids and current state ` +\n        `appear in the conversation as state snapshots. Only include the fields ` +\n        `you want to change; omitted fields keep their current values.`,\n      parameters: withRequiredId(partialSchema),\n      streamCall: async (reader, { toolCallId }) => {\n        try {\n          for await (const partialArgs of reader.args.streamValues()) {\n            if (!partialArgs || typeof partialArgs !== \"object\") continue;\n            const args = partialArgs as Record<string, unknown>;\n            const keys = Object.keys(args);\n            const idIndex = keys.indexOf(\"id\");\n            if (idIndex === keys.length - 1) continue;\n\n            const { id, ...partial } = args;\n            if (Object.keys(partial).length === 0) continue;\n            const target = resolveTarget(id);\n            if (!target) continue;\n\n            const baseline = streamBaselines.get(toolCallId);\n            const arrayBaseline =\n              baseline?.targetId === target.id ? baseline.state : target.state;\n            if (!baseline || baseline.targetId !== target.id) {\n              streamBaselines.set(toolCallId, {\n                targetId: target.id,\n                state: target.state,\n              });\n            }\n\n            setDefState(target.id, (prev) =>\n              shallowMergeInteractableState(prev, partial, { arrayBaseline }),\n            );\n          }\n        } catch {\n          // Non-fatal: execute handles the final state\n        }\n      },\n      execute: async (args: unknown, { toolCallId }) => {\n        const { id, ...partial } = (args ?? {}) as Record<string, unknown>;\n        const target = resolveTarget(id);\n        if (!target) {\n          const validIds = instances.map((d) => d.id);\n          return {\n            success: false,\n            error: `Unknown id ${JSON.stringify(id)} for interactable \"${name}\". Valid ids: ${validIds.join(\", \")}`,\n          };\n        }\n        const baseline = streamBaselines.get(toolCallId);\n        streamBaselines.delete(toolCallId);\n        const addedItemIds: Record<string, string[]> = {};\n        setDefState(target.id, (prev) =>\n          shallowMergeInteractableState(prev, partial, {\n            arrayBaseline:\n              baseline?.targetId === target.id ? baseline.state : undefined,\n            idFactory: (field) => {\n              const itemId = generateId();\n              (addedItemIds[field] ??= []).push(itemId);\n              return itemId;\n            },\n            idKeyedFields,\n          }),\n        );\n        // The resolved id lets an id-less call's UI (and the model) address\n        // the instance that was actually updated.\n        const result: {\n          success: true;\n          id: string;\n          addedItemIds?: Record<string, string[]>;\n        } = { success: true, id: target.id };\n        if (Object.keys(addedItemIds).length > 0) {\n          result.addedItemIds = addedItemIds;\n        }\n        return result;\n      },\n    };\n  }\n\n  const interactables: Unstable_InteractableSnapshotEntry[] = entries.map(\n    (def) => ({\n      id: def.id,\n      name: def.name,\n      state: def.state,\n    }),\n  );\n  return { tools, unstable_composerMetadata: { interactables } };\n}\n"],"mappings":"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"}

package/dist/react/interactables-legacy/useAssistantInteractable.js

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

package/dist/react/interactables-legacy/useAssistantInteractable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantInteractable.js","names":["useEffect","useId","useRef","useAui","InteractableStateSchema","AssistantInteractableProps","description","stateSchema","initialState","id","selected","useAssistantInteractable","name","config","aui","autoId","replace","stateSchemaRef","current","initialStateRef","interactables","register"],"sources":["../../../src/react/interactables-legacy/useAssistantInteractable.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { InteractableStateSchema } from \"./scopes\";\n\n/**\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n */\nexport type AssistantInteractableProps = {\n  description: string;\n  stateSchema: InteractableStateSchema;\n  initialState: unknown;\n  id?: string;\n  selected?: boolean;\n};\n\n/**\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n *\n * Registers an interactable with the AI assistant.\n *\n * This hook handles registration only. To read and write the interactable's\n * state, use {@link useInteractableState} with the returned id.\n *\n * @returns The interactable instance id.\n */\nexport const useAssistantInteractable = (\n  name: string,\n  config: AssistantInteractableProps,\n): string => {\n  const aui = useAui();\n\n  const autoId = useId().replace(/[^a-zA-Z0-9]/g, \"\");\n  const id = config.id ?? autoId;\n\n  const stateSchemaRef = useRef(config.stateSchema);\n  stateSchemaRef.current = config.stateSchema;\n  const initialStateRef = useRef(config.initialState);\n  initialStateRef.current = config.initialState;\n\n  useEffect(() => {\n    return aui.interactables().register({\n      id,\n      name,\n      description: config.description,\n      stateSchema: stateSchemaRef.current,\n      initialState: initialStateRef.current,\n      selected: config.selected,\n    });\n  }, [aui, id, name, config.description, config.selected]);\n\n  return id;\n};\n"],"mappings":";;;;;;;;;;;;;;;AA6BA,MAAaW,4BACXC,MACAC,WACW;CACX,MAAMC,MAAMX,OAAO;CAEnB,MAAMY,SAASd,MAAM,CAAC,CAACe,QAAQ,iBAAiB,EAAE;CAClD,MAAMP,KAAKI,OAAOJ,MAAMM;CAExB,MAAME,iBAAiBf,OAAOW,OAAON,WAAW;CAChDU,eAAeC,UAAUL,OAAON;CAChC,MAAMY,kBAAkBjB,OAAOW,OAAOL,YAAY;CAClDW,gBAAgBD,UAAUL,OAAOL;CAEjCR,gBAAgB;EACd,OAAOc,IAAIM,cAAc,CAAC,CAACC,SAAS;GAClCZ;GACAG;GACAN,aAAaO,OAAOP;GACpBC,aAAaU,eAAeC;GAC5BV,cAAcW,gBAAgBD;GAC9BR,UAAUG,OAAOH;EACnB,CAAC;CACH,GAAG;EAACI;EAAKL;EAAIG;EAAMC,OAAOP;EAAaO,OAAOH;CAAQ,CAAC;CAEvD,OAAOD;AACT"}
+{"version":3,"file":"useAssistantInteractable.js","names":["useEffect","useId","useRef","useAui","InteractableStateSchema","AssistantInteractableProps","description","stateSchema","initialState","id","selected","useAssistantInteractable","name","config","aui","autoId","replace","stateSchemaRef","current","initialStateRef","interactables","register"],"sources":["../../../src/react/interactables-legacy/useAssistantInteractable.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { InteractableStateSchema } from \"./scopes\";\n\n/**\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n */\nexport type AssistantInteractableProps = {\n  description: string;\n  stateSchema: InteractableStateSchema;\n  initialState: unknown;\n  id?: string;\n  selected?: boolean;\n};\n\n/**\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n *\n * Registers an interactable with the AI assistant.\n *\n * This hook handles registration only. To read and write the interactable's\n * state, use {@link useInteractableState} with the returned id.\n *\n * @returns The interactable instance id.\n */\nexport const useAssistantInteractable = (\n  name: string,\n  config: AssistantInteractableProps,\n): string => {\n  const aui = useAui();\n\n  const autoId = useId().replace(/[^a-zA-Z0-9]/g, \"\");\n  const id = config.id ?? autoId;\n\n  const stateSchemaRef = useRef(config.stateSchema);\n  stateSchemaRef.current = config.stateSchema;\n  const initialStateRef = useRef(config.initialState);\n  initialStateRef.current = config.initialState;\n\n  useEffect(() => {\n    return aui.interactables.register({\n      id,\n      name,\n      description: config.description,\n      stateSchema: stateSchemaRef.current,\n      initialState: initialStateRef.current,\n      selected: config.selected,\n    });\n  }, [aui, id, name, config.description, config.selected]);\n\n  return id;\n};\n"],"mappings":";;;;;;;;;;;;;;;AA6BA,MAAaW,4BACXC,MACAC,WACW;CACX,MAAMC,MAAMX,OAAO;CAEnB,MAAMY,SAASd,MAAM,CAAC,CAACe,QAAQ,iBAAiB,EAAE;CAClD,MAAMP,KAAKI,OAAOJ,MAAMM;CAExB,MAAME,iBAAiBf,OAAOW,OAAON,WAAW;CAChDU,eAAeC,UAAUL,OAAON;CAChC,MAAMY,kBAAkBjB,OAAOW,OAAOL,YAAY;CAClDW,gBAAgBD,UAAUL,OAAOL;CAEjCR,gBAAgB;EACd,OAAOc,IAAIM,cAAcC,SAAS;GAChCZ;GACAG;GACAN,aAAaO,OAAOP;GACpBC,aAAaU,eAAeC;GAC5BV,cAAcW,gBAAgBD;GAC9BR,UAAUG,OAAOH;EACnB,CAAC;CACH,GAAG;EAACI;EAAKL;EAAIG;EAAMC,OAAOP;EAAaO,OAAOH;CAAQ,CAAC;CAEvD,OAAOD;AACT"}

package/dist/react/interactables-legacy/useInteractableState.js

@@ -1,4 +1,5 @@
 import { useAui, useAuiState } from "@assistant-ui/store";
+import "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 //#region src/react/interactables-legacy/useInteractableState.ts
 /**
@@ -24,7 +25,7 @@ const useInteractableState = (id, fallback) => {
 	let t1;
 	if ($[2] !== aui || $[3] !== id) {
 		t1 = (updater) => {
-			aui.interactables().setState(id, (prev) => {
+			aui.interactables.setState(id, (prev) => {
 				if (typeof updater === "function") return updater(prev);
 				return updater;
 			});
@@ -37,7 +38,7 @@ const useInteractableState = (id, fallback) => {
 	let t2;
 	if ($[5] !== aui || $[6] !== id) {
 		t2 = (selected) => {
-			aui.interactables().setSelected(id, selected);
+			aui.interactables.setSelected(id, selected);
 		};
 		$[5] = aui;
 		$[6] = id;
@@ -46,7 +47,7 @@ const useInteractableState = (id, fallback) => {
 	const setSelected = t2;
 	let t3;
 	if ($[8] !== aui) {
-		t3 = () => aui.interactables().flush();
+		t3 = () => aui.interactables.flush();
 		$[8] = aui;
 		$[9] = t3;
 	} else t3 = $[9];

package/dist/react/interactables-legacy/useInteractableState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInteractableState.js","names":["useCallback","useAui","useAuiState","StateUpdater","TState","prev","useInteractableState","id","fallback","$","_c","aui","state","s","interactables","definitions","t0","s_0","persistence","persistenceStatus","t1","updater","setState","t2","selected","setSelected","t3","flush","t4","isPending","t5","error","t6","t7"],"sources":["../../../src/react/interactables-legacy/useInteractableState.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\n\ntype StateUpdater<TState> = TState | ((prev: TState) => TState);\n\n/**\n * Reads and writes the state of a registered interactable.\n *\n * Pair with {@link useAssistantInteractable} which handles registration.\n *\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n */\nexport const useInteractableState = <TState>(\n  id: string,\n  fallback: TState,\n): [\n  TState,\n  {\n    setState: (updater: StateUpdater<TState>) => void;\n    setSelected: (selected: boolean) => void;\n    isPending: boolean;\n    error: unknown;\n    flush: () => Promise<void>;\n  },\n] => {\n  const aui = useAui();\n\n  const state =\n    (useAuiState((s) => s.interactables.definitions[id]?.state) as TState) ??\n    (fallback as TState);\n\n  const persistenceStatus = useAuiState((s) => s.interactables.persistence[id]);\n\n  const setState = useCallback(\n    (updater: StateUpdater<TState>) => {\n      aui.interactables().setState(id, (prev) => {\n        if (typeof updater === \"function\") {\n          return (updater as (prev: TState) => TState)(prev as TState);\n        }\n        return updater;\n      });\n    },\n    [aui, id],\n  );\n\n  const setSelected = useCallback(\n    (selected: boolean) => {\n      aui.interactables().setSelected(id, selected);\n    },\n    [aui, id],\n  );\n\n  const flush = useCallback(() => aui.interactables().flush(), [aui]);\n\n  return [\n    state,\n    {\n      setState,\n      setSelected,\n      isPending: persistenceStatus?.isPending ?? false,\n      error: persistenceStatus?.error,\n      flush,\n    },\n  ];\n};\n"],"mappings":";;;;;;;;;;;;AAcA,MAAaM,wBAAuBC,IAAAC,aAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAalC,MAAAC,MAAYV,OAAO;CAEnB,MAAAW,QACGV,aAAYW,MAAOA,EAACC,cAAcC,YAAaR,GAAU,EAAAK,KAAA,KACzDJ;CAAoB,IAAAQ;CAAA,IAAAP,EAAA,OAAAF,IAAA;EAEeS,MAAAC,QAAOJ,IAACC,cAAcI,YAAaX;EAAGE,EAAA,KAAAF;EAAAE,EAAA,KAAAO;CAAA,OAAAA,KAAAP,EAAA;CAA5E,MAAAU,oBAA0BjB,YAAYc,EAAsC;CAAE,IAAAI;CAAA,IAAAX,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAG5Ea,MAAAC,YAAA;GACEV,IAAGG,cAAe,CAAC,CAAAQ,SAAUf,KAAIF,SAAA;IAC/B,IAAI,OAAOgB,YAAY,YAAU,OACvBA,QAAqChB,IAAc;IAC5D,OACMgB;GAAO,CACf;EAAC;EACHZ,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CARH,MAAAa,WAAiBF;CAUf,IAAAG;CAAA,IAAAd,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAGAgB,MAAAC,aAAA;GACEb,IAAGG,cAAe,CAAC,CAAAW,YAAalB,IAAIiB,QAAQ;EAAC;EAC9Cf,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAHH,MAAAgB,cAAoBF;CAKlB,IAAAG;CAAA,IAAAjB,EAAA,OAAAE,KAAA;EAEwBe,WAAMf,IAAGG,cAAe,CAAC,CAAAa,MAAO;EAAClB,EAAA,KAAAE;EAAAF,EAAA,KAAAiB;CAAA,OAAAA,KAAAjB,EAAA;CAA3D,MAAAkB,QAAcD;CAOC,MAAAE,KAAAT,mBAAiBU,aAAjB;CACJ,MAAAC,KAAAX,mBAAiBY;CAAO,IAAAC;CAAA,IAAAvB,EAAA,QAAAkB,SAAAlB,EAAA,QAAAgB,eAAAhB,EAAA,QAAAa,YAAAb,EAAA,QAAAmB,MAAAnB,EAAA,QAAAqB,IAAA;EAJjCE,KAAA;GAAAV;GAAAG;GAAAI,WAGaD;GAAqCG,OACzCD;GAAwBH;EAEjC;EAAClB,EAAA,MAAAkB;EAAAlB,EAAA,MAAAgB;EAAAhB,EAAA,MAAAa;EAAAb,EAAA,MAAAmB;EAAAnB,EAAA,MAAAqB;EAAArB,EAAA,MAAAuB;CAAA,OAAAA,KAAAvB,EAAA;CAAA,IAAAwB;CAAA,IAAAxB,EAAA,QAAAG,SAAAH,EAAA,QAAAuB,IAAA;EARIC,KAAA,CACLrB,OACAoB,EAMC;EACFvB,EAAA,MAAAG;EAAAH,EAAA,MAAAuB;EAAAvB,EAAA,MAAAwB;CAAA,OAAAA,KAAAxB,EAAA;CAAA,OATMwB;AASN"}
+{"version":3,"file":"useInteractableState.js","names":["useCallback","useAui","useAuiState","StateUpdater","TState","prev","useInteractableState","id","fallback","$","_c","aui","state","s","interactables","definitions","t0","s_0","persistence","persistenceStatus","t1","updater","setState","t2","selected","setSelected","t3","flush","t4","isPending","t5","error","t6","t7"],"sources":["../../../src/react/interactables-legacy/useInteractableState.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\n\ntype StateUpdater<TState> = TState | ((prev: TState) => TState);\n\n/**\n * Reads and writes the state of a registered interactable.\n *\n * Pair with {@link useAssistantInteractable} which handles registration.\n *\n * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.\n * Scheduled for removal on/after 2026-09-14. See\n * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.\n */\nexport const useInteractableState = <TState>(\n  id: string,\n  fallback: TState,\n): [\n  TState,\n  {\n    setState: (updater: StateUpdater<TState>) => void;\n    setSelected: (selected: boolean) => void;\n    isPending: boolean;\n    error: unknown;\n    flush: () => Promise<void>;\n  },\n] => {\n  const aui = useAui();\n\n  const state =\n    (useAuiState((s) => s.interactables.definitions[id]?.state) as TState) ??\n    (fallback as TState);\n\n  const persistenceStatus = useAuiState((s) => s.interactables.persistence[id]);\n\n  const setState = useCallback(\n    (updater: StateUpdater<TState>) => {\n      aui.interactables.setState(id, (prev) => {\n        if (typeof updater === \"function\") {\n          return (updater as (prev: TState) => TState)(prev as TState);\n        }\n        return updater;\n      });\n    },\n    [aui, id],\n  );\n\n  const setSelected = useCallback(\n    (selected: boolean) => {\n      aui.interactables.setSelected(id, selected);\n    },\n    [aui, id],\n  );\n\n  const flush = useCallback(() => aui.interactables.flush(), [aui]);\n\n  return [\n    state,\n    {\n      setState,\n      setSelected,\n      isPending: persistenceStatus?.isPending ?? false,\n      error: persistenceStatus?.error,\n      flush,\n    },\n  ];\n};\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAaM,wBAAuBC,IAAAC,aAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAalC,MAAAC,MAAYV,OAAO;CAEnB,MAAAW,QACGV,aAAYW,MAAOA,EAACC,cAAcC,YAAaR,GAAU,EAAAK,KAAA,KACzDJ;CAAoB,IAAAQ;CAAA,IAAAP,EAAA,OAAAF,IAAA;EAEeS,MAAAC,QAAOJ,IAACC,cAAcI,YAAaX;EAAGE,EAAA,KAAAF;EAAAE,EAAA,KAAAO;CAAA,OAAAA,KAAAP,EAAA;CAA5E,MAAAU,oBAA0BjB,YAAYc,EAAsC;CAAE,IAAAI;CAAA,IAAAX,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAG5Ea,MAAAC,YAAA;GACEV,IAAGG,cAAcQ,SAAUf,KAAIF,SAAA;IAC7B,IAAI,OAAOgB,YAAY,YAAU,OACvBA,QAAqChB,IAAc;IAC5D,OACMgB;GAAO,CACf;EAAC;EACHZ,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CARH,MAAAa,WAAiBF;CAUf,IAAAG;CAAA,IAAAd,EAAA,OAAAE,OAAAF,EAAA,OAAAF,IAAA;EAGAgB,MAAAC,aAAA;GACEb,IAAGG,cAAcW,YAAalB,IAAIiB,QAAQ;EAAC;EAC5Cf,EAAA,KAAAE;EAAAF,EAAA,KAAAF;EAAAE,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAHH,MAAAgB,cAAoBF;CAKlB,IAAAG;CAAA,IAAAjB,EAAA,OAAAE,KAAA;EAEwBe,WAAMf,IAAGG,cAAca,MAAO;EAAClB,EAAA,KAAAE;EAAAF,EAAA,KAAAiB;CAAA,OAAAA,KAAAjB,EAAA;CAAzD,MAAAkB,QAAcD;CAOC,MAAAE,KAAAT,mBAAiBU,aAAjB;CACJ,MAAAC,KAAAX,mBAAiBY;CAAO,IAAAC;CAAA,IAAAvB,EAAA,QAAAkB,SAAAlB,EAAA,QAAAgB,eAAAhB,EAAA,QAAAa,YAAAb,EAAA,QAAAmB,MAAAnB,EAAA,QAAAqB,IAAA;EAJjCE,KAAA;GAAAV;GAAAG;GAAAI,WAGaD;GAAqCG,OACzCD;GAAwBH;EAEjC;EAAClB,EAAA,MAAAkB;EAAAlB,EAAA,MAAAgB;EAAAhB,EAAA,MAAAa;EAAAb,EAAA,MAAAmB;EAAAnB,EAAA,MAAAqB;EAAArB,EAAA,MAAAuB;CAAA,OAAAA,KAAAvB,EAAA;CAAA,IAAAwB;CAAA,IAAAxB,EAAA,QAAAG,SAAAH,EAAA,QAAAuB,IAAA;EARIC,KAAA,CACLrB,OACAoB,EAMC;EACFvB,EAAA,MAAAG;EAAAH,EAAA,MAAAuB;EAAAvB,EAAA,MAAAwB;CAAA,OAAAA,KAAAxB,EAAA;CAAA,OATMwB;AASN"}

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

@@ -8,7 +8,7 @@ const useAssistantContext = (config) => {
 	getContextRef.current = getContext;
 	useEffect(() => {
 		if (disabled) return;
-		return aui.modelContext().register({ getModelContext: () => ({ system: getContextRef.current() }) });
+		return aui.modelContext.register({ getModelContext: () => ({ system: getContextRef.current() }) });
 	}, [aui, disabled]);
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useAssistantContext.js","names":["useEffect","useRef","useAui","AssistantContextConfig","useAssistantContext","config","getContext","disabled","aui","getContextRef","current","modelContext","register","getModelContext","system"],"sources":["../../../src/react/model-context/useAssistantContext.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { AssistantContextConfig } from \"../..\";\n\nexport type { AssistantContextConfig };\n\nexport const useAssistantContext = (config: AssistantContextConfig) => {\n  const { getContext, disabled = false } = config;\n  const aui = useAui();\n  const getContextRef = useRef(getContext);\n  getContextRef.current = getContext;\n\n  useEffect(() => {\n    if (disabled) return;\n\n    return aui.modelContext().register({\n      getModelContext: () => ({\n        system: getContextRef.current(),\n      }),\n    });\n  }, [aui, disabled]);\n};\n"],"mappings":";;;AAMA,MAAaI,uBAAuBC,WAAmC;CACrE,MAAM,EAAEC,YAAYC,WAAW,UAAUF;CACzC,MAAMG,MAAMN,OAAO;CACnB,MAAMO,gBAAgBR,OAAOK,UAAU;CACvCG,cAAcC,UAAUJ;CAExBN,gBAAgB;EACd,IAAIO,UAAU;EAEd,OAAOC,IAAIG,aAAa,CAAC,CAACC,SAAS,EACjCC,wBAAwB,EACtBC,QAAQL,cAAcC,QAAQ,EAChC,GACF,CAAC;CACH,GAAG,CAACF,KAAKD,QAAQ,CAAC;AACpB"}
+{"version":3,"file":"useAssistantContext.js","names":["useEffect","useRef","useAui","AssistantContextConfig","useAssistantContext","config","getContext","disabled","aui","getContextRef","current","modelContext","register","getModelContext","system"],"sources":["../../../src/react/model-context/useAssistantContext.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { AssistantContextConfig } from \"../..\";\n\nexport type { AssistantContextConfig };\n\nexport const useAssistantContext = (config: AssistantContextConfig) => {\n  const { getContext, disabled = false } = config;\n  const aui = useAui();\n  const getContextRef = useRef(getContext);\n  getContextRef.current = getContext;\n\n  useEffect(() => {\n    if (disabled) return;\n\n    return aui.modelContext.register({\n      getModelContext: () => ({\n        system: getContextRef.current(),\n      }),\n    });\n  }, [aui, disabled]);\n};\n"],"mappings":";;;AAMA,MAAaI,uBAAuBC,WAAmC;CACrE,MAAM,EAAEC,YAAYC,WAAW,UAAUF;CACzC,MAAMG,MAAMN,OAAO;CACnB,MAAMO,gBAAgBR,OAAOK,UAAU;CACvCG,cAAcC,UAAUJ;CAExBN,gBAAgB;EACd,IAAIO,UAAU;EAEd,OAAOC,IAAIG,aAAaC,SAAS,EAC/BC,wBAAwB,EACtBC,QAAQL,cAAcC,QAAQ,EAChC,GACF,CAAC;CACH,GAAG,CAACF,KAAKD,QAAQ,CAAC;AACpB"}

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

@@ -15,7 +15,7 @@ const useAssistantDataUI = (dataUI) => {
 	if ($[0] !== aui || $[1] !== dataUI) {
 		t0 = () => {
 			if (!dataUI?.name || !dataUI?.render) return;
-			return aui.dataRenderers().setDataUI(dataUI.name, dataUI.render);
+			return aui.dataRenderers.setDataUI(dataUI.name, dataUI.render);
 		};
 		$[0] = aui;
 		$[1] = dataUI;

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

@@ -1 +1 @@
-{"version":3,"file":"useAssistantDataUI.js","names":["useEffect","useAui","DataMessagePartComponent","AssistantDataUIProps","name","render","T","useAssistantDataUI","dataUI","$","_c","aui","t0","dataRenderers","setDataUI","t1","t2","t3"],"sources":["../../../src/react/model-context/useAssistantDataUI.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { DataMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/** Props used to register a renderer for `data` message parts. */\nexport type AssistantDataUIProps<T = any> = {\n  /** Data part name this renderer handles. */\n  name: string;\n  /** Component rendered for matching data message parts. */\n  render: DataMessagePartComponent<T>;\n};\n\n/**\n * Registers a renderer for named `data` message parts while the component is\n * mounted.\n *\n * @param dataUI - Data renderer registration, or `null` to skip registration.\n */\nexport const useAssistantDataUI = (dataUI: AssistantDataUIProps | null) => {\n  const aui = useAui();\n  useEffect(() => {\n    if (!dataUI?.name || !dataUI?.render) return undefined;\n    return aui.dataRenderers().setDataUI(dataUI.name, dataUI.render);\n  }, [aui, dataUI?.name, dataUI?.render]);\n};\n"],"mappings":";;;;;;;;;;AAkBA,MAAaO,sBAAqBC,WAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAChC,MAAAC,MAAYV,OAAO;CAAE,IAAAW;CAAA,IAAAH,EAAA,OAAAE,OAAAF,EAAA,OAAAD,QAAA;EACXI,WAAA;GACR,IAAI,CAACJ,QAAMJ,QAAP,CAAkBI,QAAMH,QAAQ;GAAmB,OAChDM,IAAGE,cAAe,CAAC,CAAAC,UAAWN,OAAMJ,MAAOI,OAAMH,MAAO;EAAC;EACjEI,EAAA,KAAAE;EAAAF,EAAA,KAAAD;EAAAC,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CAAQ,MAAAM,KAAAP,QAAMJ;CAAQ,MAAAY,KAAAR,QAAMH;CAAQ,IAAAY;CAAA,IAAAR,EAAA,OAAAE,OAAAF,EAAA,OAAAM,MAAAN,EAAA,OAAAO,IAAA;EAAlCC,KAAA;GAACN;GAAKI;GAAcC;EAAc;EAACP,EAAA,KAAAE;EAAAF,EAAA,KAAAM;EAAAN,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;CAAA,OAAAA,KAAAR,EAAA;CAHtCT,UAAUY,IAGPK,EAAmC;AAAC"}
+{"version":3,"file":"useAssistantDataUI.js","names":["useEffect","useAui","DataMessagePartComponent","AssistantDataUIProps","name","render","T","useAssistantDataUI","dataUI","$","_c","aui","t0","dataRenderers","setDataUI","t1","t2","t3"],"sources":["../../../src/react/model-context/useAssistantDataUI.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { DataMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/** Props used to register a renderer for `data` message parts. */\nexport type AssistantDataUIProps<T = any> = {\n  /** Data part name this renderer handles. */\n  name: string;\n  /** Component rendered for matching data message parts. */\n  render: DataMessagePartComponent<T>;\n};\n\n/**\n * Registers a renderer for named `data` message parts while the component is\n * mounted.\n *\n * @param dataUI - Data renderer registration, or `null` to skip registration.\n */\nexport const useAssistantDataUI = (dataUI: AssistantDataUIProps | null) => {\n  const aui = useAui();\n  useEffect(() => {\n    if (!dataUI?.name || !dataUI?.render) return undefined;\n    return aui.dataRenderers.setDataUI(dataUI.name, dataUI.render);\n  }, [aui, dataUI?.name, dataUI?.render]);\n};\n"],"mappings":";;;;;;;;;;AAkBA,MAAaO,sBAAqBC,WAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAChC,MAAAC,MAAYV,OAAO;CAAE,IAAAW;CAAA,IAAAH,EAAA,OAAAE,OAAAF,EAAA,OAAAD,QAAA;EACXI,WAAA;GACR,IAAI,CAACJ,QAAMJ,QAAP,CAAkBI,QAAMH,QAAQ;GAAmB,OAChDM,IAAGE,cAAcC,UAAWN,OAAMJ,MAAOI,OAAMH,MAAO;EAAC;EAC/DI,EAAA,KAAAE;EAAAF,EAAA,KAAAD;EAAAC,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CAAQ,MAAAM,KAAAP,QAAMJ;CAAQ,MAAAY,KAAAR,QAAMH;CAAQ,IAAAY;CAAA,IAAAR,EAAA,OAAAE,OAAAF,EAAA,OAAAM,MAAAN,EAAA,OAAAO,IAAA;EAAlCC,KAAA;GAACN;GAAKI;GAAcC;EAAc;EAACP,EAAA,KAAAE;EAAAF,EAAA,KAAAM;EAAAN,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;CAAA,OAAAA,KAAAR,EAAA;CAHtCT,UAAUY,IAGPK,EAAmC;AAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useAssistantInstructions.js","names":["useEffect","useAui","AssistantInstructionsConfig","getInstructions","instruction","useAssistantInstructions","config","$","_c","t0","disabled","t1","undefined","aui","t2","t3","config_0","system","modelContext","register","getModelContext"],"sources":["../../../src/react/model-context/useAssistantInstructions.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { AssistantInstructionsConfig } from \"../..\";\n\nexport type { AssistantInstructionsConfig };\n\nconst getInstructions = (\n  instruction: string | AssistantInstructionsConfig,\n): AssistantInstructionsConfig => {\n  if (typeof instruction === \"string\") return { instruction };\n  return instruction;\n};\n\nexport const useAssistantInstructions = (\n  config: string | AssistantInstructionsConfig,\n) => {\n  const { instruction, disabled = false } = getInstructions(config);\n  const aui = useAui();\n\n  useEffect(() => {\n    if (disabled) return;\n\n    const config = {\n      system: instruction,\n    };\n    return aui.modelContext().register({\n      getModelContext: () => config,\n    });\n  }, [aui, instruction, disabled]);\n};\n"],"mappings":";;;;AAMA,MAAMG,mBACJC,gBACgC;CAChC,IAAI,OAAOA,gBAAgB,UAAU,OAAO,EAAEA,YAAY;CAC1D,OAAOA;AACT;AAEA,MAAaC,4BAA2BC,WAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,QAAA;EAGIG,KAAAN,gBAAgBG,MAAM;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAAjE,MAAA,EAAAH,aAAAM,UAAAC,OAA0CF;CAArB,MAAAC,WAAAC,OAAAC,KAAAA,IAAA,QAAAD;CACrB,MAAAE,MAAYZ,OAAO;CAAE,IAAAa;CAAA,IAAAC;CAAA,IAAAR,EAAA,OAAAM,OAAAN,EAAA,OAAAG,YAAAH,EAAA,OAAAH,aAAA;EAEXU,WAAA;GACR,IAAIJ,UAAQ;GAEZ,MAAAM,WAAe,EAAAC,QACLb,YACV;GAAE,OACKS,IAAGK,aAAc,CAAC,CAAAC,SAAU,EAAAC,uBACVd,SACzB,CAAC;EAAC;EACDS,KAAA;GAACF;GAAKT;GAAaM;EAAQ;EAACH,EAAA,KAAAM;EAAAN,EAAA,KAAAG;EAAAH,EAAA,KAAAH;EAAAG,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;CAAA,OAAA;EAAAD,KAAAP,EAAA;EAAAQ,KAAAR,EAAA;CAAA;CAT/BP,UAAUc,IASPC,EAA4B;AAAC"}
+{"version":3,"file":"useAssistantInstructions.js","names":["useEffect","useAui","AssistantInstructionsConfig","getInstructions","instruction","useAssistantInstructions","config","$","_c","t0","disabled","t1","undefined","aui","t2","t3","config_0","system","modelContext","register","getModelContext"],"sources":["../../../src/react/model-context/useAssistantInstructions.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { AssistantInstructionsConfig } from \"../..\";\n\nexport type { AssistantInstructionsConfig };\n\nconst getInstructions = (\n  instruction: string | AssistantInstructionsConfig,\n): AssistantInstructionsConfig => {\n  if (typeof instruction === \"string\") return { instruction };\n  return instruction;\n};\n\nexport const useAssistantInstructions = (\n  config: string | AssistantInstructionsConfig,\n) => {\n  const { instruction, disabled = false } = getInstructions(config);\n  const aui = useAui();\n\n  useEffect(() => {\n    if (disabled) return;\n\n    const config = {\n      system: instruction,\n    };\n    return aui.modelContext.register({\n      getModelContext: () => config,\n    });\n  }, [aui, instruction, disabled]);\n};\n"],"mappings":";;;;AAMA,MAAMG,mBACJC,gBACgC;CAChC,IAAI,OAAOA,gBAAgB,UAAU,OAAO,EAAEA,YAAY;CAC1D,OAAOA;AACT;AAEA,MAAaC,4BAA2BC,WAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,QAAA;EAGIG,KAAAN,gBAAgBG,MAAM;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAAjE,MAAA,EAAAH,aAAAM,UAAAC,OAA0CF;CAArB,MAAAC,WAAAC,OAAAC,KAAAA,IAAA,QAAAD;CACrB,MAAAE,MAAYZ,OAAO;CAAE,IAAAa;CAAA,IAAAC;CAAA,IAAAR,EAAA,OAAAM,OAAAN,EAAA,OAAAG,YAAAH,EAAA,OAAAH,aAAA;EAEXU,WAAA;GACR,IAAIJ,UAAQ;GAEZ,MAAAM,WAAe,EAAAC,QACLb,YACV;GAAE,OACKS,IAAGK,aAAaC,SAAU,EAAAC,uBACRd,SACzB,CAAC;EAAC;EACDS,KAAA;GAACF;GAAKT;GAAaM;EAAQ;EAACH,EAAA,KAAAM;EAAAN,EAAA,KAAAG;EAAAH,EAAA,KAAAH;EAAAG,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;CAAA,OAAA;EAAAD,KAAAP,EAAA;EAAAQ,KAAAR,EAAA;CAAA;CAT/BP,UAAUc,IASPC,EAA4B;AAAC"}

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

@@ -38,7 +38,7 @@ import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 * ```
 */
 const useAssistantTool = (tool) => {
-	const $ = c(14);
+	const $ = c(20);
 	const aui = useAui();
 	let t0;
 	if ($[0] !== tool) {
@@ -56,46 +56,50 @@ const useAssistantTool = (tool) => {
 	const renderTextComponent = t1;
 	const render = tool.render ?? renderTextComponent;
 	let t2;
-	let t3;
-	if ($[4] !== aui || $[5] !== render || $[6] !== standalone || $[7] !== tool.toolName) {
+	if ($[4] !== aui.tools || $[5] !== render || $[6] !== standalone || $[7] !== tool.toolName) {
 		t2 = () => {
 			if (!render) return;
-			return aui.tools().setToolUI(tool.toolName, render, { standalone });
+			return aui.tools.setToolUI(tool.toolName, render, { standalone });
 		};
+		$[4] = aui.tools;
+		$[5] = render;
+		$[6] = standalone;
+		$[7] = tool.toolName;
+		$[8] = t2;
+	} else t2 = $[8];
+	let t3;
+	if ($[9] !== aui || $[10] !== render || $[11] !== standalone || $[12] !== tool.toolName) {
 		t3 = [
 			aui,
 			tool.toolName,
 			render,
 			standalone
 		];
-		$[4] = aui;
-		$[5] = render;
-		$[6] = standalone;
-		$[7] = tool.toolName;
-		$[8] = t2;
-		$[9] = t3;
-	} else {
-		t2 = $[8];
-		t3 = $[9];
-	}
+		$[9] = aui;
+		$[10] = render;
+		$[11] = standalone;
+		$[12] = tool.toolName;
+		$[13] = t3;
+	} else t3 = $[13];
 	useEffect(t2, t3);
 	let t4;
-	let t5;
-	if ($[10] !== aui || $[11] !== tool) {
+	if ($[14] !== aui.modelContext || $[15] !== tool) {
 		t4 = () => {
 			const { toolName, render: render_0, renderText, display, ...rest } = tool;
 			const context = { tools: { [toolName]: rest } };
-			return aui.modelContext().register({ getModelContext: () => context });
+			return aui.modelContext.register({ getModelContext: () => context });
 		};
+		$[14] = aui.modelContext;
+		$[15] = tool;
+		$[16] = t4;
+	} else t4 = $[16];
+	let t5;
+	if ($[17] !== aui || $[18] !== tool) {
 		t5 = [aui, tool];
-		$[10] = aui;
-		$[11] = tool;
-		$[12] = t4;
-		$[13] = t5;
-	} else {
-		t4 = $[12];
-		t5 = $[13];
-	}
+		$[17] = aui;
+		$[18] = tool;
+		$[19] = t5;
+	} else t5 = $[19];
 	useEffect(t4, t5);
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useAssistantTool.js","names":["useEffect","useMemo","useAui","ToolCallMessagePartComponent","AssistantToolProps","CoreAssistantToolProps","isStandaloneToolDisplay","makeToolCallTextComponent","ToolCallText","Record","TArgs","TResult","render","renderText","useAssistantTool","tool","$","_c","aui","t0","standalone","t1","undefined","renderTextComponent","t2","t3","toolName","tools","setToolUI","t4","t5","render_0","display","rest","context","modelContext","register","getModelContext"],"sources":["../../../src/react/model-context/useAssistantTool.ts"],"sourcesContent":["import { useEffect, useMemo } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport type { AssistantToolProps as CoreAssistantToolProps } from \"../..\";\nimport {\n  isStandaloneToolDisplay,\n  makeToolCallTextComponent,\n  type ToolCallText,\n} from \"./toolbox\";\n\n/**\n * Props used to register a tool from React.\n *\n * @deprecated Use a toolkit with `Tools({ toolkit })` and register it via\n * `useAui({ tools: Tools({ toolkit }) })` instead. See\n * https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport type AssistantToolProps<\n  TArgs extends Record<string, unknown>,\n  TResult,\n> = CoreAssistantToolProps<TArgs, TResult> & {\n  /** Component used to render calls to this tool in assistant messages. */\n  render?: ToolCallMessagePartComponent<TArgs, TResult> | undefined;\n  /** Lightweight text rendered while a tool call is running or complete. */\n  renderText?: ToolCallText<TArgs, TResult> | undefined;\n};\n\n/**\n * Registers a tool with the assistant model context while the component is\n * mounted.\n *\n * If `render` is provided, it is also installed as the renderer for matching\n * tool-call message parts. The registration is removed automatically when the\n * component unmounts or the tool definition changes.\n *\n * Pass a referentially stable tool object, such as one declared at module\n * scope or memoized with `useMemo`, to avoid re-registering on every render.\n *\n * @param tool - Tool definition and name to register.\n *\n * @deprecated Use a toolkit with `Tools({ toolkit })` and register it via\n * `useAui({ tools: Tools({ toolkit }) })` instead. See\n * https://assistant-ui.com/docs/migrations/toolkit-tools.\n *\n * @example\n * ```tsx\n * const weatherTool = {\n *   toolName: \"get_weather\",\n *   type: \"frontend\",\n *   description: \"Get the weather for a city.\",\n *   parameters: weatherSchema,\n *   execute: async ({ city }: { city: string }) => fetchWeather(city),\n *   render: WeatherToolUI,\n * } satisfies AssistantToolProps<{ city: string }, Weather>;\n *\n * function WeatherToolRegistration() {\n *   useAssistantTool(weatherTool);\n *   return null;\n * }\n * ```\n */\nexport const useAssistantTool = <\n  TArgs extends Record<string, unknown>,\n  TResult,\n>(\n  tool: AssistantToolProps<TArgs, TResult>,\n) => {\n  const aui = useAui();\n\n  const standalone = isStandaloneToolDisplay(tool);\n  const renderTextComponent = useMemo(\n    () =>\n      tool.renderText ? makeToolCallTextComponent(tool.renderText) : undefined,\n    [tool.renderText],\n  );\n  const render = tool.render ?? renderTextComponent;\n\n  useEffect(() => {\n    if (!render) return undefined;\n    return aui.tools().setToolUI(tool.toolName, render, { standalone });\n  }, [aui, tool.toolName, render, standalone]);\n\n  useEffect(() => {\n    // `render`, `renderText`, and `display` are client-only presentation\n    // concerns and never reach the model.\n    const { toolName, render, renderText, display, ...rest } = tool;\n    const context = {\n      tools: {\n        [toolName]: rest,\n      },\n    };\n    return aui.modelContext().register({\n      getModelContext: () => context,\n    });\n  }, [aui, tool]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,MAAac,oBAAmBC,SAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAM9B,MAAAC,MAAYhB,OAAO;CAAE,IAAAiB;CAAA,IAAAH,EAAA,OAAAD,MAAA;EAEFI,KAAAb,wBAAwBS,IAAI;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CAAhD,MAAAI,aAAmBD;CAA8B,IAAAE;CAAA,IAAAL,EAAA,OAAAD,KAAAF,YAAA;EAG7CQ,KAAAN,KAAIF,aAAcN,0BAA0BQ,KAAIF,UAAuB,IAAvES,KAAAA;EAAwEN,EAAA,KAAAD,KAAAF;EAAAG,EAAA,KAAAK;CAAA,OAAAA,KAAAL,EAAA;CAF5E,MAAAO,sBAEIF;CAGJ,MAAAT,SAAeG,KAAIH,UAAJW;CAAmC,IAAAC;CAAA,IAAAC;CAAA,IAAAT,EAAA,OAAAE,OAAAF,EAAA,OAAAJ,UAAAI,EAAA,OAAAI,cAAAJ,EAAA,OAAAD,KAAAW,UAAA;EAExCF,WAAA;GACR,IAAI,CAACZ,QAAM;GAAmB,OACvBM,IAAGS,MAAO,CAAC,CAAAC,UAAWb,KAAIW,UAAWd,QAAQ,EAAAQ,WAAa,CAAC;EAAC;EAClEK,KAAA;GAACP;GAAKH,KAAIW;GAAWd;GAAQQ;EAAU;EAACJ,EAAA,KAAAE;EAAAF,EAAA,KAAAJ;EAAAI,EAAA,KAAAI;EAAAJ,EAAA,KAAAD,KAAAW;EAAAV,EAAA,KAAAQ;EAAAR,EAAA,KAAAS;CAAA,OAAA;EAAAD,KAAAR,EAAA;EAAAS,KAAAT,EAAA;CAAA;CAH3ChB,UAAUwB,IAGPC,EAAwC;CAAC,IAAAI;CAAA,IAAAC;CAAA,IAAAd,EAAA,QAAAE,OAAAF,EAAA,QAAAD,MAAA;EAElCc,WAAA;GAGR,MAAA,EAAAH,UAAAd,QAAAmB,UAAAlB,YAAAmB,SAAA,GAAAC,SAA2DlB;GAC3D,MAAAmB,UAAgB,EAAAP,OACP,GACJD,WAAWO,KACd,EACF;GAAE,OACKf,IAAGiB,aAAc,CAAC,CAAAC,SAAU,EAAAC,uBACVH,QACzB,CAAC;EAAC;EACDJ,KAAA,CAACZ,KAAKH,IAAI;EAACC,EAAA,MAAAE;EAAAF,EAAA,MAAAD;EAAAC,EAAA,MAAAa;EAAAb,EAAA,MAAAc;CAAA,OAAA;EAAAD,KAAAb,EAAA;EAAAc,KAAAd,EAAA;CAAA;CAZdhB,UAAU6B,IAYPC,EAAW;AAAC"}
+{"version":3,"file":"useAssistantTool.js","names":["useEffect","useMemo","useAui","ToolCallMessagePartComponent","AssistantToolProps","CoreAssistantToolProps","isStandaloneToolDisplay","makeToolCallTextComponent","ToolCallText","Record","TArgs","TResult","render","renderText","useAssistantTool","tool","$","_c","aui","t0","standalone","t1","undefined","renderTextComponent","t2","tools","toolName","setToolUI","t3","t4","modelContext","render_0","display","rest","context","register","getModelContext","t5"],"sources":["../../../src/react/model-context/useAssistantTool.ts"],"sourcesContent":["import { useEffect, useMemo } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport type { AssistantToolProps as CoreAssistantToolProps } from \"../..\";\nimport {\n  isStandaloneToolDisplay,\n  makeToolCallTextComponent,\n  type ToolCallText,\n} from \"./toolbox\";\n\n/**\n * Props used to register a tool from React.\n *\n * @deprecated Use a toolkit with `Tools({ toolkit })` and register it via\n * `useAui({ tools: Tools({ toolkit }) })` instead. See\n * https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport type AssistantToolProps<\n  TArgs extends Record<string, unknown>,\n  TResult,\n> = CoreAssistantToolProps<TArgs, TResult> & {\n  /** Component used to render calls to this tool in assistant messages. */\n  render?: ToolCallMessagePartComponent<TArgs, TResult> | undefined;\n  /** Lightweight text rendered while a tool call is running or complete. */\n  renderText?: ToolCallText<TArgs, TResult> | undefined;\n};\n\n/**\n * Registers a tool with the assistant model context while the component is\n * mounted.\n *\n * If `render` is provided, it is also installed as the renderer for matching\n * tool-call message parts. The registration is removed automatically when the\n * component unmounts or the tool definition changes.\n *\n * Pass a referentially stable tool object, such as one declared at module\n * scope or memoized with `useMemo`, to avoid re-registering on every render.\n *\n * @param tool - Tool definition and name to register.\n *\n * @deprecated Use a toolkit with `Tools({ toolkit })` and register it via\n * `useAui({ tools: Tools({ toolkit }) })` instead. See\n * https://assistant-ui.com/docs/migrations/toolkit-tools.\n *\n * @example\n * ```tsx\n * const weatherTool = {\n *   toolName: \"get_weather\",\n *   type: \"frontend\",\n *   description: \"Get the weather for a city.\",\n *   parameters: weatherSchema,\n *   execute: async ({ city }: { city: string }) => fetchWeather(city),\n *   render: WeatherToolUI,\n * } satisfies AssistantToolProps<{ city: string }, Weather>;\n *\n * function WeatherToolRegistration() {\n *   useAssistantTool(weatherTool);\n *   return null;\n * }\n * ```\n */\nexport const useAssistantTool = <\n  TArgs extends Record<string, unknown>,\n  TResult,\n>(\n  tool: AssistantToolProps<TArgs, TResult>,\n) => {\n  const aui = useAui();\n\n  const standalone = isStandaloneToolDisplay(tool);\n  const renderTextComponent = useMemo(\n    () =>\n      tool.renderText ? makeToolCallTextComponent(tool.renderText) : undefined,\n    [tool.renderText],\n  );\n  const render = tool.render ?? renderTextComponent;\n\n  useEffect(() => {\n    if (!render) return undefined;\n    return aui.tools.setToolUI(tool.toolName, render, { standalone });\n  }, [aui, tool.toolName, render, standalone]);\n\n  useEffect(() => {\n    // `render`, `renderText`, and `display` are client-only presentation\n    // concerns and never reach the model.\n    const { toolName, render, renderText, display, ...rest } = tool;\n    const context = {\n      tools: {\n        [toolName]: rest,\n      },\n    };\n    return aui.modelContext.register({\n      getModelContext: () => context,\n    });\n  }, [aui, tool]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,MAAac,oBAAmBC,SAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAM9B,MAAAC,MAAYhB,OAAO;CAAE,IAAAiB;CAAA,IAAAH,EAAA,OAAAD,MAAA;EAEFI,KAAAb,wBAAwBS,IAAI;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CAAhD,MAAAI,aAAmBD;CAA8B,IAAAE;CAAA,IAAAL,EAAA,OAAAD,KAAAF,YAAA;EAG7CQ,KAAAN,KAAIF,aAAcN,0BAA0BQ,KAAIF,UAAuB,IAAvES,KAAAA;EAAwEN,EAAA,KAAAD,KAAAF;EAAAG,EAAA,KAAAK;CAAA,OAAAA,KAAAL,EAAA;CAF5E,MAAAO,sBAEIF;CAGJ,MAAAT,SAAeG,KAAIH,UAAJW;CAAmC,IAAAC;CAAA,IAAAR,EAAA,OAAAE,IAAAO,SAAAT,EAAA,OAAAJ,UAAAI,EAAA,OAAAI,cAAAJ,EAAA,OAAAD,KAAAW,UAAA;EAExCF,WAAA;GACR,IAAI,CAACZ,QAAM;GAAmB,OACvBM,IAAGO,MAAME,UAAWZ,KAAIW,UAAWd,QAAQ,EAAAQ,WAAa,CAAC;EAAC;EAClEJ,EAAA,KAAAE,IAAAO;EAAAT,EAAA,KAAAJ;EAAAI,EAAA,KAAAI;EAAAJ,EAAA,KAAAD,KAAAW;EAAAV,EAAA,KAAAQ;CAAA,OAAAA,KAAAR,EAAA;CAAA,IAAAY;CAAA,IAAAZ,EAAA,OAAAE,OAAAF,EAAA,QAAAJ,UAAAI,EAAA,QAAAI,cAAAJ,EAAA,QAAAD,KAAAW,UAAA;EAAEE,KAAA;GAACV;GAAKH,KAAIW;GAAWd;GAAQQ;EAAU;EAACJ,EAAA,KAAAE;EAAAF,EAAA,MAAAJ;EAAAI,EAAA,MAAAI;EAAAJ,EAAA,MAAAD,KAAAW;EAAAV,EAAA,MAAAY;CAAA,OAAAA,KAAAZ,EAAA;CAH3ChB,UAAUwB,IAGPI,EAAwC;CAAC,IAAAC;CAAA,IAAAb,EAAA,QAAAE,IAAAY,gBAAAd,EAAA,QAAAD,MAAA;EAElCc,WAAA;GAGR,MAAA,EAAAH,UAAAd,QAAAmB,UAAAlB,YAAAmB,SAAA,GAAAC,SAA2DlB;GAC3D,MAAAmB,UAAgB,EAAAT,OACP,GACJC,WAAWO,KACd,EACF;GAAE,OACKf,IAAGY,aAAaK,SAAU,EAAAC,uBACRF,QACzB,CAAC;EAAC;EACHlB,EAAA,MAAAE,IAAAY;EAAAd,EAAA,MAAAD;EAAAC,EAAA,MAAAa;CAAA,OAAAA,KAAAb,EAAA;CAAA,IAAAqB;CAAA,IAAArB,EAAA,QAAAE,OAAAF,EAAA,QAAAD,MAAA;EAAEsB,KAAA,CAACnB,KAAKH,IAAI;EAACC,EAAA,MAAAE;EAAAF,EAAA,MAAAD;EAAAC,EAAA,MAAAqB;CAAA,OAAAA,KAAArB,EAAA;CAZdhB,UAAU6B,IAYPQ,EAAW;AAAC"}

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

@@ -22,7 +22,7 @@ const useAssistantToolUI = (tool) => {
 	if ($[0] !== aui || $[1] !== standalone || $[2] !== tool) {
 		t0 = () => {
 			if (!tool?.toolName || !tool?.render) return;
-			return aui.tools().setToolUI(tool.toolName, tool.render, { standalone });
+			return aui.tools.setToolUI(tool.toolName, tool.render, { standalone });
 		};
 		$[0] = aui;
 		$[1] = standalone;

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

@@ -1 +1 @@
-{"version":3,"file":"useAssistantToolUI.js","names":["useEffect","useAui","ToolCallMessagePartComponent","AssistantToolUIProps","toolName","render","TArgs","TResult","display","useAssistantToolUI","tool","$","_c","aui","standalone","t0","tools","setToolUI","t1","t2","t3"],"sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/**\n * Props used to register a renderer for tool-call message parts.\n *\n * @deprecated Put `render`/`renderText` on the matching toolkit entry, or use\n * `MessagePrimitive.Parts` inline tool render overrides for per-message UI.\n * See https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport type AssistantToolUIProps<TArgs, TResult> = {\n  /** Name of the tool whose calls should use this renderer. */\n  toolName: string;\n  /** Component rendered for matching tool-call message parts. */\n  render: ToolCallMessagePartComponent<TArgs, TResult>;\n  /**\n   * How the UI is presented relative to the chain-of-thought trace. Set\n   * `\"standalone\"` to surface it on its own (e.g. human-in-the-loop or\n   * generative UI for a backend/MCP tool). Defaults to `\"inline\"`.\n   */\n  display?: \"standalone\" | \"inline\";\n};\n\n/**\n * Registers a tool-call renderer while the component is mounted.\n *\n * This only affects rendering. Pair it with {@link Tools} or a backend tool\n * registry to expose the actual tool definition to the model.\n *\n * @param tool - Tool renderer registration, or `null` to skip registration.\n *\n * @deprecated Put `render`/`renderText` on the matching toolkit entry, or use\n * `MessagePrimitive.Parts` inline tool render overrides for per-message UI.\n * See https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport const useAssistantToolUI = (\n  tool: AssistantToolUIProps<any, any> | null,\n) => {\n  const aui = useAui();\n  const standalone = tool?.display === \"standalone\";\n  useEffect(() => {\n    if (!tool?.toolName || !tool?.render) return undefined;\n    return aui.tools().setToolUI(tool.toolName, tool.render, { standalone });\n  }, [aui, tool?.toolName, tool?.render, standalone]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAoCA,MAAaS,sBAAqBC,SAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAGhC,MAAAC,MAAYZ,OAAO;CACnB,MAAAa,aAAmBJ,MAAIF,YAAc;CAAa,IAAAO;CAAA,IAAAJ,EAAA,OAAAE,OAAAF,EAAA,OAAAG,cAAAH,EAAA,OAAAD,MAAA;EACxCK,WAAA;GACR,IAAI,CAACL,MAAIN,YAAL,CAAoBM,MAAIL,QAAQ;GAAmB,OAChDQ,IAAGG,MAAO,CAAC,CAAAC,UAAWP,KAAIN,UAAWM,KAAIL,QAAS,EAAAS,WAAa,CAAC;EAAC;EACzEH,EAAA,KAAAE;EAAAF,EAAA,KAAAG;EAAAH,EAAA,KAAAD;EAAAC,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAQ,MAAAO,KAAAR,MAAIN;CAAY,MAAAe,KAAAT,MAAIL;CAAQ,IAAAe;CAAA,IAAAT,EAAA,OAAAE,OAAAF,EAAA,OAAAG,cAAAH,EAAA,OAAAO,MAAAP,EAAA,OAAAQ,IAAA;EAAlCC,KAAA;GAACP;GAAKK;GAAgBC;GAAcL;EAAU;EAACH,EAAA,KAAAE;EAAAF,EAAA,KAAAG;EAAAH,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;EAAAR,EAAA,KAAAS;CAAA,OAAAA,KAAAT,EAAA;CAHlDX,UAAUe,IAGPK,EAA+C;AAAC"}
+{"version":3,"file":"useAssistantToolUI.js","names":["useEffect","useAui","ToolCallMessagePartComponent","AssistantToolUIProps","toolName","render","TArgs","TResult","display","useAssistantToolUI","tool","$","_c","aui","standalone","t0","tools","setToolUI","t1","t2","t3"],"sources":["../../../src/react/model-context/useAssistantToolUI.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/**\n * Props used to register a renderer for tool-call message parts.\n *\n * @deprecated Put `render`/`renderText` on the matching toolkit entry, or use\n * `MessagePrimitive.Parts` inline tool render overrides for per-message UI.\n * See https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport type AssistantToolUIProps<TArgs, TResult> = {\n  /** Name of the tool whose calls should use this renderer. */\n  toolName: string;\n  /** Component rendered for matching tool-call message parts. */\n  render: ToolCallMessagePartComponent<TArgs, TResult>;\n  /**\n   * How the UI is presented relative to the chain-of-thought trace. Set\n   * `\"standalone\"` to surface it on its own (e.g. human-in-the-loop or\n   * generative UI for a backend/MCP tool). Defaults to `\"inline\"`.\n   */\n  display?: \"standalone\" | \"inline\";\n};\n\n/**\n * Registers a tool-call renderer while the component is mounted.\n *\n * This only affects rendering. Pair it with {@link Tools} or a backend tool\n * registry to expose the actual tool definition to the model.\n *\n * @param tool - Tool renderer registration, or `null` to skip registration.\n *\n * @deprecated Put `render`/`renderText` on the matching toolkit entry, or use\n * `MessagePrimitive.Parts` inline tool render overrides for per-message UI.\n * See https://assistant-ui.com/docs/migrations/toolkit-tools.\n */\nexport const useAssistantToolUI = (\n  tool: AssistantToolUIProps<any, any> | null,\n) => {\n  const aui = useAui();\n  const standalone = tool?.display === \"standalone\";\n  useEffect(() => {\n    if (!tool?.toolName || !tool?.render) return undefined;\n    return aui.tools.setToolUI(tool.toolName, tool.render, { standalone });\n  }, [aui, tool?.toolName, tool?.render, standalone]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAoCA,MAAaS,sBAAqBC,SAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAGhC,MAAAC,MAAYZ,OAAO;CACnB,MAAAa,aAAmBJ,MAAIF,YAAc;CAAa,IAAAO;CAAA,IAAAJ,EAAA,OAAAE,OAAAF,EAAA,OAAAG,cAAAH,EAAA,OAAAD,MAAA;EACxCK,WAAA;GACR,IAAI,CAACL,MAAIN,YAAL,CAAoBM,MAAIL,QAAQ;GAAmB,OAChDQ,IAAGG,MAAMC,UAAWP,KAAIN,UAAWM,KAAIL,QAAS,EAAAS,WAAa,CAAC;EAAC;EACvEH,EAAA,KAAAE;EAAAF,EAAA,KAAAG;EAAAH,EAAA,KAAAD;EAAAC,EAAA,KAAAI;CAAA,OAAAA,KAAAJ,EAAA;CAAQ,MAAAO,KAAAR,MAAIN;CAAY,MAAAe,KAAAT,MAAIL;CAAQ,IAAAe;CAAA,IAAAT,EAAA,OAAAE,OAAAF,EAAA,OAAAG,cAAAH,EAAA,OAAAO,MAAAP,EAAA,OAAAQ,IAAA;EAAlCC,KAAA;GAACP;GAAKK;GAAgBC;GAAcL;EAAU;EAACH,EAAA,KAAAE;EAAAF,EAAA,KAAAG;EAAAH,EAAA,KAAAO;EAAAP,EAAA,KAAAQ;EAAAR,EAAA,KAAAS;CAAA,OAAAA,KAAAT,EAAA;CAHlDX,UAAUe,IAGPK,EAA+C;AAAC"}

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

@@ -19,7 +19,7 @@ function useAuiToolOverrides(overrides) {
 	const overridesRef = useRef(overrides);
 	overridesRef.current = overrides;
 	useEffect(() => {
-		return aui.modelContext().register({ getModelContext: () => ({
+		return aui.modelContext.register({ getModelContext: () => ({
 			priority: 1e3,
 			tools: overridesRef.current
 		}) });