@assistant-ui/store 0.2.10 → 0.2.12

package/dist/useAui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAui.d.ts","sourceRoot":"","sources":["../src/useAui.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EACX,aAAa,EAEd,0BAAuB;AACxB,OAAO,KAAK,EAAW,cAAc,EAAE,qBAAkB;AA2QzD;;GAEG;AACH,eAAO,MAAM,uBAAuB;YAKxB,eAAe;aACd,MAAM,CAAC,KAAK;;YADb,eAAe;aACd,MAAM,CAAC,KAAK;EAwDxB,CAAC;AAEF,yBAAiB,MAAM,CAAC;IACtB,KAAY,KAAK,GAAG;SACjB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;KAC1D,CAAC;CACH;AAED,wBAAgB,MAAM,IAAI,eAAe,CAAC;AAC1C,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC;AAC/D,wBAAgB,MAAM,CACpB,OAAO,EAAE,MAAM,CAAC,KAAK,EACrB,MAAM,EAAE;IAAE,MAAM,EAAE,IAAI,GAAG,eAAe,CAAA;CAAE,GACzC,eAAe,CAAC"}
+{"version":3,"file":"useAui.d.ts","names":[],"sources":["../src/useAui.ts"],"mappings":";;;;;;AA6SA;cAAa,uBAAA,GAAuB,KAAA;UAKxB,eAAA;WACC,MAAA,CAAO,KAAA;AAAA;UADR,eAAA;WACC,MAAA,CAAO,KAAA;AAAA;AAAA,kBA0DH,MAAA;EAAA,KACH,KAAA,WACJ,WAAA,IAAe,aAAA,CAAc,CAAA,IAAK,cAAA,CAAe,CAAA;AAAA;;;;;;;;;;;;AA5DlC;AA0DzB;;;;;;;;;;;;;;;;;;AAE4D;AAuC5D;;;;iBAAgB,MAAA,CAAA,GAAU,eAAe;AAsBzC;;;;;;;;;AAA8D;AAI9D;;;;;;;;;;;AAJA,iBAAgB,MAAA,CAAO,OAAA,EAAS,MAAA,CAAO,KAAA,GAAQ,eAAe;;;;iBAI9C,MAAA,CACd,OAAA,EAAS,MAAA,CAAO,KAAA,EAChB,MAAA;EAAU,MAAA,SAAe,eAAA;AAAA,IACxB,eAAA"}

package/dist/useAui.js

@@ -1,192 +1,195 @@
 "use client";
-import { useResource } from "@assistant-ui/tap/react";
-import { resource, tapMemo, tapResources, tapEffectEvent, tapEffect, tapRef, tapResource, withKey, tapResourceRoot, } from "@assistant-ui/tap";
-import { useAssistantContextValue, DefaultAssistantClient, createRootAssistantClient, } from "./utils/react-assistant-context.js";
-import { tapSplitClients, } from "./utils/splitClients.js";
-import { normalizeEventSelector, } from "./types/events.js";
+import { getClientIndex } from "./utils/tap-client-stack-context.js";
+import { tapClientResource } from "./tapClientResource.js";
+import { PROXIED_ASSISTANT_STATE_SYMBOL, createProxiedAssistantState } from "./utils/proxied-assistant-state.js";
+import { DefaultAssistantClient, createRootAssistantClient, useAssistantContextValue } from "./utils/react-assistant-context.js";
+import { tapSplitClients } from "./utils/splitClients.js";
+import { normalizeEventSelector } from "./types/events.js";
 import { NotificationManager } from "./utils/NotificationManager.js";
 import { withAssistantTapContextProvider } from "./utils/tap-assistant-context.js";
-import { tapClientResource } from "./tapClientResource.js";
-import { getClientIndex } from "./utils/tap-client-stack-context.js";
-import { PROXIED_ASSISTANT_STATE_SYMBOL, createProxiedAssistantState, } from "./utils/proxied-assistant-state.js";
+import { useResource } from "@assistant-ui/tap/react";
+import { resource, tapEffect, tapMemo, tapRef, tapResource, tapResourceRoot, tapResources, withKey } from "@assistant-ui/tap";
+//#region src/useAui.ts
 const tapShallowMemoArray = (array) => {
-    // biome-ignore lint/correctness/useExhaustiveDependencies: shallow memo
-    return tapMemo(() => array, array);
+	return tapMemo(() => array, array);
 };
-const RootClientResource = resource(({ element, emit, clientRef, }) => {
-    const { methods, state } = withAssistantTapContextProvider({ clientRef, emit }, () => tapClientResource(element));
-    return tapMemo(() => ({ state, methods }), [methods, state]);
+const RootClientResource = resource(({ element, emit, clientRef }) => {
+	const { methods, state } = withAssistantTapContextProvider({
+		clientRef,
+		emit
+	}, () => tapClientResource(element));
+	return tapMemo(() => ({
+		state,
+		methods
+	}), [methods, state]);
 });
-const RootClientAccessorResource = resource(({ element, notifications, clientRef, name, }) => {
-    const store = tapResourceRoot(RootClientResource({ element, emit: notifications.emit, clientRef }));
-    tapEffect(() => {
-        return store.subscribe(notifications.notifySubscribers);
-    }, [store, notifications]);
-    return tapMemo(() => {
-        const clientFunction = () => store.getValue().methods;
-        Object.defineProperties(clientFunction, {
-            source: {
-                value: "root",
-                writable: false,
-            },
-            query: {
-                value: {},
-                writable: false,
-            },
-            name: {
-                value: name,
-                configurable: true,
-            },
-        });
-        return clientFunction;
-    }, [store, name]);
+const RootClientAccessorResource = resource(({ element, notifications, clientRef, name }) => {
+	const store = tapResourceRoot(RootClientResource({
+		element,
+		emit: notifications.emit,
+		clientRef
+	}));
+	tapEffect(() => {
+		return store.subscribe(notifications.notifySubscribers);
+	}, [store, notifications]);
+	return tapMemo(() => {
+		const clientFunction = () => store.getValue().methods;
+		Object.defineProperties(clientFunction, {
+			source: {
+				value: "root",
+				writable: false
+			},
+			query: {
+				value: {},
+				writable: false
+			},
+			name: {
+				value: name,
+				configurable: true
+			}
+		});
+		return clientFunction;
+	}, [store, name]);
 });
 const NoOpRootClientsAccessorsResource = resource(() => {
-    return tapMemo(() => ({
-        clients: [],
-        subscribe: undefined,
-        on: undefined,
-    }), []);
+	return tapMemo(() => ({
+		clients: [],
+		subscribe: void 0,
+		on: void 0
+	}), []);
 });
-const RootClientsAccessorsResource = resource(({ clients: inputClients, clientRef, }) => {
-    const notifications = tapResource(NotificationManager());
-    tapEffect(() => clientRef.parent.subscribe(notifications.notifySubscribers), [clientRef, notifications]);
-    const results = tapShallowMemoArray(tapResources(() => Object.keys(inputClients).map((key) => withKey(key, RootClientAccessorResource({
-        element: inputClients[key],
-        notifications,
-        clientRef,
-        name: key,
-    }))), [inputClients, notifications, clientRef]));
-    return tapMemo(() => {
-        return {
-            clients: results,
-            subscribe: notifications.subscribe,
-            on: function (selector, callback) {
-                if (!this) {
-                    throw new Error("const { on } = useAui() is not supported. Use aui.on() instead.");
-                }
-                const { scope, event } = normalizeEventSelector(selector);
-                if (scope !== "*") {
-                    const source = this[scope].source;
-                    if (source === null) {
-                        throw new Error(`Scope "${scope}" is not available. Use { scope: "*", event: "${event}" } to listen globally.`);
-                    }
-                }
-                const localUnsub = notifications.on(event, (payload, clientStack) => {
-                    if (scope === "*") {
-                        callback(payload);
-                        return;
-                    }
-                    const scopeClient = this[scope]();
-                    const index = getClientIndex(scopeClient);
-                    if (scopeClient === clientStack[index]) {
-                        callback(payload);
-                    }
-                });
-                if (scope !== "*" &&
-                    clientRef.parent[scope].source === null)
-                    return localUnsub;
-                const parentUnsub = clientRef.parent.on(selector, callback);
-                return () => {
-                    localUnsub();
-                    parentUnsub();
-                };
-            },
-        };
-    }, [results, notifications, clientRef]);
+const RootClientsAccessorsResource = resource(({ clients: inputClients, clientRef }) => {
+	const notifications = tapResource(NotificationManager());
+	tapEffect(() => clientRef.parent.subscribe(notifications.notifySubscribers), [clientRef, notifications]);
+	const results = tapShallowMemoArray(tapResources(() => Object.keys(inputClients).map((key) => withKey(key, RootClientAccessorResource({
+		element: inputClients[key],
+		notifications,
+		clientRef,
+		name: key
+	}))), [
+		inputClients,
+		notifications,
+		clientRef
+	]));
+	return tapMemo(() => {
+		return {
+			clients: results,
+			subscribe: notifications.subscribe,
+			on: function(selector, callback) {
+				if (!this) throw new Error("const { on } = useAui() is not supported. Use aui.on() instead.");
+				const { scope, event } = normalizeEventSelector(selector);
+				if (scope !== "*") {
+					if (this[scope].source === null) throw new Error(`Scope "${scope}" is not available. Use { scope: "*", event: "${event}" } to listen globally.`);
+				}
+				const localUnsub = notifications.on(event, (payload, clientStack) => {
+					if (scope === "*") {
+						callback(payload);
+						return;
+					}
+					const scopeClient = this[scope]();
+					if (scopeClient === clientStack[getClientIndex(scopeClient)]) callback(payload);
+				});
+				if (scope !== "*" && clientRef.parent[scope].source === null) return localUnsub;
+				const parentUnsub = clientRef.parent.on(selector, callback);
+				return () => {
+					localUnsub();
+					parentUnsub();
+				};
+			}
+		};
+	}, [
+		results,
+		notifications,
+		clientRef
+	]);
 });
-const getMeta = (props, clientRef, memo) => {
-    if ("source" in props && "query" in props)
-        return props;
-    if (memo.dep === props)
-        return memo.meta;
-    const meta = props.getMeta(clientRef.current);
-    memo.meta = meta;
-    memo.dep = props;
-    return meta;
-};
-const DerivedClientAccessorResource = resource(({ element, clientRef, name, }) => {
-    const get = tapEffectEvent(() => element.props);
-    return tapMemo(() => {
-        const clientFunction = () => get().get(clientRef.current);
-        const metaMemo = {};
-        Object.defineProperties(clientFunction, {
-            source: {
-                get: () => getMeta(get(), clientRef, metaMemo).source,
-            },
-            query: {
-                get: () => getMeta(get(), clientRef, metaMemo).query,
-            },
-            name: {
-                value: name,
-                configurable: true,
-            },
-        });
-        return clientFunction;
-    }, [clientRef, name]);
+const DerivedClientAccessorResource = resource(({ element, clientRef, name }) => {
+	const propsRef = tapRef(element.props);
+	propsRef.current = element.props;
+	return tapMemo(() => {
+		const clientFunction = () => propsRef.current.get(clientRef.current);
+		Object.defineProperties(clientFunction, {
+			source: { value: propsRef.current.source },
+			query: { value: propsRef.current.query },
+			name: {
+				value: name,
+				configurable: true
+			}
+		});
+		return clientFunction;
+	}, [clientRef, name]);
 });
-const DerivedClientsAccessorsResource = resource(({ clients, clientRef, }) => {
-    return tapShallowMemoArray(tapResources(() => Object.keys(clients).map((key) => withKey(key, DerivedClientAccessorResource({
-        element: clients[key],
-        clientRef,
-        name: key,
-    }))), [clients, clientRef]));
+const serializeMeta = (name, meta) => {
+	let queryKey;
+	try {
+		const sorted = {};
+		for (const k of Object.keys(meta.query).sort()) sorted[k] = meta.query[k];
+		queryKey = JSON.stringify(sorted);
+	} catch {
+		queryKey = String(meta.query);
+	}
+	return `${name}::${meta.source}::${queryKey}`;
+};
+const DerivedClientsAccessorsResource = resource(({ clients, clientRef }) => {
+	return tapShallowMemoArray(tapResources(() => Object.keys(clients).map((key) => {
+		const name = key;
+		const element = clients[name];
+		return withKey(serializeMeta(name, element.props), DerivedClientAccessorResource({
+			element,
+			clientRef,
+			name
+		}));
+	}), [clients, clientRef]));
 });
 /**
- * Resource that creates an extended AssistantClient.
- */
-export const AssistantClientResource = resource(({ parent, clients, }) => {
-    const { rootClients, derivedClients } = tapSplitClients(clients, parent);
-    const clientRef = tapRef({
-        parent: parent,
-        current: null,
-    }).current;
-    tapEffect(() => {
-        // if (clientRef.current && clientRef.current !== client)
-        //   throw new Error("clientRef.current !== client");
-        clientRef.current = client;
-    });
-    const rootFields = tapResource(Object.keys(rootClients).length > 0
-        ? RootClientsAccessorsResource({ clients: rootClients, clientRef })
-        : NoOpRootClientsAccessorsResource());
-    const derivedFields = tapResource(DerivedClientsAccessorsResource({ clients: derivedClients, clientRef }));
-    const client = tapMemo(() => {
-        // Swap DefaultAssistantClient -> createRootAssistantClient at root to change error message
-        const proto = parent === DefaultAssistantClient
-            ? createRootAssistantClient()
-            : parent;
-        const client = Object.create(proto);
-        Object.assign(client, {
-            subscribe: rootFields.subscribe ?? parent.subscribe,
-            on: rootFields.on ?? parent.on,
-            [PROXIED_ASSISTANT_STATE_SYMBOL]: createProxiedAssistantState(client),
-        });
-        for (const field of rootFields.clients) {
-            client[field.name] = field;
-        }
-        for (const field of derivedFields) {
-            client[field.name] = field;
-        }
-        return client;
-    }, [parent, rootFields, derivedFields]);
-    if (clientRef.current === null) {
-        clientRef.current = client;
-    }
-    return client;
+* Resource that creates an extended AssistantClient.
+*/
+const AssistantClientResource = resource(({ parent, clients }) => {
+	const { rootClients, derivedClients } = tapSplitClients(clients, parent);
+	const clientRef = tapRef({
+		parent,
+		current: null
+	}).current;
+	tapEffect(() => {
+		clientRef.current = client;
+	});
+	const rootFields = tapResource(Object.keys(rootClients).length > 0 ? RootClientsAccessorsResource({
+		clients: rootClients,
+		clientRef
+	}) : NoOpRootClientsAccessorsResource());
+	const derivedFields = tapResource(DerivedClientsAccessorsResource({
+		clients: derivedClients,
+		clientRef
+	}));
+	const client = tapMemo(() => {
+		const proto = parent === DefaultAssistantClient ? createRootAssistantClient() : parent;
+		const client = Object.create(proto);
+		Object.assign(client, {
+			subscribe: rootFields.subscribe ?? parent.subscribe,
+			on: rootFields.on ?? parent.on,
+			[PROXIED_ASSISTANT_STATE_SYMBOL]: createProxiedAssistantState(client)
+		});
+		for (const field of rootFields.clients) client[field.name] = field;
+		for (const field of derivedFields) client[field.name] = field;
+		return client;
+	}, [
+		parent,
+		rootFields,
+		derivedFields
+	]);
+	if (clientRef.current === null) clientRef.current = client;
+	return client;
 });
 /** @deprecated This API is highly experimental and may be changed in a minor release */
-export function useAui(clients, { parent } = {
-    parent: useAssistantContextValue(),
-}) {
-    if (clients) {
-        // biome-ignore lint/correctness/useHookAtTopLevel: intentional conditional/nested hook usage
-        return useResource(AssistantClientResource({
-            parent: parent ?? DefaultAssistantClient,
-            clients,
-        }));
-    }
-    if (parent === null)
-        throw new Error("received null parent, this usage is not allowed");
-    return parent;
+function useAui(clients, { parent } = { parent: useAssistantContextValue() }) {
+	if (clients) return useResource(AssistantClientResource({
+		parent: parent ?? DefaultAssistantClient,
+		clients
+	}));
+	if (parent === null) throw new Error("received null parent, this usage is not allowed");
+	return parent;
 }
+//#endregion
+export { AssistantClientResource, useAui };
+
 //# sourceMappingURL=useAui.js.map

package/dist/useAui.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAui.js","sourceRoot":"","sources":["../src/useAui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useAui.js","names":[],"sources":["../src/useAui.ts"],"sourcesContent":["\"use client\";\n\nimport { useResource } from \"@assistant-ui/tap/react\";\nimport {\n  resource,\n  tapMemo,\n  tapResources,\n  tapEffect,\n  tapRef,\n  tapResource,\n  withKey,\n  tapResourceRoot,\n} from \"@assistant-ui/tap\";\nimport type {\n  AssistantClient,\n  AssistantClientAccessor,\n  ClientNames,\n  ClientElement,\n  ClientMeta,\n} from \"./types/client\";\nimport type { DerivedElement } from \"./Derived\";\nimport {\n  useAssistantContextValue,\n  DefaultAssistantClient,\n  createRootAssistantClient,\n} from \"./utils/react-assistant-context\";\nimport {\n  type DerivedClients,\n  type RootClients,\n  tapSplitClients,\n} from \"./utils/splitClients\";\nimport {\n  normalizeEventSelector,\n  type AssistantEventName,\n  type AssistantEventCallback,\n  type AssistantEventSelector,\n} from \"./types/events\";\nimport { NotificationManager } from \"./utils/NotificationManager\";\nimport { withAssistantTapContextProvider } from \"./utils/tap-assistant-context\";\nimport { tapClientResource } from \"./tapClientResource\";\nimport { getClientIndex } from \"./utils/tap-client-stack-context\";\nimport {\n  PROXIED_ASSISTANT_STATE_SYMBOL,\n  createProxiedAssistantState,\n} from \"./utils/proxied-assistant-state\";\n\nconst tapShallowMemoArray = <T>(array: readonly T[]) => {\n  // biome-ignore lint/correctness/useExhaustiveDependencies: shallow memo\n  return tapMemo(() => array, array);\n};\n\nconst RootClientResource = resource(\n  <K extends ClientNames>({\n    element,\n    emit,\n    clientRef,\n  }: {\n    element: ClientElement<K>;\n    emit: NotificationManager[\"emit\"];\n    clientRef: { parent: AssistantClient; current: AssistantClient | null };\n  }) => {\n    const { methods, state } = withAssistantTapContextProvider(\n      { clientRef, emit },\n      () => tapClientResource(element),\n    );\n    return tapMemo(() => ({ state, methods }), [methods, state]);\n  },\n);\n\nconst RootClientAccessorResource = resource(\n  <K extends ClientNames>({\n    element,\n    notifications,\n    clientRef,\n    name,\n  }: {\n    element: ClientElement<K>;\n    notifications: NotificationManager;\n    clientRef: { parent: AssistantClient; current: AssistantClient | null };\n    name: K;\n  }): AssistantClientAccessor<K> => {\n    const store = tapResourceRoot(\n      RootClientResource({ element, emit: notifications.emit, clientRef }),\n    );\n\n    tapEffect(() => {\n      return store.subscribe(notifications.notifySubscribers);\n    }, [store, notifications]);\n\n    return tapMemo(() => {\n      const clientFunction = () => store.getValue().methods;\n      Object.defineProperties(clientFunction, {\n        source: {\n          value: \"root\" as const,\n          writable: false,\n        },\n        query: {\n          value: {} as Record<string, never>,\n          writable: false,\n        },\n        name: {\n          value: name,\n          configurable: true,\n        },\n      });\n      return clientFunction as AssistantClientAccessor<K>;\n    }, [store, name]);\n  },\n);\n\nconst NoOpRootClientsAccessorsResource = resource(() => {\n  return tapMemo(\n    () => ({\n      clients: [] as AssistantClientAccessor<ClientNames>[],\n      subscribe: undefined,\n      on: undefined,\n    }),\n    [],\n  );\n});\n\nconst RootClientsAccessorsResource = resource(\n  ({\n    clients: inputClients,\n    clientRef,\n  }: {\n    clients: RootClients;\n    clientRef: { parent: AssistantClient; current: AssistantClient | null };\n  }) => {\n    const notifications = tapResource(NotificationManager());\n\n    tapEffect(\n      () => clientRef.parent.subscribe(notifications.notifySubscribers),\n      [clientRef, notifications],\n    );\n\n    const results = tapShallowMemoArray(\n      tapResources(\n        () =>\n          Object.keys(inputClients).map((key) =>\n            withKey(\n              key,\n              RootClientAccessorResource({\n                element: inputClients[key as keyof typeof inputClients]!,\n                notifications,\n                clientRef,\n                name: key as keyof typeof inputClients,\n              }),\n            ),\n          ),\n        [inputClients, notifications, clientRef],\n      ),\n    );\n\n    return tapMemo(() => {\n      return {\n        clients: results,\n        subscribe: notifications.subscribe,\n        on: function <TEvent extends AssistantEventName>(\n          this: AssistantClient,\n          selector: AssistantEventSelector<TEvent>,\n          callback: AssistantEventCallback<TEvent>,\n        ) {\n          if (!this) {\n            throw new Error(\n              \"const { on } = useAui() is not supported. Use aui.on() instead.\",\n            );\n          }\n\n          const { scope, event } = normalizeEventSelector(selector);\n\n          if (scope !== \"*\") {\n            const source = this[scope as ClientNames].source;\n            if (source === null) {\n              throw new Error(\n                `Scope \"${scope}\" is not available. Use { scope: \"*\", event: \"${event}\" } to listen globally.`,\n              );\n            }\n          }\n\n          const localUnsub = notifications.on(event, (payload, clientStack) => {\n            if (scope === \"*\") {\n              callback(payload);\n              return;\n            }\n\n            const scopeClient = this[scope as ClientNames]();\n            const index = getClientIndex(scopeClient);\n            if (scopeClient === clientStack[index]) {\n              callback(payload);\n            }\n          });\n          if (\n            scope !== \"*\" &&\n            clientRef.parent[scope as ClientNames].source === null\n          )\n            return localUnsub;\n\n          const parentUnsub = clientRef.parent.on(selector, callback);\n\n          return () => {\n            localUnsub();\n            parentUnsub();\n          };\n        },\n      };\n    }, [results, notifications, clientRef]);\n  },\n);\n\nconst DerivedClientAccessorResource = resource(\n  <K extends ClientNames>({\n    element,\n    clientRef,\n    name,\n  }: {\n    element: DerivedElement<K>;\n    clientRef: { parent: AssistantClient; current: AssistantClient | null };\n    name: K;\n  }) => {\n    // Track the latest props on a ref updated in render. The fiber is\n    // keyed on the scope's meta by DerivedClientsAccessorsResource, so\n    // source/query are stable for this fiber's lifetime and the only\n    // value that can change between renders for the same fiber is the\n    // identity of the `get` closure. Routing reads through the ref\n    // avoids the one-commit lag that the previous `tapEffectEvent`\n    // path imposed.\n    const propsRef = tapRef(element.props);\n    propsRef.current = element.props;\n\n    return tapMemo(() => {\n      const clientFunction = () => propsRef.current.get(clientRef.current!);\n      Object.defineProperties(clientFunction, {\n        source: {\n          value: propsRef.current.source,\n        },\n        query: {\n          value: propsRef.current.query,\n        },\n        name: {\n          value: name,\n          configurable: true,\n        },\n      });\n      return clientFunction as AssistantClientAccessor<K>;\n    }, [clientRef, name]);\n  },\n);\n\nconst serializeMeta = <K extends ClientNames>(\n  name: K,\n  meta: ClientMeta<K>,\n): string => {\n  // Sort top-level keys so {a, b} and {b, a} hash to the same fiber\n  // identity, and guard JSON.stringify against unusual values (BigInt,\n  // circular refs) so render never throws here.\n  let queryKey: string;\n  try {\n    const sorted: Record<string, unknown> = {};\n    for (const k of Object.keys(meta.query as object).sort()) {\n      sorted[k] = (meta.query as Record<string, unknown>)[k];\n    }\n    queryKey = JSON.stringify(sorted);\n  } catch {\n    queryKey = String(meta.query);\n  }\n  return `${name}::${meta.source}::${queryKey}`;\n};\n\nconst DerivedClientsAccessorsResource = resource(\n  ({\n    clients,\n    clientRef,\n  }: {\n    clients: DerivedClients;\n    clientRef: { parent: AssistantClient; current: AssistantClient | null };\n  }) => {\n    return tapShallowMemoArray(\n      tapResources(\n        () =>\n          Object.keys(clients).map((key) => {\n            const name = key as keyof typeof clients;\n            const element = clients[name]!;\n            return withKey(\n              serializeMeta(name, element.props),\n              DerivedClientAccessorResource({\n                element,\n                clientRef,\n                name,\n              }),\n            );\n          }),\n        [clients, clientRef],\n      ),\n    );\n  },\n);\n\n/**\n * Resource that creates an extended AssistantClient.\n */\nexport const AssistantClientResource = resource(\n  ({\n    parent,\n    clients,\n  }: {\n    parent: AssistantClient;\n    clients: useAui.Props;\n  }): AssistantClient => {\n    const { rootClients, derivedClients } = tapSplitClients(clients, parent);\n\n    const clientRef = tapRef({\n      parent: parent,\n      current: null as AssistantClient | null,\n    }).current;\n\n    tapEffect(() => {\n      // if (clientRef.current && clientRef.current !== client)\n      //   throw new Error(\"clientRef.current !== client\");\n\n      clientRef.current = client;\n    });\n\n    const rootFields = tapResource(\n      Object.keys(rootClients).length > 0\n        ? RootClientsAccessorsResource({ clients: rootClients, clientRef })\n        : NoOpRootClientsAccessorsResource(),\n    );\n\n    const derivedFields = tapResource(\n      DerivedClientsAccessorsResource({ clients: derivedClients, clientRef }),\n    );\n\n    const client = tapMemo(() => {\n      // Swap DefaultAssistantClient -> createRootAssistantClient at root to change error message\n      const proto =\n        parent === DefaultAssistantClient\n          ? createRootAssistantClient()\n          : parent;\n\n      const client = Object.create(proto) as AssistantClient;\n      Object.assign(client, {\n        subscribe: rootFields.subscribe ?? parent.subscribe,\n        on: rootFields.on ?? parent.on,\n        [PROXIED_ASSISTANT_STATE_SYMBOL]: createProxiedAssistantState(client),\n      });\n\n      for (const field of rootFields.clients) {\n        (client as any)[field.name] = field;\n      }\n      for (const field of derivedFields) {\n        (client as any)[field.name] = field;\n      }\n\n      return client;\n    }, [parent, rootFields, derivedFields]);\n\n    if (clientRef.current === null) {\n      clientRef.current = client;\n    }\n\n    return client;\n  },\n);\n\nexport namespace useAui {\n  export type Props = {\n    [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;\n  };\n}\n\n/**\n * Returns the current `AssistantClient` from context.\n *\n * Read the client supplied by the nearest {@link AuiProvider} or\n * {@link AssistantRuntimeProvider}, then access a scope on it —\n * `aui.thread()`, `aui.composer()`, `aui.message()`, and so on. Pair\n * with {@link useAuiState} to read reactive state and {@link useAuiEvent}\n * to subscribe to events. The returned client also exposes lower-level\n * methods such as `aui.on(...)` and `aui.subscribe(...)`; prefer\n * `useAuiEvent` for React event subscriptions.\n *\n * Rendered outside a provider, the returned client's scope accessors\n * throw a descriptive error whenever they are called.\n *\n * @example\n * ```tsx\n * const aui = useAui();\n *\n * const onSend = () => aui.composer().send();\n * const onCancel = () => aui.thread().cancelRun();\n * ```\n *\n * @example\n * ```tsx\n * // Combine with useAuiState to drive disabled state.\n * const aui = useAui();\n * const isRunning = useAuiState((s) => s.thread.isRunning);\n *\n * return (\n *   <button disabled={isRunning} onClick={() => aui.composer().send()}>\n *     Send\n *   </button>\n * );\n * ```\n */\nexport function useAui(): AssistantClient;\n/**\n * Extends the parent `AssistantClient` with additional scopes.\n *\n * Advanced overload used when building primitives or providers — for example,\n * when a custom provider needs to register a `message`, `part`, or other scope\n * onto the client visible to its descendants. Application code rarely reaches\n * for this; use {@link useAui} with no arguments to read the existing client.\n *\n * @example\n * ```tsx\n * const aui = useAui({\n *   message: Derived({\n *     source: \"thread\",\n *     query: { index: 0 },\n *     get: (aui) => aui.thread().message({ index: 0 }),\n *   }),\n * });\n *\n * const role = useAuiState((s) => s.message.role);\n * ```\n */\nexport function useAui(clients: useAui.Props): AssistantClient;\n/**\n * Extends an explicit parent `AssistantClient` with additional scopes.\n */\nexport function useAui(\n  clients: useAui.Props,\n  config: { parent: null | AssistantClient },\n): AssistantClient;\n/** @deprecated This API is highly experimental and may be changed in a minor release */\nexport function useAui(\n  clients?: useAui.Props,\n  { parent }: { parent: null | AssistantClient } = {\n    parent: useAssistantContextValue(),\n  },\n): AssistantClient {\n  if (clients) {\n    // biome-ignore lint/correctness/useHookAtTopLevel: intentional conditional/nested hook usage\n    return useResource(\n      AssistantClientResource({\n        parent: parent ?? DefaultAssistantClient,\n        clients,\n      }),\n    );\n  }\n  if (parent === null)\n    throw new Error(\"received null parent, this usage is not allowed\");\n  return parent;\n}\n"],"mappings":";;;;;;;;;;;;AA8CA,MAAM,uBAA0B,UAAwB;CAEtD,OAAO,cAAc,OAAO,KAAK;AACnC;AAEA,MAAM,qBAAqB,UACD,EACtB,SACA,MACA,gBAKI;CACJ,MAAM,EAAE,SAAS,UAAU,gCACzB;EAAE;EAAW;CAAK,SACZ,kBAAkB,OAAO,CACjC;CACA,OAAO,eAAe;EAAE;EAAO;CAAQ,IAAI,CAAC,SAAS,KAAK,CAAC;AAC7D,CACF;AAEA,MAAM,6BAA6B,UACT,EACtB,SACA,eACA,WACA,WAMgC;CAChC,MAAM,QAAQ,gBACZ,mBAAmB;EAAE;EAAS,MAAM,cAAc;EAAM;CAAU,CAAC,CACrE;CAEA,gBAAgB;EACd,OAAO,MAAM,UAAU,cAAc,iBAAiB;CACxD,GAAG,CAAC,OAAO,aAAa,CAAC;CAEzB,OAAO,cAAc;EACnB,MAAM,uBAAuB,MAAM,SAAS,EAAE;EAC9C,OAAO,iBAAiB,gBAAgB;GACtC,QAAQ;IACN,OAAO;IACP,UAAU;GACZ;GACA,OAAO;IACL,OAAO,CAAC;IACR,UAAU;GACZ;GACA,MAAM;IACJ,OAAO;IACP,cAAc;GAChB;EACF,CAAC;EACD,OAAO;CACT,GAAG,CAAC,OAAO,IAAI,CAAC;AAClB,CACF;AAEA,MAAM,mCAAmC,eAAe;CACtD,OAAO,eACE;EACL,SAAS,CAAC;EACV,WAAW,KAAA;EACX,IAAI,KAAA;CACN,IACA,CAAC,CACH;AACF,CAAC;AAED,MAAM,+BAA+B,UAClC,EACC,SAAS,cACT,gBAII;CACJ,MAAM,gBAAgB,YAAY,oBAAoB,CAAC;CAEvD,gBACQ,UAAU,OAAO,UAAU,cAAc,iBAAiB,GAChE,CAAC,WAAW,aAAa,CAC3B;CAEA,MAAM,UAAU,oBACd,mBAEI,OAAO,KAAK,YAAY,EAAE,KAAK,QAC7B,QACE,KACA,2BAA2B;EACzB,SAAS,aAAa;EACtB;EACA;EACA,MAAM;CACR,CAAC,CACH,CACF,GACF;EAAC;EAAc;EAAe;CAAS,CACzC,CACF;CAEA,OAAO,cAAc;EACnB,OAAO;GACL,SAAS;GACT,WAAW,cAAc;GACzB,IAAI,SAEF,UACA,UACA;IACA,IAAI,CAAC,MACH,MAAM,IAAI,MACR,iEACF;IAGF,MAAM,EAAE,OAAO,UAAU,uBAAuB,QAAQ;IAExD,IAAI,UAAU;SACG,KAAK,OAAsB,WAC3B,MACb,MAAM,IAAI,MACR,UAAU,MAAM,gDAAgD,MAAM,wBACxE;IAAA;IAIJ,MAAM,aAAa,cAAc,GAAG,QAAQ,SAAS,gBAAgB;KACnE,IAAI,UAAU,KAAK;MACjB,SAAS,OAAO;MAChB;KACF;KAEA,MAAM,cAAc,KAAK,OAAsB;KAE/C,IAAI,gBAAgB,YADN,eAAe,WACO,IAClC,SAAS,OAAO;IAEpB,CAAC;IACD,IACE,UAAU,OACV,UAAU,OAAO,OAAsB,WAAW,MAElD,OAAO;IAET,MAAM,cAAc,UAAU,OAAO,GAAG,UAAU,QAAQ;IAE1D,aAAa;KACX,WAAW;KACX,YAAY;IACd;GACF;EACF;CACF,GAAG;EAAC;EAAS;EAAe;CAAS,CAAC;AACxC,CACF;AAEA,MAAM,gCAAgC,UACZ,EACtB,SACA,WACA,WAKI;CAQJ,MAAM,WAAW,OAAO,QAAQ,KAAK;CACrC,SAAS,UAAU,QAAQ;CAE3B,OAAO,cAAc;EACnB,MAAM,uBAAuB,SAAS,QAAQ,IAAI,UAAU,OAAQ;EACpE,OAAO,iBAAiB,gBAAgB;GACtC,QAAQ,EACN,OAAO,SAAS,QAAQ,OAC1B;GACA,OAAO,EACL,OAAO,SAAS,QAAQ,MAC1B;GACA,MAAM;IACJ,OAAO;IACP,cAAc;GAChB;EACF,CAAC;EACD,OAAO;CACT,GAAG,CAAC,WAAW,IAAI,CAAC;AACtB,CACF;AAEA,MAAM,iBACJ,MACA,SACW;CAIX,IAAI;CACJ,IAAI;EACF,MAAM,SAAkC,CAAC;EACzC,KAAK,MAAM,KAAK,OAAO,KAAK,KAAK,KAAe,EAAE,KAAK,GACrD,OAAO,KAAM,KAAK,MAAkC;EAEtD,WAAW,KAAK,UAAU,MAAM;CAClC,QAAQ;EACN,WAAW,OAAO,KAAK,KAAK;CAC9B;CACA,OAAO,GAAG,KAAK,IAAI,KAAK,OAAO,IAAI;AACrC;AAEA,MAAM,kCAAkC,UACrC,EACC,SACA,gBAII;CACJ,OAAO,oBACL,mBAEI,OAAO,KAAK,OAAO,EAAE,KAAK,QAAQ;EAChC,MAAM,OAAO;EACb,MAAM,UAAU,QAAQ;EACxB,OAAO,QACL,cAAc,MAAM,QAAQ,KAAK,GACjC,8BAA8B;GAC5B;GACA;GACA;EACF,CAAC,CACH;CACF,CAAC,GACH,CAAC,SAAS,SAAS,CACrB,CACF;AACF,CACF;;;;AAKA,MAAa,0BAA0B,UACpC,EACC,QACA,cAIqB;CACrB,MAAM,EAAE,aAAa,mBAAmB,gBAAgB,SAAS,MAAM;CAEvE,MAAM,YAAY,OAAO;EACf;EACR,SAAS;CACX,CAAC,EAAE;CAEH,gBAAgB;EAId,UAAU,UAAU;CACtB,CAAC;CAED,MAAM,aAAa,YACjB,OAAO,KAAK,WAAW,EAAE,SAAS,IAC9B,6BAA6B;EAAE,SAAS;EAAa;CAAU,CAAC,IAChE,iCAAiC,CACvC;CAEA,MAAM,gBAAgB,YACpB,gCAAgC;EAAE,SAAS;EAAgB;CAAU,CAAC,CACxE;CAEA,MAAM,SAAS,cAAc;EAE3B,MAAM,QACJ,WAAW,yBACP,0BAA0B,IAC1B;EAEN,MAAM,SAAS,OAAO,OAAO,KAAK;EAClC,OAAO,OAAO,QAAQ;GACpB,WAAW,WAAW,aAAa,OAAO;GAC1C,IAAI,WAAW,MAAM,OAAO;IAC3B,iCAAiC,4BAA4B,MAAM;EACtE,CAAC;EAED,KAAK,MAAM,SAAS,WAAW,SAC7B,OAAgB,MAAM,QAAQ;EAEhC,KAAK,MAAM,SAAS,eAClB,OAAgB,MAAM,QAAQ;EAGhC,OAAO;CACT,GAAG;EAAC;EAAQ;EAAY;CAAa,CAAC;CAEtC,IAAI,UAAU,YAAY,MACxB,UAAU,UAAU;CAGtB,OAAO;AACT,CACF;;AA0EA,SAAgB,OACd,SACA,EAAE,WAA+C,EAC/C,QAAQ,yBAAyB,EACnC,GACiB;CACjB,IAAI,SAEF,OAAO,YACL,wBAAwB;EACtB,QAAQ,UAAU;EAClB;CACF,CAAC,CACH;CAEF,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,iDAAiD;CACnE,OAAO;AACT"}

package/dist/useAuiEvent.d.ts

@@ -1,3 +1,48 @@
-import type { AssistantEventName, AssistantEventCallback, AssistantEventSelector } from "./types/events.js";
-export declare const useAuiEvent: <TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>) => void;
+import { AssistantEventCallback, AssistantEventName, AssistantEventSelector } from "./types/events.js";
+
+//#region src/useAuiEvent.d.ts
+/**
+ * Subscribes to an assistant event for the lifetime of the component.
+ *
+ * The subscription is established on mount and re-established whenever the
+ * scope or event name changes. The `callback` is wrapped in an effect-event
+ * shim, so the latest closure is invoked on each emission — you do not
+ * need to memoize it.
+ *
+ * @param selector - Either a dotted event name like
+ *   `"thread.modelContextUpdate"` or an object `{ scope, event }`. Use
+ *   `scope: "*"` to subscribe at the root client and receive emissions
+ *   from any descendant scope, regardless of which one is in React
+ *   context.
+ * @param callback - Invoked with the event payload. The most recent
+ *   reference is always called. Return values are ignored, async callbacks
+ *   are not awaited, and the callback cannot be called during render.
+ *
+ * @example
+ * ```tsx
+ * // React to transient model-context changes.
+ * useAuiEvent("thread.modelContextUpdate", ({ threadId }) => {
+ *   analytics.track("model_context_update", { threadId });
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // React to thread switches.
+ * useAuiEvent("threadListItem.switchedTo", () => {
+ *   resetLocalState();
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Listen from the root client rather than the current React context.
+ * useAuiEvent({ scope: "*", event: "thread.modelContextUpdate" }, (payload) => {
+ *   analytics.track("model_context_update", payload);
+ * });
+ * ```
+ */
+declare const useAuiEvent: <TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>) => void;
+//#endregion
+export { useAuiEvent };
 //# sourceMappingURL=useAuiEvent.d.ts.map

package/dist/useAuiEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuiEvent.d.ts","sourceRoot":"","sources":["../src/useAuiEvent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACvB,0BAAuB;AAGxB,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,kBAAkB,EAC3D,UAAU,sBAAsB,CAAC,MAAM,CAAC,EACxC,UAAU,sBAAsB,CAAC,MAAM,CAAC,SAUzC,CAAC"}
+{"version":3,"file":"useAuiEvent.d.ts","names":[],"sources":["../src/useAuiEvent.ts"],"mappings":";;;;;AAmDA;;;;;;;;;;;;;;;;;;;AAE0C;;;;;;;;;;;;;;;;;;;;cAF7B,WAAA,kBAA8B,kBAAA,EACzC,QAAA,EAAU,sBAAA,CAAuB,MAAA,GACjC,QAAA,EAAU,sBAAA,CAAuB,MAAA"}

package/dist/useAuiEvent.js

@@ -1,11 +1,64 @@
+import { normalizeEventSelector } from "./types/events.js";
+import { useAui } from "./useAui.js";
 import { useEffect } from "react";
 import { useEffectEvent } from "use-effect-event";
-import { useAui } from "./useAui.js";
-import { normalizeEventSelector } from "./types/events.js";
-export const useAuiEvent = (selector, callback) => {
-    const aui = useAui();
-    const callbackRef = useEffectEvent(callback);
-    const { scope, event } = normalizeEventSelector(selector);
-    useEffect(() => aui.on({ scope, event }, callbackRef), [aui, scope, event, callbackRef]);
+//#region src/useAuiEvent.ts
+/**
+* Subscribes to an assistant event for the lifetime of the component.
+*
+* The subscription is established on mount and re-established whenever the
+* scope or event name changes. The `callback` is wrapped in an effect-event
+* shim, so the latest closure is invoked on each emission — you do not
+* need to memoize it.
+*
+* @param selector - Either a dotted event name like
+*   `"thread.modelContextUpdate"` or an object `{ scope, event }`. Use
+*   `scope: "*"` to subscribe at the root client and receive emissions
+*   from any descendant scope, regardless of which one is in React
+*   context.
+* @param callback - Invoked with the event payload. The most recent
+*   reference is always called. Return values are ignored, async callbacks
+*   are not awaited, and the callback cannot be called during render.
+*
+* @example
+* ```tsx
+* // React to transient model-context changes.
+* useAuiEvent("thread.modelContextUpdate", ({ threadId }) => {
+*   analytics.track("model_context_update", { threadId });
+* });
+* ```
+*
+* @example
+* ```tsx
+* // React to thread switches.
+* useAuiEvent("threadListItem.switchedTo", () => {
+*   resetLocalState();
+* });
+* ```
+*
+* @example
+* ```tsx
+* // Listen from the root client rather than the current React context.
+* useAuiEvent({ scope: "*", event: "thread.modelContextUpdate" }, (payload) => {
+*   analytics.track("model_context_update", payload);
+* });
+* ```
+*/
+const useAuiEvent = (selector, callback) => {
+	const aui = useAui();
+	const callbackRef = useEffectEvent(callback);
+	const { scope, event } = normalizeEventSelector(selector);
+	useEffect(() => aui.on({
+		scope,
+		event
+	}, callbackRef), [
+		aui,
+		scope,
+		event,
+		callbackRef
+	]);
 };
+//#endregion
+export { useAuiEvent };
+
 //# sourceMappingURL=useAuiEvent.js.map

package/dist/useAuiEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAuiEvent.js","sourceRoot":"","sources":["../src/useAuiEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAMlC,OAAO,EAAE,sBAAsB,EAAE,0BAAuB;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAwC,EACxC,QAAwC,EACxC,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1D,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,EAC3C,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CACjC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"useAuiEvent.js","names":[],"sources":["../src/useAuiEvent.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useEffectEvent } from \"use-effect-event\";\nimport { useAui } from \"./useAui\";\nimport type {\n  AssistantEventName,\n  AssistantEventCallback,\n  AssistantEventSelector,\n} from \"./types/events\";\nimport { normalizeEventSelector } from \"./types/events\";\n\n/**\n * Subscribes to an assistant event for the lifetime of the component.\n *\n * The subscription is established on mount and re-established whenever the\n * scope or event name changes. The `callback` is wrapped in an effect-event\n * shim, so the latest closure is invoked on each emission — you do not\n * need to memoize it.\n *\n * @param selector - Either a dotted event name like\n *   `\"thread.modelContextUpdate\"` or an object `{ scope, event }`. Use\n *   `scope: \"*\"` to subscribe at the root client and receive emissions\n *   from any descendant scope, regardless of which one is in React\n *   context.\n * @param callback - Invoked with the event payload. The most recent\n *   reference is always called. Return values are ignored, async callbacks\n *   are not awaited, and the callback cannot be called during render.\n *\n * @example\n * ```tsx\n * // React to transient model-context changes.\n * useAuiEvent(\"thread.modelContextUpdate\", ({ threadId }) => {\n *   analytics.track(\"model_context_update\", { threadId });\n * });\n * ```\n *\n * @example\n * ```tsx\n * // React to thread switches.\n * useAuiEvent(\"threadListItem.switchedTo\", () => {\n *   resetLocalState();\n * });\n * ```\n *\n * @example\n * ```tsx\n * // Listen from the root client rather than the current React context.\n * useAuiEvent({ scope: \"*\", event: \"thread.modelContextUpdate\" }, (payload) => {\n *   analytics.track(\"model_context_update\", payload);\n * });\n * ```\n */\nexport const useAuiEvent = <TEvent extends AssistantEventName>(\n  selector: AssistantEventSelector<TEvent>,\n  callback: AssistantEventCallback<TEvent>,\n) => {\n  const aui = useAui();\n  const callbackRef = useEffectEvent(callback);\n\n  const { scope, event } = normalizeEventSelector(selector);\n  useEffect(\n    () => aui.on({ scope, event }, callbackRef),\n    [aui, scope, event, callbackRef],\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,eACX,UACA,aACG;CACH,MAAM,MAAM,OAAO;CACnB,MAAM,cAAc,eAAe,QAAQ;CAE3C,MAAM,EAAE,OAAO,UAAU,uBAAuB,QAAQ;CACxD,gBACQ,IAAI,GAAG;EAAE;EAAO;CAAM,GAAG,WAAW,GAC1C;EAAC;EAAK;EAAO;EAAO;CAAW,CACjC;AACF"}

package/dist/useAuiState.d.ts

@@ -1,18 +1,39 @@
-import type { AssistantState } from "./types/client.js";
+import { AssistantState } from "./types/client.js";
+
+//#region src/useAuiState.d.ts
 /**
- * Hook to access a slice of the assistant state with automatic subscription
+ * Subscribes to a slice of {@link AssistantState} and re-renders the
+ * component whenever that slice changes.
  *
- * @param selector - Function to select a slice of the state
- * @returns The selected state slice
+ * The `selector` is called on every store update; its return value is
+ * compared by `Object.is`, and the component re-renders only when the
+ * selected slice changes. Returning the entire state object is not
+ * supported and throws at runtime — select a specific field instead, or
+ * compose multiple `useAuiState` calls. Returning a new object or array
+ * literal, including spreading `s.thread` into a new object, causes a
+ * re-render on every store update; either select primitives or return a
+ * memoized reference.
+ *
+ * @param selector - Pure function that derives a value from the current
+ *   assistant state. Should be cheap and referentially stable for equal
+ *   inputs (plain field reads, primitives, or memoized values).
+ * @returns The currently selected slice.
  *
  * @example
- * ```typescript
- * const aui = useAui({
- *   foo: RootScope({ ... }),
- * });
+ * ```tsx
+ * // Disable a button while a run is in flight.
+ * const isRunning = useAuiState((s) => s.thread.isRunning);
+ * ```
  *
- * const bar = useAuiState((s) => s.foo.bar);
+ * @example
+ * ```tsx
+ * // Prefer multiple selectors over an inline object literal, which would
+ * // create a new reference on every render.
+ * const text = useAuiState((s) => s.composer.text);
+ * const canSend = useAuiState((s) => s.composer.canSend);
  * ```
  */
-export declare const useAuiState: <T>(selector: (state: AssistantState) => T) => T;
+declare const useAuiState: <T>(selector: (state: AssistantState) => T) => T;
+//#endregion
+export { useAuiState };
 //# sourceMappingURL=useAuiState.d.ts.map