@helpai/elements 0.23.0 → 0.25.0

package/README.md

@@ -335,7 +335,7 @@ mount({
   publicKey: "agent_pk_...",
   aiAgentDeploymentId: "...",
   presentation: { mode: "floating" },
-  baseUrl: "https://help.ai/api",    // omit to use the brand default
+  baseUrl: "https://help.ai",    // omit to use the brand default
   user: { id: "u_123", email: "alice@help.ai" },
   theme: "dark",                   // "auto" | "light" | "dark" | overrides object
   i18n: { defaultLocale: "en" },

package/configurator.mjs

@@ -432,6 +432,12 @@ var formDefSchema = z12.object({
   frequency: z12.enum(["once", "conversation", "always"]).default("once").describe("`once` (per device, persisted), `conversation` (re-eligible each new conversation), or `always`."),
   mirrorToContext: z12.boolean().default(true).describe(
     "Mirror the answers into `userContext` so they ride every request. Set `false` for PII (DOB, policy #, symptoms) \u2014 those then go only to the submit endpoint."
+  ),
+  reopenable: z12.boolean().default(true).describe(
+    'Skipped marker offers a "Fill out" button that reopens the form. Set `false` when a skip must be final (e.g. a consent ask that should not be re-surfaced).'
+  ),
+  reviewable: z12.boolean().default(true).describe(
+    "Submitted marker expands in place to a read-only list of the visitor's answers. Set `false` for sensitive answers that shouldn't linger on screen."
   )
 }).loose();
 var formsSchema = z12.array(formDefSchema).max(20).describe(
@@ -514,7 +520,7 @@ var moduleSchema = z14.object({
     "UI layout that renders this tab: `chat` (the conversation), `home`, `help`, or `news`."
   ),
   contentTags: z14.array(z14.string().max(60)).max(20).optional().describe(
-    "Content tags this tab scopes to \u2014 the `tags` filter on `GET /ai/agent/content` (matches content tagged with ANY of them). Omit for the `chat` layout."
+    "Content tags this tab scopes to \u2014 the `tags` filter on `GET /content` (matches content tagged with ANY of them). Omit for the `chat` layout."
   ),
   id: z14.string().max(60).optional().describe(
     "Stable id for navigation + last-tab persistence. Defaults to the first `contentTags` entry, else `layout`."
@@ -567,7 +573,9 @@ var modulesSchema = z14.array(moduleSchema).max(4).describe(
 import { z as z15 } from "zod";
 var trackingSchema = z15.object({
   enabled: z15.boolean().optional().describe("Master switch. Default `false` \u2014 no hits are sent until the deployment turns tracking on."),
-  endpoint: z15.url().max(2048).optional().describe("Pixel collector URL. Default: `https://t.<brand domain>/api/ai-elements/px.gif`. Must be a full URL."),
+  endpoint: z15.url().max(2048).optional().describe(
+    "Pixel collector URL. Default: `${dataBaseUrl}/elements/px.gif` (e.g. `https://help.ai/api/data/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(
     "Anti-forgery token, echoed as `tk=` on every hit. Server-issued in the `/start-conversation` response \u2014 never set by hand (see `docs/api/tracking-collector.md`)."
@@ -582,10 +590,12 @@ var trackingSchema = z15.object({
 var endpointsSchema = z16.object({
   upload: z16.string().min(1).max(2048).default("/ai/agent/upload-file"),
   transcribe: z16.string().min(1).max(2048).default("/ai/agent/transcribe-audio"),
-  submitForm: z16.string().min(1).max(2048).default("/ai/agent/submit-form").describe(
+  submitForm: z16.string().min(1).max(2048).default("/submit-form").describe(
     "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. Paths are appended to baseUrl; absolute URLs are accepted too.").meta({
+}).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."
+).meta({
   examples: [
     { upload: "/ai/agent/upload-file", transcribe: "/ai/agent/transcribe-audio" },
     { upload: "https://help.ai/uploads/presign" },
@@ -634,7 +644,10 @@ var connectionConfigSchema = z16.object({
     "Deployment UUID from the dashboard. Picks which agent / settings bundle answers this mount. Sent as `x-ai-agent-deployment-id`."
   ),
   baseUrl: z16.string().min(1).max(2048).optional().describe(
-    "Full backend origin (e.g. `https://help.ai/api`). Set this to point at your staging / self-hosted / custom backend. Default: the brand's `defaultBaseUrl` baked at build time."
+    "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."
+  ),
+  dataBaseUrl: z16.string().min(1).max(2048).optional().describe(
+    "Full data-API base (e.g. `https://help.ai/api/data`) \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`)."
   ),
   userContext: userContextSchema.optional(),
   pageContext: pageContextSchema.optional(),
@@ -719,7 +732,9 @@ var connectionConfigPartialSchema = connectionConfigSchema.partial();
 
 // src/schema/deployment.ts
 import { z as z17 } from "zod";
-var serverConfigSchema = widgetSettingsSchema.partial();
+var serverConfigSchema = widgetSettingsSchema.partial().omit({ forms: true }).extend({
+  dataBaseUrl: 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."),
   logo: assetSchema.optional().describe("Brand logo shown at the top of the page-mode sidebar."),
@@ -778,20 +793,6 @@ var startConversationResponseSchema = z17.object({
   conversationId: z17.string(),
   canContinue: z17.boolean(),
   messages: z17.array(z17.unknown()),
-  /**
-   * Form submissions recorded for this conversation — echoed like
-   * `messages` so the widget reconstructs the collapsed "form submitted"
-   * timeline markers on resume. `createdAt` is ISO-8601 (a serialized
-   * Mongo ISODate — same format as message `createdAt`).
-   */
-  formSubmissions: z17.array(
-    z17.object({
-      formId: z17.string(),
-      trigger: z17.string(),
-      skipped: z17.boolean().optional(),
-      createdAt: z17.iso.datetime().optional()
-    }).loose()
-  ).optional(),
   /**
    * Per-visitor preferences (locale picker, theme picker, sound
    * mute, dragged panel size). Distinct from `config` — this is