@useago/sdk 0.3.2 → 0.3.4

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/devtools/index.d.ts

@@ -1,2 +0,0 @@
-export { initDevPanel } from "./initDevPanel";
-export type { DevPanelOptions } from "./initDevPanel";

package/dist/devtools/initDevPanel.d.ts

@@ -1,15 +0,0 @@
-import type { AgoClient } from "../client/AgoClient";
-import type { Store } from "../state/createStore";
-/** Options for {@link initDevPanel}. */
-export interface DevPanelOptions {
-    /** The store whose state the panel renders live. */
-    store: Store<unknown>;
-    /**
-     * Client to read registered functions from and listen to function events on.
-     * Typed structurally so a mock client works too.
-     */
-    client: Pick<AgoClient, "on" | "getRegisteredFunctions">;
-    /** Where to mount: a CSS selector, an Element, or `document.body` (default). */
-    target?: string | Element;
-}
-export declare function initDevPanel(options: DevPanelOptions): void;

package/dist/devtools.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.cjs","names":[],"sources":["../src/devtools/initDevPanel.ts"],"sourcesContent":["import type { AgoClient } from \"../client/AgoClient\";\nimport type { Store } from \"../state/createStore\";\n\n/** Options for {@link initDevPanel}. */\nexport interface DevPanelOptions {\n  /** The store whose state the panel renders live. */\n  store: Store<unknown>;\n  /**\n   * Client to read registered functions from and listen to function events on.\n   * Typed structurally so a mock client works too.\n   */\n  client: Pick<AgoClient, \"on\" | \"getRegisteredFunctions\">;\n  /** Where to mount: a CSS selector, an Element, or `document.body` (default). */\n  target?: string | Element;\n}\n\nlet stateEl: HTMLElement | null;\nlet logEl: HTMLElement | null;\nlet getStateFn: () => unknown = () => ({});\n\n// Re-render the JSON object. Wired to the store's subscribe() in initDevPanel.\nfunction renderState(): void {\n  if (!stateEl) return;\n  stateEl.textContent = JSON.stringify(getStateFn(), null, 2);\n}\n\nfunction logLine(text: string, kind: \"invoke\" | \"result\" | \"error\"): void {\n  if (!logEl) return;\n  const line = document.createElement(\"div\");\n  line.className = `dev-log-line dev-log-${kind}`;\n  const time = new Date().toLocaleTimeString();\n  line.textContent = `${time}  ${text}`;\n  logEl.appendChild(line);\n  logEl.scrollTop = logEl.scrollHeight;\n}\n\nconst COLLAPSE_KEY = \"devPanelCollapsed\";\n\nfunction setCollapsed(panel: HTMLElement, collapsed: boolean): void {\n  panel.classList.toggle(\"collapsed\", collapsed);\n  const toggle = panel.querySelector<HTMLButtonElement>(\".dev-toggle\");\n  if (toggle) {\n    toggle.textContent = collapsed ? \"▢\" : \"—\";\n    toggle.title = collapsed ? \"Expand dev tools\" : \"Collapse dev tools\";\n    toggle.setAttribute(\"aria-expanded\", String(!collapsed));\n  }\n  try {\n    localStorage.setItem(COLLAPSE_KEY, collapsed ? \"1\" : \"0\");\n  } catch {\n    // localStorage may be unavailable; collapse state just won't persist.\n  }\n}\n\nexport function initDevPanel(options: DevPanelOptions): void {\n  const { store, client, target } = options;\n  getStateFn = store.get;\n  injectStyles();\n  const host =\n    typeof target === \"string\"\n      ? document.querySelector(target)\n      : target instanceof Element\n        ? target\n        : document.body;\n  const panel = document.createElement(\"aside\");\n  panel.id = \"dev-panel\";\n  (host ?? document.body).appendChild(panel);\n\n  const registered = client.getRegisteredFunctions?.() ?? [];\n  const fnNames = registered.map((f) => f.name).join(\", \") || \"—\";\n\n  panel.innerHTML = `\n    <div class=\"dev-head\">\n      <span class=\"dev-badge\">DEV</span>\n      <span class=\"dev-title\">DEV TOOLS · client-side function state — not for production</span>\n      <button type=\"button\" class=\"dev-toggle\" aria-label=\"Toggle dev tools\">—</button>\n    </div>\n    <div class=\"dev-body\">\n      <div class=\"dev-fns\">Registered functions: <code>${fnNames}</code></div>\n      <div class=\"dev-section-label\">JSON object (built by the agent)</div>\n      <pre class=\"dev-state\" id=\"dev-state\"></pre>\n      <div class=\"dev-section-label\">Function calls</div>\n      <div class=\"dev-log\" id=\"dev-log\"></div>\n    </div>\n  `;\n\n  stateEl = panel.querySelector<HTMLElement>(\"#dev-state\");\n  logEl = panel.querySelector<HTMLElement>(\"#dev-log\");\n\n  const toggle = panel.querySelector<HTMLButtonElement>(\".dev-toggle\");\n  toggle?.addEventListener(\"click\", (e) => {\n    e.stopPropagation();\n    setCollapsed(panel, !panel.classList.contains(\"collapsed\"));\n  });\n  // When collapsed, the whole widget acts as an expand button.\n  panel.addEventListener(\"click\", () => {\n    if (panel.classList.contains(\"collapsed\")) setCollapsed(panel, false);\n  });\n\n  let startCollapsed = false;\n  try {\n    startCollapsed = localStorage.getItem(COLLAPSE_KEY) === \"1\";\n  } catch {\n    // ignore\n  }\n  setCollapsed(panel, startCollapsed);\n\n  client.on(\"function:invoke\", ({ functionName, arguments: args }) => {\n    logLine(`→ ${functionName}(${JSON.stringify(args ?? {})})`, \"invoke\");\n  });\n  client.on(\"function:result\", ({ result, error }) => {\n    logLine(\n      error ? `✗ error: ${error}` : `← ${JSON.stringify(result)}`,\n      error ? \"error\" : \"result\",\n    );\n  });\n\n  // Re-render the JSON object on every state change, then paint the initial state.\n  store.subscribe(renderState);\n  renderState();\n}\n\nconst STYLE_ID = \"dev-panel-styles\";\n\nfunction injectStyles(): void {\n  if (document.getElementById(STYLE_ID)) return;\n  const style = document.createElement(\"style\");\n  style.id = STYLE_ID;\n  style.textContent = PANEL_CSS;\n  document.head.appendChild(style);\n}\n\nconst PANEL_CSS = `\n#dev-panel {\n  position: fixed;\n  top: 16px;\n  right: 16px;\n  width: min(360px, calc(100vw - 32px));\n  max-width: calc(100vw - 32px);\n  box-sizing: border-box;\n  max-height: calc(100vh - 32px);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px 14px;\n  background: #0f1419;\n  color: #d7e0e8;\n  border: 1px solid #2a3441;\n  border-radius: 12px;\n  box-shadow: 0 20px 50px -20px rgba(0,0,0,.6);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 12px;\n  z-index: 1000;\n}\n#dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }\n#dev-panel .dev-toggle {\n  margin-left: auto;\n  flex: none;\n  width: 22px;\n  height: 22px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background: transparent;\n  color: #7c8a99;\n  border: 1px solid #2a3441;\n  border-radius: 6px;\n  font-size: 12px;\n  line-height: 1;\n  cursor: pointer;\n}\n#dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }\n#dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }\n\n/* Collapsed: shrink to a small clickable widget showing only the DEV badge. */\n#dev-panel.collapsed {\n  width: auto;\n  cursor: pointer;\n  padding: 8px 10px;\n}\n#dev-panel.collapsed .dev-title,\n#dev-panel.collapsed .dev-body { display: none; }\n#dev-panel.collapsed .dev-toggle { margin-left: 6px; }\n#dev-panel .dev-badge {\n  background: #f59e0b;\n  color: #1c1206;\n  font-weight: 700;\n  font-size: 10px;\n  letter-spacing: .08em;\n  padding: 2px 6px;\n  border-radius: 5px;\n}\n#dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }\n#dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }\n#dev-panel .dev-fns code { color: #9ecbff; }\n#dev-panel .dev-section-label {\n  color: #7c8a99;\n  text-transform: uppercase;\n  letter-spacing: .08em;\n  font-size: 10px;\n  margin-top: 4px;\n}\n#dev-panel .dev-state {\n  margin: 0;\n  padding: 8px;\n  background: #060a0e;\n  border-radius: 8px;\n  overflow: auto;\n  max-height: 40vh;\n  white-space: pre;\n  color: #c8e6c9;\n}\n#dev-panel .dev-log {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  overflow-y: auto;\n  max-height: 24vh;\n  background: #060a0e;\n  border-radius: 8px;\n  padding: 6px 8px;\n}\n#dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }\n#dev-panel .dev-log-invoke { color: #9ecbff; }\n#dev-panel .dev-log-result { color: #86efac; }\n#dev-panel .dev-log-error { color: #fca5a5; }\n`;\n"],"mappings":";;AAgBA,IAAI;AACJ,IAAI;AACJ,IAAI,oBAAmC,EAAE;AAGzC,SAAS,cAAoB;AAC3B,KAAI,CAAC,QAAS;AACd,SAAQ,cAAc,KAAK,UAAU,YAAY,EAAE,MAAM,EAAE;;AAG7D,SAAS,QAAQ,MAAc,MAA2C;AACxE,KAAI,CAAC,MAAO;CACZ,MAAM,OAAO,SAAS,cAAc,MAAM;AAC1C,MAAK,YAAY,wBAAwB;AAEzC,MAAK,cAAc,oBADN,IAAI,MAAM,EAAC,oBACF,CAAK,IAAI;AAC/B,OAAM,YAAY,KAAK;AACvB,OAAM,YAAY,MAAM;;AAG1B,IAAM,eAAe;AAErB,SAAS,aAAa,OAAoB,WAA0B;AAClE,OAAM,UAAU,OAAO,aAAa,UAAU;CAC9C,MAAM,SAAS,MAAM,cAAiC,cAAc;AACpE,KAAI,QAAQ;AACV,SAAO,cAAc,YAAY,MAAM;AACvC,SAAO,QAAQ,YAAY,qBAAqB;AAChD,SAAO,aAAa,iBAAiB,OAAO,CAAC,UAAU,CAAC;;AAE1D,KAAI;AACF,eAAa,QAAQ,cAAc,YAAY,MAAM,IAAI;SACnD;;AAKV,SAAgB,aAAa,SAAgC;CAC3D,MAAM,EAAE,OAAO,QAAQ,WAAW;AAClC,cAAa,MAAM;AACnB,eAAc;CACd,MAAM,OACJ,OAAO,WAAW,WACd,SAAS,cAAc,OAAO,GAC9B,kBAAkB,UAChB,SACA,SAAS;CACjB,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,KAAK;AACX,EAAC,QAAQ,SAAS,MAAM,YAAY,MAAM;AAK1C,OAAM,YAAY;;;;;;;0DAHC,OAAO,0BAA0B,IAAI,EAAE,EAC/B,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,IASG;;;;;;;AAQ/D,WAAU,MAAM,cAA2B,aAAa;AACxD,SAAQ,MAAM,cAA2B,WAAW;AAErC,OAAM,cAAiC,cACtD,EAAQ,iBAAiB,UAAU,MAAM;AACvC,IAAE,iBAAiB;AACnB,eAAa,OAAO,CAAC,MAAM,UAAU,SAAS,YAAY,CAAC;GAC3D;AAEF,OAAM,iBAAiB,eAAe;AACpC,MAAI,MAAM,UAAU,SAAS,YAAY,CAAE,cAAa,OAAO,MAAM;GACrE;CAEF,IAAI,iBAAiB;AACrB,KAAI;AACF,mBAAiB,aAAa,QAAQ,aAAa,KAAK;SAClD;AAGR,cAAa,OAAO,eAAe;AAEnC,QAAO,GAAG,oBAAoB,EAAE,cAAc,WAAW,WAAW;AAClE,UAAQ,KAAK,aAAa,GAAG,KAAK,UAAU,QAAQ,EAAE,CAAC,CAAC,IAAI,SAAS;GACrE;AACF,QAAO,GAAG,oBAAoB,EAAE,QAAQ,YAAY;AAClD,UACE,QAAQ,YAAY,UAAU,KAAK,KAAK,UAAU,OAAO,IACzD,QAAQ,UAAU,SACnB;GACD;AAGF,OAAM,UAAU,YAAY;AAC5B,cAAa;;AAGf,IAAM,WAAW;AAEjB,SAAS,eAAqB;AAC5B,KAAI,SAAS,eAAe,SAAS,CAAE;CACvC,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,KAAK;AACX,OAAM,cAAc;AACpB,UAAS,KAAK,YAAY,MAAM;;AAGlC,IAAM,YAAY"}

package/dist/devtools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools/initDevPanel.ts"],"sourcesContent":["import type { AgoClient } from \"../client/AgoClient\";\nimport type { Store } from \"../state/createStore\";\n\n/** Options for {@link initDevPanel}. */\nexport interface DevPanelOptions {\n  /** The store whose state the panel renders live. */\n  store: Store<unknown>;\n  /**\n   * Client to read registered functions from and listen to function events on.\n   * Typed structurally so a mock client works too.\n   */\n  client: Pick<AgoClient, \"on\" | \"getRegisteredFunctions\">;\n  /** Where to mount: a CSS selector, an Element, or `document.body` (default). */\n  target?: string | Element;\n}\n\nlet stateEl: HTMLElement | null;\nlet logEl: HTMLElement | null;\nlet getStateFn: () => unknown = () => ({});\n\n// Re-render the JSON object. Wired to the store's subscribe() in initDevPanel.\nfunction renderState(): void {\n  if (!stateEl) return;\n  stateEl.textContent = JSON.stringify(getStateFn(), null, 2);\n}\n\nfunction logLine(text: string, kind: \"invoke\" | \"result\" | \"error\"): void {\n  if (!logEl) return;\n  const line = document.createElement(\"div\");\n  line.className = `dev-log-line dev-log-${kind}`;\n  const time = new Date().toLocaleTimeString();\n  line.textContent = `${time}  ${text}`;\n  logEl.appendChild(line);\n  logEl.scrollTop = logEl.scrollHeight;\n}\n\nconst COLLAPSE_KEY = \"devPanelCollapsed\";\n\nfunction setCollapsed(panel: HTMLElement, collapsed: boolean): void {\n  panel.classList.toggle(\"collapsed\", collapsed);\n  const toggle = panel.querySelector<HTMLButtonElement>(\".dev-toggle\");\n  if (toggle) {\n    toggle.textContent = collapsed ? \"▢\" : \"—\";\n    toggle.title = collapsed ? \"Expand dev tools\" : \"Collapse dev tools\";\n    toggle.setAttribute(\"aria-expanded\", String(!collapsed));\n  }\n  try {\n    localStorage.setItem(COLLAPSE_KEY, collapsed ? \"1\" : \"0\");\n  } catch {\n    // localStorage may be unavailable; collapse state just won't persist.\n  }\n}\n\nexport function initDevPanel(options: DevPanelOptions): void {\n  const { store, client, target } = options;\n  getStateFn = store.get;\n  injectStyles();\n  const host =\n    typeof target === \"string\"\n      ? document.querySelector(target)\n      : target instanceof Element\n        ? target\n        : document.body;\n  const panel = document.createElement(\"aside\");\n  panel.id = \"dev-panel\";\n  (host ?? document.body).appendChild(panel);\n\n  const registered = client.getRegisteredFunctions?.() ?? [];\n  const fnNames = registered.map((f) => f.name).join(\", \") || \"—\";\n\n  panel.innerHTML = `\n    <div class=\"dev-head\">\n      <span class=\"dev-badge\">DEV</span>\n      <span class=\"dev-title\">DEV TOOLS · client-side function state — not for production</span>\n      <button type=\"button\" class=\"dev-toggle\" aria-label=\"Toggle dev tools\">—</button>\n    </div>\n    <div class=\"dev-body\">\n      <div class=\"dev-fns\">Registered functions: <code>${fnNames}</code></div>\n      <div class=\"dev-section-label\">JSON object (built by the agent)</div>\n      <pre class=\"dev-state\" id=\"dev-state\"></pre>\n      <div class=\"dev-section-label\">Function calls</div>\n      <div class=\"dev-log\" id=\"dev-log\"></div>\n    </div>\n  `;\n\n  stateEl = panel.querySelector<HTMLElement>(\"#dev-state\");\n  logEl = panel.querySelector<HTMLElement>(\"#dev-log\");\n\n  const toggle = panel.querySelector<HTMLButtonElement>(\".dev-toggle\");\n  toggle?.addEventListener(\"click\", (e) => {\n    e.stopPropagation();\n    setCollapsed(panel, !panel.classList.contains(\"collapsed\"));\n  });\n  // When collapsed, the whole widget acts as an expand button.\n  panel.addEventListener(\"click\", () => {\n    if (panel.classList.contains(\"collapsed\")) setCollapsed(panel, false);\n  });\n\n  let startCollapsed = false;\n  try {\n    startCollapsed = localStorage.getItem(COLLAPSE_KEY) === \"1\";\n  } catch {\n    // ignore\n  }\n  setCollapsed(panel, startCollapsed);\n\n  client.on(\"function:invoke\", ({ functionName, arguments: args }) => {\n    logLine(`→ ${functionName}(${JSON.stringify(args ?? {})})`, \"invoke\");\n  });\n  client.on(\"function:result\", ({ result, error }) => {\n    logLine(\n      error ? `✗ error: ${error}` : `← ${JSON.stringify(result)}`,\n      error ? \"error\" : \"result\",\n    );\n  });\n\n  // Re-render the JSON object on every state change, then paint the initial state.\n  store.subscribe(renderState);\n  renderState();\n}\n\nconst STYLE_ID = \"dev-panel-styles\";\n\nfunction injectStyles(): void {\n  if (document.getElementById(STYLE_ID)) return;\n  const style = document.createElement(\"style\");\n  style.id = STYLE_ID;\n  style.textContent = PANEL_CSS;\n  document.head.appendChild(style);\n}\n\nconst PANEL_CSS = `\n#dev-panel {\n  position: fixed;\n  top: 16px;\n  right: 16px;\n  width: min(360px, calc(100vw - 32px));\n  max-width: calc(100vw - 32px);\n  box-sizing: border-box;\n  max-height: calc(100vh - 32px);\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px 14px;\n  background: #0f1419;\n  color: #d7e0e8;\n  border: 1px solid #2a3441;\n  border-radius: 12px;\n  box-shadow: 0 20px 50px -20px rgba(0,0,0,.6);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 12px;\n  z-index: 1000;\n}\n#dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }\n#dev-panel .dev-toggle {\n  margin-left: auto;\n  flex: none;\n  width: 22px;\n  height: 22px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background: transparent;\n  color: #7c8a99;\n  border: 1px solid #2a3441;\n  border-radius: 6px;\n  font-size: 12px;\n  line-height: 1;\n  cursor: pointer;\n}\n#dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }\n#dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }\n\n/* Collapsed: shrink to a small clickable widget showing only the DEV badge. */\n#dev-panel.collapsed {\n  width: auto;\n  cursor: pointer;\n  padding: 8px 10px;\n}\n#dev-panel.collapsed .dev-title,\n#dev-panel.collapsed .dev-body { display: none; }\n#dev-panel.collapsed .dev-toggle { margin-left: 6px; }\n#dev-panel .dev-badge {\n  background: #f59e0b;\n  color: #1c1206;\n  font-weight: 700;\n  font-size: 10px;\n  letter-spacing: .08em;\n  padding: 2px 6px;\n  border-radius: 5px;\n}\n#dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }\n#dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }\n#dev-panel .dev-fns code { color: #9ecbff; }\n#dev-panel .dev-section-label {\n  color: #7c8a99;\n  text-transform: uppercase;\n  letter-spacing: .08em;\n  font-size: 10px;\n  margin-top: 4px;\n}\n#dev-panel .dev-state {\n  margin: 0;\n  padding: 8px;\n  background: #060a0e;\n  border-radius: 8px;\n  overflow: auto;\n  max-height: 40vh;\n  white-space: pre;\n  color: #c8e6c9;\n}\n#dev-panel .dev-log {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  overflow-y: auto;\n  max-height: 24vh;\n  background: #060a0e;\n  border-radius: 8px;\n  padding: 6px 8px;\n}\n#dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }\n#dev-panel .dev-log-invoke { color: #9ecbff; }\n#dev-panel .dev-log-result { color: #86efac; }\n#dev-panel .dev-log-error { color: #fca5a5; }\n`;\n"],"mappings":";AAgBA,IAAI;AACJ,IAAI;AACJ,IAAI,oBAAmC,EAAE;AAGzC,SAAS,cAAoB;AAC3B,KAAI,CAAC,QAAS;AACd,SAAQ,cAAc,KAAK,UAAU,YAAY,EAAE,MAAM,EAAE;;AAG7D,SAAS,QAAQ,MAAc,MAA2C;AACxE,KAAI,CAAC,MAAO;CACZ,MAAM,OAAO,SAAS,cAAc,MAAM;AAC1C,MAAK,YAAY,wBAAwB;AAEzC,MAAK,cAAc,oBADN,IAAI,MAAM,EAAC,oBACF,CAAK,IAAI;AAC/B,OAAM,YAAY,KAAK;AACvB,OAAM,YAAY,MAAM;;AAG1B,IAAM,eAAe;AAErB,SAAS,aAAa,OAAoB,WAA0B;AAClE,OAAM,UAAU,OAAO,aAAa,UAAU;CAC9C,MAAM,SAAS,MAAM,cAAiC,cAAc;AACpE,KAAI,QAAQ;AACV,SAAO,cAAc,YAAY,MAAM;AACvC,SAAO,QAAQ,YAAY,qBAAqB;AAChD,SAAO,aAAa,iBAAiB,OAAO,CAAC,UAAU,CAAC;;AAE1D,KAAI;AACF,eAAa,QAAQ,cAAc,YAAY,MAAM,IAAI;SACnD;;AAKV,SAAgB,aAAa,SAAgC;CAC3D,MAAM,EAAE,OAAO,QAAQ,WAAW;AAClC,cAAa,MAAM;AACnB,eAAc;CACd,MAAM,OACJ,OAAO,WAAW,WACd,SAAS,cAAc,OAAO,GAC9B,kBAAkB,UAChB,SACA,SAAS;CACjB,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,KAAK;AACX,EAAC,QAAQ,SAAS,MAAM,YAAY,MAAM;AAK1C,OAAM,YAAY;;;;;;;0DAHC,OAAO,0BAA0B,IAAI,EAAE,EAC/B,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,IASG;;;;;;;AAQ/D,WAAU,MAAM,cAA2B,aAAa;AACxD,SAAQ,MAAM,cAA2B,WAAW;AAErC,OAAM,cAAiC,cACtD,EAAQ,iBAAiB,UAAU,MAAM;AACvC,IAAE,iBAAiB;AACnB,eAAa,OAAO,CAAC,MAAM,UAAU,SAAS,YAAY,CAAC;GAC3D;AAEF,OAAM,iBAAiB,eAAe;AACpC,MAAI,MAAM,UAAU,SAAS,YAAY,CAAE,cAAa,OAAO,MAAM;GACrE;CAEF,IAAI,iBAAiB;AACrB,KAAI;AACF,mBAAiB,aAAa,QAAQ,aAAa,KAAK;SAClD;AAGR,cAAa,OAAO,eAAe;AAEnC,QAAO,GAAG,oBAAoB,EAAE,cAAc,WAAW,WAAW;AAClE,UAAQ,KAAK,aAAa,GAAG,KAAK,UAAU,QAAQ,EAAE,CAAC,CAAC,IAAI,SAAS;GACrE;AACF,QAAO,GAAG,oBAAoB,EAAE,QAAQ,YAAY;AAClD,UACE,QAAQ,YAAY,UAAU,KAAK,KAAK,UAAU,OAAO,IACzD,QAAQ,UAAU,SACnB;GACD;AAGF,OAAM,UAAU,YAAY;AAC5B,cAAa;;AAGf,IAAM,WAAW;AAEjB,SAAS,eAAqB;AAC5B,KAAI,SAAS,eAAe,SAAS,CAAE;CACvC,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,KAAK;AACX,OAAM,cAAc;AACpB,UAAS,KAAK,YAAY,MAAM;;AAGlC,IAAM,YAAY"}

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;
-}