npm - @assistant-ui/core - Versions diffs - 0.2.9 → 0.2.11 - Mend

@assistant-ui/core 0.2.9 → 0.2.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (437) hide show

package/dist/react/adapters/LocalStorageThreadListAdapter.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { RuntimeAdapterProvider } from "../runtimes/RuntimeAdapterProvider.js";
 import { createAssistantStream } from "assistant-stream";
-import { useMemo } from "react";
+import { useMemo } from "@assistant-ui/tap/react-shim";
 import { useAui } from "@assistant-ui/store";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/adapters/LocalStorageThreadListAdapter.tsx
@@ -64,7 +64,8 @@ const createLocalStorageAdapter = (options) => {
 				remoteId: t.remoteId,
 				externalId: t.externalId,
 				status: t.status,
-				title: t.title
+				title: t.title,
+				custom: t.custom
 			})) };
 		},
 		async initialize(threadId) {
@@ -90,6 +91,14 @@ const createLocalStorageAdapter = (options) => {
 				await saveThreadMetadata(threads);
 			}
 		},
+		async updateCustom(remoteId, custom) {
+			const threads = await loadThreadMetadata();
+			const thread = threads.find((t) => t.remoteId === remoteId);
+			if (thread) {
+				thread.custom = custom;
+				await saveThreadMetadata(threads);
+			}
+		},
 		async archive(remoteId) {
 			const threads = await loadThreadMetadata();
 			const thread = threads.find((t) => t.remoteId === remoteId);
@@ -117,7 +126,8 @@ const createLocalStorageAdapter = (options) => {
 				remoteId: thread.remoteId,
 				externalId: thread.externalId,
 				status: thread.status,
-				title: thread.title
+				title: thread.title,
+				custom: thread.custom
 			};
 		},
 		async generateTitle(remoteId, messages) {

package/dist/react/adapters/LocalStorageThreadListAdapter.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"LocalStorageThreadListAdapter.js","names":[],"sources":["../../../src/react/adapters/LocalStorageThreadListAdapter.tsx"],"sourcesContent":["import { type AssistantStream, createAssistantStream } from \"assistant-stream\";\nimport { type FC, type PropsWithChildren, useMemo } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type {\n RemoteThreadInitializeResponse,\n RemoteThreadListAdapter,\n RemoteThreadListResponse,\n RemoteThreadMetadata,\n ThreadHistoryAdapter,\n ThreadMessage,\n} from \"../../index\";\nimport type {\n ExportedMessageRepository,\n ExportedMessageRepositoryItem,\n} from \"../../internal\";\nimport { RuntimeAdapterProvider } from \"../runtimes/RuntimeAdapterProvider\";\nimport type { TitleGenerationAdapter } from \"./TitleGenerationAdapter\";\n\nexport type AsyncStorageLike = {\n getItem(key: string): Promise<string \| null>;\n setItem(key: string, value: string): Promise<void>;\n removeItem(key: string): Promise<void>;\n};\n\ntype LocalStorageAdapterOptions = {\n storage: AsyncStorageLike;\n prefix?: string \| undefined;\n titleGenerator?: TitleGenerationAdapter \| undefined;\n};\n\n// `RemoteThreadMetadata.custom` is intentionally not persisted; consumers that\n// need it across reloads should fork this adapter or use a remote backend.\ntype StoredThreadMetadata = {\n remoteId: string;\n externalId?: string;\n status: \"regular\" \| \"archived\";\n title?: string;\n};\n\nclass AsyncStorageHistoryAdapter implements ThreadHistoryAdapter {\n constructor(\n private storage: AsyncStorageLike,\n private aui: ReturnType<typeof useAui>,\n private prefix: string,\n ) {}\n\n private _messagesKey(remoteId: string) {\n return `${this.prefix}messages:${remoteId}`;\n }\n\n async load(): Promise<ExportedMessageRepository> {\n const remoteId = this.aui.threadListItem().getState().remoteId;\n if (!remoteId) return { messages: [] };\n\n const raw = await this.storage.getItem(this._messagesKey(remoteId));\n if (!raw) return { messages: [] };\n return JSON.parse(raw) as ExportedMessageRepository;\n }\n\n async append(item: ExportedMessageRepositoryItem): Promise<void> {\n const { remoteId } = await this.aui.threadListItem().initialize();\n\n const key = this._messagesKey(remoteId);\n const raw = await this.storage.getItem(key);\n const repo: ExportedMessageRepository = raw\n ? (JSON.parse(raw) as ExportedMessageRepository)\n : { messages: [] };\n\n const idx = repo.messages.findIndex(\n (m) => m.message.id === item.message.id,\n );\n if (idx >= 0) {\n repo.messages[idx] = item;\n } else {\n repo.messages.push(item);\n }\n repo.headId = item.message.id;\n\n await this.storage.setItem(key, JSON.stringify(repo));\n }\n}\n\nconst createHistoryProvider = (\n storage: AsyncStorageLike,\n prefix: string,\n): FC<PropsWithChildren> => {\n const Provider: FC<PropsWithChildren> = ({ children }) => {\n const aui = useAui();\n const history = useMemo(\n () => new AsyncStorageHistoryAdapter(storage, aui, prefix),\n [aui],\n );\n const adapters = useMemo(() => ({ history }), [history]);\n\n return (\n <RuntimeAdapterProvider adapters={adapters}>\n {children}\n </RuntimeAdapterProvider>\n );\n };\n return Provider;\n};\n\nexport const createLocalStorageAdapter = (\n options: LocalStorageAdapterOptions,\n): RemoteThreadListAdapter => {\n const { storage, prefix = \"@assistant-ui:\", titleGenerator } = options;\n\n const threadsKey = `${prefix}threads`;\n const messagesKey = (threadId: string) => `${prefix}messages:${threadId}`;\n\n const loadThreadMetadata = async (): Promise<StoredThreadMetadata[]> => {\n const raw = await storage.getItem(threadsKey);\n return raw ? (JSON.parse(raw) as StoredThreadMetadata[]) : [];\n };\n\n const saveThreadMetadata = async (\n threads: StoredThreadMetadata[],\n ): Promise<void> => {\n await storage.setItem(threadsKey, JSON.stringify(threads));\n };\n\n const adapter: RemoteThreadListAdapter = {\n unstable_Provider: createHistoryProvider(storage, prefix),\n\n async list(): Promise<RemoteThreadListResponse> {\n const threads = await loadThreadMetadata();\n return {\n threads: threads.map((t) => ({\n remoteId: t.remoteId,\n externalId: t.externalId,\n status: t.status,\n title: t.title,\n })),\n };\n },\n\n async initialize(\n threadId: string,\n ): Promise<RemoteThreadInitializeResponse> {\n const remoteId = threadId;\n const threads = await loadThreadMetadata();\n\n // Only add if not already present\n if (!threads.some((t) => t.remoteId === remoteId)) {\n threads.unshift({\n remoteId,\n status: \"regular\",\n });\n await saveThreadMetadata(threads);\n }\n\n return { remoteId, externalId: undefined };\n },\n\n async rename(remoteId: string, newTitle: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.title = newTitle;\n await saveThreadMetadata(threads);\n }\n },\n\n async archive(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.status = \"archived\";\n await saveThreadMetadata(threads);\n }\n },\n\n async unarchive(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.status = \"regular\";\n await saveThreadMetadata(threads);\n }\n },\n\n async delete(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const filtered = threads.filter((t) => t.remoteId !== remoteId);\n await saveThreadMetadata(filtered);\n await storage.removeItem(messagesKey(remoteId));\n },\n\n async fetch(threadId: string): Promise<RemoteThreadMetadata> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === threadId);\n if (!thread) throw new Error(\"Thread not found\");\n return {\n remoteId: thread.remoteId,\n externalId: thread.externalId,\n status: thread.status,\n title: thread.title,\n };\n },\n\n async generateTitle(\n remoteId: string,\n messages: readonly ThreadMessage[],\n ): Promise<AssistantStream> {\n if (titleGenerator) {\n const title = await titleGenerator.generateTitle(messages);\n\n // Update the stored title\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.title = title;\n await saveThreadMetadata(threads);\n }\n\n // Return a stream with a single text part\n return createAssistantStream((controller) => {\n controller.appendText(title);\n });\n }\n\n // No title generator — return empty stream\n return createAssistantStream(() => {});\n },\n };\n\n return adapter;\n};\n"],"mappings":"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"}
1	+ {"version":3,"file":"LocalStorageThreadListAdapter.js","names":[],"sources":["../../../src/react/adapters/LocalStorageThreadListAdapter.tsx"],"sourcesContent":["import { type AssistantStream, createAssistantStream } from \"assistant-stream\";\nimport { type FC, type PropsWithChildren, useMemo } from \"react\";\nimport { useAui } from \"@assistant-ui/store\";\nimport type {\n RemoteThreadInitializeResponse,\n RemoteThreadListAdapter,\n RemoteThreadListResponse,\n RemoteThreadMetadata,\n ThreadHistoryAdapter,\n ThreadMessage,\n} from \"../../index\";\nimport type {\n ExportedMessageRepository,\n ExportedMessageRepositoryItem,\n} from \"../../internal\";\nimport { RuntimeAdapterProvider } from \"../runtimes/RuntimeAdapterProvider\";\nimport type { TitleGenerationAdapter } from \"./TitleGenerationAdapter\";\n\nexport type AsyncStorageLike = {\n getItem(key: string): Promise<string \| null>;\n setItem(key: string, value: string): Promise<void>;\n removeItem(key: string): Promise<void>;\n};\n\ntype LocalStorageAdapterOptions = {\n storage: AsyncStorageLike;\n prefix?: string \| undefined;\n titleGenerator?: TitleGenerationAdapter \| undefined;\n};\n\ntype StoredThreadMetadata = {\n remoteId: string;\n externalId?: string;\n status: \"regular\" \| \"archived\";\n title?: string;\n custom?: Record<string, unknown> \| undefined;\n};\n\nclass AsyncStorageHistoryAdapter implements ThreadHistoryAdapter {\n constructor(\n private storage: AsyncStorageLike,\n private aui: ReturnType<typeof useAui>,\n private prefix: string,\n ) {}\n\n private _messagesKey(remoteId: string) {\n return `${this.prefix}messages:${remoteId}`;\n }\n\n async load(): Promise<ExportedMessageRepository> {\n const remoteId = this.aui.threadListItem().getState().remoteId;\n if (!remoteId) return { messages: [] };\n\n const raw = await this.storage.getItem(this._messagesKey(remoteId));\n if (!raw) return { messages: [] };\n return JSON.parse(raw) as ExportedMessageRepository;\n }\n\n async append(item: ExportedMessageRepositoryItem): Promise<void> {\n const { remoteId } = await this.aui.threadListItem().initialize();\n\n const key = this._messagesKey(remoteId);\n const raw = await this.storage.getItem(key);\n const repo: ExportedMessageRepository = raw\n ? (JSON.parse(raw) as ExportedMessageRepository)\n : { messages: [] };\n\n const idx = repo.messages.findIndex(\n (m) => m.message.id === item.message.id,\n );\n if (idx >= 0) {\n repo.messages[idx] = item;\n } else {\n repo.messages.push(item);\n }\n repo.headId = item.message.id;\n\n await this.storage.setItem(key, JSON.stringify(repo));\n }\n}\n\nconst createHistoryProvider = (\n storage: AsyncStorageLike,\n prefix: string,\n): FC<PropsWithChildren> => {\n const Provider: FC<PropsWithChildren> = ({ children }) => {\n const aui = useAui();\n const history = useMemo(\n () => new AsyncStorageHistoryAdapter(storage, aui, prefix),\n [aui],\n );\n const adapters = useMemo(() => ({ history }), [history]);\n\n return (\n <RuntimeAdapterProvider adapters={adapters}>\n {children}\n </RuntimeAdapterProvider>\n );\n };\n return Provider;\n};\n\nexport const createLocalStorageAdapter = (\n options: LocalStorageAdapterOptions,\n): RemoteThreadListAdapter => {\n const { storage, prefix = \"@assistant-ui:\", titleGenerator } = options;\n\n const threadsKey = `${prefix}threads`;\n const messagesKey = (threadId: string) => `${prefix}messages:${threadId}`;\n\n const loadThreadMetadata = async (): Promise<StoredThreadMetadata[]> => {\n const raw = await storage.getItem(threadsKey);\n return raw ? (JSON.parse(raw) as StoredThreadMetadata[]) : [];\n };\n\n const saveThreadMetadata = async (\n threads: StoredThreadMetadata[],\n ): Promise<void> => {\n await storage.setItem(threadsKey, JSON.stringify(threads));\n };\n\n const adapter: RemoteThreadListAdapter = {\n unstable_Provider: createHistoryProvider(storage, prefix),\n\n async list(): Promise<RemoteThreadListResponse> {\n const threads = await loadThreadMetadata();\n return {\n threads: threads.map((t) => ({\n remoteId: t.remoteId,\n externalId: t.externalId,\n status: t.status,\n title: t.title,\n custom: t.custom,\n })),\n };\n },\n\n async initialize(\n threadId: string,\n ): Promise<RemoteThreadInitializeResponse> {\n const remoteId = threadId;\n const threads = await loadThreadMetadata();\n\n // Only add if not already present\n if (!threads.some((t) => t.remoteId === remoteId)) {\n threads.unshift({\n remoteId,\n status: \"regular\",\n });\n await saveThreadMetadata(threads);\n }\n\n return { remoteId, externalId: undefined };\n },\n\n async rename(remoteId: string, newTitle: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.title = newTitle;\n await saveThreadMetadata(threads);\n }\n },\n\n async updateCustom(\n remoteId: string,\n custom: Record<string, unknown> \| undefined,\n ): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.custom = custom;\n await saveThreadMetadata(threads);\n }\n },\n\n async archive(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.status = \"archived\";\n await saveThreadMetadata(threads);\n }\n },\n\n async unarchive(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.status = \"regular\";\n await saveThreadMetadata(threads);\n }\n },\n\n async delete(remoteId: string): Promise<void> {\n const threads = await loadThreadMetadata();\n const filtered = threads.filter((t) => t.remoteId !== remoteId);\n await saveThreadMetadata(filtered);\n await storage.removeItem(messagesKey(remoteId));\n },\n\n async fetch(threadId: string): Promise<RemoteThreadMetadata> {\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === threadId);\n if (!thread) throw new Error(\"Thread not found\");\n return {\n remoteId: thread.remoteId,\n externalId: thread.externalId,\n status: thread.status,\n title: thread.title,\n custom: thread.custom,\n };\n },\n\n async generateTitle(\n remoteId: string,\n messages: readonly ThreadMessage[],\n ): Promise<AssistantStream> {\n if (titleGenerator) {\n const title = await titleGenerator.generateTitle(messages);\n\n // Update the stored title\n const threads = await loadThreadMetadata();\n const thread = threads.find((t) => t.remoteId === remoteId);\n if (thread) {\n thread.title = title;\n await saveThreadMetadata(threads);\n }\n\n // Return a stream with a single text part\n return createAssistantStream((controller) => {\n controller.appendText(title);\n });\n }\n\n // No title generator — return empty stream\n return createAssistantStream(() => {});\n },\n };\n\n return adapter;\n};\n"],"mappings":"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"}

package/dist/react/client/DataRenderers.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DataRenderers.d.ts","names":[],"sources":["../../../src/react/client/DataRenderers.ts"],"mappings":";;;;;~~AAYA~~;;;;AAA0B;cAAb,aAAA,oCAAa,eAAA,CAAA,YAAA"}
1	+ {"version":3,"file":"DataRenderers.d.ts","names":[],"sources":["../../../src/react/client/DataRenderers.ts"],"mappings":";;;;;AAaA;;;;AAA0B;cAAb,aAAA,oCAAa,eAAA,CAAA,YAAA"}

package/dist/react/client/DataRenderers.js CHANGED Viewed

@@ -1,4 +1,5 @@
-import { resource, tapCallback, tapState } from "@assistant-ui/tap";
+import { useCallback, useState } from "@assistant-ui/tap/react-shim";
+import { resource } from "@assistant-ui/tap";
 //#region src/react/client/DataRenderers.ts
 /**
 * Registers renderers for `data` message parts.
@@ -7,14 +8,14 @@ import { resource, tapCallback, tapState } from "@assistant-ui/tap";
 * directly for a renderer scope, or prefer {@link useAssistantDataUI} /
 * {@link makeAssistantDataUI} when registering from React components.
 */
-const DataRenderers = resource(() => {
-	const [state, setState] = tapState(() => ({
+const DataRenderers = resource(function DataRenderers() {
+	const [state, setState] = useState(() => ({
 		renderers: {},
 		fallbacks: []
 	}));
 	return {
 		getState: () => state,
-		setDataUI: tapCallback((name, render) => {
+		setDataUI: useCallback((name, render) => {
 			setState((prev) => {
 				return {
 					...prev,
@@ -36,7 +37,7 @@ const DataRenderers = resource(() => {
 				});
 			};
 		}, []),
-		setFallbackDataUI: tapCallback((render) => {
+		setFallbackDataUI: useCallback((render) => {
 			setState((prev) => ({
 				...prev,
 				fallbacks: [...prev.fallbacks, render]

package/dist/react/client/DataRenderers.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DataRenderers.js","names":[],"sources":["../../../src/react/client/DataRenderers.ts"],"sourcesContent":["import { ~~resource~~, ~~tapState,~~ ~~tapCallback~~ } from \"@assistant-ui/tap\";\nimport type { ClientOutput } from \"@assistant-ui/store\";\nimport type { DataRenderersState } from \"../types/scopes/dataRenderers\";\nimport type { DataMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/*\n Registers renderers for `data` message parts.\n \n Data renderers are looked up by the part's `name` field. Use this resource\n * directly for a renderer scope, or prefer {@link useAssistantDataUI} /\n * {@link makeAssistantDataUI} when registering from React components.\n */\nexport const DataRenderers = resource((): ClientOutput<\"dataRenderers\"> => {\n const [state, setState] = ~~tapState~~<DataRenderersState>(() => ({\n renderers: {},\n fallbacks: [],\n }));\n\n const setDataUI = ~~tapCallback~~(\n (name: string, render: DataMessagePartComponent) => {\n setState((prev) => {\n return {\n ...prev,\n renderers: {\n ...prev.renderers,\n [name]: [...(prev.renderers[name] ?? []), render],\n },\n };\n });\n\n return () => {\n setState((prev) => {\n return {\n ...prev,\n renderers: {\n ...prev.renderers,\n [name]: prev.renderers[name]?.filter((r) => r !== render) ?? [],\n },\n };\n });\n };\n },\n [],\n );\n\n const setFallbackDataUI = ~~tapCallback~~((render: DataMessagePartComponent) => {\n setState((prev) => ({\n ...prev,\n fallbacks: [...prev.fallbacks, render],\n }));\n\n return () => {\n setState((prev) => ({\n ...prev,\n fallbacks: prev.fallbacks.filter((r) => r !== render),\n }));\n };\n }, []);\n\n return {\n getState: () => state,\n setDataUI,\n setFallbackDataUI,\n };\n});\n"],"mappings":"~~;;;;;;;;;AAYA~~,MAAa,gBAAgB,~~eAA8C~~;~~CACzE~~,MAAM,CAAC,OAAO,YAAY,gBAAoC;EAC5D,WAAW,CAAC;EACZ,WAAW,CAAC;CACd,EAAE;~~CA2CF~~,OAAO;EACL,gBAAgB;EAChB,~~WA3CgB~~,aACf,MAAc,WAAqC;GAClD,UAAU,SAAS;IACjB,OAAO;KACL,GAAG;KACH,WAAW;MACT,GAAG,KAAK;OACP,OAAO,CAAC,GAAI,KAAK,UAAU,SAAS,CAAC,GAAI,MAAM;KAClD;IACF;GACF,CAAC;GAED,aAAa;IACX,UAAU,SAAS;KACjB,OAAO;MACL,GAAG;MACH,WAAW;OACT,GAAG,KAAK;QACP,OAAO,KAAK,UAAU,~~OAAO~~,QAAQ,MAAM,MAAM,MAAM,KAAK,CAAC;MAChE;KACF;IACF,CAAC;GACH;EACF,GACA,CAAC,~~CAmBO~~;EACR,~~mBAjBwB~~,~~aAAa~~,WAAqC;~~GAC1E~~,UAAU,UAAU;IAClB,GAAG;IACH,WAAW,CAAC,GAAG,KAAK,WAAW,MAAM;GACvC,EAAE;GAEF,aAAa;IACX,UAAU,UAAU;KAClB,GAAG;KACH,WAAW,KAAK,UAAU,QAAQ,MAAM,MAAM,MAAM;IACtD,EAAE;GACJ;EACF,~~GAAG~~,CAAC,~~CAKc~~;CAClB;AACF,~~CAAC~~"}
1	+ {"version":3,"file":"DataRenderers.js","names":[],"sources":["../../../src/react/client/DataRenderers.ts"],"sourcesContent":["import { useState, useCallback } from \"react\";\nimport { resource } from \"@assistant-ui/tap\";\nimport type { ClientOutput } from \"@assistant-ui/store\";\nimport type { DataRenderersState } from \"../types/scopes/dataRenderers\";\nimport type { DataMessagePartComponent } from \"../types/MessagePartComponentTypes\";\n\n/*\n Registers renderers for `data` message parts.\n \n Data renderers are looked up by the part's `name` field. Use this resource\n * directly for a renderer scope, or prefer {@link useAssistantDataUI} /\n * {@link makeAssistantDataUI} when registering from React components.\n */\nexport const DataRenderers = resource(\n function DataRenderers(): ClientOutput<\"dataRenderers\"> {\n const [state, setState] = useState<DataRenderersState>(() => ({\n renderers: {},\n fallbacks: [],\n }));\n\n const setDataUI = useCallback(\n (name: string, render: DataMessagePartComponent) => {\n setState((prev) => {\n return {\n ...prev,\n renderers: {\n ...prev.renderers,\n [name]: [...(prev.renderers[name] ?? []), render],\n },\n };\n });\n\n return () => {\n setState((prev) => {\n return {\n ...prev,\n renderers: {\n ...prev.renderers,\n [name]: prev.renderers[name]?.filter((r) => r !== render) ?? [],\n },\n };\n });\n };\n },\n [],\n );\n\n const setFallbackDataUI = useCallback(\n (render: DataMessagePartComponent) => {\n setState((prev) => ({\n ...prev,\n fallbacks: [...prev.fallbacks, render],\n }));\n\n return () => {\n setState((prev) => ({\n ...prev,\n fallbacks: prev.fallbacks.filter((r) => r !== render),\n }));\n };\n },\n [],\n );\n\n return {\n getState: () => state,\n setDataUI,\n setFallbackDataUI,\n };\n },\n);\n"],"mappings":";;;;;;;;;;AAaA,MAAa,gBAAgB,SAC3B,SAAS,gBAA+C;CACtD,MAAM,CAAC,OAAO,YAAY,gBAAoC;EAC5D,WAAW,CAAC;EACZ,WAAW,CAAC;CACd,EAAE;CA8CF,OAAO;EACL,gBAAgB;EAChB,WA9CgB,aACf,MAAc,WAAqC;GAClD,UAAU,SAAS;IACjB,OAAO;KACL,GAAG;KACH,WAAW;MACT,GAAG,KAAK;OACP,OAAO,CAAC,GAAI,KAAK,UAAU,SAAS,CAAC,GAAI,MAAM;KAClD;IACF;GACF,CAAC;GAED,aAAa;IACX,UAAU,SAAS;KACjB,OAAO;MACL,GAAG;MACH,WAAW;OACT,GAAG,KAAK;QACP,OAAO,KAAK,UAAU,KAAK,EAAE,QAAQ,MAAM,MAAM,MAAM,KAAK,CAAC;MAChE;KACF;IACF,CAAC;GACH;EACF,GACA,CAAC,CAsBO;EACR,mBApBwB,aACvB,WAAqC;GACpC,UAAU,UAAU;IAClB,GAAG;IACH,WAAW,CAAC,GAAG,KAAK,WAAW,MAAM;GACvC,EAAE;GAEF,aAAa;IACX,UAAU,UAAU;KAClB,GAAG;KACH,WAAW,KAAK,UAAU,QAAQ,MAAM,MAAM,MAAM;IACtD,EAAE;GACJ;EACF,GACA,CAAC,CAMe;CAClB;AACF,CACF"}

package/dist/react/client/Interactables.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Interactables.d.ts","names":[],"sources":["../../../src/react/client/Interactables.ts"],"mappings":";;;~~cA0Ba~~,aAAA,oCAAa,eAAA,CAAA,YAAA"}
1	+ {"version":3,"file":"Interactables.d.ts","names":[],"sources":["../../../src/react/client/Interactables.ts"],"mappings":";;;cAoBa,aAAA,oCAAa,eAAA,CAAA,YAAA"}

package/dist/react/client/Interactables.js CHANGED Viewed

@@ -1,30 +1,31 @@
 import { ModelContext } from "../../store/clients/model-context-client.js";
 import { buildInteractableModelContext } from "./interactable-model-context.js";
 import { toJSONSchema, toPartialJSONSchema } from "assistant-stream";
-import { attachTransformScopes, tapAssistantClientRef } from "@assistant-ui/store";
-import { resource, tapCallback, tapEffect, tapMemo, tapRef, tapState } from "@assistant-ui/tap";
+import { useCallback, useEffect, useMemo, useRef, useState } from "@assistant-ui/tap/react-shim";
+import { attachTransformScopes, useAssistantClientRef } from "@assistant-ui/store";
+import { resource } from "@assistant-ui/tap";
 //#region src/react/client/Interactables.ts
 const PERSISTENCE_DEBOUNCE_MS = 500;
-const Interactables = resource(() => {
-	const [state, setState] = tapState(() => ({
+const Interactables = resource(function Interactables() {
+	const [state, setState] = useState(() => ({
 		definitions: {},
 		persistence: {}
 	}));
-	const clientRef = tapAssistantClientRef();
-	const stateRef = tapRef(state);
-	tapEffect(() => {
+	const clientRef = useAssistantClientRef();
+	const stateRef = useRef(state);
+	useEffect(() => {
 		stateRef.current = state;
 	}, [state]);
-	const subscribersRef = tapRef(/* @__PURE__ */ new Set());
-	const partialSchemaCacheRef = tapRef(/* @__PURE__ */ new Map());
-	const detachedStateRef = tapRef(/* @__PURE__ */ new Map());
-	const adapterRef = tapRef(void 0);
-	const debounceTimerRef = tapRef(void 0);
-	const syncSeqRef = tapRef(0);
-	const hasPendingLocalChangeRef = tapRef(false);
-	const flushResolversRef = tapRef([]);
-	const dirtyIdsRef = tapRef(/* @__PURE__ */ new Set());
-	const runPersistence = tapCallback(async () => {
+	const subscribersRef = useRef(/* @__PURE__ */ new Set());
+	const partialSchemaCacheRef = useRef(/* @__PURE__ */ new Map());
+	const detachedStateRef = useRef(/* @__PURE__ */ new Map());
+	const adapterRef = useRef(void 0);
+	const debounceTimerRef = useRef(void 0);
+	const syncSeqRef = useRef(0);
+	const hasPendingLocalChangeRef = useRef(false);
+	const flushResolversRef = useRef([]);
+	const dirtyIdsRef = useRef(/* @__PURE__ */ new Set());
+	const runPersistence = useCallback(async () => {
 		const adapter = adapterRef.current;
 		if (!adapter) {
 			for (const resolve of flushResolversRef.current) resolve();
@@ -86,7 +87,7 @@ const Interactables = resource(() => {
 			}
 		}
 	}, []);
-	const schedulePersistence = tapCallback((id) => {
+	const schedulePersistence = useCallback((id) => {
 		if (!adapterRef.current) return;
 		dirtyIdsRef.current.add(id);
 		if (debounceTimerRef.current !== void 0) clearTimeout(debounceTimerRef.current);
@@ -99,7 +100,7 @@ const Interactables = resource(() => {
 			}, PERSISTENCE_DEBOUNCE_MS);
 		}, PERSISTENCE_DEBOUNCE_MS);
 	}, [runPersistence]);
-	const exportState = tapCallback(() => {
+	const exportState = useCallback(() => {
 		const result = {};
 		for (const [id, def] of Object.entries(stateRef.current.definitions)) result[id] = {
 			name: def.name,
@@ -107,7 +108,7 @@ const Interactables = resource(() => {
 		};
 		return result;
 	}, []);
-	const importState = tapCallback((saved) => {
+	const importState = useCallback((saved) => {
 		for (const [id, entry] of Object.entries(saved)) detachedStateRef.current.set(id, entry.state);
 		setState((prev) => {
 			let changed = false;
@@ -125,10 +126,10 @@ const Interactables = resource(() => {
 			} : prev;
 		});
 	}, []);
-	const setPersistenceAdapter = tapCallback((adapter) => {
+	const setPersistenceAdapter = useCallback((adapter) => {
 		adapterRef.current = adapter;
 	}, []);
-	const flush = tapCallback(async () => {
+	const flush = useCallback(async () => {
 		if (debounceTimerRef.current !== void 0) {
 			clearTimeout(debounceTimerRef.current);
 			debounceTimerRef.current = void 0;
@@ -141,14 +142,14 @@ const Interactables = resource(() => {
 		if (!hasPendingLocalChangeRef.current) runPersistence();
 		return p;
 	}, [runPersistence]);
-	const flushIfPending = tapCallback(() => {
+	const flushIfPending = useCallback(() => {
 		if (adapterRef.current && debounceTimerRef.current !== void 0) {
 			clearTimeout(debounceTimerRef.current);
 			debounceTimerRef.current = void 0;
 			runPersistence();
 		}
 	}, [runPersistence]);
-	const setDefState = tapCallback((id, updater) => {
+	const setDefState = useCallback((id, updater) => {
 		setState((prev) => {
 			const existing = prev.definitions[id];
 			if (!existing) return prev;
@@ -165,7 +166,7 @@ const Interactables = resource(() => {
 		});
 		if (stateRef.current.definitions[id]) schedulePersistence(id);
 	}, [schedulePersistence]);
-	const setDefSelected = tapCallback((id, selected) => {
+	const setDefSelected = useCallback((id, selected) => {
 		setState((prev) => {
 			const existing = prev.definitions[id];
 			if (!existing) return prev;
@@ -181,7 +182,7 @@ const Interactables = resource(() => {
 			};
 		});
 	}, []);
-	const provider = tapMemo(() => ({
+	const provider = useMemo(() => ({
 		getModelContext: () => {
 			const defs = stateRef.current.definitions;
 			return buildInteractableModelContext(defs, partialSchemaCacheRef.current, setDefState) ?? {};
@@ -193,15 +194,15 @@ const Interactables = resource(() => {
 			};
 		}
 	}), [setDefState]);
-	tapEffect(() => {
+	useEffect(() => {
 		for (const cb of subscribersRef.current) cb();
 	}, [state]);
-	tapEffect(() => {
+	useEffect(() => {
 		return clientRef.current.modelContext().register(provider);
 	}, [clientRef, provider]);
 	return {
 		getState: () => state,
-		register: tapCallback((def) => {
+		register: useCallback((def) => {
 			try {
 				const jsonSchema = toJSONSchema(def.stateSchema);
 				partialSchemaCacheRef.current.set(def.id, toPartialJSONSchema(jsonSchema));

package/dist/react/client/Interactables.js.map CHANGED Viewed

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

package/dist/react/client/Tools.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Tools.d.ts","names":[],"sources":["../../../src/react/client/Tools.ts"],"mappings":";;;;;;;~~AAkCA~~;;;;;;;cAAa,KAAA,GAAK,KAAA;~~EAQW~~,gFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA;kFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA"}
1	+ {"version":3,"file":"Tools.d.ts","names":[],"sources":["../../../src/react/client/Tools.ts"],"mappings":";;;;;;;AAgCA;;;;;;;cAAa,KAAA,GAAK,KAAA;EAOS,gFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA;kFAFf,OAAA;WAED,eAAA,CAAgB,oBAAA;AAAA"}

package/dist/react/client/Tools.js CHANGED Viewed

@@ -1,7 +1,8 @@
 import { ModelContext } from "../../store/clients/model-context-client.js";
-import { isStandaloneToolDisplay } from "../model-context/toolbox.js";
-import { attachTransformScopes, tapAssistantClientRef } from "@assistant-ui/store";
-import { resource, tapCallback, tapEffect, tapMemo, tapResources, tapState, withKey } from "@assistant-ui/tap";
+import { isStandaloneToolDisplay, makeToolCallTextComponent } from "../model-context/toolbox.js";
+import { useCallback, useEffect, useMemo, useState } from "@assistant-ui/tap/react-shim";
+import { attachTransformScopes, useAssistantClientRef } from "@assistant-ui/store";
+import { resource, useResources, withKey } from "@assistant-ui/tap";
 //#region src/react/client/Tools.ts
 /**
 * Registers tools with model context and installs tool-call renderers.
@@ -11,16 +12,16 @@ import { resource, tapCallback, tapEffect, tapMemo, tapResources, tapState, with
 * context, while each tool renderer is registered with the tools scope for
 * message rendering.
 */
-const Tools = resource(({ toolkit, mcpApp }) => {
-	const mcpAppOutput = tapResources(() => mcpApp ? [withKey("mcpApp", mcpApp)] : [], [mcpApp])[0];
-	const [toolUIs, setToolUIs] = tapState(() => ({}));
-	const state = tapMemo(() => ({
+const Tools = resource(function Tools({ toolkit, mcpApp }) {
+	const mcpAppOutput = useResources(() => mcpApp ? [withKey("mcpApp", mcpApp)] : [], [mcpApp])[0];
+	const [toolUIs, setToolUIs] = useState(() => ({}));
+	const state = useMemo(() => ({
 		toolUIs,
 		mcpApp: mcpAppOutput,
 		tools: Object.fromEntries(Object.entries(toolUIs).map(([name, regs]) => [name, regs.map((r) => r.render)]))
 	}), [toolUIs, mcpAppOutput]);
-	const clientRef = tapAssistantClientRef();
-	const setToolUI = tapCallback((toolName, render, options) => {
+	const clientRef = useAssistantClientRef();
+	const setToolUI = useCallback((toolName, render, options) => {
 		const registration = {
 			render,
 			standalone: options?.standalone ?? false
@@ -41,12 +42,18 @@ const Tools = resource(({ toolkit, mcpApp }) => {
 			});
 		};
 	}, []);
-	tapEffect(() => {
+	useEffect(() => {
 		if (!toolkit) return;
 		const unsubscribes = [];
-		for (const [toolName, tool] of Object.entries(toolkit)) if (tool.render) unsubscribes.push(setToolUI(toolName, tool.render, { standalone: isStandaloneToolDisplay(tool) }));
+		for (const [toolName, tool] of Object.entries(toolkit)) {
+			const toolRender = "render" in tool ? tool.render : void 0;
+			const toolRenderText = "renderText" in tool ? tool.renderText : void 0;
+			const render = toolRender ?? (toolRenderText ? makeToolCallTextComponent(toolRenderText) : void 0);
+			if (render) unsubscribes.push(setToolUI(toolName, render, { standalone: isStandaloneToolDisplay(tool) }));
+		}
 		const toolsWithoutRender = Object.entries(toolkit).reduce((acc, [name, tool]) => {
-			const { render, display, ...rest } = tool;
+			if (tool.type === "mcp") return acc;
+			const { display: _display, render: _render, renderText: _renderText, ...rest } = tool;
 			acc[name] = rest;
 			return acc;
 		}, {});

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

	@@ -1 +1 @@
1	- {"version":3,"file":"Tools.js","names":[],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import {\n ~~resource~~,\n ~~tapState~~,\n ~~tapEffect,\n tapCallback,\n tapMemo,\n tapResources,\n~~ withKey,\n type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n ~~tapAssistantClientRef~~,\n type ClientOutput,\n attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n isStandaloneToolDisplay,\n type Toolkit,\n} from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/*\n Registers tools with model context and installs tool-call renderers.\n \n Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n /\nexport const Tools = resource(\n ({\n toolkit,\n mcpApp,\n }: {\n /* Tools to expose to the model and optional renderers to install. /\n toolkit?: Toolkit;\n /* Optional MCP app resource whose tools should be merged into context. */\n mcpApp?: ResourceElement<McpAppResourceOutput> \| undefined;\n }): ClientOutput<\"tools\"> => {\n const mcpAppOutputs = ~~tapResources~~(\n () => (mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []),\n [mcpApp],\n );\n const mcpAppOutput = mcpAppOutputs[0];\n\n const [toolUIs, setToolUIs] = ~~tapState~~<ToolsState[\"toolUIs\"]>(() => ({}));\n\n const state = ~~tapMemo~~(\n (): ToolsState => ({\n toolUIs,\n mcpApp: mcpAppOutput,\n // Deprecated component-only view, derived from `toolUIs`. Removed in v0.15.\n tools: Object.fromEntries(\n Object.entries(toolUIs).map(([name, regs]) => [\n name,\n regs.map((r) => r.render),\n ]),\n ),\n }),\n [toolUIs, mcpAppOutput],\n );\n\n const clientRef = ~~tapAssistantClientRef~~();\n\n const setToolUI = ~~tapCallback~~(\n (\n toolName: string,\n render: ToolCallMessagePartComponent,\n options?: { standalone?: boolean },\n ) => {\n // One registration object per call; identity is the removal key, so\n // the per-name list stays correctly ref-counted across re-registers.\n const registration = {\n render,\n standalone: options?.standalone ?? false,\n };\n\n setToolUIs((prev) => ({\n ...prev,\n [toolName]: [...(prev[toolName] ?? []), registration],\n }));\n\n return () => {\n setToolUIs((prev) => {\n const next ~~=\n~~ prev[toolName]?.filter((r) => r !== registration) ?? [];\n if (next.length > 0) return { ...prev, [toolName]: next };\n // Drop the key entirely so repeatedly mounted/unmounted tools\n // don't leave empty arrays accumulating across a long session.\n const { [toolName]: _removed, ...rest } = prev;\n return rest;\n });\n };\n },\n [],\n );\n\n ~~tapEffect~~(() => {\n if (!toolkit) return;\n const unsubscribes: (() => void)[] = [];\n\n // Register tool UIs (exclude symbols)\n for (const [toolName, tool] of Object.entries(toolkit)) {\n if (~~tool.~~render) {\n unsubscribes.push(\n setToolUI(toolName, ~~tool.~~render, {\n standalone: isStandaloneToolDisplay(tool),\n }),\n );\n }\n }\n\n // Register tools with model context (exclude symbols). `render` and~~\n //~~ `display` are client-only presentation concerns and never reach the~~\n //~~ model.\n const toolsWithoutRender = Object.entries(toolkit).reduce(\n (acc, [name, tool]) => {\n const { render, ~~display,~~ ...rest } = tool;\n acc[name] = rest;\n return acc;\n },\n {} as Record<string, Tool<any, any>>,\n );\n\n const modelContextProvider = {\n getModelContext: () => ({\n tools: toolsWithoutRender,\n }),\n };\n\n unsubscribes.push(\n clientRef.current!.modelContext().register(modelContextProvider),\n );\n\n return () => {\n unsubscribes.forEach((fn) => fn());\n };\n }, [toolkit, setToolUI, clientRef]);\n\n return {\n getState: () => state,\n setToolUI,\n };\n }~~,\n~~);\n\nattachTransformScopes(Tools, (scopes, parent) => {\n if (!scopes.modelContext && parent.modelContext.source === null) {\n scopes.modelContext = ModelContext();\n }\n});\n"],"mappings":"~~;;;;;;;;;;;;;AAkCA~~,MAAa,QAAQ,~~UAClB~~,~~EACC~~,SACA,~~aAM2B~~;~~CAK3B~~,MAAM,eAJgB,mBACb,SAAS,CAAC,QAAQ,UAAU,MAAM,CAAC,IAAI,CAAC,GAC/C,CAAC,MAAM,CAEwB,~~EAAE~~;CAEnC,MAAM,CAAC,SAAS,cAAc,gBAAuC,CAAC,EAAE;CAExE,MAAM,QAAQ,eACO;EACjB;EACA,QAAQ;EAER,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,~~EAAE~~,KAAK,CAAC,MAAM,UAAU,CAC5C,MACA,KAAK,KAAK,MAAM,EAAE,MAAM,CAC1B,CAAC,CACH;CACF,IACA,CAAC,SAAS,YAAY,CACxB;CAEA,MAAM,YAAY,sBAAsB;CAExC,MAAM,YAAY,aAEd,UACA,QACA,YACG;EAGH,MAAM,eAAe;GACnB;GACA,YAAY,SAAS,cAAc;EACrC;EAEA,YAAY,UAAU;GACpB,GAAG;IACF,WAAW,CAAC,GAAI,KAAK,aAAa,CAAC,GAAI,YAAY;EACtD,EAAE;EAEF,aAAa;GACX,YAAY,SAAS;IACnB,MAAM,~~OACJ~~,KAAK,~~WAAW~~,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC;~~IACxD~~,IAAI,KAAK,SAAS,GAAG,OAAO;KAAE,GAAG;MAAO,WAAW;IAAK;IAGxD,MAAM,GAAG,WAAW,UAAU,GAAG,SAAS;IAC1C,OAAO;GACT,CAAC;EACH;CACF,GACA,CAAC,CACH;CAEA,gBAAgB;EACd,IAAI,CAAC,SAAS;EACd,MAAM,eAA+B,CAAC;EAGtC,KAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,OAAO,~~GACnD~~,~~IAAI~~,KAAK,~~QACP~~,aAAa,KACX,UAAU,UAAU,~~KAAK,~~QAAQ,~~EAC/B~~,YAAY,wBAAwB,IAAI,EAC1C,CAAC,CACH;~~EAOJ~~,MAAM,qBAAqB,OAAO,QAAQ,OAAO,~~EAAE~~,QAChD,KAAK,CAAC,MAAM,UAAU;GACrB,MAAM,~~EAAE~~,QAAQ,~~SAAS~~,GAAG,~~SAAS~~;~~GACrC~~,IAAI,QAAQ;GACZ,OAAO;EACT,GACA,CAAC,CACH;EAQA,aAAa,KACX,UAAU,QAAS,aAAa,~~EAAE~~,SAAS,EAN3C,wBAAwB,EACtB,OAAO,mBACT,GAI8D,CAAC,CACjE;EAEA,aAAa;GACX,aAAa,SAAS,OAAO,GAAG,CAAC;EACnC;CACF,GAAG;EAAC;EAAS;EAAW;CAAS,CAAC;CAElC,OAAO;EACL,gBAAgB;EAChB;CACF;AACF,~~CACF~~;~~AAEA~~,sBAAsB,QAAQ,QAAQ,WAAW;CAC/C,IAAI,CAAC,OAAO,gBAAgB,OAAO,aAAa,WAAW,MACzD,OAAO,eAAe,aAAa;AAEvC,CAAC"}
1	+ {"version":3,"file":"Tools.js","names":[],"sources":["../../../src/react/client/Tools.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useMemo } from \"react\";\nimport {\n useResources,\n resource,\n withKey,\n type ResourceElement,\n} from \"@assistant-ui/tap\";\nimport {\n useAssistantClientRef,\n type ClientOutput,\n attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type { McpAppResourceOutput, ToolsState } from \"../types/scopes/tools\";\nimport type { Tool } from \"assistant-stream\";\nimport {\n isStandaloneToolDisplay,\n makeToolCallTextComponent,\n type Toolkit,\n} from \"../model-context/toolbox\";\nimport type { ToolCallMessagePartComponent } from \"../types/MessagePartComponentTypes\";\nimport { ModelContext } from \"../../store\";\n\nexport type { McpAppResourceOutput };\n\n/*\n Registers tools with model context and installs tool-call renderers.\n \n Mount this resource near an assistant subtree when you want to expose a\n * group of tools declaratively. Tool definitions are registered with model\n * context, while each tool renderer is registered with the tools scope for\n * message rendering.\n /\nexport const Tools = resource(function Tools({\n toolkit,\n mcpApp,\n}: {\n /* Tools to expose to the model and optional renderers to install. /\n toolkit?: Toolkit;\n /* Optional MCP app resource whose tools should be merged into context. */\n mcpApp?: ResourceElement<McpAppResourceOutput> \| undefined;\n}): ClientOutput<\"tools\"> {\n const mcpAppOutputs = useResources(\n () => (mcpApp ? [withKey(\"mcpApp\", mcpApp)] : []),\n [mcpApp],\n );\n const mcpAppOutput = mcpAppOutputs[0];\n\n const [toolUIs, setToolUIs] = useState<ToolsState[\"toolUIs\"]>(() => ({}));\n\n const state = useMemo(\n (): ToolsState => ({\n toolUIs,\n mcpApp: mcpAppOutput,\n // Deprecated component-only view, derived from `toolUIs`. Removed in v0.15.\n tools: Object.fromEntries(\n Object.entries(toolUIs).map(([name, regs]) => [\n name,\n regs.map((r) => r.render),\n ]),\n ),\n }),\n [toolUIs, mcpAppOutput],\n );\n\n const clientRef = useAssistantClientRef();\n\n const setToolUI = useCallback(\n (\n toolName: string,\n render: ToolCallMessagePartComponent,\n options?: { standalone?: boolean },\n ) => {\n // One registration object per call; identity is the removal key, so\n // the per-name list stays correctly ref-counted across re-registers.\n const registration = {\n render,\n standalone: options?.standalone ?? false,\n };\n\n setToolUIs((prev) => ({\n ...prev,\n [toolName]: [...(prev[toolName] ?? []), registration],\n }));\n\n return () => {\n setToolUIs((prev) => {\n const next = prev[toolName]?.filter((r) => r !== registration) ?? [];\n if (next.length > 0) return { ...prev, [toolName]: next };\n // Drop the key entirely so repeatedly mounted/unmounted tools\n // don't leave empty arrays accumulating across a long session.\n const { [toolName]: _removed, ...rest } = prev;\n return rest;\n });\n };\n },\n [],\n );\n\n useEffect(() => {\n if (!toolkit) return;\n const unsubscribes: (() => void)[] = [];\n\n // Register tool UIs (exclude symbols)\n for (const [toolName, tool] of Object.entries(toolkit)) {\n const toolRender = \"render\" in tool ? tool.render : undefined;\n const toolRenderText = \"renderText\" in tool ? tool.renderText : undefined;\n const render =\n toolRender ??\n (toolRenderText\n ? makeToolCallTextComponent(toolRenderText)\n : undefined);\n if (render) {\n unsubscribes.push(\n setToolUI(toolName, render, {\n standalone: isStandaloneToolDisplay(tool),\n }),\n );\n }\n }\n\n // Register tools with model context (exclude symbols). `render`,\n // `renderText`, and `display` are client-only presentation concerns and\n // never reach the model.\n const toolsWithoutRender = Object.entries(toolkit).reduce(\n (acc, [name, tool]) => {\n if (tool.type === \"mcp\") return acc;\n const {\n display: _display,\n render: _render,\n renderText: _renderText,\n ...rest\n } = tool as typeof tool & { renderText?: unknown };\n acc[name] = rest as Tool<any, any>;\n return acc;\n },\n {} as Record<string, Tool<any, any>>,\n );\n\n const modelContextProvider = {\n getModelContext: () => ({\n tools: toolsWithoutRender,\n }),\n };\n\n unsubscribes.push(\n clientRef.current!.modelContext().register(modelContextProvider),\n );\n\n return () => {\n unsubscribes.forEach((fn) => fn());\n };\n }, [toolkit, setToolUI, clientRef]);\n\n return {\n getState: () => state,\n setToolUI,\n };\n});\n\nattachTransformScopes(Tools, (scopes, parent) => {\n if (!scopes.modelContext && parent.modelContext.source === null) {\n scopes.modelContext = ModelContext();\n }\n});\n"],"mappings":";;;;;;;;;;;;;;AAgCA,MAAa,QAAQ,SAAS,SAAS,MAAM,EAC3C,SACA,UAMwB;CAKxB,MAAM,eAJgB,mBACb,SAAS,CAAC,QAAQ,UAAU,MAAM,CAAC,IAAI,CAAC,GAC/C,CAAC,MAAM,CAEwB,CAAC,CAAC;CAEnC,MAAM,CAAC,SAAS,cAAc,gBAAuC,CAAC,EAAE;CAExE,MAAM,QAAQ,eACO;EACjB;EACA,QAAQ;EAER,OAAO,OAAO,YACZ,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,UAAU,CAC5C,MACA,KAAK,KAAK,MAAM,EAAE,MAAM,CAC1B,CAAC,CACH;CACF,IACA,CAAC,SAAS,YAAY,CACxB;CAEA,MAAM,YAAY,sBAAsB;CAExC,MAAM,YAAY,aAEd,UACA,QACA,YACG;EAGH,MAAM,eAAe;GACnB;GACA,YAAY,SAAS,cAAc;EACrC;EAEA,YAAY,UAAU;GACpB,GAAG;IACF,WAAW,CAAC,GAAI,KAAK,aAAa,CAAC,GAAI,YAAY;EACtD,EAAE;EAEF,aAAa;GACX,YAAY,SAAS;IACnB,MAAM,OAAO,KAAK,SAAS,EAAE,QAAQ,MAAM,MAAM,YAAY,KAAK,CAAC;IACnE,IAAI,KAAK,SAAS,GAAG,OAAO;KAAE,GAAG;MAAO,WAAW;IAAK;IAGxD,MAAM,GAAG,WAAW,UAAU,GAAG,SAAS;IAC1C,OAAO;GACT,CAAC;EACH;CACF,GACA,CAAC,CACH;CAEA,gBAAgB;EACd,IAAI,CAAC,SAAS;EACd,MAAM,eAA+B,CAAC;EAGtC,KAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,OAAO,GAAG;GACtD,MAAM,aAAa,YAAY,OAAO,KAAK,SAAS,KAAA;GACpD,MAAM,iBAAiB,gBAAgB,OAAO,KAAK,aAAa,KAAA;GAChE,MAAM,SACJ,eACC,iBACG,0BAA0B,cAAc,IACxC,KAAA;GACN,IAAI,QACF,aAAa,KACX,UAAU,UAAU,QAAQ,EAC1B,YAAY,wBAAwB,IAAI,EAC1C,CAAC,CACH;EAEJ;EAKA,MAAM,qBAAqB,OAAO,QAAQ,OAAO,CAAC,CAAC,QAChD,KAAK,CAAC,MAAM,UAAU;GACrB,IAAI,KAAK,SAAS,OAAO,OAAO;GAChC,MAAM,EACJ,SAAS,UACT,QAAQ,SACR,YAAY,aACZ,GAAG,SACD;GACJ,IAAI,QAAQ;GACZ,OAAO;EACT,GACA,CAAC,CACH;EAQA,aAAa,KACX,UAAU,QAAS,aAAa,CAAC,CAAC,SAAS,EAN3C,wBAAwB,EACtB,OAAO,mBACT,GAI8D,CAAC,CACjE;EAEA,aAAa;GACX,aAAa,SAAS,OAAO,GAAG,CAAC;EACnC;CACF,GAAG;EAAC;EAAS;EAAW;CAAS,CAAC;CAElC,OAAO;EACL,gBAAgB;EAChB;CACF;AACF,CAAC;AAED,sBAAsB,QAAQ,QAAQ,WAAW;CAC/C,IAAI,CAAC,OAAO,gBAAgB,OAAO,aAAa,WAAW,MACzD,OAAO,eAAe,aAAa;AAEvC,CAAC"}

package/dist/react/index.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 /// <reference path="../store/scope-registration.d.ts" />
 /// <reference path="./types/store-augmentation.d.ts" />
 import { AssistantContextConfig } from "../model-context/types.js";
+import { PartState } from "../store/scopes/part.js";
 import { AssistantProviderBase, AssistantProviderBaseProps, getRenderComponent } from "./AssistantProvider.js";
 import { AssistantRuntimeProvider } from "./AssistantRuntimeProvider.js";
 import { RuntimeAdapter } from "./RuntimeAdapter.js";
@@ -10,7 +11,7 @@ import { DataRenderers } from "./client/DataRenderers.js";
 import { Interactables } from "./client/Interactables.js";
 import { DataMessagePartComponent, DataMessagePartProps, EmptyMessagePartComponent, EmptyMessagePartProps, FileMessagePartComponent, FileMessagePartProps, GenerativeUIComponentRegistry, GenerativeUIMessagePartComponent, GenerativeUIMessagePartProps, GenerativeUIRenderProps, ImageMessagePartComponent, ImageMessagePartProps, QuoteMessagePartComponent, QuoteMessagePartProps, ReasoningGroupComponent, ReasoningGroupProps, ReasoningMessagePartComponent, ReasoningMessagePartProps, SourceMessagePartComponent, SourceMessagePartProps, TextMessagePartComponent, TextMessagePartProps, ToolCallMessagePartComponent, ToolCallMessagePartProps, Unstable_AudioMessagePartComponent, Unstable_AudioMessagePartProps } from "./types/MessagePartComponentTypes.js";
 import { McpAppResourceOutput, ToolsClientSchema, ToolsMethods, ToolsState } from "./types/scopes/tools.js";
-import { ToolDefinition, Toolkit, ToolkitDeclaration, ToolkitDeclarationDefinition } from "./model-context/toolbox.js";
+import { ToolCallText, ToolDefinition, Toolkit, ToolkitDefinition, ToolkitDefinitionEntry } from "./model-context/toolbox.js";
 import { Tools } from "./client/Tools.js";
 import { InteractableDefinition, InteractablePersistedState, InteractablePersistenceAdapter, InteractablePersistenceStatus, InteractableRegistration, InteractableStateSchema, InteractablesClientSchema, InteractablesMethods, InteractablesState } from "./types/scopes/interactables.js";
 import { AssistantToolProps, useAssistantTool } from "./model-context/useAssistantTool.js";
@@ -23,7 +24,12 @@ import { useAssistantInstructions } from "./model-context/useAssistantInstructio
 import { useAssistantContext } from "./model-context/useAssistantContext.js";
 import { useInlineRender } from "./model-context/useInlineRender.js";
 import { defineToolkit } from "./model-context/define-toolkit.js";
-import { hitl } from "./model-context/hitl.js";
+import { stubTool } from "./model-context/stub-tool.js";
+import { externalTool } from "./model-context/external-tool.js";
+import { useAuiToolOverrides } from "./model-context/useAuiToolOverrides.js";
+import { hitl, hitlTool, humanTool } from "./model-context/human-tool.js";
+import { ProviderToolConfig, providerTool } from "./model-context/provider-tool.js";
+import { McpToolkitDefinition, defineMcpToolkit } from "./model-context/define-mcp-toolkit.js";
 import { AssistantInteractableProps, useAssistantInteractable } from "./model-context/useAssistantInteractable.js";
 import { useInteractableState } from "./model-context/useInteractableState.js";
 import { ToolArgsStatus, useToolArgsStatus } from "./model-context/useToolArgsStatus.js";
@@ -42,7 +48,7 @@ import { ReadonlyThreadProvider } from "./providers/ReadonlyThreadProvider.js";
 import { RuntimeAdapterProvider, RuntimeAdapters, useRuntimeAdapters } from "./runtimes/RuntimeAdapterProvider.js";
 import { useExternalStoreRuntime } from "./runtimes/useExternalStoreRuntime.js";
 import { useExternalStoreSharedOptions } from "./runtimes/useExternalStoreSharedOptions.js";
-import { convertExternalMessages, useExternalMessageConverter } from "./runtimes/external-message-converter.js";
+import { JoinStrategy, convertExternalMessages, useExternalMessageConverter } from "./runtimes/external-message-converter.js";
 import { createMessageConverter } from "./runtimes/createMessageConverter.js";
 import { RemoteThreadListHookInstanceManager } from "./runtimes/RemoteThreadListHookInstanceManager.js";
 import { RemoteThreadListThreadListRuntimeCore } from "./runtimes/RemoteThreadListThreadListRuntimeCore.js";
@@ -50,7 +56,6 @@ import { useRemoteThreadListRuntime } from "./runtimes/useRemoteThreadListRuntim
 import { useCloudThreadListAdapter } from "./runtimes/cloud/useCloudThreadListAdapter.js";
 import { useAssistantCloudThreadHistoryAdapter } from "./runtimes/cloud/AssistantCloudThreadHistoryAdapter.js";
 import { CloudFileAttachmentAdapter } from "./runtimes/cloud/CloudFileAttachmentAdapter.js";
-import { PartState } from "../store/scopes/part.js";
 import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl } from "./primitives/thread/ThreadMessages.js";
 import { EnrichedPartState, MessagePartComponent, MessagePrimitivePartByIndex, MessagePrimitiveParts, defaultComponents } from "./primitives/message/MessageParts.js";
 import { GroupByContext, groupPartByType } from "./utils/groupParts.js";
@@ -97,4 +102,4 @@ import { useEditComposerCancel } from "./primitive-hooks/useEditComposerCancel.j
 import { useEditComposerSend } from "./primitive-hooks/useEditComposerSend.js";
 import { useMessageError } from "./primitive-hooks/useMessageError.js";
 import { LocalRuntimeOptions, splitLocalRuntimeOptions, useLocalRuntime } from "./runtimes/useLocalRuntime.js";
-export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type GroupByContext, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type LocalRuntimeOptions, type McpAppResourceOutput, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolDefinition, type Toolkit, type ToolkitDeclaration, type ToolkitDeclarationDefinition, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineToolkit, getMessageQuote, getRenderComponent, groupPartByType, hitl, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, splitLocalRuntimeOptions, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };
+export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type GroupByContext, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type JoinStrategy, type LocalRuntimeOptions, type McpAppResourceOutput, type McpToolkitDefinition, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, type ProviderToolConfig, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolCallText, type ToolDefinition, type Toolkit, type ToolkitDefinition, type ToolkitDefinitionEntry, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };

package/dist/react/index.js CHANGED Viewed

@@ -13,7 +13,12 @@ import { useAssistantInstructions } from "./model-context/useAssistantInstructio
 import { useAssistantContext } from "./model-context/useAssistantContext.js";
 import { useInlineRender } from "./model-context/useInlineRender.js";
 import { defineToolkit } from "./model-context/define-toolkit.js";
-import { hitl } from "./model-context/hitl.js";
+import { stubTool } from "./model-context/stub-tool.js";
+import { externalTool } from "./model-context/external-tool.js";
+import { useAuiToolOverrides } from "./model-context/useAuiToolOverrides.js";
+import { hitl, hitlTool, humanTool } from "./model-context/human-tool.js";
+import { providerTool } from "./model-context/provider-tool.js";
+import { defineMcpToolkit } from "./model-context/define-mcp-toolkit.js";
 import { useAssistantInteractable } from "./model-context/useAssistantInteractable.js";
 import { useInteractableState } from "./model-context/useInteractableState.js";
 import { useToolArgsStatus } from "./model-context/useToolArgsStatus.js";
@@ -88,4 +93,4 @@ import { useEditComposerCancel } from "./primitive-hooks/useEditComposerCancel.j
 import { useEditComposerSend } from "./primitive-hooks/useEditComposerSend.js";
 import { useMessageError } from "./primitive-hooks/useMessageError.js";
 import { splitLocalRuntimeOptions, useLocalRuntime } from "./runtimes/useLocalRuntime.js";
-export { AssistantProviderBase, AssistantRuntimeProvider, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, DataRenderers, GenerativeUIRender, GenerativeUIRenderError, Interactables, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, QueueItemByIndexProvider, ReadonlyThreadProvider, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, SuggestionByIndexProvider, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, Tools, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineToolkit, getMessageQuote, getRenderComponent, groupPartByType, hitl, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, splitLocalRuntimeOptions, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };
+export { AssistantProviderBase, AssistantRuntimeProvider, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, DataRenderers, GenerativeUIRender, GenerativeUIRenderError, Interactables, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, QueueItemByIndexProvider, ReadonlyThreadProvider, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, SuggestionByIndexProvider, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, Tools, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };

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

@@ -0,0 +1,12 @@
+import { Toolkit } from "./toolbox.js";
+import { McpServerConfig } from "assistant-stream";
+//#region src/react/model-context/define-mcp-toolkit.d.ts
+type McpToolkitDefinition = Record<string, McpServerConfig>;
+/**
+ * Defines MCP server tools as a spreadable toolkit fragment.
+ */
+declare function defineMcpToolkit(definition: McpToolkitDefinition): Toolkit;
+//#endregion
+export { McpToolkitDefinition, defineMcpToolkit };
+//# sourceMappingURL=define-mcp-toolkit.d.ts.map

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

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"define-mcp-toolkit.d.ts","names":[],"sources":["../../../src/react/model-context/define-mcp-toolkit.ts"],"mappings":";;;;KAGY,oBAAA,GAAuB,MAAM,SAAS,eAAA;;AAAlD;;iBAKgB,gBAAA,CAAiB,UAAA,EAAY,oBAAA,GAAuB,OAAO"}