@memberjunction/ng-conversations 5.43.0 → 5.45.0

package/dist/lib/components/realtime/realtime-ui-config.js

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview Declarative UI configuration for the realtime voice widget.
+ *
+ * The realtime widget historically decided *what to show* from an internal
+ * "disclosure ratchet" ({@link import('./realtime-disclosure').RealtimeDisclosureModel})
+ * plus a handful of scattered getters. That made it impossible for a host
+ * (the chat overlay, a full-screen route, an embedded demo surface, a kiosk,
+ * a mobile sheet…) to tailor the surface to its context.
+ *
+ * This module introduces a single, pure, side-effect-free resolution step that
+ * sits between three concerns:
+ *
+ * 1. **{@link RealtimeUiInputs}** — the *consumer's intent*. A flat bag of
+ *    `@Input()`-friendly feature switches ("show the surface panel?",
+ *    "allow text?", "which chrome?") with documented defaults. A host sets
+ *    only what it cares about; everything else stays on its sensible default,
+ *    so the widget behaves exactly as before when no inputs are provided.
+ *
+ * 2. **{@link RealtimeUiSignals}** — the *live runtime state*. Read-only facts
+ *    the widget already knows: how wide its container is, whether the user has
+ *    revealed text, what the disclosure model currently permits, whether a
+ *    surface/channel/activity exists, the connection state, review/focus modes.
+ *
+ * 3. **{@link ResolvedRealtimeUi}** — the *answer*. A fully-resolved, boolean
+ *    view-model the template binds to directly. No `&&` chains in the HTML; no
+ *    business logic in getters. One source of truth, trivially unit-testable.
+ *
+ * ## The headline behaviour: auto orb ↔ console
+ *
+ * The default {@link RealtimeChromeMode} is `'auto'`. In auto mode the widget is
+ * a calm **orb** until *two* things are true at once:
+ *
+ *   - the container is at least {@link RealtimeUiInputs.consoleBreakpointPx}
+ *     wide (there's room for a structured console), **and**
+ *   - the user has actually asked to see text (`textRevealed`), or the widget
+ *     is reviewing a past session (which always shows the transcript).
+ *
+ * In other words: **getting bigger is not enough — if the user hasn't asked for
+ * text, we keep the orb.** This preserves the loved "ambient by default"
+ * feeling while letting the experience graduate to a full command console the
+ * moment it earns the space *and* the intent. Hosts that want to force one
+ * chrome forever can pass `chrome: 'orb'` or `chrome: 'console'`.
+ *
+ * The resolver is intentionally framework-free (no Angular import) so it can be
+ * unit-tested in isolation and reused by any host.
+ *
+ * @module realtime-ui-config
+ */
+/**
+ * The default container width (px) at or above which `'auto'` chrome is *allowed*
+ * to graduate from orb to console — provided the user has also revealed text.
+ * Chosen so a typical 390px chat overlay stays an orb, while a half-screen or
+ * full-screen surface can become a console. Override per-host via
+ * {@link RealtimeUiInputs.consoleBreakpointPx}.
+ */
+export const REALTIME_CONSOLE_BREAKPOINT_DEFAULT = 560;
+/**
+ * The complete, defaulted input set. Spreading this over a partial
+ * {@link RealtimeUiInputs} yields a fully-populated config; the resolver does
+ * exactly that, so callers never deal with `undefined`.
+ */
+export const DEFAULT_REALTIME_UI_INPUTS = {
+    chrome: 'auto',
+    consoleBreakpointPx: REALTIME_CONSOLE_BREAKPOINT_DEFAULT,
+    compact: false,
+    autoHideControls: true,
+    allowTextReveal: true,
+    showCaptionsControl: true,
+    showDensityPicker: true,
+    showMinimize: true,
+    showEnd: true,
+    showSurfacePanel: true,
+    showChannels: true,
+    showActivityRail: true,
+    showDevLinks: true,
+    allowResize: true,
+};
+/**
+ * A safe, dependency-free baseline {@link RealtimeUiSignals}. Use this to seed a
+ * resolved view-model **before** the component's runtime dependencies (the
+ * disclosure model, the session state, the `ResizeObserver`) exist — e.g. in a
+ * field initializer. It describes a freshly-connecting widget at zero width with
+ * nothing earned yet, so the first paint is a calm orb until `recomputeUi()`
+ * runs with real signals. Never read `this` to build the first value.
+ */
+export const DEFAULT_REALTIME_UI_SIGNALS = {
+    containerWidthPx: 0,
+    textRevealed: false,
+    disclosureShowThread: false,
+    disclosureShowComposer: false,
+    disclosureShowPanel: false,
+    disclosureShowGear: false,
+    surfacePanelEarned: false,
+    hasChannels: false,
+    hasActivity: false,
+    devMode: false,
+    isReviewing: false,
+    channelFocus: false,
+    connectionState: 'connecting',
+};
+/**
+ * Resolve the consumer config + live signals into a render-ready view-model.
+ *
+ * Pure and deterministic: same inputs ⇒ same output, no side effects, no clock,
+ * no DOM. Safe to call on every change-detection pass and trivial to unit test.
+ *
+ * The resolution order is:
+ *  1. fill defaults,
+ *  2. decide the effective {@link RealtimeChromeMode} (the orb↔console rule),
+ *  3. for each affordance, AND the consumer's switch with the runtime gate.
+ *
+ * @param inputs  consumer configuration (partial; defaults fill the rest)
+ * @param signals live runtime facts
+ * @returns the fully-resolved {@link ResolvedRealtimeUi}
+ *
+ * @example Chat overlay (lean, ambient):
+ * ```ts
+ * resolveRealtimeUi(
+ *   { chrome: 'auto', showSurfacePanel: false, showActivityRail: false, showDevLinks: false },
+ *   signals
+ * );
+ * ```
+ *
+ * @example Full-screen route (rich console):
+ * ```ts
+ * resolveRealtimeUi({ chrome: 'auto', consoleBreakpointPx: 480 }, wideSignals);
+ * ```
+ */
+export function resolveRealtimeUi(inputs, signals) {
+    const cfg = { ...DEFAULT_REALTIME_UI_INPUTS, ...(inputs ?? {}) };
+    const connecting = signals.connectionState === 'connecting';
+    const allowTextReveal = cfg.allowTextReveal;
+    const chrome = resolveChrome(cfg, signals, allowTextReveal);
+    const isConsole = chrome === 'console';
+    const compact = cfg.compact || signals.containerWidthPx < cfg.consoleBreakpointPx;
+    // The transcript shows when the user has EXPLICITLY revealed text this session
+    // (`textRevealed`), OR we're in a console (consoles always carry the thread), OR we're
+    // reviewing a recording. We deliberately do NOT consult the disclosure ratchet here: a
+    // power user with a high base level still opens to the calm orb, exactly like the historical
+    // `ShowHero = !ShowCaptions` behaviour — "keep the orb until the user asks for text".
+    const showThread = allowTextReveal && (signals.textRevealed || isConsole || signals.isReviewing);
+    // The hero orb owns the surface in orb chrome (and there's nothing else to show).
+    const showHero = chrome === 'orb' && !showThread;
+    const showComposer = isConsole && allowTextReveal && signals.disclosureShowComposer && !signals.isReviewing;
+    // The surface/Details panel opens ON DEMAND when earned (the Details peek, the agent's
+    // OpenSurfacePanel, content auto-reveal — all set surfacePanelEarned). It is an INDEPENDENT
+    // right-hand peek that rides ALONGSIDE whatever the main column shows — it must NOT require the
+    // cross-session disclosure ratchet (disclosureShowPanel = SessionLevel >= 2), and it must NOT
+    // require the user to have revealed text.
+    //
+    // It was previously gated on `isConsole`, which bundled TWO things: "there's room" (legitimate —
+    // don't cram a side panel into a narrow overlay) AND "the user revealed text" (wrong for a peek).
+    // The text-reveal coupling meant opening Details with captions OFF flipped the whole left column
+    // from the hero orb to an empty transcript (the orb vanished), and toggling captions back off
+    // yanked the panel out from under an open peek. The design intent (see the auto-reveal comment in
+    // the overlay component: "the left column stays exactly as it was, pure audio included") is a peek
+    // beside the orb. So we keep only the ROOM half: the panel shows when earned and either the chrome
+    // is already a console (incl. review / forced-console at any width) OR the container is at least as
+    // wide as the console breakpoint — never in a cramped narrow overlay, and never dependent on text.
+    const roomForSurfacePanel = isConsole || signals.containerWidthPx >= cfg.consoleBreakpointPx;
+    const showSurfacePanel = cfg.showSurfacePanel && signals.surfacePanelEarned && !signals.channelFocus && roomForSurfacePanel;
+    const showActivityTab = cfg.showActivityRail && (signals.hasActivity || signals.isReviewing) && isConsole;
+    const showChannelStrip = cfg.showChannels && signals.hasChannels && isConsole && !signals.channelFocus;
+    const showGear = signals.disclosureShowGear || isConsole;
+    return {
+        chrome,
+        compact,
+        connecting,
+        showHero,
+        showThread,
+        showComposer,
+        showSurfacePanel,
+        showActivityTab,
+        showChannelStrip,
+        showCaptionsControl: cfg.showCaptionsControl,
+        showDensityPicker: cfg.showDensityPicker && showGear,
+        showGear,
+        showDevLinks: cfg.showDevLinks && signals.devMode,
+        showMinimize: cfg.showMinimize && !signals.isReviewing,
+        showEnd: cfg.showEnd,
+        allowResize: cfg.allowResize && showSurfacePanel,
+        allowTextReveal,
+        autoHideControls: cfg.autoHideControls && chrome === 'orb',
+    };
+}
+/**
+ * Decide the effective chrome. Forced modes win outright; `'auto'` graduates to a
+ * console only when there's both **room** (width ≥ breakpoint) and **intent**
+ * (text revealed) — or when reviewing, which always wants the transcript.
+ *
+ * @internal
+ */
+function resolveChrome(cfg, signals, allowTextReveal) {
+    if (cfg.chrome === 'orb') {
+        return 'orb';
+    }
+    if (cfg.chrome === 'console') {
+        return 'console';
+    }
+    // auto
+    if (signals.isReviewing) {
+        return 'console';
+    }
+    if (!allowTextReveal) {
+        return 'orb';
+    }
+    // Intent is the USER explicitly revealing text this session — NOT the disclosure ratchet.
+    // Wider-alone keeps the orb; a power user who hasn't asked for text keeps the orb too.
+    const hasRoom = signals.containerWidthPx >= cfg.consoleBreakpointPx;
+    return hasRoom && signals.textRevealed ? 'console' : 'orb';
+}
+//# sourceMappingURL=realtime-ui-config.js.map

package/dist/lib/components/realtime/realtime-ui-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-ui-config.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-ui-config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Declarative UI configuration for the realtime voice widget.\n *\n * The realtime widget historically decided *what to show* from an internal\n * \"disclosure ratchet\" ({@link import('./realtime-disclosure').RealtimeDisclosureModel})\n * plus a handful of scattered getters. That made it impossible for a host\n * (the chat overlay, a full-screen route, an embedded demo surface, a kiosk,\n * a mobile sheet…) to tailor the surface to its context.\n *\n * This module introduces a single, pure, side-effect-free resolution step that\n * sits between three concerns:\n *\n * 1. **{@link RealtimeUiInputs}** — the *consumer's intent*. A flat bag of\n *    `@Input()`-friendly feature switches (\"show the surface panel?\",\n *    \"allow text?\", \"which chrome?\") with documented defaults. A host sets\n *    only what it cares about; everything else stays on its sensible default,\n *    so the widget behaves exactly as before when no inputs are provided.\n *\n * 2. **{@link RealtimeUiSignals}** — the *live runtime state*. Read-only facts\n *    the widget already knows: how wide its container is, whether the user has\n *    revealed text, what the disclosure model currently permits, whether a\n *    surface/channel/activity exists, the connection state, review/focus modes.\n *\n * 3. **{@link ResolvedRealtimeUi}** — the *answer*. A fully-resolved, boolean\n *    view-model the template binds to directly. No `&&` chains in the HTML; no\n *    business logic in getters. One source of truth, trivially unit-testable.\n *\n * ## The headline behaviour: auto orb ↔ console\n *\n * The default {@link RealtimeChromeMode} is `'auto'`. In auto mode the widget is\n * a calm **orb** until *two* things are true at once:\n *\n *   - the container is at least {@link RealtimeUiInputs.consoleBreakpointPx}\n *     wide (there's room for a structured console), **and**\n *   - the user has actually asked to see text (`textRevealed`), or the widget\n *     is reviewing a past session (which always shows the transcript).\n *\n * In other words: **getting bigger is not enough — if the user hasn't asked for\n * text, we keep the orb.** This preserves the loved \"ambient by default\"\n * feeling while letting the experience graduate to a full command console the\n * moment it earns the space *and* the intent. Hosts that want to force one\n * chrome forever can pass `chrome: 'orb'` or `chrome: 'console'`.\n *\n * The resolver is intentionally framework-free (no Angular import) so it can be\n * unit-tested in isolation and reused by any host.\n *\n * @module realtime-ui-config\n */\n\nimport { RealtimeUxDensity } from './realtime-disclosure';\n\n/**\n * Which visual chrome the widget renders.\n *\n * - `'orb'` — the ambient hero orb. Minimal controls; transcript/console hidden\n *   unless the user reveals them. Best for narrow/overlay/mobile contexts.\n * - `'console'` — the structured command console: header, transcript, composer\n *   dock, and (when room allows) the surface panel. Best for full-screen.\n * - `'auto'` — *(default)* start as an orb; graduate to a console when the\n *   container is wide enough **and** the user has revealed text. See the module\n *   docs for the exact rule.\n */\nexport type RealtimeChromeMode = 'orb' | 'console' | 'auto';\n\n/**\n * Identifies a control the user invoked. Emitted by the widget's `ControlInvoked`\n * output so a host can observe (or react to) any control — even one it has hidden\n * via inputs and re-rendered itself. Extend the union as new controls are added.\n */\nexport type RealtimeControlId =\n  | 'mute'\n  | 'captions'\n  | 'type'\n  | 'end'\n  | 'minimize'\n  | 'surface'\n  | 'gear'\n  | 'reveal-text'\n  | 'pure-audio'\n  | 'density';\n\n/**\n * The connection lifecycle states the widget cares about for layout decisions.\n * Mirrors the widget's runtime `RealtimeConnectionState`; duplicated as a string\n * union here so this module stays import-free of the Angular component.\n */\nexport type RealtimeUiConnectionState =\n  | 'connecting'\n  | 'listening'\n  | 'speaking'\n  | 'thinking'\n  | 'idle'\n  | 'error';\n\n/**\n * The default container width (px) at or above which `'auto'` chrome is *allowed*\n * to graduate from orb to console — provided the user has also revealed text.\n * Chosen so a typical 390px chat overlay stays an orb, while a half-screen or\n * full-screen surface can become a console. Override per-host via\n * {@link RealtimeUiInputs.consoleBreakpointPx}.\n */\nexport const REALTIME_CONSOLE_BREAKPOINT_DEFAULT = 560;\n\n/**\n * Consumer-facing configuration for the realtime widget — every field is a\n * declarative switch a host can set via an `@Input()`. **All fields are\n * optional**; omitted fields fall back to {@link DEFAULT_REALTIME_UI_INPUTS},\n * which reproduces the widget's historical behaviour. This is the surface that\n * lets the chat overlay slim the widget down, a full-screen route open it up,\n * and unexpected hosts (kiosks, demos, embeds) compose their own variant.\n *\n * A `false` here is a **hard disable** — it removes the affordance regardless of\n * what the disclosure model or runtime state would otherwise permit. A `true`\n * means \"allow it\"; the affordance still only appears when it's also *earned* by\n * the runtime (e.g. a surface panel only renders once a channel actually exists).\n */\nexport interface RealtimeUiInputs {\n  /** Which chrome to render. Default `'auto'`. */\n  chrome?: RealtimeChromeMode;\n  /**\n   * In `'auto'` chrome, the container width (px) at/above which the widget may\n   * graduate to a console (still gated on text being revealed). Default\n   * {@link REALTIME_CONSOLE_BREAKPOINT_DEFAULT}.\n   */\n  consoleBreakpointPx?: number;\n  /**\n   * Force compact spacing/typography regardless of size — useful for dense\n   * mobile sheets. Default `false` (the widget infers compactness from width).\n   */\n  compact?: boolean;\n  /**\n   * Fade non-essential controls when the session is idle (orb chrome only), for\n   * a cinematic feel. Default `true`.\n   */\n  autoHideControls?: boolean;\n  /**\n   * May the user reveal the transcript at all? When `false`, the widget is a\n   * pure voice orb with no path to text (and therefore never graduates to a\n   * console in `'auto'` mode). Default `true`.\n   */\n  allowTextReveal?: boolean;\n\n  /** Show the captions toggle. Default `true`. */\n  showCaptionsControl?: boolean;\n  /** Show the density picker inside the gear menu. Default `true`. */\n  showDensityPicker?: boolean;\n  /** Show the minimize control (collapse the call without ending it). Default `true`. */\n  showMinimize?: boolean;\n  /** Show the end-call control. Default `true`. (Hosts that own their own end button may hide it.) */\n  showEnd?: boolean;\n  /**\n   * Show the right-hand surface panel (whiteboard / browser / interactive\n   * channels). Default `true`. Only renders in console chrome and once a panel\n   * is actually earned.\n   */\n  showSurfacePanel?: boolean;\n  /** Show the channel strip (active interactive channels). Default `true`. */\n  showChannels?: boolean;\n  /** Show the Activity rail/tab (delegations, artifacts timeline). Default `true`. */\n  showActivityRail?: boolean;\n  /**\n   * Show developer affordances (\"open session / open run\" links, dev-only\n   * panels). Default `true`, but still additionally gated by the per-session\n   * dev-mode toggle, so this is a hard *ceiling*, not a force-on.\n   */\n  showDevLinks?: boolean;\n  /** Allow drag-to-resize of the surface panel. Default `true`. */\n  allowResize?: boolean;\n}\n\n/**\n * The complete, defaulted input set. Spreading this over a partial\n * {@link RealtimeUiInputs} yields a fully-populated config; the resolver does\n * exactly that, so callers never deal with `undefined`.\n */\nexport const DEFAULT_REALTIME_UI_INPUTS: Required<RealtimeUiInputs> = {\n  chrome: 'auto',\n  consoleBreakpointPx: REALTIME_CONSOLE_BREAKPOINT_DEFAULT,\n  compact: false,\n  autoHideControls: true,\n  allowTextReveal: true,\n  showCaptionsControl: true,\n  showDensityPicker: true,\n  showMinimize: true,\n  showEnd: true,\n  showSurfacePanel: true,\n  showChannels: true,\n  showActivityRail: true,\n  showDevLinks: true,\n  allowResize: true,\n};\n\n/**\n * Live runtime facts the widget feeds into the resolver. These are *observed*,\n * not configured — they come from the disclosure model, a `ResizeObserver`, and\n * the session/channel state. Pure data so the resolver stays testable.\n */\nexport interface RealtimeUiSignals {\n  /** Current width of the widget's container, in px (from a `ResizeObserver`). */\n  containerWidthPx: number;\n  /**\n   * Has the user revealed text this session? (i.e. tapped \"show the\n   * conversation\" / engaged the composer — disclosure level ≥ 1.) This is the\n   * intent half of the auto orb↔console rule.\n   */\n  textRevealed: boolean;\n  /** Disclosure model says a transcript may be shown. */\n  disclosureShowThread: boolean;\n  /** Disclosure model says the composer/text dock may be shown. */\n  disclosureShowComposer: boolean;\n  /** Disclosure model says a surface panel may be shown. */\n  disclosureShowPanel: boolean;\n  /** Disclosure model says the gear/settings menu may be shown. */\n  disclosureShowGear: boolean;\n  /** A surface/channel actually exists to populate the panel. */\n  surfacePanelEarned: boolean;\n  /** ≥ 1 interactive channel is active. */\n  hasChannels: boolean;\n  /** ≥ 1 delegation/activity has occurred (Activity rail has content). */\n  hasActivity: boolean;\n  /** Per-session developer mode is on. */\n  devMode: boolean;\n  /** The widget is reviewing a past (recorded) session, not a live call. */\n  isReviewing: boolean;\n  /** A single channel surface is maximized (focus mode); the main column is hidden. */\n  channelFocus: boolean;\n  /** Current connection lifecycle state. */\n  connectionState: RealtimeUiConnectionState;\n}\n\n/**\n * The resolved, render-ready view-model. Every field is a final boolean (or the\n * effective chrome) — the template binds straight to these with no further\n * logic. This is the single source of truth for \"what is on screen right now\".\n */\nexport interface ResolvedRealtimeUi {\n  /** The effective chrome after resolving `'auto'`. */\n  chrome: 'orb' | 'console';\n  /** Whether compact spacing/typography applies. */\n  compact: boolean;\n  /** True while connecting — hosts can show a single, size-independent loader. */\n  connecting: boolean;\n\n  /** The big ambient hero orb is the primary surface. */\n  showHero: boolean;\n  /** The transcript/thread is visible. */\n  showThread: boolean;\n  /** The text composer dock is visible. */\n  showComposer: boolean;\n  /** The right-hand surface panel is visible. */\n  showSurfacePanel: boolean;\n  /** The Activity tab/rail is available. */\n  showActivityTab: boolean;\n  /** The channel strip is visible. */\n  showChannelStrip: boolean;\n\n  /** The captions toggle is available. */\n  showCaptionsControl: boolean;\n  /** The density picker is available (inside the gear). */\n  showDensityPicker: boolean;\n  /** The gear/settings affordance is available. */\n  showGear: boolean;\n  /** Developer links/panels are available. */\n  showDevLinks: boolean;\n  /** The minimize control is available. */\n  showMinimize: boolean;\n  /** The end-call control is available. */\n  showEnd: boolean;\n\n  /** The surface panel may be drag-resized. */\n  allowResize: boolean;\n  /** The user has a path to reveal text. */\n  allowTextReveal: boolean;\n  /** Non-essential controls should auto-fade when idle. */\n  autoHideControls: boolean;\n}\n\n/**\n * A safe, dependency-free baseline {@link RealtimeUiSignals}. Use this to seed a\n * resolved view-model **before** the component's runtime dependencies (the\n * disclosure model, the session state, the `ResizeObserver`) exist — e.g. in a\n * field initializer. It describes a freshly-connecting widget at zero width with\n * nothing earned yet, so the first paint is a calm orb until `recomputeUi()`\n * runs with real signals. Never read `this` to build the first value.\n */\nexport const DEFAULT_REALTIME_UI_SIGNALS: RealtimeUiSignals = {\n  containerWidthPx: 0,\n  textRevealed: false,\n  disclosureShowThread: false,\n  disclosureShowComposer: false,\n  disclosureShowPanel: false,\n  disclosureShowGear: false,\n  surfacePanelEarned: false,\n  hasChannels: false,\n  hasActivity: false,\n  devMode: false,\n  isReviewing: false,\n  channelFocus: false,\n  connectionState: 'connecting',\n};\n\n/**\n * Resolve the consumer config + live signals into a render-ready view-model.\n *\n * Pure and deterministic: same inputs ⇒ same output, no side effects, no clock,\n * no DOM. Safe to call on every change-detection pass and trivial to unit test.\n *\n * The resolution order is:\n *  1. fill defaults,\n *  2. decide the effective {@link RealtimeChromeMode} (the orb↔console rule),\n *  3. for each affordance, AND the consumer's switch with the runtime gate.\n *\n * @param inputs  consumer configuration (partial; defaults fill the rest)\n * @param signals live runtime facts\n * @returns the fully-resolved {@link ResolvedRealtimeUi}\n *\n * @example Chat overlay (lean, ambient):\n * ```ts\n * resolveRealtimeUi(\n *   { chrome: 'auto', showSurfacePanel: false, showActivityRail: false, showDevLinks: false },\n *   signals\n * );\n * ```\n *\n * @example Full-screen route (rich console):\n * ```ts\n * resolveRealtimeUi({ chrome: 'auto', consoleBreakpointPx: 480 }, wideSignals);\n * ```\n */\nexport function resolveRealtimeUi(\n  inputs: RealtimeUiInputs | null | undefined,\n  signals: RealtimeUiSignals,\n): ResolvedRealtimeUi {\n  const cfg: Required<RealtimeUiInputs> = { ...DEFAULT_REALTIME_UI_INPUTS, ...(inputs ?? {}) };\n\n  const connecting = signals.connectionState === 'connecting';\n  const allowTextReveal = cfg.allowTextReveal;\n  const chrome = resolveChrome(cfg, signals, allowTextReveal);\n  const isConsole = chrome === 'console';\n  const compact = cfg.compact || signals.containerWidthPx < cfg.consoleBreakpointPx;\n\n  // The transcript shows when the user has EXPLICITLY revealed text this session\n  // (`textRevealed`), OR we're in a console (consoles always carry the thread), OR we're\n  // reviewing a recording. We deliberately do NOT consult the disclosure ratchet here: a\n  // power user with a high base level still opens to the calm orb, exactly like the historical\n  // `ShowHero = !ShowCaptions` behaviour — \"keep the orb until the user asks for text\".\n  const showThread = allowTextReveal && (signals.textRevealed || isConsole || signals.isReviewing);\n\n  // The hero orb owns the surface in orb chrome (and there's nothing else to show).\n  const showHero = chrome === 'orb' && !showThread;\n\n  const showComposer = isConsole && allowTextReveal && signals.disclosureShowComposer && !signals.isReviewing;\n\n  // The surface/Details panel opens ON DEMAND when earned (the Details peek, the agent's\n  // OpenSurfacePanel, content auto-reveal — all set surfacePanelEarned). It is an INDEPENDENT\n  // right-hand peek that rides ALONGSIDE whatever the main column shows — it must NOT require the\n  // cross-session disclosure ratchet (disclosureShowPanel = SessionLevel >= 2), and it must NOT\n  // require the user to have revealed text.\n  //\n  // It was previously gated on `isConsole`, which bundled TWO things: \"there's room\" (legitimate —\n  // don't cram a side panel into a narrow overlay) AND \"the user revealed text\" (wrong for a peek).\n  // The text-reveal coupling meant opening Details with captions OFF flipped the whole left column\n  // from the hero orb to an empty transcript (the orb vanished), and toggling captions back off\n  // yanked the panel out from under an open peek. The design intent (see the auto-reveal comment in\n  // the overlay component: \"the left column stays exactly as it was, pure audio included\") is a peek\n  // beside the orb. So we keep only the ROOM half: the panel shows when earned and either the chrome\n  // is already a console (incl. review / forced-console at any width) OR the container is at least as\n  // wide as the console breakpoint — never in a cramped narrow overlay, and never dependent on text.\n  const roomForSurfacePanel = isConsole || signals.containerWidthPx >= cfg.consoleBreakpointPx;\n  const showSurfacePanel =\n    cfg.showSurfacePanel && signals.surfacePanelEarned && !signals.channelFocus && roomForSurfacePanel;\n\n  const showActivityTab = cfg.showActivityRail && (signals.hasActivity || signals.isReviewing) && isConsole;\n\n  const showChannelStrip = cfg.showChannels && signals.hasChannels && isConsole && !signals.channelFocus;\n\n  const showGear = signals.disclosureShowGear || isConsole;\n\n  return {\n    chrome,\n    compact,\n    connecting,\n    showHero,\n    showThread,\n    showComposer,\n    showSurfacePanel,\n    showActivityTab,\n    showChannelStrip,\n    showCaptionsControl: cfg.showCaptionsControl,\n    showDensityPicker: cfg.showDensityPicker && showGear,\n    showGear,\n    showDevLinks: cfg.showDevLinks && signals.devMode,\n    showMinimize: cfg.showMinimize && !signals.isReviewing,\n    showEnd: cfg.showEnd,\n    allowResize: cfg.allowResize && showSurfacePanel,\n    allowTextReveal,\n    autoHideControls: cfg.autoHideControls && chrome === 'orb',\n  };\n}\n\n/**\n * Decide the effective chrome. Forced modes win outright; `'auto'` graduates to a\n * console only when there's both **room** (width ≥ breakpoint) and **intent**\n * (text revealed) — or when reviewing, which always wants the transcript.\n *\n * @internal\n */\nfunction resolveChrome(\n  cfg: Required<RealtimeUiInputs>,\n  signals: RealtimeUiSignals,\n  allowTextReveal: boolean,\n): 'orb' | 'console' {\n  if (cfg.chrome === 'orb') {\n    return 'orb';\n  }\n  if (cfg.chrome === 'console') {\n    return 'console';\n  }\n  // auto\n  if (signals.isReviewing) {\n    return 'console';\n  }\n  if (!allowTextReveal) {\n    return 'orb';\n  }\n  // Intent is the USER explicitly revealing text this session — NOT the disclosure ratchet.\n  // Wider-alone keeps the orb; a power user who hasn't asked for text keeps the orb too.\n  const hasRoom = signals.containerWidthPx >= cfg.consoleBreakpointPx;\n  return hasRoom && signals.textRevealed ? 'console' : 'orb';\n}\n"]}

package/dist/lib/components/search/search-panel.component.d.ts

@@ -22,6 +22,8 @@ export declare class SearchPanelComponent implements OnInit, OnDestroy {
     results: GroupedSearchResults;
     recentSearches: string[];
     selectedIndex: number;
+    /** Message for the "no results" empty state, echoing the search term. */
+    get NoResultsMessage(): string;
     private destroy$;
     constructor(searchService: SearchService);
     ngOnInit(): void;

package/dist/lib/components/search/search-panel.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-panel.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/search/search-panel.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,SAAS,EAET,YAAY,EAIZ,UAAU,EACX,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACV,MAAM,+BAA+B,CAAC;;AAEvC;;;;GAIG;AACH,qBAMa,oBAAqB,YAAW,MAAM,EAAE,SAAS;IA2BhD,OAAO,CAAC,aAAa;IA1BxB,aAAa,EAAG,MAAM,CAAC;IACvB,WAAW,EAAG,QAAQ,CAAC;IACvB,MAAM,EAAE,OAAO,CAAS;IAEvB,KAAK,qBAA4B;IACjC,cAAc,6BAAoC;IAElC,WAAW,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE9D,WAAW,EAAE,MAAM,CAAM;IACzB,YAAY,EAAE,YAAY,CAAS;IACnC,SAAS,EAAE,SAAS,CAA8B;IAClD,WAAW,EAAE,OAAO,CAAS;IAC7B,OAAO,EAAE,oBAAoB,CAOlC;IACK,cAAc,EAAE,MAAM,EAAE,CAAM;IAC9B,aAAa,EAAE,MAAM,CAAM;IAElC,OAAO,CAAC,QAAQ,CAAuB;gBAEnB,aAAa,EAAE,aAAa;IAEhD,QAAQ,IAAI,IAAI;IAKhB,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACI,aAAa,IAAI,IAAI;IAQ5B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAO5C;;OAEG;IACI,WAAW,IAAI,IAAI;IAM1B;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/C;;OAEG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK3C;;OAEG;IACI,mBAAmB,IAAI,IAAI;IAKlC;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IAEI,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAoCjD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAMtD;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiB1C;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAmBlD;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAarC,0FAA0F;IACnF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1D;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAOhC;;OAEG;IACI,cAAc,IAAI,IAAI;IAQ7B;;OAEG;IACH,WAAW,IAAI,IAAI;yCAlTR,oBAAoB;2CAApB,oBAAoB;CAuThC"}
+{"version":3,"file":"search-panel.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/search/search-panel.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,SAAS,EAET,YAAY,EAIZ,UAAU,EACX,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACV,MAAM,+BAA+B,CAAC;;AAEvC;;;;GAIG;AACH,qBAMa,oBAAqB,YAAW,MAAM,EAAE,SAAS;IAgChD,OAAO,CAAC,aAAa;IA/BxB,aAAa,EAAG,MAAM,CAAC;IACvB,WAAW,EAAG,QAAQ,CAAC;IACvB,MAAM,EAAE,OAAO,CAAS;IAEvB,KAAK,qBAA4B;IACjC,cAAc,6BAAoC;IAElC,WAAW,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE9D,WAAW,EAAE,MAAM,CAAM;IACzB,YAAY,EAAE,YAAY,CAAS;IACnC,SAAS,EAAE,SAAS,CAA8B;IAClD,WAAW,EAAE,OAAO,CAAS;IAC7B,OAAO,EAAE,oBAAoB,CAOlC;IACK,cAAc,EAAE,MAAM,EAAE,CAAM;IAC9B,aAAa,EAAE,MAAM,CAAM;IAElC,yEAAyE;IACzE,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,OAAO,CAAC,QAAQ,CAAuB;gBAEnB,aAAa,EAAE,aAAa;IAEhD,QAAQ,IAAI,IAAI;IAKhB,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACI,aAAa,IAAI,IAAI;IAQ5B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAO5C;;OAEG;IACI,WAAW,IAAI,IAAI;IAM1B;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/C;;OAEG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK3C;;OAEG;IACI,mBAAmB,IAAI,IAAI;IAKlC;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IAEI,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAoCjD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAMtD;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiB1C;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAmBlD;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAarC,0FAA0F;IACnF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1D;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAOhC;;OAEG;IACI,cAAc,IAAI,IAAI;IAQ7B;;OAEG;IACH,WAAW,IAAI,IAAI;yCAvTR,oBAAoB;2CAApB,oBAAoB;CA4ThC"}