@useago/sdk 1.5.2 → 1.5.4

package/dist/widget.d.ts

@@ -1,3 +1,19 @@
+declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 /**
  * Agent information
  */
@@ -36,6 +52,8 @@ declare class AgoClient {
     private functionRegistry;
     private contextRegistry;
     private eventEmitter;
+    private activityLedger;
+    private lastSentPageState;
     private config;
     /** Conversations already warned about an empty reply (one warning each). */
     private warnedEmptyConversations;
@@ -49,6 +67,12 @@ declare class AgoClient {
     private pendingApprovals;
     /** App-provided gate deciding WHEN a paused turn resumes (see {@link registerResumeGate}). */
     private resumeGate;
+    /**
+     * Proactive-mode controller, set when the client was created with
+     * `proactive` options or when `createAgoProactive(client, opts)` was called.
+     * `null` otherwise.
+     */
+    proactive: ProactiveController | null;
     constructor(config: AgoConfig);
     /**
      * Send a message and receive a streaming response
@@ -219,6 +243,14 @@ declare class AgoClient {
      * Get all registered function schemas
      */
     getRegisteredFunctions(): ClientFunctionSchema[];
+    /**
+     * Execute a registered client function locally, through the same
+     * FunctionRegistry path (result-size guard, error wrapping) as agent-invoked
+     * calls. Used by proactive nudge actions, where the user's explicit click on
+     * the action button constitutes the approval — nothing is submitted to the
+     * backend (there is no tool call to answer).
+     */
+    executeClientFunction(name: string, args: Record<string, unknown>): Promise<unknown>;
     /**
      * Register a navigation function that lets AGO navigate users to different pages.
      *
@@ -320,6 +352,9 @@ declare class AgoClient {
      */
     notifyContextChanged(): void;
     /* Excluded from this release type: emitFormEvent */
+    /* Excluded from this release type: emitProactiveEvent */
+    /* Excluded from this release type: getHttp */
+    /* Excluded from this release type: getConfiguredAgent */
     /**
      * Enable automatic capture of the current browser page (URL + title).
      * Injected as a dynamic context entry named `browser-page`.
@@ -329,6 +364,19 @@ declare class AgoClient {
      * Get the current context snapshot.
      */
     getContextSnapshot(): ContextSnapshot | null;
+    private buildSendContext;
+    /**
+     * Record something the user just did so the agent is aware of it on the next
+     * message. `actor` defaults to `"user"`. Keep `summary` short and high-signal
+     * (no raw payloads, secrets, or PII).
+     */
+    recordActivity(entry: ActivityInput): void;
+    /** Recent user + agent actions, oldest first (a copy). */
+    getRecentActivity(): ActivityEntry[];
+    clearActivity(): void;
+    private addActivity;
+    private recordAgentAction;
+    private registerActivityContext;
     /**
      * Subscribe to an event
      */
@@ -364,6 +412,7 @@ declare class AgoClient {
      * Clean up resources
      */
     destroy(): void;
+    /* Excluded from this release type: reviveAfterDestroy */
 }
 
 /**
@@ -480,6 +529,27 @@ declare interface AgoClientEvents {
     "connection:status": {
         connected: boolean;
     };
+    /**
+     * A proactive nudge passed every governor gate and is ready to display.
+     * `useProactiveNudge` / `<AgoNudge>` consume this; custom UIs should call
+     * `client.proactive.shown(nudge)` when they render it (impression tracking
+     * + frequency caps), then `accept(nudge)` / `dismiss(nudge)`.
+     */
+    "nudge:ready": ProactiveNudgeInstance;
+    /** A nudge was displayed to the user (fires once per nudge). */
+    "nudge:shown": {
+        nudge: ProactiveNudgeInstance;
+    };
+    /** The user dismissed the nudge (its trigger is suppressed, see governor). */
+    "nudge:dismissed": {
+        nudge: ProactiveNudgeInstance;
+    };
+    /** The user accepted the nudge (its action ran / the chat is being seeded). */
+    "nudge:accepted": {
+        nudge: ProactiveNudgeInstance;
+    };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -541,6 +611,24 @@ declare interface AgoConfig {
      * with `maxResultBytes` on its definition; `Infinity` disables the guard.
      */
     maxFunctionResultBytes?: number;
+    /**
+     * Max number of recent actions kept in the in-memory activity ledger that
+     * rides along as the `activity:recent` context entry. Older entries drop
+     * first. Default `10`. Larger values give the agent more history at the cost
+     * of tokens on every message. Each entry's `data` is also size-clamped (long
+     * strings truncated, large arrays capped) so one event can't bloat the context.
+     */
+    maxActivityEntries?: number;
+    /**
+     * Enable the proactive mode: declarative triggers evaluated client-side
+     * against friction signals (dwell/idle time, rage clicks, route bounces…)
+     * that can surface a nudge before the user opens the chat. Equivalent to
+     * calling `createAgoProactive(client, proactive)` — the resulting controller
+     * is available as `client.proactive`. Requires the tenant-level kill-switch
+     * (`GET /api/sdk/v1/config` → `proactive.enabled`) to be on; disabled by
+     * default otherwise.
+     */
+    proactive?: ProactiveOptions;
 }
 
 declare type AgoEventHandler<K extends AgoEventName> = (data: AgoClientEvents[K]) => void;
@@ -995,6 +1083,43 @@ declare interface FormSchema {
     required?: string[];
 }
 
+/**
+ * HTTP client with authentication headers
+ */
+declare class HttpClient {
+    private baseUrl;
+    private headers;
+    constructor(config: AgoConfig);
+    /**
+     * Update configuration (e.g., JWT token)
+     */
+    updateConfig(config: Partial<AgoConfig>): void;
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string): Promise<T>;
+    /**
+     * Make a POST request with JSON body.
+     *
+     * `keepalive: true` lets the request survive a page unload (used by the
+     * proactive event tracker's flush-on-hide — sendBeacon can't carry the auth
+     * headers, so it's a keepalive fetch instead).
+     */
+    post<T>(path: string, body?: unknown, options?: {
+        keepalive?: boolean;
+    }): Promise<T>;
+    /**
+     * Make a POST request and return the raw Response (for streaming)
+     */
+    postStream(path: string, body?: unknown): Promise<Response>;
+    /**
+     * Make a POST request with FormData (for file uploads)
+     */
+    postFormData(path: string, formData: FormData): Promise<Response>;
+    private request;
+    private handleErrorResponse;
+}
+
 /**
  * Options for {@link loadFormCollector} / the name-only form of `useFormCollector`:
  * the `name` is required and the definition is fetched from the backend, while any
@@ -1231,6 +1356,182 @@ export declare interface MountChatWidgetOptions {
     }) => void;
 }
 
+/**
+ * Optional action attached to a nudge. Accepting a `functionName` action
+ * executes the registered client function (same `FunctionRegistry` path as
+ * agent-invoked calls); `setPageState` applies values through the registered
+ * page-state controls.
+ */
+declare type NudgeAction = {
+    label: string;
+    functionName: string;
+    arguments?: Record<string, unknown>;
+} | {
+    label: string;
+    setPageState: Record<string, unknown>;
+};
+
+/**
+ * Controller returned by {@link createAgoProactive} (also available as
+ * `client.proactive`).
+ */
+declare interface ProactiveController {
+    /** Persistently opt this browser out of proactive nudges. */
+    optOut(): void;
+    /** Undo {@link optOut}. */
+    optIn(): void;
+    isOptedOut(): boolean;
+    /**
+     * Tell the governor the user is already engaged (e.g. the chat widget is
+     * open) — nudges are suppressed while `true`. Call from the UI layer.
+     */
+    setEngaged(engaged: boolean): void;
+    /** App-pushed field error counter (field NAME only — never values). */
+    signalFieldError(fieldName: string): void;
+    /** Current aggregated friction snapshot. */
+    getSignalsSnapshot(): SignalsSnapshot;
+    /** The nudge currently occupying the single-nudge slot, if any. */
+    getActiveNudge(): ProactiveNudgeInstance | null;
+    /**
+     * Mark the nudge as displayed. Idempotent per nudge; counts it against the
+     * frequency caps, tracks the impression, and emits `nudge:shown`.
+     */
+    shown(nudge: ProactiveNudgeInstance): void;
+    /**
+     * Accept the nudge: run its action (if any), emit `nudge:accepted`, track,
+     * and — for agent nudges or nudges with a `goal` — pre-seed the chat with a
+     * hidden kickoff message so the agent starts the turn with full context.
+     */
+    accept(nudge: ProactiveNudgeInstance): Promise<void>;
+    /** Dismiss the nudge: suppress the trigger, track, emit `nudge:dismissed`. */
+    dismiss(nudge: ProactiveNudgeInstance): void;
+    /** Report a downstream conversion attributable to the nudge (analytics only). */
+    markConverted(nudge: ProactiveNudgeInstance): void;
+    /** Detach everything: listeners, timers, context provider, event flush. */
+    destroy(): void;
+}
+
+/** A concrete nudge produced by the engine, carried by every `nudge:*` event. */
+declare interface ProactiveNudgeInstance {
+    /** Client-generated uuid for this nudge instance (`client_nudge_id`). */
+    id: string;
+    triggerId: string;
+    /** `static` = configured message; `agent` = backend LLM evaluation. */
+    source: "static" | "agent";
+    message: string;
+    action?: NudgeAction;
+    goal?: string;
+    /** See {@link ProactiveTrigger.kickoff}. */
+    kickoff?: string;
+    createdAt: Date;
+    /** Server-side nudge id (agent nudges only). */
+    serverNudgeId?: string;
+}
+
+/** Options for {@link createAgoProactive} / `AgoConfig.proactive`. */
+declare interface ProactiveOptions {
+    triggers: ProactiveTrigger[];
+    /**
+     * Global caps on nudges actually shown. `perSession` is in-memory (page
+     * lifetime); `perDay` is persisted in localStorage with a date rollover —
+     * best-effort by design (private browsing resets it); the costly LLM path is
+     * additionally capped server-side.
+     */
+    frequencyCap?: {
+        perSession?: number;
+        perDay?: number;
+    };
+    /** Evaluation tick, ms. Default 1000. Zero network per tick. */
+    tickMs?: number;
+    /** Storage backend for persisted governance state. Default `localStorage`. */
+    storage?: StorageLike;
+    /** Storage key for persisted governance state. Default `"ago_proactive"`. */
+    storageKey?: string;
+    /** Tuning of the signal detectors (rage-click window, throttles…). */
+    signals?: SignalCollectorTuning;
+    /**
+     * Local demos and tests ONLY: bypass the remote kill-switch. When set, the
+     * `GET /config` fetch is skipped and the kill-switch takes this value.
+     * Leave unset in production — the tenant admin controls the feature, and
+     * the evaluate endpoint stays gated server-side regardless.
+     */
+    enabledOverride?: boolean;
+}
+
+/** A declarative proactive trigger. */
+declare interface ProactiveTrigger {
+    /** Stable id, used for cooldowns, dismissal memory, and analytics. */
+    id: string;
+    /** Conjunction of matchers (see {@link ProactiveTriggerWhen}). */
+    when: ProactiveTriggerWhen;
+    /**
+     * Min time between two firings of this trigger (persisted across reloads).
+     * A firing is the moment the trigger passes the gates — including an agent
+     * evaluation that decides NOT to intervene, so a persistent condition can't
+     * hammer the evaluate endpoint. Default 60 000.
+     */
+    cooldownMs?: number;
+    /**
+     * `'agent'` asks the backend's fast-LLM second filter whether (and how) to
+     * intervene; a `static` object shows the given message with no network call.
+     */
+    intervene: "agent" | {
+        type: "static";
+        message: string;
+        action?: NudgeAction;
+    };
+    /**
+     * What the agent should help with. Sent to the evaluate endpoint, and used to
+     * pre-seed the chat turn when the user accepts the nudge.
+     */
+    goal?: string;
+    /**
+     * User-voice line used to OPEN the conversation when the user accepts this
+     * nudge and no conversation exists yet — a hidden kickoff cannot start one
+     * (the backend rejects it). Sent as a visible user message, so write it in
+     * the app's language ("Oui, aidez-moi à choisir !"). When a conversation is
+     * already open, the SDK sends a hidden meta kickoff instead and this field
+     * is unused. Without it, accepting with no open conversation skips the chat
+     * pre-seed (the nudge action still runs).
+     */
+    kickoff?: string;
+    /**
+     * How long a dismissal of this trigger's nudge suppresses it (persisted).
+     * Default 24h.
+     */
+    resurfaceAfterMs?: number;
+}
+
+/**
+ * Conditions of a proactive trigger. Pure conjunction: EVERY specified matcher
+ * must pass against the current {@link SignalsSnapshot}. Numeric fields are
+ * `>=` thresholds.
+ */
+declare interface ProactiveTriggerWhen {
+    /**
+     * Route pattern the current pathname must match. Supports the SDK's route
+     * styles: exact (`/billing`), `:param` segments (`/users/:id`), single-segment
+     * wildcards (`/a/*` / `/b`), and a trailing `/*` that matches one or more
+     * remaining segments (`/dossier/*`).
+     */
+    route?: string;
+    /** Min time since the last user activity, ms. */
+    idleMs?: number;
+    /** Min time spent on the current route, ms. */
+    dwellMs?: number;
+    /**
+     * Partial deep match against the registered page state (funnel step,
+     * filters…). Every key present here must deep-match the live value.
+     */
+    pageState?: Partial<Record<string, unknown>>;
+    /** Min rage-click bursts on the current route. */
+    rageClicks?: number;
+    /** Min A→B→A→B route oscillations this session. */
+    routeBounces?: number;
+    /** Per-field minimum error counts (field NAME → min count). */
+    fieldErrors?: Record<string, number>;
+}
+
 /**
  * Tiny, dependency-free markdown → DOM renderer for the vanilla chat widget.
  *
@@ -1291,6 +1592,54 @@ declare interface SendMessageOptions {
     clientFunctionsMode?: ClientFunctionsMode;
 }
 
+/** Tuning knobs for the collector's detectors. All optional. */
+declare interface SignalCollectorTuning {
+    /** Min gap between heavy activity work (route checks, notifications), ms. Default 250. */
+    activityThrottleMs?: number;
+    /** Rage click: clicks needed to count a burst. Default 3. */
+    rageClickCount?: number;
+    /** Rage click: max time between first and last click of a burst, ms. Default 1000. */
+    rageClickWindowMs?: number;
+    /** Rage click: max radius between clicks of a burst, px. Default 24. */
+    rageClickRadiusPx?: number;
+    /** Max routes kept in the recent-route sequence. Default 10. */
+    maxRecentRoutes?: number;
+    /** Max typed signals kept in the ring buffer. Default 50. */
+    maxSignals?: number;
+}
+
+/**
+ * Aggregated view of the current friction state. Registered as a dynamic
+ * context provider (key `friction_signals`) so it rides along as
+ * `client_context` on every message, and sent as `signals` to the proactive
+ * evaluate endpoint.
+ */
+declare interface SignalsSnapshot {
+    /** Current pathname. */
+    route: string;
+    /** Time spent on the current route, ms. */
+    dwellMs: number;
+    /** Time since the last user activity (pointer/key/scroll/touch), ms. */
+    idleMs: number;
+    /** Rage-click bursts detected on the current route. */
+    rageClicks: number;
+    /**
+     * A→B→A→B route oscillations detected in the recent route sequence. Rolling
+     * session counter (cross-route by nature); trigger cooldowns and dismissal
+     * memory keep it from re-firing forever.
+     */
+    routeBounces: number;
+    /** App-pushed field error counters (field NAME → count), current route only. */
+    fieldErrors: Record<string, number>;
+    /** Most recent pathnames, oldest first (bounded). */
+    recentRoutes: string[];
+    /**
+     * Merged `AgoStateControl.get()` snapshot of the registered page-state
+     * controls (funnel step, filters…), or `null` when none are registered.
+     */
+    pageState: Record<string, unknown> | null;
+}
+
 /**
  * SSE stream chunk data
  */

package/dist/widget.js

@@ -1,6 +1,6 @@
-import { a as qt, i as Kt, m as Xt, o as Yt, s as Qt, t as Zt } from "./AgoClient-DXrH2AMi.js";
-import { r as Jt, t as en } from "./createFormCollector-DYh90kiG.js";
-import { t as tn } from "./createConversationSession-DPrrr70o.js";
+import { a as qt, b as Kt, i as Xt, o as Yt, s as Qt, t as Zt } from "./AgoClient-BW0YZsis.js";
+import { t as Jt } from "./createConversationSession-BjsgjL-v.js";
+import { r as en, t as tn } from "./createFormCollector-Bay2UpRv.js";
 var nn = '"IBM Plex Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif', ke = `var(--ago-font, ${nn})`, ut = {
   font: "--ago-font",
   radius: "--ago-radius",
@@ -618,10 +618,10 @@ function kn(t, o) {
     message: r,
     mode: "static"
   } : r, Ue = oe.message, Ge = oe.mode ?? "static", It = "speed" in oe && oe.speed || 45, Ve = "followUpReplies" in oe && oe.followUpReplies || void 0;
-  if (!o.client && !o.config?.baseUrl) throw new Xt("mountChatWidget requires either `client` or `config` (with a baseUrl).", "config_missing_base_url");
+  if (!o.client && !o.config?.baseUrl) throw new Kt("mountChatWidget requires either `client` or `config` (with a baseUrl).", "config_missing_base_url");
   const E = o.client ?? new Zt(o.config), je = wn(t), z = m === "left" || m === "right", At = z && (o.launcher ?? !0);
   let Z = z ? p : !0, me = !1;
-  const _t = o.mobile?.breakpoint ?? 768, Le = o.mobile?.trigger ?? "tap", qe = typeof window < "u" && !!window.matchMedia, T = qe ? window.matchMedia(`(max-width: ${_t}px)`) : void 0, Lt = qe ? window.matchMedia("(prefers-reduced-motion: reduce)") : void 0, re = !z && !!T, Ne = o.persistConversation, ge = Ne ? tn(Ne === !0 ? {} : Ne) : void 0;
+  const _t = o.mobile?.breakpoint ?? 768, Le = o.mobile?.trigger ?? "tap", qe = typeof window < "u" && !!window.matchMedia, T = qe ? window.matchMedia(`(max-width: ${_t}px)`) : void 0, Lt = qe ? window.matchMedia("(prefers-reduced-motion: reduce)") : void 0, re = !z && !!T, Ne = o.persistConversation, ge = Ne ? Jt(Ne === !0 ? {} : Ne) : void 0;
   let P = o.conversationId ?? ge?.getLastActiveThread() ?? void 0, u = [], J = !1, le = null, K;
   const Ke = [];
   function Nt(e) {
@@ -865,7 +865,7 @@ function kn(t, o) {
     });
     $e.push(s);
   };
-  for (const e of l ?? []) e.schema != null ? rt(en(e)) : Jt(E, e).then((n) => rt(n)).catch(() => {
+  for (const e of l ?? []) e.schema != null ? rt(tn(e)) : en(E, e).then((n) => rt(n)).catch(() => {
   });
   async function we(e, n) {
     const s = e.trim();
@@ -882,7 +882,7 @@ function kn(t, o) {
       content: s,
       role: "user",
       status: "DONE",
-      attachments: n && n.length > 0 ? Kt(n) : void 0,
+      attachments: n && n.length > 0 ? Xt(n) : void 0,
       createdAt: /* @__PURE__ */ new Date()
     }), u.push({
       id: `temp-assistant-${S}`,

package/llms-full.txt

@@ -1389,6 +1389,11 @@ It's fire-and-forget: the handler applies each `set()` locally and returns
 the next message. React/Vue offer `useAgoPageState(controls, opts?)` with
 lifecycle cleanup; Angular exposes `agoService.registerPageStateFunction(...)`.
 
+The SDK also tells the agent **what changed**: on each message it diffs the page
+state against the previous message and adds a `state:delta` entry listing the
+fields that changed. A navigation (a different page) resets the baseline instead
+of reporting a diff, so a page switch never shows up as a spurious change.
+
 ### Navigate then change the page in one go
 
 A request like "open the invoices page and show only the overdue ones" needs two
@@ -1617,6 +1622,29 @@ client.enableAutoPageContext();
 
 (In React, set `<AgoProvider pageContext="auto">`.)
 
+### Activity ledger
+
+Tell the agent what the user (or the agent) just did, so it can reason about
+recent actions. Call `recordActivity` for meaningful user actions; the agent's
+own client-function calls (navigation, page-state changes, custom functions) are
+recorded automatically.
+
+```ts
+client.recordActivity({
+  name: "order.shipped",
+  summary: 'User changed order #123 from "Pending" to "Shipped"',
+});
+```
+
+The recent window (last 10 by default, oldest dropped first) rides along as the
+`activity:recent` context entry. Change the size with `maxActivityEntries` in the
+config. `actor` defaults to `"user"`; keep `summary` short and high-signal (no raw
+payloads or secrets). Each entry's `data` is size-clamped before it is stored (long
+strings truncated with a `…[truncated N chars]` marker, large arrays capped), so one
+event can't bloat the context. Read or clear the log with
+`client.getRecentActivity()` / `client.clearActivity()`, observe it via
+`client.on("activity:recorded", …)`, or use the React `useAgoActivityLog()` hook.
+
 ### Per framework
 
 | Framework | Idiomatic API |
@@ -1681,6 +1709,7 @@ const final = await client.waitFor("message:complete", { timeout: 10_000 });
 | `function:invoke` | `{ invocationId, functionName, arguments, conversationId }` |
 | `function:awaiting-approval` | `{ invocationId, functionName, arguments, conversationId }`: a client function call is held pending user approval (pause mode + an `approvalPolicy`/`requiresApproval` match). The turn stays at `WAITING_CLIENT`; call `approveFunction(invocationId)` to run it and resume, or `rejectFunction(invocationId)` to decline. See [Approval gate](functions-and-context.md#approval-gate-ask-before-running) |
 | `function:result` | `{ invocationId, result, error? }` |
+| `activity:recorded` | `ActivityEntry`: a user- or agent-action was recorded into the activity ledger (via `recordActivity`, or auto-recorded when the agent calls a client function). See [Activity ledger](functions-and-context.md#activity-ledger) |
 | `form:submitted` | `{ name, values, result }`: a form collector submitted successfully; `result` is the submit response (the third-party API's answer) |
 | `form:error` | `{ name, values, error }`: a form collector submit failed at the network/server level (HTTP non-2xx or a thrown handler/fetch). Validation pre-checks (missing fields, no submit target) do not fire this |
 | `connection:status` | `{ connected }` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useago/sdk",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Create In-APP AI agents that answers question and performs actions. Works with React, Vue, Angular and vanilla JS/TS.",
   "type": "module",
   "sideEffects": false,

package/dist/AgoClient-5VGybmvz.cjs

@@ -1,8 +0,0 @@
-var d=class extends Error{constructor(t,e,n){super(t),this.code=e,this.statusCode=n,this.name="AgoError"}},g=class x extends d{constructor(e,n,i,s,o,a){super(e,n,i),this.type=s,this.param=o,this.docUrl=a,this.name="AgoApiError"}static fromResponse(e,n){const i=e.error;return new x(i.doc_url?`${i.message} See ${i.doc_url}`:i.message,i.code,n,i.type,i.param,i.doc_url)}},y=class extends d{constructor(t,e){super(t,"network_error"),this.originalError=e,this.name="AgoNetworkError"}},C=class extends d{constructor(t,e="stream_error"){super(t,e),this.name="AgoStreamError"}},E=class extends d{constructor(t,e,n){super(t,"function_error"),this.functionName=e,this.originalError=n,this.name="AgoFunctionError"}},P=class{constructor(t=!1){this.enabled=t}enable(){this.enabled=!0}disable(){this.enabled=!1}log(...t){this.enabled&&console.log("[AGO SDK]",...t)}warn(...t){this.enabled&&console.warn("[AGO SDK]",...t)}error(...t){console.error("[AGO SDK]",...t)}debug(...t){this.enabled&&console.debug("[AGO SDK]",...t)}},c=new P,S="ago_widget_id";function j(){if(typeof localStorage<"u"){const e=localStorage.getItem(S);if(e)return e}const t=typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():`ago-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,12)}`;if(typeof localStorage<"u")try{localStorage.setItem(S,t)}catch{}return t}var O=class{constructor(t){this.baseUrl=t.baseUrl.replace(/\/$/,""),this.headers={"X-User-Anon-Id":t.widgetId||j()},t.userEmail&&(this.headers["X-User-Email"]=t.userEmail),t.userJwt&&(this.headers.Authorization=`Bearer ${t.userJwt}`),t.permission&&(this.headers["X-Widget-Permission"]=t.permission)}updateConfig(t){t.baseUrl&&(this.baseUrl=t.baseUrl.replace(/\/$/,"")),t.widgetId&&(this.headers["X-User-Anon-Id"]=t.widgetId),t.userEmail&&(this.headers["X-User-Email"]=t.userEmail),t.userJwt&&(this.headers.Authorization=`Bearer ${t.userJwt}`),t.permission!==void 0&&(t.permission?this.headers["X-Widget-Permission"]=t.permission:delete this.headers["X-Widget-Permission"])}async get(t){return this.request("GET",t)}async post(t,e){return this.request("POST",t,e)}async postStream(t,e){const n=`${this.baseUrl}${t}`;c.debug("POST (stream)",n,e);try{const i=await fetch(n,{method:"POST",headers:{...this.headers,"Content-Type":"application/json"},body:e?JSON.stringify(e):void 0});return i.ok||await this.handleErrorResponse(i),i}catch(i){throw i instanceof g?i:new y(`Network error: ${i instanceof Error?i.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,i instanceof Error?i:void 0)}}async postFormData(t,e){const n=`${this.baseUrl}${t}`;c.debug("POST (formData)",n);const i={...this.headers};try{const s=await fetch(n,{method:"POST",headers:i,body:e});return s.ok||await this.handleErrorResponse(s),s}catch(s){throw s instanceof g?s:new y(`Network error: ${s instanceof Error?s.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,s instanceof Error?s:void 0)}}async request(t,e,n){const i=`${this.baseUrl}${e}`;c.debug(t,i,n);try{const s=await fetch(i,{method:t,headers:{...this.headers,"Content-Type":"application/json"},body:n?JSON.stringify(n):void 0});return s.ok||await this.handleErrorResponse(s),s.status===204?void 0:s.json()}catch(s){throw s instanceof g?s:new y(`Network error: ${s instanceof Error?s.message:"Unknown error"}. Check that \`baseUrl\` is reachable and includes the protocol (https://).`,s instanceof Error?s:void 0)}}async handleErrorResponse(t){let e;try{e=await t.json()}catch{}if(e?.error)throw g.fromResponse(e,t.status);let n="";throw t.status===401||t.status===403?n=" Check `userJwt` (and that it has not expired).":t.status===404&&(n=" Check that `baseUrl` points at your AGO API root."),new g(`HTTP ${t.status}: ${t.statusText}.${n}`,"http_error",t.status,"api_error")}},D=5e4,M=2e4,B=2e3,F=class{constructor(t){this.functions=new Map,this.defaultMaxResultBytes=t?.maxResultBytes??D}setDefaultMaxResultBytes(t){this.defaultMaxResultBytes=t}register(t,e,n){if(typeof t=="object"){const{name:r,handler:l,description:u,parameters:h,maxResultBytes:m,requiresApproval:p}=t;return this.register(r,l,{description:u,parameters:h,maxResultBytes:m,requiresApproval:p})}const i=t;if(!e||!n)throw new d(`registerFunction("${i}"): both a handler and a schema are required. Pass them as arguments or use the single-object form: registerFunction({ name, parameters, handler }).`,"function_invalid_registration");this.functions.has(i)&&c.warn(`Function "${i}" is being overwritten`);const{maxResultBytes:s,requiresApproval:o,...a}=n;this.functions.set(i,{schema:{...a,name:i},handler:e,maxResultBytes:s,requiresApproval:o}),c.log(`Registered function: ${i}`)}unregister(t){const e=this.functions.delete(t);return e&&c.log(`Unregistered function: ${t}`),e}get(t){return this.functions.get(t)}has(t){return this.functions.has(t)}getSchemas(){return Array.from(this.functions.values()).map(t=>t.schema)}async execute(t,e){const n=this.functions.get(t);if(!n)throw new E(`Function "${t}" is not registered`,t);c.log(`Executing function: ${t}`,e);try{const i=await n.handler(e);return c.log(`Function ${t} completed:`,i),this.guardResultSize(t,i,n.maxResultBytes)}catch(i){throw c.error(`Function ${t} failed:`,i),new E(`Function "${t}" execution failed: ${i instanceof Error?i.message:"Unknown error"}`,t,i instanceof Error?i:void 0)}}guardResultSize(t,e,n){let i;try{i=JSON.stringify(e)}catch{return e}if(i===void 0)return e;const s=new TextEncoder().encode(i).length,o=n??this.defaultMaxResultBytes;return s>o?(c.warn(`Function "${t}" result is ${s} bytes, over the ${o}-byte limit; a truncated preview was sent to the agent instead. Return fewer fields, paginate, or raise maxResultBytes for this function.`),{truncated:!0,originalBytes:s,maxBytes:o,preview:i.slice(0,B),hint:`The result of "${t}" exceeded the ${o}-byte limit and was truncated. Request less data (use limit or filter parameters if available), or tell the user the result is too large to process.`}):(s>M&&c.warn(`Function "${t}" returned a large result (${Math.round(s/1024)} KB). Large results consume LLM context: return fewer fields, paginate, or push the data to the UI and return a summary.`),e)}clear(){this.functions.clear(),c.log("Cleared all registered functions")}get size(){return this.functions.size}},k=class{constructor(){this.entries=new Map,this.dynamicProviders=new Map}set(t,e){this.entries.set(t,e),c.log(`ClientContext set: ${t}`)}remove(t){const e=this.entries.delete(t);return e&&c.log(`ClientContext removed: ${t}`),e}addDynamicProvider(t,e){this.dynamicProviders.set(t,e),c.log(`DynamicContext provider added: ${t}`)}removeDynamicProvider(t){const e=this.dynamicProviders.delete(t);return e&&c.log(`DynamicContext provider removed: ${t}`),e}getSnapshot(){if(this.entries.size===0&&this.dynamicProviders.size===0)return null;const t={};for(const[e,n]of this.entries)t[e]=n;for(const[e,n]of this.dynamicProviders)try{const i=n();i&&(t[e]=i)}catch(i){c.error(`DynamicContext provider "${e}" threw:`,i)}return Object.keys(t).length===0?null:{entries:t}}clear(){this.entries.clear(),this.dynamicProviders.clear(),c.log("ClientContext cleared")}};function _(t){return t===null||typeof t!="object"?JSON.stringify(t)??"null":Array.isArray(t)?`[${t.map(_).join(",")}]`:`{${Object.keys(t).sort().map(e=>`${JSON.stringify(e)}:${_(t[e])}`).join(",")}}`}var I=class{constructor(t){this.callbacks=t,this.buffer="",this.message={},this.toolCalls=[],this.sources=[],this.followUpReplies=[],this.isFirstChunk=!0,this.answerCompleteEmitted=!1,this.waitingClientEmitted=!1,this.firedClientFunctions=new Set}async processStream(t){if(!t.body)throw new C("Response has no body. The endpoint did not return a stream: check that `baseUrl` points at an AGO API and nothing (proxy, mock) strips the SSE body.","stream_no_body");const e=t.body.getReader(),n=new TextDecoder;try{for(;;){const{done:i,value:s}=await e.read();if(i)break;const o=n.decode(s,{stream:!0});this.buffer+=o,this.processBuffer()}return this.buffer.trim()&&this.processBuffer(),this.buildFinalMessage()}catch(i){const s=i instanceof Error?i:new C("Stream processing failed mid-flight. The connection may have dropped; retry the message.");throw this.callbacks.onError?.(s),s}finally{e.releaseLock()}}processBuffer(){const t=this.buffer.split(`
-
-`);this.buffer=t.pop()||"";for(const e of t){if(!e.trim())continue;const n=e.split(`
-`);for(const i of n)if(!i.startsWith(": ")&&i.startsWith("data: ")){const s=i.slice(6);try{const o=JSON.parse(s);this.handleChunk(o)}catch(o){c.warn("Failed to parse SSE data:",s,o)}}}}handleChunk(t){if(this.callbacks.onRawChunk?.(t),t.message_id&&!this.message.id&&(this.message.id=t.message_id),t.thread?.id&&(this.message.conversationId=t.thread.id,this.isFirstChunk&&this.message.id&&(this.isFirstChunk=!1,this.callbacks.onStart?.({conversationId:this.message.conversationId,messageId:this.message.id}))),t.content!==void 0&&(this.message.content=(this.message.content||"")+t.content,this.message.conversationId&&this.message.id&&this.callbacks.onChunk?.({content:t.content,conversationId:this.message.conversationId,messageId:this.message.id})),t.full_content!==void 0&&(this.message.content=t.full_content),t.status&&(this.message.status=t.status),t.agent&&(this.message.agent={id:t.agent.id,name:t.agent.name,displayName:t.agent.display_name}),t.knowledge_sources&&(this.sources=t.knowledge_sources.map(e=>{const n=e.knowledge_document;return{id:n.id,title:n.title,url:n.use_external_link?n.external_link_url:n.internal_link_url}})),t.type==="client_function"&&t.function_name){const e=`${t.function_name}::${_(t.arguments??{})}`;this.firedClientFunctions.has(e)||(this.firedClientFunctions.add(e),this.callbacks.onClientFunction?.({invocationId:t.id||"",functionName:t.function_name,arguments:t.arguments||{},conversationId:this.message.conversationId||""}))}if(t.tool_call_data&&t.type&&t.type!=="client_function"){const e=this.parseToolCall(t);this.callbacks.onToolCall?.(e);const n=this.toolCalls.findIndex(i=>i.id===e.id);n>=0?this.toolCalls[n]=e:this.toolCalls.push(e)}t.follow_up_replies&&(this.followUpReplies=t.follow_up_replies),this.message.status==="DONE"&&!this.answerCompleteEmitted&&this.message.id&&(this.answerCompleteEmitted=!0,this.callbacks.onAnswerComplete?.(this.buildMessage())),this.message.status==="WAITING_CLIENT"&&!this.waitingClientEmitted&&this.message.id&&(this.waitingClientEmitted=!0,this.callbacks.onWaitingClient?.({conversationId:this.message.conversationId||"",messageId:this.message.id,waitingToolCallIds:t.waiting_tool_call_ids??[]}))}parseToolCall(t){return{id:t.id||"",type:t.type||"status_message",status:t.status||"unknown",toolName:t.tool_name||"",toolDisplayName:t.tool_display_name,message:t.message,formSchema:t.form_schema,data:t.data,functionName:t.function_name,arguments:t.arguments}}buildMessage(){return{id:this.message.id||"",conversationId:this.message.conversationId||"",content:this.message.content||"",role:"assistant",status:this.message.status||"DONE",agent:this.message.agent,sources:this.sources.length>0?this.sources:void 0,toolCalls:this.toolCalls.length>0?this.toolCalls:void 0,followUpReplies:this.followUpReplies.length>0?this.followUpReplies:void 0,createdAt:new Date}}buildFinalMessage(){const t=this.buildMessage();return t.status!=="WAITING_CLIENT"&&this.callbacks.onComplete?.(t),t}};function L(t){const e=t.message.toLowerCase();return e.includes("load failed")||e.includes("failed to fetch")||e.includes("network")||e.includes("abort")}var G=new Set(["image/jpeg","image/png","image/gif","image/webp","image/bmp","image/tiff"]);function U(t){if(!t)return;const e=typeof window<"u"&&window.location?window.location.href:"https://ago.local/";try{const n=new URL(t,e);if(n.protocol==="http:"||n.protocol==="https:"||n.protocol==="blob:")return t}catch{}}function W(t){return t.isSafeImage===!0&&typeof t.contentType=="string"&&t.contentType.startsWith("image/")&&U(t.url)!==void 0}function q(t){if(t==null||t<0)return"";if(t<1024)return`${t} B`;const e=t/1024;return e<1024?`${e.toFixed(1)} KB`:`${(e/1024).toFixed(1)} MB`}function z(t){return{id:String(t.id??""),name:typeof t.name=="string"&&t.name?t.name:"file",contentType:typeof t.content_type=="string"?t.content_type:void 0,fileSize:typeof t.file_size=="number"?t.file_size:void 0,url:typeof t.file_url=="string"?t.file_url:void 0,isSafeImage:t.is_safe_image===!0}}function J(t){return t.map((e,n)=>({id:`local-${n}-${e.name}`,name:e.name,contentType:e.type||void 0,fileSize:e.size,url:typeof URL<"u"&&URL.createObjectURL?URL.createObjectURL(e):void 0,isSafeImage:G.has(e.type)}))}var N=class{constructor(){this.handlers=new Map}on(t,e){this.handlers.has(t)||this.handlers.set(t,new Set),this.handlers.get(t).add(e)}off(t,e){const n=this.handlers.get(t);n&&n.delete(e)}emit(t,e){const n=this.handlers.get(t);n&&n.forEach(i=>{try{i(e)}catch(s){console.error(`Error in event handler for ${String(t)}:`,s)}})}once(t,e){const n=(i=>{this.off(t,n),e(i)});this.on(t,n)}waitFor(t,e){return new Promise((n,i)=>{let s;const o=(a=>{s&&clearTimeout(s),n(a)});this.once(t,o),e?.timeout&&(s=setTimeout(()=>{this.off(t,o),i(new Error(`waitFor("${String(t)}") timed out after ${e.timeout}ms`))},e.timeout))})}removeAllListeners(t){t?this.handlers.delete(t):this.handlers.clear()}},A='`baseUrl` is required, e.g. new AgoClient({ baseUrl: "https://YOUR-DOMAIN.api.useago.com" }). Try the live demo endpoint https://playground.api.useago.com. See docs/general/configuration.md#error-codes (config_missing_base_url).',H=/^[a-z][a-z0-9+.-]*:\/\//i,$=!1;function R(t,e="AgoClient"){if(typeof t!="object"||t===null)throw new d(`${e}: ${A}`,"config_missing_base_url");const n=t.baseUrl;if(typeof n!="string"||n.trim()==="")throw new d(`${e}: ${A}`,"config_missing_base_url");!n.startsWith("/")&&!H.test(n)&&($||($=!0,console.warn(`[AGO] ${e}: \`baseUrl\` has no protocol and is not a relative path (config_suspect_base_url). Requests will fail: Node throws a URL parse error, browsers fetch it as a relative path. Use "https://..." (or a "/path" for a same-origin proxy).`)))}function K(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function b(t){return t.split("/").filter(e=>e.startsWith(":")).map(e=>e.slice(1))}function X(t,e){const n=[];return{path:t.split("/").map(i=>{if(!i.startsWith(":"))return i;const s=i.slice(1),o=e[s];return o==null||o===""?(n.push(s),i):encodeURIComponent(String(o))}).join("/"),missing:n}}function Y(t,e){const n=e.find(s=>s.path===t);if(n)return n;const i=e.find(s=>{if(!s.path.includes(":"))return!1;const o="^"+s.path.split("/").map(a=>a.startsWith(":")?"[^/]+":K(a)).join("/")+"/?$";return new RegExp(o).test(t)});return i||e.filter(s=>s.path!=="/"&&t.startsWith(s.path)).sort((s,o)=>o.path.length-s.path.length)[0]}var V=class T{constructor(e){this.warnedEmptyConversations=new Set,this.pendingResumes=new Map,this.pendingApprovals=new Map,this.resumeGate=null,R(e,"AgoClient"),this.config=e,this.httpClient=new O(e),this.functionRegistry=new F({maxResultBytes:e.maxFunctionResultBytes}),this.contextRegistry=new k,this.eventEmitter=new N,e.debug&&c.enable(),c.log("AgoClient initialized")}async sendMessage(e,n){const i=this.functionRegistry.getSchemas(),s=this.contextRegistry.getSnapshot(),o=this.config.agent||this.config.defaultAgentId,a=this.resolveClientFunctionsMode(n),r={content:e,conversation_id:n?.conversationId,agent_id:n?.agentId||o};i.length>0&&(r.client_functions=i,a==="pause"&&(r.client_functions_mode=a)),s&&(r.client_context=s),n?.hidden&&(r.hidden=!0);let l;if(n?.files&&n.files.length>0){const u=new FormData;u.append("content",e),n.conversationId&&u.append("conversation_id",n.conversationId),(n.agentId||o)&&u.append("agent_id",n.agentId||o||""),i.length>0&&(u.append("client_functions",JSON.stringify(i)),a==="pause"&&u.append("client_functions_mode",a)),s&&u.append("client_context",JSON.stringify(s)),n.hidden&&u.append("hidden","true");for(const h of n.files)u.append("files",h);l=await this.httpClient.postFormData("/api/sdk/v1/messages",u)}else l=await this.httpClient.postStream("/api/sdk/v1/messages",r);return this.processSSEResponse(l)}async processSSEResponse(e){let n=!1;const i=await new I({onRawChunk:s=>{this.eventEmitter.emit("stream:message",s)},onStart:s=>{this.eventEmitter.emit("message:start",s)},onChunk:s=>{this.eventEmitter.emit("message:chunk",s)},onToolCall:s=>{this.eventEmitter.emit("toolCall:received",s),s.type==="form"&&this.eventEmitter.emit("toolCall:form",s)},onClientFunction:async s=>{if(n=!0,this.eventEmitter.emit("function:invoke",s),s.invocationId&&this.requiresApproval(s)){this.pendingApprovals.set(s.invocationId,s),this.eventEmitter.emit("function:awaiting-approval",s);return}await this.handleClientFunctionInvocation(s)},onAnswerComplete:s=>{this.eventEmitter.emit("message:answer-complete",s)},onWaitingClient:s=>{this.eventEmitter.emit("message:waiting-client",s),this.markResumeSignal(s.messageId,s.conversationId,"waitingConfirmed")},onComplete:s=>{this.eventEmitter.emit("message:complete",s)},onError:s=>{this.eventEmitter.emit("message:error",{error:s.message,code:s instanceof d?s.code:void 0})}}).processStream(e);return i.status!=="WAITING_CLIENT"&&this.maybeFlagEmptyReply(i,n),i}resolveClientFunctionsMode(e){return e?.clientFunctionsMode??this.config.clientFunctionsMode??"pause"}registerResumeGate(e){return this.resumeGate=e,()=>{this.resumeGate===e&&(this.resumeGate=null)}}async continueMessage(e){const n=this.functionRegistry.getSchemas(),i=this.contextRegistry.getSnapshot(),s={};n.length>0&&(s.client_functions=n),i&&(s.client_context=i);const o=await this.httpClient.postStream(`/api/sdk/v1/messages/${e}/continue`,s);return this.processSSEResponse(o)}markResumeSignal(e,n,i){if(!e)return;const s=this.pendingResumes.get(e)??{conversationId:n,waitingConfirmed:!1,resultsReady:!1,started:!1};s[i]=!0,n&&(s.conversationId=n),this.pendingResumes.set(e,s),!(!s.waitingConfirmed||!s.resultsReady||s.started)&&(s.started=!0,this.runAutoResume(e,s.conversationId))}async runAutoResume(e,n){try{this.resumeGate&&await this.resumeGate({conversationId:n,messageId:e})}catch(i){c.warn("Resume gate threw; resuming anyway:",i)}this.pendingResumes.delete(e);try{await this.continueMessage(e)}catch(i){c.warn("Auto-resume of paused turn failed:",i)}}maybeFlagEmptyReply(e,n){e.status==="DONE"&&(e.content??"").trim()===""&&!n&&!(e.toolCalls&&e.toolCalls.length>0)&&!(e.followUpReplies&&e.followUpReplies.length>0)&&setTimeout(()=>{if(this.eventEmitter.emit("message:empty",{conversationId:e.conversationId??"",messageId:e.id??""}),this.config.warnOnEmptyReply===!1)return;const i=e.conversationId||"(no conversation)";if(this.warnedEmptyConversations.has(i))return;this.warnedEmptyConversations.add(i);const s=this.config.agent||this.config.defaultAgentId;e.id?console.warn("[AGO] Reply completed with empty content. Possible causes: "+(s?`the agent "${s}" may not exist for this tenant, `:"an unknown `agent` slug, ")+"or the agent replied with no text. Listen for the `message:empty` event to handle this in your app; silence this warning with `warnOnEmptyReply: false`."):console.warn("[AGO] The stream completed without any message data. Possible causes: "+(s?`the agent "${s}" may not exist for this tenant, or `:"")+"`baseUrl` does not point at an AGO endpoint that returns server-sent events. Listen for the `message:empty` event to handle this in your app; silence this warning with `warnOnEmptyReply: false`.")},0)}async handleClientFunctionInvocation(e){let n,i;try{n=await this.functionRegistry.execute(e.functionName,e.arguments)}catch(s){i=s instanceof Error?s.message:"Unknown error",c.error("Client function execution failed:",s)}if(e.invocationId)try{const s=await this.submitToolCallForm(e.invocationId,{result:n,error:i,_type:"client_function_result"});s?.resume?.ready&&this.markResumeSignal(s.resume.message_id,e.conversationId,"resultsReady")}catch(s){c.error("Failed to submit function result:",s)}this.eventEmitter.emit("function:result",{invocationId:e.invocationId,result:n,error:i})}requiresApproval(e){const n=this.config.approvalPolicy;if(n)try{if(n(e))return!0}catch(i){c.warn("approvalPolicy threw; not gating this call:",i)}return this.functionRegistry.get(e.functionName)?.requiresApproval===!0}async approveFunction(e){const n=this.pendingApprovals.get(e);n&&(this.pendingApprovals.delete(e),await this.handleClientFunctionInvocation(n))}async rejectFunction(e){const n=this.pendingApprovals.get(e);if(!n)return;this.pendingApprovals.delete(e);const i={approved:!1,reason:"user_rejected"};try{const s=await this.submitToolCallForm(e,{result:i,_type:"client_function_result"});s?.resume?.ready&&this.markResumeSignal(s.resume.message_id,n.conversationId,"resultsReady")}catch(s){c.error("Failed to submit function rejection:",s)}this.eventEmitter.emit("function:result",{invocationId:e,result:i})}async getConversations(){return(await this.httpClient.get("/api/sdk/v1/conversations")).items.map(e=>({id:e.id,title:e.title,lastMessageDate:new Date(e.last_message_date)}))}async getConversation(e){const n=await this.httpClient.get(`/api/sdk/v1/conversations/${e}`),i={id:n.id,title:n.title,lastMessageDate:new Date(n.last_message_date),messages:n.messages.map(s=>({id:s.id,conversationId:n.id,content:s.content,role:s.role,status:s.status,createdAt:new Date(s.created_at),hidden:s.hidden,toolCalls:T.mapPersistedToolCalls(s.tool_call_data),attachments:s.attachments&&s.attachments.length>0?s.attachments.map(z):void 0}))};return this.eventEmitter.emit("conversation:loaded",i),i}static mapPersistedToolCalls(e){if(!(!e||e.length===0))return e.map(n=>({id:String(n.id??""),type:n.type??"status_message",status:String(n.status??"unknown"),toolName:n.tool_name??"",toolDisplayName:n.tool_display_name,message:n.message,formSchema:n.form_schema,data:n.data,functionName:n.function_name,arguments:n.arguments}))}async getMessages(e){return(await this.getConversation(e)).messages||[]}async resumePendingClientFunctions(e){const n=[...e.messages??[]].reverse().find(r=>r.role==="assistant"&&r.status==="WAITING_CLIENT");if(!n)return null;const i=(n.toolCalls??[]).filter(r=>r.type==="client_function"&&r.status==="waiting_input"&&r.functionName),s=new Set(this.functionRegistry.getSchemas().map(r=>r.name)),o=i.filter(r=>!s.has(r.functionName));if(o.length>0)return c.warn("Cannot resume paused turn: function(s) not registered on this page:",o.map(r=>r.functionName)),null;let a=i.length===0;for(const r of i){const l={invocationId:r.id,functionName:r.functionName,arguments:r.arguments??{},conversationId:e.id};if(this.requiresApproval(l)){this.pendingApprovals.set(r.id,l),this.markResumeSignal(n.id,e.id,"waitingConfirmed"),this.eventEmitter.emit("function:awaiting-approval",l),a=!1;continue}let u,h;try{u=await this.functionRegistry.execute(r.functionName,r.arguments??{})}catch(m){h=m instanceof Error?m.message:"Unknown error",c.error("Client function execution failed:",m)}a=(await this.submitToolCallForm(r.id,{result:u,error:h,_type:"client_function_result"}))?.resume?.ready??a}return a?this.continueMessage(n.id):null}async submitToolCallForm(e,n){return this.httpClient.post(`/api/sdk/v1/tool-calls/${e}/submit`,{formData:n})}async confirmToolCall(e){await this.httpClient.post(`/api/tool-calls/${e}/confirm/`)}async rejectToolCall(e){await this.httpClient.post(`/api/tool-calls/${e}/reject/`)}async getFormCollector(e){const n=await this.httpClient.get(`/api/sdk/v1/forms/${encodeURIComponent(e)}`);return{name:n.name,description:n.description,schema:n.schema,submit:n.submit??void 0}}async submitFormCollector(e,n){return this.httpClient.post("/api/sdk/v1/forms/submit",{name:e,values:n})}async submitFeedback(e,n){await this.httpClient.post(`/api/sdk/v1/messages/${e}/feedback`,{rating:n})}registerFunction(e,n,i){typeof e=="object"?this.functionRegistry.register(e):this.functionRegistry.register(e,n,i)}register(e){if(Array.isArray(e))for(const n of e)this.functionRegistry.register(n);else this.functionRegistry.register(e)}unregisterFunction(e){return this.functionRegistry.unregister(e)}getRegisteredFunctions(){return this.functionRegistry.getSchemas()}registerNavigationFunction(e,n){const i=n.map(r=>r.name),s=n.map(r=>{const l=b(r.path),u=l.length>0?` (requires ${l.map(h=>`"${h}"`).join(", ")})`:"";return`- "${r.name}"${u}: ${r.description}`}).join(`
-`),o=new Map;for(const r of n)for(const l of b(r.path))o.set(l,[...o.get(l)??[],r.name]);const a={page:{type:"string",description:"The page to navigate to",enum:i}};for(const[r,l]of o){if(r==="page"){c.error('registerNavigationFunction: a ":page" placeholder collides with the "page" argument and is ignored. Rename the placeholder.');continue}a[r]={type:"string",description:`Value for ":${r}" in the page path. Required when page is ${l.map(u=>`"${u}"`).join(" or ")}.`}}this.registerFunction("navigateToPage",async r=>{const l=r.page,u=n.find(f=>f.name===l);if(!u)return{success:!1,error:`Unknown page: ${l}`};let h={};if(typeof r.params=="string")try{h=JSON.parse(r.params)}catch{}else r.params&&typeof r.params=="object"&&(h=r.params);const m={};for(const f of b(u.path))m[f]=r[f]??h[f];const{path:p,missing:w}=X(u.path,m);if(w.length>0){const f=w.map(v=>`"${v}": "..."`).join(", ");return{success:!1,error:`Page "${l}" needs ${w.map(v=>`"${v}"`).join(", ")}. Retry with { "page": "${l}", ${f} }.`}}return e(p),{success:!0,navigatedTo:p}},{description:`Navigate the user to a page in the application. Available pages:
-${s}`,parameters:{type:"object",properties:a,required:["page"]}}),this.addDynamicContext("current-page",()=>{if(typeof window>"u"||!window.location)return null;const r=window.location.href,l=typeof document<"u"?document.title:void 0,u=Y(window.location.pathname,n),h={url:r};return u&&(h.page=u.name),l&&(h.title=l),{name:"Current page",description:"The page the user is currently viewing.",data:h}})}unregisterNavigationFunction(){this.unregisterFunction("navigateToPage"),this.removeDynamicContext("current-page")}registerPageStateFunction(e,n){const i=n?.functionName??"setPageState",s=new Map(e.map(a=>[a.name,a])),o=e.map(a=>`- "${a.name}": ${a.description}`).join(`
-`);this.registerFunction(i,async a=>{const r={};for(const[l,u]of Object.entries(a)){if(u===void 0)continue;const h=s.get(l);h&&(await h.set(u),r[l]=u)}return{success:!0,applied:r}},{description:`Change the state of the current page. Set ONLY the controls the user explicitly asked for; leave the others unset. Available controls:
-${o}`,parameters:{type:"object",properties:Object.fromEntries(e.map(a=>[a.name,{...a.schema,description:a.description}]))},requiresApproval:n?.requiresApproval}),this.addDynamicContext(`page-state:${i}`,()=>{const a=e.filter(l=>typeof l.get=="function");if(a.length===0)return null;const r={};for(const l of a)r[l.name]=l.get();return{name:"Page state",description:"Current, editable state of the page the user is viewing.",data:r}})}unregisterPageStateFunction(e){const n=e??"setPageState";this.unregisterFunction(n),this.removeDynamicContext(`page-state:${n}`)}setContext(e,n){this.contextRegistry.set(e,n),this.notifyContextChanged()}removeContext(e){const n=this.contextRegistry.remove(e);return n&&this.notifyContextChanged(),n}addDynamicContext(e,n){this.contextRegistry.addDynamicProvider(e,n),this.notifyContextChanged()}removeDynamicContext(e){const n=this.contextRegistry.removeDynamicProvider(e);return n&&this.notifyContextChanged(),n}notifyContextChanged(){this.eventEmitter.emit("context:changed",this.contextRegistry.getSnapshot())}emitFormEvent(e,n){this.eventEmitter.emit(e,n)}enableAutoPageContext(){this.addDynamicContext("browser-page",()=>{const e=typeof window<"u"?window.location.href:void 0,n=typeof document<"u"?document.title:void 0;return!e&&!n?null:{name:"Browser page",description:"Current page the user is viewing",data:{url:e,title:n}}})}getContextSnapshot(){return this.contextRegistry.getSnapshot()}on(e,n){this.eventEmitter.on(e,n)}off(e,n){this.eventEmitter.off(e,n)}once(e,n){this.eventEmitter.once(e,n)}waitFor(e,n){return this.eventEmitter.waitFor(e,n)}updateConfig(e){const n={};for(const[s,o]of Object.entries(e))o!==void 0&&(n[s]=o);const i={...this.config,...n};R(i,"AgoClient.updateConfig"),this.config=i,this.httpClient.updateConfig(n),n.debug!==void 0&&(n.debug?c.enable():c.disable()),n.maxFunctionResultBytes!==void 0&&this.functionRegistry.setDefaultMaxResultBytes(n.maxFunctionResultBytes)}destroy(){this.eventEmitter.removeAllListeners(),this.functionRegistry.clear(),this.contextRegistry.clear(),this.pendingResumes.clear(),this.pendingApprovals.clear(),this.resumeGate=null,c.log("AgoClient destroyed")}};Object.defineProperty(exports,"AgoApiError",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"AgoClient",{enumerable:!0,get:function(){return V}});Object.defineProperty(exports,"AgoError",{enumerable:!0,get:function(){return d}});Object.defineProperty(exports,"AgoFunctionError",{enumerable:!0,get:function(){return E}});Object.defineProperty(exports,"AgoNetworkError",{enumerable:!0,get:function(){return y}});Object.defineProperty(exports,"AgoStreamError",{enumerable:!0,get:function(){return C}});Object.defineProperty(exports,"ClientContextRegistry",{enumerable:!0,get:function(){return k}});Object.defineProperty(exports,"EventEmitter",{enumerable:!0,get:function(){return N}});Object.defineProperty(exports,"FunctionRegistry",{enumerable:!0,get:function(){return F}});Object.defineProperty(exports,"SSEHandler",{enumerable:!0,get:function(){return I}});Object.defineProperty(exports,"attachmentsFromFiles",{enumerable:!0,get:function(){return J}});Object.defineProperty(exports,"canInlineImage",{enumerable:!0,get:function(){return W}});Object.defineProperty(exports,"formatFileSize",{enumerable:!0,get:function(){return q}});Object.defineProperty(exports,"isStreamNetworkError",{enumerable:!0,get:function(){return L}});Object.defineProperty(exports,"logger",{enumerable:!0,get:function(){return c}});Object.defineProperty(exports,"safeAttachmentUrl",{enumerable:!0,get:function(){return U}});Object.defineProperty(exports,"validateConfig",{enumerable:!0,get:function(){return R}});