@useago/sdk 0.1.6 → 0.2.0

package/dist/client/AgoClient.d.ts

@@ -1,4 +1,5 @@
 import type { ClientFunctionDefinition, ClientFunctionHandler, ClientFunctionSchema } from "../functions/types";
+import type { ContextEntry, ContextSnapshot, DynamicContextProvider } from "../state/ClientContextRegistry";
 import type { AgoConfig, AgoClientEvents, AgoEventName, AgoEventHandler, AgoMessage, Conversation, SendMessageOptions } from "./types";
 /**
  * Main SDK client for AGO Chat integration
@@ -6,6 +7,7 @@ import type { AgoConfig, AgoClientEvents, AgoEventName, AgoEventHandler, AgoMess
 export declare class AgoClient {
     private httpClient;
     private functionRegistry;
+    private contextRegistry;
     private eventEmitter;
     private config;
     constructor(config: AgoConfig);
@@ -62,6 +64,15 @@ export declare class AgoClient {
      */
     registerFunction(definition: ClientFunctionDefinition): void;
     registerFunction(name: string, handler: ClientFunctionHandler, schema: Omit<ClientFunctionSchema, "name">): void;
+    /**
+     * Short alias for `registerFunction`. Also accepts an array of definitions.
+     *
+     * ```ts
+     * client.register(lookupOrder);
+     * client.register([lookupOrder, cancelOrder]);
+     * ```
+     */
+    register(definition: ClientFunctionDefinition | ClientFunctionDefinition[]): void;
     /**
      * Unregister a client-side function
      */
@@ -80,6 +91,51 @@ export declare class AgoClient {
         path: string;
         description: string;
     }>): void;
+    /**
+     * Register or update a piece of client-side context.
+     * This context is sent with every message so the AI understands the user's situation.
+     *
+     * ```ts
+     * client.setContext("order-page", {
+     *   name: "Order detail",
+     *   description: "User is viewing order #123",
+     *   data: { orderId: "123", status: "shipped" },
+     * });
+     * ```
+     */
+    setContext(key: string, entry: ContextEntry): void;
+    /**
+     * Remove a previously registered context entry.
+     */
+    removeContext(key: string): boolean;
+    /**
+     * Register a dynamic context provider. The callback is invoked every time
+     * a message is sent, so the AI always gets the freshest data.
+     *
+     * Use this for context that lives outside React state — global stores,
+     * refs, or computed values.
+     *
+     * ```ts
+     * client.addDynamicContext("cart", () => ({
+     *   name: "Checkout",
+     *   data: { itemCount: cart.items.length, total: cart.total },
+     * }));
+     * ```
+     */
+    addDynamicContext(key: string, provider: DynamicContextProvider): void;
+    /**
+     * Remove a dynamic context provider.
+     */
+    removeDynamicContext(key: string): boolean;
+    /**
+     * Enable automatic capture of the current browser page (URL + title).
+     * Injected as a dynamic context entry named `browser-page`.
+     */
+    enableAutoPageContext(): void;
+    /**
+     * Get the current context snapshot.
+     */
+    getContextSnapshot(): ContextSnapshot | null;
     /**
      * Subscribe to an event
      */

package/dist/client/types.d.ts

@@ -2,14 +2,16 @@
  * SDK Configuration
  */
 export interface AgoConfig {
-    /** Widget API key (X-Widget-Key header) */
-    apiKey: string;
-    /** Widget ID (X-Widget-Id header) */
-    widgetId: string;
-    /** API base URL (default: https://api.useago.com) */
-    baseUrl?: string;
-    /** Default agent ID for new conversations */
+    /** API base URL (e.g., https://YOUR-DOMAIN.useago.com) */
+    baseUrl: string;
+    /** Widget ID (X-Widget-Id header). Auto-generated if not provided. */
+    widgetId?: string;
+    /** Default agent (id or slug) for new conversations. Shorthand for `defaultAgentId`. */
+    agent?: string;
+    /** Default agent ID for new conversations. Prefer `agent`. */
     defaultAgentId?: string;
+    /** Permission name to apply to all requests (sent as `X-Widget-Permission`). Mirrors the widget's `window.AGO.permission`. */
+    permission?: string;
     /** User email for identification */
     userEmail?: string;
     /** JWT token for authenticated users */

package/dist/createMockClient-Ci_N2tH8.cjs

@@ -0,0 +1,104 @@
+//#region src/testing/createMockClient.ts
+/**
+* Create a mock AgoClient for testing. Works with any framework.
+*
+* ```ts
+* import { createMockClient } from "@useago/sdk/testing";
+*
+* const mock = createMockClient();
+* mock.__emitEvent("message:complete", someMessage);
+* expect(mock.__callsFor("sendMessage")).toHaveLength(1);
+* ```
+*/
+function createMockClient(options = {}) {
+	const { overrides = {} } = options;
+	const noopMessage = {
+		id: "mock-msg-1",
+		conversationId: "mock-conv-1",
+		content: "Mock response",
+		role: "assistant",
+		status: "DONE",
+		createdAt: /* @__PURE__ */ new Date()
+	};
+	const noopConversation = {
+		id: "mock-conv-1",
+		title: "Mock Conversation",
+		lastMessageDate: /* @__PURE__ */ new Date()
+	};
+	const listeners = /* @__PURE__ */ new Map();
+	const calls = [];
+	const merged = {
+		sendMessage: async () => noopMessage,
+		getConversations: async () => [noopConversation],
+		getConversation: async () => noopConversation,
+		getMessages: async () => [noopMessage],
+		submitToolCallForm: async () => void 0,
+		confirmToolCall: async () => void 0,
+		rejectToolCall: async () => void 0,
+		submitFeedback: async () => void 0,
+		registerFunction: () => void 0,
+		unregisterFunction: () => true,
+		getRegisteredFunctions: () => [],
+		registerNavigationFunction: () => void 0,
+		on: (event, handler) => {
+			if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+			listeners.get(event).add(handler);
+		},
+		off: (event, handler) => {
+			listeners.get(event)?.delete(handler);
+		},
+		once: (event, handler) => {
+			const wrapper = (...args) => {
+				listeners.get(event)?.delete(wrapper);
+				handler(...args);
+			};
+			if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+			listeners.get(event).add(wrapper);
+		},
+		waitFor: (event, options) => {
+			return new Promise((resolve, reject) => {
+				let timer;
+				const handler = (data) => {
+					if (timer) clearTimeout(timer);
+					listeners.get(event)?.delete(handler);
+					resolve(data);
+				};
+				if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+				listeners.get(event).add(handler);
+				if (options?.timeout) timer = setTimeout(() => {
+					listeners.get(event)?.delete(handler);
+					reject(/* @__PURE__ */ new Error(`waitFor("${event}") timed out after ${options.timeout}ms`));
+				}, options.timeout);
+			});
+		},
+		updateConfig: () => void 0,
+		destroy: () => {
+			listeners.clear();
+		},
+		...overrides
+	};
+	const mock = {};
+	for (const [key, fn] of Object.entries(merged)) mock[key] = (...args) => {
+		calls.push({
+			method: key,
+			args
+		});
+		return fn(...args);
+	};
+	mock.__calls = calls;
+	mock.__callsFor = (method) => calls.filter((c) => c.method === method);
+	mock.__emitEvent = (event, data) => {
+		const handlers = listeners.get(event);
+		if (handlers) [...handlers].forEach((h) => h(data));
+	};
+	return mock;
+}
+//#endregion
+Object.defineProperty(exports, "createMockClient", {
+	enumerable: true,
+	get: function() {
+		return createMockClient;
+	}
+});
+
+//# sourceMappingURL=createMockClient-Ci_N2tH8.cjs.map

package/dist/createMockClient-Ci_N2tH8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMockClient-Ci_N2tH8.cjs","names":[],"sources":["../src/testing/createMockClient.ts"],"sourcesContent":["import type { AgoClient } from \"../client/AgoClient\";\nimport type {\n  AgoClientEvents,\n  AgoEventName,\n  AgoMessage,\n  Conversation,\n} from \"../client/types\";\nimport type { ClientFunctionSchema } from \"../functions/types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype MockFn = (...args: any[]) => any;\n\nexport interface MockAgoClientOptions {\n  overrides?: Partial<Record<string, MockFn>>;\n}\n\nexport interface MockAgoClient extends AgoClient {\n  /**\n   * Simulate a server-pushed event.\n   * ```ts\n   * mock.__emitEvent(\"message:complete\", { id: \"1\", content: \"hi\", ... });\n   * ```\n   */\n  __emitEvent<K extends AgoEventName>(event: K, data: AgoClientEvents[K]): void;\n\n  /**\n   * All recorded method calls: `[methodName, ...args][]`\n   */\n  __calls: Array<{ method: string; args: unknown[] }>;\n\n  /**\n   * Get calls for a specific method.\n   */\n  __callsFor(method: string): Array<{ method: string; args: unknown[] }>;\n}\n\n/**\n * Create a mock AgoClient for testing. Works with any framework.\n *\n * ```ts\n * import { createMockClient } from \"@useago/sdk/testing\";\n *\n * const mock = createMockClient();\n * mock.__emitEvent(\"message:complete\", someMessage);\n * expect(mock.__callsFor(\"sendMessage\")).toHaveLength(1);\n * ```\n */\nexport function createMockClient(\n  options: MockAgoClientOptions = {}\n): MockAgoClient {\n  const { overrides = {} } = options;\n\n  const noopMessage: AgoMessage = {\n    id: \"mock-msg-1\",\n    conversationId: \"mock-conv-1\",\n    content: \"Mock response\",\n    role: \"assistant\",\n    status: \"DONE\",\n    createdAt: new Date(),\n  };\n\n  const noopConversation: Conversation = {\n    id: \"mock-conv-1\",\n    title: \"Mock Conversation\",\n    lastMessageDate: new Date(),\n  };\n\n  const listeners = new Map<string, Set<(...args: unknown[]) => void>>();\n  const calls: Array<{ method: string; args: unknown[] }> = [];\n\n  const defaults: Record<string, MockFn> = {\n    sendMessage: async () => noopMessage,\n    getConversations: async () => [noopConversation],\n    getConversation: async () => noopConversation,\n    getMessages: async () => [noopMessage],\n    submitToolCallForm: async () => undefined,\n    confirmToolCall: async () => undefined,\n    rejectToolCall: async () => undefined,\n    submitFeedback: async () => undefined,\n    registerFunction: () => undefined,\n    unregisterFunction: () => true,\n    getRegisteredFunctions: () => [] as ClientFunctionSchema[],\n    registerNavigationFunction: () => undefined,\n    on: (event: string, handler: (...args: unknown[]) => void) => {\n      if (!listeners.has(event)) listeners.set(event, new Set());\n      listeners.get(event)!.add(handler);\n    },\n    off: (event: string, handler: (...args: unknown[]) => void) => {\n      listeners.get(event)?.delete(handler);\n    },\n    once: (event: string, handler: (...args: unknown[]) => void) => {\n      const wrapper = (...args: unknown[]) => {\n        listeners.get(event)?.delete(wrapper);\n        handler(...args);\n      };\n      if (!listeners.has(event)) listeners.set(event, new Set());\n      listeners.get(event)!.add(wrapper);\n    },\n    waitFor: (event: string, options?: { timeout?: number }) => {\n      return new Promise((resolve, reject) => {\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const handler = (data: unknown) => {\n          if (timer) clearTimeout(timer);\n          listeners.get(event)?.delete(handler);\n          resolve(data);\n        };\n        if (!listeners.has(event)) listeners.set(event, new Set());\n        listeners.get(event)!.add(handler);\n        if (options?.timeout) {\n          timer = setTimeout(() => {\n            listeners.get(event)?.delete(handler);\n            reject(new Error(`waitFor(\"${event}\") timed out after ${options.timeout}ms`));\n          }, options.timeout);\n        }\n      });\n    },\n    updateConfig: () => undefined,\n    destroy: () => {\n      listeners.clear();\n    },\n  };\n\n  const merged = { ...defaults, ...overrides } as Record<string, MockFn>;\n\n  // Wrap all methods to record calls\n  const mock: Record<string, unknown> = {};\n\n  for (const [key, fn] of Object.entries(merged)) {\n    mock[key] = (...args: unknown[]) => {\n      calls.push({ method: key, args });\n      return (fn as MockFn)(...args);\n    };\n  }\n\n  // Test helpers (not recorded)\n  mock.__calls = calls;\n  mock.__callsFor = (method: string) => calls.filter((c) => c.method === method);\n  mock.__emitEvent = (event: string, data: unknown) => {\n    // Copy the set to avoid mutation during iteration (once handlers remove themselves)\n    const handlers = listeners.get(event);\n    if (handlers) {\n      [...handlers].forEach((h) => h(data));\n    }\n  };\n\n  return mock as unknown as MockAgoClient;\n}\n"],"mappings":";;;;;;;;;;;;AA+CA,SAAgB,iBACd,UAAgC,EAAE,EACnB;CACf,MAAM,EAAE,YAAY,EAAE,KAAK;CAE3B,MAAM,cAA0B;EAC9B,IAAI;EACJ,gBAAgB;EAChB,SAAS;EACT,MAAM;EACN,QAAQ;EACR,2BAAW,IAAI,MAAM;EACtB;CAED,MAAM,mBAAiC;EACrC,IAAI;EACJ,OAAO;EACP,iCAAiB,IAAI,MAAM;EAC5B;CAED,MAAM,4BAAY,IAAI,KAAgD;CACtE,MAAM,QAAoD,EAAE;CAsD5D,MAAM,SAAS;EAnDb,aAAa,YAAY;EACzB,kBAAkB,YAAY,CAAC,iBAAiB;EAChD,iBAAiB,YAAY;EAC7B,aAAa,YAAY,CAAC,YAAY;EACtC,oBAAoB,YAAY,KAAA;EAChC,iBAAiB,YAAY,KAAA;EAC7B,gBAAgB,YAAY,KAAA;EAC5B,gBAAgB,YAAY,KAAA;EAC5B,wBAAwB,KAAA;EACxB,0BAA0B;EAC1B,8BAA8B,EAAE;EAChC,kCAAkC,KAAA;EAClC,KAAK,OAAe,YAA0C;AAC5D,OAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,aAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;;EAEpC,MAAM,OAAe,YAA0C;AAC7D,aAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;;EAEvC,OAAO,OAAe,YAA0C;GAC9D,MAAM,WAAW,GAAG,SAAoB;AACtC,cAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,YAAQ,GAAG,KAAK;;AAElB,OAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,aAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;;EAEpC,UAAU,OAAe,YAAmC;AAC1D,UAAO,IAAI,SAAS,SAAS,WAAW;IACtC,IAAI;IACJ,MAAM,WAAW,SAAkB;AACjC,SAAI,MAAO,cAAa,MAAM;AAC9B,eAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,aAAQ,KAAK;;AAEf,QAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,cAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;AAClC,QAAI,SAAS,QACX,SAAQ,iBAAiB;AACvB,eAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,4BAAO,IAAI,MAAM,YAAY,MAAM,qBAAqB,QAAQ,QAAQ,IAAI,CAAC;OAC5E,QAAQ,QAAQ;KAErB;;EAEJ,oBAAoB,KAAA;EACpB,eAAe;AACb,aAAU,OAAO;;EAIS,GAAG;EAAW;CAG5C,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,OAAO,OAAO,QAAQ,OAAO,CAC5C,MAAK,QAAQ,GAAG,SAAoB;AAClC,QAAM,KAAK;GAAE,QAAQ;GAAK;GAAM,CAAC;AACjC,SAAQ,GAAc,GAAG,KAAK;;AAKlC,MAAK,UAAU;AACf,MAAK,cAAc,WAAmB,MAAM,QAAQ,MAAM,EAAE,WAAW,OAAO;AAC9E,MAAK,eAAe,OAAe,SAAkB;EAEnD,MAAM,WAAW,UAAU,IAAI,MAAM;AACrC,MAAI,SACF,EAAC,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC;;AAIzC,QAAO"}

package/dist/createMockClient-U0ae_AYy.js

@@ -0,0 +1,99 @@
+//#region src/testing/createMockClient.ts
+/**
+* Create a mock AgoClient for testing. Works with any framework.
+*
+* ```ts
+* import { createMockClient } from "@useago/sdk/testing";
+*
+* const mock = createMockClient();
+* mock.__emitEvent("message:complete", someMessage);
+* expect(mock.__callsFor("sendMessage")).toHaveLength(1);
+* ```
+*/
+function createMockClient(options = {}) {
+	const { overrides = {} } = options;
+	const noopMessage = {
+		id: "mock-msg-1",
+		conversationId: "mock-conv-1",
+		content: "Mock response",
+		role: "assistant",
+		status: "DONE",
+		createdAt: /* @__PURE__ */ new Date()
+	};
+	const noopConversation = {
+		id: "mock-conv-1",
+		title: "Mock Conversation",
+		lastMessageDate: /* @__PURE__ */ new Date()
+	};
+	const listeners = /* @__PURE__ */ new Map();
+	const calls = [];
+	const merged = {
+		sendMessage: async () => noopMessage,
+		getConversations: async () => [noopConversation],
+		getConversation: async () => noopConversation,
+		getMessages: async () => [noopMessage],
+		submitToolCallForm: async () => void 0,
+		confirmToolCall: async () => void 0,
+		rejectToolCall: async () => void 0,
+		submitFeedback: async () => void 0,
+		registerFunction: () => void 0,
+		unregisterFunction: () => true,
+		getRegisteredFunctions: () => [],
+		registerNavigationFunction: () => void 0,
+		on: (event, handler) => {
+			if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+			listeners.get(event).add(handler);
+		},
+		off: (event, handler) => {
+			listeners.get(event)?.delete(handler);
+		},
+		once: (event, handler) => {
+			const wrapper = (...args) => {
+				listeners.get(event)?.delete(wrapper);
+				handler(...args);
+			};
+			if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+			listeners.get(event).add(wrapper);
+		},
+		waitFor: (event, options) => {
+			return new Promise((resolve, reject) => {
+				let timer;
+				const handler = (data) => {
+					if (timer) clearTimeout(timer);
+					listeners.get(event)?.delete(handler);
+					resolve(data);
+				};
+				if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+				listeners.get(event).add(handler);
+				if (options?.timeout) timer = setTimeout(() => {
+					listeners.get(event)?.delete(handler);
+					reject(/* @__PURE__ */ new Error(`waitFor("${event}") timed out after ${options.timeout}ms`));
+				}, options.timeout);
+			});
+		},
+		updateConfig: () => void 0,
+		destroy: () => {
+			listeners.clear();
+		},
+		...overrides
+	};
+	const mock = {};
+	for (const [key, fn] of Object.entries(merged)) mock[key] = (...args) => {
+		calls.push({
+			method: key,
+			args
+		});
+		return fn(...args);
+	};
+	mock.__calls = calls;
+	mock.__callsFor = (method) => calls.filter((c) => c.method === method);
+	mock.__emitEvent = (event, data) => {
+		const handlers = listeners.get(event);
+		if (handlers) [...handlers].forEach((h) => h(data));
+	};
+	return mock;
+}
+//#endregion
+export { createMockClient as t };
+
+//# sourceMappingURL=createMockClient-U0ae_AYy.js.map

package/dist/createMockClient-U0ae_AYy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMockClient-U0ae_AYy.js","names":[],"sources":["../src/testing/createMockClient.ts"],"sourcesContent":["import type { AgoClient } from \"../client/AgoClient\";\nimport type {\n  AgoClientEvents,\n  AgoEventName,\n  AgoMessage,\n  Conversation,\n} from \"../client/types\";\nimport type { ClientFunctionSchema } from \"../functions/types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype MockFn = (...args: any[]) => any;\n\nexport interface MockAgoClientOptions {\n  overrides?: Partial<Record<string, MockFn>>;\n}\n\nexport interface MockAgoClient extends AgoClient {\n  /**\n   * Simulate a server-pushed event.\n   * ```ts\n   * mock.__emitEvent(\"message:complete\", { id: \"1\", content: \"hi\", ... });\n   * ```\n   */\n  __emitEvent<K extends AgoEventName>(event: K, data: AgoClientEvents[K]): void;\n\n  /**\n   * All recorded method calls: `[methodName, ...args][]`\n   */\n  __calls: Array<{ method: string; args: unknown[] }>;\n\n  /**\n   * Get calls for a specific method.\n   */\n  __callsFor(method: string): Array<{ method: string; args: unknown[] }>;\n}\n\n/**\n * Create a mock AgoClient for testing. Works with any framework.\n *\n * ```ts\n * import { createMockClient } from \"@useago/sdk/testing\";\n *\n * const mock = createMockClient();\n * mock.__emitEvent(\"message:complete\", someMessage);\n * expect(mock.__callsFor(\"sendMessage\")).toHaveLength(1);\n * ```\n */\nexport function createMockClient(\n  options: MockAgoClientOptions = {}\n): MockAgoClient {\n  const { overrides = {} } = options;\n\n  const noopMessage: AgoMessage = {\n    id: \"mock-msg-1\",\n    conversationId: \"mock-conv-1\",\n    content: \"Mock response\",\n    role: \"assistant\",\n    status: \"DONE\",\n    createdAt: new Date(),\n  };\n\n  const noopConversation: Conversation = {\n    id: \"mock-conv-1\",\n    title: \"Mock Conversation\",\n    lastMessageDate: new Date(),\n  };\n\n  const listeners = new Map<string, Set<(...args: unknown[]) => void>>();\n  const calls: Array<{ method: string; args: unknown[] }> = [];\n\n  const defaults: Record<string, MockFn> = {\n    sendMessage: async () => noopMessage,\n    getConversations: async () => [noopConversation],\n    getConversation: async () => noopConversation,\n    getMessages: async () => [noopMessage],\n    submitToolCallForm: async () => undefined,\n    confirmToolCall: async () => undefined,\n    rejectToolCall: async () => undefined,\n    submitFeedback: async () => undefined,\n    registerFunction: () => undefined,\n    unregisterFunction: () => true,\n    getRegisteredFunctions: () => [] as ClientFunctionSchema[],\n    registerNavigationFunction: () => undefined,\n    on: (event: string, handler: (...args: unknown[]) => void) => {\n      if (!listeners.has(event)) listeners.set(event, new Set());\n      listeners.get(event)!.add(handler);\n    },\n    off: (event: string, handler: (...args: unknown[]) => void) => {\n      listeners.get(event)?.delete(handler);\n    },\n    once: (event: string, handler: (...args: unknown[]) => void) => {\n      const wrapper = (...args: unknown[]) => {\n        listeners.get(event)?.delete(wrapper);\n        handler(...args);\n      };\n      if (!listeners.has(event)) listeners.set(event, new Set());\n      listeners.get(event)!.add(wrapper);\n    },\n    waitFor: (event: string, options?: { timeout?: number }) => {\n      return new Promise((resolve, reject) => {\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const handler = (data: unknown) => {\n          if (timer) clearTimeout(timer);\n          listeners.get(event)?.delete(handler);\n          resolve(data);\n        };\n        if (!listeners.has(event)) listeners.set(event, new Set());\n        listeners.get(event)!.add(handler);\n        if (options?.timeout) {\n          timer = setTimeout(() => {\n            listeners.get(event)?.delete(handler);\n            reject(new Error(`waitFor(\"${event}\") timed out after ${options.timeout}ms`));\n          }, options.timeout);\n        }\n      });\n    },\n    updateConfig: () => undefined,\n    destroy: () => {\n      listeners.clear();\n    },\n  };\n\n  const merged = { ...defaults, ...overrides } as Record<string, MockFn>;\n\n  // Wrap all methods to record calls\n  const mock: Record<string, unknown> = {};\n\n  for (const [key, fn] of Object.entries(merged)) {\n    mock[key] = (...args: unknown[]) => {\n      calls.push({ method: key, args });\n      return (fn as MockFn)(...args);\n    };\n  }\n\n  // Test helpers (not recorded)\n  mock.__calls = calls;\n  mock.__callsFor = (method: string) => calls.filter((c) => c.method === method);\n  mock.__emitEvent = (event: string, data: unknown) => {\n    // Copy the set to avoid mutation during iteration (once handlers remove themselves)\n    const handlers = listeners.get(event);\n    if (handlers) {\n      [...handlers].forEach((h) => h(data));\n    }\n  };\n\n  return mock as unknown as MockAgoClient;\n}\n"],"mappings":";;;;;;;;;;;;AA+CA,SAAgB,iBACd,UAAgC,EAAE,EACnB;CACf,MAAM,EAAE,YAAY,EAAE,KAAK;CAE3B,MAAM,cAA0B;EAC9B,IAAI;EACJ,gBAAgB;EAChB,SAAS;EACT,MAAM;EACN,QAAQ;EACR,2BAAW,IAAI,MAAM;EACtB;CAED,MAAM,mBAAiC;EACrC,IAAI;EACJ,OAAO;EACP,iCAAiB,IAAI,MAAM;EAC5B;CAED,MAAM,4BAAY,IAAI,KAAgD;CACtE,MAAM,QAAoD,EAAE;CAsD5D,MAAM,SAAS;EAnDb,aAAa,YAAY;EACzB,kBAAkB,YAAY,CAAC,iBAAiB;EAChD,iBAAiB,YAAY;EAC7B,aAAa,YAAY,CAAC,YAAY;EACtC,oBAAoB,YAAY,KAAA;EAChC,iBAAiB,YAAY,KAAA;EAC7B,gBAAgB,YAAY,KAAA;EAC5B,gBAAgB,YAAY,KAAA;EAC5B,wBAAwB,KAAA;EACxB,0BAA0B;EAC1B,8BAA8B,EAAE;EAChC,kCAAkC,KAAA;EAClC,KAAK,OAAe,YAA0C;AAC5D,OAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,aAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;;EAEpC,MAAM,OAAe,YAA0C;AAC7D,aAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;;EAEvC,OAAO,OAAe,YAA0C;GAC9D,MAAM,WAAW,GAAG,SAAoB;AACtC,cAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,YAAQ,GAAG,KAAK;;AAElB,OAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,aAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;;EAEpC,UAAU,OAAe,YAAmC;AAC1D,UAAO,IAAI,SAAS,SAAS,WAAW;IACtC,IAAI;IACJ,MAAM,WAAW,SAAkB;AACjC,SAAI,MAAO,cAAa,MAAM;AAC9B,eAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,aAAQ,KAAK;;AAEf,QAAI,CAAC,UAAU,IAAI,MAAM,CAAE,WAAU,IAAI,uBAAO,IAAI,KAAK,CAAC;AAC1D,cAAU,IAAI,MAAM,CAAE,IAAI,QAAQ;AAClC,QAAI,SAAS,QACX,SAAQ,iBAAiB;AACvB,eAAU,IAAI,MAAM,EAAE,OAAO,QAAQ;AACrC,4BAAO,IAAI,MAAM,YAAY,MAAM,qBAAqB,QAAQ,QAAQ,IAAI,CAAC;OAC5E,QAAQ,QAAQ;KAErB;;EAEJ,oBAAoB,KAAA;EACpB,eAAe;AACb,aAAU,OAAO;;EAIS,GAAG;EAAW;CAG5C,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,OAAO,OAAO,QAAQ,OAAO,CAC5C,MAAK,QAAQ,GAAG,SAAoB;AAClC,QAAM,KAAK;GAAE,QAAQ;GAAK;GAAM,CAAC;AACjC,SAAQ,GAAc,GAAG,KAAK;;AAKlC,MAAK,UAAU;AACf,MAAK,cAAc,WAAmB,MAAM,QAAQ,MAAM,EAAE,WAAW,OAAO;AAC9E,MAAK,eAAe,OAAe,SAAkB;EAEnD,MAAM,WAAW,UAAU,IAAI,MAAM;AACrC,MAAI,SACF,EAAC,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC;;AAIzC,QAAO"}