@helpai/elements 0.14.2 → 0.16.0

package/configurator.mjs

@@ -132,7 +132,7 @@ var behaviorSchema = z4.object({
     "Show tool/function calls the model makes (e.g. search) as inline chips in the transcript. `false` (default) hides them."
   ),
   popOutUrl: z4.string().min(1).max(2048).optional().describe(
-    "URL the `popOut` action opens in a new tab (carries `?chat=<id>&widgetId=<id>` query params). Falls back to the brand's build-time default. Set this to point at your own dedicated chat page (e.g. `https://app.acme.com/chat`). Server-pushable on `/start-conversation.widget.behavior.popOutUrl`."
+    "URL the `popOut` action opens in a new tab (carries `?conversation=<id>&widgetId=<id>` query params). Falls back to the brand's build-time default. Set this to point at your own dedicated chat page (e.g. `https://app.acme.com/chat`). Server-pushable on `/start-conversation.widget.behavior.popOutUrl`."
   )
 }).loose().describe("Lifecycle + streaming behaviour. Doesn't affect visual presentation.").meta({
   examples: [
@@ -251,10 +251,11 @@ var actionNameSchema = z8.enum([
   "history",
   "language",
   "theme",
+  "textSize",
   "close"
 ]);
-var headerActionsSchema = z8.array(actionNameSchema).max(9).describe(
-  "Which actions the header exposes. `history` + `close` are dedicated buttons; the rest appear in the \u22EF menu. Unlisted actions are hidden; order is irrelevant. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `close`. Per-mode defaults live in `DEFAULT_ACTIONS_BY_MODE`."
+var headerActionsSchema = z8.array(actionNameSchema).max(10).describe(
+  "Which actions the header exposes. `history` + `close` are dedicated buttons; the rest appear in the \u22EF menu. Unlisted actions are hidden; order is irrelevant. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `textSize`, `close`. Per-mode defaults live in `DEFAULT_ACTIONS_BY_MODE`."
 ).meta({
   examples: [
     ["theme", "history", "close", "clear", "fullscreen", "popOut", "sound", "language"],
@@ -542,7 +543,7 @@ var moduleSchema = z15.object({
     }).loose()
   ).max(10).optional().describe("`home` \u2014 team/agent avatars shown in the hero."),
   showSearchBar: z15.boolean().optional().describe("`home` \u2014 show the 'Search for help' bar (default true)."),
-  showRecentMessages: z15.boolean().optional().describe("`home` \u2014 show the visitor's most recent conversation card (default true)."),
+  showRecentConversations: z15.boolean().optional().describe("`home` \u2014 show the visitor's most recent conversation card (default true)."),
   status: z15.object({
     text: z15.string().min(1).max(120),
     level: z15.string().max(40).optional().describe(
@@ -556,18 +557,18 @@ var modulesSchema = z15.array(moduleSchema).max(4).describe(
   "Messenger tabs \u2014 an ordered list of up to 4 tabs, each picking a `layout` + optional content `contentTags` (the content scope) + a translatable `label`. One tab \u2192 no tab bar (just that content); zero \u2192 an empty state. Floating / drawer / modal only."
 ).meta({
   examples: [
-    [{ label: "tabMessages", layout: "chat" }],
+    [{ label: "tabConversations", layout: "chat" }],
     [
       {
         label: "tabHome",
         layout: "home",
         brandName: "Acme",
         showSearchBar: true,
-        showRecentMessages: true,
+        showRecentConversations: true,
         contentBlockTitle: "Popular articles",
         contentTags: ["popular"]
       },
-      { label: "tabMessages", layout: "chat" },
+      { label: "tabConversations", layout: "chat" },
       { label: "tabHelp", layout: "help", contentTags: ["help", "guides"] },
       { label: "tabNews", layout: "news", contentTags: ["news"] }
     ]
@@ -774,6 +775,20 @@ 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 epoch ms (same clock as
+   * message `createdAt`).
+   */
+  formSubmissions: z17.array(
+    z17.object({
+      formId: z17.string(),
+      trigger: z17.string(),
+      skipped: z17.boolean().optional(),
+      createdAt: z17.number().optional()
+    }).loose()
+  ).optional(),
   /**
    * Per-visitor preferences (locale picker, theme picker, sound
    * mute, dragged panel size). Distinct from `config` — this is