@assistant-ui/store 0.0.0 → 0.0.2

package/dist/AssistantContext.js

@@ -20,6 +20,7 @@ var AssistantContext = createContext(
   new Proxy({}, {
     get(_, prop) {
       if (prop === "subscribe") return NO_OP_SUBSCRIBE;
+      if (prop === "on") return NO_OP_SUBSCRIBE;
       if (prop === "flushSync") return NO_OP_FLUSH_SYNC;
       if (hasRegisteredScope(prop))
         return NO_OP_SCOPE_FIELD;

package/dist/AssistantContext.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/AssistantContext.tsx"],"sourcesContent":["import React, { createContext, useContext } from \"react\";\nimport type { AssistantClient, AssistantScopes, ScopeField } from \"./types\";\nimport { hasRegisteredScope } from \"./ScopeRegistry\";\n\nconst NO_OP_SUBSCRIBE = () => () => {};\nconst NO_OP_FLUSH_SYNC = () => {};\nconst NO_OP_SCOPE_FIELD = (() => {\n  const fn = (() => {\n    throw new Error(\n      \"You need to wrap this component/hook in <AssistantProvider>\",\n    );\n  }) as ScopeField<never>;\n  fn.source = null;\n  fn.query = null;\n  return fn;\n})();\n\n/**\n * React Context for the AssistantClient\n */\nexport const AssistantContext = createContext<AssistantClient>(\n  new Proxy({} as AssistantClient, {\n    get(_, prop: string) {\n      // Allow access to subscribe and flushSync without error\n      if (prop === \"subscribe\") return NO_OP_SUBSCRIBE;\n\n      if (prop === \"flushSync\") return NO_OP_FLUSH_SYNC;\n\n      // If this is a registered scope, return a function that errors when called or accessed\n      if (hasRegisteredScope(prop as keyof AssistantScopes))\n        return NO_OP_SCOPE_FIELD;\n\n      return null;\n    },\n  }),\n);\n\nexport const useAssistantContextValue = (): AssistantClient => {\n  return useContext(AssistantContext);\n};\n\n/**\n * Provider component for AssistantClient\n *\n * @example\n * ```typescript\n * <AssistantProvider client={client}>\n *   <YourApp />\n * </AssistantProvider>\n * ```\n */\nexport const AssistantProvider = ({\n  client,\n  children,\n}: {\n  client: AssistantClient;\n  children: React.ReactNode;\n}): React.ReactElement => {\n  return (\n    <AssistantContext.Provider value={client}>\n      {children}\n    </AssistantContext.Provider>\n  );\n};\n"],"mappings":";AAAA,SAAgB,eAAe,kBAAkB;AAEjD,SAAS,0BAA0B;AAyD/B;AAvDJ,IAAM,kBAAkB,MAAM,MAAM;AAAC;AACrC,IAAM,mBAAmB,MAAM;AAAC;AAChC,IAAM,qBAAqB,MAAM;AAC/B,QAAM,MAAM,MAAM;AAChB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,KAAG,SAAS;AACZ,KAAG,QAAQ;AACX,SAAO;AACT,GAAG;AAKI,IAAM,mBAAmB;AAAA,EAC9B,IAAI,MAAM,CAAC,GAAsB;AAAA,IAC/B,IAAI,GAAG,MAAc;AAEnB,UAAI,SAAS,YAAa,QAAO;AAEjC,UAAI,SAAS,YAAa,QAAO;AAGjC,UAAI,mBAAmB,IAA6B;AAClD,eAAO;AAET,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;AAEO,IAAM,2BAA2B,MAAuB;AAC7D,SAAO,WAAW,gBAAgB;AACpC;AAYO,IAAM,oBAAoB,CAAC;AAAA,EAChC;AAAA,EACA;AACF,MAG0B;AACxB,SACE,oBAAC,iBAAiB,UAAjB,EAA0B,OAAO,QAC/B,UACH;AAEJ;","names":[]}
+{"version":3,"sources":["../src/AssistantContext.tsx"],"sourcesContent":["import React, { createContext, useContext } from \"react\";\nimport type { AssistantClient, AssistantScopes, ScopeField } from \"./types\";\nimport { hasRegisteredScope } from \"./ScopeRegistry\";\n\nconst NO_OP_SUBSCRIBE = () => () => {};\nconst NO_OP_FLUSH_SYNC = () => {};\nconst NO_OP_SCOPE_FIELD = (() => {\n  const fn = (() => {\n    throw new Error(\n      \"You need to wrap this component/hook in <AssistantProvider>\",\n    );\n  }) as ScopeField<never>;\n  fn.source = null;\n  fn.query = null;\n  return fn;\n})();\n\n/**\n * React Context for the AssistantClient\n */\nexport const AssistantContext = createContext<AssistantClient>(\n  new Proxy({} as AssistantClient, {\n    get(_, prop: string) {\n      // Allow access to subscribe and flushSync without error\n      if (prop === \"subscribe\") return NO_OP_SUBSCRIBE;\n      if (prop === \"on\") return NO_OP_SUBSCRIBE;\n      if (prop === \"flushSync\") return NO_OP_FLUSH_SYNC;\n\n      // If this is a registered scope, return a function that errors when called or accessed\n      if (hasRegisteredScope(prop as keyof AssistantScopes))\n        return NO_OP_SCOPE_FIELD;\n\n      return null;\n    },\n  }),\n);\n\nexport const useAssistantContextValue = (): AssistantClient => {\n  return useContext(AssistantContext);\n};\n\n/**\n * Provider component for AssistantClient\n *\n * @example\n * ```typescript\n * <AssistantProvider client={client}>\n *   <YourApp />\n * </AssistantProvider>\n * ```\n */\nexport const AssistantProvider = ({\n  client,\n  children,\n}: {\n  client: AssistantClient;\n  children: React.ReactNode;\n}): React.ReactElement => {\n  return (\n    <AssistantContext.Provider value={client}>\n      {children}\n    </AssistantContext.Provider>\n  );\n};\n"],"mappings":";AAAA,SAAgB,eAAe,kBAAkB;AAEjD,SAAS,0BAA0B;AAyD/B;AAvDJ,IAAM,kBAAkB,MAAM,MAAM;AAAC;AACrC,IAAM,mBAAmB,MAAM;AAAC;AAChC,IAAM,qBAAqB,MAAM;AAC/B,QAAM,MAAM,MAAM;AAChB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,KAAG,SAAS;AACZ,KAAG,QAAQ;AACX,SAAO;AACT,GAAG;AAKI,IAAM,mBAAmB;AAAA,EAC9B,IAAI,MAAM,CAAC,GAAsB;AAAA,IAC/B,IAAI,GAAG,MAAc;AAEnB,UAAI,SAAS,YAAa,QAAO;AACjC,UAAI,SAAS,KAAM,QAAO;AAC1B,UAAI,SAAS,YAAa,QAAO;AAGjC,UAAI,mBAAmB,IAA6B;AAClD,eAAO;AAET,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;AAEO,IAAM,2BAA2B,MAAuB;AAC7D,SAAO,WAAW,gBAAgB;AACpC;AAYO,IAAM,oBAAoB,CAAC;AAAA,EAChC;AAAA,EACA;AACF,MAG0B;AACxB,SACE,oBAAC,iBAAiB,UAAjB,EAA0B,OAAO,QAC/B,UACH;AAEJ;","names":[]}

package/dist/AssistantIf.d.ts

@@ -0,0 +1,12 @@
+import type { FC, PropsWithChildren } from "react";
+import type { AssistantState } from "./types";
+type UseAssistantIfProps = {
+    condition: AssistantIf.Condition;
+};
+export declare namespace AssistantIf {
+    type Props = PropsWithChildren<UseAssistantIfProps>;
+    type Condition = (state: AssistantState) => boolean;
+}
+export declare const AssistantIf: FC<AssistantIf.Props>;
+export {};
+//# sourceMappingURL=AssistantIf.d.ts.map

package/dist/AssistantIf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantIf.d.ts","sourceRoot":"","sources":["../src/AssistantIf.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,KAAK,mBAAmB,GAAG;IACzB,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC;CAClC,CAAC;AAMF,yBAAiB,WAAW,CAAC;IAC3B,KAAY,KAAK,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAC3D,KAAY,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;CAC5D;AAED,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAG7C,CAAC"}

package/dist/AssistantIf.js

@@ -0,0 +1,16 @@
+"use client";
+
+// src/AssistantIf.tsx
+import { useAssistantState } from "./useAssistantState.js";
+var useAssistantIf = (props) => {
+  return useAssistantState(props.condition);
+};
+var AssistantIf = ({ children, condition }) => {
+  const result = useAssistantIf({ condition });
+  return result ? children : null;
+};
+AssistantIf.displayName = "AssistantIf";
+export {
+  AssistantIf
+};
+//# sourceMappingURL=AssistantIf.js.map

package/dist/AssistantIf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AssistantIf.tsx"],"sourcesContent":["\"use client\";\n\nimport type { FC, PropsWithChildren } from \"react\";\nimport { useAssistantState } from \"./useAssistantState\";\nimport type { AssistantState } from \"./types\";\n\ntype UseAssistantIfProps = {\n  condition: AssistantIf.Condition;\n};\n\nconst useAssistantIf = (props: UseAssistantIfProps) => {\n  return useAssistantState(props.condition);\n};\n\nexport namespace AssistantIf {\n  export type Props = PropsWithChildren<UseAssistantIfProps>;\n  export type Condition = (state: AssistantState) => boolean;\n}\n\nexport const AssistantIf: FC<AssistantIf.Props> = ({ children, condition }) => {\n  const result = useAssistantIf({ condition });\n  return result ? children : null;\n};\n\nAssistantIf.displayName = \"AssistantIf\";\n"],"mappings":";;;AAGA,SAAS,yBAAyB;AAOlC,IAAM,iBAAiB,CAAC,UAA+B;AACrD,SAAO,kBAAkB,MAAM,SAAS;AAC1C;AAOO,IAAM,cAAqC,CAAC,EAAE,UAAU,UAAU,MAAM;AAC7E,QAAM,SAAS,eAAe,EAAE,UAAU,CAAC;AAC3C,SAAO,SAAS,WAAW;AAC7B;AAEA,YAAY,cAAc;","names":[]}

package/dist/DerivedScope.d.ts

@@ -1,18 +1,20 @@
-import type { ScopeDefinition, ScopeValue, DerivedScopeProps } from "./types";
+import type { ScopeDefinition, DerivedScopeProps } from "./types";
 /**
  * Creates a derived scope field that memoizes based on source and query.
  * The get callback always calls the most recent version (useEffectEvent pattern).
  *
  * @example
  * ```typescript
- * const MessageScope = DerivedScope<MessageScopeDefinition>({
- *   source: "thread",
- *   query: { type: "index", index: 0 },
- *   get: () => messageApi,
+ * const client = useAssistantClient({
+ *   message: DerivedScope({
+ *     source: "thread",
+ *     query: { index: 0 },
+ *     get: (client) => client.thread().message({ index: 0 }),
+ *   }),
  * });
  * ```
  */
 export declare const DerivedScope: <T extends ScopeDefinition>(props: DerivedScopeProps<T>, options?: {
     key?: string | number;
-} | undefined) => import("@assistant-ui/tap").ResourceElement<ScopeValue<T>, DerivedScopeProps<T>>;
+} | undefined) => import("@assistant-ui/tap").ResourceElement<null, DerivedScopeProps<T>>;
 //# sourceMappingURL=DerivedScope.d.ts.map

package/dist/DerivedScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DerivedScope.d.ts","sourceRoot":"","sources":["../src/DerivedScope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,eAAe;;kGAG3B,CAAC"}
+{"version":3,"file":"DerivedScope.d.ts","sourceRoot":"","sources":["../src/DerivedScope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,eAAe;;yFAG3B,CAAC"}

package/dist/DerivedScope.js

@@ -1,8 +1,8 @@
 // src/DerivedScope.ts
 import { resource } from "@assistant-ui/tap";
 var DerivedScope = resource(
-  (config) => {
-    return config;
+  (_config) => {
+    return null;
   }
 );
 export {

package/dist/DerivedScope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/DerivedScope.ts"],"sourcesContent":["import { resource } from \"@assistant-ui/tap\";\nimport type { ScopeDefinition, ScopeValue, DerivedScopeProps } from \"./types\";\n\n/**\n * Creates a derived scope field that memoizes based on source and query.\n * The get callback always calls the most recent version (useEffectEvent pattern).\n *\n * @example\n * ```typescript\n * const MessageScope = DerivedScope<MessageScopeDefinition>({\n *   source: \"thread\",\n *   query: { type: \"index\", index: 0 },\n *   get: () => messageApi,\n * });\n * ```\n */\nexport const DerivedScope = resource(\n  <T extends ScopeDefinition>(config: DerivedScopeProps<T>): ScopeValue<T> => {\n    return config;\n  },\n);\n"],"mappings":";AAAA,SAAS,gBAAgB;AAgBlB,IAAM,eAAe;AAAA,EAC1B,CAA4B,WAAgD;AAC1E,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../src/DerivedScope.ts"],"sourcesContent":["import { resource } from \"@assistant-ui/tap\";\nimport type { ScopeDefinition, DerivedScopeProps } from \"./types\";\n\n/**\n * Creates a derived scope field that memoizes based on source and query.\n * The get callback always calls the most recent version (useEffectEvent pattern).\n *\n * @example\n * ```typescript\n * const client = useAssistantClient({\n *   message: DerivedScope({\n *     source: \"thread\",\n *     query: { index: 0 },\n *     get: (client) => client.thread().message({ index: 0 }),\n *   }),\n * });\n * ```\n */\nexport const DerivedScope = resource(\n  <T extends ScopeDefinition>(_config: DerivedScopeProps<T>): null => {\n    return null;\n  },\n);\n"],"mappings":";AAAA,SAAS,gBAAgB;AAkBlB,IAAM,eAAe;AAAA,EAC1B,CAA4B,YAAwC;AAClE,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/EventContext.d.ts

@@ -0,0 +1,61 @@
+import type { AssistantScopes, Unsubscribe } from "./types";
+/**
+ * Module augmentation interface for event scope configuration.
+ * Maps event sources to their parent scopes.
+ *
+ * @example
+ * ```typescript
+ * declare module "@assistant-ui/store" {
+ *   interface AssistantEventScopeConfig {
+ *     composer: "thread" | "message";
+ *     thread: never;
+ *   }
+ * }
+ * ```
+ */
+export interface AssistantEventScopeConfig {
+}
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+/**
+ * Event map derived from scope event definitions
+ */
+export type ScopeEventMap = UnionToIntersection<{
+    [K in keyof AssistantScopes]: AssistantScopes[K] extends {
+        events: infer E;
+    } ? E extends Record<string, unknown> ? E : never : never;
+}[keyof AssistantScopes]>;
+type WildcardPayload = {
+    [K in keyof ScopeEventMap]: {
+        event: K;
+        payload: ScopeEventMap[K];
+    };
+}[keyof ScopeEventMap];
+export type AssistantEventMap = ScopeEventMap & {
+    "*": WildcardPayload;
+};
+export type AssistantEvent = keyof AssistantEventMap;
+export type EventSource<T extends AssistantEvent = AssistantEvent> = T extends `${infer Source}.${string}` ? Source : never;
+export type SourceByScope<TScope extends AssistantEventScope<AssistantEvent>> = (TScope extends "*" ? EventSource : never) | (TScope extends keyof AssistantEventScopeConfig ? TScope : never) | {
+    [K in keyof AssistantEventScopeConfig]: TScope extends AssistantEventScopeConfig[K] ? K : never;
+}[keyof AssistantEventScopeConfig];
+export type AssistantEventScope<TEvent extends AssistantEvent> = "*" | EventSource<TEvent> | (EventSource<TEvent> extends keyof AssistantEventScopeConfig ? AssistantEventScopeConfig[EventSource<TEvent>] : never);
+export type AssistantEventSelector<TEvent extends AssistantEvent> = TEvent | {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export declare const normalizeEventSelector: <TEvent extends AssistantEvent>(selector: AssistantEventSelector<TEvent>) => {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export declare const checkEventScope: <TEvent extends AssistantEvent, TExpectedScope extends AssistantEventScope<AssistantEvent>>(expectedScope: TExpectedScope, scope: AssistantEventScope<TEvent>, _event: TEvent) => _event is Extract<TEvent, `${SourceByScope<TExpectedScope>}.${string}`>;
+export type AssistantEventCallback<TEvent extends AssistantEvent> = (payload: AssistantEventMap[TEvent]) => void;
+export type EventManager = {
+    on<TEvent extends AssistantEvent>(event: TEvent, callback: AssistantEventCallback<TEvent>): Unsubscribe;
+    emit<TEvent extends Exclude<AssistantEvent, "*">>(event: TEvent, payload: AssistantEventMap[TEvent]): void;
+};
+export declare const EventManager: () => import("@assistant-ui/tap").ResourceElement<{
+    on: <TEvent extends AssistantEvent>(event: TEvent, callback: AssistantEventCallback<TEvent>) => () => void;
+    emit: <TEvent extends Exclude<AssistantEvent, "*">>(event: TEvent, payload: AssistantEventMap[TEvent]) => void;
+}, undefined>;
+export {};
+//# sourceMappingURL=EventContext.d.ts.map

package/dist/EventContext.d.ts.map

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

package/dist/EventContext.js

@@ -0,0 +1,62 @@
+// src/EventContext.ts
+import { resource, tapMemo } from "@assistant-ui/tap";
+var normalizeEventSelector = (selector) => {
+  if (typeof selector === "string") {
+    const source = selector.split(".")[0];
+    return {
+      scope: source,
+      event: selector
+    };
+  }
+  return {
+    scope: selector.scope,
+    event: selector.event
+  };
+};
+var checkEventScope = (expectedScope, scope, _event) => {
+  return scope === expectedScope;
+};
+var EventManager = resource(() => {
+  const events = tapMemo(() => {
+    const listeners = /* @__PURE__ */ new Map();
+    return {
+      on: (event, callback) => {
+        if (!listeners.has(event)) {
+          listeners.set(event, /* @__PURE__ */ new Set());
+        }
+        const eventListeners = listeners.get(event);
+        eventListeners.add(callback);
+        return () => {
+          eventListeners.delete(callback);
+          if (eventListeners.size === 0) {
+            listeners.delete(event);
+          }
+        };
+      },
+      emit: (event, payload) => {
+        const eventListeners = listeners.get(event);
+        const wildcardListeners = listeners.get("*");
+        if (!eventListeners && !wildcardListeners) return;
+        queueMicrotask(() => {
+          if (eventListeners) {
+            for (const callback of eventListeners) {
+              callback(payload);
+            }
+          }
+          if (wildcardListeners) {
+            for (const callback of wildcardListeners) {
+              callback({ event, payload });
+            }
+          }
+        });
+      }
+    };
+  }, []);
+  return events;
+});
+export {
+  EventManager,
+  checkEventScope,
+  normalizeEventSelector
+};
+//# sourceMappingURL=EventContext.js.map

package/dist/EventContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/EventContext.ts"],"sourcesContent":["import { resource, tapMemo } from \"@assistant-ui/tap\";\nimport type { AssistantScopes, Unsubscribe } from \"./types\";\n\n/**\n * Module augmentation interface for event scope configuration.\n * Maps event sources to their parent scopes.\n *\n * @example\n * ```typescript\n * declare module \"@assistant-ui/store\" {\n *   interface AssistantEventScopeConfig {\n *     composer: \"thread\" | \"message\";\n *     thread: never;\n *   }\n * }\n * ```\n */\nexport interface AssistantEventScopeConfig {}\n\ntype UnionToIntersection<U> = (\n  U extends unknown\n    ? (x: U) => void\n    : never\n) extends (x: infer I) => void\n  ? I\n  : never;\n\n/**\n * Event map derived from scope event definitions\n */\nexport type ScopeEventMap = UnionToIntersection<\n  {\n    [K in keyof AssistantScopes]: AssistantScopes[K] extends {\n      events: infer E;\n    }\n      ? E extends Record<string, unknown>\n        ? E\n        : never\n      : never;\n  }[keyof AssistantScopes]\n>;\n\ntype WildcardPayload = {\n  [K in keyof ScopeEventMap]: {\n    event: K;\n    payload: ScopeEventMap[K];\n  };\n}[keyof ScopeEventMap];\n\nexport type AssistantEventMap = ScopeEventMap & {\n  // Catch-all\n  \"*\": WildcardPayload;\n};\n\nexport type AssistantEvent = keyof AssistantEventMap;\n\nexport type EventSource<T extends AssistantEvent = AssistantEvent> =\n  T extends `${infer Source}.${string}` ? Source : never;\n\nexport type SourceByScope<TScope extends AssistantEventScope<AssistantEvent>> =\n  | (TScope extends \"*\" ? EventSource : never)\n  | (TScope extends keyof AssistantEventScopeConfig ? TScope : never)\n  | {\n      [K in keyof AssistantEventScopeConfig]: TScope extends AssistantEventScopeConfig[K]\n        ? K\n        : never;\n    }[keyof AssistantEventScopeConfig];\n\nexport type AssistantEventScope<TEvent extends AssistantEvent> =\n  | \"*\"\n  | EventSource<TEvent>\n  | (EventSource<TEvent> extends keyof AssistantEventScopeConfig\n      ? AssistantEventScopeConfig[EventSource<TEvent>]\n      : never);\n\nexport type AssistantEventSelector<TEvent extends AssistantEvent> =\n  | TEvent\n  | {\n      scope: AssistantEventScope<TEvent>;\n      event: TEvent;\n    };\n\nexport const normalizeEventSelector = <TEvent extends AssistantEvent>(\n  selector: AssistantEventSelector<TEvent>,\n) => {\n  if (typeof selector === \"string\") {\n    const source = selector.split(\".\")[0] as AssistantEventScope<TEvent>;\n    return {\n      scope: source,\n      event: selector,\n    };\n  }\n\n  return {\n    scope: selector.scope,\n    event: selector.event,\n  };\n};\n\nexport const checkEventScope = <\n  TEvent extends AssistantEvent,\n  TExpectedScope extends AssistantEventScope<AssistantEvent>,\n>(\n  expectedScope: TExpectedScope,\n  scope: AssistantEventScope<TEvent>,\n  _event: TEvent,\n): _event is Extract<TEvent, `${SourceByScope<TExpectedScope>}.${string}`> => {\n  return scope === expectedScope;\n};\n\nexport type AssistantEventCallback<TEvent extends AssistantEvent> = (\n  payload: AssistantEventMap[TEvent],\n) => void;\n\nexport type EventManager = {\n  on<TEvent extends AssistantEvent>(\n    event: TEvent,\n    callback: AssistantEventCallback<TEvent>,\n  ): Unsubscribe;\n  emit<TEvent extends Exclude<AssistantEvent, \"*\">>(\n    event: TEvent,\n    payload: AssistantEventMap[TEvent],\n  ): void;\n};\n\ntype ListenerMap = Omit<\n  Map<AssistantEvent, Set<AssistantEventCallback<AssistantEvent>>>,\n  \"get\" | \"set\"\n> & {\n  get<TEvent extends AssistantEvent>(\n    event: TEvent,\n  ): Set<AssistantEventCallback<TEvent>> | undefined;\n  set<TEvent extends AssistantEvent>(\n    event: TEvent,\n    value: Set<AssistantEventCallback<TEvent>>,\n  ): void;\n};\n\nexport const EventManager = resource(() => {\n  const events = tapMemo(() => {\n    const listeners: ListenerMap = new Map();\n\n    return {\n      on: (event, callback) => {\n        if (!listeners.has(event)) {\n          listeners.set(event, new Set());\n        }\n\n        const eventListeners = listeners.get(event)!;\n        eventListeners.add(callback);\n\n        return () => {\n          eventListeners.delete(callback);\n          if (eventListeners.size === 0) {\n            listeners.delete(event);\n          }\n        };\n      },\n\n      emit: (event, payload) => {\n        const eventListeners = listeners.get(event);\n        const wildcardListeners = listeners.get(\"*\");\n\n        if (!eventListeners && !wildcardListeners) return;\n\n        // make sure state updates flush\n        queueMicrotask(() => {\n          // Emit to specific event listeners\n          if (eventListeners) {\n            for (const callback of eventListeners) {\n              callback(payload);\n            }\n          }\n\n          // Emit to wildcard listeners\n          if (wildcardListeners) {\n            for (const callback of wildcardListeners) {\n              callback({ event, payload } as any);\n            }\n          }\n        });\n      },\n    } satisfies EventManager;\n  }, []);\n\n  return events;\n});\n"],"mappings":";AAAA,SAAS,UAAU,eAAe;AAkF3B,IAAM,yBAAyB,CACpC,aACG;AACH,MAAI,OAAO,aAAa,UAAU;AAChC,UAAM,SAAS,SAAS,MAAM,GAAG,EAAE,CAAC;AACpC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,SAAS;AAAA,IAChB,OAAO,SAAS;AAAA,EAClB;AACF;AAEO,IAAM,kBAAkB,CAI7B,eACA,OACA,WAC4E;AAC5E,SAAO,UAAU;AACnB;AA8BO,IAAM,eAAe,SAAS,MAAM;AACzC,QAAM,SAAS,QAAQ,MAAM;AAC3B,UAAM,YAAyB,oBAAI,IAAI;AAEvC,WAAO;AAAA,MACL,IAAI,CAAC,OAAO,aAAa;AACvB,YAAI,CAAC,UAAU,IAAI,KAAK,GAAG;AACzB,oBAAU,IAAI,OAAO,oBAAI,IAAI,CAAC;AAAA,QAChC;AAEA,cAAM,iBAAiB,UAAU,IAAI,KAAK;AAC1C,uBAAe,IAAI,QAAQ;AAE3B,eAAO,MAAM;AACX,yBAAe,OAAO,QAAQ;AAC9B,cAAI,eAAe,SAAS,GAAG;AAC7B,sBAAU,OAAO,KAAK;AAAA,UACxB;AAAA,QACF;AAAA,MACF;AAAA,MAEA,MAAM,CAAC,OAAO,YAAY;AACxB,cAAM,iBAAiB,UAAU,IAAI,KAAK;AAC1C,cAAM,oBAAoB,UAAU,IAAI,GAAG;AAE3C,YAAI,CAAC,kBAAkB,CAAC,kBAAmB;AAG3C,uBAAe,MAAM;AAEnB,cAAI,gBAAgB;AAClB,uBAAW,YAAY,gBAAgB;AACrC,uBAAS,OAAO;AAAA,YAClB;AAAA,UACF;AAGA,cAAI,mBAAmB;AACrB,uBAAW,YAAY,mBAAmB;AACxC,uBAAS,EAAE,OAAO,QAAQ,CAAQ;AAAA,YACpC;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO;AACT,CAAC;","names":[]}

package/dist/StoreContext.d.ts

@@ -0,0 +1,9 @@
+import type { EventManager } from "./EventContext";
+import type { AssistantClient } from "./types";
+export type StoreContextValue = {
+    events: EventManager;
+    parent: AssistantClient;
+};
+export declare const withStoreContextProvider: <TResult>(value: StoreContextValue, fn: () => TResult) => TResult;
+export declare const tapStoreContext: () => StoreContextValue;
+//# sourceMappingURL=StoreContext.d.ts.map

package/dist/StoreContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreContext.d.ts","sourceRoot":"","sources":["../src/StoreContext.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAIF,eAAO,MAAM,wBAAwB,GAAI,OAAO,EAC9C,OAAO,iBAAiB,EACxB,IAAI,MAAM,OAAO,YAGlB,CAAC;AAEF,eAAO,MAAM,eAAe,yBAK3B,CAAC"}

package/dist/StoreContext.js

@@ -0,0 +1,20 @@
+// src/StoreContext.ts
+import {
+  createContext,
+  tapContext,
+  withContextProvider
+} from "@assistant-ui/tap";
+var StoreContext = createContext(null);
+var withStoreContextProvider = (value, fn) => {
+  return withContextProvider(StoreContext, value, fn);
+};
+var tapStoreContext = () => {
+  const ctx = tapContext(StoreContext);
+  if (!ctx) throw new Error("Store context is not available");
+  return ctx;
+};
+export {
+  tapStoreContext,
+  withStoreContextProvider
+};
+//# sourceMappingURL=StoreContext.js.map

package/dist/StoreContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/StoreContext.ts"],"sourcesContent":["import {\n  createContext,\n  tapContext,\n  withContextProvider,\n} from \"@assistant-ui/tap\";\nimport type { EventManager } from \"./EventContext\";\nimport type { AssistantClient } from \"./types\";\n\nexport type StoreContextValue = {\n  events: EventManager;\n  parent: AssistantClient;\n};\n\nconst StoreContext = createContext<StoreContextValue | null>(null);\n\nexport const withStoreContextProvider = <TResult>(\n  value: StoreContextValue,\n  fn: () => TResult,\n) => {\n  return withContextProvider(StoreContext, value, fn);\n};\n\nexport const tapStoreContext = () => {\n  const ctx = tapContext(StoreContext);\n  if (!ctx) throw new Error(\"Store context is not available\");\n\n  return ctx;\n};\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,IAAM,eAAe,cAAwC,IAAI;AAE1D,IAAM,2BAA2B,CACtC,OACA,OACG;AACH,SAAO,oBAAoB,cAAc,OAAO,EAAE;AACpD;AAEO,IAAM,kBAAkB,MAAM;AACnC,QAAM,MAAM,WAAW,YAAY;AACnC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,gCAAgC;AAE1D,SAAO;AACT;","names":[]}

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 export { useAssistantClient } from "./useAssistantClient";
 export { useAssistantState } from "./useAssistantState";
+export { useAssistantEvent } from "./useAssistantEvent";
+export { AssistantIf } from "./AssistantIf";
 export { AssistantProvider } from "./AssistantContext";
-export type { AssistantScopes, AssistantClient, AssistantState } from "./types";
 export { DerivedScope } from "./DerivedScope";
-export type { ApiObject } from "./tapApi";
-export { tapApi } from "./tapApi";
+export { tapApi, type ApiObject } from "./tapApi";
+export { tapStoreContext, type StoreContextValue } from "./StoreContext";
 export { tapLookupResources } from "./tapLookupResources";
-export { tapStoreList } from "./tapStoreList";
-export type { TapStoreListConfig } from "./tapStoreList";
+export { tapStoreList, type TapStoreListConfig } from "./tapStoreList";
 export { registerAssistantScope } from "./ScopeRegistry";
-export type { AssistantScopeRegistry } from "./types";
+export type { AssistantScopes, AssistantScopeRegistry, AssistantClient, AssistantState, } from "./types";
+export type { AssistantEvent, AssistantEventScopeConfig, AssistantEventMap, AssistantEventScope, AssistantEventSelector, AssistantEventCallback, EventSource, SourceByScope, EventManager, } from "./EventContext";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,20 +1,26 @@
 // src/index.ts
 import { useAssistantClient } from "./useAssistantClient.js";
 import { useAssistantState } from "./useAssistantState.js";
+import { useAssistantEvent } from "./useAssistantEvent.js";
+import { AssistantIf } from "./AssistantIf.js";
 import { AssistantProvider } from "./AssistantContext.js";
 import { DerivedScope } from "./DerivedScope.js";
 import { tapApi } from "./tapApi.js";
+import { tapStoreContext } from "./StoreContext.js";
 import { tapLookupResources } from "./tapLookupResources.js";
 import { tapStoreList } from "./tapStoreList.js";
 import { registerAssistantScope } from "./ScopeRegistry.js";
 export {
+  AssistantIf,
   AssistantProvider,
   DerivedScope,
   registerAssistantScope,
   tapApi,
   tapLookupResources,
+  tapStoreContext,
   tapStoreList,
   useAssistantClient,
+  useAssistantEvent,
   useAssistantState
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { useAssistantClient } from \"./useAssistantClient\";\nexport { useAssistantState } from \"./useAssistantState\";\nexport { AssistantProvider } from \"./AssistantContext\";\nexport type { AssistantScopes, AssistantClient, AssistantState } from \"./types\";\nexport { DerivedScope } from \"./DerivedScope\";\nexport type { ApiObject } from \"./tapApi\";\nexport { tapApi } from \"./tapApi\";\nexport { tapLookupResources } from \"./tapLookupResources\";\nexport { tapStoreList } from \"./tapStoreList\";\nexport type { TapStoreListConfig } from \"./tapStoreList\";\nexport { registerAssistantScope } from \"./ScopeRegistry\";\n\nexport type { AssistantScopeRegistry } from \"./types\";\n"],"mappings":";AAAA,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAElC,SAAS,oBAAoB;AAE7B,SAAS,cAAc;AACvB,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AAE7B,SAAS,8BAA8B;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// hooks\nexport { useAssistantClient } from \"./useAssistantClient\";\nexport { useAssistantState } from \"./useAssistantState\";\nexport { useAssistantEvent } from \"./useAssistantEvent\";\n\n// components\nexport { AssistantIf } from \"./AssistantIf\";\nexport { AssistantProvider } from \"./AssistantContext\";\n\n// resources\nexport { DerivedScope } from \"./DerivedScope\";\n\n// tap hooks\nexport { tapApi, type ApiObject } from \"./tapApi\";\nexport { tapStoreContext, type StoreContextValue } from \"./StoreContext\";\nexport { tapLookupResources } from \"./tapLookupResources\";\nexport { tapStoreList, type TapStoreListConfig } from \"./tapStoreList\";\n\n// registration\nexport { registerAssistantScope } from \"./ScopeRegistry\";\n\n// types\nexport type {\n  AssistantScopes,\n  AssistantScopeRegistry,\n  AssistantClient,\n  AssistantState,\n} from \"./types\";\n\nexport type {\n  AssistantEvent,\n  AssistantEventScopeConfig,\n  AssistantEventMap,\n  AssistantEventScope,\n  AssistantEventSelector,\n  AssistantEventCallback,\n  EventSource,\n  SourceByScope,\n  EventManager,\n} from \"./EventContext\";\n"],"mappings":";AACA,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAGlC,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAGlC,SAAS,oBAAoB;AAG7B,SAAS,cAA8B;AACvC,SAAS,uBAA+C;AACxD,SAAS,0BAA0B;AACnC,SAAS,oBAA6C;AAGtD,SAAS,8BAA8B;","names":[]}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { ResourceElement } from "@assistant-ui/tap";
+import type { AssistantEvent, AssistantEventCallback, AssistantEventSelector } from "./EventContext";
 /**
  * Module augmentation interface for assistant-ui store type extensions.
  *
@@ -8,8 +9,19 @@ import type { ResourceElement } from "@assistant-ui/tap";
  *   interface AssistantScopeRegistry {
  *     foo: {
  *       value: { getState: () => { bar: string }; updateBar: (bar: string) => void };
- *       source: "root";
- *       query: Record<string, never>;
+ *       meta: { source: "root"; query: Record<string, never> };
+ *       events: {
+ *         "foo.updated": { id: string; newValue: string };
+ *         "foo.deleted": { id: string };
+ *       };
+ *     };
+ *     // Example with multiple sources (discriminated union):
+ *     bar: {
+ *       value: { getState: () => { id: string } };
+ *       meta:
+ *         | { source: "fooList"; query: { index: number } }
+ *         | { source: "barList"; query: { id: string } };
+ *       events: Record<string, never>;
  *     };
  *   }
  * }
@@ -20,26 +32,11 @@ export interface AssistantScopeRegistry {
 export type AssistantScopes = keyof AssistantScopeRegistry extends never ? Record<"ERROR: No scopes were defined", ScopeDefinition> : {
     [K in keyof AssistantScopeRegistry]: AssistantScopeRegistry[K];
 };
-/**
- * Helper type to extract the value type from a scope definition
- */
-export type ScopeValue<T extends ScopeDefinition> = T["value"];
-/**
- * Helper type to extract the source type from a scope definition
- */
-export type ScopeSource<T extends ScopeDefinition> = T["source"];
-/**
- * Helper type to extract the query type from a scope definition
- */
-export type ScopeQuery<T extends ScopeDefinition> = T["query"];
 /**
  * Type for a scope field - a function that returns the current API value,
- * with source and query metadata attached
+ * with source/query metadata attached (derived from meta)
  */
-export type ScopeField<T extends ScopeDefinition> = (() => ScopeValue<T>) & ({
-    source: ScopeSource<T>;
-    query: ScopeQuery<T>;
-} | {
+export type ScopeField<T extends ScopeDefinition> = (() => T["value"]) & (T["meta"] | {
     source: null;
     query: null;
 });
@@ -47,16 +44,16 @@ export type ScopeField<T extends ScopeDefinition> = (() => ScopeValue<T>) & ({
  * Props passed to a derived scope resource element
  */
 export type DerivedScopeProps<T extends ScopeDefinition> = {
-    get: (parent: AssistantClient) => ScopeValue<T>;
-    source: ScopeSource<T>;
-    query: ScopeQuery<T>;
+    get: (parent: AssistantClient) => T["value"];
+    source: T["meta"]["source"];
+    query: T["meta"]["query"];
 };
 /**
  * Input type for scope definitions - ResourceElement that returns the API value
  * Can optionally include source/query metadata via DerivedScope
  */
 export type ScopeInput<T extends ScopeDefinition> = ResourceElement<{
-    api: ScopeValue<T>;
+    api: T["value"];
 }>;
 /**
  * Map of scope names to their input definitions
@@ -82,5 +79,6 @@ export type AssistantClient = {
 } & {
     subscribe(listener: () => void): Unsubscribe;
     flushSync(): void;
+    on<TEvent extends AssistantEvent>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>): Unsubscribe;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBzD;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,MAAM,eAAe,GAAG,MAAM,sBAAsB,SAAS,KAAK,GACpE,MAAM,CAAC,+BAA+B,EAAE,eAAe,CAAC,GACxD;KAAG,CAAC,IAAI,MAAM,sBAAsB,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAAE,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC,GACvE,CACI;IACE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACtB,GACD;IACE,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,CACJ,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI;IACzD,GAAG,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,eAAe,CAAC;IAClE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;KACvB,CAAC,IAAI,MAAM,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,MAAM,eAAe,GAAG,UAAU,CACtC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CACxC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAC7D,GAAG;IACF,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAC7C,SAAS,IAAI,IAAI,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAwBxB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,MAAM,eAAe,GAAG,MAAM,sBAAsB,SAAS,KAAK,GACpE,MAAM,CAAC,+BAA+B,EAAE,eAAe,CAAC,GACxD;KAAG,CAAC,IAAI,MAAM,sBAAsB,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAAE,CAAC;AACvE;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GACpE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI;IACzD,GAAG,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI,eAAe,CAAC;IAClE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;KACvB,CAAC,IAAI,MAAM,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,MAAM,eAAe,GAAG,UAAU,CACtC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CACxC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAC7D,GAAG;IACF,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAC7C,SAAS,IAAI,IAAI,CAAC;IAClB,EAAE,CAAC,MAAM,SAAS,cAAc,EAC9B,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACxC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,GACvC,WAAW,CAAC;CAChB,CAAC"}

package/dist/useAssistantClient.d.ts

@@ -1,21 +1,29 @@
 import type { AssistantClient, AssistantScopes, ScopesInput, ScopeField } from "./types";
+import { type AssistantEvent, type AssistantEventCallback, type AssistantEventSelector } from "./EventContext";
 /**
  * Hook to mount and access root scopes
  */
-export declare const useRootScopes: (rootScopes: ScopesInput) => {
+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<any, any, any>>;
+    "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

package/dist/useAssistantClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantClient.d.ts","sourceRoot":"","sources":["../src/useAssistantClient.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,UAAU,EAGX,MAAM,SAAS,CAAC;AA6FjB;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,WAAW;;;;;YA1B1C,GACF,CAAC,mCAAuB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC3D;0BACqB,MAAM,IAAI;;CAyBrC,CAAC;AAqEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,WAAW,EAC1B,cAAc,eAAe;;CAK9B,CAAC;AAyBF;;;;;;;;;;;;;;;;;;;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":"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"}