@helpai/elements 0.26.0 → 0.28.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-2pMWV4oW.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-E-Jyc0nF.js';
 import 'zod';
 
 /**
@@ -146,7 +146,7 @@ interface ConversationWelcome {
     suggestions?: ConversationSuggestion[];
 }
 /**
- * Response from `POST /ai-agent/handshake` — the widget's one mount-time
+ * Response from `POST /pai/handshake` — the widget's one mount-time
  * round-trip. Deliberately LIGHT: identity + deployment surface only
  * (config, agent persona, welcome, page-mode site/blocks, userPrefs).
  * The conversation THREAD is a separate, lazily-fetched read
@@ -896,14 +896,14 @@ interface PageContext {
 /**
  * Override the HTTP endpoints the widget calls. `upload` / `transcribe`
  * paths are appended to the agent base (`${baseUrl}/api/agent`);
- * `submitForm` is appended to the data base (`dataBaseUrl`). Absolute URLs
+ * `submitForm` is appended to the data base (`dataApiBaseUrl`). Absolute URLs
  * also work (useful when the upload endpoint lives on a different origin
  * like a CDN presign service).
  */
 interface Endpoints {
-    /** File upload endpoint. Default: `'/ai-agent/upload-file'`. */
+    /** File upload endpoint. Default: `'/pai/upload-file'`. */
     upload?: string;
-    /** Voice transcription endpoint. Default: `'/ai-agent/transcribe-audio'`. */
+    /** Voice transcription endpoint. Default: `'/pai/transcribe-audio'`. */
     transcribe?: string;
     /**
      * Form submission endpoint. Default: `'/submit-form'`. When any form
@@ -933,13 +933,14 @@ interface Endpoints {
 /** Section: anonymous owner-facing usage tracking. */
 interface TrackingOptions {
     /**
-     * Master switch. Default `false` — tracking stays off until the
-     * deployment (or the embedding page) explicitly turns it on.
+     * Master switch. Default `true` — the widget always fires; the data
+     * module gates ingestion per deployment server-side. Set `false`
+     * (deployment config or init) to silence the client entirely.
      */
     enabled?: boolean;
     /**
-     * Pixel collector URL. Default: `${dataBaseUrl}/elements/px.gif`
-     * (e.g. `https://help.ai/api/data/elements/px.gif`).
+     * Pixel collector URL. Default: `${dataApiBaseUrl}/pai/elements-px.gif`
+     * (e.g. `https://help.ai/api/data/pai/elements-px.gif`).
      */
     endpoint?: string;
     /**
@@ -1015,22 +1016,22 @@ interface ChatWidgetOptions {
      * Agent-API base (no trailing slash) — set it when the
      * `module-help-ai-agent-api` service is reached DIRECTLY (a standalone
      * local module, e.g. `http://localhost:3087`) instead of through the
-     * edge. Routes attach as-is (`${agentBaseUrl}/ai-agent/handshake`).
+     * edge. Routes attach as-is (`${agentApiBaseUrl}/pai/handshake`).
      * Precedence: this option > derived from the main origin
      * (`${baseUrl}/api/agent`). Not server-pushable — the handshake already
      * travelled over it.
      */
-    agentBaseUrl?: string;
+    agentApiBaseUrl?: string;
     /**
      * Data-API base (no trailing slash) — the `module-help-ai-data-api`
      * service serving content, form definitions, and form submissions at
      * root-level paths (`/content`, `/forms`, `/activity`, `/submit-form`).
      * Set it for a standalone local module (e.g. `http://localhost:3106`).
-     * Precedence: this option > server-pushed `config.dataBaseUrl` > derived
+     * Precedence: this option > server-pushed `config.dataApiBaseUrl` > derived
      * from the main origin (`${baseUrl}/api/data`, e.g.
      * `https://help.ai/api/data`).
      */
-    dataBaseUrl?: string;
+    dataApiBaseUrl?: string;
     /** Host-asserted, informational end-user context (untrusted; not auth). */
     userContext?: UserContext;
     /** Host-asserted, informational page/visit context (untrusted; `area`, url, …). */
@@ -1085,10 +1086,10 @@ interface ResolvedOptions {
     publicKey?: string;
     aiAgentDeploymentId?: string;
     baseUrl: string;
-    /** Resolved agent-API base — see {@link ChatWidgetOptions.agentBaseUrl}. */
-    agentBaseUrl: string;
-    /** Resolved data-API base — see {@link ChatWidgetOptions.dataBaseUrl}. */
-    dataBaseUrl: string;
+    /** Resolved agent-API base — see {@link ChatWidgetOptions.agentApiBaseUrl}. */
+    agentApiBaseUrl: string;
+    /** Resolved data-API base — see {@link ChatWidgetOptions.dataApiBaseUrl}. */
+    dataApiBaseUrl: string;
     userContext?: UserContext;
     pageContext?: PageContext;
     position: Position;
@@ -1187,7 +1188,7 @@ interface ResolvedOptions {
  */
 interface ServerConfig {
     /** Data-API base override — adopted only when the host didn't set one. */
-    dataBaseUrl?: string;
+    dataApiBaseUrl?: string;
     presentation?: PresentationOptions;
     behavior?: BehaviorOptions;
     theme?: ThemePreference | ThemeOverrides;

package/index.mjs

@@ -476,13 +476,13 @@ var DEFAULT_FEATURES = {
 };
 var DEFAULT_FORMS = { list: [], byTrigger: {} };
 var DEFAULT_TRACKING = {
-  enabled: false,
+  enabled: true,
   sampleRate: 1
 };
 var DEFAULT_ENDPOINTS = {
-  upload: "/ai-agent/upload-file",
-  transcribe: "/ai-agent/transcribe-audio",
-  submitForm: "/submit-form"
+  upload: "/pai/upload-file",
+  transcribe: "/pai/transcribe-audio",
+  submitForm: "/pai/submit-form"
 };
 var DEFAULT_LAUNCHER = {
   variant: "circle",
@@ -525,15 +525,15 @@ function resolveOptions(rawOpts) {
   const locale = i18n.locale ?? resolveDefaultLocale(i18n.defaultLocale);
   const availableLocales = i18n.availableLocales ?? [locale];
   const baseUrl = (opts.baseUrl ?? BRAND.defaultBaseUrl).replace(/\/$/, "");
-  const agentBaseUrl = (opts.agentBaseUrl ?? `${baseUrl}/api/agent`).replace(/\/$/, "");
-  const dataBaseUrl = (opts.dataBaseUrl ?? `${baseUrl}/api/data`).replace(/\/$/, "");
+  const agentApiBaseUrl = (opts.agentApiBaseUrl ?? `${baseUrl}/api/agent`).replace(/\/$/, "");
+  const dataApiBaseUrl = (opts.dataApiBaseUrl ?? `${baseUrl}/api/data`).replace(/\/$/, "");
   return {
     widgetId: opts.widgetId ?? "default",
     publicKey: opts.publicKey,
     aiAgentDeploymentId: opts.aiAgentDeploymentId,
     baseUrl,
-    agentBaseUrl,
-    dataBaseUrl,
+    agentApiBaseUrl,
+    dataApiBaseUrl,
     userContext: sanitizeUserContext(opts.userContext),
     pageContext: sanitizePageContext(opts.pageContext),
     position: presentation.position ?? "bottom-right",
@@ -578,7 +578,7 @@ function resolveOptions(rawOpts) {
     poweredBy: resolvePoweredBy(footer.poweredBy),
     composer: resolveComposer(opts.composer),
     modules: resolveModules(opts.modules),
-    tracking: resolveTracking(opts.tracking, dataBaseUrl),
+    tracking: resolveTracking(opts.tracking, dataApiBaseUrl),
     storage: opts.storage ?? defaultStorage,
     onMessage: opts.onMessage,
     onOpen: opts.onOpen,
@@ -611,13 +611,13 @@ function resolveHaptics(overrides) {
     events: overrides?.events
   };
 }
-function resolveTracking(overrides, dataBaseUrl) {
+function resolveTracking(overrides, dataApiBaseUrl) {
   const sampleRate = overrides?.sampleRate ?? DEFAULT_TRACKING.sampleRate;
   return {
     enabled: overrides?.enabled ?? DEFAULT_TRACKING.enabled,
-    // The collector rides the data module — `${dataBaseUrl}/elements/px.gif`
-    // (e.g. `https://help.ai/api/data/elements/px.gif`).
-    endpoint: overrides?.endpoint ?? `${dataBaseUrl}/elements/px.gif`,
+    // The collector rides the data module — `${dataApiBaseUrl}/pai/elements-px.gif`
+    // (e.g. `https://help.ai/api/data/pai/elements-px.gif`).
+    endpoint: overrides?.endpoint ?? `${dataApiBaseUrl}/pai/elements-px.gif`,
     // Clamp instead of reject — a malformed rate must never turn a
     // disabled tracker on or crash resolve (no Zod on the IIFE path).
     sampleRate: Math.min(1, Math.max(0, Number.isFinite(sampleRate) ? sampleRate : 1)),
@@ -786,7 +786,8 @@ function mergeServerConfig(user, server) {
     out[key] = mergeLeaves(sv, uv);
   }
   if (server.modules !== void 0 && user.modules === void 0) out.modules = server.modules;
-  if (server.dataBaseUrl !== void 0 && user.dataBaseUrl === void 0) out.dataBaseUrl = server.dataBaseUrl;
+  if (server.dataApiBaseUrl !== void 0 && user.dataApiBaseUrl === void 0)
+    out.dataApiBaseUrl = server.dataApiBaseUrl;
   const userI18n = user.i18n;
   const serverI18n = server.i18n;
   if (userI18n || serverI18n) {
@@ -846,8 +847,8 @@ var EMBED_SCALAR_ATTRS = [
   ["public-key", "publicKey"],
   ["ai-agent-deployment-id", "aiAgentDeploymentId"],
   ["base-url", "baseUrl"],
-  ["agent-base-url", "agentBaseUrl"],
-  ["data-base-url", "dataBaseUrl"],
+  ["agent-api-base-url", "agentApiBaseUrl"],
+  ["data-api-base-url", "dataApiBaseUrl"],
   ["theme", "theme", (v) => v]
 ];
 var PRESENTATION_ATTRS = [
@@ -1253,63 +1254,61 @@ function parseWireDate(value) {
 }
 var DEFAULT_PATHS = {
   /** Conversation bootstrap. `POST` → deployment config + per-visitor state. */
-  handshake: "/ai-agent/handshake",
+  handshake: "/pai/handshake",
   /** Send a message + stream the reply (SSE). `POST`. */
-  streamMessage: "/ai-agent/stream-message",
+  streamMessage: "/pai/stream-message",
   /**
    * Resume an interrupted reply. `GET` (envelope rides as query params).
    * Stateless: the server re-streams the whole reply SSE again from the start —
    * there is NO `Last-Event-ID`. The client reconciles by id (`seenIds`), so
    * replayed events are skipped and only the continuation surfaces.
    */
-  streamResume: "/ai-agent/stream-resume",
+  streamResume: "/pai/stream-resume",
   /** Abort the in-flight reply stream. `POST`. */
-  cancelStream: "/ai-agent/cancel-stream",
+  cancelStream: "/pai/cancel-stream",
   /** List the visitor's conversations. `GET`. */
-  listConversations: "/ai-agent/list-conversations",
+  listConversations: "/pai/list-conversations",
   /** Load one conversation's thread (messages + canContinue + suggestions). `GET ?conversationId=…`. */
-  listMessages: "/ai-agent/list-messages",
+  listMessages: "/pai/list-messages",
   /**
    * Persist a user-driven settings change. POST `{ visitorId, userPrefs }` →
    * server persists, returns the merged authoritative copy. Fire-and-forget on
    * the client — a failure leaves the local cache valid; the next
    * `handshake()` reconciles.
    */
-  updateSettings: "/ai-agent/update-settings",
+  updateSettings: "/pai/update-settings",
   /**
    * Mark a conversation read. POST `{ visitorId, conversationId }` → the server
    * records `lastReadAt = now` for that (visitor, conversation) and recomputes
    * `unreadCount` (returned on `/list-conversations`) accordingly. Fire-and-forget
    * on the client; a failure just leaves the badge until the next sync.
    */
-  markRead: "/ai-agent/mark-read",
-  // ── Data API (module-help-ai-data-api, via `dataBaseUrl`) ─────────
-  /** All widget content via one filtered endpoint. `GET /content?tags=…`. */
-  content: "/content",
+  markRead: "/pai/mark-read",
+  // ── Data API (module-help-ai-data-api, via `dataApiBaseUrl`) ─────────
+  /**
+   * The data module's one ACTIVATION read. `GET
+   * /pai/bootstrap?visitorId=…&conversationId=…` →
+   * `{ forms, formSubmissions }`: the deployment's resolved form
+   * definitions plus the visitor's recorded submissions for the envelope's
+   * conversation (chronological — they rebuild the timeline markers).
+   * Also re-read with an explicit `conversationId` selector on a
+   * history-pane thread switch. A failure is treated as "no forms, no
+   * records" (non-fatal) — the chat works regardless.
+   */
+  bootstrap: "/pai/bootstrap",
   /**
-   * Resolved form definitions for the deployment. `GET /forms` →
-   * `{ forms: FormDef[] }`. Fetched once at boot (in parallel with
-   * handshake); form gating waits for it. A failure is treated as
-   * "no forms" (non-fatal).
+   * All widget content via one filtered endpoint — content stays OUT of the
+   * bootstrap because its reads are query-driven (`tags` / `categories` /
+   * `ids` / `search` + pagination). `GET /pai/content?tags=…`.
    */
-  forms: "/forms",
+  content: "/pai/content",
   /**
    * Form submission (the event-driven forms engine). POST `{ visitorId,
    * conversationId, formId, trigger, values, skipped? }` → record the form's answers
    * immediately, keyed by the same `visitorId` + `conversationId` the chat uses.
    * Overridable via `endpoints.submitForm`. Fire-and-forget; 404 is ignored.
    */
-  submitForm: "/submit-form",
-  /**
-   * Visitor interaction records for a conversation. `GET
-   * /activity?visitorId=…&conversationId=…` →
-   * `{ formSubmissions: FormSubmissionRecord[] }` (chronological). Replaces
-   * the former `formSubmissions` echo on the handshake / list-messages;
-   * deliberately generic — future visitor interaction records ride the same
-   * endpoint. A failure (e.g. 404 `AI_AGENT_PUBLIC_ACCESS_NOT_FOUND` when the
-   * deployment doesn't resolve) is treated as "no records" (non-fatal).
-   */
-  activity: "/activity"
+  submitForm: "/pai/submit-form"
 };
 var CONTEXT_PARAM = "context";
 function buildSendMessageRequest(params) {
@@ -1578,7 +1577,7 @@ var AgentTransport = class {
   }
   // ---- Data API (content / forms — module-help-ai-data-api) --------------
   //
-  // The DATA surfaces live on `dataBaseUrl` (default `${baseUrl}/api/data`)
+  // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
   // with ROOT-level paths — same auth headers + envelope, same retry
   // behavior. One endpoint for every content surface (Home / Help / News /
   // docs); callers pass filters; a thrown StreamError (e.g. 404 on an older
@@ -1598,38 +1597,26 @@ var AgentTransport = class {
     return { ...res, items };
   }
   /**
-   * Fetch the deployment's resolved form definitions. `GET /forms`
-   * (data-API). Replaces the former `config.forms` push on the handshake —
-   * called once at boot, in parallel with `handshake`; form gating
-   * (pre-chat etc.) waits for it. Callers treat a thrown StreamError as
-   * "no forms" (non-fatal).
-   */
-  async listForms() {
-    log4.debug("listForms \u2192");
-    const res = await this.getJson(this.dataUrl(DEFAULT_PATHS.forms), "listForms");
-    const forms = res.forms ?? [];
-    log4.debug("listForms \u2190", { count: forms.length });
-    return { forms };
-  }
-  /**
-   * Fetch the visitor's recorded activity for a conversation — currently the
-   * form submissions that rebuild the collapsed "form submitted / skipped"
-   * timeline markers on resume. `GET /activity` (data-API); the
-   * envelope carries `visitorId` / `conversationId` as query params.
-   * `conversationId` here is an optional resource selector (a thread that may
-   * differ from the active conversation — the history-pane switch); when
-   * omitted, the envelope's active conversation applies. Callers treat a
-   * thrown StreamError (e.g. 404 on a deployment that doesn't resolve) as
-   * "no activity" (non-fatal).
+   * The data module's ONE activation read. `GET /pai/bootstrap` (data-API)
+   * → the deployment's resolved form definitions + the visitor's recorded
+   * form submissions for the envelope's conversation. The handshake
+   * (agent-API) is completely independent of these surfaces.
+   *
+   * `conversationId` is an optional resource selector (a thread that may
+   * differ from the active conversation — the history-pane switch re-reads
+   * that thread's submissions); when omitted, the envelope's active
+   * conversation applies. Callers treat a thrown StreamError (e.g. 404 on a
+   * deployment that doesn't resolve) as "no forms, no records" (non-fatal).
    */
-  async getActivity(conversationId) {
-    const url = new URL(this.dataUrl(DEFAULT_PATHS.activity));
+  async bootstrap(conversationId) {
+    const url = new URL(this.dataUrl(DEFAULT_PATHS.bootstrap));
     if (conversationId) url.searchParams.set("conversationId", conversationId);
-    log4.debug("getActivity \u2192", { conversationId: conversationId ?? this.conversationId });
-    const res = await this.getJson(url.toString(), "getActivity");
+    log4.debug("bootstrap \u2192", { conversationId: conversationId ?? this.conversationId });
+    const res = await this.getJson(url.toString(), "bootstrap");
+    const forms = res.forms ?? [];
     const formSubmissions = res.formSubmissions ?? [];
-    log4.debug("getActivity \u2190", { count: formSubmissions.length });
-    return { formSubmissions };
+    log4.debug("bootstrap \u2190", { forms: forms.length, formSubmissions: formSubmissions.length });
+    return { forms, formSubmissions };
   }
   async saveUserPrefs(userPrefs) {
     log4.debug("saveUserPrefs \u2192", {
@@ -1642,10 +1629,10 @@ var AgentTransport = class {
     return res;
   }
   get uploadPath() {
-    return this.opts.endpoints?.upload ?? "/ai-agent/upload-file";
+    return this.opts.endpoints?.upload ?? "/pai/upload-file";
   }
   get transcribePath() {
-    return this.opts.endpoints?.transcribe ?? "/ai-agent/transcribe-audio";
+    return this.opts.endpoints?.transcribe ?? "/pai/transcribe-audio";
   }
   get submitFormPath() {
     return this.opts.endpoints?.submitForm ?? DEFAULT_PATHS.submitForm;
@@ -1788,7 +1775,7 @@ var AgentTransport = class {
     }
     return false;
   }
-  /** Abort + fire-and-forget POST to `/ai-agent/cancel-stream`. Idempotent. */
+  /** Abort + fire-and-forget POST to `/pai/cancel-stream`. Idempotent. */
   cancelStream(ctrl, conversationId) {
     if (ctrl.signal.aborted) return;
     log4.debug("cancel stream", { conversationId, visitorId: this.visitorId });
@@ -1898,12 +1885,12 @@ var AgentTransport = class {
     return await res.json();
   }
   /**
-   * Agent-API URL — resolves a `/ai-agent/*` path against the resolved
+   * Agent-API URL — resolves a `/pai/*` path against the resolved
    * agent module base. Absolute URLs pass through unchanged.
    */
   url(pathOrUrl) {
     if (/^https?:\/\//i.test(pathOrUrl)) return pathOrUrl;
-    return `${this.opts.agentBaseUrl}${pathOrUrl}`;
+    return `${this.opts.agentApiBaseUrl}${pathOrUrl}`;
   }
   /**
    * Data-API variant of {@link url} — resolves a root-level path (content /
@@ -1913,7 +1900,7 @@ var AgentTransport = class {
    */
   dataUrl(pathOrUrl) {
     if (/^https?:\/\//i.test(pathOrUrl)) return pathOrUrl;
-    return `${this.opts.dataBaseUrl}${pathOrUrl}`;
+    return `${this.opts.dataApiBaseUrl}${pathOrUrl}`;
   }
   get fetchImpl() {
     return this.opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
@@ -6479,8 +6466,8 @@ function App({ options, hostElement, bus }) {
   const [formContext, setFormContext] = useState13({});
   const [transport] = useState13(
     () => new AgentTransport({
-      agentBaseUrl: options.agentBaseUrl,
-      dataBaseUrl: options.dataBaseUrl,
+      agentApiBaseUrl: options.agentApiBaseUrl,
+      dataApiBaseUrl: options.dataApiBaseUrl,
       auth: createAuth({
         publicKey: options.publicKey,
         aiAgentDeploymentId: options.aiAgentDeploymentId,
@@ -6561,10 +6548,11 @@ function App({ options, hostElement, bus }) {
     },
     [messagesSig]
   );
+  const dataBootRef = useRef9(null);
   const fetchFormMarkers = useCallback6(
     async (conversationId) => {
       try {
-        const { formSubmissions: subs } = await transport.getActivity(conversationId);
+        const { formSubmissions: subs } = await (conversationId ? transport.bootstrap(conversationId) : dataBootRef.current ?? transport.bootstrap());
         const lastIndexByForm = /* @__PURE__ */ new Map();
         subs.forEach((rec, i) => lastIndexByForm.set(rec.formId, i));
         return subs.filter((rec, i) => !rec.skipped || lastIndexByForm.get(rec.formId) === i).map((rec, i) => ({
@@ -6575,7 +6563,7 @@ function App({ options, hostElement, bus }) {
           values: rec.values
         }));
       } catch (err) {
-        log16.debug("getActivity failed \u2014 no form markers (non-fatal)", { err });
+        log16.debug("bootstrap failed \u2014 no form markers (non-fatal)", { err });
         return [];
       }
     },
@@ -6764,12 +6752,13 @@ function App({ options, hostElement, bus }) {
   }, []);
   useEffect17(() => {
     if (!activated) return;
+    dataBootRef.current = transport.bootstrap();
     void (async () => {
       try {
-        const res = await transport.listForms();
-        setRemoteForms(resolveForms(res.forms));
+        const res = await dataBootRef.current;
+        setRemoteForms(resolveForms((res ?? { forms: [] }).forms));
       } catch (err) {
-        log16.debug("listForms failed \u2014 treating as no forms", { err });
+        log16.debug("bootstrap failed \u2014 treating as no forms", { err });
       } finally {
         setFormsReady(true);
       }
@@ -7154,6 +7143,20 @@ function App({ options, hostElement, bus }) {
     },
     [transport, messagesSig, conversationIdSig, bus, options, persistence, refreshUnread, fetchFormMarkers]
   );
+  const pendingOpenFormRef = useRef9(null);
+  const openForm = useCallback6(
+    (id) => {
+      if (typeof id !== "string") return;
+      if (formsReady) forms.fire("manual", id);
+      else pendingOpenFormRef.current = id;
+    },
+    [formsReady, forms]
+  );
+  useEffect17(() => {
+    if (!formsReady || !pendingOpenFormRef.current) return;
+    forms.fire("manual", pendingOpenFormRef.current);
+    pendingOpenFormRef.current = null;
+  }, [formsReady, forms]);
   useEffect17(() => {
     const unsub = bindHostCommands(hostElement, {
       open: handleOpen,
@@ -7161,10 +7164,10 @@ function App({ options, hostElement, bus }) {
       expand: handleExpand,
       fullscreen: handleFullscreen,
       popout: handlePopOut,
-      openForm: (id) => forms.fire("manual", typeof id === "string" ? id : void 0)
+      openForm
     });
     return unsub;
-  }, [hostElement, handleOpen, handleClose, handleExpand, handleFullscreen, handlePopOut, forms]);
+  }, [hostElement, handleOpen, handleClose, handleExpand, handleFullscreen, handlePopOut, openForm]);
   const effectiveOptions = useMemo3(
     () => applyOptionOverrides(options, activeLocale, activeThemeMode, activeTextSize),
     [options, activeLocale, activeThemeMode, activeTextSize]

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.26.0"
+  "version": "0.28.0"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-2pMWV4oW.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-E-Jyc0nF.js';
 import { z } from 'zod';
 
 /**

package/schema.json

@@ -32,14 +32,14 @@
           "minLength": 1,
           "maxLength": 2048
         },
-        "agentBaseUrl": {
-          "description": "Full agent-API base — set it to reach a STANDALONE `module-help-ai-agent-api` directly (local module on its own port, e.g. `http://localhost:3087`; routes attach as-is: `/ai-agent/handshake`). Precedence: this option > derived from the main origin (`${baseUrl}/api/agent`). Not server-pushable.",
+        "agentApiBaseUrl": {
+          "description": "Full agent-API base — set it to reach a STANDALONE `module-help-ai-agent-api` directly (local module on its own port, e.g. `http://localhost:3087`; routes attach as-is: `/pai/handshake`). Precedence: this option > derived from the main origin (`${baseUrl}/api/agent`). Not server-pushable.",
           "type": "string",
           "minLength": 1,
           "maxLength": 2048
         },
-        "dataBaseUrl": {
-          "description": "Full data-API base (e.g. `https://help.ai/api/data`, or a standalone local module like `http://localhost:3106`) — the service serving content, form definitions (`GET /forms`), and form submissions at root-level paths. Precedence: this option > server-pushed `config.dataBaseUrl` > derived from the main origin (`${baseUrl}/api/data`).",
+        "dataApiBaseUrl": {
+          "description": "Full data-API base (e.g. `https://help.ai/api/data`, or a standalone local module like `http://localhost:3106`) — the service serving content, form definitions (`GET /forms`), and form submissions at root-level paths. Precedence: this option > server-pushed `config.dataApiBaseUrl` > derived from the main origin (`${baseUrl}/api/data`).",
           "type": "string",
           "minLength": 1,
           "maxLength": 2048
@@ -166,19 +166,19 @@
           "type": "object",
           "properties": {
             "upload": {
-              "default": "/ai-agent/upload-file",
+              "default": "/pai/upload-file",
               "type": "string",
               "minLength": 1,
               "maxLength": 2048
             },
             "transcribe": {
-              "default": "/ai-agent/transcribe-audio",
+              "default": "/pai/transcribe-audio",
               "type": "string",
               "minLength": 1,
               "maxLength": 2048
             },
             "submitForm": {
-              "default": "/submit-form",
+              "default": "/pai/submit-form",
               "description": "Form submission endpoint. The widget POSTs each completed form's values here (fire-and-forget), keyed by the same visitorId + conversationId as the conversation; the payload carries `formId` + `trigger` so the backend can route. Optional — a 404 is ignored.",
               "type": "string",
               "minLength": 1,
@@ -191,11 +191,11 @@
             "submitForm"
           ],
           "additionalProperties": {},
-          "description": "HTTP endpoint overrides. `upload` / `transcribe` paths are appended to the agent base (`${baseUrl}/api/agent`), `submitForm` to the data base (`dataBaseUrl`); absolute URLs are accepted too.",
+          "description": "HTTP endpoint overrides. `upload` / `transcribe` paths are appended to the agent base (`${baseUrl}/api/agent`), `submitForm` to the data base (`dataApiBaseUrl`); absolute URLs are accepted too.",
           "examples": [
             {
-              "upload": "/ai-agent/upload-file",
-              "transcribe": "/ai-agent/transcribe-audio"
+              "upload": "/pai/upload-file",
+              "transcribe": "/pai/transcribe-audio"
             },
             {
               "upload": "https://help.ai/uploads/presign"
@@ -1867,11 +1867,11 @@
           "type": "object",
           "properties": {
             "enabled": {
-              "description": "Master switch. Default `false` — no hits are sent until the deployment turns tracking on.",
+              "description": "Master switch. Default `true` — the widget always fires; the data module gates ingestion per deployment server-side. Set `false` to silence the client entirely.",
               "type": "boolean"
             },
             "endpoint": {
-              "description": "Pixel collector URL. Default: `${dataBaseUrl}/elements/px.gif` (e.g. `https://help.ai/api/data/elements/px.gif`). Must be a full URL.",
+              "description": "Pixel collector URL. Default: `${dataApiBaseUrl}/pai/elements-px.gif` (e.g. `https://help.ai/api/data/pai/elements-px.gif`). Must be a full URL.",
               "type": "string",
               "maxLength": 2048,
               "format": "uri"
@@ -3272,11 +3272,11 @@
               "type": "object",
               "properties": {
                 "enabled": {
-                  "description": "Master switch. Default `false` — no hits are sent until the deployment turns tracking on.",
+                  "description": "Master switch. Default `true` — the widget always fires; the data module gates ingestion per deployment server-side. Set `false` to silence the client entirely.",
                   "type": "boolean"
                 },
                 "endpoint": {
-                  "description": "Pixel collector URL. Default: `${dataBaseUrl}/elements/px.gif` (e.g. `https://help.ai/api/data/elements/px.gif`). Must be a full URL.",
+                  "description": "Pixel collector URL. Default: `${dataApiBaseUrl}/pai/elements-px.gif` (e.g. `https://help.ai/api/data/pai/elements-px.gif`). Must be a full URL.",
                   "type": "string",
                   "maxLength": 2048,
                   "format": "uri"
@@ -3305,7 +3305,7 @@
                 }
               ]
             },
-            "dataBaseUrl": {
+            "dataApiBaseUrl": {
               "type": "string",
               "minLength": 1,
               "maxLength": 2048