@useago/sdk 0.1.6 → 0.1.7

package/dist/createMockClient-BqNSJUu4.cjs

@@ -0,0 +1,93 @@
+"use strict";
+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 defaults = {
+    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) => {
+      var _a;
+      (_a = listeners.get(event)) == null ? void 0 : _a.delete(handler);
+    },
+    once: (event, handler) => {
+      const wrapper = (...args) => {
+        var _a;
+        (_a = listeners.get(event)) == null ? void 0 : _a.delete(wrapper);
+        handler(...args);
+      };
+      if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+      listeners.get(event).add(wrapper);
+    },
+    waitFor: (event, options2) => {
+      return new Promise((resolve, reject) => {
+        let timer;
+        const handler = (data) => {
+          var _a;
+          if (timer) clearTimeout(timer);
+          (_a = listeners.get(event)) == null ? void 0 : _a.delete(handler);
+          resolve(data);
+        };
+        if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+        listeners.get(event).add(handler);
+        if (options2 == null ? void 0 : options2.timeout) {
+          timer = setTimeout(() => {
+            var _a;
+            (_a = listeners.get(event)) == null ? void 0 : _a.delete(handler);
+            reject(new Error(`waitFor("${event}") timed out after ${options2.timeout}ms`));
+          }, options2.timeout);
+        }
+      });
+    },
+    updateConfig: () => void 0,
+    destroy: () => {
+      listeners.clear();
+    }
+  };
+  const merged = { ...defaults, ...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;
+}
+exports.createMockClient = createMockClient;
+//# sourceMappingURL=createMockClient-BqNSJUu4.cjs.map

package/dist/createMockClient-BqNSJUu4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMockClient-BqNSJUu4.cjs","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"],"names":["options"],"mappings":"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"}

package/dist/functions-B0Z0rNQW.cjs

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const showToast = {
+  name: "showToast",
+  description: "Show a toast notification to the user. Use this to confirm actions or display brief messages.",
+  parameters: {
+    type: "object",
+    properties: {
+      message: { type: "string", description: "The message to display" },
+      type: {
+        type: "string",
+        description: "Toast type",
+        enum: ["success", "error", "warning", "info"]
+      },
+      duration: {
+        type: "number",
+        description: "Duration in milliseconds (default 3000)"
+      }
+    },
+    required: ["message"]
+  },
+  handler: async () => ({ shown: false, error: "No toast handler configured" })
+};
+const showNotification = {
+  name: "showNotification",
+  description: "Show a browser notification to the user. Useful for important alerts even when the tab is not focused.",
+  parameters: {
+    type: "object",
+    properties: {
+      title: { type: "string", description: "Notification title" },
+      body: { type: "string", description: "Notification body text" }
+    },
+    required: ["title"]
+  },
+  handler: async (args) => {
+    if (typeof Notification === "undefined") {
+      return { shown: false, error: "Notifications not supported" };
+    }
+    if (Notification.permission === "denied") {
+      return { shown: false, error: "Notification permission denied" };
+    }
+    if (Notification.permission !== "granted") {
+      await Notification.requestPermission();
+    }
+    if (Notification.permission === "granted") {
+      new Notification(args.title, { body: args.body });
+      return { shown: true };
+    }
+    return { shown: false, error: "Permission not granted" };
+  }
+};
+const openUrl = {
+  name: "openUrl",
+  description: "Open a URL in a new browser tab.",
+  parameters: {
+    type: "object",
+    properties: {
+      url: { type: "string", description: "The URL to open" }
+    },
+    required: ["url"]
+  },
+  handler: async (args) => {
+    window.open(args.url, "_blank", "noopener,noreferrer");
+    return { opened: true };
+  }
+};
+const copyToClipboard = {
+  name: "copyToClipboard",
+  description: "Copy text to the user's clipboard.",
+  parameters: {
+    type: "object",
+    properties: {
+      text: { type: "string", description: "The text to copy" }
+    },
+    required: ["text"]
+  },
+  handler: async (args) => {
+    await navigator.clipboard.writeText(args.text);
+    return { copied: true };
+  }
+};
+const setTheme = {
+  name: "setTheme",
+  description: "Change the application's color theme. Sets a data-theme attribute on the document element.",
+  parameters: {
+    type: "object",
+    properties: {
+      theme: {
+        type: "string",
+        description: "Theme to apply",
+        enum: ["light", "dark", "system"]
+      }
+    },
+    required: ["theme"]
+  },
+  handler: async (args) => {
+    const theme = args.theme;
+    document.documentElement.setAttribute("data-theme", theme);
+    if (theme === "dark") {
+      document.documentElement.classList.add("dark");
+    } else {
+      document.documentElement.classList.remove("dark");
+    }
+    return { theme, applied: true };
+  }
+};
+const showConfirmDialog = {
+  name: "showConfirmDialog",
+  description: "Show a confirmation dialog to the user and return their choice (true/false).",
+  parameters: {
+    type: "object",
+    properties: {
+      message: {
+        type: "string",
+        description: "The confirmation message to display"
+      }
+    },
+    required: ["message"]
+  },
+  handler: async (args) => {
+    const confirmed = window.confirm(args.message);
+    return { confirmed };
+  }
+};
+const getUserLocation = {
+  name: "getUserLocation",
+  description: "Get the user's current geographic location (requires permission).",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
+  handler: async () => {
+    if (!navigator.geolocation) {
+      return { error: "Geolocation not supported" };
+    }
+    return new Promise((resolve) => {
+      navigator.geolocation.getCurrentPosition(
+        (pos) => resolve({
+          latitude: pos.coords.latitude,
+          longitude: pos.coords.longitude,
+          accuracy: pos.coords.accuracy
+        }),
+        (err) => resolve({ error: err.message })
+      );
+    });
+  }
+};
+const scrollToElement = {
+  name: "scrollToElement",
+  description: "Scroll the page to a specific element identified by CSS selector.",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the element to scroll to (e.g. '#section-pricing')"
+      },
+      behavior: {
+        type: "string",
+        description: "Scroll behavior",
+        enum: ["smooth", "instant"]
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const el = document.querySelector(args.selector);
+    if (!el) {
+      return { scrolled: false, error: `Element not found: ${args.selector}` };
+    }
+    el.scrollIntoView({ behavior: args.behavior || "smooth" });
+    return { scrolled: true };
+  }
+};
+const setLocalStorage = {
+  name: "setLocalStorage",
+  description: "Store a value in the browser's localStorage.",
+  parameters: {
+    type: "object",
+    properties: {
+      key: { type: "string", description: "Storage key" },
+      value: { type: "string", description: "Value to store" }
+    },
+    required: ["key", "value"]
+  },
+  handler: async (args) => {
+    localStorage.setItem(args.key, args.value);
+    return { stored: true };
+  }
+};
+const getLocalStorage = {
+  name: "getLocalStorage",
+  description: "Retrieve a value from the browser's localStorage.",
+  parameters: {
+    type: "object",
+    properties: {
+      key: { type: "string", description: "Storage key" }
+    },
+    required: ["key"]
+  },
+  handler: async (args) => {
+    const value = localStorage.getItem(args.key);
+    return { key: args.key, value, found: value !== null };
+  }
+};
+const highlightElement = {
+  name: "highlightElement",
+  description: "Highlight a DOM element to draw the user's attention (e.g. for onboarding).",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the element to highlight"
+      },
+      color: {
+        type: "string",
+        description: "Highlight border color (default: #3b82f6)"
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const el = document.querySelector(args.selector);
+    if (!el) {
+      return { highlighted: false, error: `Element not found: ${args.selector}` };
+    }
+    const prev = el.style.outline;
+    const color = args.color || "#3b82f6";
+    el.style.outline = `3px solid ${color}`;
+    el.style.outlineOffset = "2px";
+    el.scrollIntoView({ behavior: "smooth", block: "center" });
+    setTimeout(() => {
+      el.style.outline = prev;
+      el.style.outlineOffset = "";
+    }, 3e3);
+    return { highlighted: true };
+  }
+};
+const submitForm = {
+  name: "submitForm",
+  description: "Fill and submit an HTML form on the page. Pass field values as key-value pairs.",
+  parameters: {
+    type: "object",
+    properties: {
+      selector: {
+        type: "string",
+        description: "CSS selector of the form element"
+      },
+      values: {
+        type: "string",
+        description: "JSON string of field name → value pairs"
+      }
+    },
+    required: ["selector"]
+  },
+  handler: async (args) => {
+    const form = document.querySelector(args.selector);
+    if (!form) {
+      return { submitted: false, error: `Form not found: ${args.selector}` };
+    }
+    if (args.values) {
+      const values = JSON.parse(args.values);
+      for (const [name, value] of Object.entries(values)) {
+        const input = form.elements.namedItem(name);
+        if (input) input.value = value;
+      }
+    }
+    form.requestSubmit();
+    return { submitted: true };
+  }
+};
+const trackEvent = {
+  name: "trackEvent",
+  description: "Track a custom analytics event. Override the handler to wire up your analytics provider.",
+  parameters: {
+    type: "object",
+    properties: {
+      event: { type: "string", description: "Event name" },
+      properties: {
+        type: "string",
+        description: "JSON string of event properties"
+      }
+    },
+    required: ["event"]
+  },
+  handler: async (args) => {
+    const props = args.properties ? JSON.parse(args.properties) : {};
+    console.log(`[AGO Analytics] ${args.event}`, props);
+    return { tracked: true, event: args.event };
+  }
+};
+exports.copyToClipboard = copyToClipboard;
+exports.getLocalStorage = getLocalStorage;
+exports.getUserLocation = getUserLocation;
+exports.highlightElement = highlightElement;
+exports.openUrl = openUrl;
+exports.scrollToElement = scrollToElement;
+exports.setLocalStorage = setLocalStorage;
+exports.setTheme = setTheme;
+exports.showConfirmDialog = showConfirmDialog;
+exports.showNotification = showNotification;
+exports.showToast = showToast;
+exports.submitForm = submitForm;
+exports.trackEvent = trackEvent;
+//# sourceMappingURL=functions-B0Z0rNQW.cjs.map

package/dist/functions-B0Z0rNQW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-B0Z0rNQW.cjs","sources":["../src/helpers/functions.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"../functions/types\";\n\n/**\n * Show a toast/notification to the user.\n * The handler is a no-op by default — wire it up to your toast library.\n *\n * ```ts\n * import { showToast } from \"@useago/sdk/helpers\";\n * showToast.handler = async (args) => { myToast(args.message); return { shown: true }; };\n * client.registerFunction(showToast);\n * ```\n */\nexport const showToast: ClientFunctionDefinition = {\n  name: \"showToast\",\n  description:\n    \"Show a toast notification to the user. Use this to confirm actions or display brief messages.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      message: { type: \"string\", description: \"The message to display\" },\n      type: {\n        type: \"string\",\n        description: \"Toast type\",\n        enum: [\"success\", \"error\", \"warning\", \"info\"],\n      },\n      duration: {\n        type: \"number\",\n        description: \"Duration in milliseconds (default 3000)\",\n      },\n    },\n    required: [\"message\"],\n  },\n  handler: async () => ({ shown: false, error: \"No toast handler configured\" }),\n};\n\n/**\n * Show a browser notification (requires permission).\n */\nexport const showNotification: ClientFunctionDefinition = {\n  name: \"showNotification\",\n  description:\n    \"Show a browser notification to the user. Useful for important alerts even when the tab is not focused.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      title: { type: \"string\", description: \"Notification title\" },\n      body: { type: \"string\", description: \"Notification body text\" },\n    },\n    required: [\"title\"],\n  },\n  handler: async (args) => {\n    if (typeof Notification === \"undefined\") {\n      return { shown: false, error: \"Notifications not supported\" };\n    }\n    if (Notification.permission === \"denied\") {\n      return { shown: false, error: \"Notification permission denied\" };\n    }\n    if (Notification.permission !== \"granted\") {\n      await Notification.requestPermission();\n    }\n    if (Notification.permission === \"granted\") {\n      new Notification(args.title as string, { body: args.body as string });\n      return { shown: true };\n    }\n    return { shown: false, error: \"Permission not granted\" };\n  },\n};\n\n/**\n * Open a URL in a new tab.\n */\nexport const openUrl: ClientFunctionDefinition = {\n  name: \"openUrl\",\n  description: \"Open a URL in a new browser tab.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      url: { type: \"string\", description: \"The URL to open\" },\n    },\n    required: [\"url\"],\n  },\n  handler: async (args) => {\n    window.open(args.url as string, \"_blank\", \"noopener,noreferrer\");\n    return { opened: true };\n  },\n};\n\n/**\n * Copy text to clipboard.\n */\nexport const copyToClipboard: ClientFunctionDefinition = {\n  name: \"copyToClipboard\",\n  description: \"Copy text to the user's clipboard.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      text: { type: \"string\", description: \"The text to copy\" },\n    },\n    required: [\"text\"],\n  },\n  handler: async (args) => {\n    await navigator.clipboard.writeText(args.text as string);\n    return { copied: true };\n  },\n};\n\n/**\n * Set the application theme (light/dark/system).\n * Default handler toggles a `data-theme` attribute on `<html>`.\n */\nexport const setTheme: ClientFunctionDefinition = {\n  name: \"setTheme\",\n  description:\n    \"Change the application's color theme. Sets a data-theme attribute on the document element.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      theme: {\n        type: \"string\",\n        description: \"Theme to apply\",\n        enum: [\"light\", \"dark\", \"system\"],\n      },\n    },\n    required: [\"theme\"],\n  },\n  handler: async (args) => {\n    const theme = args.theme as string;\n    document.documentElement.setAttribute(\"data-theme\", theme);\n    if (theme === \"dark\") {\n      document.documentElement.classList.add(\"dark\");\n    } else {\n      document.documentElement.classList.remove(\"dark\");\n    }\n    return { theme, applied: true };\n  },\n};\n\n/**\n * Show a confirm dialog and return the user's choice.\n */\nexport const showConfirmDialog: ClientFunctionDefinition = {\n  name: \"showConfirmDialog\",\n  description:\n    \"Show a confirmation dialog to the user and return their choice (true/false).\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      message: {\n        type: \"string\",\n        description: \"The confirmation message to display\",\n      },\n    },\n    required: [\"message\"],\n  },\n  handler: async (args) => {\n    const confirmed = window.confirm(args.message as string);\n    return { confirmed };\n  },\n};\n\n/**\n * Get the user's geolocation.\n */\nexport const getUserLocation: ClientFunctionDefinition = {\n  name: \"getUserLocation\",\n  description:\n    \"Get the user's current geographic location (requires permission).\",\n  parameters: {\n    type: \"object\",\n    properties: {},\n  },\n  handler: async () => {\n    if (!navigator.geolocation) {\n      return { error: \"Geolocation not supported\" };\n    }\n    return new Promise((resolve) => {\n      navigator.geolocation.getCurrentPosition(\n        (pos) =>\n          resolve({\n            latitude: pos.coords.latitude,\n            longitude: pos.coords.longitude,\n            accuracy: pos.coords.accuracy,\n          }),\n        (err) => resolve({ error: err.message })\n      );\n    });\n  },\n};\n\n/**\n * Scroll to an element on the page.\n */\nexport const scrollToElement: ClientFunctionDefinition = {\n  name: \"scrollToElement\",\n  description: \"Scroll the page to a specific element identified by CSS selector.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the element to scroll to (e.g. '#section-pricing')\",\n      },\n      behavior: {\n        type: \"string\",\n        description: \"Scroll behavior\",\n        enum: [\"smooth\", \"instant\"],\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const el = document.querySelector(args.selector as string);\n    if (!el) {\n      return { scrolled: false, error: `Element not found: ${args.selector}` };\n    }\n    el.scrollIntoView({ behavior: (args.behavior as ScrollBehavior) || \"smooth\" });\n    return { scrolled: true };\n  },\n};\n\n/**\n * Set a value in localStorage.\n */\nexport const setLocalStorage: ClientFunctionDefinition = {\n  name: \"setLocalStorage\",\n  description: \"Store a value in the browser's localStorage.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      key: { type: \"string\", description: \"Storage key\" },\n      value: { type: \"string\", description: \"Value to store\" },\n    },\n    required: [\"key\", \"value\"],\n  },\n  handler: async (args) => {\n    localStorage.setItem(args.key as string, args.value as string);\n    return { stored: true };\n  },\n};\n\n/**\n * Get a value from localStorage.\n */\nexport const getLocalStorage: ClientFunctionDefinition = {\n  name: \"getLocalStorage\",\n  description: \"Retrieve a value from the browser's localStorage.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      key: { type: \"string\", description: \"Storage key\" },\n    },\n    required: [\"key\"],\n  },\n  handler: async (args) => {\n    const value = localStorage.getItem(args.key as string);\n    return { key: args.key, value, found: value !== null };\n  },\n};\n\n/**\n * Highlight an element on the page (useful for guided tours).\n */\nexport const highlightElement: ClientFunctionDefinition = {\n  name: \"highlightElement\",\n  description:\n    \"Highlight a DOM element to draw the user's attention (e.g. for onboarding).\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the element to highlight\",\n      },\n      color: {\n        type: \"string\",\n        description: \"Highlight border color (default: #3b82f6)\",\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const el = document.querySelector(args.selector as string) as HTMLElement | null;\n    if (!el) {\n      return { highlighted: false, error: `Element not found: ${args.selector}` };\n    }\n    const prev = el.style.outline;\n    const color = (args.color as string) || \"#3b82f6\";\n    el.style.outline = `3px solid ${color}`;\n    el.style.outlineOffset = \"2px\";\n    el.scrollIntoView({ behavior: \"smooth\", block: \"center\" });\n    setTimeout(() => {\n      el.style.outline = prev;\n      el.style.outlineOffset = \"\";\n    }, 3000);\n    return { highlighted: true };\n  },\n};\n\n/**\n * Submit a form on the page programmatically.\n */\nexport const submitForm: ClientFunctionDefinition = {\n  name: \"submitForm\",\n  description:\n    \"Fill and submit an HTML form on the page. Pass field values as key-value pairs.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      selector: {\n        type: \"string\",\n        description: \"CSS selector of the form element\",\n      },\n      values: {\n        type: \"string\",\n        description: \"JSON string of field name → value pairs\",\n      },\n    },\n    required: [\"selector\"],\n  },\n  handler: async (args) => {\n    const form = document.querySelector(args.selector as string) as HTMLFormElement | null;\n    if (!form) {\n      return { submitted: false, error: `Form not found: ${args.selector}` };\n    }\n    if (args.values) {\n      const values = JSON.parse(args.values as string) as Record<string, string>;\n      for (const [name, value] of Object.entries(values)) {\n        const input = form.elements.namedItem(name) as HTMLInputElement | null;\n        if (input) input.value = value;\n      }\n    }\n    form.requestSubmit();\n    return { submitted: true };\n  },\n};\n\n/**\n * Track a custom analytics event.\n * Default handler logs to console — replace with your analytics provider.\n */\nexport const trackEvent: ClientFunctionDefinition = {\n  name: \"trackEvent\",\n  description:\n    \"Track a custom analytics event. Override the handler to wire up your analytics provider.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      event: { type: \"string\", description: \"Event name\" },\n      properties: {\n        type: \"string\",\n        description: \"JSON string of event properties\",\n      },\n    },\n    required: [\"event\"],\n  },\n  handler: async (args) => {\n    const props = args.properties ? JSON.parse(args.properties as string) : {};\n    console.log(`[AGO Analytics] ${args.event}`, props);\n    return { tracked: true, event: args.event };\n  },\n};\n"],"names":[],"mappings":"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"}