@helpai/elements 0.62.1 → 0.63.0

package/index.d.ts

@@ -1,6 +1,5 @@
-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-i9cta98X.js';
-import 'zod';
-
+import { z } from "zod";
+//#region src/core/storage.d.ts
 /**
  * Pluggable client-side key-value storage.
  *
@@ -19,14 +18,15 @@ import 'zod';
  * serialises typed values to JSON before calling `set`.
  */
 interface ClientStorage {
-    /** Returns the stored string for `key`, or `null` when absent / unreadable. */
-    get(key: string): string | null;
-    /** Stores `value` under `key`. Best-effort — silent on quota / disabled storage. */
-    set(key: string, value: string): void;
-    /** Removes `key`. No-op if absent. */
-    remove(key: string): void;
+  /** Returns the stored string for `key`, or `null` when absent / unreadable. */
+  get(key: string): string | null;
+  /** Stores `value` under `key`. Best-effort — silent on quota / disabled storage. */
+  set(key: string, value: string): void;
+  /** Removes `key`. No-op if absent. */
+  remove(key: string): void;
 }
-
+//#endregion
+//#region src/i18n/strings.d.ts
 /**
  * UI strings — built-in defaults, type contracts, and runtime resolution.
  *
@@ -40,7 +40,7 @@ interface ClientStorage {
  * populated {@link Strings} map. UI components then read `strings.send` as a
  * normal property access — no per-render lookup, no per-render allocation.
  */
-type StringKey = "launcherOpen" | "launcherLabel" | "panelTitle" | "composerPlaceholder" | "send" | "stop" | "attach" | "micStart" | "micStop" | "micUnsupported" | "expand" | "collapse" | "fullscreen" | "exitFullscreen" | "resizeHandle" | "scrollToBottom" | "close" | "moreActions" | "soundOn" | "soundOff" | "language" | "theme" | "themeAuto" | "themeLight" | "themeDark" | "textSize" | "textSizeSmall" | "textSizeNormal" | "textSizeLarge" | "history" | "historyTitle" | "historyEmpty" | "historyLoading" | "historyBack" | "historyContinue" | "conversationLoading" | "conversationClosed" | "startNewConversation" | "dateToday" | "dateYesterday" | "dateLastWeek" | "dateOlder" | "newConversation" | "dropZone" | "attachmentTooLarge" | "attachmentTooMany" | "attachmentMimeRejected" | "errorRetry" | "errorGeneric" | "errorRateLimited" | "loading" | "thinking" | "thoughts" | "toolResult" | "sources" | "feedbackUp" | "feedbackDown" | "feedbackThanks" | "copy" | "copied" | "collapseSidebar" | "expandSidebar" | "formSubmit" | "formSkip" | "formSubmitted" | "formSkipped" | "formFillOut" | "formRequired" | "formInvalidEmail" | "formInvalidTel" | "formInvalidUrl" | "formInvalidNumber" | "formTooShort" | "formTooLong" | "formNumberTooSmall" | "formNumberTooLarge" | "formPatternMismatch" | "formChooseAtLeast" | "formChooseAtMost" | "formOther" | "formOtherPlaceholder" | "inputRequired" | "inputBadge" | "inputAnswered" | "inputSkipped" | "inputSubmit" | "inputSubmitHint" | "inputSkip" | "showOptions" | "hideOptions" | "qtypeText" | "qtypeEmail" | "qtypePhone" | "qtypeNumber" | "qtypeDate" | "qtypeChooseOne" | "qtypeChooseAny" | "qtypeBoolean" | "confirmYes" | "confirmNo" | "approve" | "reject" | "approvalPrompt" | "approvalBody" | "approvalYourResponse" | "approvalEditHint" | "approvalSubmitting" | "edit" | "toolParameters" | "statusAwaiting" | "statusResponded" | "statusCompleted" | "statusDenied" | "statusError" | "statusRunning" | "statusSuperseded" | "tabHome" | "tabConversations" | "tabHelp" | "tabNews" | "modulesEmpty" | "moduleBack" | "contentLoading" | "homeGreeting" | "homeGreetingNamed" | "homeGreetingLead" | "homeSearchPlaceholder" | "homeContentTitle" | "homeStatus" | "helpTitle" | "helpSearchPlaceholder" | "helpEmpty" | "helpLoading" | "helpSearchEmpty" | "newsTitle" | "newsEmpty" | "newsLoading" | "newsBack" | "newsPublishedAt";
+type StringKey = "launcherOpen" | "launcherLabel" | "panelTitle" | "composerPlaceholder" | "send" | "stop" | "attach" | "micStart" | "micStop" | "micUnsupported" | "expand" | "collapse" | "fullscreen" | "exitFullscreen" | "resizeHandle" | "scrollToBottom" | "close" | "moreActions" | "soundOn" | "soundOff" | "language" | "theme" | "themeAuto" | "themeLight" | "themeDark" | "textSize" | "textSizeSmall" | "textSizeNormal" | "textSizeLarge" | "history" | "historyTitle" | "historyEmpty" | "historyLoading" | "historyBack" | "historyContinue" | "conversationLoading" | "conversationClosed" | "startNewConversation" | "talkToOperator" | "connectingOperator" | "noOperatorAvailable" | "chattingWithOperator" | "dateToday" | "dateYesterday" | "dateLastWeek" | "dateOlder" | "newConversation" | "dropZone" | "attachmentTooLarge" | "attachmentTooMany" | "attachmentMimeRejected" | "errorRetry" | "errorGeneric" | "errorRateLimited" | "loading" | "thinking" | "thoughts" | "toolResult" | "sources" | "feedbackUp" | "feedbackDown" | "feedbackThanks" | "copy" | "copied" | "collapseSidebar" | "expandSidebar" | "formSubmit" | "formSkip" | "formSubmitted" | "formSkipped" | "formFillOut" | "formRequired" | "formInvalidEmail" | "formInvalidTel" | "formInvalidUrl" | "formInvalidNumber" | "formTooShort" | "formTooLong" | "formNumberTooSmall" | "formNumberTooLarge" | "formPatternMismatch" | "formChooseAtLeast" | "formChooseAtMost" | "formOther" | "formOtherPlaceholder" | "inputRequired" | "inputBadge" | "inputAnswered" | "inputSkipped" | "inputSubmit" | "inputSubmitHint" | "inputSkip" | "showOptions" | "hideOptions" | "qtypeText" | "qtypeEmail" | "qtypePhone" | "qtypeNumber" | "qtypeDate" | "qtypeChooseOne" | "qtypeChooseAny" | "qtypeBoolean" | "confirmYes" | "confirmNo" | "approve" | "reject" | "approvalPrompt" | "approvalBody" | "approvalYourResponse" | "approvalEditHint" | "approvalSubmitting" | "edit" | "toolParameters" | "statusAwaiting" | "statusResponded" | "statusCompleted" | "statusDenied" | "statusError" | "statusRunning" | "statusSuperseded" | "tabHome" | "tabConversations" | "tabHelp" | "tabNews" | "modulesEmpty" | "moduleBack" | "contentLoading" | "homeGreeting" | "homeGreetingNamed" | "homeGreetingLead" | "homeSearchPlaceholder" | "homeContentTitle" | "homeStatus" | "helpTitle" | "helpSearchPlaceholder" | "helpEmpty" | "helpLoading" | "helpSearchEmpty" | "newsTitle" | "newsEmpty" | "newsLoading" | "newsBack" | "newsPublishedAt";
 /** A partial map for one locale — what overrides look like on the wire. */
 type LocaleStrings = Partial<Record<StringKey, string>>;
 /**
@@ -64,44 +64,12 @@ type Strings = Record<StringKey, string>;
  * top-level value is an object, the whole override is treated as nested.
  */
 type StringsOverride = LocaleStrings | Partial<Record<string, LocaleStrings>>;
-
-/**
- * Per-widget client-side state.
- *
- * Storage holds three things, each under its own key:
- *
- * 1. **`visitorId`** — anonymous browser-level identifier, minted once and
- *    reused forever. **Brand-global** (NOT scoped to widget/deployment): one
- *    anonymous "who is this browser" id, shared across every widget + deployment
- *    of this brand. Sent on every backend request.
- * 2. **`conversationId`** — the active conversation thread. The backend is the
- *    source of truth for messages; we store only the id and re-fetch on
- *    reload via `transport.loadConversation()`.
- * 3. **`userPrefs`** — user preferences (locale, panel size from drag,
- *    sound mute). Cached locally for instant render-before-network, then
- *    reconciled with the server's copy on each `connect()`.
- *
- * Everything EXCEPT `visitorId` is namespaced as
- * `${brand.cssPrefix}.${widgetId}.${aiAgentDeploymentId}.${field}` (the deployment id
- * is dropped when absent) so two widgets — or two AI agent deployments — keep
- * their state cleanly separated; pointing a widget at a different
- * `aiAgentDeploymentId` starts from fresh conversation / prefs / panel state.
- * `visitorId` is the deliberate exception: it stays global so the same browser
- * is one anonymous visitor everywhere (`${brand.cssPrefix}.visitorId`).
- *
- * A `storageVersion` (when set) folds a `.v<version>` segment into EVERY key —
- * including the global `visitorId` — so bumping it force-resets the entire
- * client-side namespace for all users (a full fresh start: new visitor id,
- * conversation, prefs, panel state). Unset → the unversioned keys.
- *
- * Storage is pluggable via {@link ClientStorage} — pass a custom adapter
- * to add encryption, logging, or use a non-localStorage backend.
- */
-
+//#endregion
+//#region src/core/persistence.d.ts
 /** Drag-resized panel dimensions. Persisted only when resize is enabled. */
 interface WidgetSize {
-    width: number;
-    height: number;
+  width: number;
+  height: number;
 }
 /**
  * User-changeable preferences. Sent to the backend on every request as a
@@ -112,52 +80,81 @@ interface WidgetSize {
  * default. Empty object `{}` means "no preference recorded yet."
  */
 interface UserPrefs {
-    /** BCP-47 tag picked from the language switcher. */
-    locale?: string;
-    /** Drag-resized panel dimensions. */
-    widgetSize?: WidgetSize;
-    /** Sound on/off toggle (icon button). */
-    soundMuted?: boolean;
-    /** Theme picked from the theme switcher. */
-    themeMode?: "auto" | "light" | "dark";
-    /** Text size picked from the text-size switcher. */
-    textSize?: "small" | "normal" | "large";
+  /** BCP-47 tag picked from the language switcher. */
+  locale?: string;
+  /** Drag-resized panel dimensions. */
+  widgetSize?: WidgetSize;
+  /** Sound on/off toggle (icon button). */
+  soundMuted?: boolean;
+  /** Theme picked from the theme switcher. */
+  themeMode?: "auto" | "light" | "dark";
+  /** Text size picked from the text-size switcher. */
+  textSize?: "small" | "normal" | "large";
 }
-
-/** A 👍/👎 reaction on an assistant message; `null` clears a prior choice. */
+//#endregion
+//#region src/stream/types.d.ts
+/** A 👍/👎 reaction on a rateable (assistant/operator) message; `null` clears a prior choice. */
 type FeedbackValue = "up" | "down" | null;
-
+//#endregion
+//#region src/stream/protocol.d.ts
 /** A tool reference on the wire: `{ code, config }`. `config` is opaque. */
 interface ToolRef {
-    code: string;
-    config?: Record<string, unknown>;
+  code: string;
+  config?: Record<string, unknown>;
+}
+/**
+ * Who is driving replies in a conversation — the widget mirrors the backend `controlMode`.
+ *   - `ai-agent`: the AI agent answers (normal operation).
+ *   - `awaiting_operator`: operator-control requested, AI paused, waiting in the operator queue.
+ *   - `operator`: a workspace operator took over and is replying; AI paused.
+ *
+ * Carried on `HandshakeResponse.controlState`, `LoadConversationResponse.controlState` (resume +
+ * history-switch), and the `data-control-state` stream part (on the reply stream and the held-open
+ * resume during operator-control). Absent / unknown → treated as `"ai-agent"`.
+ */
+type ControlMode = "ai-agent" | "awaiting_operator" | "operator";
+/**
+ * The control-state snapshot the widget reads to render composer/typing/banner state. The optional
+ * `operatorAvailable` (set on the operator-request response + the awaiting terminal part) tells the
+ * widget whether to show "connecting…" or the async-capture ("leave your details") copy.
+ */
+interface ControlState {
+  controlMode: ControlMode;
+  /**
+   * The operator's 2-letter initials (operator mode only) — shown in the bubble chrome + banner. The
+   * visitor never sees the full name (privacy); the backend derives the initials. `assignedOperatorId`
+   * also rides the wire but the widget doesn't render it, so it isn't modeled here.
+   */
+  assignedOperatorInitials?: string;
+  /** Whether anyone was in the operator pool when operator-control was requested (awaiting mode advisory). */
+  operatorAvailable?: boolean;
 }
 /** One-shot bot persona shown in the panel header. */
 interface ConversationAgent {
-    name: string;
-    /** Image URL or data URI. When omitted, initials render from `name`. */
-    avatar?: string;
-    /** Subtitle ("AI Assistant", "Support team", …). */
-    title?: string;
-    /** Presence indicator. Default: `'online'`. */
-    status?: "online" | "away" | "offline";
+  name: string;
+  /** Image URL or data URI. When omitted, initials render from `name`. */
+  avatar?: string;
+  /** Subtitle ("AI Assistant", "Support team", …). */
+  title?: string;
+  /** Presence indicator. Default: `'online'`. */
+  status?: "online" | "away" | "offline";
 }
 /** A clickable quick-reply chip. */
 interface ConversationSuggestion {
-    id: string;
-    /** What the chip displays. */
-    label: string;
-    /** What actually gets sent when clicked. Defaults to `label`. */
-    text?: string;
+  id: string;
+  /** What the chip displays. */
+  label: string;
+  /** What actually gets sent when clicked. Defaults to `label`. */
+  text?: string;
 }
 /** Welcome payload pushed into the message list on first open. */
 interface ConversationWelcome {
-    messages?: Array<{
-        id: string;
-        role: "assistant" | "system";
-        text: string;
-    }>;
-    suggestions?: ConversationSuggestion[];
+  messages?: Array<{
+    id: string;
+    role: "assistant" | "system";
+    text: string;
+  }>;
+  suggestions?: ConversationSuggestion[];
 }
 /**
  * Response from `POST /pai/handshake` — the widget's one mount-time
@@ -173,53 +170,56 @@ interface ConversationWelcome {
  * widget in French when they open it on their laptop (assuming the same
  * `visitorId`, e.g. via authenticated conversation — out of scope for v1).
  */
-interface HandshakeResponse {
-    /**
-     * Public runtime conversation id. The widget mints this UUIDv7 and the backend
-     * validates that it belongs to the public deployment + visitor.
-     */
-    conversationId: string;
+interface HandshakeResponse$1 {
+  /**
+   * Public runtime conversation id. The widget mints this UUIDv7 and the backend
+   * validates that it belongs to the public deployment + visitor.
+   */
+  conversationId: string;
+  visitorId?: string;
+  /** Bot persona in the panel header (name, avatar, status). */
+  agent?: ConversationAgent;
+  /** Initial assistant messages + quick-reply chips. */
+  welcome?: ConversationWelcome;
+  /**
+   * Deployment-wide widget configuration the dashboard admin saved
+   * (mode / theme / launcher / actions / composer / features / …).
+   * Client adopts as defaults; customer's `init({...})` still wins
+   * per-field. Same for every visitor of this deployment.
+   */
+  config?: ServerConfig$1;
+  /** Page-mode site config (logo, title). Backend ships it whenever the deployment renders the page-shell sidebar. */
+  site?: Record<string, unknown>;
+  /** Page-mode sidebar blocks (navigation, link cards). Backend ships it whenever the deployment renders the page-shell sidebar. */
+  blocks?: Record<string, unknown>;
+  /** Current control state — seeds the composer/typing/banner state on connect. Absent → `ai-agent`. */
+  controlState?: ControlState;
+  /**
+   * Server's authoritative copy of the visitor's preferences. When present,
+   * client adopts it (overrides local cache) and re-applies it to the UI
+   * (locale, panel size, sound mute). Absent → client keeps its cache.
+   */
+  userPrefs?: UserPrefs;
+  /**
+   * Optional rebind metadata. When the server returns a `visitorId` /
+   * `conversationId` different from what the client sent, this block tells
+   * the client WHY — useful for telemetry and the `visitorRebound` /
+   * `conversationRebound` events fired into the host page. Server is free to
+   * omit it: the client detects rebinding by comparing request vs
+   * response ids regardless.
+   *
+   * Common reasons: `"conflict"` (the id collided with an existing
+   * record), `"expired"` (the id is too old to be re-used), `"invalid"`
+   * (malformed / not a UUIDv7). Custom strings are passed through to
+   * listeners verbatim.
+   */
+  rebind?: {
     visitorId?: string;
-    /** Bot persona in the panel header (name, avatar, status). */
-    agent?: ConversationAgent;
-    /** Initial assistant messages + quick-reply chips. */
-    welcome?: ConversationWelcome;
-    /**
-     * Deployment-wide widget configuration the dashboard admin saved
-     * (mode / theme / launcher / actions / composer / features / …).
-     * Client adopts as defaults; customer's `init({...})` still wins
-     * per-field. Same for every visitor of this deployment.
-     */
-    config?: ServerConfig;
-    /** Page-mode site config (logo, title). Backend ships it whenever the deployment renders the page-shell sidebar. */
-    site?: Record<string, unknown>;
-    /** Page-mode sidebar blocks (navigation, link cards). Backend ships it whenever the deployment renders the page-shell sidebar. */
-    blocks?: Record<string, unknown>;
-    /**
-     * Server's authoritative copy of the visitor's preferences. When present,
-     * client adopts it (overrides local cache) and re-applies it to the UI
-     * (locale, panel size, sound mute). Absent → client keeps its cache.
-     */
-    userPrefs?: UserPrefs;
-    /**
-     * Optional rebind metadata. When the server returns a `visitorId` /
-     * `conversationId` different from what the client sent, this block tells
-     * the client WHY — useful for telemetry and the `visitorRebound` /
-     * `conversationRebound` events fired into the host page. Server is free to
-     * omit it: the client detects rebinding by comparing request vs
-     * response ids regardless.
-     *
-     * Common reasons: `"conflict"` (the id collided with an existing
-     * record), `"expired"` (the id is too old to be re-used), `"invalid"`
-     * (malformed / not a UUIDv7). Custom strings are passed through to
-     * listeners verbatim.
-     */
-    rebind?: {
-        visitorId?: string;
-        conversationId?: string;
-    };
+    conversationId?: string;
+  };
 }
-
+//#endregion
+//#region src/core/config/types/common.d.ts
 /**
  * Primitive type aliases shared across every config section. Kept in
  * one file so a domain-specific change (adding a new `Mode` value,
@@ -286,12 +286,8 @@ type ActionName = "clear" | "expand" | "fullscreen" | "sound" | "history" | "lan
  * set for each mode; a deployment can replace the whole list.
  */
 type ActionList = ActionName[];
-
-/**
- * Composer + features. The send-button skin, attachment limits, voice
- * mode, file toggle, tool-call gates.
- */
-
+//#endregion
+//#region src/core/config/types/composer.d.ts
 /**
  * How voice input is captured and transcribed.
  *
@@ -304,45 +300,52 @@ type ActionList = ActionName[];
 type VoiceMode = "local" | "server" | "disabled";
 /** Capability flags. Any field left `undefined` uses its default. */
 interface FeatureFlags {
-    /** Voice input behaviour (see {@link VoiceMode}). Default: `'local'`. */
-    voice?: VoiceMode;
-    /**
-     * Backend tools the assistant may invoke. Accepts either a bare tool code
-     * (`"tool:send-money"`) or a rich ref (`{ code, config }`) — the wire
-     * format always uses the rich shape.
-     */
-    tools?: Array<string | ToolRef>;
-    /**
-     * 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;
+  /** Voice input behaviour (see {@link VoiceMode}). Default: `'local'`. */
+  voice?: VoiceMode;
+  /**
+   * Backend tools the assistant may invoke. Accepts either a bare tool code
+   * (`"tool:send-money"`) or a rich ref (`{ code, config }`) — the wire
+   * format always uses the rich shape.
+   */
+  tools?: Array<string | ToolRef>;
+  /**
+   * 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;
+  /**
+   * Opt IN operator control — exposes the "Talk to an operator" affordance + connected-to-operator
+   * states. Positive opt-in (unlike the `disable*` flags) for a new capability; default off.
+   */
+  enableOperatorRequest?: boolean;
 }
 /**
- * Features after resolution. The UI reads a POSITIVE `humanInLoop` — `resolveOptions`
- * inverts the wire-input `disableHumanInLoop` once here, so no render site does `!disable…`.
+ * Features after resolution. The UI reads POSITIVE `humanInLoop`/`fileUpload` — `resolveOptions`
+ * inverts the wire-input `disable*` flags once here, so no render site does `!disable…`.
+ * `operatorRequest` is already positive at the wire, so it passes through unchanged.
  */
 interface ResolvedFeatures {
-    fileUpload: boolean;
-    voice: VoiceMode;
-    humanInLoop: boolean;
-    tools?: Array<string | ToolRef>;
+  fileUpload: boolean;
+  voice: VoiceMode;
+  humanInLoop: boolean;
+  operatorRequest: boolean;
+  tools?: Array<string | ToolRef>;
 }
 /**
  * Client-side attachment limits. Server enforcement is still required —
  * these prevent wasted upload bandwidth and give the user fast feedback.
  */
 interface AttachmentLimits {
-    maxBytes?: number;
-    maxCount?: number;
-    /** Comma-separated MIME allowlist, e.g. `'image/*,application/pdf'`. */
-    accept?: string;
+  maxBytes?: number;
+  maxCount?: number;
+  /** Comma-separated MIME allowlist, e.g. `'image/*,application/pdf'`. */
+  accept?: string;
 }
 /** Outline shape of the send button. */
 type SendButtonShape = "circle" | "square" | "pill";
@@ -351,19 +354,20 @@ type SendButtonIcon = "arrowUp" | "paperPlane" | "send" | "chevron";
 /** Fill/stroke treatment. */
 type SendButtonVariant = "filled" | "outline" | "ghost";
 interface SendButtonOptions {
-    /** Outline shape. Default: `"circle"`. */
-    shape?: SendButtonShape;
-    /** Icon inside the button. Default: `"arrowUp"`. */
-    icon?: SendButtonIcon;
-    /** Fill treatment. Default: `"filled"`. */
-    variant?: SendButtonVariant;
+  /** Outline shape. Default: `"circle"`. */
+  shape?: SendButtonShape;
+  /** Icon inside the button. Default: `"arrowUp"`. */
+  icon?: SendButtonIcon;
+  /** Fill treatment. Default: `"filled"`. */
+  variant?: SendButtonVariant;
 }
 interface ComposerOptions {
-    sendButton?: SendButtonOptions;
-    /** Client-side attachment limits. Server still validates at upload time. */
-    attachments?: AttachmentLimits;
+  sendButton?: SendButtonOptions;
+  /** Client-side attachment limits. Server still validates at upload time. */
+  attachments?: AttachmentLimits;
 }
-
+//#endregion
+//#region src/core/config/types/feedback.d.ts
 /**
  * Audible + tactile feedback knobs. Both default to enabled (browser
  * autoplay policy still gates audio playback).
@@ -379,12 +383,12 @@ type FeedbackEvent = "messageReceived" | "messageSent" | "error" | "voiceStart"
  */
 type SoundEventValue = boolean | string;
 interface SoundOptions {
-    /** Master on/off. Default: `false` (opt-in). */
-    enabled?: boolean;
-    /** Global volume 0..1. Default: `0.3` (subtle). */
-    volume?: number;
-    /** Per-event overrides. Missing keys use the built-in default (see feedback/defaults). */
-    events?: Partial<Record<FeedbackEvent, SoundEventValue>>;
+  /** Master on/off. Default: `false` (opt-in). */
+  enabled?: boolean;
+  /** Global volume 0..1. Default: `0.3` (subtle). */
+  volume?: number;
+  /** Per-event overrides. Missing keys use the built-in default (see feedback/defaults). */
+  events?: Partial<Record<FeedbackEvent, SoundEventValue>>;
 }
 /**
  * Per-event haptic pattern. Android `navigator.vibrate()` shape.
@@ -399,19 +403,20 @@ interface SoundOptions {
  */
 type HapticEventValue = boolean | number | number[];
 interface HapticsOptions {
-    /** Default: `true` on touch devices, silently ignored elsewhere. */
-    enabled?: boolean;
-    events?: Partial<Record<FeedbackEvent, HapticEventValue>>;
+  /** Default: `true` on touch devices, silently ignored elsewhere. */
+  enabled?: boolean;
+  events?: Partial<Record<FeedbackEvent, HapticEventValue>>;
 }
 /**
  * Section: audible + tactile feedback. Both default to enabled
  * (browser autoplay policy still gates audio playback).
  */
 interface FeedbackOptions {
-    sound?: SoundOptions;
-    haptics?: HapticsOptions;
+  sound?: SoundOptions;
+  haptics?: HapticsOptions;
 }
-
+//#endregion
+//#region src/core/config/types/forms.d.ts
 /**
  * Event-driven forms engine — framework-free runtime types (mirror of
  * `src/schema/widget/forms.ts`). The IIFE path has no Zod, so these plain
@@ -430,41 +435,41 @@ interface FeedbackOptions {
 type FieldType = "text" | "email" | "tel" | "url" | "number" | "date" | "time" | "textarea" | "select" | "radio" | "checkbox" | "multiselect";
 /** One choice for `select` / `radio` / `multiselect` fields. */
 interface FieldOption {
-    value: string;
-    /** Display text; falls back to `value`. */
-    label?: string;
-    description?: string;
+  value: string;
+  /** Display text; falls back to `value`. */
+  label?: string;
+  description?: string;
 }
 /** Validation constraints applied client-side (the backend still validates). */
 interface FieldValidation {
-    /** Regex source string (anchored as written) — text-like fields. */
-    pattern?: string;
-    minLength?: number;
-    maxLength?: number;
-    /** Numeric range — `number` fields. */
-    min?: number;
-    max?: number;
-    /** Selection-count bounds — `multiselect` fields. */
-    minSelections?: number;
-    maxSelections?: number;
+  /** Regex source string (anchored as written) — text-like fields. */
+  pattern?: string;
+  minLength?: number;
+  maxLength?: number;
+  /** Numeric range — `number` fields. */
+  min?: number;
+  max?: number;
+  /** Selection-count bounds — `multiselect` fields. */
+  minSelections?: number;
+  maxSelections?: number;
 }
 /** One field in a form. */
 interface FormField {
-    /** Stable key the value is recorded under (e.g. `email`). */
-    name: string;
-    label: string;
-    type: FieldType;
-    placeholder?: string;
-    required?: boolean;
-    /** Pre-filled value (string for scalars; comma-joined for `multiselect`). */
-    defaultValue?: string;
-    /** Choices for `select` / `radio` / `multiselect`. */
-    options?: FieldOption[];
-    validation?: FieldValidation;
-    /** `select`/`radio`/`multiselect` — allow a free-text "Other" answer. */
-    allowOther?: boolean;
-    /** Small helper line under the field. */
-    validationHint?: string;
+  /** Stable key the value is recorded under (e.g. `email`). */
+  name: string;
+  label: string;
+  type: FieldType;
+  placeholder?: string;
+  required?: boolean;
+  /** Pre-filled value (string for scalars; comma-joined for `multiselect`). */
+  defaultValue?: string;
+  /** Choices for `select` / `radio` / `multiselect`. */
+  options?: FieldOption[];
+  validation?: FieldValidation;
+  /** `select`/`radio`/`multiselect` — allow a free-text "Other" answer. */
+  allowOther?: boolean;
+  /** Small helper line under the field. */
+  validationHint?: string;
 }
 /**
  * Trigger that surfaces a form. Terse string with an optional `:param` so it's
@@ -476,21 +481,21 @@ type FormTrigger = "pre-chat" | `after-messages:${number}` | "conversation-close
 type TriggerKind = "pre-chat" | "after-messages" | "conversation-closed" | "panel-close" | "idle" | "page-area" | "manual";
 /** A {@link FormTrigger} parsed into kind + optional param. */
 interface ParsedTrigger {
-    kind: TriggerKind;
-    /** Numeric for `after-messages` / `idle`; string area for `page-area`. */
-    param?: number | string;
+  kind: TriggerKind;
+  /** Numeric for `after-messages` / `idle`; string area for `page-area`. */
+  param?: number | string;
 }
 /**
  * Extra eligibility predicate, evaluated when a trigger fires. Small and
  * declarative on purpose — richer routing belongs to the agent / backend.
  */
 interface FormCondition {
-    /** Only show if `userContext` lacks ALL of these keys (progressive profiling). */
-    missingContext?: string[];
-    /** Only on these page areas (`pageContext.area`). */
-    pageArea?: string | string[];
-    minMessages?: number;
-    maxMessages?: number;
+  /** Only show if `userContext` lacks ALL of these keys (progressive profiling). */
+  missingContext?: string[];
+  /** Only on these page areas (`pageContext.area`). */
+  pageArea?: string | string[];
+  minMessages?: number;
+  maxMessages?: number;
 }
 /**
  * How often a form may show: `once` per device (persisted), once per
@@ -499,46 +504,46 @@ interface FormCondition {
 type FormFrequency = "once" | "conversation" | "always";
 /** One form as authored in config (raw input). */
 interface FormDef {
-    /** Stable id — persistence dedupe + `manual` `openForm(id)`. */
-    id: string;
-    on: FormTrigger | FormTrigger[];
-    when?: FormCondition;
-    fields: FormField[];
-    title?: string;
-    description?: string;
-    submitLabel?: string;
-    skippable?: boolean;
-    /** Default `once`. */
-    frequency?: FormFrequency;
-    /**
-     * Mirror the submitted answers into `userContext` so they ride every
-     * subsequent request (the agent sees them in-conversation). Default `true`.
-     * Set `false` for PII (DOB, policy #, symptoms) — those then go ONLY to the
-     * submit endpoint, never onto the always-on context envelope.
-     */
-    mirrorToContext?: boolean;
-    /**
-     * Skipped marker offers a "Fill out" button that reopens the form (skip is
-     * a deferral, not a refusal). Default `true`. Set `false` when a skip must
-     * be final — e.g. a consent ask that should not be re-surfaced.
-     */
-    reopenable?: boolean;
-    /**
-     * Submitted marker expands in place to a read-only list of the visitor's
-     * answers. Default `true`. Set `false` to keep the marker plain — e.g.
-     * sensitive answers that shouldn't linger on screen (pairs with
-     * `mirrorToContext: false`; the backend should also omit `values` from the
-     * `/activity` records for such forms).
-     */
-    reviewable?: boolean;
-    /** BCP-47 locale the top-level strings (title / fields copy) are authored in. */
-    defaultLocale?: string;
-    /**
-     * Per-locale string overrides. The data module trims this to the requested
-     * `?locale=` (≤1 entry); the widget overlays it onto the default copy at
-     * resolve time (`overlayFormDef`). Absent strings fall back to the default.
-     */
-    translations?: FormTranslation[];
+  /** Stable id — persistence dedupe + `manual` `openForm(id)`. */
+  id: string;
+  on: FormTrigger | FormTrigger[];
+  when?: FormCondition;
+  fields: FormField[];
+  title?: string;
+  description?: string;
+  submitLabel?: string;
+  skippable?: boolean;
+  /** Default `once`. */
+  frequency?: FormFrequency;
+  /**
+   * Mirror the submitted answers into `userContext` so they ride every
+   * subsequent request (the agent sees them in-conversation). Default `true`.
+   * Set `false` for PII (DOB, policy #, symptoms) — those then go ONLY to the
+   * submit endpoint, never onto the always-on context envelope.
+   */
+  mirrorToContext?: boolean;
+  /**
+   * Skipped marker offers a "Fill out" button that reopens the form (skip is
+   * a deferral, not a refusal). Default `true`. Set `false` when a skip must
+   * be final — e.g. a consent ask that should not be re-surfaced.
+   */
+  reopenable?: boolean;
+  /**
+   * Submitted marker expands in place to a read-only list of the visitor's
+   * answers. Default `true`. Set `false` to keep the marker plain — e.g.
+   * sensitive answers that shouldn't linger on screen (pairs with
+   * `mirrorToContext: false`; the backend should also omit `values` from the
+   * `/activity` records for such forms).
+   */
+  reviewable?: boolean;
+  /** BCP-47 locale the top-level strings (title / fields copy) are authored in. */
+  defaultLocale?: string;
+  /**
+   * Per-locale string overrides. The data module trims this to the requested
+   * `?locale=` (≤1 entry); the widget overlays it onto the default copy at
+   * resolve time (`overlayFormDef`). Absent strings fall back to the default.
+   */
+  translations?: FormTranslation[];
 }
 /**
  * Per-locale overrides of a form's HUMAN-FACING strings only. Structure (field
@@ -552,54 +557,55 @@ interface FormDef {
  * of `module-help-ai-data-api` `DynamicFormTranslation`.
  */
 interface FieldOptionTranslation {
-    /** The canonical option `value` this localizes. */
-    value: string;
-    label?: string;
-    description?: string;
+  /** The canonical option `value` this localizes. */
+  value: string;
+  label?: string;
+  description?: string;
 }
 interface FormFieldTranslation {
-    /** The canonical field `name` this localizes. */
-    name: string;
-    label?: string;
-    placeholder?: string;
-    validationHint?: string;
-    options?: FieldOptionTranslation[];
+  /** The canonical field `name` this localizes. */
+  name: string;
+  label?: string;
+  placeholder?: string;
+  validationHint?: string;
+  options?: FieldOptionTranslation[];
 }
 interface FormTranslation {
-    locale: string;
-    title?: string;
-    description?: string;
-    submitLabel?: string;
-    fields?: FormFieldTranslation[];
+  locale: string;
+  title?: string;
+  description?: string;
+  submitLabel?: string;
+  fields?: FormFieldTranslation[];
 }
 /** The `forms` block is an ordered list (max 20); order = priority. */
 type FormsOptions = FormDef[];
 /** A fully-resolved form exposed on {@link ResolvedOptions}. */
 interface ResolvedForm {
-    id: string;
-    triggers: ParsedTrigger[];
-    when?: FormCondition;
-    fields: FormField[];
-    title?: string;
-    description?: string;
-    submitLabel?: string;
-    skippable: boolean;
-    frequency: FormFrequency;
-    /** Mirror answers into `userContext` (false → PII, endpoint only). */
-    mirrorToContext: boolean;
-    /** Skipped marker offers "Fill out" (false → a skip is final). */
-    reopenable: boolean;
-    /** Submitted marker expands to a read-only answers list. */
-    reviewable: boolean;
+  id: string;
+  triggers: ParsedTrigger[];
+  when?: FormCondition;
+  fields: FormField[];
+  title?: string;
+  description?: string;
+  submitLabel?: string;
+  skippable: boolean;
+  frequency: FormFrequency;
+  /** Mirror answers into `userContext` (false → PII, endpoint only). */
+  mirrorToContext: boolean;
+  /** Skipped marker offers "Fill out" (false → a skip is final). */
+  reopenable: boolean;
+  /** Submitted marker expands to a read-only answers list. */
+  reviewable: boolean;
 }
 /** Fully-resolved forms block: ordered list + an event→forms index. */
 interface ResolvedForms {
-    /** Forms in declared order (= priority). */
-    list: ResolvedForm[];
-    /** Forms keyed by trigger kind, for fast event lookup. */
-    byTrigger: Partial<Record<TriggerKind, ResolvedForm[]>>;
+  /** Forms in declared order (= priority). */
+  list: ResolvedForm[];
+  /** Forms keyed by trigger kind, for fast event lookup. */
+  byTrigger: Partial<Record<TriggerKind, ResolvedForm[]>>;
 }
-
+//#endregion
+//#region src/core/config/types/launcher.d.ts
 /**
  * Launcher (floating-mode FAB) + the pre-engagement callout bubble.
  * Inputs are option-bag shaped; the resolved variant lives in `widget.ts`.
@@ -643,32 +649,33 @@ type CalloutPosition = "auto" | "horizontal" | "vertical";
  *                       hidden across visits.
  */
 interface LauncherCalloutOptions {
-    /** Text content. Empty string hides the callout. */
-    text: string;
-    /** Visual shape. Default: `"pill"`. */
-    shape?: CalloutShape;
-    /** Side of the launcher to anchor on. Default: `"auto"`. */
-    position?: CalloutPosition;
-    /** Delay before the bubble appears (ms). Default: `1200`. */
-    delayMs?: number;
-    /** Auto-dismiss after this many ms. Default: never (`0`). */
-    autoDismissMs?: number;
-    /** Animate with a subtle horizontal nudge. Default: `true`. */
-    animated?: boolean;
-    /** Re-show on every visit regardless of prior dismissal. Default: `true`. */
-    persistent?: boolean;
+  /** Text content. Empty string hides the callout. */
+  text: string;
+  /** Visual shape. Default: `"pill"`. */
+  shape?: CalloutShape;
+  /** Side of the launcher to anchor on. Default: `"auto"`. */
+  position?: CalloutPosition;
+  /** Delay before the bubble appears (ms). Default: `1200`. */
+  delayMs?: number;
+  /** Auto-dismiss after this many ms. Default: never (`0`). */
+  autoDismissMs?: number;
+  /** Animate with a subtle horizontal nudge. Default: `true`. */
+  animated?: boolean;
+  /** Re-show on every visit regardless of prior dismissal. Default: `true`. */
+  persistent?: boolean;
 }
 /** Launcher appearance + behaviour. Only applies in `floating` mode. */
 interface LauncherOptions {
-    variant?: LauncherVariant;
-    size?: LauncherSize;
-    label?: string;
-    icon?: LauncherIconPreset | string;
-    hidden?: boolean;
-    /** Pre-engagement bubble next to the FAB. See {@link LauncherCalloutOptions}. */
-    callout?: LauncherCalloutOptions;
+  variant?: LauncherVariant;
+  size?: LauncherSize;
+  label?: string;
+  icon?: LauncherIconPreset | string;
+  hidden?: boolean;
+  /** Pre-engagement bubble next to the FAB. See {@link LauncherCalloutOptions}. */
+  callout?: LauncherCalloutOptions;
 }
-
+//#endregion
+//#region src/core/config/types/modules.d.ts
 /**
  * Messenger "modules" runtime config types — framework-free mirror of
  * `src/schema/widget/modules.ts`. The IIFE runtime path has no Zod, so
@@ -682,26 +689,26 @@ interface LauncherOptions {
 type ModuleLayout = "chat" | "home" | "help" | "news";
 /** A team/agent avatar shown in the Home hero. */
 interface ModuleAvatar {
-    name: string;
-    /** Image URL; initials of `name` are shown when omitted. */
-    avatar?: string;
-    role?: string;
+  name: string;
+  /** Image URL; initials of `name` are shown when omitted. */
+  avatar?: string;
+  role?: string;
 }
 /** The Home status card. */
 interface ModuleStatus {
-    /**
-     * Status line. An i18n key or a literal (resolved via `localizeText`).
-     * Omit to use the built-in generic `homeStatus` string — so a deployment can
-     * show a localized status without authoring copy or a custom key per locale.
-     */
-    text?: string;
-    /**
-     * Status severity → status-icon colour. Free text; `operational` (default),
-     * `degraded`, and `down` are styled, any other value uses the operational style.
-     */
-    level?: string;
-    /** Opens in an in-widget iframe when tapped. */
-    url?: string;
+  /**
+   * Status line. An i18n key or a literal (resolved via `localizeText`).
+   * Omit to use the built-in generic `homeStatus` string — so a deployment can
+   * show a localized status without authoring copy or a custom key per locale.
+   */
+  text?: string;
+  /**
+   * Status severity → status-icon colour. Free text; `operational` (default),
+   * `degraded`, and `down` are styled, any other value uses the operational style.
+   */
+  level?: string;
+  /** Opens in an in-widget iframe when tapped. */
+  url?: string;
 }
 /**
  * `home` layout config — flat feature flags (no block authoring). The Home tab
@@ -709,22 +716,22 @@ interface ModuleStatus {
  * → status → a content list (from the tab's `contentTags`, titled `contentBlockTitle`).
  */
 interface HomeConfig {
-    brandName?: string;
-    hideGreeting?: boolean;
-    greetingText?: string;
-    userAvatars?: ModuleAvatar[];
-    hideSearchBar?: boolean;
-    hideRecentConversations?: boolean;
-    status?: ModuleStatus;
-    contentBlockTitle?: string;
+  brandName?: string;
+  hideGreeting?: boolean;
+  greetingText?: string;
+  userAvatars?: ModuleAvatar[];
+  hideSearchBar?: boolean;
+  hideRecentConversations?: boolean;
+  status?: ModuleStatus;
+  contentBlockTitle?: string;
 }
 /** One tab as authored in config (raw input). */
 interface ModuleOptions extends HomeConfig {
-    label: string;
-    layout: ModuleLayout;
-    /** Content tags to scope this tab to (matches content tagged with ANY of them). */
-    contentTags?: string[];
-    id?: string;
+  label: string;
+  layout: ModuleLayout;
+  /** Content tags to scope this tab to (matches content tagged with ANY of them). */
+  contentTags?: string[];
+  id?: string;
 }
 /** The `modules` block is an ordered list of tabs (max 4). */
 type ModulesOptions = ModuleOptions[];
@@ -734,38 +741,34 @@ type ModulesOptions = ModuleOptions[];
  * `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. */
-    label: string;
-    layout: ModuleLayout;
-    /** Content tag scope — the `tags` filter (omitted for `chat`). */
-    contentTags?: string[];
-    showGreeting?: boolean;
-    showSearchBar?: boolean;
-    showRecentConversations?: boolean;
+  /** 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. */
+  label: string;
+  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 {
-    /** The tabs, in declared order. Presence = enabled; an empty list = no tabs. */
-    list: ResolvedModule[];
-    /** The tabs keyed by `id` (for nav + per-tab config lookup). */
-    byId: Record<string, ResolvedModule>;
+  /** The tabs, in declared order. Presence = enabled; an empty list = no tabs. */
+  list: ResolvedModule[];
+  /** The tabs keyed by `id` (for nav + per-tab config lookup). */
+  byId: Record<string, ResolvedModule>;
 }
-
-/**
- * Visual presentation — theme tokens, sizing tiers, drag-resize, and
- * the `mode` / `position` / `iframe` knobs at the section root.
- */
-
+//#endregion
+//#region src/core/config/types/presentation.d.ts
 /** CSS-custom-property overrides applied as inline styles on the host. */
 interface ThemeOverrides {
-    accent?: string;
-    accentText?: string;
-    radius?: string;
-    fontFamily?: string;
-    /** Readable content-column cap (→ `--conversation-max`). CSS length; default `768px`. */
-    contentMaxWidth?: string;
+  accent?: string;
+  accentText?: string;
+  radius?: string;
+  fontFamily?: string;
+  /** Readable content-column cap (→ `--conversation-max`). CSS length; default `768px`. */
+  contentMaxWidth?: string;
 }
 /**
  * Widget sizing overrides. Each field accepts any valid CSS length
@@ -779,47 +782,47 @@ interface ThemeOverrides {
  *    fills the viewport regardless of other dimensions.
  */
 interface SizeOptions {
-    /** Normal-mode width. Default: mode-specific (see `src/styles/panel.css`). */
+  /** Normal-mode width. Default: mode-specific (see `src/styles/panel.css`). */
+  width?: string;
+  /** Normal-mode height. Default: mode-specific. */
+  height?: string;
+  /** Dimensions when the user clicks the expand button. */
+  expanded?: {
     width?: string;
-    /** Normal-mode height. Default: mode-specific. */
     height?: string;
-    /** Dimensions when the user clicks the expand button. */
-    expanded?: {
-        width?: string;
-        height?: string;
-    };
-    /**
-     * Edge inset for `drawer` mode — turns the side dock into a flyout
-     * with the given gap from each viewport edge (`16px`, `2vh`,
-     * `min(24px, 4vw)`, …). Combine with a partial `height` (`80vh`,
-     * `min(720px, calc(100vh - 32px))`) for the classic floating
-     * side-panel look. Ignored by every other mode.
-     */
-    inset?: string;
-    /** Enable + configure user-drag resize of the panel in normal mode. */
-    resize?: ResizeOptions;
-    /**
-     * Which size to open with on the **first** render.
-     *
-     * - `"auto"` — pick `expanded` when `window.innerWidth ≥ autoSizeBreakpoint`,
-     *   otherwise `normal`. Lets the backend push a "responsive default" without
-     *   baking the breakpoint into the frontend.
-     * - `"normal"` — default compact panel (same as omitting the field).
-     * - `"expanded"` — force-start at the configured `expanded.width/height`.
-     * - `"fullscreen"` — force-start at viewport fill.
-     *
-     * Only applies to the very first mount. The user's last size is
-     * preserved across close → reopen; a page reload re-evaluates.
-     * Standalone mode always overrides to `fullscreen`.
-     *
-     * Default: `"normal"`.
-     */
-    initialSize?: "auto" | "normal" | "expanded" | "fullscreen";
-    /**
-     * Viewport-width threshold (px) above which `initialSize: "auto"` picks
-     * `"expanded"`. Default: `900`.
-     */
-    autoSizeBreakpoint?: number;
+  };
+  /**
+   * Edge inset for `drawer` mode — turns the side dock into a flyout
+   * with the given gap from each viewport edge (`16px`, `2vh`,
+   * `min(24px, 4vw)`, …). Combine with a partial `height` (`80vh`,
+   * `min(720px, calc(100vh - 32px))`) for the classic floating
+   * side-panel look. Ignored by every other mode.
+   */
+  inset?: string;
+  /** Enable + configure user-drag resize of the panel in normal mode. */
+  resize?: ResizeOptions;
+  /**
+   * Which size to open with on the **first** render.
+   *
+   * - `"auto"` — pick `expanded` when `window.innerWidth ≥ autoSizeBreakpoint`,
+   *   otherwise `normal`. Lets the backend push a "responsive default" without
+   *   baking the breakpoint into the frontend.
+   * - `"normal"` — default compact panel (same as omitting the field).
+   * - `"expanded"` — force-start at the configured `expanded.width/height`.
+   * - `"fullscreen"` — force-start at viewport fill.
+   *
+   * Only applies to the very first mount. The user's last size is
+   * preserved across close → reopen; a page reload re-evaluates.
+   * Standalone mode always overrides to `fullscreen`.
+   *
+   * Default: `"normal"`.
+   */
+  initialSize?: "auto" | "normal" | "expanded" | "fullscreen";
+  /**
+   * Viewport-width threshold (px) above which `initialSize: "auto"` picks
+   * `"expanded"`. Default: `900`.
+   */
+  autoSizeBreakpoint?: number;
 }
 /**
  * Drag-resize configuration. When `enabled`, a corner grip appears on the
@@ -827,59 +830,54 @@ interface SizeOptions {
  * `userPrefs.widgetSize` (cached client-side + synced to the backend).
  */
 interface ResizeOptions {
-    /** Show the resize grip. Default: `false`. */
-    enabled?: boolean;
-    minWidth?: string;
-    maxWidth?: string;
-    minHeight?: string;
-    maxHeight?: string;
+  /** Show the resize grip. Default: `false`. */
+  enabled?: boolean;
+  minWidth?: string;
+  maxWidth?: string;
+  minHeight?: string;
+  maxHeight?: string;
 }
 /**
  * Section: how the widget physically presents itself on the page.
  */
 interface PresentationOptions {
-    mode?: Mode;
-    position?: Position;
-    /**
-     * Wrap the widget in a same-origin iframe for strict JS + CSS isolation
-     * beyond what shadow DOM provides. Composes with every mode.
-     */
-    iframe?: boolean;
-    size?: SizeOptions;
+  mode?: Mode;
+  position?: Position;
+  /**
+   * Wrap the widget in a same-origin iframe for strict JS + CSS isolation
+   * beyond what shadow DOM provides. Composes with every mode.
+   */
+  iframe?: boolean;
+  size?: SizeOptions;
 }
-
-/**
- * Misc nested sections: behavior, header, i18n, footer, connection
- * (user + endpoints). Keep them in one file because each is small (~5
- * fields) and they all live at the top level of `ChatWidgetOptions`.
- */
-
+//#endregion
+//#region src/core/config/types/sections.d.ts
 /**
  * Section: conversation runtime behaviour — auto-open, streaming mode, and the
  * transcript surface (what renders, how it scrolls, reaction controls).
  */
 interface BehaviorOptions {
-    /** When `true`, don't auto-open the panel on first visit. */
-    startMinimized?: boolean;
-    /** Streaming vs. buffered reply delivery. */
-    responseMode?: ResponseMode;
-    /** Show the model's reasoning ("thoughts") as a collapsible block. Default `false`. */
-    showReasoning?: boolean;
-    /** Show automatic tool/function calls (details + result) in the transcript. Default `false`. */
-    showToolCalls?: boolean;
-    /** Show citation sources (web links + document references) in the transcript. Default `false`. */
-    showSources?: boolean;
-    /** Turn OFF the 👍/👎 feedback controls on assistant replies. Unset/`false` = shown (default). */
-    disableMessageFeedback?: boolean;
-    /** Auto-send a suggestion chip's text on tap. Unset/`false` = fill the composer to edit (default). */
-    autoSendSuggestions?: boolean;
+  /** When `true`, don't auto-open the panel on first visit. */
+  startMinimized?: boolean;
+  /** Streaming vs. buffered reply delivery. */
+  responseMode?: ResponseMode;
+  /** Show the model's reasoning ("thoughts") as a collapsible block. Default `false`. */
+  showReasoning?: boolean;
+  /** Show automatic tool/function calls (details + result) in the transcript. Default `false`. */
+  showToolCalls?: boolean;
+  /** Show citation sources (web links + document references) in the transcript. Default `false`. */
+  showSources?: boolean;
+  /** Turn OFF the 👍/👎 feedback controls on rateable (assistant/operator) replies. Unset/`false` = shown (default). */
+  disableMessageFeedback?: boolean;
+  /** Auto-send a suggestion chip's text on tap. Unset/`false` = fill the composer to edit (default). */
+  autoSendSuggestions?: boolean;
 }
 /**
  * Section: panel header actions — the enabled set (`history`/`close` buttons +
  * ⋯ menu). Unlisted actions are hidden.
  */
 interface HeaderOptions {
-    actions?: ActionList;
+  actions?: ActionList;
 }
 /**
  * Section: locale resolution + per-instance string overrides.
@@ -892,35 +890,35 @@ interface HeaderOptions {
  * 5. `"en"` ultimate fallback.
  */
 interface I18nOptions {
-    locale?: string;
-    defaultLocale?: "auto" | string;
-    availableLocales?: string[];
-    strings?: StringsOverride;
+  locale?: string;
+  defaultLocale?: "auto" | string;
+  availableLocales?: string[];
+  strings?: StringsOverride;
 }
 /**
  * "Powered by …" attribution shown below the composer. Any combination of
  * logo + text + href is valid; all three absent hides the element.
  */
 interface PoweredByOption {
-    /** Visible text (e.g. `"Powered by Help AI"`). */
-    text?: string;
-    /** If set, the attribution is an `<a>` pointing here (`noopener noreferrer`). */
-    href?: string;
-    /** Optional small logo URL rendered before the text. */
-    logoUrl?: string;
+  /** Visible text (e.g. `"Powered by Help AI"`). */
+  text?: string;
+  /** If set, the attribution is an `<a>` pointing here (`noopener noreferrer`). */
+  href?: string;
+  /** Optional small logo URL rendered before the text. */
+  logoUrl?: string;
 }
 /**
  * Section: footer area below the composer — brand attribution and
  * the optional ChatGPT-style "AI can make mistakes" disclaimer.
  */
 interface FooterOptions {
-    /** Optional "Powered by …" attribution rendered below the disclaimer. */
-    poweredBy?: PoweredByOption;
-    /**
-     * Small muted text rendered below the composer. Same pattern as ChatGPT's
-     * "ChatGPT can make mistakes." When absent / empty, the line is hidden.
-     */
-    composerDisclaimer?: string;
+  /** Optional "Powered by …" attribution rendered below the disclaimer. */
+  poweredBy?: PoweredByOption;
+  /**
+   * Small muted text rendered below the composer. Same pattern as ChatGPT's
+   * "ChatGPT can make mistakes." When absent / empty, the line is hidden.
+   */
+  composerDisclaimer?: string;
 }
 /**
  * Host-asserted context about the current end-user, forwarded to the backend
@@ -935,17 +933,17 @@ interface FooterOptions {
  * `sanitizeUserContext` before it goes on the wire.
  */
 interface UserContext {
-    id?: string;
-    email?: string;
-    name?: string;
-    /** Subscription / pricing tier (e.g. `"pro"`). */
-    plan?: string;
-    /** The user's role on the host site (e.g. `"admin"`, `"member"`). */
-    role?: string;
-    /** Phone number. */
-    phone?: string;
-    /** Arbitrary extra scalar context forwarded to the agent. */
-    [key: string]: string | number | boolean | undefined;
+  id?: string;
+  email?: string;
+  name?: string;
+  /** Subscription / pricing tier (e.g. `"pro"`). */
+  plan?: string;
+  /** The user's role on the host site (e.g. `"admin"`, `"member"`). */
+  role?: string;
+  /** Phone number. */
+  phone?: string;
+  /** Arbitrary extra scalar context forwarded to the agent. */
+  [key: string]: string | number | boolean | undefined;
 }
 /**
  * Suggested values for {@link PageContext.area} — the host-defined surface the
@@ -963,16 +961,16 @@ type PageArea = "home" | "docs" | "help-desk" | "support" | "pricing" | "checkou
  * sanitised client-side before sending.
  */
 interface PageContext {
-    /** Host-defined surface the visitor is on (see {@link PageArea}). */
-    area?: PageArea;
-    /** Full page URL. Auto-filled from `location.href` when omitted. */
-    url?: string;
-    /** Page path, e.g. `/pricing/enterprise`. */
-    path?: string;
-    /** Human-readable page title. */
-    title?: string;
-    /** Arbitrary extra scalar context about this page / visit. */
-    [key: string]: string | number | boolean | undefined;
+  /** Host-defined surface the visitor is on (see {@link PageArea}). */
+  area?: PageArea;
+  /** Full page URL. Auto-filled from `location.href` when omitted. */
+  url?: string;
+  /** Page path, e.g. `/pricing/enterprise`. */
+  path?: string;
+  /** Human-readable page title. */
+  title?: string;
+  /** Arbitrary extra scalar context about this page / visit. */
+  [key: string]: string | number | boolean | undefined;
 }
 /**
  * Override the HTTP endpoints the widget calls. `upload` / `transcribe`
@@ -982,21 +980,22 @@ interface PageContext {
  * like a CDN presign service).
  */
 interface Endpoints {
-    /** File upload endpoint. Default: `'/pai/upload-file'`. */
-    upload?: string;
-    /** Voice transcription endpoint. Default: `'/pai/transcribe-audio'`. */
-    transcribe?: string;
-    /**
-     * Form submission endpoint. Default: `'/submit-form'`. When any form
-     * (a pre-chat lead capture, a CSAT survey, etc.) is completed, the widget POSTs
-     * the captured values here (fire-and-forget), keyed by the same `visitorId` +
-     * `conversationId` the conversation uses; the payload carries `formId` + `trigger`
-     * so the backend can route. Optional: a backend that doesn't implement it just
-     * 404s and the submission is ignored.
-     */
-    submitForm?: string;
+  /** File upload endpoint. Default: `'/pai/upload-file'`. */
+  upload?: string;
+  /** Voice transcription endpoint. Default: `'/pai/transcribe-audio'`. */
+  transcribe?: string;
+  /**
+   * Form submission endpoint. Default: `'/submit-form'`. When any form
+   * (a pre-chat lead capture, a CSAT survey, etc.) is completed, the widget POSTs
+   * the captured values here (fire-and-forget), keyed by the same `visitorId` +
+   * `conversationId` the conversation uses; the payload carries `formId` + `trigger`
+   * so the backend can route. Optional: a backend that doesn't implement it just
+   * 404s and the submission is ignored.
+   */
+  submitForm?: string;
 }
-
+//#endregion
+//#region src/core/config/types/tracking.d.ts
 /**
  * Built-in anonymous usage tracking — utm.gif-style pixel hits that give
  * the widget OWNER (the site embedding it) insights about how visitors
@@ -1013,50 +1012,40 @@ interface Endpoints {
  */
 /** Section: anonymous owner-facing usage tracking. */
 interface TrackingOptions {
-    /**
-     * Master switch. Default `true` — the widget always fires; the data
-     * module gates ingestion per deployment server-side. Set `false`
-     * (deployment config or init) to silence the client entirely.
-     */
-    enabled?: boolean;
-    /**
-     * Pixel collector URL. Default: `${dataApiBaseUrl}/pai/elements-px.gif`
-     * (e.g. `https://help.ai/api/data/pai/elements-px.gif`).
-     */
-    endpoint?: string;
-    /**
-     * Per-visitor sampling 0..1. `0.25` tracks ~a quarter of visitors
-     * (decided once per page load, so funnels stay intact). Default `1`.
-     */
-    sampleRate?: number;
-    /**
-     * Anti-forgery token, echoed as `tk=` on every hit. **Server-issued,
-     * never set by hand** — the backend mints it in the
-     * `/handshake` response (HMAC over `pk`/`vid`/expiry with a
-     * server-side secret; see `docs/api/tracking-collector.md`) and the
-     * collector verifies it statelessly. Opaque to the client.
-     */
-    token?: string;
+  /**
+   * Master switch. Default `true` — the widget always fires; the data
+   * module gates ingestion per deployment server-side. Set `false`
+   * (deployment config or init) to silence the client entirely.
+   */
+  enabled?: boolean;
+  /**
+   * Pixel collector URL. Default: `${dataApiBaseUrl}/pai/elements-px.gif`
+   * (e.g. `https://help.ai/api/data/pai/elements-px.gif`).
+   */
+  endpoint?: string;
+  /**
+   * Per-visitor sampling 0..1. `0.25` tracks ~a quarter of visitors
+   * (decided once per page load, so funnels stay intact). Default `1`.
+   */
+  sampleRate?: number;
+  /**
+   * Anti-forgery token, echoed as `tk=` on every hit. **Server-issued,
+   * never set by hand** — the backend mints it in the
+   * `/handshake` response (HMAC over `pk`/`vid`/expiry with a
+   * server-side secret; see `docs/api/tracking-collector.md`) and the
+   * collector verifies it statelessly. Opaque to the client.
+   */
+  token?: string;
 }
 /** Post-resolve shape — every field concrete (token stays optional: absent until the handshake delivers it). */
 interface ResolvedTracking {
-    enabled: boolean;
-    endpoint: string;
-    sampleRate: number;
-    token?: string;
+  enabled: boolean;
+  endpoint: string;
+  sampleRate: number;
+  token?: string;
 }
-
-/**
- * The three composing roots: raw input ({@link ChatWidgetOptions}),
- * post-normalisation runtime shape ({@link ResolvedOptions}), and the
- * subset the server can push back via `/handshake` ({@link
- * ServerConfig}).
- *
- * Internal modules always depend on `ResolvedOptions`. The raw shape
- * lives at the boundary (`init`, `mount`, web component attributes,
- * data-* parsing, server merge) and never escapes.
- */
-
+//#endregion
+//#region src/core/config/types/widget.d.ts
 /**
  * Raw options passed to {@link mount}, {@link init}, the Web Component, or
  * the `<script data-*>` auto-boot path. Every field is optional.
@@ -1075,87 +1064,87 @@ interface ResolvedTracking {
  * serialised on the wire.
  */
 interface ChatWidgetOptions {
-    /**
-     * Stable identifier for this widget instance. Use when mounting more
-     * than one widget on the same page (different deployments, different
-     * targets). Isolates client-storage namespaces (visitorId, active conversationId,
-     * cached userPrefs). Default: `"default"`.
-     */
-    widgetId?: string;
-    /** Workspace-scoped public key (`agent_pk_...`). Sent as `x-public-key`. */
-    publicKey?: string;
-    /** Deployment ID (UUID). Sent as `x-ai-agent-deployment-id`. */
-    aiAgentDeploymentId?: string;
-    /**
-     * MAIN site origin (no trailing slash, e.g. `https://help.ai`). The API
-     * modules derive from it — the production edge mounts the agent API at
-     * `${baseUrl}/api/agent` and the data API at `${baseUrl}/api/data`.
-     * Defaults to the brand's origin.
-     */
-    baseUrl?: string;
-    /**
-     * 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 (`${agentApiBaseUrl}/pai/handshake`).
-     * Precedence: this option > derived from the main origin
-     * (`${baseUrl}/api/agent`). Not server-pushable — the handshake already
-     * travelled over it.
-     */
-    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.dataApiBaseUrl` > derived
-     * from the main origin (`${baseUrl}/api/data`, e.g.
-     * `https://help.ai/api/data`).
-     */
-    dataApiBaseUrl?: string;
-    /** Host-asserted, informational end-user context (untrusted; not auth). */
-    userContext?: UserContext;
-    /** Host-asserted, informational page/visit context (untrusted; `area`, url, …). */
-    pageContext?: PageContext;
-    /** HTTP endpoint overrides. */
-    endpoints?: Endpoints;
-    /**
-     * Console log verbosity. `false` / `"off"` silences everything,
-     * `true` → `"debug"`. Levels `error` / `warn` / `info` / `debug` /
-     * `trace` gate output additively. Runtime-toggleable via
-     * `chat.setDebug(level)` or `?<brand>-debug=trace` in the page URL.
-     */
-    debug?: boolean | "off" | "error" | "warn" | "info" | "debug" | "trace";
-    presentation?: PresentationOptions;
-    behavior?: BehaviorOptions;
-    /** Theme preference (`'auto' | 'light' | 'dark'`) or overrides object. */
-    theme?: ThemePreference | ThemeOverrides;
-    launcher?: LauncherOptions;
-    header?: HeaderOptions;
-    composer?: ComposerOptions;
-    feedback?: FeedbackOptions;
-    i18n?: I18nOptions;
-    footer?: FooterOptions;
-    /** Capability flags (file upload, voice mode, tools). Server-pushable. */
-    features?: FeatureFlags;
-    /** Event-driven forms (lead capture, CSAT, intake, consent…). Server-pushable. */
-    forms?: FormsOptions;
-    /** Messenger modules (Chat / Home / Messages / Help / News tabs). Server-pushable. */
-    modules?: ModulesOptions;
-    /** Anonymous owner-facing usage tracking (pixel hits). Server-pushable. */
-    tracking?: TrackingOptions;
-    /**
-     * Custom client-side storage adapter. Implements the {@link ClientStorage}
-     * interface (`get` / `set` / `remove` / `clear`).
-     */
-    storage?: ClientStorage;
-    onMessage?: (msg: {
-        role: string;
-        text: string;
-    }) => void;
-    onOpen?: () => void;
-    onClose?: () => void;
-    onError?: (err: unknown) => void;
+  /**
+   * Stable identifier for this widget instance. Use when mounting more
+   * than one widget on the same page (different deployments, different
+   * targets). Isolates client-storage namespaces (visitorId, active conversationId,
+   * cached userPrefs). Default: `"default"`.
+   */
+  widgetId?: string;
+  /** Workspace-scoped public key (`agent_pk_...`). Sent as `x-public-key`. */
+  publicKey?: string;
+  /** Deployment ID (UUID). Sent as `x-ai-agent-deployment-id`. */
+  aiAgentDeploymentId?: string;
+  /**
+   * MAIN site origin (no trailing slash, e.g. `https://help.ai`). The API
+   * modules derive from it — the production edge mounts the agent API at
+   * `${baseUrl}/api/agent` and the data API at `${baseUrl}/api/data`.
+   * Defaults to the brand's origin.
+   */
+  baseUrl?: string;
+  /**
+   * 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 (`${agentApiBaseUrl}/pai/handshake`).
+   * Precedence: this option > derived from the main origin
+   * (`${baseUrl}/api/agent`). Not server-pushable — the handshake already
+   * travelled over it.
+   */
+  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.dataApiBaseUrl` > derived
+   * from the main origin (`${baseUrl}/api/data`, e.g.
+   * `https://help.ai/api/data`).
+   */
+  dataApiBaseUrl?: string;
+  /** Host-asserted, informational end-user context (untrusted; not auth). */
+  userContext?: UserContext;
+  /** Host-asserted, informational page/visit context (untrusted; `area`, url, …). */
+  pageContext?: PageContext;
+  /** HTTP endpoint overrides. */
+  endpoints?: Endpoints;
+  /**
+   * Console log verbosity. `false` / `"off"` silences everything,
+   * `true` → `"debug"`. Levels `error` / `warn` / `info` / `debug` /
+   * `trace` gate output additively. Runtime-toggleable via
+   * `chat.setDebug(level)` or `?<brand>-debug=trace` in the page URL.
+   */
+  debug?: boolean | "off" | "error" | "warn" | "info" | "debug" | "trace";
+  presentation?: PresentationOptions;
+  behavior?: BehaviorOptions;
+  /** Theme preference (`'auto' | 'light' | 'dark'`) or overrides object. */
+  theme?: ThemePreference | ThemeOverrides;
+  launcher?: LauncherOptions;
+  header?: HeaderOptions;
+  composer?: ComposerOptions;
+  feedback?: FeedbackOptions;
+  i18n?: I18nOptions;
+  footer?: FooterOptions;
+  /** Capability flags (file upload, voice mode, tools). Server-pushable. */
+  features?: FeatureFlags;
+  /** Event-driven forms (lead capture, CSAT, intake, consent…). Server-pushable. */
+  forms?: FormsOptions;
+  /** Messenger modules (Chat / Home / Messages / Help / News tabs). Server-pushable. */
+  modules?: ModulesOptions;
+  /** Anonymous owner-facing usage tracking (pixel hits). Server-pushable. */
+  tracking?: TrackingOptions;
+  /**
+   * Custom client-side storage adapter. Implements the {@link ClientStorage}
+   * interface (`get` / `set` / `remove` / `clear`).
+   */
+  storage?: ClientStorage;
+  onMessage?: (msg: {
+    role: string;
+    text: string;
+  }) => void;
+  onOpen?: () => void;
+  onClose?: () => void;
+  onError?: (err: unknown) => void;
 }
 /**
  * Post-normalisation options. Every optional field in {@link ChatWidgetOptions}
@@ -1163,104 +1152,104 @@ interface ChatWidgetOptions {
  * modules depend on this shape, never the raw input.
  */
 interface ResolvedOptions {
-    widgetId: string;
-    publicKey?: string;
-    aiAgentDeploymentId?: string;
-    baseUrl: 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;
-    themeMode: ThemePreference;
-    /** Active text size. Default `normal`; the end-user's pick overrides at runtime. */
-    textSize: TextSize;
-    themeOverrides: ThemeOverrides;
-    mode: Mode;
-    iframe: boolean;
-    responseMode: ResponseMode;
-    /** Show reasoning ("thoughts") as a collapsible block. Default `false`. */
-    showReasoning: boolean;
-    /** Show automatic tool calls (details + result) in the transcript. Default `false`. */
-    showToolCalls: boolean;
-    /** Show citation sources (web links + document references) in the transcript. Default `false`. */
-    showSources: boolean;
-    /** Show 👍/👎 feedback controls on assistant replies. Default `true`. */
-    enableMessageFeedback: boolean;
-    /** Auto-send a suggestion chip's text on tap (vs. filling the composer to edit). Default `false`. */
-    autoSendSuggestions: boolean;
-    features: ResolvedFeatures;
-    /** Resolved event-driven forms — ordered list + trigger index. */
-    forms: ResolvedForms;
-    endpoints: Required<Endpoints>;
-    attachments: Required<Pick<AttachmentLimits, "maxBytes" | "maxCount">> & {
-        accept: string;
-    };
-    /**
-     * Active locale used to compute {@link ResolvedOptions.strings} and carried
-     * on every request envelope. Concrete (`"auto"` already resolved to a
-     * BCP-47 tag) and clamped into {@link ResolvedOptions.availableLocales}.
-     */
-    locale: string;
-    /**
-     * Deployment fallback locale — concrete. The clamp target when the
-     * detected / persisted / picked locale isn't in `availableLocales`.
-     * Server-authoritative (`config.i18n.defaultLocale` wins over `init`).
-     */
-    defaultLocale: string;
-    /**
-     * Locales offered in the language switcher — the deployment's supported
-     * set, server-authoritative (`config.i18n.availableLocales` wins over
-     * `init`). Single-entry hides the language action.
-     */
-    availableLocales: string[];
-    startMinimized: boolean;
-    actions: ActionList;
-    size: SizeOptions;
-    launcher: Required<Omit<LauncherOptions, "callout" | "label">> & {
-        /** Label is optional even after resolution (`circle` variant has no label). */
-        label?: string;
-        /**
-         * Resolved callout config (defaults filled in) — `null` means no
-         * callout configured (text was empty / unset).
-         */
-        callout: Required<LauncherCalloutOptions> | null;
-    };
-    sound: Required<Omit<SoundOptions, "events">> & {
-        events: SoundOptions["events"];
-    };
-    haptics: Required<Omit<HapticsOptions, "events">> & {
-        events: HapticsOptions["events"];
-    };
-    /**
-     * Fully-resolved string map for the active locale. Pre-computed at
-     * options-resolve time (and after each server-settings merge) so render
-     * paths can read `strings.send` directly without per-call lookup.
-     */
-    strings: Strings;
+  widgetId: string;
+  publicKey?: string;
+  aiAgentDeploymentId?: string;
+  baseUrl: 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;
+  themeMode: ThemePreference;
+  /** Active text size. Default `normal`; the end-user's pick overrides at runtime. */
+  textSize: TextSize;
+  themeOverrides: ThemeOverrides;
+  mode: Mode;
+  iframe: boolean;
+  responseMode: ResponseMode;
+  /** Show reasoning ("thoughts") as a collapsible block. Default `false`. */
+  showReasoning: boolean;
+  /** Show automatic tool calls (details + result) in the transcript. Default `false`. */
+  showToolCalls: boolean;
+  /** Show citation sources (web links + document references) in the transcript. Default `false`. */
+  showSources: boolean;
+  /** Show 👍/👎 feedback controls on rateable (assistant/operator) replies. Default `true`. */
+  enableMessageFeedback: boolean;
+  /** Auto-send a suggestion chip's text on tap (vs. filling the composer to edit). Default `false`. */
+  autoSendSuggestions: boolean;
+  features: ResolvedFeatures;
+  /** Resolved event-driven forms — ordered list + trigger index. */
+  forms: ResolvedForms;
+  endpoints: Required<Endpoints>;
+  attachments: Required<Pick<AttachmentLimits, "maxBytes" | "maxCount">> & {
+    accept: string;
+  };
+  /**
+   * Active locale used to compute {@link ResolvedOptions.strings} and carried
+   * on every request envelope. Concrete (`"auto"` already resolved to a
+   * BCP-47 tag) and clamped into {@link ResolvedOptions.availableLocales}.
+   */
+  locale: string;
+  /**
+   * Deployment fallback locale — concrete. The clamp target when the
+   * detected / persisted / picked locale isn't in `availableLocales`.
+   * Server-authoritative (`config.i18n.defaultLocale` wins over `init`).
+   */
+  defaultLocale: string;
+  /**
+   * Locales offered in the language switcher — the deployment's supported
+   * set, server-authoritative (`config.i18n.availableLocales` wins over
+   * `init`). Single-entry hides the language action.
+   */
+  availableLocales: string[];
+  startMinimized: boolean;
+  actions: ActionList;
+  size: SizeOptions;
+  launcher: Required<Omit<LauncherOptions, "callout" | "label">> & {
+    /** Label is optional even after resolution (`circle` variant has no label). */
+    label?: string;
     /**
-     * The raw {@link StringsOverride} the page-owner / server supplied —
-     * preserved so App can re-resolve into a new locale at runtime when the
-     * user picks one from the language switcher (without forcing a re-mount).
+     * Resolved callout config (defaults filled in) — `null` means no
+     * callout configured (text was empty / unset).
      */
-    stringsOverride?: StringsOverride;
-    composerDisclaimer: string;
-    poweredBy: PoweredByOption | null;
-    composer: {
-        sendButton: Required<SendButtonOptions>;
-    };
-    /** Resolved messenger modules — per-module config + ordered enabled list + default tab. */
-    modules: ResolvedModules;
-    /** Resolved anonymous usage tracking. */
-    tracking: ResolvedTracking;
-    /** Resolved storage adapter — defaults to `LocalStorageAdapter`. */
-    storage: ClientStorage;
-    onMessage?: ChatWidgetOptions["onMessage"];
-    onOpen?: ChatWidgetOptions["onOpen"];
-    onClose?: ChatWidgetOptions["onClose"];
-    onError?: ChatWidgetOptions["onError"];
+    callout: Required<LauncherCalloutOptions> | null;
+  };
+  sound: Required<Omit<SoundOptions, "events">> & {
+    events: SoundOptions["events"];
+  };
+  haptics: Required<Omit<HapticsOptions, "events">> & {
+    events: HapticsOptions["events"];
+  };
+  /**
+   * Fully-resolved string map for the active locale. Pre-computed at
+   * options-resolve time (and after each server-settings merge) so render
+   * paths can read `strings.send` directly without per-call lookup.
+   */
+  strings: Strings;
+  /**
+   * The raw {@link StringsOverride} the page-owner / server supplied —
+   * preserved so App can re-resolve into a new locale at runtime when the
+   * user picks one from the language switcher (without forcing a re-mount).
+   */
+  stringsOverride?: StringsOverride;
+  composerDisclaimer: string;
+  poweredBy: PoweredByOption | null;
+  composer: {
+    sendButton: Required<SendButtonOptions>;
+  };
+  /** Resolved messenger modules — per-module config + ordered enabled list + default tab. */
+  modules: ResolvedModules;
+  /** Resolved anonymous usage tracking. */
+  tracking: ResolvedTracking;
+  /** Resolved storage adapter — defaults to `LocalStorageAdapter`. */
+  storage: ClientStorage;
+  onMessage?: ChatWidgetOptions["onMessage"];
+  onOpen?: ChatWidgetOptions["onOpen"];
+  onClose?: ChatWidgetOptions["onClose"];
+  onError?: ChatWidgetOptions["onError"];
 }
 /**
  * Shape of the server-pushed `widget` object in `HandshakeResponse`.
@@ -1273,32 +1262,33 @@ interface ResolvedOptions {
  * the data-API (`GET /forms`). A stale backend still pushing
  * `config.forms` is ignored.
  */
-interface ServerConfig {
-    /** Data-API base override — adopted only when the host didn't set one. */
-    dataApiBaseUrl?: string;
-    /**
-     * Storage-schema version — the deployment-owned force-reset lever, pushed ONLY
-     * via the handshake (deliberately not an embed attribute / `init` option).
-     * Pushing a new value abandons every client's prior storage namespace
-     * (visitor id, conversation, prefs, panel state, caches) on next load. The
-     * widget stashes it and the next mount folds `.v<version>` into every key.
-     */
-    storageVersion?: string;
-    presentation?: PresentationOptions;
-    behavior?: BehaviorOptions;
-    theme?: ThemePreference | ThemeOverrides;
-    launcher?: LauncherOptions;
-    header?: HeaderOptions;
-    composer?: ComposerOptions;
-    feedback?: FeedbackOptions;
-    i18n?: I18nOptions;
-    footer?: FooterOptions;
-    features?: FeatureFlags;
-    modules?: ModulesOptions;
-    tracking?: TrackingOptions;
-    endpoints?: Endpoints;
+interface ServerConfig$1 {
+  /** Data-API base override — adopted only when the host didn't set one. */
+  dataApiBaseUrl?: string;
+  /**
+   * Storage-schema version — the deployment-owned force-reset lever, pushed ONLY
+   * via the handshake (deliberately not an embed attribute / `init` option).
+   * Pushing a new value abandons every client's prior storage namespace
+   * (visitor id, conversation, prefs, panel state, caches) on next load. The
+   * widget stashes it and the next mount folds `.v<version>` into every key.
+   */
+  storageVersion?: string;
+  presentation?: PresentationOptions;
+  behavior?: BehaviorOptions;
+  theme?: ThemePreference | ThemeOverrides;
+  launcher?: LauncherOptions;
+  header?: HeaderOptions;
+  composer?: ComposerOptions;
+  feedback?: FeedbackOptions;
+  i18n?: I18nOptions;
+  footer?: FooterOptions;
+  features?: FeatureFlags;
+  modules?: ModulesOptions;
+  tracking?: TrackingOptions;
+  endpoints?: Endpoints;
 }
-
+//#endregion
+//#region src/core/logger.d.ts
 /**
  * Comprehensive logger for the widget runtime.
  *
@@ -1325,23 +1315,14 @@ interface ServerConfig {
 type LogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
 /** One structured line, as forwarded to an external {@link setLogSink} sink. */
 interface LogEntry {
-    level: LogLevel;
-    /** Subsystem tag, e.g. `"transport"` or `"core:hooks"`. */
-    scope: string;
-    message: string;
-    payload?: unknown;
+  level: LogLevel;
+  /** Subsystem tag, e.g. `"transport"` or `"core:hooks"`. */
+  scope: string;
+  message: string;
+  payload?: unknown;
 }
-
-/**
- * Tiny typed pub/sub for widget lifecycle events.
- *
- * Insulates UI components from the public callback shape, and gives us room
- * to add listeners (analytics, logging) without touching the UI.
- *
- * All listeners are isolated — a throw in one never breaks the widget or
- * prevents other listeners from firing.
- */
-
+//#endregion
+//#region src/core/events.d.ts
 /**
  * Payload shape per event. Keyed by event name; use `void` for events that
  * carry no data.
@@ -1352,200 +1333,168 @@ interface LogEntry {
  * structured logger at `info` level when `debug` is enabled.
  */
 interface EventMap {
-    /** Panel opened (floating / modal / drawer). */
-    open: void;
-    /** Panel closed. */
-    close: void;
-    /** Expanded mode toggled (1.5× size). Payload is the new state. */
-    expand: boolean;
-    /** Fullscreen mode toggled. Payload is the new state. */
-    fullscreen: boolean;
-    /** End-user dragged the resize grip — payload is the resolved size. */
-    resize: {
-        width: number;
-        height: number;
-    };
-    /** A message was exchanged. Fires for both user and assistant messages. */
-    message: {
-        role: string;
-        text: string;
-    };
-    /** User submitted a message (fires before the request is sent). */
-    send: {
-        text: string;
-        attachmentCount: number;
-    };
-    /** User cancelled an in-flight stream. */
-    stop: void;
-    /** Clear / new-conversation requested. */
-    clear: void;
-    /** User picked a chat from the history pane / sidebar. */
-    selectConversation: {
-        conversationId: string;
-    };
-    /** User clicked a suggested-message chip. */
-    suggestion: {
-        text: string;
-    };
-    /** History pane toggled. Payload is the resulting view. */
-    toggleHistory: {
-        view: "chat" | "history";
-    };
-    /** A form (intake, CSAT, …) was completed or skipped. */
-    formSubmit: {
-        formId: string;
-        values: Record<string, string>;
-        skipped: boolean;
-    };
-    /** User answered an ask-questions tool request (re-POST follows). */
-    toolResult: {
-        toolCallId: string;
-    };
-    /** User approved / rejected a gated tool call (re-POST follows). */
-    toolDecision: {
-        toolCallId: string;
-        approved: boolean;
-    };
-    /**
-     * User gave feedback on an assistant reply. `value` is `"up"` / `"down"`, or
-     * `null` when they cleared a prior choice. `messageId` is the backend message
-     * id. Also POSTed best-effort to `/pai/message-feedback`; a host listener can
-     * mirror it to analytics.
-     */
-    messageFeedback: {
-        messageId: string;
-        value: FeedbackValue;
-    };
-    /** A content list (news / help / home block) rendered. */
-    contentView: {
-        section: string;
-        tags?: string;
-        count: number;
-    };
-    /** An article / content item was opened. */
-    contentOpen: {
-        contentId: string;
-        tags?: string;
-    };
-    /** The help search ran. Length + hit count only — never the query text. */
-    contentSearch: {
-        queryLength: number;
-        hitCount: number;
-    };
-    /** An opened article was read (dwell threshold passed). Fires once per open. */
-    contentRead: {
-        contentId: string;
-    };
-    /** A link inside an opened article was followed. */
-    contentLinkClick: {
-        contentId: string;
-    };
-    /** Files attached (drag-drop, file picker, paste). */
-    attach: {
-        count: number;
-        totalBytes: number;
-    };
-    /** An attachment was removed before send. */
-    removeAttachment: {
-        id: string;
-    };
-    /** Voice recording started. */
-    voiceStart: void;
-    /** Voice recording stopped and was sent for transcription. */
-    voiceStop: {
-        durationMs: number;
-    };
-    /** Voice recording cancelled (e.g. user released outside the button). */
-    voiceCancel: void;
-    /** End-user picked a different UI locale. Payload is the new BCP-47 tag. */
-    localeChange: string;
-    /** End-user picked a different theme mode (`auto` / `light` / `dark`). */
-    themeChange: ThemePreference;
-    /** End-user picked a different text size (`small` / `normal` / `large`). */
-    textSizeChange: TextSize;
-    /** End-user toggled the global sound mute. */
-    soundToggle: {
-        muted: boolean;
-    };
-    /** Page-mode sidebar collapsed / expanded. */
-    sidebarToggle: {
-        collapsed: boolean;
-    };
-    /** Pre-engagement launcher callout dismissed. */
-    calloutDismiss: void;
-    /** An unhandled error occurred somewhere in the transport or UI. */
-    error: unknown;
-    /** Connect bootstrap succeeded. Payload is the typed server response. */
-    handshake: HandshakeResponse;
-    /**
-     * Server rebound the `visitorId` — e.g. the client-minted id
-     * conflicted with an existing record, was expired, or otherwise
-     * rejected, and the server returned a fresh one in the
-     * `/handshake` response. The widget has already adopted the new
-     * id and persisted it; this event is informational so host pages
-     * can re-link analytics / external systems that pinned the
-     * previous value.
-     *
-     * `reason` is the server's explanation, when provided
-     * (`rebind.visitorId` in the handshake response). Common values:
-     * `"conflict"` / `"expired"` / `"invalid"`. May be `undefined` if
-     * the server didn't include a `rebind` block.
-     */
-    visitorRebound: {
-        previous: string;
-        current: string;
-        reason?: string;
-    };
-    /**
-     * Server rebound the `conversationId` — same shape and semantics as
-     * `visitorRebound` but for the conversation-thread id. Fires when
-     * the server's response carries a different `conversationId` than the
-     * client sent.
-     */
-    conversationRebound: {
-        previous: string;
-        current: string;
-        reason?: string;
-    };
+  /** Panel opened (floating / modal / drawer). */
+  open: void;
+  /** Panel closed. */
+  close: void;
+  /** Expanded mode toggled (1.5× size). Payload is the new state. */
+  expand: boolean;
+  /** Fullscreen mode toggled. Payload is the new state. */
+  fullscreen: boolean;
+  /** End-user dragged the resize grip — payload is the resolved size. */
+  resize: {
+    width: number;
+    height: number;
+  };
+  /** A message was exchanged. Fires for user, assistant, and operator messages. */
+  message: {
+    role: string;
+    text: string;
+  };
+  /** User submitted a message (fires before the request is sent). */
+  send: {
+    text: string;
+    attachmentCount: number;
+  };
+  /** User cancelled an in-flight stream. */
+  stop: void;
+  /** Clear / new-conversation requested. */
+  clear: void;
+  /** User picked a chat from the history pane / sidebar. */
+  selectConversation: {
+    conversationId: string;
+  };
+  /** User clicked a suggested-message chip. */
+  suggestion: {
+    text: string;
+  };
+  /** History pane toggled. Payload is the resulting view. */
+  toggleHistory: {
+    view: "chat" | "history";
+  };
+  /** A form (intake, CSAT, …) was completed or skipped. */
+  formSubmit: {
+    formId: string;
+    values: Record<string, string>;
+    skipped: boolean;
+  };
+  /** User answered an ask-questions tool request (re-POST follows). */
+  toolResult: {
+    toolCallId: string;
+  };
+  /** User approved / rejected a gated tool call (re-POST follows). */
+  toolDecision: {
+    toolCallId: string;
+    approved: boolean;
+  };
+  /**
+   * User gave feedback on a rateable reply (AI or operator). `value` is `"up"` / `"down"`, or
+   * `null` when they cleared a prior choice. `messageId` is the backend message
+   * id. Also POSTed best-effort to `/pai/message-feedback`; a host listener can
+   * mirror it to analytics.
+   */
+  messageFeedback: {
+    messageId: string;
+    value: FeedbackValue;
+  };
+  /** A content list (news / help / home block) rendered. */
+  contentView: {
+    section: string;
+    tags?: string;
+    count: number;
+  };
+  /** An article / content item was opened. */
+  contentOpen: {
+    contentId: string;
+    tags?: string;
+  };
+  /** The help search ran. Length + hit count only — never the query text. */
+  contentSearch: {
+    queryLength: number;
+    hitCount: number;
+  };
+  /** An opened article was read (dwell threshold passed). Fires once per open. */
+  contentRead: {
+    contentId: string;
+  };
+  /** A link inside an opened article was followed. */
+  contentLinkClick: {
+    contentId: string;
+  };
+  /** Files attached (drag-drop, file picker, paste). */
+  attach: {
+    count: number;
+    totalBytes: number;
+  };
+  /** An attachment was removed before send. */
+  removeAttachment: {
+    id: string;
+  };
+  /** Voice recording started. */
+  voiceStart: void;
+  /** Voice recording stopped and was sent for transcription. */
+  voiceStop: {
+    durationMs: number;
+  };
+  /** Voice recording cancelled (e.g. user released outside the button). */
+  voiceCancel: void;
+  /** End-user picked a different UI locale. Payload is the new BCP-47 tag. */
+  localeChange: string;
+  /** End-user picked a different theme mode (`auto` / `light` / `dark`). */
+  themeChange: ThemePreference;
+  /** End-user picked a different text size (`small` / `normal` / `large`). */
+  textSizeChange: TextSize;
+  /** End-user toggled the global sound mute. */
+  soundToggle: {
+    muted: boolean;
+  };
+  /** Page-mode sidebar collapsed / expanded. */
+  sidebarToggle: {
+    collapsed: boolean;
+  };
+  /** Pre-engagement launcher callout dismissed. */
+  calloutDismiss: void;
+  /** An unhandled error occurred somewhere in the transport or UI. */
+  error: unknown;
+  /** Connect bootstrap succeeded. Payload is the typed server response. */
+  handshake: HandshakeResponse$1;
+  /**
+   * Server rebound the `visitorId` — e.g. the client-minted id
+   * conflicted with an existing record, was expired, or otherwise
+   * rejected, and the server returned a fresh one in the
+   * `/handshake` response. The widget has already adopted the new
+   * id and persisted it; this event is informational so host pages
+   * can re-link analytics / external systems that pinned the
+   * previous value.
+   *
+   * `reason` is the server's explanation, when provided
+   * (`rebind.visitorId` in the handshake response). Common values:
+   * `"conflict"` / `"expired"` / `"invalid"`. May be `undefined` if
+   * the server didn't include a `rebind` block.
+   */
+  visitorRebound: {
+    previous: string;
+    current: string;
+    reason?: string;
+  };
+  /**
+   * Server rebound the `conversationId` — same shape and semantics as
+   * `visitorRebound` but for the conversation-thread id. Fires when
+   * the server's response carries a different `conversationId` than the
+   * client sent.
+   */
+  conversationRebound: {
+    previous: string;
+    current: string;
+    reason?: string;
+  };
 }
 type EventName = keyof EventMap;
-
-/**
- * Derives the `data-mode` attribute value from App state.
- *
- * Kept as a pure helper (no DOM, no React) so tests can pin the critical
- * invariants cheaply:
- *
- * - `isOpen === false` → `"closed"` regardless of `panelSize`.
- *   This is the reason closing from fullscreen doesn't hide the launcher:
- *   the `[data-mode="fullscreen"] .__P__-fab { display: none }` rule never
- *   matches when the widget is closed.
- * - `panelSize` is preserved across close → open, so reopening the widget
- *   restores the user's last layout (normal / expanded / fullscreen).
- * - Inline + standalone are terminal modes: they override any panelSize
- *   because the widget isn't a popover and can't be "closed".
- */
-
+//#endregion
+//#region src/ui/host-mode.d.ts
 type HostMode = "page" | "standalone" | "inline" | "modal" | "drawer" | "fullscreen" | "expanded" | "open" | "closed";
-
-/**
- * Shared widget runtime — the one composition both entry points wrap around
- * `<App>`.
- *
- * `mount()` (`src/index.ts`, programmatic, `widgetId`-keyed registry, returns a
- * handle) and `<web-ai-chat>` (`src/web-component.ts`, declarative, N-per-page,
- * no registry) used to each hand-roll the same four things around the App tree:
- * the ErrorBoundary wrapper, the handshake-config merge, the usage tracker, and
- * the host-attribute application (position / theme / `data-mode`). That parallel
- * code drifted three separate times (mode-merge, tracker, ErrorBoundary). This
- * module is the single source of that composition so it can't drift again — both
- * entry points only own what's genuinely theirs (mount: iframe + handle + hooks
- * + registry; web-component: attribute parsing + the custom-element lifecycle).
- *
- * Lives at the composition-root level (peer to the entry files), not in `core/`,
- * because it imports Preact + UI + shadow adapters — `core/**` is framework-free.
- */
-
+//#endregion
+//#region src/boot.d.ts
 /**
  * Determine what `data-mode` the host should start at — matching what App's
  * mount-time `useEffect` will produce on its first render. Used for the initial
@@ -1558,35 +1507,8 @@ type HostMode = "page" | "standalone" | "inline" | "modal" | "drawer" | "fullscr
  * first effect (the closed→open→closed flicker this pins against).
  */
 declare function resolveInitialHostMode(options: ResolvedOptions): HostMode;
-
-/**
- * Global lifecycle-hook registry.
- *
- * Per-instance events (`open`, `close`, `message`, …) are already delivered
- * to subscribers via each widget's {@link EventBus}. That works well for
- * callers who hold a direct handle to the instance — but not for the
- * zero-JS `<script data-*>` embed path, and not for analytics wiring that
- * wants to hear from *every* widget without knowing their ids in advance.
- *
- * This module plugs that gap. Hooks are registered against a widgetId
- * (exact or `"*"`) and an event name (exact or `"*"`), and fire with a
- * unified signature — `(instance, event, data)` — so a single callback can
- * handle any event on any widget:
- *
- * ```ts
- * HelpAI.hook("*", "*", (inst, event, data) => analytics.track(event, { widget: inst.widgetId }));
- * HelpAI.hook("support", "message", (inst, _event, data) => log(`[${inst.widgetId}] ${data.role}: ${data.text}`));
- * ```
- *
- * Registration order is irrelevant — hooks may be added before the bundle
- * loads (via the pre-boot queue) or after any number of instances are
- * already mounted. Live instances are subscribed retroactively.
- *
- * Listeners are isolated: a throw in one never breaks the widget or
- * prevents other listeners from firing. Same contract as the per-instance
- * bus.
- */
-
+//#endregion
+//#region src/core/hooks.d.ts
 /** Wildcard that matches every widget id / every event name. */
 declare const HOOK_WILDCARD = "*";
 /**
@@ -1603,116 +1525,2063 @@ declare const HOOK_WILDCARD = "*";
  * ```
  */
 type HookListener = (instance: ChatWidgetInstance, event: EventName, data: unknown) => void;
-
-/**
- * Public ESM entry for `@<brand>/elements`.
- *
- * This module is side-effect free — importing it does not mount anything or
- * touch the DOM. Call {@link mount} or {@link init} to render the widget.
- *
- * The Web Component (`<{brand}-chat>`) lives in a separate sub-entry
- * (`./web-component`) so tree-shakers can drop the custom-element machinery
- * when it isn't used.
- *
- * @example
- * ```ts
- * import { mount } from '@helpai/elements';
- *
- * const chat = mount({
- *   publicKey: 'agent_pk_...',
- *   mode: 'inline',
- *   target: document.getElementById('chat'),
- * });
- *
- * chat.on('message', (m) => console.log(m));
- * ```
- *
- * @packageDocumentation
- */
-
+//#endregion
+//#region src/schema/primitives.d.ts
+/** A single image asset (logo, hero, icon). */
+declare const assetSchema: z.ZodObject<{
+  url: z.ZodString;
+  alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type Asset = z.infer<typeof assetSchema>;
+/** A navigation link / link card. `href` is optional so it can also be used as a heading. */
+declare const linkSchema: z.ZodObject<{
+  id: z.ZodOptional<z.ZodString>;
+  label: z.ZodString;
+  href: z.ZodOptional<z.ZodString>;
+  icon: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type Link = z.infer<typeof linkSchema>;
+//#endregion
+//#region src/schema/widget.d.ts
+/**
+ * Where the widget talks to and how it authenticates. Owned by the
+ * **embedding developer** — typically baked into the page template or
+ * an env var, not user-editable. Distinct from {@link widgetSettingsSchema}
+ * which is the dashboard-pushed UX surface.
+ */
+declare const connectionConfigSchema: z.ZodObject<{
+  widgetId: z.ZodDefault<z.ZodString>;
+  publicKey: z.ZodOptional<z.ZodString>;
+  aiAgentDeploymentId: z.ZodOptional<z.ZodString>;
+  baseUrl: z.ZodOptional<z.ZodString>;
+  agentApiBaseUrl: z.ZodOptional<z.ZodString>;
+  dataApiBaseUrl: z.ZodOptional<z.ZodString>;
+  userContext: z.ZodOptional<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+  pageContext: z.ZodOptional<z.ZodObject<{
+    area: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+  endpoints: z.ZodOptional<z.ZodObject<{
+    upload: z.ZodDefault<z.ZodString>;
+    transcribe: z.ZodDefault<z.ZodString>;
+    submitForm: z.ZodDefault<z.ZodString>;
+  }, z.core.$loose>>;
+  debug: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+    trace: "trace";
+  }>]>>;
+}, z.core.$loose>;
+type ConnectionConfig = z.infer<typeof connectionConfigSchema>;
+/**
+ * Everything that controls **how the widget looks and behaves** —
+ * the UX surface a dashboard / customer-success operator would
+ * configure. The backend pushes this same shape on
+ * `/pai/handshake` (under `config`); the dev configurator lets
+ * you edit it in real time.
+ *
+ * Composed from the section schemas under `./widget/*` so the
+ * dashboard form has obvious tabs without extra metadata.
+ */
+declare const widgetSettingsSchema: z.ZodObject<{
+  presentation: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      floating: "floating";
+      inline: "inline";
+      standalone: "standalone";
+      page: "page";
+      modal: "modal";
+      drawer: "drawer";
+    }>>;
+    position: z.ZodDefault<z.ZodEnum<{
+      "bottom-right": "bottom-right";
+      "bottom-left": "bottom-left";
+      "top-right": "top-right";
+      "top-left": "top-left";
+    }>>;
+    iframe: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodObject<{
+      width: z.ZodOptional<z.ZodString>;
+      height: z.ZodOptional<z.ZodString>;
+      expanded: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      resize: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minWidth: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        minHeight: z.ZodOptional<z.ZodString>;
+        maxHeight: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      inset: z.ZodOptional<z.ZodString>;
+      initialSize: z.ZodDefault<z.ZodEnum<{
+        fullscreen: "fullscreen";
+        expanded: "expanded";
+        normal: "normal";
+        auto: "auto";
+      }>>;
+      autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  behavior: z.ZodOptional<z.ZodObject<{
+    startMinimized: z.ZodDefault<z.ZodBoolean>;
+    responseMode: z.ZodDefault<z.ZodEnum<{
+      streaming: "streaming";
+      buffered: "buffered";
+    }>>;
+    showReasoning: z.ZodDefault<z.ZodBoolean>;
+    showToolCalls: z.ZodDefault<z.ZodBoolean>;
+    showSources: z.ZodDefault<z.ZodBoolean>;
+    disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>;
+  theme: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+  }>, z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentText: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    contentMaxWidth: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>;
+  launcher: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+      circle: "circle";
+      pill: "pill";
+      bar: "bar";
+      minimal: "minimal";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    callout: z.ZodOptional<z.ZodObject<{
+      text: z.ZodDefault<z.ZodString>;
+      shape: z.ZodDefault<z.ZodEnum<{
+        pill: "pill";
+        bubble: "bubble";
+        callout: "callout";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        horizontal: "horizontal";
+        vertical: "vertical";
+      }>>;
+      delayMs: z.ZodDefault<z.ZodNumber>;
+      autoDismissMs: z.ZodDefault<z.ZodNumber>;
+      animated: z.ZodDefault<z.ZodBoolean>;
+      persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  header: z.ZodOptional<z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      close: "close";
+      expand: "expand";
+      fullscreen: "fullscreen";
+      clear: "clear";
+      theme: "theme";
+      sound: "sound";
+      history: "history";
+      language: "language";
+      textSize: "textSize";
+    }>>>;
+  }, z.core.$loose>>;
+  composer: z.ZodOptional<z.ZodObject<{
+    sendButton: z.ZodOptional<z.ZodObject<{
+      shape: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        square: "square";
+      }>>;
+      icon: z.ZodDefault<z.ZodEnum<{
+        send: "send";
+        arrowUp: "arrowUp";
+        paperPlane: "paperPlane";
+        chevron: "chevron";
+      }>>;
+      variant: z.ZodDefault<z.ZodEnum<{
+        filled: "filled";
+        outline: "outline";
+        ghost: "ghost";
+      }>>;
+    }, z.core.$loose>>;
+    attachments: z.ZodOptional<z.ZodObject<{
+      maxBytes: z.ZodDefault<z.ZodNumber>;
+      maxCount: z.ZodDefault<z.ZodNumber>;
+      accept: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  feedback: z.ZodOptional<z.ZodObject<{
+    sound: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      volume: z.ZodDefault<z.ZodNumber>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    }, z.core.$loose>>;
+    haptics: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  i18n: z.ZodOptional<z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+    availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+  }, z.core.$loose>>;
+  footer: z.ZodOptional<z.ZodObject<{
+    poweredBy: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodURL>;
+      logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$loose>>;
+    composerDisclaimer: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+  features: z.ZodOptional<z.ZodObject<{
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodEnum<{
+      local: "local";
+      server: "server";
+      disabled: "disabled";
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      code: z.ZodString;
+      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>]>>>;
+    disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+    enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>;
+  forms: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    on: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    when: z.ZodOptional<z.ZodObject<{
+      missingContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      pageArea: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      minMessages: z.ZodOptional<z.ZodNumber>;
+      maxMessages: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        number: "number";
+        url: "url";
+        email: "email";
+        date: "date";
+        text: "text";
+        tel: "tel";
+        time: "time";
+        textarea: "textarea";
+        select: "select";
+        radio: "radio";
+        checkbox: "checkbox";
+        multiselect: "multiselect";
+      }>;
+      placeholder: z.ZodOptional<z.ZodString>;
+      required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+      defaultValue: z.ZodOptional<z.ZodString>;
+      options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      validation: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodOptional<z.ZodString>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        minSelections: z.ZodOptional<z.ZodNumber>;
+        maxSelections: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$loose>>;
+      allowOther: z.ZodOptional<z.ZodBoolean>;
+      validationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+    frequency: z.ZodDefault<z.ZodEnum<{
+      once: "once";
+      conversation: "conversation";
+      always: "always";
+    }>>;
+    mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      submitLabel: z.ZodOptional<z.ZodString>;
+      fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        validationHint: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          value: z.ZodString;
+          label: z.ZodOptional<z.ZodString>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+      }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>;
+  modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    layout: z.ZodEnum<{
+      home: "home";
+      chat: "chat";
+      help: "help";
+      news: "news";
+    }>;
+    contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
+    brandName: z.ZodOptional<z.ZodString>;
+    hideGreeting: z.ZodOptional<z.ZodBoolean>;
+    greetingText: z.ZodOptional<z.ZodString>;
+    userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      avatar: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+    hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      level: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contentBlockTitle: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  tracking: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type WidgetSettings = z.infer<typeof widgetSettingsSchema>;
+/**
+ * Full client widget config — connection + widget settings + page-mode
+ * extras. The dashboard / dev configurator typically only edits one
+ * of the two halves at a time (`widgetSettingsSchema` for the dashboard
+ * surface, `connectionConfigSchema` for the developer-facing fields).
+ */
+declare const widgetConfigSchema: z.ZodObject<{
+  widgetId: z.ZodDefault<z.ZodString>;
+  publicKey: z.ZodOptional<z.ZodString>;
+  aiAgentDeploymentId: z.ZodOptional<z.ZodString>;
+  baseUrl: z.ZodOptional<z.ZodString>;
+  agentApiBaseUrl: z.ZodOptional<z.ZodString>;
+  dataApiBaseUrl: z.ZodOptional<z.ZodString>;
+  userContext: z.ZodOptional<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+  pageContext: z.ZodOptional<z.ZodObject<{
+    area: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+  endpoints: z.ZodOptional<z.ZodObject<{
+    upload: z.ZodDefault<z.ZodString>;
+    transcribe: z.ZodDefault<z.ZodString>;
+    submitForm: z.ZodDefault<z.ZodString>;
+  }, z.core.$loose>>;
+  debug: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+    trace: "trace";
+  }>]>>;
+  site: z.ZodOptional<z.ZodUnknown>;
+  blocks: z.ZodOptional<z.ZodUnknown>;
+  presentation: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      floating: "floating";
+      inline: "inline";
+      standalone: "standalone";
+      page: "page";
+      modal: "modal";
+      drawer: "drawer";
+    }>>;
+    position: z.ZodDefault<z.ZodEnum<{
+      "bottom-right": "bottom-right";
+      "bottom-left": "bottom-left";
+      "top-right": "top-right";
+      "top-left": "top-left";
+    }>>;
+    iframe: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodObject<{
+      width: z.ZodOptional<z.ZodString>;
+      height: z.ZodOptional<z.ZodString>;
+      expanded: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      resize: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minWidth: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        minHeight: z.ZodOptional<z.ZodString>;
+        maxHeight: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      inset: z.ZodOptional<z.ZodString>;
+      initialSize: z.ZodDefault<z.ZodEnum<{
+        fullscreen: "fullscreen";
+        expanded: "expanded";
+        normal: "normal";
+        auto: "auto";
+      }>>;
+      autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  behavior: z.ZodOptional<z.ZodObject<{
+    startMinimized: z.ZodDefault<z.ZodBoolean>;
+    responseMode: z.ZodDefault<z.ZodEnum<{
+      streaming: "streaming";
+      buffered: "buffered";
+    }>>;
+    showReasoning: z.ZodDefault<z.ZodBoolean>;
+    showToolCalls: z.ZodDefault<z.ZodBoolean>;
+    showSources: z.ZodDefault<z.ZodBoolean>;
+    disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>;
+  theme: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+  }>, z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentText: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    contentMaxWidth: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>;
+  launcher: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+      circle: "circle";
+      pill: "pill";
+      bar: "bar";
+      minimal: "minimal";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    callout: z.ZodOptional<z.ZodObject<{
+      text: z.ZodDefault<z.ZodString>;
+      shape: z.ZodDefault<z.ZodEnum<{
+        pill: "pill";
+        bubble: "bubble";
+        callout: "callout";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        horizontal: "horizontal";
+        vertical: "vertical";
+      }>>;
+      delayMs: z.ZodDefault<z.ZodNumber>;
+      autoDismissMs: z.ZodDefault<z.ZodNumber>;
+      animated: z.ZodDefault<z.ZodBoolean>;
+      persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  header: z.ZodOptional<z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      close: "close";
+      expand: "expand";
+      fullscreen: "fullscreen";
+      clear: "clear";
+      theme: "theme";
+      sound: "sound";
+      history: "history";
+      language: "language";
+      textSize: "textSize";
+    }>>>;
+  }, z.core.$loose>>;
+  composer: z.ZodOptional<z.ZodObject<{
+    sendButton: z.ZodOptional<z.ZodObject<{
+      shape: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        square: "square";
+      }>>;
+      icon: z.ZodDefault<z.ZodEnum<{
+        send: "send";
+        arrowUp: "arrowUp";
+        paperPlane: "paperPlane";
+        chevron: "chevron";
+      }>>;
+      variant: z.ZodDefault<z.ZodEnum<{
+        filled: "filled";
+        outline: "outline";
+        ghost: "ghost";
+      }>>;
+    }, z.core.$loose>>;
+    attachments: z.ZodOptional<z.ZodObject<{
+      maxBytes: z.ZodDefault<z.ZodNumber>;
+      maxCount: z.ZodDefault<z.ZodNumber>;
+      accept: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  feedback: z.ZodOptional<z.ZodObject<{
+    sound: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      volume: z.ZodDefault<z.ZodNumber>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    }, z.core.$loose>>;
+    haptics: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>;
+  i18n: z.ZodOptional<z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+    availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+  }, z.core.$loose>>;
+  footer: z.ZodOptional<z.ZodObject<{
+    poweredBy: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodURL>;
+      logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$loose>>;
+    composerDisclaimer: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+  features: z.ZodOptional<z.ZodObject<{
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodEnum<{
+      local: "local";
+      server: "server";
+      disabled: "disabled";
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      code: z.ZodString;
+      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>]>>>;
+    disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+    enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>;
+  forms: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    on: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    when: z.ZodOptional<z.ZodObject<{
+      missingContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      pageArea: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      minMessages: z.ZodOptional<z.ZodNumber>;
+      maxMessages: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        number: "number";
+        url: "url";
+        email: "email";
+        date: "date";
+        text: "text";
+        tel: "tel";
+        time: "time";
+        textarea: "textarea";
+        select: "select";
+        radio: "radio";
+        checkbox: "checkbox";
+        multiselect: "multiselect";
+      }>;
+      placeholder: z.ZodOptional<z.ZodString>;
+      required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+      defaultValue: z.ZodOptional<z.ZodString>;
+      options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      validation: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodOptional<z.ZodString>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        minSelections: z.ZodOptional<z.ZodNumber>;
+        maxSelections: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$loose>>;
+      allowOther: z.ZodOptional<z.ZodBoolean>;
+      validationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+    frequency: z.ZodDefault<z.ZodEnum<{
+      once: "once";
+      conversation: "conversation";
+      always: "always";
+    }>>;
+    mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      submitLabel: z.ZodOptional<z.ZodString>;
+      fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        validationHint: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          value: z.ZodString;
+          label: z.ZodOptional<z.ZodString>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+      }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>;
+  modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    layout: z.ZodEnum<{
+      home: "home";
+      chat: "chat";
+      help: "help";
+      news: "news";
+    }>;
+    contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
+    brandName: z.ZodOptional<z.ZodString>;
+    hideGreeting: z.ZodOptional<z.ZodBoolean>;
+    greetingText: z.ZodOptional<z.ZodString>;
+    userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      avatar: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+    hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      level: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contentBlockTitle: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  tracking: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type WidgetConfig = z.infer<typeof widgetConfigSchema>;
+/**
+ * Partial schema — used when validating server-pushed patches that
+ * override individual fields on top of the resolved config. Every field
+ * becomes optional; defaults are NOT applied.
+ */
+declare const widgetConfigPartialSchema: z.ZodObject<{
+  widgetId: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  publicKey: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  aiAgentDeploymentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  baseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  agentApiBaseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  dataApiBaseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  userContext: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>>;
+  pageContext: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    area: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>>;
+  endpoints: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    upload: z.ZodDefault<z.ZodString>;
+    transcribe: z.ZodDefault<z.ZodString>;
+    submitForm: z.ZodDefault<z.ZodString>;
+  }, z.core.$loose>>>;
+  debug: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+    trace: "trace";
+  }>]>>>;
+  site: z.ZodOptional<z.ZodOptional<z.ZodUnknown>>;
+  blocks: z.ZodOptional<z.ZodOptional<z.ZodUnknown>>;
+  presentation: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      floating: "floating";
+      inline: "inline";
+      standalone: "standalone";
+      page: "page";
+      modal: "modal";
+      drawer: "drawer";
+    }>>;
+    position: z.ZodDefault<z.ZodEnum<{
+      "bottom-right": "bottom-right";
+      "bottom-left": "bottom-left";
+      "top-right": "top-right";
+      "top-left": "top-left";
+    }>>;
+    iframe: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodObject<{
+      width: z.ZodOptional<z.ZodString>;
+      height: z.ZodOptional<z.ZodString>;
+      expanded: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      resize: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minWidth: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        minHeight: z.ZodOptional<z.ZodString>;
+        maxHeight: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      inset: z.ZodOptional<z.ZodString>;
+      initialSize: z.ZodDefault<z.ZodEnum<{
+        fullscreen: "fullscreen";
+        expanded: "expanded";
+        normal: "normal";
+        auto: "auto";
+      }>>;
+      autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  behavior: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    startMinimized: z.ZodDefault<z.ZodBoolean>;
+    responseMode: z.ZodDefault<z.ZodEnum<{
+      streaming: "streaming";
+      buffered: "buffered";
+    }>>;
+    showReasoning: z.ZodDefault<z.ZodBoolean>;
+    showToolCalls: z.ZodDefault<z.ZodBoolean>;
+    showSources: z.ZodDefault<z.ZodBoolean>;
+    disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  theme: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+  }>, z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentText: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    contentMaxWidth: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>>;
+  launcher: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+      circle: "circle";
+      pill: "pill";
+      bar: "bar";
+      minimal: "minimal";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    callout: z.ZodOptional<z.ZodObject<{
+      text: z.ZodDefault<z.ZodString>;
+      shape: z.ZodDefault<z.ZodEnum<{
+        pill: "pill";
+        bubble: "bubble";
+        callout: "callout";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        horizontal: "horizontal";
+        vertical: "vertical";
+      }>>;
+      delayMs: z.ZodDefault<z.ZodNumber>;
+      autoDismissMs: z.ZodDefault<z.ZodNumber>;
+      animated: z.ZodDefault<z.ZodBoolean>;
+      persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  header: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      close: "close";
+      expand: "expand";
+      fullscreen: "fullscreen";
+      clear: "clear";
+      theme: "theme";
+      sound: "sound";
+      history: "history";
+      language: "language";
+      textSize: "textSize";
+    }>>>;
+  }, z.core.$loose>>>;
+  composer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sendButton: z.ZodOptional<z.ZodObject<{
+      shape: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        square: "square";
+      }>>;
+      icon: z.ZodDefault<z.ZodEnum<{
+        send: "send";
+        arrowUp: "arrowUp";
+        paperPlane: "paperPlane";
+        chevron: "chevron";
+      }>>;
+      variant: z.ZodDefault<z.ZodEnum<{
+        filled: "filled";
+        outline: "outline";
+        ghost: "ghost";
+      }>>;
+    }, z.core.$loose>>;
+    attachments: z.ZodOptional<z.ZodObject<{
+      maxBytes: z.ZodDefault<z.ZodNumber>;
+      maxCount: z.ZodDefault<z.ZodNumber>;
+      accept: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  feedback: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sound: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      volume: z.ZodDefault<z.ZodNumber>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    }, z.core.$loose>>;
+    haptics: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  i18n: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+    availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+  }, z.core.$loose>>>;
+  footer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    poweredBy: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodURL>;
+      logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$loose>>;
+    composerDisclaimer: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  features: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodEnum<{
+      local: "local";
+      server: "server";
+      disabled: "disabled";
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      code: z.ZodString;
+      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>]>>>;
+    disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+    enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  forms: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    on: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    when: z.ZodOptional<z.ZodObject<{
+      missingContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      pageArea: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      minMessages: z.ZodOptional<z.ZodNumber>;
+      maxMessages: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        number: "number";
+        url: "url";
+        email: "email";
+        date: "date";
+        text: "text";
+        tel: "tel";
+        time: "time";
+        textarea: "textarea";
+        select: "select";
+        radio: "radio";
+        checkbox: "checkbox";
+        multiselect: "multiselect";
+      }>;
+      placeholder: z.ZodOptional<z.ZodString>;
+      required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+      defaultValue: z.ZodOptional<z.ZodString>;
+      options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      validation: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodOptional<z.ZodString>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        minSelections: z.ZodOptional<z.ZodNumber>;
+        maxSelections: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$loose>>;
+      allowOther: z.ZodOptional<z.ZodBoolean>;
+      validationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+    frequency: z.ZodDefault<z.ZodEnum<{
+      once: "once";
+      conversation: "conversation";
+      always: "always";
+    }>>;
+    mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      submitLabel: z.ZodOptional<z.ZodString>;
+      fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        validationHint: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          value: z.ZodString;
+          label: z.ZodOptional<z.ZodString>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+      }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>>;
+  modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    layout: z.ZodEnum<{
+      home: "home";
+      chat: "chat";
+      help: "help";
+      news: "news";
+    }>;
+    contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
+    brandName: z.ZodOptional<z.ZodString>;
+    hideGreeting: z.ZodOptional<z.ZodBoolean>;
+    greetingText: z.ZodOptional<z.ZodString>;
+    userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      avatar: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+    hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      level: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contentBlockTitle: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>>;
+  tracking: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+type WidgetConfigPartial = z.infer<typeof widgetConfigPartialSchema>;
+declare const widgetSettingsPartialSchema: z.ZodObject<{
+  presentation: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      floating: "floating";
+      inline: "inline";
+      standalone: "standalone";
+      page: "page";
+      modal: "modal";
+      drawer: "drawer";
+    }>>;
+    position: z.ZodDefault<z.ZodEnum<{
+      "bottom-right": "bottom-right";
+      "bottom-left": "bottom-left";
+      "top-right": "top-right";
+      "top-left": "top-left";
+    }>>;
+    iframe: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodObject<{
+      width: z.ZodOptional<z.ZodString>;
+      height: z.ZodOptional<z.ZodString>;
+      expanded: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      resize: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minWidth: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        minHeight: z.ZodOptional<z.ZodString>;
+        maxHeight: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      inset: z.ZodOptional<z.ZodString>;
+      initialSize: z.ZodDefault<z.ZodEnum<{
+        fullscreen: "fullscreen";
+        expanded: "expanded";
+        normal: "normal";
+        auto: "auto";
+      }>>;
+      autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  behavior: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    startMinimized: z.ZodDefault<z.ZodBoolean>;
+    responseMode: z.ZodDefault<z.ZodEnum<{
+      streaming: "streaming";
+      buffered: "buffered";
+    }>>;
+    showReasoning: z.ZodDefault<z.ZodBoolean>;
+    showToolCalls: z.ZodDefault<z.ZodBoolean>;
+    showSources: z.ZodDefault<z.ZodBoolean>;
+    disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  theme: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+  }>, z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentText: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    contentMaxWidth: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>>;
+  launcher: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+      circle: "circle";
+      pill: "pill";
+      bar: "bar";
+      minimal: "minimal";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    callout: z.ZodOptional<z.ZodObject<{
+      text: z.ZodDefault<z.ZodString>;
+      shape: z.ZodDefault<z.ZodEnum<{
+        pill: "pill";
+        bubble: "bubble";
+        callout: "callout";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        horizontal: "horizontal";
+        vertical: "vertical";
+      }>>;
+      delayMs: z.ZodDefault<z.ZodNumber>;
+      autoDismissMs: z.ZodDefault<z.ZodNumber>;
+      animated: z.ZodDefault<z.ZodBoolean>;
+      persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  header: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      close: "close";
+      expand: "expand";
+      fullscreen: "fullscreen";
+      clear: "clear";
+      theme: "theme";
+      sound: "sound";
+      history: "history";
+      language: "language";
+      textSize: "textSize";
+    }>>>;
+  }, z.core.$loose>>>;
+  composer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sendButton: z.ZodOptional<z.ZodObject<{
+      shape: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        square: "square";
+      }>>;
+      icon: z.ZodDefault<z.ZodEnum<{
+        send: "send";
+        arrowUp: "arrowUp";
+        paperPlane: "paperPlane";
+        chevron: "chevron";
+      }>>;
+      variant: z.ZodDefault<z.ZodEnum<{
+        filled: "filled";
+        outline: "outline";
+        ghost: "ghost";
+      }>>;
+    }, z.core.$loose>>;
+    attachments: z.ZodOptional<z.ZodObject<{
+      maxBytes: z.ZodDefault<z.ZodNumber>;
+      maxCount: z.ZodDefault<z.ZodNumber>;
+      accept: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  feedback: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sound: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      volume: z.ZodDefault<z.ZodNumber>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    }, z.core.$loose>>;
+    haptics: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  i18n: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+    availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+  }, z.core.$loose>>>;
+  footer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    poweredBy: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodURL>;
+      logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$loose>>;
+    composerDisclaimer: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  features: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodEnum<{
+      local: "local";
+      server: "server";
+      disabled: "disabled";
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      code: z.ZodString;
+      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>]>>>;
+    disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+    enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  forms: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    on: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    when: z.ZodOptional<z.ZodObject<{
+      missingContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      pageArea: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      minMessages: z.ZodOptional<z.ZodNumber>;
+      maxMessages: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        number: "number";
+        url: "url";
+        email: "email";
+        date: "date";
+        text: "text";
+        tel: "tel";
+        time: "time";
+        textarea: "textarea";
+        select: "select";
+        radio: "radio";
+        checkbox: "checkbox";
+        multiselect: "multiselect";
+      }>;
+      placeholder: z.ZodOptional<z.ZodString>;
+      required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+      defaultValue: z.ZodOptional<z.ZodString>;
+      options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      validation: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodOptional<z.ZodString>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        minSelections: z.ZodOptional<z.ZodNumber>;
+        maxSelections: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$loose>>;
+      allowOther: z.ZodOptional<z.ZodBoolean>;
+      validationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    skippable: z.ZodDefault<z.ZodBoolean>;
+    frequency: z.ZodDefault<z.ZodEnum<{
+      once: "once";
+      conversation: "conversation";
+      always: "always";
+    }>>;
+    mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      locale: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+      submitLabel: z.ZodOptional<z.ZodString>;
+      fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        validationHint: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          value: z.ZodString;
+          label: z.ZodOptional<z.ZodString>;
+          description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+      }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>>>;
+  modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    layout: z.ZodEnum<{
+      home: "home";
+      chat: "chat";
+      help: "help";
+      news: "news";
+    }>;
+    contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
+    brandName: z.ZodOptional<z.ZodString>;
+    hideGreeting: z.ZodOptional<z.ZodBoolean>;
+    greetingText: z.ZodOptional<z.ZodString>;
+    userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      avatar: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+    hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      level: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contentBlockTitle: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>>;
+  tracking: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+type WidgetSettingsPartial = z.infer<typeof widgetSettingsPartialSchema>;
+declare const connectionConfigPartialSchema: z.ZodObject<{
+  widgetId: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  publicKey: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  aiAgentDeploymentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  baseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  agentApiBaseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  dataApiBaseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  userContext: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>>;
+  pageContext: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    area: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>>;
+  endpoints: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    upload: z.ZodDefault<z.ZodString>;
+    transcribe: z.ZodDefault<z.ZodString>;
+    submitForm: z.ZodDefault<z.ZodString>;
+  }, z.core.$loose>>>;
+  debug: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+    trace: "trace";
+  }>]>>>;
+}, z.core.$loose>;
+type ConnectionConfigPartial = z.infer<typeof connectionConfigPartialSchema>;
+//#endregion
+//#region src/schema/deployment.d.ts
+/**
+ * Server-pushable widget settings. Same surface as the editable
+ * {@link widgetSettingsSchema} but every field is optional (the server
+ * pushes patches, not full configs). Connection fields (publicKey,
+ * aiAgentDeploymentId, baseUrl, user, iframe) are deliberately
+ * excluded — those are client concerns.
+ *
+ * Two deltas vs the editable surface:
+ *   - `forms` is omitted — resolved form definitions are served by the
+ *     data-API (`GET /forms`), not pushed on the handshake. A stale
+ *     backend still sending `config.forms` passes through `.loose()` and is
+ *     ignored by the runtime merge.
+ *   - `dataApiBaseUrl` is pushable — lets a deployment point the widget at its
+ *     data-API base (adopted only when the host didn't set one).
+ *   - `storageVersion` is pushable — a handshake-only force-reset lever (never an
+ *     embed attribute / `init` option). Bumping it folds a `.v<version>` segment
+ *     into every client-storage key on the next load, abandoning the prior
+ *     namespace for all visitors.
+ */
+declare const serverConfigSchema: z.ZodObject<{
+  presentation: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+      floating: "floating";
+      inline: "inline";
+      standalone: "standalone";
+      page: "page";
+      modal: "modal";
+      drawer: "drawer";
+    }>>;
+    position: z.ZodDefault<z.ZodEnum<{
+      "bottom-right": "bottom-right";
+      "bottom-left": "bottom-left";
+      "top-right": "top-right";
+      "top-left": "top-left";
+    }>>;
+    iframe: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodObject<{
+      width: z.ZodOptional<z.ZodString>;
+      height: z.ZodOptional<z.ZodString>;
+      expanded: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      resize: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minWidth: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        minHeight: z.ZodOptional<z.ZodString>;
+        maxHeight: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>;
+      inset: z.ZodOptional<z.ZodString>;
+      initialSize: z.ZodDefault<z.ZodEnum<{
+        fullscreen: "fullscreen";
+        expanded: "expanded";
+        normal: "normal";
+        auto: "auto";
+      }>>;
+      autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  behavior: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    startMinimized: z.ZodDefault<z.ZodBoolean>;
+    responseMode: z.ZodDefault<z.ZodEnum<{
+      streaming: "streaming";
+      buffered: "buffered";
+    }>>;
+    showReasoning: z.ZodDefault<z.ZodBoolean>;
+    showToolCalls: z.ZodDefault<z.ZodBoolean>;
+    showSources: z.ZodDefault<z.ZodBoolean>;
+    disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+    autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  theme: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+  }>, z.ZodObject<{
+    accent: z.ZodOptional<z.ZodString>;
+    accentText: z.ZodOptional<z.ZodString>;
+    radius: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    contentMaxWidth: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>>;
+  launcher: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+      circle: "circle";
+      pill: "pill";
+      bar: "bar";
+      minimal: "minimal";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    callout: z.ZodOptional<z.ZodObject<{
+      text: z.ZodDefault<z.ZodString>;
+      shape: z.ZodDefault<z.ZodEnum<{
+        pill: "pill";
+        bubble: "bubble";
+        callout: "callout";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        horizontal: "horizontal";
+        vertical: "vertical";
+      }>>;
+      delayMs: z.ZodDefault<z.ZodNumber>;
+      autoDismissMs: z.ZodDefault<z.ZodNumber>;
+      animated: z.ZodDefault<z.ZodBoolean>;
+      persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  header: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      close: "close";
+      expand: "expand";
+      fullscreen: "fullscreen";
+      clear: "clear";
+      theme: "theme";
+      sound: "sound";
+      history: "history";
+      language: "language";
+      textSize: "textSize";
+    }>>>;
+  }, z.core.$loose>>>;
+  composer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sendButton: z.ZodOptional<z.ZodObject<{
+      shape: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        square: "square";
+      }>>;
+      icon: z.ZodDefault<z.ZodEnum<{
+        send: "send";
+        arrowUp: "arrowUp";
+        paperPlane: "paperPlane";
+        chevron: "chevron";
+      }>>;
+      variant: z.ZodDefault<z.ZodEnum<{
+        filled: "filled";
+        outline: "outline";
+        ghost: "ghost";
+      }>>;
+    }, z.core.$loose>>;
+    attachments: z.ZodOptional<z.ZodObject<{
+      maxBytes: z.ZodDefault<z.ZodNumber>;
+      maxCount: z.ZodDefault<z.ZodNumber>;
+      accept: z.ZodDefault<z.ZodString>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  feedback: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    sound: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      volume: z.ZodDefault<z.ZodNumber>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    }, z.core.$loose>>;
+    haptics: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
+        error: "error";
+        messageReceived: "messageReceived";
+        messageSent: "messageSent";
+      }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+    }, z.core.$loose>>;
+  }, z.core.$loose>>>;
+  i18n: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+    availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+  }, z.core.$loose>>>;
+  footer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    poweredBy: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      href: z.ZodOptional<z.ZodURL>;
+      logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$loose>>;
+    composerDisclaimer: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  features: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodEnum<{
+      local: "local";
+      server: "server";
+      disabled: "disabled";
+    }>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      code: z.ZodString;
+      config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>]>>>;
+    disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+    enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$loose>>>;
+  modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    layout: z.ZodEnum<{
+      home: "home";
+      chat: "chat";
+      help: "help";
+      news: "news";
+    }>;
+    contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
+    brandName: z.ZodOptional<z.ZodString>;
+    hideGreeting: z.ZodOptional<z.ZodBoolean>;
+    greetingText: z.ZodOptional<z.ZodString>;
+    userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      avatar: z.ZodOptional<z.ZodString>;
+      role: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+    hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodObject<{
+      text: z.ZodOptional<z.ZodString>;
+      level: z.ZodOptional<z.ZodString>;
+      url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contentBlockTitle: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>>;
+  tracking: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodURL>;
+    sampleRate: z.ZodOptional<z.ZodNumber>;
+    token: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  dataApiBaseUrl: z.ZodOptional<z.ZodString>;
+  storageVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type ServerConfig = z.infer<typeof serverConfigSchema>;
+/**
+ * Page-mode brand identity rendered at the top of the sidebar.
+ *
+ * Just the two things the widget actually paints: a brand name (used
+ * as the logo's accessible alt-text fallback) and the logo asset
+ * itself, with an optional dark-theme variant. Backend-side concerns
+ * (custom domain, SEO meta tags, theme colours, favicons, hero
+ * images) live outside this widget — the SSR / dashboard / DNS
+ * layers own them.
+ *
+ * `.loose()` so unknown server-pushed fields still validate; only
+ * the rendered subset is typed.
+ */
+declare const siteConfigSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  logo: z.ZodOptional<z.ZodObject<{
+    url: z.ZodString;
+    alt: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  logoDark: z.ZodOptional<z.ZodObject<{
+    url: z.ZodString;
+    alt: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+}, z.core.$loose>;
+type SiteConfig = z.infer<typeof siteConfigSchema>;
+/**
+ * Page-mode content blocks rendered in the sidebar.
+ *
+ * The dashboard configures lists of links here; the widget walks
+ * them and renders one section per non-empty list. Each entry
+ * follows {@link linkSchema} (`label` + optional `href` / `icon` /
+ * `description` / `id`).
+ */
+declare const blocksConfigSchema: z.ZodObject<{
+  navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+  linkCards: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+type BlocksConfig = z.infer<typeof blocksConfigSchema>;
+declare const handshakeResponseSchema: z.ZodObject<{
+  deployment: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    publicKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>;
+  agent: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+      online: "online";
+      away: "away";
+      offline: "offline";
+    }>>;
+  }, z.core.$loose>;
+  config: z.ZodOptional<z.ZodObject<{
+    presentation: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      mode: z.ZodDefault<z.ZodEnum<{
+        floating: "floating";
+        inline: "inline";
+        standalone: "standalone";
+        page: "page";
+        modal: "modal";
+        drawer: "drawer";
+      }>>;
+      position: z.ZodDefault<z.ZodEnum<{
+        "bottom-right": "bottom-right";
+        "bottom-left": "bottom-left";
+        "top-right": "top-right";
+        "top-left": "top-left";
+      }>>;
+      iframe: z.ZodDefault<z.ZodBoolean>;
+      size: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodString>;
+        expanded: z.ZodOptional<z.ZodObject<{
+          width: z.ZodOptional<z.ZodString>;
+          height: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        resize: z.ZodOptional<z.ZodObject<{
+          enabled: z.ZodDefault<z.ZodBoolean>;
+          minWidth: z.ZodOptional<z.ZodString>;
+          maxWidth: z.ZodOptional<z.ZodString>;
+          minHeight: z.ZodOptional<z.ZodString>;
+          maxHeight: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        inset: z.ZodOptional<z.ZodString>;
+        initialSize: z.ZodDefault<z.ZodEnum<{
+          fullscreen: "fullscreen";
+          expanded: "expanded";
+          normal: "normal";
+          auto: "auto";
+        }>>;
+        autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
+      }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    behavior: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      startMinimized: z.ZodDefault<z.ZodBoolean>;
+      responseMode: z.ZodDefault<z.ZodEnum<{
+        streaming: "streaming";
+        buffered: "buffered";
+      }>>;
+      showReasoning: z.ZodDefault<z.ZodBoolean>;
+      showToolCalls: z.ZodDefault<z.ZodBoolean>;
+      showSources: z.ZodDefault<z.ZodBoolean>;
+      disableMessageFeedback: z.ZodDefault<z.ZodBoolean>;
+      autoSendSuggestions: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>>;
+    theme: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+      auto: "auto";
+      light: "light";
+      dark: "dark";
+    }>, z.ZodObject<{
+      accent: z.ZodOptional<z.ZodString>;
+      accentText: z.ZodOptional<z.ZodString>;
+      radius: z.ZodOptional<z.ZodString>;
+      fontFamily: z.ZodOptional<z.ZodString>;
+      contentMaxWidth: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>]>>>;
+    launcher: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      variant: z.ZodDefault<z.ZodEnum<{
+        circle: "circle";
+        pill: "pill";
+        bar: "bar";
+        minimal: "minimal";
+      }>>;
+      size: z.ZodDefault<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+      }>>;
+      label: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodString>;
+      hidden: z.ZodDefault<z.ZodBoolean>;
+      callout: z.ZodOptional<z.ZodObject<{
+        text: z.ZodDefault<z.ZodString>;
+        shape: z.ZodDefault<z.ZodEnum<{
+          pill: "pill";
+          bubble: "bubble";
+          callout: "callout";
+        }>>;
+        position: z.ZodDefault<z.ZodEnum<{
+          auto: "auto";
+          horizontal: "horizontal";
+          vertical: "vertical";
+        }>>;
+        delayMs: z.ZodDefault<z.ZodNumber>;
+        autoDismissMs: z.ZodDefault<z.ZodNumber>;
+        animated: z.ZodDefault<z.ZodBoolean>;
+        persistent: z.ZodDefault<z.ZodBoolean>;
+      }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    header: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        close: "close";
+        expand: "expand";
+        fullscreen: "fullscreen";
+        clear: "clear";
+        theme: "theme";
+        sound: "sound";
+        history: "history";
+        language: "language";
+        textSize: "textSize";
+      }>>>;
+    }, z.core.$loose>>>;
+    composer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      sendButton: z.ZodOptional<z.ZodObject<{
+        shape: z.ZodDefault<z.ZodEnum<{
+          circle: "circle";
+          pill: "pill";
+          square: "square";
+        }>>;
+        icon: z.ZodDefault<z.ZodEnum<{
+          send: "send";
+          arrowUp: "arrowUp";
+          paperPlane: "paperPlane";
+          chevron: "chevron";
+        }>>;
+        variant: z.ZodDefault<z.ZodEnum<{
+          filled: "filled";
+          outline: "outline";
+          ghost: "ghost";
+        }>>;
+      }, z.core.$loose>>;
+      attachments: z.ZodOptional<z.ZodObject<{
+        maxBytes: z.ZodDefault<z.ZodNumber>;
+        maxCount: z.ZodDefault<z.ZodNumber>;
+        accept: z.ZodDefault<z.ZodString>;
+      }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    feedback: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      sound: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        volume: z.ZodDefault<z.ZodNumber>;
+        events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+          voiceStart: "voiceStart";
+          voiceStop: "voiceStop";
+          error: "error";
+          messageReceived: "messageReceived";
+          messageSent: "messageSent";
+        }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+      }, z.core.$loose>>;
+      haptics: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+          voiceStart: "voiceStart";
+          voiceStop: "voiceStop";
+          error: "error";
+          messageReceived: "messageReceived";
+          messageSent: "messageSent";
+        }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
+      }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+    i18n: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      locale: z.ZodOptional<z.ZodString>;
+      defaultLocale: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodString]>>;
+      availableLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      strings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>]>>;
+    }, z.core.$loose>>>;
+    footer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      poweredBy: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodURL>;
+        logoUrl: z.ZodOptional<z.ZodURL>;
+      }, z.core.$loose>>;
+      composerDisclaimer: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    features: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      disableFileUpload: z.ZodDefault<z.ZodBoolean>;
+      voice: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        server: "server";
+        disabled: "disabled";
+      }>>;
+      tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      }, z.core.$loose>]>>>;
+      disableHumanInLoop: z.ZodDefault<z.ZodBoolean>;
+      enableOperatorRequest: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>>>;
+    modules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      layout: z.ZodEnum<{
+        home: "home";
+        chat: "chat";
+        help: "help";
+        news: "news";
+      }>;
+      contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      id: z.ZodOptional<z.ZodString>;
+      brandName: z.ZodOptional<z.ZodString>;
+      hideGreeting: z.ZodOptional<z.ZodBoolean>;
+      greetingText: z.ZodOptional<z.ZodString>;
+      userAvatars: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        avatar: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      hideSearchBar: z.ZodOptional<z.ZodBoolean>;
+      hideRecentConversations: z.ZodOptional<z.ZodBoolean>;
+      status: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+      contentBlockTitle: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    tracking: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      endpoint: z.ZodOptional<z.ZodURL>;
+      sampleRate: z.ZodOptional<z.ZodNumber>;
+      token: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    dataApiBaseUrl: z.ZodOptional<z.ZodString>;
+    storageVersion: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+  site: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodObject<{
+      url: z.ZodString;
+      alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    logoDark: z.ZodOptional<z.ZodObject<{
+      url: z.ZodString;
+      alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+  }, z.core.$loose>>;
+  blocks: z.ZodOptional<z.ZodObject<{
+    navigation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      label: z.ZodString;
+      href: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    linkCards: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodOptional<z.ZodString>;
+      label: z.ZodString;
+      href: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>;
+  welcome: z.ZodOptional<z.ZodObject<{
+    messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      role: z.ZodEnum<{
+        assistant: "assistant";
+        system: "system";
+      }>;
+      text: z.ZodString;
+    }, z.core.$loose>>>;
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      label: z.ZodString;
+      text: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+  }, z.core.$loose>>;
+  visitorId: z.ZodString;
+  conversationId: z.ZodString;
+  userPrefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  rebind: z.ZodOptional<z.ZodObject<{
+    visitorId: z.ZodOptional<z.ZodEnum<{
+      conflict: "conflict";
+      expired: "expired";
+      invalid: "invalid";
+    }>>;
+    conversationId: z.ZodOptional<z.ZodEnum<{
+      conflict: "conflict";
+      expired: "expired";
+      invalid: "invalid";
+    }>>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type HandshakeResponse = z.infer<typeof handshakeResponseSchema>;
+//#endregion
+//#region src/index.d.ts
 /**
  * Handle returned by {@link mount} / {@link init}. All methods are safe to call
  * after `destroy()` — they become no-ops rather than throwing.
  */
 interface ChatWidgetInstance {
-    /** Stable identifier — matches `options.widgetId ?? "default"`. */
-    readonly widgetId: string;
-    /** Open the floating panel (no-op in `inline` / `standalone` mode). */
-    open: () => void;
-    /** Close the floating panel (no-op in `inline` / `standalone` mode). */
-    close: () => void;
-    /** Unmount the widget and release all subscriptions. */
-    destroy: () => void;
-    /** Toggle fullscreen mode. In `standalone` mode this is a no-op. */
-    expand: () => void;
-    /**
-     * Surface a configured form by id (a form with a `manual` trigger). Lets the
-     * host open, say, an appointment or feedback form from its own button. No-op
-     * if no form with that id + a `manual` trigger exists.
-     */
-    openForm: (id: string) => void;
-    /**
-     * Subscribe to a lifecycle event. Returns an `off` function. See
-     * {@link EventMap} for the full set + payload shapes — currently
-     * `open | close | message | error | expand | fullscreen |
-     * handshake | localeChange`.
-     */
-    on: <E extends EventName>(name: E, fn: (payload: EventMap[E]) => void) => () => void;
-    /**
-     * Merge new options into the running instance without a full remount.
-     * Useful for theme toggles or other live config tweaks.
-     */
-    update: (patch: Partial<ChatWidgetOptions>) => void;
-    /**
-     * Set / merge the host-asserted end-user context (`id`, `email`, `name`, plus
-     * any custom scalar fields). Informational only — not auth. Merges into the
-     * current context, refreshes the Home greeting, and re-handshakes so the
-     * agent gets it. Call this after the visitor logs in. Untrusted input is
-     * sanitised; bad fields are dropped with a `warn`.
-     *
-     * @example
-     * ```ts
-     * getInstance().setUserContext({ id: "u_1", name: "Mohamed", email: "mo@acme.com", plan: "pro" });
-     * ```
-     */
-    setUserContext: (userContext: UserContext) => void;
-    /** Clear the end-user context (e.g. on logout) and re-handshake anonymously. */
-    clearUserContext: () => void;
-    /**
-     * Set / merge the host-asserted page/visit context (`area`, `url`, `path`,
-     * `title`, plus custom scalar fields). Use it to tell the agent which surface
-     * the visitor is on (e.g. `area: "pricing"`) and update it on SPA navigation.
-     * Merges into the current context and re-handshakes.
-     *
-     * @example
-     * ```ts
-     * getInstance().setPageContext({ area: "pricing", path: "/pricing/enterprise" });
-     * ```
-     */
-    setPageContext: (pageContext: PageContext) => void;
-    /** Clear the page/visit context and re-handshake. */
-    clearPageContext: () => void;
-    /**
-     * Set the runtime log level. Accepts `"off"` / `"error"` / `"warn"` /
-     * `"info"` / `"debug"` / `"trace"`, or `true` (→ `"debug"`) /
-     * `false` (→ `"off"`), or a number 0..5. Persists to localStorage so
-     * a page refresh keeps the same verbosity — useful for asking a
-     * customer to reproduce a bug and capture the console transcript.
-     *
-     * Affects every widget on the page (logger is module-global; setting
-     * it from one instance applies everywhere). Equivalent to calling
-     * `HelpAI.setDebug(level)` on the brand global.
-     */
-    setDebug: (level: LogLevel | boolean | number | string) => void;
-    /** Current log level. Read-only. */
-    readonly debugLevel: () => LogLevel;
-    /**
-     * Forward every log line (that passes the active level) to an external sink —
-     * pipe errors/warnings/debug into Sentry, Datadog, your own logger, etc. Pass
-     * `null` to clear. One global sink per bundle (logger is module-global); use
-     * `setDebug("trace")` to capture everything, not just warnings + errors.
-     */
-    onLog: (sink: ((entry: LogEntry) => void) | null) => void;
+  /** Stable identifier — matches `options.widgetId ?? "default"`. */
+  readonly widgetId: string;
+  /** Open the floating panel (no-op in `inline` / `standalone` mode). */
+  open: () => void;
+  /** Close the floating panel (no-op in `inline` / `standalone` mode). */
+  close: () => void;
+  /** Unmount the widget and release all subscriptions. */
+  destroy: () => void;
+  /** Toggle fullscreen mode. In `standalone` mode this is a no-op. */
+  expand: () => void;
+  /**
+   * Surface a configured form by id (a form with a `manual` trigger). Lets the
+   * host open, say, an appointment or feedback form from its own button. No-op
+   * if no form with that id + a `manual` trigger exists.
+   */
+  openForm: (id: string) => void;
+  /**
+   * Subscribe to a lifecycle event. Returns an `off` function. See
+   * {@link EventMap} for the full set + payload shapes — currently
+   * `open | close | message | error | expand | fullscreen |
+   * handshake | localeChange`.
+   */
+  on: <E extends EventName>(name: E, fn: (payload: EventMap[E]) => void) => () => void;
+  /**
+   * Merge new options into the running instance without a full remount.
+   * Useful for theme toggles or other live config tweaks.
+   */
+  update: (patch: Partial<ChatWidgetOptions>) => void;
+  /**
+   * Set / merge the host-asserted end-user context (`id`, `email`, `name`, plus
+   * any custom scalar fields). Informational only — not auth. Merges into the
+   * current context, refreshes the Home greeting, and re-handshakes so the
+   * agent gets it. Call this after the visitor logs in. Untrusted input is
+   * sanitised; bad fields are dropped with a `warn`.
+   *
+   * @example
+   * ```ts
+   * getInstance().setUserContext({ id: "u_1", name: "Mohamed", email: "mo@acme.com", plan: "pro" });
+   * ```
+   */
+  setUserContext: (userContext: UserContext) => void;
+  /** Clear the end-user context (e.g. on logout) and re-handshake anonymously. */
+  clearUserContext: () => void;
+  /**
+   * Set / merge the host-asserted page/visit context (`area`, `url`, `path`,
+   * `title`, plus custom scalar fields). Use it to tell the agent which surface
+   * the visitor is on (e.g. `area: "pricing"`) and update it on SPA navigation.
+   * Merges into the current context and re-handshakes.
+   *
+   * @example
+   * ```ts
+   * getInstance().setPageContext({ area: "pricing", path: "/pricing/enterprise" });
+   * ```
+   */
+  setPageContext: (pageContext: PageContext) => void;
+  /** Clear the page/visit context and re-handshake. */
+  clearPageContext: () => void;
+  /**
+   * Set the runtime log level. Accepts `"off"` / `"error"` / `"warn"` /
+   * `"info"` / `"debug"` / `"trace"`, or `true` (→ `"debug"`) /
+   * `false` (→ `"off"`), or a number 0..5. Persists to localStorage so
+   * a page refresh keeps the same verbosity — useful for asking a
+   * customer to reproduce a bug and capture the console transcript.
+   *
+   * Affects every widget on the page (logger is module-global; setting
+   * it from one instance applies everywhere). Equivalent to calling
+   * `HelpAI.setDebug(level)` on the brand global.
+   */
+  setDebug: (level: LogLevel | boolean | number | string) => void;
+  /** Current log level. Read-only. */
+  readonly debugLevel: () => LogLevel;
+  /**
+   * Forward every log line (that passes the active level) to an external sink —
+   * pipe errors/warnings/debug into Sentry, Datadog, your own logger, etc. Pass
+   * `null` to clear. One global sink per bundle (logger is module-global); use
+   * `setDebug("trace")` to capture everything, not just warnings + errors.
+   */
+  onLog: (sink: ((entry: LogEntry) => void) | null) => void;
 }
 /**
  * Mount a new widget. If an instance with the same `widgetId` already
@@ -1729,7 +3598,7 @@ interface ChatWidgetInstance {
  * ```
  */
 declare function mount(opts: ChatWidgetOptions & {
-    target?: HTMLElement;
+  target?: HTMLElement;
 }): ChatWidgetInstance;
 /**
  * Idempotent init per `widgetId`. If an instance exists at that slot, its
@@ -1737,7 +3606,7 @@ declare function mount(opts: ChatWidgetOptions & {
  * behaves like {@link mount}. Safe to call on every route change in an SPA.
  */
 declare function init(opts: ChatWidgetOptions & {
-    target?: HTMLElement;
+  target?: HTMLElement;
 }): ChatWidgetInstance;
 /**
  * Destroy a specific instance by `widgetId`, or — when no id is supplied —
@@ -1751,7 +3620,6 @@ declare function destroy(widgetId?: string): void;
 declare function getInstance(widgetId?: string): ChatWidgetInstance | null;
 /** All live widget instances on the page. */
 declare function getAllInstances(): ChatWidgetInstance[];
-
 /**
  * Register a lifecycle hook that fires for every matching
  * `(widgetId, event)` pair across all live widgets.
@@ -1783,15 +3651,16 @@ declare function hook(widgetId: string, event: string, listener: HookListener):
 declare const version: string;
 /** Compile-time brand constants inlined at build time (name, CDN URL, theme). */
 declare const brand: {
-    readonly id: string;
-    readonly name: string;
-    readonly global: string;
-    readonly tagName: string;
-    readonly cssPrefix: string;
-    readonly defaultBaseUrl: string;
-    readonly displayName: string;
-    readonly domain: string;
-    readonly siteUrl: string;
+  readonly id: string;
+  readonly name: string;
+  readonly global: string;
+  readonly tagName: string;
+  readonly cssPrefix: string;
+  readonly defaultBaseUrl: string;
+  readonly displayName: string;
+  readonly domain: string;
+  readonly siteUrl: string;
 };
-
-export { type ChatWidgetInstance, type ChatWidgetOptions, type EventMap, type EventName, HOOK_WILDCARD, type HookListener, type LogEntry, type LogLevel, type ResolvedOptions, brand, destroy, getAllInstances, getInstance, hook, init, mount, resolveInitialHostMode, version };
+//#endregion
+export { type Asset, type BlocksConfig, ChatWidgetInstance, type ChatWidgetOptions, type ConnectionConfig, type ConnectionConfigPartial, type EventMap, type EventName, HOOK_WILDCARD, type HandshakeResponse, type HookListener, type Link, type LogEntry, type LogLevel, type ResolvedOptions, type ServerConfig, type SiteConfig, type WidgetConfig, type WidgetConfigPartial, type WidgetSettings, type WidgetSettingsPartial, brand, destroy, getAllInstances, getInstance, hook, init, mount, resolveInitialHostMode, version };
+//# sourceMappingURL=index.d.ts.map