@useago/sdk 0.3.2 → 0.3.4

package/dist/devtools.d.ts

@@ -1,2 +1,443 @@
-export * from './devtools/index'
-export {}
+/**
+ * Agent information
+ */
+declare interface AgoAgent {
+    id: string;
+    name: string;
+    displayName?: string;
+}
+
+/**
+ * Main SDK client for AGO Chat integration
+ */
+declare class AgoClient {
+    private httpClient;
+    private functionRegistry;
+    private contextRegistry;
+    private eventEmitter;
+    private config;
+    constructor(config: AgoConfig);
+    /**
+     * Send a message and receive a streaming response
+     */
+    sendMessage(content: string, options?: SendMessageOptions): Promise<AgoMessage>;
+    private processSSEResponse;
+    private handleClientFunctionInvocation;
+    /**
+     * Get list of conversations
+     */
+    getConversations(): Promise<Conversation[]>;
+    /**
+     * Get a specific conversation with messages
+     */
+    getConversation(conversationId: string): Promise<Conversation>;
+    /**
+     * Get messages for a conversation
+     */
+    getMessages(conversationId: string): Promise<AgoMessage[]>;
+    /**
+     * Submit form data for a tool call
+     */
+    submitToolCallForm(toolCallId: string, formData: Record<string, unknown>): Promise<void>;
+    /**
+     * Confirm a tool call
+     */
+    confirmToolCall(toolCallId: string): Promise<void>;
+    /**
+     * Reject a tool call
+     */
+    rejectToolCall(toolCallId: string): Promise<void>;
+    /**
+     * Relay a completed form collector's values to a server-configured destination.
+     *
+     * Used by `createFormCollector` / `useFormCollector` in `{ via: "backend" }` mode:
+     * the browser never holds the destination URL or its secret — the backend resolves
+     * `destination` (a named, opted-in tool) and forwards the values from the server.
+     */
+    submitFormCollector(destination: string, values: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Submit feedback for a message
+     */
+    submitFeedback(messageId: string, rating: "positive" | "negative"): Promise<void>;
+    /**
+     * Register a client-side function that AGO can call.
+     * Accepts either a definition object or (name, handler, schema) args.
+     *
+     * ```ts
+     * // Single-object (preferred)
+     * client.registerFunction({
+     *   name: "lookupOrder",
+     *   description: "Look up an order",
+     *   parameters: { type: "object", properties: { id: { type: "string" } } },
+     *   handler: async (args) => fetchOrder(args.id),
+     * });
+     *
+     * // Classic 3-arg form
+     * client.registerFunction("lookupOrder", handler, schema);
+     * ```
+     */
+    registerFunction(definition: ClientFunctionDefinition): void;
+    registerFunction(name: string, handler: ClientFunctionHandler, schema: Omit<ClientFunctionSchema, "name">): void;
+    /**
+     * Short alias for `registerFunction`. Also accepts an array of definitions.
+     *
+     * ```ts
+     * client.register(lookupOrder);
+     * client.register([lookupOrder, cancelOrder]);
+     * ```
+     */
+    register(definition: ClientFunctionDefinition | ClientFunctionDefinition[]): void;
+    /**
+     * Unregister a client-side function
+     */
+    unregisterFunction(name: string): boolean;
+    /**
+     * Get all registered function schemas
+     */
+    getRegisteredFunctions(): ClientFunctionSchema[];
+    /**
+     * Register a navigation function that lets AGO navigate users to different pages.
+     * @param navigate - A callback that performs the navigation (e.g. react-router's navigate)
+     * @param routes - Map of route names to paths, with descriptions for the LLM
+     */
+    registerNavigationFunction(navigate: (path: string) => void, routes: Array<{
+        name: string;
+        path: string;
+        description: string;
+    }>): void;
+    /**
+     * Register or update a piece of client-side context.
+     * This context is sent with every message so the AI understands the user's situation.
+     *
+     * ```ts
+     * client.setContext("order-page", {
+     *   name: "Order detail",
+     *   description: "User is viewing order #123",
+     *   data: { orderId: "123", status: "shipped" },
+     * });
+     * ```
+     */
+    setContext(key: string, entry: ContextEntry): void;
+    /**
+     * Remove a previously registered context entry.
+     */
+    removeContext(key: string): boolean;
+    /**
+     * Register a dynamic context provider. The callback is invoked every time
+     * a message is sent, so the AI always gets the freshest data.
+     *
+     * Use this for context that lives outside React state — global stores,
+     * refs, or computed values.
+     *
+     * ```ts
+     * client.addDynamicContext("cart", () => ({
+     *   name: "Checkout",
+     *   data: { itemCount: cart.items.length, total: cart.total },
+     * }));
+     * ```
+     */
+    addDynamicContext(key: string, provider: DynamicContextProvider): void;
+    /**
+     * Remove a dynamic context provider.
+     */
+    removeDynamicContext(key: string): boolean;
+    /**
+     * Enable automatic capture of the current browser page (URL + title).
+     * Injected as a dynamic context entry named `browser-page`.
+     */
+    enableAutoPageContext(): void;
+    /**
+     * Get the current context snapshot.
+     */
+    getContextSnapshot(): ContextSnapshot | null;
+    /**
+     * Subscribe to an event
+     */
+    on<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void;
+    /**
+     * Unsubscribe from an event
+     */
+    off<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void;
+    /**
+     * Subscribe to an event once — auto-unsubscribes after the first call.
+     */
+    once<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void;
+    /**
+     * Returns a Promise that resolves the next time `event` fires.
+     *
+     * ```ts
+     * const msg = await client.waitFor("message:complete", { timeout: 10000 });
+     * ```
+     */
+    waitFor<K extends AgoEventName>(event: K, options?: {
+        timeout?: number;
+    }): Promise<AgoClientEvents[K]>;
+    /**
+     * Update client configuration
+     */
+    updateConfig(config: Partial<AgoConfig>): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+
+/**
+ * SDK Events
+ */
+declare 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;
+    };
+}
+
+/**
+ * SDK Configuration
+ */
+declare 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;
+}
+
+declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;
+
+declare type AgoEventName = keyof AgoClientEvents;
+
+/**
+ * Message from AGO
+ */
+declare interface AgoMessage {
+    id: string;
+    conversationId: string;
+    content: string;
+    role: "user" | "assistant";
+    status: MessageStatus;
+    agent?: AgoAgent;
+    sources?: AgoSource[];
+    toolCalls?: ToolCallData[];
+    followUpReplies?: string[];
+    createdAt: Date;
+}
+
+/**
+ * Knowledge source citation
+ */
+declare interface AgoSource {
+    id: string;
+    title: string;
+    url?: string;
+}
+
+/**
+ * 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);
+ * ```
+ */
+declare interface ClientFunctionDefinition {
+    name: string;
+    description: string;
+    parameters: ClientFunctionSchema["parameters"];
+    handler: ClientFunctionHandler;
+}
+
+/**
+ * Function handler type
+ */
+declare type ClientFunctionHandler = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+
+declare interface ClientFunctionInvocation {
+    invocationId: string;
+    functionName: string;
+    arguments: Record<string, unknown>;
+    conversationId: string;
+}
+
+/**
+ * Schema for a client-side function that AGO can call
+ */
+declare 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[];
+    };
+}
+
+/**
+ * A single piece of context the client wants the LLM to know about.
+ */
+declare interface ContextEntry {
+    /** Human-readable label (e.g. "Order detail", "Current user") */
+    name?: string;
+    /** Short description of what this context represents */
+    description?: string;
+    /** Arbitrary structured data the AI should know about */
+    data?: Record<string, unknown>;
+}
+
+/**
+ * Serialised client context sent with each message.
+ */
+declare interface ContextSnapshot {
+    /** All active context entries keyed by their registration key */
+    entries: Record<string, ContextEntry>;
+}
+
+/**
+ * Conversation/Thread
+ */
+declare interface Conversation {
+    id: string;
+    title: string;
+    lastMessageDate: Date;
+    messages?: AgoMessage[];
+}
+
+/** Options for {@link initDevPanel}. */
+export declare 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;
+}
+
+/**
+ * A function that returns a fresh context entry on demand.
+ * Evaluated every time a message is sent — use it to pull data from stores,
+ * refs, or any source that isn't captured by React state.
+ */
+declare type DynamicContextProvider = () => ContextEntry | null | undefined;
+
+declare interface FormField {
+    type: "string" | "number" | "boolean" | "array";
+    title?: string;
+    description?: string;
+    enum?: string[];
+    default?: unknown;
+}
+
+/**
+ * Form schema for tool calls requiring user input
+ */
+declare interface FormSchema {
+    type: "object";
+    properties: Record<string, FormField>;
+    required?: string[];
+}
+
+export declare function initDevPanel(options: DevPanelOptions): void;
+
+declare type MessageStatus = "IN_PROGRESS" | "DONE" | "ERROR" | "TODO" | "CANCELED";
+
+/**
+ * Options for sending a message
+ */
+declare interface SendMessageOptions {
+    /** Existing conversation ID */
+    conversationId?: string;
+    /** Override default agent */
+    agentId?: string;
+    /** File attachments */
+    files?: File[];
+}
+
+/**
+ * A minimal observable store: one value, synchronous subscriptions, and
+ * optional persistence via {@link PersistOptions} (localStorage by default).
+ *
+ * ```ts
+ * const store = createStore({ count: 0 });
+ * store.subscribe((state) => save(state));
+ * store.set({ count: 1 }); // listeners fire synchronously
+ *
+ * const cart = createStore({ items: [] }, { key: "cart" }); // persisted
+ * ```
+ */
+declare interface Store<T> {
+    /** Current state. */
+    get(): T;
+    /** Replace the state and notify subscribers synchronously. */
+    set(next: T): void;
+    /** Register a listener; returns a function that removes it. */
+    subscribe(listener: (state: T) => void): () => void;
+}
+
+/**
+ * Tool call data from SSE stream
+ */
+declare 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>;
+}
+
+declare type ToolCallType = "form" | "confirmation_input" | "status_message" | "progress_indicator" | "client_function" | "reasoning" | "mcp_ui_resource";
+
+export { }

package/dist/devtools.js

@@ -1,87 +1,63 @@
-//#region src/devtools/initDevPanel.ts
-var stateEl;
-var logEl;
-var getStateFn = () => ({});
-function renderState() {
-	if (!stateEl) return;
-	stateEl.textContent = JSON.stringify(getStateFn(), null, 2);
+var r, d, x = () => ({});
+function p() {
+  r && (r.textContent = JSON.stringify(x(), null, 2));
 }
-function logLine(text, kind) {
-	if (!logEl) return;
-	const line = document.createElement("div");
-	line.className = `dev-log-line dev-log-${kind}`;
-	line.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${text}`;
-	logEl.appendChild(line);
-	logEl.scrollTop = logEl.scrollHeight;
+function g(t, a) {
+  if (!d) return;
+  const e = document.createElement("div");
+  e.className = `dev-log-line dev-log-${a}`, e.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${t}`, d.appendChild(e), d.scrollTop = d.scrollHeight;
 }
-var COLLAPSE_KEY = "devPanelCollapsed";
-function setCollapsed(panel, collapsed) {
-	panel.classList.toggle("collapsed", collapsed);
-	const toggle = panel.querySelector(".dev-toggle");
-	if (toggle) {
-		toggle.textContent = collapsed ? "▢" : "—";
-		toggle.title = collapsed ? "Expand dev tools" : "Collapse dev tools";
-		toggle.setAttribute("aria-expanded", String(!collapsed));
-	}
-	try {
-		localStorage.setItem(COLLAPSE_KEY, collapsed ? "1" : "0");
-	} catch {}
+var u = "ago_dev_panel_collapsed";
+function s(t, a) {
+  t.classList.toggle("collapsed", a);
+  const e = t.querySelector(".dev-toggle");
+  e && (e.textContent = a ? "▢" : "—", e.title = a ? "Expand dev tools" : "Collapse dev tools", e.setAttribute("aria-expanded", String(!a)));
+  try {
+    localStorage.setItem(u, a ? "1" : "0");
+  } catch {
+  }
 }
-function initDevPanel(options) {
-	const { store, client, target } = options;
-	getStateFn = store.get;
-	injectStyles();
-	const host = typeof target === "string" ? document.querySelector(target) : target instanceof Element ? target : document.body;
-	const panel = document.createElement("aside");
-	panel.id = "dev-panel";
-	(host ?? document.body).appendChild(panel);
-	panel.innerHTML = `
+function m(t) {
+  const { store: a, client: e, target: i } = t;
+  x = a.get, b();
+  const f = typeof i == "string" ? document.querySelector(i) : i instanceof Element ? i : document.body, o = document.createElement("aside");
+  o.id = "ago-dev-panel", (f ?? document.body).appendChild(o), o.innerHTML = `
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">DEV TOOLS · client-side function state — not for production</span>
       <button type="button" class="dev-toggle" aria-label="Toggle dev tools">—</button>
     </div>
     <div class="dev-body">
-      <div class="dev-fns">Registered functions: <code>${(client.getRegisteredFunctions?.() ?? []).map((f) => f.name).join(", ") || "—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.() ?? []).map((n) => n.name).join(", ") || "—"}</code></div>
       <div class="dev-section-label">JSON object (built by the agent)</div>
-      <pre class="dev-state" id="dev-state"></pre>
+      <pre class="dev-state" id="ago-dev-state"></pre>
       <div class="dev-section-label">Function calls</div>
-      <div class="dev-log" id="dev-log"></div>
+      <div class="dev-log" id="ago-dev-log"></div>
     </div>
-  `;
-	stateEl = panel.querySelector("#dev-state");
-	logEl = panel.querySelector("#dev-log");
-	panel.querySelector(".dev-toggle")?.addEventListener("click", (e) => {
-		e.stopPropagation();
-		setCollapsed(panel, !panel.classList.contains("collapsed"));
-	});
-	panel.addEventListener("click", () => {
-		if (panel.classList.contains("collapsed")) setCollapsed(panel, false);
-	});
-	let startCollapsed = false;
-	try {
-		startCollapsed = localStorage.getItem(COLLAPSE_KEY) === "1";
-	} catch {}
-	setCollapsed(panel, startCollapsed);
-	client.on("function:invoke", ({ functionName, arguments: args }) => {
-		logLine(`→ ${functionName}(${JSON.stringify(args ?? {})})`, "invoke");
-	});
-	client.on("function:result", ({ result, error }) => {
-		logLine(error ? `✗ error: ${error}` : `← ${JSON.stringify(result)}`, error ? "error" : "result");
-	});
-	store.subscribe(renderState);
-	renderState();
+  `, r = o.querySelector("#ago-dev-state"), d = o.querySelector("#ago-dev-log"), o.querySelector(".dev-toggle")?.addEventListener("click", (n) => {
+    n.stopPropagation(), s(o, !o.classList.contains("collapsed"));
+  }), o.addEventListener("click", () => {
+    o.classList.contains("collapsed") && s(o, !1);
+  });
+  let c = !1;
+  try {
+    c = localStorage.getItem(u) === "1";
+  } catch {
+  }
+  s(o, c), e.on("function:invoke", ({ functionName: n, arguments: l }) => {
+    g(`→ ${n}(${JSON.stringify(l ?? {})})`, "invoke");
+  }), e.on("function:result", ({ result: n, error: l }) => {
+    g(l ? `✗ error: ${l}` : `← ${JSON.stringify(n)}`, l ? "error" : "result");
+  }), a.subscribe(p), p();
 }
-var STYLE_ID = "dev-panel-styles";
-function injectStyles() {
-	if (document.getElementById(STYLE_ID)) return;
-	const style = document.createElement("style");
-	style.id = STYLE_ID;
-	style.textContent = PANEL_CSS;
-	document.head.appendChild(style);
+var v = "ago-dev-panel-styles";
+function b() {
+  if (document.getElementById(v)) return;
+  const t = document.createElement("style");
+  t.id = v, t.textContent = h, document.head.appendChild(t);
 }
-var PANEL_CSS = `
-#dev-panel {
+var h = `
+#ago-dev-panel {
   position: fixed;
   top: 16px;
   right: 16px;
@@ -102,8 +78,8 @@ var PANEL_CSS = `
   font-size: 12px;
   z-index: 1000;
 }
-#dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }
-#dev-panel .dev-toggle {
+#ago-dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }
+#ago-dev-panel .dev-toggle {
   margin-left: auto;
   flex: none;
   width: 22px;
@@ -119,19 +95,19 @@ var PANEL_CSS = `
   line-height: 1;
   cursor: pointer;
 }
-#dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
-#dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }
+#ago-dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
+#ago-dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }
 
 /* Collapsed: shrink to a small clickable widget showing only the DEV badge. */
-#dev-panel.collapsed {
+#ago-dev-panel.collapsed {
   width: auto;
   cursor: pointer;
   padding: 8px 10px;
 }
-#dev-panel.collapsed .dev-title,
-#dev-panel.collapsed .dev-body { display: none; }
-#dev-panel.collapsed .dev-toggle { margin-left: 6px; }
-#dev-panel .dev-badge {
+#ago-dev-panel.collapsed .dev-title,
+#ago-dev-panel.collapsed .dev-body { display: none; }
+#ago-dev-panel.collapsed .dev-toggle { margin-left: 6px; }
+#ago-dev-panel .dev-badge {
   background: #f59e0b;
   color: #1c1206;
   font-weight: 700;
@@ -140,17 +116,17 @@ var PANEL_CSS = `
   padding: 2px 6px;
   border-radius: 5px;
 }
-#dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
-#dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }
-#dev-panel .dev-fns code { color: #9ecbff; }
-#dev-panel .dev-section-label {
+#ago-dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
+#ago-dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }
+#ago-dev-panel .dev-fns code { color: #9ecbff; }
+#ago-dev-panel .dev-section-label {
   color: #7c8a99;
   text-transform: uppercase;
   letter-spacing: .08em;
   font-size: 10px;
   margin-top: 4px;
 }
-#dev-panel .dev-state {
+#ago-dev-panel .dev-state {
   margin: 0;
   padding: 8px;
   background: #060a0e;
@@ -160,7 +136,7 @@ var PANEL_CSS = `
   white-space: pre;
   color: #c8e6c9;
 }
-#dev-panel .dev-log {
+#ago-dev-panel .dev-log {
   display: flex;
   flex-direction: column;
   gap: 2px;
@@ -170,12 +146,11 @@ var PANEL_CSS = `
   border-radius: 8px;
   padding: 6px 8px;
 }
-#dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
-#dev-panel .dev-log-invoke { color: #9ecbff; }
-#dev-panel .dev-log-result { color: #86efac; }
-#dev-panel .dev-log-error { color: #fca5a5; }
+#ago-dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
+#ago-dev-panel .dev-log-invoke { color: #9ecbff; }
+#ago-dev-panel .dev-log-result { color: #86efac; }
+#ago-dev-panel .dev-log-error { color: #fca5a5; }
 `;
-//#endregion
-export { initDevPanel };
-
-//# sourceMappingURL=devtools.js.map
+export {
+  m as initDevPanel
+};

package/dist/functions-BH1X5kas.cjs

@@ -0,0 +1 @@
+const v=require("./rolldown-runtime-CaekUdDJ.cjs");var w=v.__exportAll({copyToClipboard:()=>c,getLocalStorage:()=>f,getUserLocation:()=>p,highlightElement:()=>h,openUrl:()=>a,scrollToElement:()=>d,setLocalStorage:()=>m,setTheme:()=>l,showConfirmDialog:()=>u,showNotification:()=>s,showToast:()=>i,submitForm:()=>y,trackEvent:()=>g}),i={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:!1,error:"No toast handler configured"})},s={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 e=>typeof Notification>"u"?{shown:!1,error:"Notifications not supported"}:Notification.permission==="denied"?{shown:!1,error:"Notification permission denied"}:(Notification.permission!=="granted"&&await Notification.requestPermission(),Notification.permission==="granted"?(new Notification(e.title,{body:e.body}),{shown:!0}):{shown:!1,error:"Permission not granted"})},a={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 e=>(window.open(e.url,"_blank","noopener,noreferrer"),{opened:!0})},c={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 e=>(await navigator.clipboard.writeText(e.text),{copied:!0})},l={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 e=>{const t=e.theme;return document.documentElement.setAttribute("data-theme",t),t==="dark"?document.documentElement.classList.add("dark"):document.documentElement.classList.remove("dark"),{theme:t,applied:!0}}},u={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 e=>({confirmed:window.confirm(e.message)})},p={name:"getUserLocation",description:"Get the user's current geographic location (requires permission).",parameters:{type:"object",properties:{}},handler:async()=>navigator.geolocation?new Promise(e=>{navigator.geolocation.getCurrentPosition(t=>e({latitude:t.coords.latitude,longitude:t.coords.longitude,accuracy:t.coords.accuracy}),t=>e({error:t.message}))}):{error:"Geolocation not supported"}},d={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 e=>{const t=document.querySelector(e.selector);return t?(t.scrollIntoView({behavior:e.behavior||"smooth"}),{scrolled:!0}):{scrolled:!1,error:`Element not found: ${e.selector}`}}},m={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 e=>(localStorage.setItem(e.key,e.value),{stored:!0})},f={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 e=>{const t=localStorage.getItem(e.key);return{key:e.key,value:t,found:t!==null}}},h={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 e=>{const t=document.querySelector(e.selector);if(!t)return{highlighted:!1,error:`Element not found: ${e.selector}`};const r=t.style.outline,o=e.color||"#3b82f6";return t.style.outline=`3px solid ${o}`,t.style.outlineOffset="2px",t.scrollIntoView({behavior:"smooth",block:"center"}),setTimeout(()=>{t.style.outline=r,t.style.outlineOffset=""},3e3),{highlighted:!0}}},y={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 e=>{const t=document.querySelector(e.selector);if(!t)return{submitted:!1,error:`Form not found: ${e.selector}`};if(e.values){const r=JSON.parse(e.values);for(const[o,b]of Object.entries(r)){const n=t.elements.namedItem(o);n&&(n.value=b)}}return t.requestSubmit(),{submitted:!0}}},g={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 e=>{const t=e.properties?JSON.parse(e.properties):{};return console.log(`[AGO Analytics] ${e.event}`,t),{tracked:!0,event:e.event}}};Object.defineProperty(exports,"copyToClipboard",{enumerable:!0,get:function(){return c}});Object.defineProperty(exports,"functions_exports",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"getLocalStorage",{enumerable:!0,get:function(){return f}});Object.defineProperty(exports,"getUserLocation",{enumerable:!0,get:function(){return p}});Object.defineProperty(exports,"highlightElement",{enumerable:!0,get:function(){return h}});Object.defineProperty(exports,"openUrl",{enumerable:!0,get:function(){return a}});Object.defineProperty(exports,"scrollToElement",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"setLocalStorage",{enumerable:!0,get:function(){return m}});Object.defineProperty(exports,"setTheme",{enumerable:!0,get:function(){return l}});Object.defineProperty(exports,"showConfirmDialog",{enumerable:!0,get:function(){return u}});Object.defineProperty(exports,"showNotification",{enumerable:!0,get:function(){return s}});Object.defineProperty(exports,"showToast",{enumerable:!0,get:function(){return i}});Object.defineProperty(exports,"submitForm",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"trackEvent",{enumerable:!0,get:function(){return g}});