@useago/sdk 1.9.0 → 1.12.0

package/llms-full.txt

@@ -386,7 +386,10 @@ widget.destroy(); // removes listeners, uninstalls forms, clears the DOM
 While the agent answers, the send button becomes a Stop button that interrupts
 the turn; pass `allowStop: false` to keep a disabled spinner instead.
 Set `placement: "left"` or `"right"` for a fixed full-height side panel with a
-launcher button. Set `persistConversation: true` to resume the visitor's last
+launcher button, or `placement: "bubble"` for the hosted widget's floating
+bubble (home / chat / history screens); with `loadHomeConfig: true` the bubble's
+home title, subtitle and starter cards come from the AGO dashboard.
+Set `persistConversation: true` to resume the visitor's last
 thread across reloads. Set `feedback: true` to put thumbs under each answer,
 with a "what went wrong?" panel on a thumbs-down. Theme it with the `theme` option or `--ago-*` CSS variables
 on `.ago-chat-widget`. Message text renders as GitHub-flavored markdown and is
@@ -1319,7 +1322,8 @@ reference, and the framework guides show the idiomatic wrappers.
 
 - [Client-side functions](#client-side-functions): the agent runs code in the browser
 - [Pre-built helpers](#pre-built-helpers): a catalogue of ready-made functions
-- [Client context](#client-context): tell the agent what the user is doing
+- [Client context](#client-context): tell the agent what the user is doing,
+  including the [JavaScript errors](#javascript-errors) the page hit
 
 ---
 
@@ -1918,11 +1922,94 @@ 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.
 
+### JavaScript errors
+
+"The button does nothing" is much easier to answer when the agent can see the
+exception behind it. Turn the error watcher on and the page's recent JavaScript
+errors ride along with every message:
+
+```ts
+const client = new AgoClient({
+  baseUrl: "https://playground.api.useago.com",
+  agent: "generic-guide",
+  errorWatcher: true,
+});
+```
+
+(`<AgoProvider errorWatcher>`, the Vue plugin and `provideAgo` take the same
+option, and so does `mountChatWidget({ config: { errorWatcher: true } })`.)
+
+With it on, the SDK captures:
+
+- uncaught exceptions (the `window` `error` event), with file, line and stack;
+- unhandled promise rejections;
+- every `console.error` call (see the note below);
+- errors your app caught itself and hands over with `client.reportError()`.
+
+They go out as the `errors:recent` context entry: at most 10 distinct errors,
+deduplicated with a `count`, each with how long ago it last fired, pruned after
+10 minutes. Messages are cut at 500 characters and stacks at 2000, so one crash
+cannot flood the context. The entry is absent when nothing happened.
+
+Report the errors you already catch, so the agent sees them too:
+
+```tsx
+// React error boundary
+componentDidCatch(error, info) {
+  this.props.client.reportError(error, { componentStack: info.componentStack });
+}
+
+// Vue
+app.config.errorHandler = (err, _instance, info) => client.reportError(err, { info });
+
+// Angular
+@Injectable() class AgoErrorHandler implements ErrorHandler {
+  constructor(private ago: AgoService) {}
+  handleError(error: unknown) { this.ago.getClient().reportError(error); }
+}
+```
+
+Tune the caps or redact what leaves the page with options instead of `true`:
+
+```ts
+new AgoClient({
+  baseUrl: "https://playground.api.useago.com",
+  errorWatcher: {
+    maxErrors: 5,          // distinct errors kept (default 10)
+    maxAgeMs: 120_000,     // forget errors older than 2 min (default 10 min)
+    maxStackChars: 1000,   // default 2000
+    // Return null to drop an error, or an edited copy to redact it.
+    filter: (e) => (e.message.includes("token") ? null : e),
+  },
+});
+```
+
+Things to know:
+
+- **It is off by default.** Error messages can contain emails, ids or internal
+  URLs. Enabling it is your call; use `filter` if some of them must stay home.
+- **`console.error` is wrapped.** The SDK never touches globals otherwise, but
+  most caught errors (React render errors included) only surface there. The
+  wrapper calls the original every time and is restored on `destroy()`.
+- **Cross-origin scripts** without a `crossorigin` attribute only yield
+  `Script error.` with no details. That is the browser, not the SDK.
+- Errors also count as friction for the proactive mode: a trigger can use
+  `when: { jsErrors: 1 }` to nudge right after a crash.
+
+Observe or inspect it with `client.on("error:captured", …)`,
+`client.getRecentErrors()`, `client.clearErrors()`, or toggle it at runtime
+with `client.updateConfig({ errorWatcher: false })`.
+
+To see it work, `examples/simple-html/error-watcher.html` is an order page
+with three planted bugs (a `TypeError`, an unhandled rejection, a swallowed
+error logged with `console.error`) and the bubble widget wired to the same
+client. Build the SDK, serve the repo, click a button, ask the agent what broke.
+
 ### Per framework
 
 | Framework | Idiomatic API |
 | --- | --- |
-| Core | `setContext` / `addDynamicContext` / `enableAutoPageContext` |
+| Core | `setContext` / `addDynamicContext` / `enableAutoPageContext` / `errorWatcher` |
 | React | `useAgoContext(entryOrFn, key?)` + `pageContext="auto"` |
 | Vue | core API inside `onMounted` / `onUnmounted` |
 | Angular | `agoService.getClient().setContext(…)` |
@@ -1984,6 +2071,7 @@ const final = await client.waitFor("message:complete", { timeout: 10_000 });
 | `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) |
+| `error:captured` | `CapturedError`: the error watcher captured a JavaScript error (uncaught exception, unhandled rejection, `console.error`, or `reportError`). Fires on repeats too, with the updated `count`. Needs `errorWatcher` in the config. See [JavaScript errors](functions-and-context.md#javascript-errors) |
 | `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 }` |
@@ -2103,6 +2191,14 @@ client.on("toolCall:received", async (toolCall) => {
 `ToolCallType` is one of: `form`, `confirmation_input`, `status_message`,
 `progress_indicator`, `client_function`, `reasoning`, `mcp_ui_resource`.
 
+A `form` tool call from the agent's `ago_ticketing` tool is the ticket form:
+`toolName` is `"ago_ticketing"`, `formSchema` is empty, and the fields come from
+`getConfig().permissions[0].ticketForm` instead. The call carries the agent's
+pre-filled `ticket`, `allowedToCreateTicket`, and for embed-mode forms
+`embedHtml`. The vanilla widget renders and submits it for you (see
+[Ticket form](widget.md#ticket-form-the-form-tool-call)); a custom UI creates
+the ticket with `createTicket()` and then calls `submitToolCallForm(id, { success: true, ticket_id, ticket_url })`.
+
 ---
 
 ## Framework equivalents
@@ -2141,10 +2237,12 @@ interface AgoConfig {
   permission?: string;      // X-Widget-Permission header
   userEmail?: string;       // X-User-Email header, identify the end user
   userJwt?: string;         // Authorization: Bearer <jwt>, authenticated users
+  metadata?: Record<string, unknown> | null; // Message body, for user/ticket enrichment
   debug?: boolean;          // enable verbose console logging
   warnOnEmptyReply?: boolean; // default true; see "Empty replies" below
   clientFunctionsMode?: "placeholder" | "pause"; // default "pause"
   maxFunctionResultBytes?: number; // default 50000; cap on client function results
+  errorWatcher?: boolean | ErrorWatcherOptions; // default off; send recent JS errors as context
 }
 ```
 
@@ -2156,10 +2254,12 @@ interface AgoConfig {
 | `permission` | — | `X-Widget-Permission` | Mirrors the widget's `window.AGO.permission`. |
 | `userEmail` | — | `X-User-Email` | Identifies the user to AGO. |
 | `userJwt` | — | `Authorization: Bearer …` | For authenticated sessions. |
+| `metadata` | — | `metadata` in the body | JSON-serializable user/ticket context. Per-message overrides replace defaults; `null` omits the field. |
 | `debug` | — | — | Turns on the SDK's logger. |
 | `warnOnEmptyReply` | — | — | Default `true`: warn on the console (once per conversation) when a reply completes empty, usually an unknown `agent` slug. The [`message:empty` event](events-and-streaming.md#events) fires regardless. |
 | `clientFunctionsMode` | — | `client_functions_mode` in the body | Default `"pause"`: the agent stops on client function call(s) and resumes the SAME turn once the results are submitted (the SDK submits and resumes automatically; see the [`message:waiting-client` event](events-and-streaming.md#events)). Needs a backend with pause/resume support; older backends ignore the flag and fall back to placeholder behavior. Legacy `"placeholder"`: the turn continues on a placeholder and results are only visible on later turns. Per-message override via `sendMessage(..., { clientFunctionsMode })`. |
 | `maxFunctionResultBytes` | — | — | Default `50000`. Client function results larger than this (serialized) are replaced with a truncated preview before reaching the LLM. Override per function with `maxResultBytes`; see [result size limit](functions-and-context.md#result-size-limit). |
+| `errorWatcher` | — | `errors:recent` in `client_context` | Off by default. `true` (or options) captures the page's JavaScript errors (uncaught exceptions, unhandled rejections, `console.error`, `reportError`) and sends the recent ones with every message. See [JavaScript errors](functions-and-context.md#javascript-errors). |
 
 ---
 
@@ -2221,7 +2321,7 @@ provideAgo({ baseUrl: "https://acme.useago.com", agent: "support" });
 order:
 
 1. **`window.AGO`** (the widget config object): `basepath`, `widgetId`,
-   `agent`/`defaultAgent`, `permission`, `email`, `jwt`.
+   `agent`/`defaultAgent`, `permission`, `email`, `jwt`, `metadata`.
 2. **`<meta>` tags**: `ago-base-url`, `ago-widget-id`, `ago-agent`
    (or `ago-agent-id`), `ago-permission`, `ago-user-email`.
 3. **`data-ago-*` attributes** on `<body>` or a `<script>` tag:
@@ -2255,13 +2355,32 @@ client.updateConfig({ userJwt: token, userEmail: "jane@acme.com" });
 
 Changing `permission` to a falsy value removes the header. In React, the
 `useAgo` hook re-applies `agent`, `permission`, `userEmail`, `userJwt`,
-`debug` and `warnOnEmptyReply` automatically when those props change (changing
-`baseUrl`/`widgetId` recreates the client).
+`metadata`, `debug` and `warnOnEmptyReply` automatically when those props
+change (changing `baseUrl`/`widgetId` recreates the client).
 
 `updateConfig` validates the merged result: omitting a key (or passing it as
 `undefined`) keeps the current value; an explicit empty or non-string `baseUrl`
 throws `config_missing_base_url` and leaves the client unchanged.
 
+### User and ticket metadata
+
+Pass JSON-serializable data in `config.metadata` to include it in every new
+message request (JSON and multipart uploads). `sendMessage(text, { metadata })`
+replaces those defaults for that message; it does not merge objects. `null`
+omits metadata. `updateConfig({ metadata: null })` stops sending defaults; it
+does not erase data already stored by the server.
+
+```ts
+client.updateConfig({ metadata: { brevo: { clientid: 11970100, planCategory: "Free" } } });
+await client.sendMessage("I need help");
+```
+
+The AGO API stores this data as widget metadata on the user. Configure metadata
+field mappings in AGO to include selected fields in tickets. This does not
+populate a separately hosted Zendesk form. Use `setContext` as well when the
+agent needs these values in its prompt. Metadata supplied by the browser is
+untrusted context, not an authentication credential or permission grant.
+
 ---
 
 ## Errors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useago/sdk",
-  "version": "1.9.0",
+  "version": "1.12.0",
   "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/createMockClient-BZbOe-23.cjs

@@ -1 +0,0 @@
-function y(u={}){const{overrides:g={}}=u,a={id:"mock-msg-1",conversationId:"mock-conv-1",content:"Mock response",role:"assistant",status:"DONE",createdAt:new Date},l={id:"mock-conv-1",title:"Mock Conversation",lastMessageDate:new Date},n=new Map,c=[],m={sendMessage:async()=>a,continueMessage:async()=>a,stop:async()=>null,stopMessage:async()=>({status:"not_running"}),isGenerating:()=>!1,resumePendingClientFunctions:async()=>null,registerResumeGate:()=>()=>{},getConversations:async()=>[l],getConversation:async()=>l,getMessages:async()=>[a],submitToolCallForm:async()=>({status:"completed"}),confirmToolCall:async()=>{},rejectToolCall:async()=>{},submitFeedback:async()=>{},submitConversationFeedback:async()=>a.id,registerFunction:()=>{},unregisterFunction:()=>!0,getRegisteredFunctions:()=>[],executeClientFunction:async()=>{},getContextSnapshot:()=>null,notifyContextChanged:()=>{},setContext:()=>{},removeContext:()=>!0,addDynamicContext:()=>{},removeDynamicContext:()=>!0,registerNavigationFunction:()=>{},unregisterNavigationFunction:()=>{},getConfiguredAgent:()=>{},getHttp:()=>({get:async()=>({}),post:async()=>({})}),emitProactiveEvent:(e,t)=>{const o=n.get(e);o&&[...o].forEach(s=>s(t))},on:(e,t)=>{n.has(e)||n.set(e,new Set),n.get(e).add(t)},off:(e,t)=>{n.get(e)?.delete(t)},once:(e,t)=>{const o=(...s)=>{n.get(e)?.delete(o),t(...s)};n.has(e)||n.set(e,new Set),n.get(e).add(o)},waitFor:(e,t)=>new Promise((o,s)=>{let r;const d=f=>{r&&clearTimeout(r),n.get(e)?.delete(d),o(f)};n.has(e)||n.set(e,new Set),n.get(e).add(d),t?.timeout&&(r=setTimeout(()=>{n.get(e)?.delete(d),s(new Error(`waitFor("${e}") timed out after ${t.timeout}ms`))},t.timeout))}),updateConfig:()=>{},destroy:()=>{n.clear()},...g},i={};for(const[e,t]of Object.entries(m))i[e]=(...o)=>(c.push({method:e,args:o}),t(...o));return i.proactive=null,i.__calls=c,i.__callsFor=e=>c.filter(t=>t.method===e),i.__emitEvent=(e,t)=>{const o=n.get(e);o&&[...o].forEach(s=>s(t))},i}Object.defineProperty(exports,"createMockClient",{enumerable:!0,get:function(){return y}});

package/dist/sheetController-CBUVOroo.js

@@ -1,205 +0,0 @@
-var u = /* @__PURE__ */ new WeakMap(), A = [
-  "position",
-  "top",
-  "left",
-  "right",
-  "width"
-];
-function x(e, t) {
-  return t.map((a) => ({
-    style: e,
-    prop: a,
-    value: e.getPropertyValue(a),
-    priority: e.getPropertyPriority(a)
-  }));
-}
-function T(e) {
-  for (const { style: t, prop: a, value: r, priority: n } of e) r ? t.setProperty(a, r, n) : t.removeProperty(a);
-}
-function N(e, t = document) {
-  const a = u.get(t);
-  if (a) {
-    a.owners.add(e);
-    return;
-  }
-  const r = t.body, n = t.documentElement, s = t.defaultView?.scrollY ?? 0;
-  u.set(t, {
-    owners: /* @__PURE__ */ new Set([e]),
-    saved: [...x(r.style, A), ...x(n.style, ["overflow"])],
-    scrollY: s
-  }), r.style.position = "fixed", r.style.top = `-${s}px`, r.style.left = "0", r.style.right = "0", r.style.width = "100%", n.style.overflow = "hidden";
-}
-function P(e, t = document) {
-  const a = u.get(t);
-  !a || !a.owners.delete(e) || a.owners.size > 0 || (u.delete(t), T(a.saved), t.defaultView?.scrollTo(0, a.scrollY));
-}
-var w = '"IBM Plex Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif', I = `var(--ago-font, ${w})`, S = {
-  font: "--ago-font",
-  radius: "--ago-radius",
-  messageRadius: "--ago-message-radius",
-  brand: "--ago-brand-color",
-  brandText: "--ago-brand-text-color",
-  headerBg: "--ago-header-background",
-  headerText: "--ago-header-text-color",
-  panelBg: "--ago-panel-background",
-  messagesBg: "--ago-messages-background",
-  text: "--ago-text-color",
-  mutedText: "--ago-muted-text-color",
-  border: "--ago-border-color",
-  accent: "--ago-accent-color",
-  agentBubbleBg: "--ago-agent-bubble-background"
-}, U = "var(--ago-brand-color, #03182f)", G = "var(--ago-brand-text-color, #fff)", H = "var(--ago-header-background, var(--ago-brand-color, #03182f))", K = "var(--ago-header-text-color, #e8f0fe)", $ = "var(--ago-panel-background, #fff)", F = "var(--ago-messages-background, #fbfbfb)", V = "var(--ago-text-color, #30373e)", X = "var(--ago-muted-text-color, #6b6d6f)", Y = "var(--ago-border-color, #dee3e8)", z = "var(--ago-accent-color, #1b5fc4)", j = "var(--ago-agent-bubble-background, #f1f3f5)", k = "var(--ago-radius, 16px)", q = "var(--ago-message-radius, 16px)", Q = "var(--ago-message-radius, 20px)";
-function W(e, t) {
-  if (t)
-    for (const a of Object.keys(S)) {
-      const r = t[a];
-      r != null && e.style.setProperty(S[a], r);
-    }
-}
-function C(e, t) {
-  Object.assign(e.style, t);
-}
-function Z(e = {}) {
-  const t = document.createElement("div");
-  return C(t, e), t;
-}
-var O = "ago-chat-widget-keyframes";
-function J() {
-  if (typeof document > "u" || document.getElementById(O)) return;
-  const e = document.createElement("style");
-  e.id = O, e.textContent = "@keyframes ago-pulse { 0%, 80%, 100% { opacity: 0.3; transform: scale(0.8); } 40% { opacity: 1; transform: scale(1); } }@keyframes ago-spin { to { transform: rotate(360deg); } }", document.head.appendChild(e);
-}
-var D = "2147483000";
-function M(e, t = "0px") {
-  return e === void 0 ? t : typeof e == "number" ? `${e}px` : e;
-}
-function L(e) {
-  return `(max-width: ${e}px), (max-height: 500px) and (orientation: landscape)`;
-}
-function ee(e = {}) {
-  const t = e.breakpoint ?? 768, a = e.peekHeight ?? 152, r = M(e.bottomOffset), n = e.initialState ?? "peek", s = /* @__PURE__ */ new Set();
-  let i = n, d = !1;
-  const c = typeof window < "u" && typeof window.matchMedia == "function" ? window.matchMedia(L(t)) : void 0;
-  let g = p();
-  const R = m(!1, n);
-  function _(o, l) {
-    if (!o) return {
-      style: {},
-      attrs: {
-        role: null,
-        "aria-modal": null,
-        "aria-label": null
-      }
-    };
-    const E = {
-      position: "fixed",
-      left: "0",
-      right: "0",
-      bottom: r,
-      zIndex: D,
-      display: "flex",
-      flexDirection: "column",
-      borderRadius: l === "full" ? "0" : `${k} ${k} 0 0`,
-      paddingBottom: "env(safe-area-inset-bottom)"
-    };
-    return l === "full" ? {
-      style: {
-        ...E,
-        top: "0",
-        height: "auto",
-        paddingTop: "env(safe-area-inset-top)"
-      },
-      attrs: {
-        role: "dialog",
-        "aria-modal": "true",
-        tabindex: "-1"
-      }
-    } : {
-      style: {
-        ...E,
-        top: "auto",
-        minHeight: `calc(${a}px + env(safe-area-inset-bottom))`,
-        height: "auto"
-      },
-      attrs: {
-        role: null,
-        "aria-modal": null,
-        tabindex: "-1"
-      }
-    };
-  }
-  function m(o, l) {
-    return {
-      compact: o,
-      state: l,
-      isModal: o && l === "full",
-      surface: _(o, l)
-    };
-  }
-  function p() {
-    return m(!!c?.matches, i);
-  }
-  function v() {
-    g = p();
-    for (const o of s) o();
-  }
-  function b(o, l) {
-    d || i === o || (i = o, v(), e.onStateChange?.(o, l));
-  }
-  function y() {
-    if (!d) {
-      if (!c?.matches && i !== n) {
-        i = n, v(), e.onStateChange?.(n, "breakpoint");
-        return;
-      }
-      v();
-    }
-  }
-  let f = !1;
-  function B() {
-    f || !c || (c.addEventListener("change", y), f = !0, g = p());
-  }
-  function h() {
-    !f || !c || (c.removeEventListener("change", y), f = !1);
-  }
-  return {
-    subscribe(o) {
-      return s.add(o), s.size === 1 && B(), () => {
-        s.delete(o), s.size === 0 && h();
-      };
-    },
-    getSnapshot: () => g,
-    getServerSnapshot: () => R,
-    expand: (o = "api") => b("full", o),
-    collapse: (o = "api") => b("peek", o),
-    toggle: (o = "api") => b(i === "full" ? "peek" : "full", o),
-    destroy() {
-      d || (d = !0, h(), s.clear());
-    }
-  };
-}
-export {
-  P as C,
-  N as S,
-  V as _,
-  Y as a,
-  Z as b,
-  I as c,
-  F as d,
-  q as f,
-  k as g,
-  $ as h,
-  j as i,
-  H as l,
-  X as m,
-  ee as n,
-  U as o,
-  Q as p,
-  z as r,
-  G as s,
-  L as t,
-  K as u,
-  W as v,
-  J as x,
-  C as y
-};

package/dist/sheetController-DY-sC13T.cjs

@@ -1 +0,0 @@
-var d=new WeakMap,D=["position","top","left","right","width"];function S(e,t){return t.map(r=>({style:e,prop:r,value:e.getPropertyValue(r),priority:e.getPropertyPriority(r)}))}function k(e){for(const{style:t,prop:r,value:o,priority:a}of e)o?t.setProperty(r,o,a):t.removeProperty(r)}function x(e,t=document){const r=d.get(t);if(r){r.owners.add(e);return}const o=t.body,a=t.documentElement,u=t.defaultView?.scrollY??0;d.set(t,{owners:new Set([e]),saved:[...S(o.style,D),...S(a.style,["overflow"])],scrollY:u}),o.style.position="fixed",o.style.top=`-${u}px`,o.style.left="0",o.style.right="0",o.style.width="100%",a.style.overflow="hidden"}function j(e,t=document){const r=d.get(t);!r||!r.owners.delete(e)||r.owners.size>0||(d.delete(t),k(r.saved),t.defaultView?.scrollTo(0,r.scrollY))}var L='"IBM Plex Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',N=`var(--ago-font, ${L})`,h={font:"--ago-font",radius:"--ago-radius",messageRadius:"--ago-message-radius",brand:"--ago-brand-color",brandText:"--ago-brand-text-color",headerBg:"--ago-header-background",headerText:"--ago-header-text-color",panelBg:"--ago-panel-background",messagesBg:"--ago-messages-background",text:"--ago-text-color",mutedText:"--ago-muted-text-color",border:"--ago-border-color",accent:"--ago-accent-color",agentBubbleBg:"--ago-agent-bubble-background"},M="var(--ago-brand-color, #03182f)",w="var(--ago-brand-text-color, #fff)",U="var(--ago-header-background, var(--ago-brand-color, #03182f))",G="var(--ago-header-text-color, #e8f0fe)",I="var(--ago-panel-background, #fff)",K="var(--ago-messages-background, #fbfbfb)",H="var(--ago-text-color, #30373e)",X="var(--ago-muted-text-color, #6b6d6f)",$="var(--ago-border-color, #dee3e8)",F="var(--ago-accent-color, #1b5fc4)",V="var(--ago-agent-bubble-background, #f1f3f5)",O="var(--ago-radius, 16px)",Y="var(--ago-message-radius, 16px)",z="var(--ago-message-radius, 20px)";function Q(e,t){if(t)for(const r of Object.keys(h)){const o=t[r];o!=null&&e.style.setProperty(h[r],o)}}function A(e,t){Object.assign(e.style,t)}function q(e={}){const t=document.createElement("div");return A(t,e),t}var _="ago-chat-widget-keyframes";function W(){if(typeof document>"u"||document.getElementById(_))return;const e=document.createElement("style");e.id=_,e.textContent="@keyframes ago-pulse { 0%, 80%, 100% { opacity: 0.3; transform: scale(0.8); } 40% { opacity: 1; transform: scale(1); } }@keyframes ago-spin { to { transform: rotate(360deg); } }",document.head.appendChild(e)}var Z="2147483000";function J(e,t="0px"){return e===void 0?t:typeof e=="number"?`${e}px`:e}function P(e){return`(max-width: ${e}px), (max-height: 500px) and (orientation: landscape)`}function ee(e={}){const t=e.breakpoint??768,r=e.peekHeight??152,o=J(e.bottomOffset),a=e.initialState??"peek",u=new Set;let l=a,f=!1;const c=typeof window<"u"&&typeof window.matchMedia=="function"?window.matchMedia(P(t)):void 0;let g=b();const B=y(!1,a);function T(n,i){if(!n)return{style:{},attrs:{role:null,"aria-modal":null,"aria-label":null}};const R={position:"fixed",left:"0",right:"0",bottom:o,zIndex:Z,display:"flex",flexDirection:"column",borderRadius:i==="full"?"0":`${O} ${O} 0 0`,paddingBottom:"env(safe-area-inset-bottom)"};return i==="full"?{style:{...R,top:"0",height:"auto",paddingTop:"env(safe-area-inset-top)"},attrs:{role:"dialog","aria-modal":"true",tabindex:"-1"}}:{style:{...R,top:"auto",minHeight:`calc(${r}px + env(safe-area-inset-bottom))`,height:"auto"},attrs:{role:null,"aria-modal":null,tabindex:"-1"}}}function y(n,i){return{compact:n,state:i,isModal:n&&i==="full",surface:T(n,i)}}function b(){return y(!!c?.matches,l)}function p(){g=b();for(const n of u)n()}function m(n,i){f||l===n||(l=n,p(),e.onStateChange?.(n,i))}function E(){if(!f){if(!c?.matches&&l!==a){l=a,p(),e.onStateChange?.(a,"breakpoint");return}p()}}let s=!1;function C(){s||!c||(c.addEventListener("change",E),s=!0,g=b())}function v(){!s||!c||(c.removeEventListener("change",E),s=!1)}return{subscribe(n){return u.add(n),u.size===1&&C(),()=>{u.delete(n),u.size===0&&v()}},getSnapshot:()=>g,getServerSnapshot:()=>B,expand:(n="api")=>m("full",n),collapse:(n="api")=>m("peek",n),toggle:(n="api")=>m(l==="full"?"peek":"full",n),destroy(){f||(f=!0,v(),u.clear())}}}Object.defineProperty(exports,"ACCENT_COLOR",{enumerable:!0,get:function(){return F}});Object.defineProperty(exports,"AGENT_BUBBLE_BACKGROUND",{enumerable:!0,get:function(){return V}});Object.defineProperty(exports,"BORDER_COLOR",{enumerable:!0,get:function(){return $}});Object.defineProperty(exports,"BRAND_COLOR",{enumerable:!0,get:function(){return M}});Object.defineProperty(exports,"BRAND_TEXT_COLOR",{enumerable:!0,get:function(){return w}});Object.defineProperty(exports,"FONT_VAR",{enumerable:!0,get:function(){return N}});Object.defineProperty(exports,"HEADER_BACKGROUND",{enumerable:!0,get:function(){return U}});Object.defineProperty(exports,"HEADER_TEXT_COLOR",{enumerable:!0,get:function(){return G}});Object.defineProperty(exports,"MESSAGES_BACKGROUND",{enumerable:!0,get:function(){return K}});Object.defineProperty(exports,"MESSAGE_RADIUS",{enumerable:!0,get:function(){return Y}});Object.defineProperty(exports,"MESSAGE_RADIUS_IMESSAGE",{enumerable:!0,get:function(){return z}});Object.defineProperty(exports,"MUTED_TEXT_COLOR",{enumerable:!0,get:function(){return X}});Object.defineProperty(exports,"PANEL_BACKGROUND",{enumerable:!0,get:function(){return I}});Object.defineProperty(exports,"RADIUS",{enumerable:!0,get:function(){return O}});Object.defineProperty(exports,"TEXT_COLOR",{enumerable:!0,get:function(){return H}});Object.defineProperty(exports,"applyTheme",{enumerable:!0,get:function(){return Q}});Object.defineProperty(exports,"compactMediaQuery",{enumerable:!0,get:function(){return P}});Object.defineProperty(exports,"createSheetController",{enumerable:!0,get:function(){return ee}});Object.defineProperty(exports,"css",{enumerable:!0,get:function(){return A}});Object.defineProperty(exports,"div",{enumerable:!0,get:function(){return q}});Object.defineProperty(exports,"ensureKeyframes",{enumerable:!0,get:function(){return W}});Object.defineProperty(exports,"lockBackgroundScroll",{enumerable:!0,get:function(){return x}});Object.defineProperty(exports,"unlockBackgroundScroll",{enumerable:!0,get:function(){return j}});