@helpai/elements 0.59.3 → 0.59.4

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-Crtq-vQg.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-Bqqyxer1.js';
 import 'zod';
 
 /**
@@ -304,8 +304,6 @@ type ActionList = ActionName[];
 type VoiceMode = "local" | "server" | "disabled";
 /** Capability flags. Any field left `undefined` uses its default. */
 interface FeatureFlags {
-    /** Show the paperclip button + accept drag/drop/paste. Default: `true`. */
-    files?: boolean;
     /** Voice input behaviour (see {@link VoiceMode}). Default: `'local'`. */
     voice?: VoiceMode;
     /**
@@ -315,11 +313,26 @@ interface FeatureFlags {
      */
     tools?: Array<string | ToolRef>;
     /**
-     * Render human-in-the-loop tool UI — the inline ask-questions form and the
-     * approve/reject controls for gated tools. Default `true`. Set `false` to
-     * suppress them (the wire still carries the signals; they just won't show).
+     * Turn OFF the human-in-the-loop tool UI — the inline ask-questions form and the
+     * approve/reject controls for gated tools. Unset/`false` = shown (default); `true`
+     * suppresses the UI (the wire still carries the signals; they just won't show).
      */
     disableHumanInLoop?: boolean;
+    /**
+     * Turn OFF file uploads — hide the paperclip button + reject drag/drop/paste.
+     * Unset/`false` = enabled (default); `true` disables them.
+     */
+    disableFileUpload?: boolean;
+}
+/**
+ * Features after resolution. The UI reads a POSITIVE `humanInLoop` — `resolveOptions`
+ * inverts the wire-input `disableHumanInLoop` once here, so no render site does `!disable…`.
+ */
+interface ResolvedFeatures {
+    fileUpload: boolean;
+    voice: VoiceMode;
+    humanInLoop: boolean;
+    tools?: Array<string | ToolRef>;
 }
 /**
  * Client-side attachment limits. Server enforcement is still required —
@@ -715,8 +728,12 @@ interface ModuleOptions extends HomeConfig {
 }
 /** The `modules` block is an ordered list of tabs (max 4). */
 type ModulesOptions = ModuleOptions[];
-/** A resolved tab (stable `id` filled, defaults applied). */
-interface ResolvedModule extends HomeConfig {
+/**
+ * A resolved tab (stable `id` filled, defaults applied). The `home` boolean flags are POSITIVE
+ * (`showGreeting`/`showSearchBar`/`showRecentConversations`) — `resolveModules` inverts the wire-input
+ * `hide*` once, so no render site does `!hide…`. Present only for `home` tabs.
+ */
+interface ResolvedModule extends Omit<HomeConfig, "hideGreeting" | "hideSearchBar" | "hideRecentConversations"> {
     /** Stable id for nav + last-tab persistence (`id` ?? first `contentTags` ?? `layout`, deduped). */
     id: string;
     /** i18n key or literal — resolved at render via the i18n strings. */
@@ -724,6 +741,9 @@ interface ResolvedModule extends HomeConfig {
     layout: ModuleLayout;
     /** Content tag scope — the `tags` filter (omitted for `chat`). */
     contentTags?: string[];
+    showGreeting?: boolean;
+    showSearchBar?: boolean;
+    showRecentConversations?: boolean;
 }
 /** Fully-resolved modules block exposed on {@link ResolvedOptions}. */
 interface ResolvedModules {
@@ -847,8 +867,6 @@ interface BehaviorOptions {
     showToolCalls?: boolean;
     /** Show citation sources (web links + document references) in the transcript. Default `false`. */
     showSources?: boolean;
-    /** Fade the message list at its scroll edges (gradient mask). Default `true`. */
-    scrollFade?: boolean;
     /** Turn OFF the 👍/👎 feedback controls on assistant replies. Unset/`false` = shown (default). */
     disableMessageFeedback?: boolean;
 }
@@ -1165,13 +1183,9 @@ interface ResolvedOptions {
     showToolCalls: boolean;
     /** Show citation sources (web links + document references) in the transcript. Default `false`. */
     showSources: boolean;
-    /** Fade the message list at its scroll edges (gradient mask). Default `true`. */
-    scrollFade: boolean;
     /** Show 👍/👎 feedback controls on assistant replies. Default `true`. */
     enableMessageFeedback: boolean;
-    features: Required<Omit<FeatureFlags, "tools">> & {
-        tools?: Array<string | ToolRef>;
-    };
+    features: ResolvedFeatures;
     /** Resolved event-driven forms — ordered list + trigger index. */
     forms: ResolvedForms;
     endpoints: Required<Endpoints>;

package/index.mjs

@@ -29,7 +29,7 @@ var BRAND = {
 };
 
 // src/core/version.ts
-var ELEMENTS_VERSION = true ? "0.59.3" : "0.0.0-dev";
+var ELEMENTS_VERSION = true ? "0.59.4" : "0.0.0-dev";
 var ELEMENTS_VERSION_PARAM = "_ev";
 
 // src/i18n/strings.ts
@@ -1029,9 +1029,7 @@ var DEFAULT_ATTACHMENTS = {
   accept: "*/*"
 };
 var DEFAULT_FEATURES = {
-  files: true,
-  voice: "local",
-  disableHumanInLoop: false
+  voice: "local"
 };
 var DEFAULT_FORMS = { list: [], byTrigger: {} };
 var DEFAULT_TRACKING = {
@@ -1106,12 +1104,11 @@ function resolveOptions(rawOpts) {
     showReasoning: behavior.showReasoning ?? false,
     showToolCalls: behavior.showToolCalls ?? false,
     showSources: behavior.showSources ?? false,
-    scrollFade: behavior.scrollFade ?? true,
     enableMessageFeedback: !(behavior.disableMessageFeedback ?? false),
     features: {
-      files: opts.features?.files ?? DEFAULT_FEATURES.files,
       voice: opts.features?.voice ?? DEFAULT_FEATURES.voice,
-      disableHumanInLoop: opts.features?.disableHumanInLoop ?? false,
+      fileUpload: !(opts.features?.disableFileUpload ?? false),
+      humanInLoop: !(opts.features?.disableHumanInLoop ?? false),
       tools: opts.features?.tools
     },
     forms: resolveForms(opts.forms, locale),
@@ -1225,9 +1222,9 @@ function resolveModules(overrides) {
     if (m.layout === "home") {
       resolved.brandName = m.brandName;
       resolved.greetingText = m.greetingText;
-      resolved.hideGreeting = m.hideGreeting ?? false;
-      resolved.hideSearchBar = m.hideSearchBar ?? false;
-      resolved.hideRecentConversations = m.hideRecentConversations ?? false;
+      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;
@@ -1436,7 +1433,6 @@ var BEHAVIOR_ATTRS = [
   ["show-reasoning", "showReasoning", boolAttr],
   ["show-tool-calls", "showToolCalls", boolAttr],
   ["show-sources", "showSources", boolAttr],
-  ["scroll-fade", "scrollFade", boolAttr],
   ["disable-message-feedback", "disableMessageFeedback", boolAttr]
 ];
 var I18N_ATTRS = [["locale", "locale"]];
@@ -1448,7 +1444,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]
 ];
@@ -4500,7 +4496,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))
@@ -4557,7 +4553,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();
@@ -4576,7 +4572,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;
@@ -4646,7 +4642,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",
@@ -6403,7 +6399,6 @@ function MessageList({
   showReasoning,
   showToolCalls,
   showSources,
-  scrollFade,
   enableMessageFeedback,
   onFeedback,
   loading,
@@ -6424,7 +6419,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";
@@ -6670,21 +6664,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",
       {
@@ -7053,7 +7037,6 @@ function PanelContent(props2) {
           showReasoning: options.showReasoning,
           showToolCalls: options.showToolCalls,
           showSources: options.showSources,
-          scrollFade: options.scrollFade,
           enableMessageFeedback: options.enableMessageFeedback,
           onFeedback: onMessageFeedback,
           loading: loadingMessages,
@@ -7600,13 +7583,13 @@ function HomeRoot(props2) {
   const [content, setContent] = useState12([]);
   const tagsKey = config.contentTags?.join(",");
   useEffect11(() => {
-    if (config.hideRecentConversations) return;
+    if (config.showRecentConversations === false) return;
     let cancelled = false;
     transport.listConversations({ limit: 1 }).then((res) => !cancelled && setRecent(res.conversations?.[0] ?? null)).catch((err) => !cancelled && log14.warn("listConversations (home) failed", { err }));
     return () => {
       cancelled = true;
     };
-  }, [transport, config.hideRecentConversations]);
+  }, [transport, config.showRecentConversations]);
   useEffect11(() => {
     if (!config.contentTags?.length) return;
     let cancelled = false;
@@ -7634,13 +7617,13 @@ function HomeRoot(props2) {
           /* @__PURE__ */ jsx32(HeaderActions, { panelProps, variant: "plain" })
         ] })
       ] }),
-      !config.hideGreeting ? /* @__PURE__ */ jsxs26(Fragment7, { children: [
+      config.showGreeting !== false ? /* @__PURE__ */ jsxs26(Fragment7, { children: [
         /* @__PURE__ */ jsx32("h1", { class: `${p28}-home-greeting`, "data-testid": TID.homeGreeting, children: greeting.title }),
         greeting.subtitle ? /* @__PURE__ */ jsx32("p", { class: `${p28}-home-lead`, children: greeting.subtitle }) : null
       ] }) : null
     ] }),
     /* @__PURE__ */ jsxs26("div", { class: `${p28}-home-cards`, children: [
-      !config.hideSearchBar ? /* @__PURE__ */ jsx32(
+      config.showSearchBar !== false ? /* @__PURE__ */ jsx32(
         HomeSearchButton,
         {
           placeholder: strings.homeSearchPlaceholder,
@@ -8793,12 +8776,12 @@ function App({ options, hostElement, bus }) {
   );
   const toolInteraction = useMemo3(
     () => ({
-      humanInLoop: !options.features.disableHumanInLoop,
+      humanInLoop: options.features.humanInLoop,
       onResult: handleToolResult,
       onDecision: handleToolDecision,
       onEdit: handleToolEdit
     }),
-    [options.features.disableHumanInLoop, handleToolResult, handleToolDecision, handleToolEdit]
+    [options.features.humanInLoop, handleToolResult, handleToolDecision, handleToolEdit]
   );
   const userMessageCount = () => messagesSig.value.reduce((n, m) => n + (m.role === "user" ? 1 : 0), 0);
   const effectiveForms = options.forms.list.length > 0 ? options.forms : remoteForms ?? options.forms;

package/package.json

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

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-Crtq-vQg.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-Bqqyxer1.js';
 import { z } from 'zod';
 
 /**
@@ -84,7 +84,6 @@ declare const behaviorSchema: z.ZodObject<{
     showReasoning: z.ZodDefault<z.ZodBoolean>;
     showToolCalls: z.ZodDefault<z.ZodBoolean>;
     showSources: z.ZodDefault<z.ZodBoolean>;
-    scrollFade: z.ZodDefault<z.ZodBoolean>;
     disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
 type Behavior = z.infer<typeof behaviorSchema>;
@@ -298,7 +297,7 @@ declare const toolRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$loose>]>;
 declare const featureFlagsSchema: z.ZodObject<{
-    files: z.ZodDefault<z.ZodBoolean>;
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
     voice: z.ZodDefault<z.ZodEnum<{
         server: "server";
         local: "local";

package/schema.json

@@ -485,11 +485,6 @@
               "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"
-            },
             "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`.",
@@ -502,7 +497,6 @@
             "showReasoning",
             "showToolCalls",
             "showSources",
-            "scrollFade",
             "disableMessageFeedback"
           ],
           "additionalProperties": {},
@@ -515,7 +509,6 @@
             {
               "startMinimized": false,
               "responseMode": "buffered",
-              "scrollFade": 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": {
@@ -1316,7 +1309,7 @@
             }
           },
           "required": [
-            "files",
+            "disableFileUpload",
             "voice",
             "disableHumanInLoop"
           ],
@@ -1324,15 +1317,13 @@
           "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"
@@ -2355,11 +2346,6 @@
                   "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"
-                },
                 "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`.",
@@ -2372,7 +2358,6 @@
                 "showReasoning",
                 "showToolCalls",
                 "showSources",
-                "scrollFade",
                 "disableMessageFeedback"
               ],
               "additionalProperties": {},
@@ -2385,7 +2370,6 @@
                 {
                   "startMinimized": false,
                   "responseMode": "buffered",
-                  "scrollFade": false,
                   "disableMessageFeedback": true
                 }
               ]
@@ -3129,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": {
@@ -3186,7 +3170,7 @@
                 }
               },
               "required": [
-                "files",
+                "disableFileUpload",
                 "voice",
                 "disableHumanInLoop"
               ],
@@ -3194,15 +3178,13 @@
               "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"

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."
-  ),
   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, disableMessageFeedback: true }
+    { startMinimized: false, responseMode: "buffered", disableMessageFeedback: true }
   ]
 });
 
@@ -224,7 +221,9 @@ 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."
   ),
@@ -236,9 +235,9 @@ var featureFlagsSchema = z7.object({
   )
 }).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"] }
   ]
 });
 
@@ -730,7 +729,7 @@ var widgetSettingsSchema = z16.object({
     {
       presentation: { mode: "inline" },
       behavior: { responseMode: "streaming" },
-      features: { files: true, voice: "local" }
+      features: { voice: "local" }
     }
   ]
 });