@useago/sdk 0.3.1 → 0.3.3

package/dist/client/types.d.ts

@@ -1,205 +0,0 @@
-/**
- * SDK Configuration
- */
-export interface AgoConfig {
-    /** 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 */
-    userJwt?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-}
-/**
- * Options for sending a message
- */
-export interface SendMessageOptions {
-    /** Existing conversation ID */
-    conversationId?: string;
-    /** Override default agent */
-    agentId?: string;
-    /** File attachments */
-    files?: File[];
-}
-/**
- * Message from AGO
- */
-export interface AgoMessage {
-    id: string;
-    conversationId: string;
-    content: string;
-    role: "user" | "assistant";
-    status: MessageStatus;
-    agent?: AgoAgent;
-    sources?: AgoSource[];
-    toolCalls?: ToolCallData[];
-    followUpReplies?: string[];
-    createdAt: Date;
-}
-export type MessageStatus = "IN_PROGRESS" | "DONE" | "ERROR" | "TODO" | "CANCELED";
-/**
- * Agent information
- */
-export interface AgoAgent {
-    id: string;
-    name: string;
-    displayName?: string;
-}
-/**
- * Knowledge source citation
- */
-export interface AgoSource {
-    id: string;
-    title: string;
-    url?: string;
-}
-/**
- * Conversation/Thread
- */
-export interface Conversation {
-    id: string;
-    title: string;
-    lastMessageDate: Date;
-    messages?: AgoMessage[];
-}
-/**
- * Tool call data from SSE stream
- */
-export interface ToolCallData {
-    id: string;
-    type: ToolCallType;
-    status: string;
-    toolName: string;
-    toolDisplayName?: string;
-    message?: string;
-    formSchema?: FormSchema;
-    data?: Record<string, unknown>;
-    functionName?: string;
-    arguments?: Record<string, unknown>;
-}
-export type ToolCallType = "form" | "confirmation_input" | "status_message" | "progress_indicator" | "client_function" | "reasoning" | "mcp_ui_resource";
-/**
- * Form schema for tool calls requiring user input
- */
-export interface FormSchema {
-    type: "object";
-    properties: Record<string, FormField>;
-    required?: string[];
-}
-export interface FormField {
-    type: "string" | "number" | "boolean" | "array";
-    title?: string;
-    description?: string;
-    enum?: string[];
-    default?: unknown;
-}
-/**
- * Client-side function types
- */
-export interface FunctionSchema {
-    name: string;
-    description: string;
-    parameters: {
-        type: "object";
-        properties: Record<string, {
-            type: string;
-            description?: string;
-            enum?: string[];
-        }>;
-        required?: string[];
-    };
-}
-export type ClientFunction = (args: Record<string, unknown>) => Promise<unknown> | unknown;
-export interface FunctionDefinition {
-    name: string;
-    schema: FunctionSchema;
-    handler: ClientFunction;
-}
-export interface ClientFunctionInvocation {
-    invocationId: string;
-    functionName: string;
-    arguments: Record<string, unknown>;
-    conversationId: string;
-}
-/**
- * SSE stream chunk data
- */
-export interface SSEChunkData {
-    content?: string;
-    full_content?: string;
-    message_id?: string;
-    status?: MessageStatus;
-    thread?: {
-        id: string;
-    };
-    agent?: {
-        id: string;
-        name: string;
-        display_name?: string;
-    };
-    knowledge_sources?: Array<{
-        knowledge_document: {
-            id: string;
-            title: string;
-            use_external_link: boolean;
-            external_link_url?: string;
-            internal_link_url?: string;
-        };
-        position: number;
-    }>;
-    tool_call_data?: boolean;
-    type?: string;
-    id?: string;
-    tool_name?: string;
-    tool_display_name?: string;
-    function_name?: string;
-    arguments?: Record<string, unknown>;
-    form_schema?: FormSchema;
-    message?: string;
-    data?: Record<string, unknown>;
-    follow_up_replies?: string[];
-    satisfaction_feedback?: unknown;
-    ask_to_talk_to_human?: boolean;
-}
-/**
- * SDK Events
- */
-export interface AgoClientEvents {
-    "message:start": {
-        conversationId: string;
-        messageId: string;
-    };
-    "message:chunk": {
-        content: string;
-        conversationId: string;
-        messageId: string;
-    };
-    "message:complete": AgoMessage;
-    "message:error": {
-        error: string;
-        conversationId?: string;
-        messageId?: string;
-    };
-    "toolCall:received": ToolCallData;
-    "toolCall:form": ToolCallData;
-    "function:invoke": ClientFunctionInvocation;
-    "function:result": {
-        invocationId: string;
-        result: unknown;
-        error?: string;
-    };
-    "connection:status": {
-        connected: boolean;
-    };
-}
-export type AgoEventName = keyof AgoClientEvents;
-export type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;

package/dist/createMockClient-Ci_N2tH8.cjs

@@ -1,104 +0,0 @@
-//#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

@@ -1 +0,0 @@
-{"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

@@ -1,99 +0,0 @@
-//#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

@@ -1 +0,0 @@
-{"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"}

package/dist/functions/FunctionRegistry.d.ts

@@ -1,41 +0,0 @@
-import type { ClientFunctionDefinition, ClientFunctionHandler, ClientFunctionSchema, RegisteredFunction } from "./types";
-/**
- * Registry for client-side functions that AGO can call
- */
-export declare class FunctionRegistry {
-    private functions;
-    /**
-     * Register a function that AGO can call.
-     * Accepts either a single definition object or (name, handler, schema) args.
-     */
-    register(definition: ClientFunctionDefinition): void;
-    register(name: string, handler: ClientFunctionHandler, schema: Omit<ClientFunctionSchema, "name">): void;
-    /**
-     * Unregister a function
-     */
-    unregister(name: string): boolean;
-    /**
-     * Get a registered function
-     */
-    get(name: string): RegisteredFunction | undefined;
-    /**
-     * Check if a function is registered
-     */
-    has(name: string): boolean;
-    /**
-     * Get all registered function schemas (for sending to backend)
-     */
-    getSchemas(): ClientFunctionSchema[];
-    /**
-     * Execute a registered function
-     */
-    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Clear all registered functions
-     */
-    clear(): void;
-    /**
-     * Get the number of registered functions
-     */
-    get size(): number;
-}

package/dist/functions/defineFunction.d.ts

@@ -1,22 +0,0 @@
-import type { ClientFunctionDefinition } from "./types";
-/**
- * Create a reusable function definition.
- * Returns the same object — this is an identity function for discoverability and type-checking.
- *
- * ```ts
- * // Define once, reuse anywhere
- * export const lookupOrder = defineFunction({
- *   name: "lookupOrder",
- *   description: "Look up an order by ID",
- *   parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
- *   handler: async (args) => fetchOrder(args.id as string),
- * });
- *
- * // Register with client
- * client.registerFunction(lookupOrder);
- *
- * // Or use in React
- * useAgoFunction(lookupOrder.name, lookupOrder);
- * ```
- */
-export declare function defineFunction(definition: ClientFunctionDefinition): ClientFunctionDefinition;

package/dist/functions/index.d.ts

@@ -1,2 +0,0 @@
-export { FunctionRegistry } from "./FunctionRegistry";
-export type { ClientFunctionSchema, ClientFunctionHandler, RegisteredFunction, } from "./types";

package/dist/functions/types.d.ts

@@ -1,50 +0,0 @@
-/**
- * Schema for a client-side function that AGO can call
- */
-export interface ClientFunctionSchema {
-    /** Function name (must be unique) */
-    name: string;
-    /** Description for the LLM to understand when to call this function */
-    description: string;
-    /** JSON Schema for function parameters */
-    parameters: {
-        type: "object";
-        properties: Record<string, {
-            type: string;
-            description?: string;
-            enum?: string[];
-            default?: unknown;
-        }>;
-        required?: string[];
-    };
-}
-/**
- * Function handler type
- */
-export type ClientFunctionHandler = (args: Record<string, unknown>) => Promise<unknown> | unknown;
-/**
- * Registered function with handler
- */
-export interface RegisteredFunction {
-    schema: ClientFunctionSchema;
-    handler: ClientFunctionHandler;
-}
-/**
- * Single-object function definition — combines name, schema, and handler.
- *
- * ```ts
- * const fn = defineFunction({
- *   name: "lookupOrder",
- *   description: "Look up an order by ID",
- *   parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
- *   handler: async (args) => fetchOrder(args.id as string),
- * });
- * client.registerFunction(fn);
- * ```
- */
-export interface ClientFunctionDefinition {
-    name: string;
-    description: string;
-    parameters: ClientFunctionSchema["parameters"];
-    handler: ClientFunctionHandler;
-}