@helpai/elements 0.27.0 → 0.28.1

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-CcW_mx_i.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';
 
 /**
@@ -896,7 +896,7 @@ 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).
  */
@@ -939,7 +939,7 @@ interface TrackingOptions {
      */
     enabled?: boolean;
     /**
-     * Pixel collector URL. Default: `${dataBaseUrl}/pai/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;
@@ -1016,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}/pai/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, …). */
@@ -1086,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;
@@ -1188,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

@@ -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}/pai/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 ?? `${dataBaseUrl}/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 = [
@@ -1283,7 +1284,7 @@ var DEFAULT_PATHS = {
    * on the client; a failure just leaves the badge until the next sync.
    */
   markRead: "/pai/mark-read",
-  // ── Data API (module-help-ai-data-api, via `dataBaseUrl`) ─────────
+  // ── Data API (module-help-ai-data-api, via `dataApiBaseUrl`) ─────────
   /**
    * The data module's one ACTIVATION read. `GET
    * /pai/bootstrap?visitorId=…&conversationId=…` →
@@ -1380,6 +1381,7 @@ function messageToWireParts(m) {
 var log4 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var CONTENT_CACHE_TTL_MS = 6e4;
 var MAX_REQUEST_RETRIES = 3;
 var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
 function backoffMs(attempt) {
@@ -1418,6 +1420,20 @@ var AgentTransport = class {
     // always sees the visitor's latest context as they navigate.
     __publicField(this, "userContext");
     __publicField(this, "pageContext");
+    // ---- Data API (content / forms — module-help-ai-data-api) --------------
+    //
+    // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
+    // under the module's `/pai/*` group — 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 backend) is treated as "no content" by the module and the tab
+    // degrades gracefully.
+    // Per-query content cache: published content barely changes mid-visit, but
+    // every tab switch remounts its module and re-asks. Entries hold the
+    // REQUEST PROMISE (concurrent identical queries share one network call)
+    // and serve repeats for CONTENT_CACHE_TTL_MS; failures are evicted so the
+    // next ask retries.
+    __publicField(this, "contentCache", /* @__PURE__ */ new Map());
   }
   // ---- Public API -------------------------------------------------------
   /**
@@ -1574,16 +1590,22 @@ var AgentTransport = class {
       log4.debug("markRead failed (non-fatal)", { err });
     }
   }
-  // ---- Data API (content / forms — module-help-ai-data-api) --------------
-  //
-  // The DATA surfaces live on `dataBaseUrl` (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
-  // backend) is treated as "no content" by the module and the tab degrades
-  // gracefully.
-  /** Fetch content rows by filter. `GET /content` (data-API). */
-  async listContent(query = {}) {
+  /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
+  listContent(query = {}) {
+    const key = JSON.stringify(query, Object.keys(query).toSorted());
+    const cached = this.contentCache.get(key);
+    if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
+      log4.debug("listContent \u2192 cache", query);
+      return cached.result;
+    }
+    const result = this.fetchContent(query).catch((err) => {
+      this.contentCache.delete(key);
+      throw err;
+    });
+    this.contentCache.set(key, { at: Date.now(), result });
+    return result;
+  }
+  async fetchContent(query) {
     const url = new URL(this.dataUrl(DEFAULT_PATHS.content));
     for (const [key, value] of Object.entries(query)) {
       if (value === void 0) continue;
@@ -1889,7 +1911,7 @@ var AgentTransport = class {
    */
   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 /
@@ -1899,7 +1921,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);
@@ -6465,8 +6487,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,

package/package.json

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

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-CcW_mx_i.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": {
+        "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
@@ -191,7 +191,7 @@
             "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": "/pai/upload-file",
@@ -1871,7 +1871,7 @@
               "type": "boolean"
             },
             "endpoint": {
-              "description": "Pixel collector URL. Default: `${dataBaseUrl}/pai/elements-px.gif` (e.g. `https://help.ai/api/data/pai/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"
@@ -3276,7 +3276,7 @@
                   "type": "boolean"
                 },
                 "endpoint": {
-                  "description": "Pixel collector URL. Default: `${dataBaseUrl}/pai/elements-px.gif` (e.g. `https://help.ai/api/data/pai/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

package/schema.mjs

@@ -573,7 +573,7 @@ var trackingSchema = z15.object({
     "Master switch. Default `true` \u2014 the widget always fires; the data module gates ingestion per deployment server-side. Set `false` to silence the client entirely."
   ),
   endpoint: z15.url().max(2048).optional().describe(
-    "Pixel collector URL. Default: `${dataBaseUrl}/pai/elements-px.gif` (e.g. `https://help.ai/api/data/pai/elements-px.gif`). Must be a full URL."
+    "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."
   ),
   sampleRate: z15.number().min(0).max(1).optional().describe("Per-visitor sampling 0..1 (decided once per page load, keeping funnels intact). Default `1`."),
   token: z15.string().max(512).optional().describe(
@@ -593,7 +593,7 @@ var endpointsSchema = z16.object({
     "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 \u2014 a 404 is ignored."
   )
 }).loose().describe(
-  "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."
+  "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."
 ).meta({
   examples: [
     { upload: "/pai/upload-file", transcribe: "/pai/transcribe-audio" },
@@ -645,11 +645,11 @@ var connectionConfigSchema = z16.object({
   baseUrl: z16.string().min(1).max(2048).optional().describe(
     "MAIN site origin (e.g. `https://help.ai`) \u2014 the API modules derive from it: agent API at `${baseUrl}/api/agent`, data API at `${baseUrl}/api/data`. Set this to point at your staging / self-hosted / custom backend. Default: the brand's `defaultBaseUrl` baked at build time."
   ),
-  agentBaseUrl: z16.string().min(1).max(2048).optional().describe(
+  agentApiBaseUrl: z16.string().min(1).max(2048).optional().describe(
     "Full agent-API base \u2014 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."
   ),
-  dataBaseUrl: z16.string().min(1).max(2048).optional().describe(
-    "Full data-API base (e.g. `https://help.ai/api/data`, or a standalone local module like `http://localhost:3106`) \u2014 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: z16.string().min(1).max(2048).optional().describe(
+    "Full data-API base (e.g. `https://help.ai/api/data`, or a standalone local module like `http://localhost:3106`) \u2014 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`)."
   ),
   userContext: userContextSchema.optional(),
   pageContext: pageContextSchema.optional(),
@@ -733,7 +733,7 @@ var connectionConfigPartialSchema = connectionConfigSchema.partial();
 // src/schema/deployment.ts
 import { z as z17 } from "zod";
 var serverConfigSchema = widgetSettingsSchema.partial().omit({ forms: true }).extend({
-  dataBaseUrl: z17.string().min(1).max(2048).optional()
+  dataApiBaseUrl: z17.string().min(1).max(2048).optional()
 });
 var siteConfigSchema = z17.object({
   title: z17.string().min(1).max(120).optional().describe("Brand / site name. Used as the logo's alt-text fallback."),

package/web-component.mjs

@@ -510,15 +510,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",
@@ -563,7 +563,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,
@@ -596,13 +596,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}/pai/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 ?? `${dataBaseUrl}/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)),
@@ -771,7 +771,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) {
@@ -831,8 +832,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 = [
@@ -1338,7 +1339,7 @@ var DEFAULT_PATHS = {
    * on the client; a failure just leaves the badge until the next sync.
    */
   markRead: "/pai/mark-read",
-  // ── Data API (module-help-ai-data-api, via `dataBaseUrl`) ─────────
+  // ── Data API (module-help-ai-data-api, via `dataApiBaseUrl`) ─────────
   /**
    * The data module's one ACTIVATION read. `GET
    * /pai/bootstrap?visitorId=…&conversationId=…` →
@@ -1435,6 +1436,7 @@ function messageToWireParts(m) {
 var log4 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var CONTENT_CACHE_TTL_MS = 6e4;
 var MAX_REQUEST_RETRIES = 3;
 var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
 function backoffMs(attempt) {
@@ -1473,6 +1475,20 @@ var AgentTransport = class {
     // always sees the visitor's latest context as they navigate.
     __publicField(this, "userContext");
     __publicField(this, "pageContext");
+    // ---- Data API (content / forms — module-help-ai-data-api) --------------
+    //
+    // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
+    // under the module's `/pai/*` group — 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 backend) is treated as "no content" by the module and the tab
+    // degrades gracefully.
+    // Per-query content cache: published content barely changes mid-visit, but
+    // every tab switch remounts its module and re-asks. Entries hold the
+    // REQUEST PROMISE (concurrent identical queries share one network call)
+    // and serve repeats for CONTENT_CACHE_TTL_MS; failures are evicted so the
+    // next ask retries.
+    __publicField(this, "contentCache", /* @__PURE__ */ new Map());
   }
   // ---- Public API -------------------------------------------------------
   /**
@@ -1629,16 +1645,22 @@ var AgentTransport = class {
       log4.debug("markRead failed (non-fatal)", { err });
     }
   }
-  // ---- Data API (content / forms — module-help-ai-data-api) --------------
-  //
-  // The DATA surfaces live on `dataBaseUrl` (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
-  // backend) is treated as "no content" by the module and the tab degrades
-  // gracefully.
-  /** Fetch content rows by filter. `GET /content` (data-API). */
-  async listContent(query = {}) {
+  /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
+  listContent(query = {}) {
+    const key = JSON.stringify(query, Object.keys(query).toSorted());
+    const cached = this.contentCache.get(key);
+    if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
+      log4.debug("listContent \u2192 cache", query);
+      return cached.result;
+    }
+    const result = this.fetchContent(query).catch((err) => {
+      this.contentCache.delete(key);
+      throw err;
+    });
+    this.contentCache.set(key, { at: Date.now(), result });
+    return result;
+  }
+  async fetchContent(query) {
     const url = new URL(this.dataUrl(DEFAULT_PATHS.content));
     for (const [key, value] of Object.entries(query)) {
       if (value === void 0) continue;
@@ -1944,7 +1966,7 @@ var AgentTransport = class {
    */
   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 /
@@ -1954,7 +1976,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);
@@ -6520,8 +6542,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,