@helpai/elements 0.59.2 → 0.59.4

package/schema.json

@@ -485,14 +485,9 @@
               "description": "Show the citation sources behind an answer (web links + document/file references) in the transcript. `false` (default) hides them.",
               "type": "boolean"
             },
-            "scrollFade": {
-              "default": true,
-              "description": "Fade the message list at its scroll edges with a soft gradient mask (the fade lifts at the very top/bottom). `true` (default) enables it; `false` shows hard edges.",
-              "type": "boolean"
-            },
-            "enableMessageFeedback": {
-              "default": true,
-              "description": "Show 👍/👎 feedback controls under each assistant reply. `true` (default) shows them. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
+            "disableMessageFeedback": {
+              "default": false,
+              "description": "Turn OFF the 👍/👎 feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
               "type": "boolean"
             }
           },
@@ -502,8 +497,7 @@
             "showReasoning",
             "showToolCalls",
             "showSources",
-            "scrollFade",
-            "enableMessageFeedback"
+            "disableMessageFeedback"
           ],
           "additionalProperties": {},
           "description": "Conversation behaviour — lifecycle, streaming, and the transcript surface (scroll, feedback).",
@@ -515,8 +509,7 @@
             {
               "startMinimized": false,
               "responseMode": "buffered",
-              "scrollFade": false,
-              "enableMessageFeedback": false
+              "disableMessageFeedback": true
             }
           ]
         },
@@ -1259,9 +1252,9 @@
         "features": {
           "type": "object",
           "properties": {
-            "files": {
-              "default": true,
-              "description": "Show the paperclip button + accept drag/drop/paste for file attachments.",
+            "disableFileUpload": {
+              "default": false,
+              "description": "Turn OFF file uploads — hide the paperclip button + reject drag/drop/paste. Unset/`false` = enabled (default), `true` = disabled.",
               "type": "boolean"
             },
             "voice": {
@@ -1309,30 +1302,28 @@
                 ]
               }
             },
-            "humanInLoop": {
-              "default": true,
-              "description": "Render human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. `true` (default) shows them; `false` suppresses the UI (the wire still carries the signals).",
+            "disableHumanInLoop": {
+              "default": false,
+              "description": "Turn OFF the human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. Unset/`false` = shown (default), `true` = suppressed (the wire still carries the signals).",
               "type": "boolean"
             }
           },
           "required": [
-            "files",
+            "disableFileUpload",
             "voice",
-            "humanInLoop"
+            "disableHumanInLoop"
           ],
           "additionalProperties": {},
           "description": "Capability flags — file upload, voice mode, and the tools the assistant may invoke.",
           "examples": [
             {
-              "files": true,
               "voice": "local"
             },
             {
-              "files": false,
+              "disableFileUpload": true,
               "voice": "disabled"
             },
             {
-              "files": true,
               "voice": "server",
               "tools": [
                 "tool:send-money"
@@ -1841,8 +1832,8 @@
                 "type": "string",
                 "maxLength": 80
               },
-              "showGreeting": {
-                "description": "`home` — show the greeting hero (default true).",
+              "hideGreeting": {
+                "description": "`home` — hide the greeting hero. Unset/`false` = shown (default), `true` = hidden.",
                 "type": "boolean"
               },
               "greetingText": {
@@ -1878,12 +1869,12 @@
                   "additionalProperties": {}
                 }
               },
-              "showSearchBar": {
-                "description": "`home` — show the 'Search for help' bar (default true).",
+              "hideSearchBar": {
+                "description": "`home` — hide the 'Search for help' bar. Unset/`false` = shown (default), `true` = hidden.",
                 "type": "boolean"
               },
-              "showRecentConversations": {
-                "description": "`home` — show the visitor's most recent conversation card (default true).",
+              "hideRecentConversations": {
+                "description": "`home` — hide the visitor's most recent conversation card. Unset/`false` = shown (default), `true` = hidden.",
                 "type": "boolean"
               },
               "status": {
@@ -1939,8 +1930,6 @@
                 "label": "tabHome",
                 "layout": "home",
                 "brandName": "Acme",
-                "showSearchBar": true,
-                "showRecentConversations": true,
                 "contentBlockTitle": "Popular articles",
                 "contentTags": [
                   "popular"
@@ -2357,14 +2346,9 @@
                   "description": "Show the citation sources behind an answer (web links + document/file references) in the transcript. `false` (default) hides them.",
                   "type": "boolean"
                 },
-                "scrollFade": {
-                  "default": true,
-                  "description": "Fade the message list at its scroll edges with a soft gradient mask (the fade lifts at the very top/bottom). `true` (default) enables it; `false` shows hard edges.",
-                  "type": "boolean"
-                },
-                "enableMessageFeedback": {
-                  "default": true,
-                  "description": "Show 👍/👎 feedback controls under each assistant reply. `true` (default) shows them. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
+                "disableMessageFeedback": {
+                  "default": false,
+                  "description": "Turn OFF the 👍/👎 feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`.",
                   "type": "boolean"
                 }
               },
@@ -2374,8 +2358,7 @@
                 "showReasoning",
                 "showToolCalls",
                 "showSources",
-                "scrollFade",
-                "enableMessageFeedback"
+                "disableMessageFeedback"
               ],
               "additionalProperties": {},
               "description": "Conversation behaviour — lifecycle, streaming, and the transcript surface (scroll, feedback).",
@@ -2387,8 +2370,7 @@
                 {
                   "startMinimized": false,
                   "responseMode": "buffered",
-                  "scrollFade": false,
-                  "enableMessageFeedback": false
+                  "disableMessageFeedback": true
                 }
               ]
             },
@@ -3131,9 +3113,9 @@
             "features": {
               "type": "object",
               "properties": {
-                "files": {
-                  "default": true,
-                  "description": "Show the paperclip button + accept drag/drop/paste for file attachments.",
+                "disableFileUpload": {
+                  "default": false,
+                  "description": "Turn OFF file uploads — hide the paperclip button + reject drag/drop/paste. Unset/`false` = enabled (default), `true` = disabled.",
                   "type": "boolean"
                 },
                 "voice": {
@@ -3181,30 +3163,28 @@
                     ]
                   }
                 },
-                "humanInLoop": {
-                  "default": true,
-                  "description": "Render human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. `true` (default) shows them; `false` suppresses the UI (the wire still carries the signals).",
+                "disableHumanInLoop": {
+                  "default": false,
+                  "description": "Turn OFF the human-in-the-loop tool UI — the inline ask-questions form + approve/reject controls for gated tools. Unset/`false` = shown (default), `true` = suppressed (the wire still carries the signals).",
                   "type": "boolean"
                 }
               },
               "required": [
-                "files",
+                "disableFileUpload",
                 "voice",
-                "humanInLoop"
+                "disableHumanInLoop"
               ],
               "additionalProperties": {},
               "description": "Capability flags — file upload, voice mode, and the tools the assistant may invoke.",
               "examples": [
                 {
-                  "files": true,
                   "voice": "local"
                 },
                 {
-                  "files": false,
+                  "disableFileUpload": true,
                   "voice": "disabled"
                 },
                 {
-                  "files": true,
                   "voice": "server",
                   "tools": [
                     "tool:send-money"
@@ -3253,8 +3233,8 @@
                     "type": "string",
                     "maxLength": 80
                   },
-                  "showGreeting": {
-                    "description": "`home` — show the greeting hero (default true).",
+                  "hideGreeting": {
+                    "description": "`home` — hide the greeting hero. Unset/`false` = shown (default), `true` = hidden.",
                     "type": "boolean"
                   },
                   "greetingText": {
@@ -3290,12 +3270,12 @@
                       "additionalProperties": {}
                     }
                   },
-                  "showSearchBar": {
-                    "description": "`home` — show the 'Search for help' bar (default true).",
+                  "hideSearchBar": {
+                    "description": "`home` — hide the 'Search for help' bar. Unset/`false` = shown (default), `true` = hidden.",
                     "type": "boolean"
                   },
-                  "showRecentConversations": {
-                    "description": "`home` — show the visitor's most recent conversation card (default true).",
+                  "hideRecentConversations": {
+                    "description": "`home` — hide the visitor's most recent conversation card. Unset/`false` = shown (default), `true` = hidden.",
                     "type": "boolean"
                   },
                   "status": {
@@ -3351,8 +3331,6 @@
                     "label": "tabHome",
                     "layout": "home",
                     "brandName": "Acme",
-                    "showSearchBar": true,
-                    "showRecentConversations": true,
                     "contentBlockTitle": "Popular articles",
                     "contentTags": [
                       "popular"

package/schema.mjs

@@ -131,16 +131,13 @@ var behaviorSchema = z4.object({
   showSources: z4.boolean().default(false).describe(
     "Show the citation sources behind an answer (web links + document/file references) in the transcript. `false` (default) hides them."
   ),
-  scrollFade: z4.boolean().default(true).describe(
-    "Fade the message list at its scroll edges with a soft gradient mask (the fade lifts at the very top/bottom). `true` (default) enables it; `false` shows hard edges."
-  ),
-  enableMessageFeedback: z4.boolean().default(true).describe(
-    "Show \u{1F44D}/\u{1F44E} feedback controls under each assistant reply. `true` (default) shows them. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`."
+  disableMessageFeedback: z4.boolean().default(false).describe(
+    "Turn OFF the \u{1F44D}/\u{1F44E} feedback controls under each assistant reply. Unset/`false` = shown (default), `true` = hidden. A choice fires the `messageFeedback` event and is POSTed best-effort to `/pai/message-feedback`."
   )
 }).loose().describe("Conversation behaviour \u2014 lifecycle, streaming, and the transcript surface (scroll, feedback).").meta({
   examples: [
     { startMinimized: true, responseMode: "streaming" },
-    { startMinimized: false, responseMode: "buffered", scrollFade: false, enableMessageFeedback: false }
+    { startMinimized: false, responseMode: "buffered", disableMessageFeedback: true }
   ]
 });
 
@@ -224,21 +221,23 @@ var toolRefSchema = z7.union([
   }).loose()
 ]);
 var featureFlagsSchema = z7.object({
-  files: z7.boolean().default(true).describe("Show the paperclip button + accept drag/drop/paste for file attachments."),
+  disableFileUpload: z7.boolean().default(false).describe(
+    "Turn OFF file uploads \u2014 hide the paperclip button + reject drag/drop/paste. Unset/`false` = enabled (default), `true` = disabled."
+  ),
   voice: voiceModeSchema.default("local").describe(
     "Voice input mode. `local` \u2014 Web Speech API in the browser (free, runs on-device). `server` \u2014 record audio + upload to the transcribe endpoint. `disabled` \u2014 hide the mic button."
   ),
   tools: z7.array(toolRefSchema).max(200).optional().describe(
     "Backend tools the assistant may invoke. Bare codes (`'tool:send-money'`) or rich refs (`{ code, config }`)."
   ),
-  humanInLoop: z7.boolean().default(true).describe(
-    "Render human-in-the-loop tool UI \u2014 the inline ask-questions form + approve/reject controls for gated tools. `true` (default) shows them; `false` suppresses the UI (the wire still carries the signals)."
+  disableHumanInLoop: z7.boolean().default(false).describe(
+    "Turn OFF the human-in-the-loop tool UI \u2014 the inline ask-questions form + approve/reject controls for gated tools. Unset/`false` = shown (default), `true` = suppressed (the wire still carries the signals)."
   )
 }).loose().describe("Capability flags \u2014 file upload, voice mode, and the tools the assistant may invoke.").meta({
   examples: [
-    { files: true, voice: "local" },
-    { files: false, voice: "disabled" },
-    { files: true, voice: "server", tools: ["tool:send-money"] }
+    { voice: "local" },
+    { disableFileUpload: true, voice: "disabled" },
+    { voice: "server", tools: ["tool:send-money"] }
   ]
 });
 
@@ -551,7 +550,7 @@ var moduleSchema = z14.object({
   ),
   // ── `home` layout config (flat feature flags — no block authoring) ──────
   brandName: z14.string().max(80).optional().describe("`home` \u2014 hero wordmark (e.g. your company name)."),
-  showGreeting: z14.boolean().optional().describe("`home` \u2014 show the greeting hero (default true)."),
+  hideGreeting: z14.boolean().optional().describe("`home` \u2014 hide the greeting hero. Unset/`false` = shown (default), `true` = hidden."),
   greetingText: z14.string().max(280).optional().describe("`home` \u2014 override the greeting headline (default 'How can we help?'); supports a `{name}` token."),
   userAvatars: z14.array(
     z14.object({
@@ -560,8 +559,10 @@ var moduleSchema = z14.object({
       role: z14.string().max(80).optional()
     }).loose()
   ).max(10).optional().describe("`home` \u2014 team/agent avatars shown in the hero."),
-  showSearchBar: z14.boolean().optional().describe("`home` \u2014 show the 'Search for help' bar (default true)."),
-  showRecentConversations: z14.boolean().optional().describe("`home` \u2014 show the visitor's most recent conversation card (default true)."),
+  hideSearchBar: z14.boolean().optional().describe("`home` \u2014 hide the 'Search for help' bar. Unset/`false` = shown (default), `true` = hidden."),
+  hideRecentConversations: z14.boolean().optional().describe(
+    "`home` \u2014 hide the visitor's most recent conversation card. Unset/`false` = shown (default), `true` = hidden."
+  ),
   status: z14.object({
     text: z14.string().min(1).max(120).optional().describe(
       "`home` \u2014 status line; an i18n key or a literal (resolved via `localizeText`). Omit to use the built-in generic `homeStatus` string (localized, no custom key needed)."
@@ -583,8 +584,6 @@ var modulesSchema = z14.array(moduleSchema).max(4).describe(
         label: "tabHome",
         layout: "home",
         brandName: "Acme",
-        showSearchBar: true,
-        showRecentConversations: true,
         contentBlockTitle: "Popular articles",
         contentTags: ["popular"]
       },
@@ -730,7 +729,7 @@ var widgetSettingsSchema = z16.object({
     {
       presentation: { mode: "inline" },
       behavior: { responseMode: "streaming" },
-      features: { files: true, voice: "local" }
+      features: { voice: "local" }
     }
   ]
 });

package/web-component.mjs

@@ -1010,9 +1010,7 @@ var DEFAULT_ATTACHMENTS = {
   accept: "*/*"
 };
 var DEFAULT_FEATURES = {
-  files: true,
-  voice: "local",
-  humanInLoop: true
+  voice: "local"
 };
 var DEFAULT_FORMS = { list: [], byTrigger: {} };
 var DEFAULT_TRACKING = {
@@ -1049,7 +1047,6 @@ var DEFAULT_HAPTICS = {
   events: void 0
 };
 var DEFAULT_MODULES = [{ label: "tabConversations", layout: "chat" }];
-var DEFAULT_HOME_MODULE = { showSearchBar: true };
 
 // src/core/config/resolve.ts
 function resolveOptions(rawOpts) {
@@ -1088,12 +1085,11 @@ function resolveOptions(rawOpts) {
     showReasoning: behavior.showReasoning ?? false,
     showToolCalls: behavior.showToolCalls ?? false,
     showSources: behavior.showSources ?? false,
-    scrollFade: behavior.scrollFade ?? true,
-    enableMessageFeedback: behavior.enableMessageFeedback ?? true,
+    enableMessageFeedback: !(behavior.disableMessageFeedback ?? false),
     features: {
-      files: opts.features?.files ?? DEFAULT_FEATURES.files,
       voice: opts.features?.voice ?? DEFAULT_FEATURES.voice,
-      humanInLoop: opts.features?.humanInLoop ?? DEFAULT_FEATURES.humanInLoop,
+      fileUpload: !(opts.features?.disableFileUpload ?? false),
+      humanInLoop: !(opts.features?.disableHumanInLoop ?? false),
       tools: opts.features?.tools
     },
     forms: resolveForms(opts.forms, locale),
@@ -1207,9 +1203,9 @@ function resolveModules(overrides) {
     if (m.layout === "home") {
       resolved.brandName = m.brandName;
       resolved.greetingText = m.greetingText;
-      resolved.showGreeting = m.showGreeting ?? true;
-      resolved.showSearchBar = m.showSearchBar ?? DEFAULT_HOME_MODULE.showSearchBar;
-      resolved.showRecentConversations = m.showRecentConversations ?? true;
+      resolved.showGreeting = !(m.hideGreeting ?? false);
+      resolved.showSearchBar = !(m.hideSearchBar ?? false);
+      resolved.showRecentConversations = !(m.hideRecentConversations ?? false);
       if (m.userAvatars && m.userAvatars.length > 0) resolved.userAvatars = m.userAvatars;
       if (m.status) resolved.status = m.status;
       resolved.contentBlockTitle = m.contentBlockTitle;
@@ -1418,8 +1414,7 @@ var BEHAVIOR_ATTRS = [
   ["show-reasoning", "showReasoning", boolAttr],
   ["show-tool-calls", "showToolCalls", boolAttr],
   ["show-sources", "showSources", boolAttr],
-  ["scroll-fade", "scrollFade", boolAttr],
-  ["enable-message-feedback", "enableMessageFeedback", boolAttr]
+  ["disable-message-feedback", "disableMessageFeedback", boolAttr]
 ];
 var I18N_ATTRS = [["locale", "locale"]];
 var ACTION_NAMES = new Set(ACTION_NAME_LITERALS);
@@ -1431,7 +1426,7 @@ var LAUNCHER_ATTRS = [
   ["launcher-hidden", "hidden", boolAttr]
 ];
 var FEATURE_ATTRS = [
-  ["features-files", "files", boolAttr],
+  ["features-disable-file-upload", "disableFileUpload", boolAttr],
   ["features-voice", "voice", (v) => v],
   ["features-tools", "tools", csv]
 ];
@@ -1934,7 +1929,7 @@ function createAuth(opts) {
 }
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.59.2" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.4" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/stream/types.ts
@@ -4460,7 +4455,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
   const [voiceOn, setVoiceOn] = useState2(false);
   const taRef = useRef2(null);
   const fileRef = useRef2(null);
-  const filesEnabled = options.features.files;
+  const fileUploadEnabled = options.features.fileUpload;
   const voiceMode = options.features.voice;
   const [voice, setVoice] = useState2(
     () => createVoice(voiceMode, options.locale, (blob, type) => transport.transcribe(blob, type))
@@ -4517,7 +4512,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
         "input, textarea, [contenteditable]:not([contenteditable='false'])"
       );
       if (editable && editable !== ta) return;
-      if (filesEnabled) {
+      if (fileUploadEnabled) {
         const result = ingest(data.items, attsRef.current, options.attachments);
         if (result.accepted.length > 0) {
           e.preventDefault();
@@ -4536,7 +4531,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
     };
     panel.addEventListener("paste", onPaste);
     return () => panel.removeEventListener("paste", onPaste);
-  }, [filesEnabled, options.attachments, p7]);
+  }, [fileUploadEnabled, options.attachments, p7]);
   const send = () => {
     const trimmed = text.trim();
     if (!trimmed && atts.length === 0) return;
@@ -4606,7 +4601,7 @@ function Composer({ options, transport, feedback, bus, isStreaming, onSend, onSt
     atts.length > 0 ? /* @__PURE__ */ jsx6("div", { class: `${p7}-attachments`, children: atts.map((a) => /* @__PURE__ */ jsx6(AttachmentChip, { attachment: a, onRemove: () => removeAtt(a.id) }, a.id)) }) : null,
     /* @__PURE__ */ jsxs5("div", { class: `${p7}-composer-row`, children: [
       /* @__PURE__ */ jsxs5("div", { class: `${p7}-composer-actions`, children: [
-        filesEnabled ? /* @__PURE__ */ jsx6(
+        fileUploadEnabled ? /* @__PURE__ */ jsx6(
           "button",
           {
             type: "button",
@@ -6363,7 +6358,6 @@ function MessageList({
   showReasoning,
   showToolCalls,
   showSources,
-  scrollFade,
   enableMessageFeedback,
   onFeedback,
   loading,
@@ -6384,7 +6378,6 @@ function MessageList({
   const inInteractionGrace = () => interactingRef.current || performance.now() - interactionEndedAtRef.current < INTERACTION_GRACE_MS;
   const autoPinAtRef = useRef5(0);
   const syncFade = (el) => {
-    if (!scrollFade) return;
     const overflowing = el.scrollHeight - el.clientHeight > 1;
     el.dataset.fadeTop = overflowing && el.scrollTop > 1 ? "true" : "false";
     el.dataset.fadeBottom = overflowing && el.scrollHeight - el.scrollTop - el.clientHeight > 1 ? "true" : "false";
@@ -6630,21 +6623,11 @@ function MessageList({
     rows.push(markerRow(marker));
   }
   return /* @__PURE__ */ jsxs16("div", { class: `${p18}-list-wrap`, children: [
-    /* @__PURE__ */ jsxs16(
-      "div",
-      {
-        ref,
-        class: `${p18}-list${scrollFade ? ` ${p18}-list--fade` : ""}`,
-        role: "log",
-        "aria-live": "polite",
-        "aria-relevant": "additions text",
-        children: [
-          loading && messages.value.length === 0 ? /* @__PURE__ */ jsx20("div", { class: `${p18}-list-loading`, role: "status", children: strings.conversationLoading }) : null,
-          rows,
-          form && !inlineForm ? /* @__PURE__ */ jsx20(FormGate, { form: form.form, strings, onSubmit: form.onSubmit, onSkip: form.onSkip }) : null
-        ]
-      }
-    ),
+    /* @__PURE__ */ jsxs16("div", { ref, class: `${p18}-list ${p18}-list--fade`, role: "log", "aria-live": "polite", "aria-relevant": "additions text", children: [
+      loading && messages.value.length === 0 ? /* @__PURE__ */ jsx20("div", { class: `${p18}-list-loading`, role: "status", children: strings.conversationLoading }) : null,
+      rows,
+      form && !inlineForm ? /* @__PURE__ */ jsx20(FormGate, { form: form.form, strings, onSubmit: form.onSubmit, onSkip: form.onSkip }) : null
+    ] }),
     showJump ? /* @__PURE__ */ jsx20(
       "button",
       {
@@ -7013,7 +6996,6 @@ function PanelContent(props2) {
           showReasoning: options.showReasoning,
           showToolCalls: options.showToolCalls,
           showSources: options.showSources,
-          scrollFade: options.scrollFade,
           enableMessageFeedback: options.enableMessageFeedback,
           onFeedback: onMessageFeedback,
           loading: loadingMessages,
@@ -7560,7 +7542,7 @@ function HomeRoot(props2) {
   const [content, setContent] = useState12([]);
   const tagsKey = config.contentTags?.join(",");
   useEffect11(() => {
-    if (!config.showRecentConversations) return;
+    if (config.showRecentConversations === false) return;
     let cancelled = false;
     transport.listConversations({ limit: 1 }).then((res) => !cancelled && setRecent(res.conversations?.[0] ?? null)).catch((err) => !cancelled && log13.warn("listConversations (home) failed", { err }));
     return () => {