@assistant-ui/core 0.2.18 → 0.2.20

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

@@ -0,0 +1,264 @@
+import { ModelContext } from "../../store/clients/model-context-client.js";
+import { buildInteractableModelContext } from "./interactable-model-context.js";
+import { toJSONSchema, toPartialJSONSchema } from "assistant-stream";
+import { attachTransformScopes, useAssistantClientRef } from "@assistant-ui/store";
+import { useCallback, useEffect, useMemo, useRef, useState } from "@assistant-ui/tap/react-shim";
+import { resource } from "@assistant-ui/tap";
+//#region src/react/interactables-legacy/Interactables.ts
+const PERSISTENCE_DEBOUNCE_MS = 500;
+const useInteractables = () => {
+	const [state, setState] = useState(() => ({
+		definitions: {},
+		persistence: {}
+	}));
+	const clientRef = useAssistantClientRef();
+	const stateRef = useRef(state);
+	useEffect(() => {
+		stateRef.current = state;
+	}, [state]);
+	const subscribersRef = useRef(/* @__PURE__ */ new Set());
+	const partialSchemaCacheRef = useRef(/* @__PURE__ */ new Map());
+	const detachedStateRef = useRef(/* @__PURE__ */ new Map());
+	const adapterRef = useRef(void 0);
+	const debounceTimerRef = useRef(void 0);
+	const syncSeqRef = useRef(0);
+	const hasPendingLocalChangeRef = useRef(false);
+	const flushResolversRef = useRef([]);
+	const dirtyIdsRef = useRef(/* @__PURE__ */ new Set());
+	const runPersistence = useCallback(async () => {
+		const adapter = adapterRef.current;
+		if (!adapter) {
+			for (const resolve of flushResolversRef.current) resolve();
+			flushResolversRef.current = [];
+			return;
+		}
+		const seq = ++syncSeqRef.current;
+		const dirtyIds = new Set(dirtyIdsRef.current);
+		dirtyIdsRef.current.clear();
+		hasPendingLocalChangeRef.current = true;
+		const exported = stateRef.current.definitions;
+		const payload = {};
+		for (const [id, def] of Object.entries(exported)) payload[id] = {
+			name: def.name,
+			state: def.state
+		};
+		setState((prev) => ({
+			...prev,
+			persistence: {
+				...prev.persistence,
+				...Object.fromEntries([...dirtyIds].map((id_0) => [id_0, {
+					isPending: true,
+					error: void 0
+				}]))
+			}
+		}));
+		try {
+			await adapter.save(payload);
+			if (syncSeqRef.current === seq) {
+				hasPendingLocalChangeRef.current = false;
+				setState((prev_1) => {
+					const persistence = { ...prev_1.persistence };
+					for (const id_2 of dirtyIds) delete persistence[id_2];
+					return {
+						...prev_1,
+						persistence
+					};
+				});
+			}
+		} catch (e) {
+			if (syncSeqRef.current === seq) {
+				hasPendingLocalChangeRef.current = false;
+				setState((prev_0) => ({
+					...prev_0,
+					persistence: {
+						...prev_0.persistence,
+						...Object.fromEntries([...dirtyIds].map((id_1) => [id_1, {
+							isPending: false,
+							error: e
+						}]))
+					}
+				}));
+			}
+		} finally {
+			if (dirtyIdsRef.current.size > 0 && adapterRef.current) runPersistence();
+			else {
+				for (const resolve of flushResolversRef.current) resolve();
+				flushResolversRef.current = [];
+			}
+		}
+	}, []);
+	const schedulePersistence = useCallback((id_3) => {
+		if (!adapterRef.current) return;
+		dirtyIdsRef.current.add(id_3);
+		if (debounceTimerRef.current !== void 0) clearTimeout(debounceTimerRef.current);
+		debounceTimerRef.current = setTimeout(() => {
+			debounceTimerRef.current = void 0;
+			if (!hasPendingLocalChangeRef.current) runPersistence();
+			else debounceTimerRef.current = setTimeout(() => {
+				debounceTimerRef.current = void 0;
+				runPersistence();
+			}, PERSISTENCE_DEBOUNCE_MS);
+		}, PERSISTENCE_DEBOUNCE_MS);
+	}, [runPersistence]);
+	const exportState = useCallback(() => {
+		const result = {};
+		for (const [id_4, def_0] of Object.entries(stateRef.current.definitions)) result[id_4] = {
+			name: def_0.name,
+			state: def_0.state
+		};
+		return result;
+	}, []);
+	const importState = useCallback((saved) => {
+		for (const [id_5, entry] of Object.entries(saved)) detachedStateRef.current.set(id_5, entry.state);
+		setState((prev_2) => {
+			let changed = false;
+			const definitions = { ...prev_2.definitions };
+			for (const [id_6, entry_0] of Object.entries(saved)) if (definitions[id_6]) {
+				definitions[id_6] = {
+					...definitions[id_6],
+					state: entry_0.state
+				};
+				changed = true;
+			}
+			return changed ? {
+				...prev_2,
+				definitions
+			} : prev_2;
+		});
+	}, []);
+	const setPersistenceAdapter = useCallback((adapter_0) => {
+		adapterRef.current = adapter_0;
+	}, []);
+	const flush = useCallback(async () => {
+		if (debounceTimerRef.current !== void 0) {
+			clearTimeout(debounceTimerRef.current);
+			debounceTimerRef.current = void 0;
+		}
+		if (!adapterRef.current) return;
+		if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0) return;
+		const p = new Promise((resolve_0) => {
+			flushResolversRef.current.push(resolve_0);
+		});
+		if (!hasPendingLocalChangeRef.current) runPersistence();
+		return p;
+	}, [runPersistence]);
+	const flushIfPending = useCallback(() => {
+		if (adapterRef.current && debounceTimerRef.current !== void 0) {
+			clearTimeout(debounceTimerRef.current);
+			debounceTimerRef.current = void 0;
+			runPersistence();
+		}
+	}, [runPersistence]);
+	const setDefState = useCallback((id_7, updater) => {
+		setState((prev_3) => {
+			const existing = prev_3.definitions[id_7];
+			if (!existing) return prev_3;
+			return {
+				...prev_3,
+				definitions: {
+					...prev_3.definitions,
+					[id_7]: {
+						...existing,
+						state: updater(existing.state)
+					}
+				}
+			};
+		});
+		if (stateRef.current.definitions[id_7]) schedulePersistence(id_7);
+	}, [schedulePersistence]);
+	const setDefSelected = useCallback((id_8, selected) => {
+		setState((prev_4) => {
+			const existing_0 = prev_4.definitions[id_8];
+			if (!existing_0) return prev_4;
+			return {
+				...prev_4,
+				definitions: {
+					...prev_4.definitions,
+					[id_8]: {
+						...existing_0,
+						selected
+					}
+				}
+			};
+		});
+	}, []);
+	const provider = useMemo(() => ({
+		getModelContext: () => {
+			const defs = stateRef.current.definitions;
+			return buildInteractableModelContext(defs, partialSchemaCacheRef.current, setDefState) ?? {};
+		},
+		subscribe: (callback) => {
+			subscribersRef.current.add(callback);
+			return () => {
+				subscribersRef.current.delete(callback);
+			};
+		}
+	}), [setDefState]);
+	useEffect(() => {
+		for (const cb of subscribersRef.current) cb();
+	}, [state]);
+	useEffect(() => {
+		return clientRef.current.modelContext().register(provider);
+	}, [clientRef, provider]);
+	return {
+		getState: () => state,
+		register: useCallback((def_1) => {
+			try {
+				const jsonSchema = toJSONSchema(def_1.stateSchema);
+				partialSchemaCacheRef.current.set(def_1.id, toPartialJSONSchema(jsonSchema));
+			} catch (e_0) {
+				console.warn(`[Interactables] Failed to create partial schema for "${def_1.name}". The update tool will require all fields.`, e_0);
+			}
+			const detached = detachedStateRef.current.get(def_1.id);
+			detachedStateRef.current.delete(def_1.id);
+			setState((prev_5) => ({
+				...prev_5,
+				definitions: {
+					...prev_5.definitions,
+					[def_1.id]: {
+						id: def_1.id,
+						name: def_1.name,
+						description: def_1.description,
+						stateSchema: def_1.stateSchema,
+						state: prev_5.definitions[def_1.id]?.state ?? detached ?? def_1.initialState,
+						selected: def_1.selected
+					}
+				}
+			}));
+			return () => {
+				flushIfPending();
+				setState((prev_6) => {
+					const existing_1 = prev_6.definitions[def_1.id];
+					if (existing_1) detachedStateRef.current.set(def_1.id, existing_1.state);
+					partialSchemaCacheRef.current.delete(def_1.id);
+					const { [def_1.id]: _, ...rest } = prev_6.definitions;
+					const { [def_1.id]: __, ...restPersistence } = prev_6.persistence;
+					return {
+						...prev_6,
+						definitions: rest,
+						persistence: restPersistence
+					};
+				});
+			};
+		}, [flushIfPending]),
+		setState: setDefState,
+		setSelected: setDefSelected,
+		exportState,
+		importState,
+		setPersistenceAdapter,
+		flush
+	};
+};
+/**
+* @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+* Scheduled for removal on/after 2026-09-14. See
+* {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+*/
+const Interactables = resource(useInteractables);
+attachTransformScopes(useInteractables, (scopes, parent) => {
+	if (!scopes.modelContext && parent.modelContext.source === null) scopes.modelContext = ModelContext();
+});
+//#endregion
+export { Interactables };
+
+//# sourceMappingURL=Interactables.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Interactables.js","names":["useState","useEffect","useCallback","useRef","useMemo","resource","useAssistantClientRef","ClientOutput","attachTransformScopes","InteractablesState","InteractableRegistration","InteractableStateSchema","InteractablePersistedState","InteractablePersistenceAdapter","toJSONSchema","toPartialJSONSchema","ModelContext","buildInteractableModelContext","PERSISTENCE_DEBOUNCE_MS","useInteractables","state","setState","definitions","persistence","clientRef","stateRef","current","subscribersRef","Set","partialSchemaCacheRef","Map","detachedStateRef","adapterRef","undefined","debounceTimerRef","ReturnType","setTimeout","syncSeqRef","hasPendingLocalChangeRef","flushResolversRef","Array","dirtyIdsRef","runPersistence","adapter","resolve","seq","dirtyIds","clear","exported","payload","id","def","Object","entries","name","prev","fromEntries","map","isPending","error","save","e","size","schedulePersistence","add","clearTimeout","exportState","result","importState","saved","entry","set","changed","setPersistenceAdapter","flush","p","Promise","push","flushIfPending","setDefState","updater","existing","setDefSelected","selected","provider","getModelContext","defs","subscribe","callback","delete","cb","modelContext","register","jsonSchema","stateSchema","console","warn","detached","get","description","initialState","_","rest","__","restPersistence","getState","setSelected","Interactables","scopes","parent","source"],"sources":["../../../src/react/interactables-legacy/Interactables.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef, useMemo } from \"react\";\nimport { resource } from \"@assistant-ui/tap\";\nimport {\n  useAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type {\n  InteractablesState,\n  InteractableRegistration,\n  InteractableStateSchema,\n  InteractablePersistedState,\n  InteractablePersistenceAdapter,\n} from \"./scopes\";\nimport { toJSONSchema, toPartialJSONSchema } from \"assistant-stream\";\nimport { ModelContext } from \"../../store\";\nimport { buildInteractableModelContext } from \"./interactable-model-context\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\nconst useInteractables = (): ClientOutput<\"interactables\"> => {\n  const [state, setState] = useState<InteractablesState>(() => ({\n    definitions: {},\n    persistence: {},\n  }));\n\n  const clientRef = useAssistantClientRef();\n\n  const stateRef = useRef(state);\n  useEffect(() => {\n    stateRef.current = state;\n  }, [state]);\n\n  const subscribersRef = useRef(new Set<() => void>());\n  const partialSchemaCacheRef = useRef(\n    new Map<string, InteractableStateSchema>(),\n  );\n  const detachedStateRef = useRef(new Map<string, unknown>());\n\n  const adapterRef = useRef<InteractablePersistenceAdapter | undefined>(\n    undefined,\n  );\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = useRef(0);\n  const hasPendingLocalChangeRef = useRef(false);\n  const flushResolversRef = useRef<Array<() => void>>([]);\n  const dirtyIdsRef = useRef(new Set<string>());\n\n  const runPersistence = useCallback(async () => {\n    const adapter = adapterRef.current;\n    if (!adapter) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n      return;\n    }\n\n    const seq = ++syncSeqRef.current;\n    const dirtyIds = new Set(dirtyIdsRef.current);\n    dirtyIdsRef.current.clear();\n    hasPendingLocalChangeRef.current = true;\n\n    // Snapshot before any await so unregistered definitions are still included.\n    const exported = stateRef.current.definitions;\n    const payload: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(exported)) {\n      payload[id] = { name: def.name, state: def.state };\n    }\n\n    setState((prev) => ({\n      ...prev,\n      persistence: {\n        ...prev.persistence,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      },\n    }));\n\n    try {\n      await adapter.save(payload);\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => {\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) delete persistence[id];\n          return { ...prev, persistence };\n        });\n      }\n    } catch (e) {\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => ({\n          ...prev,\n          persistence: {\n            ...prev.persistence,\n            ...Object.fromEntries(\n              [...dirtyIds].map((id) => [id, { isPending: false, error: e }]),\n            ),\n          },\n        }));\n      }\n    } finally {\n      if (dirtyIdsRef.current.size > 0 && adapterRef.current) {\n        runPersistence();\n      } else {\n        for (const resolve of flushResolversRef.current) resolve();\n        flushResolversRef.current = [];\n      }\n    }\n  }, []);\n\n  const schedulePersistence = useCallback(\n    (id: string) => {\n      if (!adapterRef.current) return;\n      dirtyIdsRef.current.add(id);\n      if (debounceTimerRef.current !== undefined) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = undefined;\n        if (!hasPendingLocalChangeRef.current) {\n          runPersistence();\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            runPersistence();\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [runPersistence],\n  );\n\n  const exportState = useCallback((): InteractablePersistedState => {\n    const result: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(stateRef.current.definitions)) {\n      result[id] = { name: def.name, state: def.state };\n    }\n    return result;\n  }, []);\n\n  const importState = useCallback((saved: InteractablePersistedState) => {\n    for (const [id, entry] of Object.entries(saved)) {\n      detachedStateRef.current.set(id, entry.state);\n    }\n    setState((prev) => {\n      let changed = false;\n      const definitions = { ...prev.definitions };\n      for (const [id, entry] of Object.entries(saved)) {\n        if (definitions[id]) {\n          definitions[id] = { ...definitions[id], state: entry.state };\n          changed = true;\n        }\n      }\n      return changed ? { ...prev, definitions } : prev;\n    });\n  }, []);\n\n  const setPersistenceAdapter = useCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      adapterRef.current = adapter;\n    },\n    [],\n  );\n\n  const flush = useCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (!adapterRef.current) return;\n    if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0)\n      return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (!hasPendingLocalChangeRef.current) {\n      runPersistence();\n    }\n    return p;\n  }, [runPersistence]);\n\n  const flushIfPending = useCallback(() => {\n    if (adapterRef.current && debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n      runPersistence();\n    }\n  }, [runPersistence]);\n\n  const setDefState = useCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setState((prev) => {\n        const existing = prev.definitions[id];\n        if (!existing) return prev;\n        return {\n          ...prev,\n          definitions: {\n            ...prev.definitions,\n            [id]: { ...existing, state: updater(existing.state) },\n          },\n        };\n      });\n      if (stateRef.current.definitions[id]) schedulePersistence(id);\n    },\n    [schedulePersistence],\n  );\n\n  const setDefSelected = useCallback((id: string, selected: boolean) => {\n    setState((prev) => {\n      const existing = prev.definitions[id];\n      if (!existing) return prev;\n      return {\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [id]: { ...existing, selected },\n        },\n      };\n    });\n  }, []);\n\n  const provider = useMemo(\n    () => ({\n      getModelContext: () => {\n        const defs = stateRef.current.definitions;\n        return (\n          buildInteractableModelContext(\n            defs,\n            partialSchemaCacheRef.current,\n            setDefState,\n          ) ?? {}\n        );\n      },\n      subscribe: (callback: () => void) => {\n        subscribersRef.current.add(callback);\n        return () => {\n          subscribersRef.current.delete(callback);\n        };\n      },\n    }),\n    [setDefState],\n  );\n\n  useEffect(() => {\n    for (const cb of subscribersRef.current) cb();\n  }, [state]);\n\n  useEffect(() => {\n    return clientRef.current!.modelContext().register(provider);\n  }, [clientRef, provider]);\n\n  const register = useCallback(\n    (def: InteractableRegistration) => {\n      try {\n        const jsonSchema = toJSONSchema(def.stateSchema);\n        partialSchemaCacheRef.current.set(\n          def.id,\n          toPartialJSONSchema(jsonSchema),\n        );\n      } catch (e) {\n        console.warn(\n          `[Interactables] Failed to create partial schema for \"${def.name}\". The update tool will require all fields.`,\n          e,\n        );\n      }\n\n      const detached = detachedStateRef.current.get(def.id);\n      detachedStateRef.current.delete(def.id);\n\n      setState((prev) => ({\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [def.id]: {\n            id: def.id,\n            name: def.name,\n            description: def.description,\n            stateSchema: def.stateSchema,\n            state:\n              prev.definitions[def.id]?.state ?? detached ?? def.initialState,\n            selected: def.selected,\n          },\n        },\n      }));\n\n      return () => {\n        flushIfPending();\n        setState((prev) => {\n          const existing = prev.definitions[def.id];\n          if (existing) {\n            detachedStateRef.current.set(def.id, existing.state);\n          }\n          partialSchemaCacheRef.current.delete(def.id);\n          const { [def.id]: _, ...rest } = prev.definitions;\n          const { [def.id]: __, ...restPersistence } = prev.persistence;\n          return { ...prev, definitions: rest, persistence: restPersistence };\n        });\n      };\n    },\n    [flushIfPending],\n  );\n\n  return {\n    getState: () => state,\n    register,\n    setState: setDefState,\n    setSelected: setDefSelected,\n    exportState,\n    importState,\n    setPersistenceAdapter,\n    flush,\n  };\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 */\nexport const Interactables = resource(useInteractables);\n\nattachTransformScopes(useInteractables, (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/interactables-legacy/interactable-model-context.d.ts

@@ -0,0 +1,12 @@
+import { InteractableDefinition, InteractableStateSchema } from "./scopes.js";
+import { Tool } from "assistant-stream";
+
+//#region src/react/interactables-legacy/interactable-model-context.d.ts
+declare function shallowMerge(prev: unknown, partial: unknown): unknown;
+declare function buildInteractableModelContext(definitions: Record<string, InteractableDefinition>, partialSchemaCache: Map<string, InteractableStateSchema>, setDefState: (id: string, updater: (prev: unknown) => unknown) => void): {
+  system: string;
+  tools: Record<string, Tool<any, any>>;
+} | undefined;
+//#endregion
+export { buildInteractableModelContext, shallowMerge };
+//# sourceMappingURL=interactable-model-context.d.ts.map

package/dist/react/interactables-legacy/interactable-model-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactable-model-context.d.ts","names":[],"sources":["../../../src/react/interactables-legacy/interactable-model-context.ts"],"mappings":";;;;iBAGgB,YAAA,CAAa,IAAA,WAAe,OAAgB;AAAA,iBAiB5C,6BAAA,CACd,WAAA,EAAa,MAAA,SAAe,sBAAA,GAC5B,kBAAA,EAAoB,GAAA,SAAY,uBAAA,GAChC,WAAA,GAAc,EAAA,UAAY,OAAA,GAAU,IAAA;EACjC,MAAA;EAAgB,KAAA,EAAO,MAAA,SAAe,IAAA;AAAA"}

package/dist/react/interactables-legacy/interactable-model-context.js

@@ -0,0 +1,54 @@
+//#region src/react/interactables-legacy/interactable-model-context.ts
+function shallowMerge(prev, partial) {
+	if (typeof prev !== "object" || prev === null || typeof partial !== "object" || partial === null || Array.isArray(prev) || Array.isArray(partial)) return partial;
+	return {
+		...prev,
+		...partial
+	};
+}
+function buildInteractableModelContext(definitions, partialSchemaCache, setDefState) {
+	const entries = Object.values(definitions);
+	if (entries.length === 0) return void 0;
+	const byName = /* @__PURE__ */ new Map();
+	for (const def of entries) {
+		const list = byName.get(def.name) ?? [];
+		list.push(def);
+		byName.set(def.name, list);
+	}
+	const systemParts = [];
+	const tools = {};
+	for (const [name, instances] of byName) {
+		const isMulti = instances.length > 1;
+		for (const def of instances) {
+			const selectedTag = def.selected ? " (SELECTED)" : "";
+			const idTag = isMulti ? ` [id="${def.id}"]` : "";
+			systemParts.push(`Interactable component "${name}"${idTag}${selectedTag} (${def.description}). Current state: ${JSON.stringify(def.state)}`);
+			const safeName = name.replace(/[^a-zA-Z0-9_-]/g, "_");
+			const safeId = def.id.replace(/[^a-zA-Z0-9_-]/g, "_");
+			const toolName = isMulti ? `update_${safeName}_${safeId}` : `update_${safeName}`;
+			const partialSchema = partialSchemaCache.get(def.id) ?? def.stateSchema;
+			tools[toolName] = {
+				type: "frontend",
+				description: `Update the state of interactable component "${name}"${isMulti ? ` (id: ${def.id})` : ""}. Only include the fields you want to change; omitted fields keep their current values. ${def.description}`,
+				parameters: partialSchema,
+				streamCall: async (reader) => {
+					try {
+						for await (const partialArgs of reader.args.streamValues()) setDefState(def.id, (prev) => shallowMerge(prev, partialArgs));
+					} catch {}
+				},
+				execute: async (partialState) => {
+					setDefState(def.id, (prev) => shallowMerge(prev, partialState));
+					return { success: true };
+				}
+			};
+		}
+	}
+	return {
+		system: systemParts.join("\n"),
+		tools
+	};
+}
+//#endregion
+export { buildInteractableModelContext, shallowMerge };
+
+//# sourceMappingURL=interactable-model-context.js.map

package/dist/react/interactables-legacy/interactable-model-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactable-model-context.js","names":["Tool","InteractableDefinition","InteractableStateSchema","shallowMerge","prev","partial","Array","isArray","Record","buildInteractableModelContext","definitions","partialSchemaCache","Map","setDefState","id","updater","system","tools","entries","Object","values","length","undefined","byName","def","list","get","name","push","set","systemParts","instances","isMulti","selectedTag","selected","idTag","description","JSON","stringify","state","safeName","replace","safeId","toolName","partialSchema","stateSchema","type","const","parameters","streamCall","reader","partialArgs","args","streamValues","execute","partialState","success","join"],"sources":["../../../src/react/interactables-legacy/interactable-model-context.ts"],"sourcesContent":["import type { Tool } from \"assistant-stream\";\nimport type { InteractableDefinition, InteractableStateSchema } from \"./scopes\";\n\nexport function shallowMerge(prev: unknown, partial: unknown): unknown {\n  if (\n    typeof prev !== \"object\" ||\n    prev === null ||\n    typeof partial !== \"object\" ||\n    partial === null ||\n    Array.isArray(prev) ||\n    Array.isArray(partial)\n  ) {\n    return partial;\n  }\n  return {\n    ...(prev as Record<string, unknown>),\n    ...(partial as Record<string, unknown>),\n  };\n}\n\nexport function buildInteractableModelContext(\n  definitions: Record<string, InteractableDefinition>,\n  partialSchemaCache: Map<string, InteractableStateSchema>,\n  setDefState: (id: string, updater: (prev: unknown) => unknown) => void,\n): { system: string; tools: Record<string, Tool<any, any>> } | undefined {\n  const entries = Object.values(definitions);\n  if (entries.length === 0) return undefined;\n\n  const byName = new Map<string, 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 systemParts: string[] = [];\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const [name, instances] of byName) {\n    const isMulti = instances.length > 1;\n\n    for (const def of instances) {\n      const selectedTag = def.selected ? \" (SELECTED)\" : \"\";\n      const idTag = isMulti ? ` [id=\"${def.id}\"]` : \"\";\n\n      systemParts.push(\n        `Interactable component \"${name}\"${idTag}${selectedTag} (${def.description}). Current state: ${JSON.stringify(def.state)}`,\n      );\n\n      const safeName = name.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n      const safeId = def.id.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n      const toolName = isMulti\n        ? `update_${safeName}_${safeId}`\n        : `update_${safeName}`;\n\n      const partialSchema = partialSchemaCache.get(def.id) ?? def.stateSchema;\n\n      tools[toolName] = {\n        type: \"frontend\" as const,\n        description: `Update the state of interactable component \"${name}\"${isMulti ? ` (id: ${def.id})` : \"\"}. Only include the fields you want to change; omitted fields keep their current values. ${def.description}`,\n        parameters: partialSchema,\n        streamCall: async (reader) => {\n          try {\n            for await (const partialArgs of reader.args.streamValues()) {\n              setDefState(def.id, (prev) => shallowMerge(prev, partialArgs));\n            }\n          } catch {\n            // Non-fatal: execute handles the final state\n          }\n        },\n        execute: async (partialState: unknown) => {\n          setDefState(def.id, (prev) => shallowMerge(prev, partialState));\n          return { success: true };\n        },\n      };\n    }\n  }\n\n  return { system: systemParts.join(\"\\n\"), tools };\n}\n"],"mappings":";AAGA,SAAgBG,aAAaC,MAAeC,SAA2B;CACrE,IACE,OAAOD,SAAS,YAChBA,SAAS,QACT,OAAOC,YAAY,YACnBA,YAAY,QACZC,MAAMC,QAAQH,IAAI,KAClBE,MAAMC,QAAQF,OAAO,GAErB,OAAOA;CAET,OAAO;EACL,GAAID;EACJ,GAAIC;CACN;AACF;AAEA,SAAgBI,8BACdC,aACAC,oBACAE,aACuE;CACvE,MAAMK,UAAUC,OAAOC,OAAOV,WAAW;CACzC,IAAIQ,QAAQG,WAAW,GAAG,OAAOC,KAAAA;CAEjC,MAAMC,yBAAS,IAAIX,IAAsC;CACzD,KAAK,MAAMY,OAAON,SAAS;EACzB,MAAMO,OAAOF,OAAOG,IAAIF,IAAIG,IAAI,KAAK,CAAA;EACrCF,KAAKG,KAAKJ,GAAG;EACbD,OAAOM,IAAIL,IAAIG,MAAMF,IAAI;CAC3B;CAEA,MAAMK,cAAwB,CAAA;CAC9B,MAAMb,QAAwC,CAAC;CAE/C,KAAK,MAAM,CAACU,MAAMI,cAAcR,QAAQ;EACtC,MAAMS,UAAUD,UAAUV,SAAS;EAEnC,KAAK,MAAMG,OAAOO,WAAW;GAC3B,MAAME,cAAcT,IAAIU,WAAW,gBAAgB;GACnD,MAAMC,QAAQH,UAAU,SAASR,IAAIV,GAAE,MAAO;GAE9CgB,YAAYF,KACV,2BAA2BD,KAAI,GAAIQ,QAAQF,YAAW,IAAKT,IAAIY,YAAW,oBAAqBC,KAAKC,UAAUd,IAAIe,KAAK,GACzH;GAEA,MAAMC,WAAWb,KAAKc,QAAQ,mBAAmB,GAAG;GACpD,MAAMC,SAASlB,IAAIV,GAAG2B,QAAQ,mBAAmB,GAAG;GACpD,MAAME,WAAWX,UACb,UAAUQ,SAAQ,GAAIE,WACtB,UAAUF;GAEd,MAAMI,gBAAgBjC,mBAAmBe,IAAIF,IAAIV,EAAE,KAAKU,IAAIqB;GAE5D5B,MAAM0B,YAAY;IAChBG,MAAM;IACNV,aAAa,+CAA+CT,KAAI,GAAIK,UAAU,SAASR,IAAIV,GAAE,KAAM,GAAE,0FAA2FU,IAAIY;IACpMY,YAAYJ;IACZK,YAAY,OAAOC,WAAW;KAC5B,IAAI;MACF,WAAW,MAAMC,eAAeD,OAAOE,KAAKC,aAAa,GACvDxC,YAAYW,IAAIV,KAAKV,SAASD,aAAaC,MAAM+C,WAAW,CAAC;KAEjE,QAAQ,CACN;IAEJ;IACAG,SAAS,OAAOC,iBAA0B;KACxC1C,YAAYW,IAAIV,KAAKV,SAASD,aAAaC,MAAMmD,YAAY,CAAC;KAC9D,OAAO,EAAEC,SAAS,KAAK;IACzB;GACF;EACF;CACF;CAEA,OAAO;EAAExC,QAAQc,YAAY2B,KAAK,IAAI;EAAGxC;CAAM;AACjD"}

package/dist/react/interactables-legacy/scopes.d.ts

@@ -0,0 +1,58 @@
+import { Unsubscribe } from "../../types/unsubscribe.js";
+import { Tool } from "assistant-stream";
+
+//#region src/react/interactables-legacy/scopes.d.ts
+/**
+ * Schema type matching Tool["parameters"] from assistant-stream.
+ * Accepts both StandardSchemaV1 and JSONSchema7.
+ */
+type InteractableStateSchema = NonNullable<Extract<Tool, {
+  parameters: unknown;
+}>["parameters"]>;
+type InteractableDefinition = {
+  id: string;
+  name: string;
+  description: string;
+  stateSchema: InteractableStateSchema;
+  state: unknown;
+  selected?: boolean | undefined;
+};
+type InteractableRegistration = {
+  id: string;
+  name: string;
+  description: string;
+  stateSchema: InteractableStateSchema;
+  initialState: unknown;
+  selected?: boolean | undefined;
+};
+type InteractablePersistenceStatus = {
+  isPending: boolean;
+  error: unknown;
+};
+type InteractablesState = {
+  /** Keyed by instance id */definitions: Record<string, InteractableDefinition>; /** Per-id persistence sync status */
+  persistence: Record<string, InteractablePersistenceStatus>;
+};
+type InteractablePersistedState = Record<string, {
+  name: string;
+  state: unknown;
+}>;
+type InteractablePersistenceAdapter = {
+  save(state: InteractablePersistedState): void | Promise<void>;
+};
+type InteractablesMethods = {
+  getState(): InteractablesState;
+  register(def: InteractableRegistration): Unsubscribe;
+  setState(id: string, updater: (prev: unknown) => unknown): void;
+  setSelected(id: string, selected: boolean): void;
+  exportState(): InteractablePersistedState;
+  importState(saved: InteractablePersistedState): void;
+  setPersistenceAdapter(adapter: InteractablePersistenceAdapter | undefined): void;
+  flush(): Promise<void>;
+};
+type InteractablesClientSchema = {
+  methods: InteractablesMethods;
+};
+//#endregion
+export { InteractableDefinition, InteractablePersistedState, InteractablePersistenceAdapter, InteractablePersistenceStatus, InteractableRegistration, InteractableStateSchema, InteractablesClientSchema, InteractablesMethods, InteractablesState };
+//# sourceMappingURL=scopes.d.ts.map

package/dist/react/interactables-legacy/scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.d.ts","names":[],"sources":["../../../src/react/interactables-legacy/scopes.ts"],"mappings":";;;;;;;AAOA;KAAY,uBAAA,GAA0B,WAAA,CACpC,OAAA,CAAQ,IAAA;EAAQ,UAAA;AAAA;AAAA,KAGN,sBAAA;EACV,EAAA;EACA,IAAA;EACA,WAAA;EACA,WAAA,EAAa,uBAAuB;EACpC,KAAA;EACA,QAAA;AAAA;AAAA,KAGU,wBAAA;EACV,EAAA;EACA,IAAA;EACA,WAAA;EACA,WAAA,EAAa,uBAAuB;EACpC,YAAA;EACA,QAAA;AAAA;AAAA,KAGU,6BAAA;EACV,SAAA;EACA,KAAK;AAAA;AAAA,KAGK,kBAAA;EAjBF,2BAmBR,WAAA,EAAa,MAAA,SAAe,sBAAA,GAhBlB;EAkBV,WAAA,EAAa,MAAA,SAAe,6BAAA;AAAA;AAAA,KAGlB,0BAAA,GAA6B,MAAM;EAE3C,IAAA;EAAc,KAAA;AAAA;AAAA,KAGN,8BAAA;EACV,IAAA,CAAK,KAAA,EAAO,0BAAA,UAAoC,OAAO;AAAA;AAAA,KAG7C,oBAAA;EACV,QAAA,IAAY,kBAAA;EACZ,QAAA,CAAS,GAAA,EAAK,wBAAA,GAA2B,WAAA;EACzC,QAAA,CAAS,EAAA,UAAY,OAAA,GAAU,IAAA;EAC/B,WAAA,CAAY,EAAA,UAAY,QAAA;EACxB,WAAA,IAAe,0BAAA;EACf,WAAA,CAAY,KAAA,EAAO,0BAAA;EACnB,qBAAA,CACE,OAAA,EAAS,8BAAA;EAEX,KAAA,IAAS,OAAA;AAAA;AAAA,KAGC,yBAAA;EACV,OAAA,EAAS,oBAAoB;AAAA"}

package/dist/react/interactables-legacy/useAssistantInteractable.d.ts

@@ -0,0 +1,31 @@
+import { InteractableStateSchema } from "./scopes.js";
+
+//#region src/react/interactables-legacy/useAssistantInteractable.d.ts
+/**
+ * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+ * Scheduled for removal on/after 2026-09-14. See
+ * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+ */
+type AssistantInteractableProps = {
+  description: string;
+  stateSchema: InteractableStateSchema;
+  initialState: unknown;
+  id?: string;
+  selected?: boolean;
+};
+/**
+ * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+ * Scheduled for removal on/after 2026-09-14. See
+ * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+ *
+ * Registers an interactable with the AI assistant.
+ *
+ * This hook handles registration only. To read and write the interactable's
+ * state, use {@link useInteractableState} with the returned id.
+ *
+ * @returns The interactable instance id.
+ */
+declare const useAssistantInteractable: (name: string, config: AssistantInteractableProps) => string;
+//#endregion
+export { AssistantInteractableProps, useAssistantInteractable };
+//# sourceMappingURL=useAssistantInteractable.d.ts.map

package/dist/react/interactables-legacy/useAssistantInteractable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAssistantInteractable.d.ts","names":[],"sources":["../../../src/react/interactables-legacy/useAssistantInteractable.ts"],"mappings":";;;;;AASA;;;KAAY,0BAAA;EACV,WAAA;EACA,WAAA,EAAa,uBAAuB;EACpC,YAAA;EACA,EAAA;EACA,QAAA;AAAA;;AAAQ;AAeV;;;;;;;;AAEoC;;cAFvB,wBAAA,GACX,IAAA,UACA,MAAA,EAAQ,0BAA0B"}

package/dist/react/{model-context → interactables-legacy}/useAssistantInteractable.js

@@ -1,7 +1,11 @@
-import { useEffect, useId, useRef } from "@assistant-ui/tap/react-shim";
 import { useAui } from "@assistant-ui/store";
-//#region src/react/model-context/useAssistantInteractable.ts
+import { useEffect, useId, useRef } from "@assistant-ui/tap/react-shim";
+//#region src/react/interactables-legacy/useAssistantInteractable.ts
 /**
+* @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+* Scheduled for removal on/after 2026-09-14. See
+* {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+*
 * Registers an interactable with the AI assistant.
 *
 * This hook handles registration only. To read and write the interactable's

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

@@ -0,0 +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"}

package/dist/react/interactables-legacy/useInteractableState.d.ts

@@ -0,0 +1,21 @@
+//#region src/react/interactables-legacy/useInteractableState.d.ts
+type StateUpdater<TState> = TState | ((prev: TState) => TState);
+/**
+ * Reads and writes the state of a registered interactable.
+ *
+ * Pair with {@link useAssistantInteractable} which handles registration.
+ *
+ * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+ * Scheduled for removal on/after 2026-09-14. See
+ * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+ */
+declare const useInteractableState: <TState>(id: string, fallback: TState) => [TState, {
+  setState: (updater: StateUpdater<TState>) => void;
+  setSelected: (selected: boolean) => void;
+  isPending: boolean;
+  error: unknown;
+  flush: () => Promise<void>;
+}];
+//#endregion
+export { useInteractableState };
+//# sourceMappingURL=useInteractableState.d.ts.map

package/dist/react/interactables-legacy/useInteractableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractableState.d.ts","names":[],"sources":["../../../src/react/interactables-legacy/useInteractableState.ts"],"mappings":";KAGK,YAAA,WAAuB,MAAA,KAAW,IAAA,EAAM,MAAA,KAAW,MAAA;;;;;;;;;;cAW3C,oBAAA,WACX,EAAA,UACA,QAAA,EAAU,MAAA,MAEV,MAAA;EAEE,QAAA,GAAW,OAAA,EAAS,YAAA,CAAa,MAAA;EACjC,WAAA,GAAc,QAAA;EACd,SAAA;EACA,KAAA;EACA,KAAA,QAAa,OAAA;AAAA"}

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

@@ -0,0 +1,84 @@
+import { useAui, useAuiState } from "@assistant-ui/store";
+import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
+//#region src/react/interactables-legacy/useInteractableState.ts
+/**
+* Reads and writes the state of a registered interactable.
+*
+* Pair with {@link useAssistantInteractable} which handles registration.
+*
+* @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+* Scheduled for removal on/after 2026-09-14. See
+* {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+*/
+const useInteractableState = (id, fallback) => {
+	const $ = c(19);
+	const aui = useAui();
+	const state = useAuiState((s) => s.interactables.definitions[id]?.state) ?? fallback;
+	let t0;
+	if ($[0] !== id) {
+		t0 = (s_0) => s_0.interactables.persistence[id];
+		$[0] = id;
+		$[1] = t0;
+	} else t0 = $[1];
+	const persistenceStatus = useAuiState(t0);
+	let t1;
+	if ($[2] !== aui || $[3] !== id) {
+		t1 = (updater) => {
+			aui.interactables().setState(id, (prev) => {
+				if (typeof updater === "function") return updater(prev);
+				return updater;
+			});
+		};
+		$[2] = aui;
+		$[3] = id;
+		$[4] = t1;
+	} else t1 = $[4];
+	const setState = t1;
+	let t2;
+	if ($[5] !== aui || $[6] !== id) {
+		t2 = (selected) => {
+			aui.interactables().setSelected(id, selected);
+		};
+		$[5] = aui;
+		$[6] = id;
+		$[7] = t2;
+	} else t2 = $[7];
+	const setSelected = t2;
+	let t3;
+	if ($[8] !== aui) {
+		t3 = () => aui.interactables().flush();
+		$[8] = aui;
+		$[9] = t3;
+	} else t3 = $[9];
+	const flush = t3;
+	const t4 = persistenceStatus?.isPending ?? false;
+	const t5 = persistenceStatus?.error;
+	let t6;
+	if ($[10] !== flush || $[11] !== setSelected || $[12] !== setState || $[13] !== t4 || $[14] !== t5) {
+		t6 = {
+			setState,
+			setSelected,
+			isPending: t4,
+			error: t5,
+			flush
+		};
+		$[10] = flush;
+		$[11] = setSelected;
+		$[12] = setState;
+		$[13] = t4;
+		$[14] = t5;
+		$[15] = t6;
+	} else t6 = $[15];
+	let t7;
+	if ($[16] !== state || $[17] !== t6) {
+		t7 = [state, t6];
+		$[16] = state;
+		$[17] = t6;
+		$[18] = t7;
+	} else t7 = $[18];
+	return t7;
+};
+//#endregion
+export { useInteractableState };
+
+//# sourceMappingURL=useInteractableState.js.map

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

@@ -0,0 +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"}