@assistant-ui/store 0.0.2 → 0.0.3

package/dist/tapClientList.d.ts

@@ -0,0 +1,24 @@
+import type { ContravariantResource } from "@assistant-ui/tap";
+import type { ClientMethods, ClientOutputOf } from "./types/client";
+export declare const tapClientList: <TData, TState, TMethods extends ClientMethods>(props: tapClientList.Props<TData, TState, TMethods>) => {
+    state: TState[];
+    get: (lookup: {
+        index: number;
+    } | {
+        key: string;
+    }) => TMethods;
+    add: (initialData: TData) => void;
+};
+export declare namespace tapClientList {
+    type ResourceProps<TData> = {
+        key: string;
+        getInitialData: () => TData;
+        remove: () => void;
+    };
+    type Props<TData, TState, TMethods extends ClientMethods> = {
+        initialValues: TData[];
+        getKey: (data: TData) => string;
+        resource: ContravariantResource<ClientOutputOf<TState, TMethods>, ResourceProps<TData>>;
+    };
+}
+//# sourceMappingURL=tapClientList.d.ts.map

package/dist/tapClientList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapClientList.d.ts","sourceRoot":"","sources":["../src/tapClientList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAsBpE,eAAO,MAAM,aAAa,GAAI,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAS,aAAa,EACzE,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAClD;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,QAAQ,CAAC;IAC/D,GAAG,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC;CAyDnC,CAAC;AAEF,yBAAiB,aAAa,CAAC;IAC7B,KAAY,aAAa,CAAC,KAAK,IAAI;QACjC,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,KAAK,CAAC;QAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IAEF,KAAY,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAS,aAAa,IAAI;QACjE,aAAa,EAAE,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;QAChC,QAAQ,EAAE,qBAAqB,CAC7B,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,EAChC,aAAa,CAAC,KAAK,CAAC,CACrB,CAAC;KACH,CAAC;CACH"}

package/dist/tapClientList.js

@@ -0,0 +1,72 @@
+// src/tapClientList.ts
+import { tapState } from "@assistant-ui/tap";
+import { tapClientLookup } from "./tapClientLookup.js";
+var createProps = (key, data, remove) => {
+  let initialData = { data };
+  return {
+    key,
+    getInitialData: () => {
+      if (!initialData) {
+        throw new Error("getInitialData may only be called once");
+      }
+      const data2 = initialData.data;
+      initialData = void 0;
+      return data2;
+    },
+    remove
+  };
+};
+var tapClientList = (props) => {
+  const { initialValues, getKey, resource: Resource } = props;
+  const [items, setItems] = tapState(() => {
+    const entries = [];
+    for (const data of initialValues) {
+      const key = getKey(data);
+      entries.push([
+        key,
+        createProps(key, data, () => {
+          setItems((items2) => {
+            const newItems = { ...items2 };
+            delete newItems[key];
+            return newItems;
+          });
+        })
+      ]);
+    }
+    return Object.fromEntries(entries);
+  });
+  const lookup = tapClientLookup(
+    items,
+    Resource,
+    [Resource]
+  );
+  const add = (data) => {
+    const key = getKey(data);
+    setItems((items2) => {
+      if (key in items2) {
+        throw new Error(
+          `Tried to add item with a key ${key} that already exists`
+        );
+      }
+      return {
+        ...items2,
+        [key]: createProps(key, data, () => {
+          setItems((items3) => {
+            const newItems = { ...items3 };
+            delete newItems[key];
+            return newItems;
+          });
+        })
+      };
+    });
+  };
+  return {
+    state: lookup.state,
+    get: lookup.get,
+    add
+  };
+};
+export {
+  tapClientList
+};
+//# sourceMappingURL=tapClientList.js.map

package/dist/tapClientList.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tapClientList.ts"],"sourcesContent":["import { tapState } from \"@assistant-ui/tap\";\nimport type { ContravariantResource } from \"@assistant-ui/tap\";\nimport { tapClientLookup } from \"./tapClientLookup\";\nimport type { ClientMethods, ClientOutputOf } from \"./types/client\";\n\nconst createProps = <TData>(\n  key: string,\n  data: TData,\n  remove: () => void,\n): tapClientList.ResourceProps<TData> => {\n  let initialData: { data: TData } | undefined = { data };\n  return {\n    key,\n    getInitialData: () => {\n      if (!initialData) {\n        throw new Error(\"getInitialData may only be called once\");\n      }\n      const data = initialData.data;\n      initialData = undefined;\n      return data;\n    },\n    remove,\n  };\n};\n\nexport const tapClientList = <TData, TState, TMethods extends ClientMethods>(\n  props: tapClientList.Props<TData, TState, TMethods>,\n): {\n  state: TState[];\n  get: (lookup: { index: number } | { key: string }) => TMethods;\n  add: (initialData: TData) => void;\n} => {\n  const { initialValues, getKey, resource: Resource } = props;\n\n  type Props = tapClientList.ResourceProps<TData>;\n\n  const [items, setItems] = tapState<Record<string, Props>>(() => {\n    const entries: [string, Props][] = [];\n    for (const data of initialValues) {\n      const key = getKey(data);\n      entries.push([\n        key,\n        createProps(key, data, () => {\n          setItems((items) => {\n            const newItems = { ...items };\n            delete newItems[key];\n            return newItems;\n          });\n        }),\n      ]);\n    }\n    return Object.fromEntries(entries);\n  });\n\n  const lookup = tapClientLookup<TState, TMethods, Record<string, Props>>(\n    items,\n    Resource,\n    [Resource],\n  );\n\n  const add = (data: TData) => {\n    const key = getKey(data);\n    setItems((items) => {\n      if (key in items) {\n        throw new Error(\n          `Tried to add item with a key ${key} that already exists`,\n        );\n      }\n\n      return {\n        ...items,\n        [key]: createProps(key, data, () => {\n          setItems((items) => {\n            const newItems = { ...items };\n            delete newItems[key];\n            return newItems;\n          });\n        }),\n      };\n    });\n  };\n\n  return {\n    state: lookup.state,\n    get: lookup.get,\n    add,\n  };\n};\n\nexport namespace tapClientList {\n  export type ResourceProps<TData> = {\n    key: string;\n    getInitialData: () => TData;\n    remove: () => void;\n  };\n\n  export type Props<TData, TState, TMethods extends ClientMethods> = {\n    initialValues: TData[];\n    getKey: (data: TData) => string;\n    resource: ContravariantResource<\n      ClientOutputOf<TState, TMethods>,\n      ResourceProps<TData>\n    >;\n  };\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAEzB,SAAS,uBAAuB;AAGhC,IAAM,cAAc,CAClB,KACA,MACA,WACuC;AACvC,MAAI,cAA2C,EAAE,KAAK;AACtD,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,MAAM;AACpB,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI,MAAM,wCAAwC;AAAA,MAC1D;AACA,YAAMA,QAAO,YAAY;AACzB,oBAAc;AACd,aAAOA;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACF;AAEO,IAAM,gBAAgB,CAC3B,UAKG;AACH,QAAM,EAAE,eAAe,QAAQ,UAAU,SAAS,IAAI;AAItD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAgC,MAAM;AAC9D,UAAM,UAA6B,CAAC;AACpC,eAAW,QAAQ,eAAe;AAChC,YAAM,MAAM,OAAO,IAAI;AACvB,cAAQ,KAAK;AAAA,QACX;AAAA,QACA,YAAY,KAAK,MAAM,MAAM;AAC3B,mBAAS,CAACC,WAAU;AAClB,kBAAM,WAAW,EAAE,GAAGA,OAAM;AAC5B,mBAAO,SAAS,GAAG;AACnB,mBAAO;AAAA,UACT,CAAC;AAAA,QACH,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AACA,WAAO,OAAO,YAAY,OAAO;AAAA,EACnC,CAAC;AAED,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,MAAM,CAAC,SAAgB;AAC3B,UAAM,MAAM,OAAO,IAAI;AACvB,aAAS,CAACA,WAAU;AAClB,UAAI,OAAOA,QAAO;AAChB,cAAM,IAAI;AAAA,UACR,gCAAgC,GAAG;AAAA,QACrC;AAAA,MACF;AAEA,aAAO;AAAA,QACL,GAAGA;AAAA,QACH,CAAC,GAAG,GAAG,YAAY,KAAK,MAAM,MAAM;AAClC,mBAAS,CAACA,WAAU;AAClB,kBAAM,WAAW,EAAE,GAAGA,OAAM;AAC5B,mBAAO,SAAS,GAAG;AACnB,mBAAO;AAAA,UACT,CAAC;AAAA,QACH,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,KAAK,OAAO;AAAA,IACZ;AAAA,EACF;AACF;","names":["data","items"]}

package/dist/tapClientLookup.d.ts

@@ -0,0 +1,11 @@
+import { ResourceElement } from "@assistant-ui/tap";
+import type { ClientMethods, ClientOutputOf } from "./types/client";
+export declare const tapClientLookup: <TState, TMethods extends ClientMethods, M extends Record<string | number | symbol, any>>(map: M, getElement: (t: M[keyof M], key: keyof M) => ResourceElement<ClientOutputOf<TState, TMethods>>, getElementDeps: any[]) => {
+    state: TState[];
+    get: (lookup: {
+        index: number;
+    } | {
+        key: keyof M;
+    }) => TMethods;
+};
+//# sourceMappingURL=tapClientLookup.d.ts.map

package/dist/tapClientLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapClientLookup.d.ts","sourceRoot":"","sources":["../src/tapClientLookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAyB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGpE,eAAO,MAAM,eAAe,GAC1B,MAAM,EACN,QAAQ,SAAS,aAAa,EAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAE/C,KAAK,CAAC,EACN,YAAY,CACV,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,CAAC,KACT,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EACtD,gBAAgB,GAAG,EAAE,KACpB;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,QAAQ,CAAC;CAsCjE,CAAC"}

package/dist/tapClientLookup.js

@@ -0,0 +1,42 @@
+// src/tapClientLookup.ts
+import { tapMemo, tapResources } from "@assistant-ui/tap";
+import { ClientResource } from "./tapClientResource.js";
+var tapClientLookup = (map, getElement, getElementDeps) => {
+  const resources = tapResources(
+    map,
+    (t, key) => ClientResource(getElement(t, key)),
+    getElementDeps
+  );
+  const keys = tapMemo(() => Object.keys(map), [map]);
+  const state = tapMemo(() => {
+    const result = new Array(keys.length);
+    for (let i = 0; i < keys.length; i++) {
+      result[i] = resources[keys[i]].state;
+    }
+    return result;
+  }, [keys, resources]);
+  return {
+    state,
+    get: (lookup) => {
+      if ("index" in lookup) {
+        if (lookup.index < 0 || lookup.index >= keys.length) {
+          throw new Error(
+            `tapClientLookup: Index ${lookup.index} out of bounds (length: ${keys.length})`
+          );
+        }
+        return resources[keys[lookup.index]].methods;
+      }
+      const value = resources[lookup.key];
+      if (!value) {
+        throw new Error(
+          `tapClientLookup: Key "${String(lookup.key)}" not found`
+        );
+      }
+      return value.methods;
+    }
+  };
+};
+export {
+  tapClientLookup
+};
+//# sourceMappingURL=tapClientLookup.js.map

package/dist/tapClientLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tapClientLookup.ts"],"sourcesContent":["import { ResourceElement, tapMemo, tapResources } from \"@assistant-ui/tap\";\nimport type { ClientMethods, ClientOutputOf } from \"./types/client\";\nimport { ClientResource } from \"./tapClientResource\";\n\nexport const tapClientLookup = <\n  TState,\n  TMethods extends ClientMethods,\n  M extends Record<string | number | symbol, any>,\n>(\n  map: M,\n  getElement: (\n    t: M[keyof M],\n    key: keyof M,\n  ) => ResourceElement<ClientOutputOf<TState, TMethods>>,\n  getElementDeps: any[],\n): {\n  state: TState[];\n  get: (lookup: { index: number } | { key: keyof M }) => TMethods;\n} => {\n  const resources = tapResources(\n    map,\n    (t, key) => ClientResource(getElement(t, key)),\n    getElementDeps,\n  );\n  const keys = tapMemo(() => Object.keys(map) as (keyof M)[], [map]);\n\n  const state = tapMemo(() => {\n    const result = new Array(keys.length);\n    for (let i = 0; i < keys.length; i++) {\n      result[i] = resources[keys[i]!].state;\n    }\n    return result;\n  }, [keys, resources]);\n\n  return {\n    state,\n    get: (lookup: { index: number } | { key: keyof M }) => {\n      if (\"index\" in lookup) {\n        if (lookup.index < 0 || lookup.index >= keys.length) {\n          throw new Error(\n            `tapClientLookup: Index ${lookup.index} out of bounds (length: ${keys.length})`,\n          );\n        }\n        return resources[keys[lookup.index]!]!.methods;\n      }\n\n      const value = resources[lookup.key];\n      if (!value) {\n        throw new Error(\n          `tapClientLookup: Key \"${String(lookup.key)}\" not found`,\n        );\n      }\n      return value.methods;\n    },\n  };\n};\n"],"mappings":";AAAA,SAA0B,SAAS,oBAAoB;AAEvD,SAAS,sBAAsB;AAExB,IAAM,kBAAkB,CAK7B,KACA,YAIA,mBAIG;AACH,QAAM,YAAY;AAAA,IAChB;AAAA,IACA,CAAC,GAAG,QAAQ,eAAe,WAAW,GAAG,GAAG,CAAC;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,OAAO,QAAQ,MAAM,OAAO,KAAK,GAAG,GAAkB,CAAC,GAAG,CAAC;AAEjE,QAAM,QAAQ,QAAQ,MAAM;AAC1B,UAAM,SAAS,IAAI,MAAM,KAAK,MAAM;AACpC,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,aAAO,CAAC,IAAI,UAAU,KAAK,CAAC,CAAE,EAAE;AAAA,IAClC;AACA,WAAO;AAAA,EACT,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,SAAO;AAAA,IACL;AAAA,IACA,KAAK,CAAC,WAAiD;AACrD,UAAI,WAAW,QAAQ;AACrB,YAAI,OAAO,QAAQ,KAAK,OAAO,SAAS,KAAK,QAAQ;AACnD,gBAAM,IAAI;AAAA,YACR,0BAA0B,OAAO,KAAK,2BAA2B,KAAK,MAAM;AAAA,UAC9E;AAAA,QACF;AACA,eAAO,UAAU,KAAK,OAAO,KAAK,CAAE,EAAG;AAAA,MACzC;AAEA,YAAM,QAAQ,UAAU,OAAO,GAAG;AAClC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI;AAAA,UACR,yBAAyB,OAAO,OAAO,GAAG,CAAC;AAAA,QAC7C;AAAA,MACF;AACA,aAAO,MAAM;AAAA,IACf;AAAA,EACF;AACF;","names":[]}

package/dist/tapClientResource.d.ts

@@ -0,0 +1,24 @@
+import { type ResourceElement } from "@assistant-ui/tap";
+import type { ClientMethods, ClientOutputOf } from "./types/client";
+export declare const getClientState: (client: ClientMethods) => unknown;
+/**
+ * Resource that wraps a plain resource element to create a stable client proxy.
+ *
+ * Takes a ResourceElement that returns { state, methods } and
+ * wraps it to produce a stable client proxy. This adds the client to the
+ * client stack, enabling event scoping.
+ *
+ * Use this for 1:1 client mappings where you want event scoping to work correctly.
+ *
+ * @example
+ * ```typescript
+ * const MessageResource = resource(({ messageId }: { messageId: string }) => {
+ *   return tapInlineResource(
+ *     tapClientResource(InnerMessageResource({ messageId }))
+ *   );
+ * });
+ * ```
+ */
+export declare const ClientResource: <TState, TMethods extends ClientMethods>(props: ResourceElement<ClientOutputOf<TState, TMethods>>) => ResourceElement<ClientOutputOf<TState, TMethods>, ResourceElement<ClientOutputOf<TState, TMethods>>>;
+export declare const tapClientResource: <TState, TMethods extends ClientMethods>(element: ResourceElement<ClientOutputOf<TState, TMethods>>) => ClientOutputOf<TState, TMethods>;
+//# sourceMappingURL=tapClientResource.d.ts.map

package/dist/tapClientResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapClientResource.d.ts","sourceRoot":"","sources":["../src/tapClientResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EAIrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBpE,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,YASnD,CAAC;AA2DF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,GACxB,MAAM,EAAE,QAAQ,SAAS,aAAa,mKA4BxC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,EAAE,QAAQ,SAAS,aAAa,EACtE,SAAS,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,qCAG3D,CAAC"}

package/dist/tapClientResource.js

@@ -0,0 +1,100 @@
+// src/tapClientResource.ts
+import {
+  tapEffect,
+  tapMemo,
+  tapRef,
+  tapResource,
+  resource,
+  tapInlineResource
+} from "@assistant-ui/tap";
+import {
+  tapClientStack,
+  tapWithClientStack,
+  SYMBOL_CLIENT_INDEX
+} from "./utils/tap-client-stack-context.js";
+import {
+  BaseProxyHandler,
+  handleIntrospectionProp
+} from "./utils/BaseProxyHandler.js";
+var SYMBOL_GET_OUTPUT = /* @__PURE__ */ Symbol("assistant-ui.store.getValue");
+var getClientState = (client) => {
+  const output = client[SYMBOL_GET_OUTPUT];
+  if (!output) {
+    throw new Error(
+      "Client scope contains a non-client resource. Ensure your Derived get() returns a client created with tapClientResource(), not a plain resource."
+    );
+  }
+  return output.state;
+};
+var fieldAccessFns = /* @__PURE__ */ new Map();
+function getOrCreateProxyFn(prop) {
+  let template = fieldAccessFns.get(prop);
+  if (!template) {
+    template = function(...args) {
+      if (!this)
+        throw new Error(
+          `Destructuring the client method "${String(prop)}" is not supported.`
+        );
+      const method = this[SYMBOL_GET_OUTPUT].methods[prop];
+      if (!method)
+        throw new Error(`Method "${String(prop)}" is not implemented.`);
+      return method(...args);
+    };
+    fieldAccessFns.set(prop, template);
+  }
+  return template;
+}
+var ClientProxyHandler = class extends BaseProxyHandler {
+  constructor(outputRef, index) {
+    super();
+    this.outputRef = outputRef;
+    this.index = index;
+  }
+  get(_, prop) {
+    if (prop === SYMBOL_GET_OUTPUT) return this.outputRef.current;
+    if (prop === SYMBOL_CLIENT_INDEX) return this.index;
+    const introspection = handleIntrospectionProp(prop, "ClientProxy");
+    if (introspection !== false) return introspection;
+    return getOrCreateProxyFn(prop);
+  }
+  ownKeys() {
+    return Object.keys(this.outputRef.current.methods);
+  }
+  has(_, prop) {
+    if (prop === SYMBOL_GET_OUTPUT) return true;
+    if (prop === SYMBOL_CLIENT_INDEX) return true;
+    return prop in this.outputRef.current.methods;
+  }
+};
+var ClientResource = resource(
+  (element) => {
+    const valueRef = tapRef(
+      null
+    );
+    const index = tapClientStack().length;
+    const methods = tapMemo(
+      () => new Proxy(
+        {},
+        new ClientProxyHandler(valueRef, index)
+      ),
+      []
+    );
+    const value = tapWithClientStack(methods, () => tapResource(element));
+    if (!valueRef.current) {
+      valueRef.current = value;
+    }
+    tapEffect(() => {
+      valueRef.current = value;
+    });
+    return { methods, state: value.state };
+  }
+);
+var tapClientResource = (element) => {
+  return tapInlineResource(ClientResource(element));
+};
+export {
+  ClientResource,
+  getClientState,
+  tapClientResource
+};
+//# sourceMappingURL=tapClientResource.js.map

package/dist/tapClientResource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tapClientResource.ts"],"sourcesContent":["import {\n  tapEffect,\n  tapMemo,\n  tapRef,\n  type ResourceElement,\n  tapResource,\n  resource,\n  tapInlineResource,\n} from \"@assistant-ui/tap\";\nimport type { ClientMethods, ClientOutputOf } from \"./types/client\";\nimport {\n  tapClientStack,\n  tapWithClientStack,\n  SYMBOL_CLIENT_INDEX,\n} from \"./utils/tap-client-stack-context\";\nimport {\n  BaseProxyHandler,\n  handleIntrospectionProp,\n} from \"./utils/BaseProxyHandler\";\n\n/**\n * Symbol used internally to get state from ClientProxy.\n * This allows getState() to be optional in the user-facing client.\n */\nconst SYMBOL_GET_OUTPUT = Symbol(\"assistant-ui.store.getValue\");\n\ntype ClientInternal = {\n  [SYMBOL_GET_OUTPUT]: ClientOutputOf<unknown, ClientMethods>;\n};\n\nexport const getClientState = (client: ClientMethods) => {\n  const output = (client as unknown as ClientInternal)[SYMBOL_GET_OUTPUT];\n  if (!output) {\n    throw new Error(\n      \"Client scope contains a non-client resource. \" +\n        \"Ensure your Derived get() returns a client created with tapClientResource(), not a plain resource.\",\n    );\n  }\n  return output.state;\n};\n\n// Global cache for function templates by field name\nconst fieldAccessFns = new Map<\n  string | symbol,\n  (this: ClientInternal, ...args: unknown[]) => unknown\n>();\n\nfunction getOrCreateProxyFn(prop: string | symbol) {\n  let template = fieldAccessFns.get(prop);\n  if (!template) {\n    template = function (this: ClientInternal | undefined, ...args: unknown[]) {\n      if (!this)\n        throw new Error(\n          `Destructuring the client method \"${String(prop)}\" is not supported.`,\n        );\n\n      const method = this[SYMBOL_GET_OUTPUT].methods[prop];\n      if (!method)\n        throw new Error(`Method \"${String(prop)}\" is not implemented.`);\n      return method(...args);\n    };\n    fieldAccessFns.set(prop, template);\n  }\n  return template;\n}\n\nclass ClientProxyHandler\n  extends BaseProxyHandler\n  implements ProxyHandler<object>\n{\n  constructor(\n    private readonly outputRef: {\n      current: ClientOutputOf<unknown, ClientMethods>;\n    },\n    private readonly index: number,\n  ) {\n    super();\n  }\n\n  get(_: unknown, prop: string | symbol) {\n    if (prop === SYMBOL_GET_OUTPUT) return this.outputRef.current;\n    if (prop === SYMBOL_CLIENT_INDEX) return this.index;\n    const introspection = handleIntrospectionProp(prop, \"ClientProxy\");\n    if (introspection !== false) return introspection;\n    return getOrCreateProxyFn(prop);\n  }\n\n  ownKeys(): ArrayLike<string | symbol> {\n    return Object.keys(this.outputRef.current.methods);\n  }\n\n  has(_: unknown, prop: string | symbol) {\n    if (prop === SYMBOL_GET_OUTPUT) return true;\n    if (prop === SYMBOL_CLIENT_INDEX) return true;\n    return prop in this.outputRef.current.methods;\n  }\n}\n\n/**\n * Resource that wraps a plain resource element to create a stable client proxy.\n *\n * Takes a ResourceElement that returns { state, methods } and\n * wraps it to produce a stable client proxy. This adds the client to the\n * client stack, enabling event scoping.\n *\n * Use this for 1:1 client mappings where you want event scoping to work correctly.\n *\n * @example\n * ```typescript\n * const MessageResource = resource(({ messageId }: { messageId: string }) => {\n *   return tapInlineResource(\n *     tapClientResource(InnerMessageResource({ messageId }))\n *   );\n * });\n * ```\n */\nexport const ClientResource = resource(\n  <TState, TMethods extends ClientMethods>(\n    element: ResourceElement<ClientOutputOf<TState, TMethods>>,\n  ): ClientOutputOf<TState, TMethods> => {\n    const valueRef = tapRef(\n      null as unknown as ClientOutputOf<TState, TMethods>,\n    );\n\n    const index = tapClientStack().length;\n    const methods = tapMemo(\n      () =>\n        new Proxy<TMethods>(\n          {} as TMethods,\n          new ClientProxyHandler(valueRef, index),\n        ),\n      [],\n    );\n\n    const value = tapWithClientStack(methods, () => tapResource(element));\n    if (!valueRef.current) {\n      valueRef.current = value;\n    }\n\n    tapEffect(() => {\n      valueRef.current = value;\n    });\n\n    return { methods, state: value.state };\n  },\n);\n\nexport const tapClientResource = <TState, TMethods extends ClientMethods>(\n  element: ResourceElement<ClientOutputOf<TState, TMethods>>,\n) => {\n  return tapInlineResource(ClientResource(element));\n};\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAMP,IAAM,oBAAoB,uBAAO,6BAA6B;AAMvD,IAAM,iBAAiB,CAAC,WAA0B;AACvD,QAAM,SAAU,OAAqC,iBAAiB;AACtE,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO,OAAO;AAChB;AAGA,IAAM,iBAAiB,oBAAI,IAGzB;AAEF,SAAS,mBAAmB,MAAuB;AACjD,MAAI,WAAW,eAAe,IAAI,IAAI;AACtC,MAAI,CAAC,UAAU;AACb,eAAW,YAA+C,MAAiB;AACzE,UAAI,CAAC;AACH,cAAM,IAAI;AAAA,UACR,oCAAoC,OAAO,IAAI,CAAC;AAAA,QAClD;AAEF,YAAM,SAAS,KAAK,iBAAiB,EAAE,QAAQ,IAAI;AACnD,UAAI,CAAC;AACH,cAAM,IAAI,MAAM,WAAW,OAAO,IAAI,CAAC,uBAAuB;AAChE,aAAO,OAAO,GAAG,IAAI;AAAA,IACvB;AACA,mBAAe,IAAI,MAAM,QAAQ;AAAA,EACnC;AACA,SAAO;AACT;AAEA,IAAM,qBAAN,cACU,iBAEV;AAAA,EACE,YACmB,WAGA,OACjB;AACA,UAAM;AALW;AAGA;AAAA,EAGnB;AAAA,EAEA,IAAI,GAAY,MAAuB;AACrC,QAAI,SAAS,kBAAmB,QAAO,KAAK,UAAU;AACtD,QAAI,SAAS,oBAAqB,QAAO,KAAK;AAC9C,UAAM,gBAAgB,wBAAwB,MAAM,aAAa;AACjE,QAAI,kBAAkB,MAAO,QAAO;AACpC,WAAO,mBAAmB,IAAI;AAAA,EAChC;AAAA,EAEA,UAAsC;AACpC,WAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,OAAO;AAAA,EACnD;AAAA,EAEA,IAAI,GAAY,MAAuB;AACrC,QAAI,SAAS,kBAAmB,QAAO;AACvC,QAAI,SAAS,oBAAqB,QAAO;AACzC,WAAO,QAAQ,KAAK,UAAU,QAAQ;AAAA,EACxC;AACF;AAoBO,IAAM,iBAAiB;AAAA,EAC5B,CACE,YACqC;AACrC,UAAM,WAAW;AAAA,MACf;AAAA,IACF;AAEA,UAAM,QAAQ,eAAe,EAAE;AAC/B,UAAM,UAAU;AAAA,MACd,MACE,IAAI;AAAA,QACF,CAAC;AAAA,QACD,IAAI,mBAAmB,UAAU,KAAK;AAAA,MACxC;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,QAAQ,mBAAmB,SAAS,MAAM,YAAY,OAAO,CAAC;AACpE,QAAI,CAAC,SAAS,SAAS;AACrB,eAAS,UAAU;AAAA,IACrB;AAEA,cAAU,MAAM;AACd,eAAS,UAAU;AAAA,IACrB,CAAC;AAED,WAAO,EAAE,SAAS,OAAO,MAAM,MAAM;AAAA,EACvC;AACF;AAEO,IAAM,oBAAoB,CAC/B,YACG;AACH,SAAO,kBAAkB,eAAe,OAAO,CAAC;AAClD;","names":[]}

package/dist/types/client.d.ts

@@ -0,0 +1,117 @@
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { AssistantEventName, AssistantEventCallback, AssistantEventSelector } from "./events";
+/**
+ * Base type for methods that can be called on a client.
+ */
+export interface ClientMethods {
+    [key: string | symbol]: (...args: any[]) => any;
+}
+type ClientMetaType = {
+    source: ClientNames;
+    query: Record<string, unknown>;
+};
+/**
+ * Module augmentation interface for assistant-ui store type extensions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@assistant-ui/store" {
+ *   interface ClientRegistry {
+ *     // Simple client (meta and events are optional)
+ *     foo: {
+ *       state: { bar: string };
+ *       methods: { updateBar: (bar: string) => void };
+ *     };
+ *     // Full client with meta and events
+ *     bar: {
+ *       state: { id: string };
+ *       methods: { update: () => void };
+ *       meta: { source: "fooList"; query: { index: number } };
+ *       events: {
+ *         "bar.updated": { id: string };
+ *       };
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface ClientRegistry {
+}
+type ClientEventsType<K extends ClientNames> = Record<`${K}.${string}`, unknown>;
+type ClientError<E extends string> = {
+    state: E;
+    methods: Record<E, () => E>;
+    meta: {
+        source: ClientNames;
+        query: Record<E, E>;
+    };
+    events: Record<`${E}.`, E>;
+};
+type ValidateClient<K extends keyof ClientRegistry> = ClientRegistry[K] extends {
+    methods: ClientMethods;
+} ? "meta" extends keyof ClientRegistry[K] ? ClientRegistry[K]["meta"] extends ClientMetaType ? "events" extends keyof ClientRegistry[K] ? ClientRegistry[K]["events"] extends ClientEventsType<K> ? ClientRegistry[K] : ClientError<`ERROR: ${K & string} has invalid events type`> : ClientRegistry[K] : ClientError<`ERROR: ${K & string} has invalid meta type`> : "events" extends keyof ClientRegistry[K] ? ClientRegistry[K]["events"] extends ClientEventsType<K> ? ClientRegistry[K] : ClientError<`ERROR: ${K & string} has invalid events type`> : ClientRegistry[K] : ClientError<`ERROR: ${K & string} has invalid methods type`>;
+type ClientSchemas = keyof ClientRegistry extends never ? {
+    "ERROR: No clients were defined": ClientError<"ERROR: No clients were defined">;
+} : {
+    [K in keyof ClientRegistry]: ValidateClient<K>;
+};
+/**
+ * Output type that client resources return with state and methods.
+ *
+ * @example
+ * ```typescript
+ * const FooResource = resource((): ClientResourceOutput<"foo"> => {
+ *   const [state, setState] = tapState({ bar: "hello" });
+ *   return {
+ *     state,
+ *     methods: {
+ *       updateBar: (b) => setState({ bar: b })
+ *     }
+ *   };
+ * });
+ * ```
+ */
+export type ClientOutput<K extends ClientNames> = ClientOutputOf<ClientSchemas[K]["state"], ClientSchemas[K]["methods"] & ClientMethods>;
+/**
+ * Generic version of ClientResourceOutput for library code.
+ */
+export type ClientOutputOf<TState, TMethods extends ClientMethods> = {
+    state: TState;
+    methods: TMethods;
+};
+export type ClientNames = keyof ClientSchemas extends infer U ? U : never;
+export type ClientEvents<K extends ClientNames> = "events" extends keyof ClientSchemas[K] ? ClientSchemas[K]["events"] extends ClientEventsType<K> ? ClientSchemas[K]["events"] : never : never;
+export type ClientMeta<K extends ClientNames> = "meta" extends keyof ClientSchemas[K] ? Pick<ClientSchemas[K]["meta"] extends ClientMetaType ? ClientSchemas[K]["meta"] : never, "source" | "query"> : never;
+export type ClientElement<K extends ClientNames> = ResourceElement<ClientOutput<K>>;
+/**
+ * Unsubscribe function type.
+ */
+export type Unsubscribe = () => void;
+/**
+ * State type extracted from all clients.
+ */
+export type AssistantState = {
+    [K in ClientNames]: ClientSchemas[K]["state"];
+};
+/**
+ * Type for a client accessor - a function that returns the methods,
+ * with source/query metadata attached (derived from meta).
+ */
+export type AssistantClientAccessor<K extends ClientNames> = (() => ClientSchemas[K]["methods"]) & (ClientMeta<K> | {
+    source: "root";
+    query: Record<string, never>;
+} | {
+    source: null;
+    query: null;
+});
+/**
+ * The assistant client type with all registered clients.
+ */
+export type AssistantClient = {
+    [K in ClientNames]: AssistantClientAccessor<K>;
+} & {
+    subscribe(listener: () => void): Unsubscribe;
+    on<TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>): Unsubscribe;
+};
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"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"}

package/dist/types/client.js

@@ -0,0 +1 @@
+//# sourceMappingURL=client.js.map

package/dist/types/events.d.ts

@@ -0,0 +1,33 @@
+import type { AssistantClientAccessor, ClientEvents, ClientNames } from "./client";
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type ClientEventMap = UnionToIntersection<{
+    [K in ClientNames]: ClientEvents<K>;
+}[ClientNames]>;
+type WildcardPayload = {
+    [K in keyof ClientEventMap]: {
+        event: K;
+        payload: ClientEventMap[K];
+    };
+}[keyof ClientEventMap];
+export type AssistantEventPayload = ClientEventMap & {
+    "*": WildcardPayload;
+};
+export type AssistantEventName = keyof AssistantEventPayload;
+type EventSource<T extends AssistantEventName> = T extends `${infer Source}.${string}` ? Source : never;
+type ParentOf<K extends ClientNames> = AssistantClientAccessor<K> extends {
+    source: infer S;
+} ? S extends ClientNames ? S : never : never;
+type AncestorsOf<K extends ClientNames, Seen extends ClientNames = never> = K extends Seen ? never : ParentOf<K> extends never ? never : ParentOf<K> | AncestorsOf<ParentOf<K>, Seen | K>;
+/** Valid scopes: `"*"` | event source | ancestors of event source */
+export type AssistantEventScope<TEvent extends AssistantEventName> = "*" | EventSource<TEvent> | (EventSource<TEvent> extends ClientNames ? AncestorsOf<EventSource<TEvent>> : never);
+export type AssistantEventSelector<TEvent extends AssistantEventName> = TEvent | {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export declare const normalizeEventSelector: <TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>) => {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export type AssistantEventCallback<TEvent extends AssistantEventName> = (payload: AssistantEventPayload[TEvent]) => void;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACZ,MAAM,UAAU,CAAC;AAGlB,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAC5B,CAAC,SAAS,OAAO,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GACd,KAAK,CACV,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,cAAc,GAAG,mBAAmB,CACvC;KAAG,CAAC,IAAI,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC;CAAE,CAAC,WAAW,CAAC,CACrD,CAAC;AAIF,KAAK,eAAe,GAAG;KACpB,CAAC,IAAI,MAAM,cAAc,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE;CACtE,CAAC,MAAM,cAAc,CAAC,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,GAAG,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;AAE7D,KAAK,WAAW,CAAC,CAAC,SAAS,kBAAkB,IAC3C,CAAC,SAAS,GAAG,MAAM,MAAM,IAAI,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AAIzD,KAAK,QAAQ,CAAC,CAAC,SAAS,WAAW,IACjC,uBAAuB,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClD,CAAC,SAAS,WAAW,GACnB,CAAC,GACD,KAAK,GACP,KAAK,CAAC;AAEZ,KAAK,WAAW,CACd,CAAC,SAAS,WAAW,EACrB,IAAI,SAAS,WAAW,GAAG,KAAK,IAC9B,CAAC,SAAS,IAAI,GACd,KAAK,GACL,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,GACvB,KAAK,GACL,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;AAEvD,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,kBAAkB,IAC7D,GAAG,GACH,WAAW,CAAC,MAAM,CAAC,GACnB,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,WAAW,GACpC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAChC,KAAK,CAAC,CAAC;AAIf,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,kBAAkB,IAChE,MAAM,GACN;IAAE,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,kBAAkB,EACtE,UAAU,sBAAsB,CAAC,MAAM,CAAC;;;CAOzC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,kBAAkB,IAAI,CACtE,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,KACnC,IAAI,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,12 @@
+// src/types/events.ts
+var normalizeEventSelector = (selector) => {
+  if (typeof selector === "string") {
+    const source = selector.split(".")[0];
+    return { scope: source, event: selector };
+  }
+  return { scope: selector.scope, event: selector.event };
+};
+export {
+  normalizeEventSelector
+};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/events.ts"],"sourcesContent":["import type {\n  AssistantClientAccessor,\n  ClientEvents,\n  ClientNames,\n} from \"./client\";\n\n// --- Event Map Construction ---\ntype UnionToIntersection<U> = (\n  U extends unknown\n    ? (x: U) => void\n    : never\n) extends (x: infer I) => void\n  ? I\n  : never;\n\ntype ClientEventMap = UnionToIntersection<\n  { [K in ClientNames]: ClientEvents<K> }[ClientNames]\n>;\n\n// --- Core Types ---\n\ntype WildcardPayload = {\n  [K in keyof ClientEventMap]: { event: K; payload: ClientEventMap[K] };\n}[keyof ClientEventMap];\n\nexport type AssistantEventPayload = ClientEventMap & { \"*\": WildcardPayload };\n\nexport type AssistantEventName = keyof AssistantEventPayload;\n\ntype EventSource<T extends AssistantEventName> =\n  T extends `${infer Source}.${string}` ? Source : never;\n\n// --- Scoping ---\n\ntype ParentOf<K extends ClientNames> =\n  AssistantClientAccessor<K> extends { source: infer S }\n    ? S extends ClientNames\n      ? S\n      : never\n    : never;\n\ntype AncestorsOf<\n  K extends ClientNames,\n  Seen extends ClientNames = never,\n> = K extends Seen\n  ? never\n  : ParentOf<K> extends never\n    ? never\n    : ParentOf<K> | AncestorsOf<ParentOf<K>, Seen | K>;\n\n/** Valid scopes: `\"*\"` | event source | ancestors of event source */\nexport type AssistantEventScope<TEvent extends AssistantEventName> =\n  | \"*\"\n  | EventSource<TEvent>\n  | (EventSource<TEvent> extends ClientNames\n      ? AncestorsOf<EventSource<TEvent>>\n      : never);\n\n// --- Selection & Callbacks ---\n\nexport type AssistantEventSelector<TEvent extends AssistantEventName> =\n  | TEvent\n  | { scope: AssistantEventScope<TEvent>; event: TEvent };\n\nexport const normalizeEventSelector = <TEvent extends AssistantEventName>(\n  selector: AssistantEventSelector<TEvent>,\n) => {\n  if (typeof selector === \"string\") {\n    const source = selector.split(\".\")[0] as AssistantEventScope<TEvent>;\n    return { scope: source, event: selector };\n  }\n  return { scope: selector.scope, event: selector.event };\n};\n\nexport type AssistantEventCallback<TEvent extends AssistantEventName> = (\n  payload: AssistantEventPayload[TEvent],\n) => void;\n"],"mappings":";AAgEO,IAAM,yBAAyB,CACpC,aACG;AACH,MAAI,OAAO,aAAa,UAAU;AAChC,UAAM,SAAS,SAAS,MAAM,GAAG,EAAE,CAAC;AACpC,WAAO,EAAE,OAAO,QAAQ,OAAO,SAAS;AAAA,EAC1C;AACA,SAAO,EAAE,OAAO,SAAS,OAAO,OAAO,SAAS,MAAM;AACxD;","names":[]}

package/dist/useAssistantClient.d.ts

@@ -1,50 +1,17 @@
-import type { AssistantClient, AssistantScopes, ScopesInput, ScopeField } from "./types";
-import { type AssistantEvent, type AssistantEventCallback, type AssistantEventSelector } from "./EventContext";
+import type { AssistantClient, ClientNames, ClientElement } from "./types/client";
+import { DerivedElement } from "./Derived";
 /**
- * Hook to mount and access root scopes
- */
-export declare const useRootScopes: (rootScopes: ScopesInput, parent: AssistantClient) => {
-    scopes: {};
-    on: <TEvent extends AssistantEvent>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>) => () => void;
-    subscribe?: never;
-    flushSync?: never;
-} | {
-    scopes: { [K in "ERROR: No scopes were defined"]: ScopeField<AssistantScopes[K]>; };
-    subscribe: (callback: () => void) => () => void;
-    flushSync: () => void;
-    on: <TEvent extends AssistantEvent>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>) => () => void;
-};
-/**
- * Hook to mount and access derived scopes
- */
-export declare const useDerivedScopes: (derivedScopes: ScopesInput, parentClient: AssistantClient) => {
-    "ERROR: No scopes were defined"?: ScopeField<import("./types").ScopeDefinition<Record<string, unknown> & {
-        getState: () => Record<string, unknown>;
-    }, {
-        source: string;
-        query: Record<string, unknown>;
-    }, Record<string, unknown>>>;
-};
-/**
- * Hook to access or extend the AssistantClient
- *
- * @example Without config - returns the client from context:
- * ```typescript
- * const client = useAssistantClient();
- * const fooState = client.foo.getState();
- * ```
- *
- * @example With config - creates a new client with additional scopes:
- * ```typescript
- * const client = useAssistantClient({
- *   message: DerivedScope({
- *     source: "thread",
- *     query: { type: "index", index: 0 },
- *     get: () => messageApi,
- *   }),
- * });
- * ```
+ * Resource that creates an extended AssistantClient.
  */
+export declare const AssistantClientResource: import("@assistant-ui/tap").Resource<AssistantClient, {
+    baseClient: AssistantClient;
+    clients: useAssistantClient.Props;
+}>;
+export declare namespace useAssistantClient {
+    type Props = {
+        [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;
+    };
+}
 export declare function useAssistantClient(): AssistantClient;
-export declare function useAssistantClient(scopes: ScopesInput): AssistantClient;
+export declare function useAssistantClient(clients: useAssistantClient.Props): AssistantClient;
 //# sourceMappingURL=useAssistantClient.d.ts.map

package/dist/useAssistantClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantClient.d.ts","sourceRoot":"","sources":["../src/useAssistantClient.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,UAAU,EAGX,MAAM,SAAS,CAAC;AAIjB,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAqIxB;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,WAAW,EACvB,QAAQ,eAAe;;SApDT,MAAM,SAAS,cAAc,YAC7B,sBAAsB,CAAC,MAAM,CAAC,YAC9B,sBAAsB,CAAC,MAAM,CAAC;;;;YAoBjC,GACF,CAAC,mCAAuB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC3D;0BACqB,MAAM,IAAI;;SAzBxB,MAAM,SAAS,cAAc,YAC7B,sBAAsB,CAAC,MAAM,CAAC,YAC9B,sBAAsB,CAAC,MAAM,CAAC;CAqD7C,CAAC;AAqEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,WAAW,EAC1B,cAAc,eAAe;;;;;;;CAK9B,CAAC;AA0BF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAAC;AACtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC"}
+{"version":3,"file":"useAssistantClient.d.ts","sourceRoot":"","sources":["../src/useAssistantClient.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EACX,aAAa,EAEd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAW,cAAc,EAAE,MAAM,WAAW,CAAC;AAmOpD;;GAEG;AACH,eAAO,MAAM,uBAAuB;gBAKpB,eAAe;aAClB,kBAAkB,CAAC,KAAK;EA4CpC,CAAC;AAEF,yBAAiB,kBAAkB,CAAC;IAClC,KAAY,KAAK,GAAG;SACjB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;KAC1D,CAAC;CACH;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAAC;AACtD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,CAAC,KAAK,GAChC,eAAe,CAAC"}