@assistant-ui/core 0.3.20 → 0.3.21

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

@@ -2,7 +2,13 @@ import { nullProtoRecord } from "../../utils/record.js";
 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 }) => {
+/**
+* `load` is caller code with no settling contract, so an awaited `flush` bounds
+* the wait rather than inheriting it. Past this the edit stays queued for the
+* next successful snapshot, which is the same shape a failed load already has.
+*/
+const FLUSH_LOAD_TIMEOUT_MS = 5e3;
+const useInteractablePersistenceQueue = ({ adapterRef, adapterGenerationRef, snapshot, updatePersistenceStatus, retainDirtyWithoutAdapter = false }) => {
 	const debounceTimerRef = useRef(void 0);
 	const syncSeqRef = useRef(0);
 	const latestSyncSeqByIdRef = useRef(/* @__PURE__ */ new Map());
@@ -19,11 +25,12 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 		for (const id of dirtyIds) latestSyncSeqByIdRef.current.set(id, seq);
 		return {
 			adapter,
+			adapterGeneration: adapterGenerationRef.current,
 			payload: snapshot(),
 			dirtyIds,
 			seq
 		};
-	}, [snapshot]);
+	}, [adapterGenerationRef, snapshot]);
 	const enqueuePersistence = useCallback((adapter_0) => {
 		const batch = takeDirtyBatch(adapter_0);
 		if (!batch) return;
@@ -39,7 +46,7 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 			}
 			return;
 		}
-		const { adapter: adapter_1, payload, dirtyIds: dirtyIds_0, seq: seq_0 } = resolved;
+		const { adapter: adapter_1, adapterGeneration, payload, dirtyIds: dirtyIds_0, seq: seq_0 } = resolved;
 		inFlightPersistenceRef.current += 1;
 		updatePersistenceStatus((prev) => {
 			const persistence = nullProtoRecord(prev);
@@ -73,10 +80,12 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 			await adapter_1.save(payload);
 			settleBatch(void 0);
 		} catch (e) {
-			settleBatch({
+			const isCurrentScope = adapterGenerationRef.current === adapterGeneration;
+			if (!isCurrentScope) console.warn("[Interactables] Persistence save failed after the adapter changed.", e);
+			settleBatch(isCurrentScope ? {
 				isPending: false,
 				error: e
-			});
+			} : void 0);
 		} finally {
 			inFlightPersistenceRef.current -= 1;
 			const next = outgoingQueueRef.current.shift() ?? (adapterRef.current && dirtyIdsRef.current.size > 0 ? takeDirtyBatch(adapterRef.current) : void 0);
@@ -92,6 +101,7 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 			}
 		}
 	}, [
+		adapterGenerationRef,
 		adapterRef,
 		takeDirtyBatch,
 		updatePersistenceStatus
@@ -99,35 +109,54 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 	runPersistenceRef.current = (nextBatch) => {
 		runPersistence(nextBatch);
 	};
+	const flushIfPending = useCallback(() => {
+		if (debounceTimerRef.current !== void 0) {
+			clearTimeout(debounceTimerRef.current);
+			debounceTimerRef.current = void 0;
+		}
+		if (adapterRef.current) enqueuePersistence(adapterRef.current);
+	}, [adapterRef, enqueuePersistence]);
+	const schedulePersistence = useCallback((id_3) => {
+		if (!adapterRef.current && !retainDirtyWithoutAdapter) return;
+		dirtyIdsRef.current.add(id_3);
+		if (!adapterRef.current) return;
+		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);
+			}, 500);
+		}, 500);
+	}, [
+		adapterRef,
+		enqueuePersistence,
+		retainDirtyWithoutAdapter
+	]);
 	return {
-		flushIfPending: useCallback(() => {
+		discardPending: 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]),
+			dirtyIdsRef.current.clear();
+			if (inFlightPersistenceRef.current === 0 && outgoingQueueRef.current.length === 0) {
+				for (const resolve_0 of flushResolversRef.current) resolve_0();
+				flushResolversRef.current = [];
+			}
+		}, []),
+		flushIfPending,
+		getDirtyIds: useCallback(() => new Set(dirtyIdsRef.current), []),
+		schedulePersistence,
 		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 (!(inFlightPersistenceRef.current > 0 || outgoingQueueRef.current.length > 0 || adapterRef.current !== void 0 && dirtyIdsRef.current.size > 0)) return;
+			const p = new Promise((resolve_1) => {
+				flushResolversRef.current.push(resolve_1);
 			});
 			if (adapterRef.current) enqueuePersistence(adapterRef.current);
 			return p;
@@ -135,6 +164,6 @@ const useInteractablePersistenceQueue = ({ adapterRef, snapshot, updatePersisten
 	};
 };
 //#endregion
-export { useInteractablePersistenceQueue };
+export { FLUSH_LOAD_TIMEOUT_MS, PERSISTENCE_DEBOUNCE_MS, useInteractablePersistenceQueue };
 
 //# sourceMappingURL=useInteractablePersistenceQueue.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useInteractablePersistenceQueue.js","names":["useCallback","useRef","RefObject","nullProtoRecord","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","persistence","settleBatch","status","settledIds","get","has","delete","length","changed","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\";\nimport { nullProtoRecord } from \"../../utils/record\";\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        const persistence = nullProtoRecord(prev);\n        for (const id of dirtyIds) {\n          persistence[id] = { isPending: true, error: undefined };\n        }\n        return persistence;\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 = nullProtoRecord(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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"}
+{"version":3,"file":"useInteractablePersistenceQueue.js","names":["useCallback","useRef","RefObject","nullProtoRecord","PERSISTENCE_DEBOUNCE_MS","FLUSH_LOAD_TIMEOUT_MS","PersistenceAdapter","save","state","State","Promise","PersistenceStatus","isPending","error","PersistenceStatusMap","Record","PersistenceStatusUpdater","updater","prev","UseInteractablePersistenceQueueOptions","adapterRef","adapterGenerationRef","snapshot","updatePersistenceStatus","retainDirtyWithoutAdapter","useInteractablePersistenceQueue","debounceTimerRef","ReturnType","setTimeout","undefined","syncSeqRef","latestSyncSeqByIdRef","Map","inFlightPersistenceRef","flushResolversRef","Array","dirtyIdsRef","Set","PersistenceBatch","adapter","payload","dirtyIds","seq","adapterGeneration","outgoingQueueRef","runPersistenceRef","batch","takeDirtyBatch","current","size","clear","id","set","enqueuePersistence","push","runPersistence","resolved","resolve","persistence","settleBatch","status","settledIds","get","has","delete","length","changed","e","isCurrentScope","console","warn","next","shift","clearTimeout","nextBatch","flushIfPending","schedulePersistence","add","discardPending","getDirtyIds","flush","hasWork","p"],"sources":["../../../src/react/interactables-shared/useInteractablePersistenceQueue.ts"],"sourcesContent":["import { useCallback, useRef, type RefObject } from \"react\";\nimport { nullProtoRecord } from \"../../utils/record\";\n\nexport const PERSISTENCE_DEBOUNCE_MS = 500;\n\n/**\n * `load` is caller code with no settling contract, so an awaited `flush` bounds\n * the wait rather than inheriting it. Past this the edit stays queued for the\n * next successful snapshot, which is the same shape a failed load already has.\n */\nexport const FLUSH_LOAD_TIMEOUT_MS = 5_000;\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  adapterGenerationRef: RefObject<number>;\n  snapshot: () => State;\n  updatePersistenceStatus: PersistenceStatusUpdater;\n  retainDirtyWithoutAdapter?: boolean;\n};\n\nexport const useInteractablePersistenceQueue = <State>({\n  adapterRef,\n  adapterGenerationRef,\n  snapshot,\n  updatePersistenceStatus,\n  retainDirtyWithoutAdapter = false,\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    adapterGeneration: 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 {\n        adapter,\n        adapterGeneration: adapterGenerationRef.current,\n        payload: snapshot(),\n        dirtyIds,\n        seq,\n      };\n    },\n    [adapterGenerationRef, 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, adapterGeneration, payload, dirtyIds, seq } = resolved;\n      inFlightPersistenceRef.current += 1;\n\n      updatePersistenceStatus((prev) => {\n        const persistence = nullProtoRecord(prev);\n        for (const id of dirtyIds) {\n          persistence[id] = { isPending: true, error: undefined };\n        }\n        return persistence;\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 = nullProtoRecord(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        const isCurrentScope =\n          adapterGenerationRef.current === adapterGeneration;\n        if (!isCurrentScope) {\n          console.warn(\n            \"[Interactables] Persistence save failed after the adapter changed.\",\n            e,\n          );\n        }\n        settleBatch(\n          isCurrentScope ? { isPending: false, error: e } : undefined,\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    [adapterGenerationRef, 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 && !retainDirtyWithoutAdapter) return;\n      dirtyIdsRef.current.add(id);\n      if (!adapterRef.current) return;\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, retainDirtyWithoutAdapter],\n  );\n\n  const discardPending = useCallback(() => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    dirtyIdsRef.current.clear();\n    if (\n      inFlightPersistenceRef.current === 0 &&\n      outgoingQueueRef.current.length === 0\n    ) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n    }\n  }, []);\n\n  const getDirtyIds = useCallback(() => new Set(dirtyIdsRef.current), []);\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      outgoingQueueRef.current.length > 0 ||\n      (adapterRef.current !== undefined && dirtyIdsRef.current.size > 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 {\n    discardPending,\n    flushIfPending,\n    getDirtyIds,\n    schedulePersistence,\n    flush,\n  };\n};\n"],"mappings":"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"}

package/dist/react/model-context/define-mcp-toolkit.d.ts

@@ -1,18 +1,17 @@
-import { Toolkit } from "./toolbox.js";
-import { McpServerConfig } from "assistant-stream";
-//#region src/react/model-context/define-mcp-toolkit.d.ts
+import type { McpServerConfig } from "assistant-stream";
+import type { Toolkit } from "./toolbox.js";
 export type McpToolkitEntry = McpServerConfig | {
-  server: McpServerConfig;
-  disabled?: boolean | undefined;
-  /**
-   * Prefix applied to every tool name exposed by this MCP server. Useful
-   * when multiple servers publish the same tool name, such as `search`.
-   */
-  prefix?: string | undefined;
-  tools?: Record<string, McpToolkitToolConfig> | undefined;
+    server: McpServerConfig;
+    disabled?: boolean | undefined;
+    /**
+     * Prefix applied to every tool name exposed by this MCP server. Useful
+     * when multiple servers publish the same tool name, such as `search`.
+     */
+    prefix?: string | undefined;
+    tools?: Record<string, McpToolkitToolConfig> | undefined;
 };
 export type McpToolkitToolConfig = {
-  disabled?: boolean | undefined;
+    disabled?: boolean | undefined;
 };
 export type McpToolkitDefinition = Record<string, McpToolkitEntry>;
 /**
@@ -22,5 +21,4 @@ export type McpToolkitDefinition = Record<string, McpToolkitEntry>;
  * request.
  */
 export declare function defineMcpToolkit(definition: McpToolkitDefinition): Toolkit;
-//#endregion
 //# sourceMappingURL=define-mcp-toolkit.d.ts.map

package/dist/react/model-context/define-mcp-toolkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-mcp-toolkit.d.ts","names":[],"sources":["../../../src/react/model-context/define-mcp-toolkit.ts"],"mappings":";;;YAGY,kBACR;EAEE,QAAQ;EACR;;;;;EAKA;EACA,QAAQ,eAAe;;YAGjB;EACV;;YAGU,uBAAuB,eAAe;;;;;;;wBAQlC,iBAAiB,YAAY,uBAAuB"}
+{"version":3,"file":"define-mcp-toolkit.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/define-mcp-toolkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAkB;AAEzC,MAAM,MAAM,eAAe,GACvB,eAAe,GACf;IACE,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAoB1E"}

package/dist/react/model-context/define-toolkit.d.ts

@@ -1,5 +1,4 @@
-import { Toolkit, ToolkitDefinition, ToolkitDefinitionEntryWithParameters } from "./toolbox.js";
-//#region src/react/model-context/define-toolkit.d.ts
+import type { Toolkit, ToolkitDefinition, ToolkitDefinitionEntryWithParameters } from "./toolbox.js";
 /**
  * Toolkit authoring helper. Accepts the permissive {@link ToolkitDefinition}
  * (a generative `backend` tool may carry its server `execute`) and types the
@@ -10,7 +9,16 @@ import { Toolkit, ToolkitDefinition, ToolkitDefinitionEntryWithParameters } from
  * Outside generative compilation, it returns the toolkit unchanged and can be
  * used for plain frontend/backend/human toolkit objects.
  */
-export declare function defineToolkit<TArgsByName extends { [K in keyof TArgsByName]: Record<string, unknown>; }, TResultByName extends { [K in keyof TArgsByName]: unknown; } = { [K in keyof TArgsByName]: any; }>(_definition: { [K in keyof TArgsByName]: ToolkitDefinitionEntryWithParameters<TArgsByName[K], TResultByName[K]>; }): Toolkit & { [K in keyof TArgsByName]: ToolkitDefinitionEntryWithParameters<TArgsByName[K], TResultByName[K]>; };
+export declare function defineToolkit<TArgsByName extends {
+    [K in keyof TArgsByName]: Record<string, unknown>;
+}, TResultByName extends {
+    [K in keyof TArgsByName]: unknown;
+} = {
+    [K in keyof TArgsByName]: any;
+}>(_definition: {
+    [K in keyof TArgsByName]: ToolkitDefinitionEntryWithParameters<TArgsByName[K], TResultByName[K]>;
+}): Toolkit & {
+    [K in keyof TArgsByName]: ToolkitDefinitionEntryWithParameters<TArgsByName[K], TResultByName[K]>;
+};
 export declare function defineToolkit<const TDefinition extends ToolkitDefinition>(_definition: TDefinition): Toolkit & TDefinition;
-//#endregion
 //# sourceMappingURL=define-toolkit.d.ts.map

package/dist/react/model-context/define-toolkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-toolkit.d.ts","names":[],"sources":["../../../src/react/model-context/define-toolkit.ts"],"mappings":";;;;;;;;;;;;wBAgBgB,cACd,uBACG,WAAW,cAAc,4BAE5B,yBAAyB,WAAW,8BACjC,WAAW,sBAEd,gBACC,WAAW,cAAc,qCACxB,YAAY,IACZ,cAAc,SAEd,aACD,WAAW,cAAc,qCACxB,YAAY,IACZ,cAAc;wBAGF,oBAAoB,oBAAoB,mBACtD,aAAa,cACZ,UAAU"}
+{"version":3,"file":"define-toolkit.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/define-toolkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,oCAAoC,EACrC,qBAAkB;AAEnB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,WAAW,SAAS;KACjB,CAAC,IAAI,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAClD,EACD,aAAa,SAAS;KAAG,CAAC,IAAI,MAAM,WAAW,GAAG,OAAO;CAAE,GAAG;KAC3D,CAAC,IAAI,MAAM,WAAW,GAAG,GAAG;CAC9B,EACD,WAAW,EAAE;KACZ,CAAC,IAAI,MAAM,WAAW,GAAG,oCAAoC,CAC5D,WAAW,CAAC,CAAC,CAAC,EACd,aAAa,CAAC,CAAC,CAAC,CACjB;CACF,GAAG,OAAO,GAAG;KACX,CAAC,IAAI,MAAM,WAAW,GAAG,oCAAoC,CAC5D,WAAW,CAAC,CAAC,CAAC,EACd,aAAa,CAAC,CAAC,CAAC,CACjB;CACF,CAAC;AACF,wBAAgB,aAAa,CAAC,KAAK,CAAC,WAAW,SAAS,iBAAiB,EACvE,WAAW,EAAE,WAAW,GACvB,OAAO,GAAG,WAAW,CAAC"}

package/dist/react/model-context/external-tool.d.ts

@@ -1,4 +1,3 @@
-//#region src/react/model-context/external-tool.d.ts
 /**
  * Marks a generative toolkit entry as an externally executed backend tool.
  *
@@ -9,5 +8,4 @@
  * client build.
  */
 export declare function externalTool(): never;
-//#endregion
 //# sourceMappingURL=external-tool.d.ts.map

package/dist/react/model-context/external-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-tool.d.ts","names":[],"sources":["../../../src/react/model-context/external-tool.ts"],"mappings":";;;;;;;;;;wBASgB"}
+{"version":3,"file":"external-tool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/external-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAMpC"}

package/dist/react/model-context/human-tool.d.ts

@@ -1,4 +1,3 @@
-//#region src/react/model-context/human-tool.d.ts
 /**
  * Marks a tool as **human-in-the-loop**: the agent pauses and the UI (`render`)
  * supplies the result instead of code. Use it as the tool's `execute`:
@@ -22,5 +21,4 @@ export declare const hitlTool: typeof humanTool;
  * @deprecated Use {@link humanTool}.
  */
 export declare const hitl: typeof humanTool;
-//#endregion
 //# sourceMappingURL=human-tool.d.ts.map

package/dist/react/model-context/human-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human-tool.d.ts","names":[],"sources":["../../../src/react/model-context/human-tool.ts"],"mappings":";;;;;;;;;;;;;;;wBAcgB;;;;qBAYH,iBAAQ;;;;qBAKR,aAAI"}
+{"version":3,"file":"human-tool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/human-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,IAAI,KAAK,CAOjC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,kBAAY,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,IAAI,kBAAY,CAAC"}

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

@@ -1,29 +1,28 @@
-import { ToolDefinition } from "./toolbox.js";
-import { Unstable_InteractableStateSchema } from "../types/scopes/interactables.js";
-import { Unstable_InferInteractableState, Unstable_InteractableVersionInfo } from "./useInteractable.js";
-import { ReactNode } from "react";
-//#region src/react/model-context/interactableTool.d.ts
+import type { ReactNode } from "react";
+import type { Unstable_InteractableStateSchema } from "../types/scopes/interactables.js";
+import type { ToolDefinition } from "./toolbox.js";
+import { type Unstable_InferInteractableState, type Unstable_InteractableVersionInfo } from "./useInteractable.js";
 export type Unstable_InteractableToolRenderProps<TState> = {
-  /**
-   * The live state. While `streaming` is true, fields the model has not
-   * finished generating may still be missing.
-   */
-  state: TState;
-  setState: (updater: TState | ((prev: TState) => TState)) => void;
-  /**
-   * This message's version of the instance: its state as of this point in the
-   * conversation, whether it is the most recent edit, and a `restore()` back
-   * to it. `undefined` while streaming.
-   */
-  version: Unstable_InteractableVersionInfo<TState> | undefined;
-  id: string;
-  /** True while the tool call's arguments are still streaming in. */
-  streaming: boolean;
+    /**
+     * The live state. While `streaming` is true, fields the model has not
+     * finished generating may still be missing.
+     */
+    state: TState;
+    setState: (updater: TState | ((prev: TState) => TState)) => void;
+    /**
+     * This message's version of the instance: its state as of this point in the
+     * conversation, whether it is the most recent edit, and a `restore()` back
+     * to it. `undefined` while streaming.
+     */
+    version: Unstable_InteractableVersionInfo<TState> | undefined;
+    id: string;
+    /** True while the tool call's arguments are still streaming in. */
+    streaming: boolean;
 };
 export type Unstable_InteractableToolConfig<TSchema extends Unstable_InteractableStateSchema> = {
-  description: string;
-  stateSchema: TSchema;
-  render: (props: Unstable_InteractableToolRenderProps<Unstable_InferInteractableState<TSchema>>) => ReactNode;
+    description: string;
+    stateSchema: TSchema;
+    render: (props: Unstable_InteractableToolRenderProps<Unstable_InferInteractableState<TSchema>>) => ReactNode;
 };
 /**
  * Defines a tool that creates a thread-scoped interactable from its arguments,
@@ -46,7 +45,6 @@ export type Unstable_InteractableToolConfig<TSchema extends Unstable_Interactabl
  * @deprecated Unstable / Experimental (not actually removed).
  */
 export declare const unstable_interactableTool: <TSchema extends Unstable_InteractableStateSchema>(config: Unstable_InteractableToolConfig<TSchema>) => ToolDefinition<Record<string, unknown>, {
-  success: true;
+    success: true;
 }>;
-//#endregion
 //# sourceMappingURL=interactableTool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interactableTool.d.ts","names":[],"sources":["../../../src/react/model-context/interactableTool.tsx"],"mappings":";;;;;YAWY,qCAAqC;;;;;EAK/C,OAAO;EACP,WAAW,SAAS,WAAW,MAAM,WAAW;;;;;;EAMhD,SAAS,iCAAiC;EAC1C;;EAEA;;YAGU,gCACV,gBAAgB;EAEhB;EACA,aAAa;EACb,SACE,OAAO,qCACL,gCAAgC,cAE/B;;;;;;;;;;;;;;;;;;;;;;qBA2BM,4BACX,gBAAgB,kCAEhB,QAAQ,gCAAgC,aACvC,eAAe;EAA2B"}
+{"version":3,"file":"interactableTool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/interactableTool.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gCAAgC,EAAE,yCAAsC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAEhD,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACtC,6BAA0B;AAG3B,MAAM,MAAM,oCAAoC,CAAC,MAAM,IAAI;IACzD;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC;IACjE;;;;OAIG;IACH,OAAO,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,+BAA+B,CACzC,OAAO,SAAS,gCAAgC,IAC9C;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,CACN,KAAK,EAAE,oCAAoC,CACzC,+BAA+B,CAAC,OAAO,CAAC,CACzC,KACE,SAAS,CAAC;CAChB,CAAC;AAMF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,gCAAgC,EAEhD,QAAQ,+BAA+B,CAAC,OAAO,CAAC,KAC/C,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAyG3D,CAAC"}

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

@@ -1,6 +1,5 @@
-import { AssistantDataUIProps } from "./useAssistantDataUI.js";
-import { FC } from "react";
-//#region src/react/model-context/makeAssistantDataUI.d.ts
+import type { FC } from "react";
+import { type AssistantDataUIProps } from "./useAssistantDataUI.js";
 /**
  * Component returned by {@link makeAssistantDataUI}.
  *
@@ -8,8 +7,8 @@ import { FC } from "react";
  * parts.
  */
 export type AssistantDataUI = FC & {
-  /** Data renderer registered by this component. */
-  unstable_data: AssistantDataUIProps;
+    /** Data renderer registered by this component. */
+    unstable_data: AssistantDataUIProps;
 };
 /**
  * Creates a React component that registers a named data-part renderer when
@@ -18,5 +17,4 @@ export type AssistantDataUI = FC & {
  * @param dataUI - Data renderer registration.
  */
 export declare const makeAssistantDataUI: <T = any>(dataUI: AssistantDataUIProps<T>) => AssistantDataUI;
-//#endregion
 //# sourceMappingURL=makeAssistantDataUI.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"makeAssistantDataUI.d.ts","names":[],"sources":["../../../src/react/model-context/makeAssistantDataUI.ts"],"mappings":";;;;;;;;;YAYY,kBAAkB;;EAE5B,eAAe;;;;;;;;qBASJ,sBAAuB,SAClC,QAAQ,qBAAqB,OAAE"}
+{"version":3,"file":"makeAssistantDataUI.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/makeAssistantDataUI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,KAAK,oBAAoB,EAE1B,gCAA6B;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,EAAE,GAAG;IACjC,kDAAkD;IAClD,aAAa,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,GAAG,GAAG,EACzC,QAAQ,oBAAoB,CAAC,CAAC,CAAC,oBAQhC,CAAC"}

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

@@ -1,6 +1,5 @@
-import { AssistantToolProps } from "./useAssistantTool.js";
-import { FC } from "react";
-//#region src/react/model-context/makeAssistantTool.d.ts
+import type { FC } from "react";
+import { type AssistantToolProps } from "./useAssistantTool.js";
 /**
  * Component returned by {@link makeAssistantTool}.
  *
@@ -12,8 +11,8 @@ import { FC } from "react";
  * https://assistant-ui.com/docs/migrations/toolkit-tools.
  */
 export type AssistantTool = FC & {
-  /** Tool definition registered by this component. */
-  unstable_tool: AssistantToolProps<any, any>;
+    /** Tool definition registered by this component. */
+    unstable_tool: AssistantToolProps<any, any>;
 };
 /**
  * Creates a React component that registers an assistant tool when rendered.
@@ -28,5 +27,4 @@ export type AssistantTool = FC & {
  * https://assistant-ui.com/docs/migrations/toolkit-tools.
  */
 export declare const makeAssistantTool: <TArgs extends Record<string, unknown>, TResult>(tool: AssistantToolProps<TArgs, TResult>) => AssistantTool;
-//#endregion
 //# sourceMappingURL=makeAssistantTool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"makeAssistantTool.d.ts","names":[],"sources":["../../../src/react/model-context/makeAssistantTool.ts"],"mappings":";;;;;;;;;;;;;YAaY,gBAAgB;;EAE1B,eAAe;;;;;;;;;;;;;;qBAeJ,oBACX,cAAc,yBACd,SAEA,MAAM,mBAAmB,OAAO,aAAQ"}
+{"version":3,"file":"makeAssistantTool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/makeAssistantTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,KAAK,kBAAkB,EAAoB,8BAA2B;AAE/E;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG;IAC/B,oDAAoD;IACpD,aAAa,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAEP,MAAM,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,kBAQzC,CAAC"}

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

@@ -1,6 +1,5 @@
-import { AssistantToolUIProps } from "./useAssistantToolUI.js";
-import { FC } from "react";
-//#region src/react/model-context/makeAssistantToolUI.d.ts
+import type { FC } from "react";
+import { type AssistantToolUIProps } from "./useAssistantToolUI.js";
 /**
  * Component returned by {@link makeAssistantToolUI}.
  *
@@ -12,8 +11,8 @@ import { FC } from "react";
  * See https://assistant-ui.com/docs/migrations/toolkit-tools.
  */
 export type AssistantToolUI = FC & {
-  /** Tool renderer registered by this component. */
-  unstable_tool: AssistantToolUIProps<any, any>;
+    /** Tool renderer registered by this component. */
+    unstable_tool: AssistantToolUIProps<any, any>;
 };
 /**
  * Creates a React component that registers a tool-call renderer when rendered.
@@ -28,5 +27,4 @@ export type AssistantToolUI = FC & {
  * See https://assistant-ui.com/docs/migrations/toolkit-tools.
  */
 export declare const makeAssistantToolUI: <TArgs, TResult>(tool: AssistantToolUIProps<TArgs, TResult>) => AssistantToolUI;
-//#endregion
 //# sourceMappingURL=makeAssistantToolUI.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"makeAssistantToolUI.d.ts","names":[],"sources":["../../../src/react/model-context/makeAssistantToolUI.ts"],"mappings":";;;;;;;;;;;;;YAgBY,kBAAkB;;EAE5B,eAAe;;;;;;;;;;;;;;qBAeJ,sBAAuB,OAAO,SACzC,MAAM,qBAAqB,OAAO,aAAQ"}
+{"version":3,"file":"makeAssistantToolUI.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/makeAssistantToolUI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,KAAK,oBAAoB,EAE1B,gCAA6B;AAE9B;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,EAAE,GAAG;IACjC,kDAAkD;IAClD,aAAa,EAAE,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,EAAE,OAAO,EAChD,MAAM,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,oBAQ3C,CAAC"}

package/dist/react/model-context/provider-tool.d.ts

@@ -1,7 +1,6 @@
-import { Tool } from "assistant-stream";
-//#region src/react/model-context/provider-tool.d.ts
+import type { Tool } from "assistant-stream";
 type ProviderToolDefinition<TArgs extends Record<string, unknown>> = Extract<Tool<TArgs, unknown>, {
-  type: "provider";
+    type: "provider";
 }>;
 export type ProviderToolConfig<TArgs extends Record<string, unknown> = Record<string, unknown>> = Pick<ProviderToolDefinition<TArgs>, "providerId" | "args" | "parameters" | "providerOptions" | "supportsDeferredResults">;
 /**
@@ -9,5 +8,5 @@ export type ProviderToolConfig<TArgs extends Record<string, unknown> = Record<st
  * `execute: providerTool(...)` into a `type: "provider"` tool entry.
  */
 export declare function providerTool(_config: ProviderToolConfig): never;
-//#endregion
+export {};
 //# sourceMappingURL=provider-tool.d.ts.map

package/dist/react/model-context/provider-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-tool.d.ts","names":[],"sources":["../../../src/react/model-context/provider-tool.ts"],"mappings":";;KAEK,uBAAuB,cAAc,2BAA2B,QACnE,KAAK;EACH;;YAGQ,mBACV,cAAc,0BAA0B,2BACtC,KACF,uBAAuB;;;;;wBAYT,aAAa,SAAS"}
+{"version":3,"file":"provider-tool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/provider-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,KAAK,sBAAsB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,OAAO,CAC1E,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAC5B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC7D,IAAI,CACN,sBAAsB,CAAC,KAAK,CAAC,EAC3B,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,iBAAiB,GACjB,yBAAyB,CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,KAAK,CAO/D"}

package/dist/react/model-context/stub-tool.d.ts

@@ -1,4 +1,3 @@
-//#region src/react/model-context/stub-tool.d.ts
 /**
  * Marks a generative toolkit entry as a frontend tool whose executor will be
  * supplied by `useAuiToolOverrides(...)`.
@@ -7,5 +6,4 @@
  * `"use generative"` toolkit file so the compiler can strip it.
  */
 export declare function stubTool(): never;
-//#endregion
 //# sourceMappingURL=stub-tool.d.ts.map

package/dist/react/model-context/stub-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stub-tool.d.ts","names":[],"sources":["../../../src/react/model-context/stub-tool.ts"],"mappings":";;;;;;;;wBAOgB"}
+{"version":3,"file":"stub-tool.d.ts","sourceRoot":"","sources":["../../../src/react/model-context/stub-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAMhC"}