@assistant-ui/core 0.3.15 → 0.3.17

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

@@ -1,19 +1,19 @@
 import { notifySubscribers } from "../../subscribable/subscribable.js";
 import { ModelContext } from "../../store/clients/model-context-client.js";
 import { buildInteractableModelContext } from "./interactable-model-context.js";
+import { useInteractablePersistenceQueue } from "../interactables-shared/useInteractablePersistenceQueue.js";
+import { useAssistantScopeEffect } from "@assistant-ui/store/client";
 import { toJSONSchema, toPartialJSONSchema } from "assistant-stream";
 import { useCallback, useEffect, useMemo, useRef, useState } from "@assistant-ui/tap/react-shim";
-import { attachTransformScopes, useAssistantClientRef } from "@assistant-ui/store";
+import { attachTransformScopes as attachTransformScopes$1, useAssistantClientRef as useAssistantClientRef$1 } from "@assistant-ui/store";
 import { resource } from "@assistant-ui/tap";
-import { useAssistantScopeEffect } from "@assistant-ui/store/client";
 //#region src/react/interactables-legacy/Interactables.ts
-const PERSISTENCE_DEBOUNCE_MS = 500;
 const useInteractables = () => {
 	const [state, setState] = useState(() => ({
 		definitions: {},
 		persistence: {}
 	}));
-	const clientRef = useAssistantClientRef();
+	const clientRef = useAssistantClientRef$1();
 	const stateRef = useRef(state);
 	const setStateAndRef = useCallback((updater) => {
 		const next = updater(stateRef.current);
@@ -24,14 +24,6 @@ const useInteractables = () => {
 	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 latestSyncSeqByIdRef = useRef(/* @__PURE__ */ new Map());
-	const inFlightPersistenceRef = useRef(0);
-	const flushResolversRef = useRef([]);
-	const dirtyIdsRef = useRef(/* @__PURE__ */ new Set());
-	const outgoingQueueRef = useRef([]);
-	const runPersistenceRef = useRef(() => {});
 	const exportState = useCallback(() => {
 		const result = {};
 		for (const [id, def] of Object.entries(stateRef.current.definitions)) result[id] = {
@@ -40,178 +32,68 @@ const useInteractables = () => {
 		};
 		return result;
 	}, []);
-	const takeDirtyBatch = useCallback((adapter) => {
-		if (dirtyIdsRef.current.size === 0) return;
-		const dirtyIds = new Set(dirtyIdsRef.current);
-		dirtyIdsRef.current.clear();
-		const seq = ++syncSeqRef.current;
-		for (const id_0 of dirtyIds) latestSyncSeqByIdRef.current.set(id_0, seq);
-		return {
-			adapter,
-			payload: exportState(),
-			dirtyIds,
-			seq
-		};
-	}, [exportState]);
-	const enqueuePersistence = useCallback((adapter_0) => {
-		const batch = takeDirtyBatch(adapter_0);
-		if (!batch) return;
-		if (inFlightPersistenceRef.current === 0) runPersistenceRef.current(batch);
-		else outgoingQueueRef.current.push(batch);
-	}, [takeDirtyBatch]);
-	const runPersistence = useCallback(async (batch_0) => {
-		const resolved = batch_0 ?? (adapterRef.current ? takeDirtyBatch(adapterRef.current) : void 0);
-		if (!resolved) {
-			if (inFlightPersistenceRef.current === 0) {
-				for (const resolve of flushResolversRef.current) resolve();
-				flushResolversRef.current = [];
-			}
-			return;
-		}
-		const { adapter: adapter_1, payload, dirtyIds: dirtyIds_0, seq: seq_0 } = resolved;
-		inFlightPersistenceRef.current += 1;
-		setStateAndRef((prev) => ({
-			...prev,
-			persistence: {
-				...prev.persistence,
-				...Object.fromEntries([...dirtyIds_0].map((id_1) => [id_1, {
-					isPending: true,
-					error: void 0
-				}]))
-			}
-		}));
-		try {
-			await adapter_1.save(payload);
-			setStateAndRef((prev_1) => {
-				let changed_0 = false;
-				const persistence_0 = { ...prev_1.persistence };
-				for (const id_3 of dirtyIds_0) {
-					if (latestSyncSeqByIdRef.current.get(id_3) !== seq_0 || dirtyIdsRef.current.has(id_3)) continue;
-					latestSyncSeqByIdRef.current.delete(id_3);
-					delete persistence_0[id_3];
-					changed_0 = true;
-				}
-				return changed_0 ? {
-					...prev_1,
-					persistence: persistence_0
-				} : prev_1;
-			});
-		} catch (e) {
-			setStateAndRef((prev_0) => {
-				let changed = false;
-				const persistence = { ...prev_0.persistence };
-				for (const id_2 of dirtyIds_0) {
-					if (latestSyncSeqByIdRef.current.get(id_2) !== seq_0 || dirtyIdsRef.current.has(id_2)) continue;
-					latestSyncSeqByIdRef.current.delete(id_2);
-					persistence[id_2] = {
-						isPending: false,
-						error: e
-					};
-					changed = true;
-				}
-				return changed ? {
-					...prev_0,
-					persistence
-				} : prev_0;
-			});
-		} finally {
-			inFlightPersistenceRef.current -= 1;
-			const next = outgoingQueueRef.current.shift() ?? (adapterRef.current && dirtyIdsRef.current.size > 0 ? takeDirtyBatch(adapterRef.current) : void 0);
-			if (next) {
-				if (debounceTimerRef.current !== void 0) {
-					clearTimeout(debounceTimerRef.current);
-					debounceTimerRef.current = void 0;
-				}
-				runPersistenceRef.current(next);
-			} else if (inFlightPersistenceRef.current === 0) {
-				for (const resolve of flushResolversRef.current) resolve();
-				flushResolversRef.current = [];
-			}
-		}
-	}, [setStateAndRef, takeDirtyBatch]);
-	runPersistenceRef.current = (nextBatch) => {
-		runPersistence(nextBatch);
-	};
-	const schedulePersistence = useCallback((id_4) => {
-		if (!adapterRef.current) return;
-		dirtyIdsRef.current.add(id_4);
-		if (debounceTimerRef.current !== void 0) clearTimeout(debounceTimerRef.current);
-		debounceTimerRef.current = setTimeout(() => {
-			debounceTimerRef.current = void 0;
-			if (inFlightPersistenceRef.current === 0 && adapterRef.current) enqueuePersistence(adapterRef.current);
-			else debounceTimerRef.current = setTimeout(() => {
-				debounceTimerRef.current = void 0;
-				if (adapterRef.current) enqueuePersistence(adapterRef.current);
-			}, PERSISTENCE_DEBOUNCE_MS);
-		}, PERSISTENCE_DEBOUNCE_MS);
-	}, [enqueuePersistence]);
+	const updatePersistenceStatus = useCallback((updater_0) => {
+		setStateAndRef((prev) => {
+			const persistence = updater_0(prev.persistence);
+			return persistence === prev.persistence ? prev : {
+				...prev,
+				persistence
+			};
+		});
+	}, [setStateAndRef]);
+	const { flushIfPending, schedulePersistence, flush } = useInteractablePersistenceQueue({
+		adapterRef,
+		snapshot: exportState,
+		updatePersistenceStatus
+	});
 	const importState = useCallback((saved) => {
-		for (const [id_5, entry] of Object.entries(saved)) detachedStateRef.current.set(id_5, entry.state);
-		setStateAndRef((prev_2) => {
-			let changed_1 = 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],
+		for (const [id_0, entry] of Object.entries(saved)) detachedStateRef.current.set(id_0, entry.state);
+		setStateAndRef((prev_0) => {
+			let changed = false;
+			const definitions = { ...prev_0.definitions };
+			for (const [id_1, entry_0] of Object.entries(saved)) if (definitions[id_1]) {
+				definitions[id_1] = {
+					...definitions[id_1],
 					state: entry_0.state
 				};
-				changed_1 = true;
+				changed = true;
 			}
-			return changed_1 ? {
-				...prev_2,
+			return changed ? {
+				...prev_0,
 				definitions
-			} : prev_2;
+			} : prev_0;
 		});
 	}, [setStateAndRef]);
-	const flushIfPending = useCallback(() => {
-		if (debounceTimerRef.current !== void 0) {
-			clearTimeout(debounceTimerRef.current);
-			debounceTimerRef.current = void 0;
-		}
-		if (adapterRef.current) enqueuePersistence(adapterRef.current);
-	}, [enqueuePersistence]);
-	const flush = useCallback(async () => {
-		if (debounceTimerRef.current !== void 0) {
-			clearTimeout(debounceTimerRef.current);
-			debounceTimerRef.current = void 0;
-		}
-		if (!(inFlightPersistenceRef.current > 0 || dirtyIdsRef.current.size > 0 || outgoingQueueRef.current.length > 0)) return;
-		const p = new Promise((resolve_0) => {
-			flushResolversRef.current.push(resolve_0);
-		});
-		if (adapterRef.current) enqueuePersistence(adapterRef.current);
-		return p;
-	}, [enqueuePersistence]);
-	const setPersistenceAdapter = useCallback((adapter_2) => {
-		if (adapterRef.current !== adapter_2) flushIfPending();
-		adapterRef.current = adapter_2;
+	const setPersistenceAdapter = useCallback((adapter) => {
+		if (adapterRef.current !== adapter) flushIfPending();
+		adapterRef.current = adapter;
 	}, [flushIfPending]);
-	const setDefState = useCallback((id_7, updater_0) => {
-		setStateAndRef((prev_3) => {
-			const existing = prev_3.definitions[id_7];
-			if (!existing) return prev_3;
+	const setDefState = useCallback((id_2, updater_1) => {
+		setStateAndRef((prev_1) => {
+			const existing = prev_1.definitions[id_2];
+			if (!existing) return prev_1;
 			return {
-				...prev_3,
+				...prev_1,
 				definitions: {
-					...prev_3.definitions,
-					[id_7]: {
+					...prev_1.definitions,
+					[id_2]: {
 						...existing,
-						state: updater_0(existing.state)
+						state: updater_1(existing.state)
 					}
 				}
 			};
 		});
-		if (stateRef.current.definitions[id_7]) schedulePersistence(id_7);
+		if (stateRef.current.definitions[id_2]) schedulePersistence(id_2);
 	}, [schedulePersistence, setStateAndRef]);
-	const setDefSelected = useCallback((id_8, selected) => {
-		setStateAndRef((prev_4) => {
-			const existing_0 = prev_4.definitions[id_8];
-			if (!existing_0) return prev_4;
+	const setDefSelected = useCallback((id_3, selected) => {
+		setStateAndRef((prev_2) => {
+			const existing_0 = prev_2.definitions[id_3];
+			if (!existing_0) return prev_2;
 			return {
-				...prev_4,
+				...prev_2,
 				definitions: {
-					...prev_4.definitions,
-					[id_8]: {
+					...prev_2.definitions,
+					[id_3]: {
 						...existing_0,
 						selected
 					}
@@ -241,35 +123,35 @@ const useInteractables = () => {
 			try {
 				const jsonSchema = toJSONSchema(def_0.stateSchema);
 				partialSchemaCacheRef.current.set(def_0.id, toPartialJSONSchema(jsonSchema));
-			} catch (e_0) {
-				console.warn(`[Interactables] Failed to create partial schema for "${def_0.name}". The update tool will require all fields.`, e_0);
+			} catch (e) {
+				console.warn(`[Interactables] Failed to create partial schema for "${def_0.name}". The update tool will require all fields.`, e);
 			}
 			const detached = detachedStateRef.current.get(def_0.id);
 			detachedStateRef.current.delete(def_0.id);
-			setStateAndRef((prev_5) => ({
-				...prev_5,
+			setStateAndRef((prev_3) => ({
+				...prev_3,
 				definitions: {
-					...prev_5.definitions,
+					...prev_3.definitions,
 					[def_0.id]: {
 						id: def_0.id,
 						name: def_0.name,
 						description: def_0.description,
 						stateSchema: def_0.stateSchema,
-						state: prev_5.definitions[def_0.id]?.state ?? detached ?? def_0.initialState,
+						state: prev_3.definitions[def_0.id]?.state ?? detached ?? def_0.initialState,
 						selected: def_0.selected
 					}
 				}
 			}));
 			return () => {
 				flushIfPending();
-				setStateAndRef((prev_6) => {
-					const existing_1 = prev_6.definitions[def_0.id];
+				setStateAndRef((prev_4) => {
+					const existing_1 = prev_4.definitions[def_0.id];
 					if (existing_1) detachedStateRef.current.set(def_0.id, existing_1.state);
 					partialSchemaCacheRef.current.delete(def_0.id);
-					const { [def_0.id]: _, ...rest } = prev_6.definitions;
-					const { [def_0.id]: __, ...restPersistence } = prev_6.persistence;
+					const { [def_0.id]: _, ...rest } = prev_4.definitions;
+					const { [def_0.id]: __, ...restPersistence } = prev_4.persistence;
 					return {
-						...prev_6,
+						...prev_4,
 						definitions: rest,
 						persistence: restPersistence
 					};
@@ -290,7 +172,7 @@ const useInteractables = () => {
 * {@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) => {
+attachTransformScopes$1(useInteractables, (scopes, parent) => {
 	if (!scopes.modelContext && parent.modelContext.source === null) scopes.modelContext = ModelContext();
 });
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"Interactables.js","names":["useState","useEffect","useCallback","useRef","useMemo","resource","useAssistantClientRef","ClientOutput","attachTransformScopes","useAssistantScopeEffect","InteractablesState","InteractableRegistration","InteractableStateSchema","InteractablePersistedState","InteractablePersistenceAdapter","toJSONSchema","toPartialJSONSchema","ModelContext","buildInteractableModelContext","notifySubscribers","notifyStateSubscribers","PERSISTENCE_DEBOUNCE_MS","useInteractables","state","setState","definitions","persistence","clientRef","stateRef","setStateAndRef","updater","prev","next","current","subscribersRef","Set","partialSchemaCacheRef","Map","detachedStateRef","adapterRef","undefined","debounceTimerRef","ReturnType","setTimeout","syncSeqRef","latestSyncSeqByIdRef","inFlightPersistenceRef","flushResolversRef","Array","dirtyIdsRef","PersistenceBatch","adapter","payload","dirtyIds","seq","outgoingQueueRef","runPersistenceRef","batch","exportState","result","id","def","Object","entries","name","takeDirtyBatch","size","clear","set","enqueuePersistence","push","runPersistence","resolved","resolve","fromEntries","map","isPending","error","save","changed","get","has","delete","e","shift","clearTimeout","nextBatch","schedulePersistence","add","importState","saved","entry","flushIfPending","flush","hasWork","length","p","Promise","setPersistenceAdapter","setDefState","existing","setDefSelected","selected","provider","getModelContext","defs","subscribe","callback","modelContext","register","jsonSchema","stateSchema","console","warn","detached","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 { useAssistantScopeEffect } from \"@assistant-ui/store/client\";\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\";\nimport { notifySubscribers as notifyStateSubscribers } from \"../../subscribable/subscribable\";\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\n  const setStateAndRef = useCallback(\n    (updater: (prev: InteractablesState) => InteractablesState) => {\n      const next = updater(stateRef.current);\n      stateRef.current = next;\n      setState(next);\n    },\n    [],\n  );\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 latestSyncSeqByIdRef = useRef(new Map<string, number>());\n  const inFlightPersistenceRef = useRef(0);\n  const flushResolversRef = useRef<Array<() => void>>([]);\n  const dirtyIdsRef = useRef(new Set<string>());\n\n  type PersistenceBatch = {\n    adapter: InteractablePersistenceAdapter;\n    payload: InteractablePersistedState;\n    dirtyIds: Set<string>;\n    seq: number;\n  };\n\n  const outgoingQueueRef = useRef<PersistenceBatch[]>([]);\n  const runPersistenceRef = useRef<(batch?: PersistenceBatch) => void>(\n    () => {},\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 takeDirtyBatch = useCallback(\n    (adapter: InteractablePersistenceAdapter): PersistenceBatch | undefined => {\n      if (dirtyIdsRef.current.size === 0) return;\n      const dirtyIds = new Set(dirtyIdsRef.current);\n      dirtyIdsRef.current.clear();\n      const seq = ++syncSeqRef.current;\n      for (const id of dirtyIds) latestSyncSeqByIdRef.current.set(id, seq);\n      return { adapter, payload: exportState(), dirtyIds, seq };\n    },\n    [exportState],\n  );\n\n  const enqueuePersistence = useCallback(\n    (adapter: InteractablePersistenceAdapter) => {\n      const batch = takeDirtyBatch(adapter);\n      if (!batch) return;\n      if (inFlightPersistenceRef.current === 0) {\n        runPersistenceRef.current(batch);\n      } else {\n        outgoingQueueRef.current.push(batch);\n      }\n    },\n    [takeDirtyBatch],\n  );\n\n  const runPersistence = useCallback(\n    async (batch?: PersistenceBatch) => {\n      const resolved =\n        batch ??\n        (adapterRef.current ? takeDirtyBatch(adapterRef.current) : undefined);\n      if (!resolved) {\n        if (inFlightPersistenceRef.current === 0) {\n          for (const resolve of flushResolversRef.current) resolve();\n          flushResolversRef.current = [];\n        }\n        return;\n      }\n\n      const { adapter, payload, dirtyIds, seq } = resolved;\n      inFlightPersistenceRef.current += 1;\n\n      setStateAndRef((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        setStateAndRef((prev) => {\n          let changed = false;\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) {\n            if (\n              latestSyncSeqByIdRef.current.get(id) !== seq ||\n              dirtyIdsRef.current.has(id)\n            )\n              continue;\n            latestSyncSeqByIdRef.current.delete(id);\n            delete persistence[id];\n            changed = true;\n          }\n          return changed ? { ...prev, persistence } : prev;\n        });\n      } catch (e) {\n        setStateAndRef((prev) => {\n          let changed = false;\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) {\n            if (\n              latestSyncSeqByIdRef.current.get(id) !== seq ||\n              dirtyIdsRef.current.has(id)\n            )\n              continue;\n            latestSyncSeqByIdRef.current.delete(id);\n            persistence[id] = { isPending: false, error: e };\n            changed = true;\n          }\n          return changed ? { ...prev, persistence } : prev;\n        });\n      } finally {\n        inFlightPersistenceRef.current -= 1;\n        const next =\n          outgoingQueueRef.current.shift() ??\n          (adapterRef.current && dirtyIdsRef.current.size > 0\n            ? takeDirtyBatch(adapterRef.current)\n            : undefined);\n        if (next) {\n          if (debounceTimerRef.current !== undefined) {\n            clearTimeout(debounceTimerRef.current);\n            debounceTimerRef.current = undefined;\n          }\n          runPersistenceRef.current(next);\n        } else if (inFlightPersistenceRef.current === 0) {\n          for (const resolve of flushResolversRef.current) resolve();\n          flushResolversRef.current = [];\n        }\n      }\n    },\n    [setStateAndRef, takeDirtyBatch],\n  );\n  runPersistenceRef.current = (nextBatch) => {\n    void runPersistence(nextBatch);\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 (inFlightPersistenceRef.current === 0 && adapterRef.current) {\n          enqueuePersistence(adapterRef.current);\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            if (adapterRef.current) enqueuePersistence(adapterRef.current);\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [enqueuePersistence],\n  );\n\n  const importState = useCallback(\n    (saved: InteractablePersistedState) => {\n      for (const [id, entry] of Object.entries(saved)) {\n        detachedStateRef.current.set(id, entry.state);\n      }\n      setStateAndRef((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    [setStateAndRef],\n  );\n\n  const flushIfPending = useCallback(() => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (adapterRef.current) enqueuePersistence(adapterRef.current);\n  }, [enqueuePersistence]);\n\n  const flush = useCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    const hasWork =\n      inFlightPersistenceRef.current > 0 ||\n      dirtyIdsRef.current.size > 0 ||\n      outgoingQueueRef.current.length > 0;\n    if (!hasWork) return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (adapterRef.current) enqueuePersistence(adapterRef.current);\n    return p;\n  }, [enqueuePersistence]);\n\n  const setPersistenceAdapter = useCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      if (adapterRef.current !== adapter) flushIfPending();\n      adapterRef.current = adapter;\n    },\n    [flushIfPending],\n  );\n\n  const setDefState = useCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setStateAndRef((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, setStateAndRef],\n  );\n\n  const setDefSelected = useCallback(\n    (id: string, selected: boolean) => {\n      setStateAndRef((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    [setStateAndRef],\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    notifyStateSubscribers(subscribersRef.current);\n  }, [state]);\n\n  useAssistantScopeEffect(\n    \"modelContext\",\n    () => clientRef.current!.modelContext().register(provider),\n    [provider],\n  );\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      setStateAndRef((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        setStateAndRef((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, setStateAndRef],\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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"}
+{"version":3,"file":"Interactables.js","names":["useState","useEffect","useCallback","useRef","useMemo","resource","useAssistantClientRef","ClientOutput","attachTransformScopes","useAssistantScopeEffect","InteractablesState","InteractableRegistration","InteractableStateSchema","InteractablePersistedState","InteractablePersistenceAdapter","toJSONSchema","toPartialJSONSchema","ModelContext","buildInteractableModelContext","notifySubscribers","notifyStateSubscribers","useInteractablePersistenceQueue","useInteractables","state","setState","definitions","persistence","clientRef","stateRef","setStateAndRef","updater","prev","next","current","subscribersRef","Set","partialSchemaCacheRef","Map","detachedStateRef","adapterRef","undefined","exportState","result","id","def","Object","entries","name","updatePersistenceStatus","flushIfPending","schedulePersistence","flush","snapshot","importState","saved","entry","set","changed","setPersistenceAdapter","adapter","setDefState","existing","setDefSelected","selected","provider","getModelContext","defs","subscribe","callback","add","delete","modelContext","register","jsonSchema","stateSchema","e","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 { useAssistantScopeEffect } from \"@assistant-ui/store/client\";\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\";\nimport { notifySubscribers as notifyStateSubscribers } from \"../../subscribable/subscribable\";\nimport { useInteractablePersistenceQueue } from \"../interactables-shared/useInteractablePersistenceQueue\";\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\n  const setStateAndRef = useCallback(\n    (updater: (prev: InteractablesState) => InteractablesState) => {\n      const next = updater(stateRef.current);\n      stateRef.current = next;\n      setState(next);\n    },\n    [],\n  );\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\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 updatePersistenceStatus = useCallback(\n    (\n      updater: (\n        prev: InteractablesState[\"persistence\"],\n      ) => InteractablesState[\"persistence\"],\n    ) => {\n      setStateAndRef((prev) => {\n        const persistence = updater(prev.persistence);\n        return persistence === prev.persistence\n          ? prev\n          : { ...prev, persistence };\n      });\n    },\n    [setStateAndRef],\n  );\n\n  const { flushIfPending, schedulePersistence, flush } =\n    useInteractablePersistenceQueue({\n      adapterRef,\n      snapshot: exportState,\n      updatePersistenceStatus,\n    });\n\n  const importState = useCallback(\n    (saved: InteractablePersistedState) => {\n      for (const [id, entry] of Object.entries(saved)) {\n        detachedStateRef.current.set(id, entry.state);\n      }\n      setStateAndRef((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    [setStateAndRef],\n  );\n\n  const setPersistenceAdapter = useCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      if (adapterRef.current !== adapter) flushIfPending();\n      adapterRef.current = adapter;\n    },\n    [flushIfPending],\n  );\n\n  const setDefState = useCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setStateAndRef((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, setStateAndRef],\n  );\n\n  const setDefSelected = useCallback(\n    (id: string, selected: boolean) => {\n      setStateAndRef((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    [setStateAndRef],\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    notifyStateSubscribers(subscribersRef.current);\n  }, [state]);\n\n  useAssistantScopeEffect(\n    \"modelContext\",\n    () => clientRef.current!.modelContext().register(provider),\n    [provider],\n  );\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      setStateAndRef((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        setStateAndRef((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, setStateAndRef],\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-shared/useInteractablePersistenceQueue.d.ts

@@ -0,0 +1,24 @@
+import { RefObject } from "react";
+//#region src/react/interactables-shared/useInteractablePersistenceQueue.d.ts
+type PersistenceAdapter<State> = {
+  save(state: State): void | Promise<void>;
+};
+type PersistenceStatus = {
+  isPending: boolean;
+  error: unknown;
+};
+type PersistenceStatusMap = Record<string, PersistenceStatus>;
+type PersistenceStatusUpdater = (updater: (prev: PersistenceStatusMap) => PersistenceStatusMap) => void;
+type UseInteractablePersistenceQueueOptions<State> = {
+  adapterRef: RefObject<PersistenceAdapter<State> | undefined>;
+  snapshot: () => State;
+  updatePersistenceStatus: PersistenceStatusUpdater;
+};
+declare const useInteractablePersistenceQueue: <State>({ adapterRef, snapshot, updatePersistenceStatus }: UseInteractablePersistenceQueueOptions<State>) => {
+  flushIfPending: () => void;
+  schedulePersistence: (id: string) => void;
+  flush: () => Promise<void>;
+};
+//#endregion
+export { useInteractablePersistenceQueue };
+//# sourceMappingURL=useInteractablePersistenceQueue.d.ts.map

package/dist/react/interactables-shared/useInteractablePersistenceQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractablePersistenceQueue.d.ts","names":[],"sources":["../../../src/react/interactables-shared/useInteractablePersistenceQueue.ts"],"mappings":";;KAIK,mBAAmB;EACtB,KAAK,OAAO,eAAe;;KAGxB;EACH;EACA;;KAGG,uBAAuB,eAAe;KAEtC,4BACH,UAAU,MAAM,yBAAyB;KAGtC,uCAAuC;EAC1C,YAAY,UAAU,mBAAmB;EACzC,gBAAgB;EAChB,yBAAyB;;cAGd,kCAAmC,SAAO,YAAA,UAAA,2BAIpD,uCAAuC;;EAyIjC,sBAAA"}

package/dist/react/interactables-shared/useInteractablePersistenceQueue.js

@@ -0,0 +1,138 @@
+import { useCallback, useRef } from "@assistant-ui/tap/react-shim";
+//#region src/react/interactables-shared/useInteractablePersistenceQueue.ts
+const PERSISTENCE_DEBOUNCE_MS = 500;
+const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersistenceStatus }) => {
+	const debounceTimerRef = useRef(void 0);
+	const syncSeqRef = useRef(0);
+	const latestSyncSeqByIdRef = useRef(/* @__PURE__ */ new Map());
+	const inFlightPersistenceRef = useRef(0);
+	const flushResolversRef = useRef([]);
+	const dirtyIdsRef = useRef(/* @__PURE__ */ new Set());
+	const outgoingQueueRef = useRef([]);
+	const runPersistenceRef = useRef(() => {});
+	const takeDirtyBatch = useCallback((adapter) => {
+		if (dirtyIdsRef.current.size === 0) return;
+		const dirtyIds = new Set(dirtyIdsRef.current);
+		dirtyIdsRef.current.clear();
+		const seq = ++syncSeqRef.current;
+		for (const id of dirtyIds) latestSyncSeqByIdRef.current.set(id, seq);
+		return {
+			adapter,
+			payload: snapshot(),
+			dirtyIds,
+			seq
+		};
+	}, [snapshot]);
+	const enqueuePersistence = useCallback((adapter_0) => {
+		const batch = takeDirtyBatch(adapter_0);
+		if (!batch) return;
+		if (inFlightPersistenceRef.current === 0) runPersistenceRef.current(batch);
+		else outgoingQueueRef.current.push(batch);
+	}, [takeDirtyBatch]);
+	const runPersistence = useCallback(async (batch_0) => {
+		const resolved = batch_0 ?? (adapterRef.current ? takeDirtyBatch(adapterRef.current) : void 0);
+		if (!resolved) {
+			if (inFlightPersistenceRef.current === 0) {
+				for (const resolve of flushResolversRef.current) resolve();
+				flushResolversRef.current = [];
+			}
+			return;
+		}
+		const { adapter: adapter_1, payload, dirtyIds: dirtyIds_0, seq: seq_0 } = resolved;
+		inFlightPersistenceRef.current += 1;
+		updatePersistenceStatus((prev) => ({
+			...prev,
+			...Object.fromEntries([...dirtyIds_0].map((id_0) => [id_0, {
+				isPending: true,
+				error: void 0
+			}]))
+		}));
+		const settleBatch = (status) => {
+			const settledIds = [];
+			for (const id_1 of dirtyIds_0) {
+				if (latestSyncSeqByIdRef.current.get(id_1) !== seq_0 || dirtyIdsRef.current.has(id_1)) continue;
+				latestSyncSeqByIdRef.current.delete(id_1);
+				settledIds.push(id_1);
+			}
+			if (settledIds.length === 0) return;
+			updatePersistenceStatus((prev_0) => {
+				let changed = false;
+				const persistence = { ...prev_0 };
+				for (const id_2 of settledIds) {
+					if (prev_0[id_2] === void 0) continue;
+					if (status === void 0) delete persistence[id_2];
+					else persistence[id_2] = status;
+					changed = true;
+				}
+				return changed ? persistence : prev_0;
+			});
+		};
+		try {
+			await adapter_1.save(payload);
+			settleBatch(void 0);
+		} catch (e) {
+			settleBatch({
+				isPending: false,
+				error: e
+			});
+		} finally {
+			inFlightPersistenceRef.current -= 1;
+			const next = outgoingQueueRef.current.shift() ?? (adapterRef.current && dirtyIdsRef.current.size > 0 ? takeDirtyBatch(adapterRef.current) : void 0);
+			if (next) {
+				if (debounceTimerRef.current !== void 0) {
+					clearTimeout(debounceTimerRef.current);
+					debounceTimerRef.current = void 0;
+				}
+				runPersistenceRef.current(next);
+			} else if (inFlightPersistenceRef.current === 0) {
+				for (const resolve of flushResolversRef.current) resolve();
+				flushResolversRef.current = [];
+			}
+		}
+	}, [
+		adapterRef,
+		takeDirtyBatch,
+		updatePersistenceStatus
+	]);
+	runPersistenceRef.current = (nextBatch) => {
+		runPersistence(nextBatch);
+	};
+	return {
+		flushIfPending: useCallback(() => {
+			if (debounceTimerRef.current !== void 0) {
+				clearTimeout(debounceTimerRef.current);
+				debounceTimerRef.current = void 0;
+			}
+			if (adapterRef.current) enqueuePersistence(adapterRef.current);
+		}, [adapterRef, enqueuePersistence]),
+		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 (inFlightPersistenceRef.current === 0 && adapterRef.current) enqueuePersistence(adapterRef.current);
+				else debounceTimerRef.current = setTimeout(() => {
+					debounceTimerRef.current = void 0;
+					if (adapterRef.current) enqueuePersistence(adapterRef.current);
+				}, PERSISTENCE_DEBOUNCE_MS);
+			}, PERSISTENCE_DEBOUNCE_MS);
+		}, [adapterRef, enqueuePersistence]),
+		flush: useCallback(async () => {
+			if (debounceTimerRef.current !== void 0) {
+				clearTimeout(debounceTimerRef.current);
+				debounceTimerRef.current = void 0;
+			}
+			if (!(inFlightPersistenceRef.current > 0 || dirtyIdsRef.current.size > 0 || outgoingQueueRef.current.length > 0)) return;
+			const p = new Promise((resolve_0) => {
+				flushResolversRef.current.push(resolve_0);
+			});
+			if (adapterRef.current) enqueuePersistence(adapterRef.current);
+			return p;
+		}, [adapterRef, enqueuePersistence])
+	};
+};
+//#endregion
+export { useInteractablePersistenceQueue };
+
+//# sourceMappingURL=useInteractablePersistenceQueue.js.map

package/dist/react/interactables-shared/useInteractablePersistenceQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractablePersistenceQueue.js","names":["useCallback","useRef","RefObject","PERSISTENCE_DEBOUNCE_MS","PersistenceAdapter","save","state","State","Promise","PersistenceStatus","isPending","error","PersistenceStatusMap","Record","PersistenceStatusUpdater","updater","prev","UseInteractablePersistenceQueueOptions","adapterRef","snapshot","updatePersistenceStatus","useInteractablePersistenceQueue","debounceTimerRef","ReturnType","setTimeout","undefined","syncSeqRef","latestSyncSeqByIdRef","Map","inFlightPersistenceRef","flushResolversRef","Array","dirtyIdsRef","Set","PersistenceBatch","adapter","payload","dirtyIds","seq","outgoingQueueRef","runPersistenceRef","batch","takeDirtyBatch","current","size","clear","id","set","enqueuePersistence","push","runPersistence","resolved","resolve","Object","fromEntries","map","settleBatch","status","settledIds","get","has","delete","length","changed","persistence","e","next","shift","clearTimeout","nextBatch","flushIfPending","schedulePersistence","add","flush","hasWork","p"],"sources":["../../../src/react/interactables-shared/useInteractablePersistenceQueue.ts"],"sourcesContent":["import { useCallback, useRef, type RefObject } from \"react\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\ntype PersistenceAdapter<State> = {\n  save(state: State): void | Promise<void>;\n};\n\ntype PersistenceStatus = {\n  isPending: boolean;\n  error: unknown;\n};\n\ntype PersistenceStatusMap = Record<string, PersistenceStatus>;\n\ntype PersistenceStatusUpdater = (\n  updater: (prev: PersistenceStatusMap) => PersistenceStatusMap,\n) => void;\n\ntype UseInteractablePersistenceQueueOptions<State> = {\n  adapterRef: RefObject<PersistenceAdapter<State> | undefined>;\n  snapshot: () => State;\n  updatePersistenceStatus: PersistenceStatusUpdater;\n};\n\nexport const useInteractablePersistenceQueue = <State>({\n  adapterRef,\n  snapshot,\n  updatePersistenceStatus,\n}: UseInteractablePersistenceQueueOptions<State>) => {\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = useRef(0);\n  const latestSyncSeqByIdRef = useRef(new Map<string, number>());\n  const inFlightPersistenceRef = useRef(0);\n  const flushResolversRef = useRef<Array<() => void>>([]);\n  const dirtyIdsRef = useRef(new Set<string>());\n\n  type PersistenceBatch = {\n    adapter: PersistenceAdapter<State>;\n    payload: State;\n    dirtyIds: Set<string>;\n    seq: number;\n  };\n\n  const outgoingQueueRef = useRef<PersistenceBatch[]>([]);\n  const runPersistenceRef = useRef<(batch?: PersistenceBatch) => void>(\n    () => {},\n  );\n\n  const takeDirtyBatch = useCallback(\n    (adapter: PersistenceAdapter<State>): PersistenceBatch | undefined => {\n      if (dirtyIdsRef.current.size === 0) return;\n      const dirtyIds = new Set(dirtyIdsRef.current);\n      dirtyIdsRef.current.clear();\n      const seq = ++syncSeqRef.current;\n      for (const id of dirtyIds) latestSyncSeqByIdRef.current.set(id, seq);\n      return { adapter, payload: snapshot(), dirtyIds, seq };\n    },\n    [snapshot],\n  );\n\n  const enqueuePersistence = useCallback(\n    (adapter: PersistenceAdapter<State>) => {\n      const batch = takeDirtyBatch(adapter);\n      if (!batch) return;\n      if (inFlightPersistenceRef.current === 0) {\n        runPersistenceRef.current(batch);\n      } else {\n        outgoingQueueRef.current.push(batch);\n      }\n    },\n    [takeDirtyBatch],\n  );\n\n  const runPersistence = useCallback(\n    async (batch?: PersistenceBatch) => {\n      const resolved =\n        batch ??\n        (adapterRef.current ? takeDirtyBatch(adapterRef.current) : undefined);\n      if (!resolved) {\n        if (inFlightPersistenceRef.current === 0) {\n          for (const resolve of flushResolversRef.current) resolve();\n          flushResolversRef.current = [];\n        }\n        return;\n      }\n\n      const { adapter, payload, dirtyIds, seq } = resolved;\n      inFlightPersistenceRef.current += 1;\n\n      updatePersistenceStatus((prev) => ({\n        ...prev,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      }));\n\n      const settleBatch = (status: PersistenceStatus | undefined) => {\n        const settledIds: string[] = [];\n        for (const id of dirtyIds) {\n          if (\n            latestSyncSeqByIdRef.current.get(id) !== seq ||\n            dirtyIdsRef.current.has(id)\n          )\n            continue;\n          latestSyncSeqByIdRef.current.delete(id);\n          settledIds.push(id);\n        }\n        if (settledIds.length === 0) return;\n        updatePersistenceStatus((prev) => {\n          let changed = false;\n          const persistence = { ...prev };\n          for (const id of settledIds) {\n            if (prev[id] === undefined) continue;\n            if (status === undefined) delete persistence[id];\n            else persistence[id] = status;\n            changed = true;\n          }\n          return changed ? persistence : prev;\n        });\n      };\n\n      try {\n        await adapter.save(payload);\n        settleBatch(undefined);\n      } catch (e) {\n        settleBatch({ isPending: false, error: e });\n      } finally {\n        inFlightPersistenceRef.current -= 1;\n        const next =\n          outgoingQueueRef.current.shift() ??\n          (adapterRef.current && dirtyIdsRef.current.size > 0\n            ? takeDirtyBatch(adapterRef.current)\n            : undefined);\n        if (next) {\n          if (debounceTimerRef.current !== undefined) {\n            clearTimeout(debounceTimerRef.current);\n            debounceTimerRef.current = undefined;\n          }\n          runPersistenceRef.current(next);\n        } else if (inFlightPersistenceRef.current === 0) {\n          for (const resolve of flushResolversRef.current) resolve();\n          flushResolversRef.current = [];\n        }\n      }\n    },\n    [adapterRef, takeDirtyBatch, updatePersistenceStatus],\n  );\n  runPersistenceRef.current = (nextBatch) => {\n    void runPersistence(nextBatch);\n  };\n\n  const flushIfPending = useCallback(() => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (adapterRef.current) enqueuePersistence(adapterRef.current);\n  }, [adapterRef, enqueuePersistence]);\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 (inFlightPersistenceRef.current === 0 && adapterRef.current) {\n          enqueuePersistence(adapterRef.current);\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            if (adapterRef.current) enqueuePersistence(adapterRef.current);\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [adapterRef, enqueuePersistence],\n  );\n\n  const flush = useCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    const hasWork =\n      inFlightPersistenceRef.current > 0 ||\n      dirtyIdsRef.current.size > 0 ||\n      outgoingQueueRef.current.length > 0;\n    if (!hasWork) return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (adapterRef.current) enqueuePersistence(adapterRef.current);\n    return p;\n  }, [adapterRef, enqueuePersistence]);\n\n  return { flushIfPending, schedulePersistence, flush };\n};\n"],"mappings":"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"}

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

@@ -1,7 +1,9 @@
+import { ToolCallText as ToolCallText$1 } from "../../model-context/tool-call-text.js";
 import { ToolCallMessagePartComponent, ToolCallMessagePartProps } from "../types/MessagePartComponentTypes.js";
 import { Tool, ToolCallReader, ToolDeclaration, ToolModelOutputFunction } from "assistant-stream";
 import { ReactNode } from "react";
 //#region src/react/model-context/toolbox.d.ts
+type ToolCallText<TArgs extends Record<string, unknown>, TResult> = ToolCallText$1<TArgs, TResult, ReactNode>;
 /**
  * Resolves whether a tool's UI should be presented standalone (outside the
  * chain-of-thought grouping), applying the type-based defaults.
@@ -31,20 +33,6 @@ type ToolParameters<TArgs extends Record<string, unknown>> = ToolDeclaration<TAr
 type ToolExecuteContext = Parameters<NonNullable<ToolDeclaration["execute"]>>[1];
 type ToolExecute<TArgs extends Record<string, unknown>, TResult> = (args: TArgs, context: ToolExecuteContext) => TResult | Promise<TResult>;
 type ToolStreamCall<TArgs extends Record<string, unknown>, TResult> = (reader: ToolCallReader<TArgs, TResult>, context: ToolExecuteContext) => void;
-type ToolCallRunningText<TArgs extends Record<string, unknown>> = ReactNode | ((options: {
-  args: TArgs;
-}) => ReactNode);
-type ToolCallCompleteText<TArgs extends Record<string, unknown>, TResult> = ReactNode | ((options: {
-  args: TArgs;
-  result: TResult | undefined;
-}) => ReactNode);
-type ToolCallText<TArgs extends Record<string, unknown>, TResult> = {
-  running: ToolCallRunningText<TArgs>;
-  complete?: ToolCallCompleteText<TArgs, TResult> | undefined;
-} | {
-  running?: ToolCallRunningText<TArgs> | undefined;
-  complete: ToolCallCompleteText<TArgs, TResult>;
-};
 declare const makeToolCallTextComponent: <TArgs extends Record<string, unknown>, TResult>(text: ToolCallText<TArgs, TResult>) => ((part: ToolCallMessagePartProps<TArgs, TResult>) => ReactNode);
 /**
  * Tool definition accepted by the React tool registry.

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

@@ -1 +1 @@
-{"version":3,"file":"toolbox.d.ts","names":[],"sources":["../../../src/react/model-context/toolbox.ts"],"mappings":";;;;;;;;;;;;;cAqBa,0BACX,MAAM,KAAK;KAMR,WAAW,GAAG,cAAc,yBAAyB,WAAW;EACnE;IAEE,KACG;EAAY;;EAEH,QAAQ,6BAA6B,OAAO;;EAE5C,SAAS,6BAA6B,OAAO;EAC7C,YAAY,aAAa,OAAO;;EAEpC,QAAQ,6BAA6B,OAAO;KACpD;EACE,SAAS,6BAA6B,OAAO;EAC7C,aAAa,aAAa,OAAO;;KAGlC,eAAe,cAAc,2BAChC,gBAAgB;KAGb,qBAAqB,WACxB,YAAY;KAGT,YAAY,cAAc,yBAAyB,YACtD,MAAM,OACN,SAAS,uBACN,UAAU,QAAQ;KAElB,eAAe,cAAc,yBAAyB,YACzD,QAAQ,eAAe,OAAO,UAC9B,SAAS;KAGN,oBAAoB,cAAc,2BACnC,cACE;EAAW,MAAM;MAAY;KAE9B,qBAAqB,cAAc,yBAAyB,WAC7D,cACE;EAAW,MAAM;EAAO,QAAQ;MAA0B;KAEpD,aAAa,cAAc,yBAAyB;EAE1D,SAAS,oBAAoB;EAC7B,WAAW,qBAAqB,OAAO;;EAGvC,UAAU,oBAAoB;EAC9B,UAAU,qBAAqB,OAAO;;cAqB/B,4BACX,cAAc,yBACd,SAEA,MAAM,aAAa,OAAO,eACvB,MAAM,yBAAyB,OAAO,aAAa;;;;;;;;;KAc5C,eACV,cAAc,0BAA0B,yBACxC,qBACE,WAAW,KAAK,OAAO,UAAU,OAAO;;;;;;;;;;;;;;;;;;;KAoBhC,UAAU,eAAe;;;;;;;;;;KAWhC,sBACH,GACA,mBAAmB,GACnB,4BACoB,EAAE,QAGpB,QAAQ,EAAE,qCACL,KAAK,0BACL,KAAK,QAAQ,2BACf,KAAK,OAAO;KAEd,iCACH;EAAY;GACZ,cAAc,yBACd,WACE,KACF;EAOA;6BAC2B,IACvB,sBAAsB,cAAc,YAAY,QAAQ,QAAQ,iDAErC,IAC3B,sBACE,oBAEA,wBAAwB,QAAQ,QAAQ,QAAQ,yEAGA,IAClD,sBACE,4CAGE,eACA,SAAS,uBACN,QAAQ,WAAW,QAAQ,QAAQ,mBAG9C,sBAAsB,iBAAiB,eAAe;KAInD,uBACH,cAAc,yBACd,WACE,WACF,gBAAgB,OAAO,wBAAuB,KAC1C;EAAY;IACV,iCAAiC,GAAG,OAAO,0BAGjD,OACA;;;;;;;;;;KAYU,uBACV,cAAc,0BAA0B,yBACxC,qBACE,uBAAuB,OAAO,WAAW;KAEjC,qCACV,cAAc,0BAA0B,yBACxC,qBACE,uBAAuB,OAAO;EAChC,YAAY,YAAY,eAAe;;;;;;;KAQ7B,kBACV,uBACG,WAAW,cAAc,6BACxB,qBACJ,yBAAyB,WAAW,8BACjC,WAAW,2BAGb,WAAW,cAAc,uBACxB,YAAY,IACZ,cAAc;;KAKN;;EAEV,SAAS"}
+{"version":3,"file":"toolbox.d.ts","names":[],"sources":["../../../src/react/model-context/toolbox.ts"],"mappings":";;;;;KAgBY,aACV,cAAc,yBACd,WACE,eAAoB,OAAO,SAAS;;;;;;;;;;cAW3B,0BACX,MAAM,KAAK;KAMR,WAAW,GAAG,cAAc,yBAAyB,WAAW;EACnE;IAEE,KACG;EAAY;;EAEH,QAAQ,6BAA6B,OAAO;;EAE5C,SAAS,6BAA6B,OAAO;EAC7C,YAAY,aAAa,OAAO;;EAEpC,QAAQ,6BAA6B,OAAO;KACpD;EACE,SAAS,6BAA6B,OAAO;EAC7C,aAAa,aAAa,OAAO;;KAGlC,eAAe,cAAc,2BAChC,gBAAgB;KAGb,qBAAqB,WACxB,YAAY;KAGT,YAAY,cAAc,yBAAyB,YACtD,MAAM,OACN,SAAS,uBACN,UAAU,QAAQ;KAElB,eAAe,cAAc,yBAAyB,YACzD,QAAQ,eAAe,OAAO,UAC9B,SAAS;cAGE,4BACX,cAAc,yBACd,SAEA,MAAM,aAAa,OAAO,eACvB,MAAM,yBAAyB,OAAO,aAAa;;;;;;;;;KAc5C,eACV,cAAc,0BAA0B,yBACxC,qBACE,WAAW,KAAK,OAAO,UAAU,OAAO;;;;;;;;;;;;;;;;;;;KAoBhC,UAAU,eAAe;;;;;;;;;;KAWhC,sBACH,GACA,mBAAmB,GACnB,4BACoB,EAAE,QAGpB,QAAQ,EAAE,qCACL,KAAK,0BACL,KAAK,QAAQ,2BACf,KAAK,OAAO;KAEd,iCACH;EAAY;GACZ,cAAc,yBACd,WACE,KACF;EAOA;6BAC2B,IACvB,sBAAsB,cAAc,YAAY,QAAQ,QAAQ,iDAErC,IAC3B,sBACE,oBAEA,wBAAwB,QAAQ,QAAQ,QAAQ,yEAGA,IAClD,sBACE,4CAGE,eACA,SAAS,uBACN,QAAQ,WAAW,QAAQ,QAAQ,mBAG9C,sBAAsB,iBAAiB,eAAe;KAInD,uBACH,cAAc,yBACd,WACE,WACF,gBAAgB,OAAO,wBAAuB,KAC1C;EAAY;IACV,iCAAiC,GAAG,OAAO,0BAGjD,OACA;;;;;;;;;;KAYU,uBACV,cAAc,0BAA0B,yBACxC,qBACE,uBAAuB,OAAO,WAAW;KAEjC,qCACV,cAAc,0BAA0B,yBACxC,qBACE,uBAAuB,OAAO;EAChC,YAAY,YAAY,eAAe;;;;;;;KAQ7B,kBACV,uBACG,WAAW,cAAc,6BACxB,qBACJ,yBAAyB,WAAW,8BACjC,WAAW,2BAGb,WAAW,cAAc,uBACxB,YAAY,IACZ,cAAc;;KAKN;;EAEV,SAAS"}