@memberjunction/ng-conversations 5.40.2 → 5.41.0

package/dist/lib/components/realtime/realtime-surface-tabs.model.d.ts

@@ -0,0 +1,181 @@
+import { Subject } from 'rxjs';
+import type { TemplateRef } from '@angular/core';
+import type { BaseRealtimeChannelClient } from './channels/base-realtime-channel-client';
+import { ParsedDelegationArtifact } from '../../services/delegation-result-parser';
+/**
+ * The kind of a surface-panel tab:
+ *  - `activity` — the always-present first tab hosting the session activity rail.
+ *  - `artifact` — one tab per artifact produced by a delegated run (auto-opened on arrival).
+ *  - `channel`  — an interactive-channel surface (e.g. the Whiteboard). Registered per
+ *    registry-resolved plugin via {@link RealtimeSurfaceTabsModel.RegisterChannelTab};
+ *    renders the plugin's dynamically-created surface component (or a registered template
+ *    for legacy/template-based panes), with the "coming online…" placeholder until either
+ *    is supplied.
+ */
+export type RealtimeSurfaceTabKind = 'activity' | 'artifact' | 'channel';
+/**
+ * Per-kind payload carried on a {@link RealtimeSurfaceTab}.
+ */
+export interface RealtimeSurfaceTabData {
+    /** For `artifact` tabs: the artifact this tab views (loaded by ArtifactID, latest version). */
+    Artifact?: ParsedDelegationArtifact;
+    /**
+     * For `channel` tabs: the channel PLUGIN whose surface component the pane creates
+     * dynamically (and binds back to the plugin) — the registry-driven path every real
+     * channel uses. Takes precedence over {@link Content}.
+     */
+    Plugin?: BaseRealtimeChannelClient;
+    /**
+     * For `channel` tabs: a TEMPLATE-based pane body. Backward-compatible alternative to
+     * {@link Plugin} for hosts that render a bespoke surface without a channel plugin.
+     * When BOTH are absent the pane renders the built-in "coming online…" placeholder.
+     */
+    Content?: TemplateRef<unknown>;
+}
+/**
+ * One tab on the call overlay's tabbed surface panel (the right panel): Activity, an
+ * artifact viewer, or an interactive-channel surface.
+ */
+export interface RealtimeSurfaceTab {
+    /** Stable unique key (`activity`, `artifact:<versionId>`, or the channel's registered key). */
+    Key: string;
+    /** Tab strip label (artifact tabs use the artifact's name). */
+    Title: string;
+    /** Font Awesome icon class for the tab strip (e.g. `fa-solid fa-file-lines`). */
+    Icon: string;
+    /** What the tab renders. */
+    Kind: RealtimeSurfaceTabKind;
+    /** Kind-specific payload. */
+    Data?: RealtimeSurfaceTabData;
+}
+/**
+ * Registration for an interactive-channel tab. The overlay shell registers one per
+ * registry-resolved channel plugin (supplying {@link Plugin}); supplying {@link Plugin}
+ * or {@link Content} later under the same `Key` upgrades a placeholder tab to the real
+ * surface.
+ */
+export interface RealtimeChannelTabRegistration {
+    /** Stable channel key (the plugin's `ChannelName`, e.g. `Whiteboard`). Re-registering the same key updates the tab. */
+    Key: string;
+    /** Tab strip label (e.g. `Whiteboard`). */
+    Title: string;
+    /** Font Awesome icon class (e.g. `fa-solid fa-chalkboard`). */
+    Icon: string;
+    /** The channel plugin whose surface the pane creates + binds. Preferred over {@link Content}. */
+    Plugin?: BaseRealtimeChannelClient;
+    /** A template-based pane body (legacy/bespoke panes). Omit both to show the "coming online…" placeholder. */
+    Content?: TemplateRef<unknown>;
+    /** Focus the tab immediately after registration (default `false`). */
+    Focus?: boolean;
+}
+/**
+ * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list
+ * (CHANNEL tabs first — the marquee surfaces — then artifact tabs in arrival order, with
+ * Activity pinned LAST), the active tab, the transient "flash" highlight for a
+ * just-arrived tab, and the persistent UNSEEN glow for content that arrived without
+ * stealing focus (an artifact tab glows until the user visits it).
+ *
+ * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the
+ * add / focus / dedupe / flash / unseen logic is unit-testable in isolation. All
+ * collections are REPLACED (never mutated) on change, and every change emits {@link Changed$}.
+ */
+export declare class RealtimeSurfaceTabsModel {
+    /** The fixed key of the always-present Activity tab (pinned as the LAST tab). */
+    static readonly ActivityTabKey = "activity";
+    /** The ordered tabs (channels… · artifacts… · Activity last). Replaced immutably on every change. */
+    Tabs: RealtimeSurfaceTab[];
+    /** Key of the currently focused tab. */
+    ActiveKey: string;
+    /**
+     * Key of the tab currently "flashing" (the brief violet highlight a just-arrived
+     * artifact tab gets, per the mockup). Cleared by the owning component after a beat
+     * via {@link ClearFlash}.
+     */
+    FlashKey: string | null;
+    /**
+     * Tabs holding content the user hasn't visited yet (the persistent glow): an artifact
+     * tab that arrived WITHOUT stealing focus stays marked until it is focused. Replaced
+     * immutably on change.
+     */
+    private unseenKeys;
+    /** Emits after every model change so the owning component can mark for check. */
+    readonly Changed$: Subject<void>;
+    /** The currently focused tab (always resolvable — Activity is never removed). */
+    get ActiveTab(): RealtimeSurfaceTab;
+    /** True while the tab with `key` holds content the user hasn't visited (glow state). */
+    IsUnseen(key: string): boolean;
+    /** The stable tab key for an artifact (one tab per produced artifact VERSION). */
+    static ArtifactTabKey(artifact: ParsedDelegationArtifact): string;
+    /**
+     * Opens (or re-focuses) the tab for an artifact a delegated run produced.
+     *
+     * First arrival: inserts an `artifact` tab AFTER existing channel/artifact tabs but
+     * BEFORE the pinned-last Activity tab, marks it as the {@link FlashKey}, and — unless
+     * `focus` is true — leaves focus alone and marks the tab UNSEEN (it glows until
+     * visited; per product direction a finished artifact never steals the screen, only the
+     * agent's first channel activity does). Subsequent calls for the same artifact version
+     * just (optionally) focus the existing tab — no duplicate, no re-flash.
+     *
+     * @param artifact The produced artifact (id + version id + display name).
+     * @param focus Whether to focus the tab (default `false` — glow, don't grab).
+     * @param markUnseen Whether an unfocused first arrival glows (default `true`). Pass
+     *   `false` for HISTORY artifacts (session-review carryover) — they're context, not news.
+     * @returns The (new or existing) tab.
+     */
+    OpenArtifactTab(artifact: ParsedDelegationArtifact, focus?: boolean, markUnseen?: boolean): RealtimeSurfaceTab;
+    /**
+     * Registers (or updates) an interactive-channel tab. Re-registering an existing key
+     * replaces its title/icon/plugin/content in place (this is how a placeholder upgrades
+     * to the real surface once the channel comes online). New channel tabs lead the strip
+     * (before artifact tabs and the pinned-last Activity tab) — the marquee surfaces.
+     *
+     * @param registration The channel tab registration.
+     * @returns The (new or updated) tab.
+     */
+    RegisterChannelTab(registration: RealtimeChannelTabRegistration): RealtimeSurfaceTab;
+    /** Focuses the tab with `key` (no-op when it doesn't exist); visiting clears its unseen glow. */
+    Focus(key: string): void;
+    /** The index of the pinned-last Activity tab (insertion boundary for content tabs). */
+    private activityIndex;
+    /** Clears a tab's unseen glow (no emission of its own — callers emit). */
+    private markSeen;
+    /**
+     * Marks the tab with `key` as the {@link FlashKey} (the brief violet "just arrived"
+     * highlight) WITHOUT changing focus — used by the auto-reveal path when the agent first
+     * acts on a channel, so the user's eye lands on the tab that just came alive. No-op for
+     * unknown keys; the owning component clears it after a beat via {@link ClearFlash}.
+     */
+    FlashTab(key: string): void;
+    /**
+     * Removes the tab with `key`. Rules:
+     *  - the Activity tab is IRREMOVABLE (always the panel's first tab) — removing it is a no-op;
+     *  - an unknown key is a no-op (returns `false`);
+     *  - when the removed tab was focused, focus falls back to the Activity tab;
+     *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.
+     *
+     * @param key The tab key to remove.
+     * @returns `true` when a tab was removed.
+     */
+    RemoveTab(key: string): boolean;
+    /** Clears the transient flash highlight (called by the component after a beat). */
+    ClearFlash(): void;
+}
+/**
+ * Pure decision helper for the REVIEW→LIVE continuation edge: should the overlay REMOVE the
+ * review-registered (template-based, read-only) Whiteboard tab?
+ *
+ * Yes only when ALL hold:
+ *  - a live session is active (the channel set emission belongs to a real session start, not
+ *    the initial/teardown `[]` replay);
+ *  - review mode actually registered a whiteboard tab (otherwise there is nothing stale);
+ *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the
+ *    live plugin re-registers the same tab key and upgrades the pane in place instead.
+ *
+ * Review ARTIFACT tabs are deliberately NOT removed — they are wanted carryover.
+ *
+ * Kept framework-free (like the model) so the rule is unit-testable in isolation.
+ */
+export declare function ShouldRemoveReviewWhiteboardTab(liveSessionActive: boolean, reviewWhiteboardTabRegistered: boolean, liveChannels: ReadonlyArray<{
+    ChannelName: string;
+}>): boolean;
+//# sourceMappingURL=realtime-surface-tabs.model.d.ts.map

package/dist/lib/components/realtime/realtime-surface-tabs.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-tabs.model.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.model.ts"],"names":[],"mappings":"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"}

package/dist/lib/components/realtime/realtime-surface-tabs.model.js

@@ -0,0 +1,223 @@
+import { Subject } from 'rxjs';
+/**
+ * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list
+ * (CHANNEL tabs first — the marquee surfaces — then artifact tabs in arrival order, with
+ * Activity pinned LAST), the active tab, the transient "flash" highlight for a
+ * just-arrived tab, and the persistent UNSEEN glow for content that arrived without
+ * stealing focus (an artifact tab glows until the user visits it).
+ *
+ * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the
+ * add / focus / dedupe / flash / unseen logic is unit-testable in isolation. All
+ * collections are REPLACED (never mutated) on change, and every change emits {@link Changed$}.
+ */
+export class RealtimeSurfaceTabsModel {
+    /** The fixed key of the always-present Activity tab (pinned as the LAST tab). */
+    static ActivityTabKey = 'activity';
+    /** The ordered tabs (channels… · artifacts… · Activity last). Replaced immutably on every change. */
+    Tabs = [
+        { Key: RealtimeSurfaceTabsModel.ActivityTabKey, Title: 'Activity', Icon: 'fa-solid fa-list-check', Kind: 'activity' }
+    ];
+    /** Key of the currently focused tab. */
+    ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;
+    /**
+     * Key of the tab currently "flashing" (the brief violet highlight a just-arrived
+     * artifact tab gets, per the mockup). Cleared by the owning component after a beat
+     * via {@link ClearFlash}.
+     */
+    FlashKey = null;
+    /**
+     * Tabs holding content the user hasn't visited yet (the persistent glow): an artifact
+     * tab that arrived WITHOUT stealing focus stays marked until it is focused. Replaced
+     * immutably on change.
+     */
+    unseenKeys = new Set();
+    /** Emits after every model change so the owning component can mark for check. */
+    Changed$ = new Subject();
+    /** The currently focused tab (always resolvable — Activity is never removed). */
+    get ActiveTab() {
+        return this.Tabs.find(t => t.Key === this.ActiveKey)
+            ?? this.Tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)
+            ?? this.Tabs[0];
+    }
+    /** True while the tab with `key` holds content the user hasn't visited (glow state). */
+    IsUnseen(key) {
+        return this.unseenKeys.has(key);
+    }
+    /** The stable tab key for an artifact (one tab per produced artifact VERSION). */
+    static ArtifactTabKey(artifact) {
+        return `artifact:${artifact.ArtifactVersionID}`;
+    }
+    /**
+     * Opens (or re-focuses) the tab for an artifact a delegated run produced.
+     *
+     * First arrival: inserts an `artifact` tab AFTER existing channel/artifact tabs but
+     * BEFORE the pinned-last Activity tab, marks it as the {@link FlashKey}, and — unless
+     * `focus` is true — leaves focus alone and marks the tab UNSEEN (it glows until
+     * visited; per product direction a finished artifact never steals the screen, only the
+     * agent's first channel activity does). Subsequent calls for the same artifact version
+     * just (optionally) focus the existing tab — no duplicate, no re-flash.
+     *
+     * @param artifact The produced artifact (id + version id + display name).
+     * @param focus Whether to focus the tab (default `false` — glow, don't grab).
+     * @param markUnseen Whether an unfocused first arrival glows (default `true`). Pass
+     *   `false` for HISTORY artifacts (session-review carryover) — they're context, not news.
+     * @returns The (new or existing) tab.
+     */
+    OpenArtifactTab(artifact, focus = false, markUnseen = true) {
+        const key = RealtimeSurfaceTabsModel.ArtifactTabKey(artifact);
+        const existing = this.Tabs.find(t => t.Key === key);
+        if (existing) {
+            if (focus) {
+                this.Focus(key);
+            }
+            return existing;
+        }
+        const tab = {
+            Key: key,
+            Title: artifact.Name,
+            Icon: 'fa-solid fa-file-lines',
+            Kind: 'artifact',
+            Data: { Artifact: artifact }
+        };
+        // Insert before the pinned-last Activity tab: channels… | artifacts… | Activity.
+        const at = this.activityIndex();
+        this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];
+        this.FlashKey = key;
+        if (focus) {
+            this.ActiveKey = key;
+        }
+        else if (markUnseen) {
+            this.unseenKeys = new Set([...this.unseenKeys, key]);
+        }
+        this.Changed$.next();
+        return tab;
+    }
+    /**
+     * Registers (or updates) an interactive-channel tab. Re-registering an existing key
+     * replaces its title/icon/plugin/content in place (this is how a placeholder upgrades
+     * to the real surface once the channel comes online). New channel tabs lead the strip
+     * (before artifact tabs and the pinned-last Activity tab) — the marquee surfaces.
+     *
+     * @param registration The channel tab registration.
+     * @returns The (new or updated) tab.
+     */
+    RegisterChannelTab(registration) {
+        const tab = {
+            Key: registration.Key,
+            Title: registration.Title,
+            Icon: registration.Icon,
+            Kind: 'channel',
+            Data: { Plugin: registration.Plugin, Content: registration.Content }
+        };
+        const idx = this.Tabs.findIndex(t => t.Key === registration.Key);
+        if (idx >= 0) {
+            const next = [...this.Tabs];
+            next[idx] = tab;
+            this.Tabs = next;
+        }
+        else {
+            // Insert after existing channel tabs, before artifacts and the pinned-last Activity.
+            const firstNonChannel = this.Tabs.findIndex(t => t.Kind !== 'channel');
+            const at = firstNonChannel >= 0 ? firstNonChannel : this.Tabs.length;
+            this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];
+        }
+        if (registration.Focus) {
+            this.ActiveKey = tab.Key;
+            this.markSeen(tab.Key);
+        }
+        this.Changed$.next();
+        return tab;
+    }
+    /** Focuses the tab with `key` (no-op when it doesn't exist); visiting clears its unseen glow. */
+    Focus(key) {
+        if (!this.Tabs.some(t => t.Key === key)) {
+            return;
+        }
+        const changed = this.ActiveKey !== key || this.unseenKeys.has(key);
+        this.ActiveKey = key;
+        this.markSeen(key);
+        if (changed) {
+            this.Changed$.next();
+        }
+    }
+    /** The index of the pinned-last Activity tab (insertion boundary for content tabs). */
+    activityIndex() {
+        const idx = this.Tabs.findIndex(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey);
+        return idx >= 0 ? idx : this.Tabs.length;
+    }
+    /** Clears a tab's unseen glow (no emission of its own — callers emit). */
+    markSeen(key) {
+        if (this.unseenKeys.has(key)) {
+            const next = new Set(this.unseenKeys);
+            next.delete(key);
+            this.unseenKeys = next;
+        }
+    }
+    /**
+     * Marks the tab with `key` as the {@link FlashKey} (the brief violet "just arrived"
+     * highlight) WITHOUT changing focus — used by the auto-reveal path when the agent first
+     * acts on a channel, so the user's eye lands on the tab that just came alive. No-op for
+     * unknown keys; the owning component clears it after a beat via {@link ClearFlash}.
+     */
+    FlashTab(key) {
+        if (this.FlashKey === key || !this.Tabs.some(t => t.Key === key)) {
+            return;
+        }
+        this.FlashKey = key;
+        this.Changed$.next();
+    }
+    /**
+     * Removes the tab with `key`. Rules:
+     *  - the Activity tab is IRREMOVABLE (always the panel's first tab) — removing it is a no-op;
+     *  - an unknown key is a no-op (returns `false`);
+     *  - when the removed tab was focused, focus falls back to the Activity tab;
+     *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.
+     *
+     * @param key The tab key to remove.
+     * @returns `true` when a tab was removed.
+     */
+    RemoveTab(key) {
+        if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.Tabs.some(t => t.Key === key)) {
+            return false;
+        }
+        this.Tabs = this.Tabs.filter(t => t.Key !== key);
+        if (this.ActiveKey === key) {
+            this.ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;
+        }
+        if (this.FlashKey === key) {
+            this.FlashKey = null;
+        }
+        this.markSeen(key); // a removed tab can't dangle an unseen glow
+        this.Changed$.next();
+        return true;
+    }
+    /** Clears the transient flash highlight (called by the component after a beat). */
+    ClearFlash() {
+        if (this.FlashKey !== null) {
+            this.FlashKey = null;
+            this.Changed$.next();
+        }
+    }
+}
+/**
+ * Pure decision helper for the REVIEW→LIVE continuation edge: should the overlay REMOVE the
+ * review-registered (template-based, read-only) Whiteboard tab?
+ *
+ * Yes only when ALL hold:
+ *  - a live session is active (the channel set emission belongs to a real session start, not
+ *    the initial/teardown `[]` replay);
+ *  - review mode actually registered a whiteboard tab (otherwise there is nothing stale);
+ *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the
+ *    live plugin re-registers the same tab key and upgrades the pane in place instead.
+ *
+ * Review ARTIFACT tabs are deliberately NOT removed — they are wanted carryover.
+ *
+ * Kept framework-free (like the model) so the rule is unit-testable in isolation.
+ */
+export function ShouldRemoveReviewWhiteboardTab(liveSessionActive, reviewWhiteboardTabRegistered, liveChannels) {
+    if (!liveSessionActive || !reviewWhiteboardTabRegistered) {
+        return false;
+    }
+    return !liveChannels.some(c => c.ChannelName?.trim().toLowerCase() === 'whiteboard');
+}
+//# sourceMappingURL=realtime-surface-tabs.model.js.map

package/dist/lib/components/realtime/realtime-surface-tabs.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-tabs.model.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.model.ts"],"names":[],"mappings":"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","sourcesContent":["import { Subject } from 'rxjs';\nimport type { TemplateRef } from '@angular/core';\nimport type { BaseRealtimeChannelClient } from './channels/base-realtime-channel-client';\nimport { ParsedDelegationArtifact } from '../../services/delegation-result-parser';\n\n/**\n * The kind of a surface-panel tab:\n *  - `activity` — the always-present first tab hosting the session activity rail.\n *  - `artifact` — one tab per artifact produced by a delegated run (auto-opened on arrival).\n *  - `channel`  — an interactive-channel surface (e.g. the Whiteboard). Registered per\n *    registry-resolved plugin via {@link RealtimeSurfaceTabsModel.RegisterChannelTab};\n *    renders the plugin's dynamically-created surface component (or a registered template\n *    for legacy/template-based panes), with the \"coming online…\" placeholder until either\n *    is supplied.\n */\nexport type RealtimeSurfaceTabKind = 'activity' | 'artifact' | 'channel';\n\n/**\n * Per-kind payload carried on a {@link RealtimeSurfaceTab}.\n */\nexport interface RealtimeSurfaceTabData {\n  /** For `artifact` tabs: the artifact this tab views (loaded by ArtifactID, latest version). */\n  Artifact?: ParsedDelegationArtifact;\n  /**\n   * For `channel` tabs: the channel PLUGIN whose surface component the pane creates\n   * dynamically (and binds back to the plugin) — the registry-driven path every real\n   * channel uses. Takes precedence over {@link Content}.\n   */\n  Plugin?: BaseRealtimeChannelClient;\n  /**\n   * For `channel` tabs: a TEMPLATE-based pane body. Backward-compatible alternative to\n   * {@link Plugin} for hosts that render a bespoke surface without a channel plugin.\n   * When BOTH are absent the pane renders the built-in \"coming online…\" placeholder.\n   */\n  Content?: TemplateRef<unknown>;\n}\n\n/**\n * One tab on the call overlay's tabbed surface panel (the right panel): Activity, an\n * artifact viewer, or an interactive-channel surface.\n */\nexport interface RealtimeSurfaceTab {\n  /** Stable unique key (`activity`, `artifact:<versionId>`, or the channel's registered key). */\n  Key: string;\n  /** Tab strip label (artifact tabs use the artifact's name). */\n  Title: string;\n  /** Font Awesome icon class for the tab strip (e.g. `fa-solid fa-file-lines`). */\n  Icon: string;\n  /** What the tab renders. */\n  Kind: RealtimeSurfaceTabKind;\n  /** Kind-specific payload. */\n  Data?: RealtimeSurfaceTabData;\n}\n\n/**\n * Registration for an interactive-channel tab. The overlay shell registers one per\n * registry-resolved channel plugin (supplying {@link Plugin}); supplying {@link Plugin}\n * or {@link Content} later under the same `Key` upgrades a placeholder tab to the real\n * surface.\n */\nexport interface RealtimeChannelTabRegistration {\n  /** Stable channel key (the plugin's `ChannelName`, e.g. `Whiteboard`). Re-registering the same key updates the tab. */\n  Key: string;\n  /** Tab strip label (e.g. `Whiteboard`). */\n  Title: string;\n  /** Font Awesome icon class (e.g. `fa-solid fa-chalkboard`). */\n  Icon: string;\n  /** The channel plugin whose surface the pane creates + binds. Preferred over {@link Content}. */\n  Plugin?: BaseRealtimeChannelClient;\n  /** A template-based pane body (legacy/bespoke panes). Omit both to show the \"coming online…\" placeholder. */\n  Content?: TemplateRef<unknown>;\n  /** Focus the tab immediately after registration (default `false`). */\n  Focus?: boolean;\n}\n\n/**\n * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list\n * (CHANNEL tabs first — the marquee surfaces — then artifact tabs in arrival order, with\n * Activity pinned LAST), the active tab, the transient \"flash\" highlight for a\n * just-arrived tab, and the persistent UNSEEN glow for content that arrived without\n * stealing focus (an artifact tab glows until the user visits it).\n *\n * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the\n * add / focus / dedupe / flash / unseen logic is unit-testable in isolation. All\n * collections are REPLACED (never mutated) on change, and every change emits {@link Changed$}.\n */\nexport class RealtimeSurfaceTabsModel {\n  /** The fixed key of the always-present Activity tab (pinned as the LAST tab). */\n  public static readonly ActivityTabKey = 'activity';\n\n  /** The ordered tabs (channels… · artifacts… · Activity last). Replaced immutably on every change. */\n  public Tabs: RealtimeSurfaceTab[] = [\n    { Key: RealtimeSurfaceTabsModel.ActivityTabKey, Title: 'Activity', Icon: 'fa-solid fa-list-check', Kind: 'activity' }\n  ];\n\n  /** Key of the currently focused tab. */\n  public ActiveKey: string = RealtimeSurfaceTabsModel.ActivityTabKey;\n\n  /**\n   * Key of the tab currently \"flashing\" (the brief violet highlight a just-arrived\n   * artifact tab gets, per the mockup). Cleared by the owning component after a beat\n   * via {@link ClearFlash}.\n   */\n  public FlashKey: string | null = null;\n\n  /**\n   * Tabs holding content the user hasn't visited yet (the persistent glow): an artifact\n   * tab that arrived WITHOUT stealing focus stays marked until it is focused. Replaced\n   * immutably on change.\n   */\n  private unseenKeys: ReadonlySet<string> = new Set<string>();\n\n  /** Emits after every model change so the owning component can mark for check. */\n  public readonly Changed$ = new Subject<void>();\n\n  /** The currently focused tab (always resolvable — Activity is never removed). */\n  public get ActiveTab(): RealtimeSurfaceTab {\n    return this.Tabs.find(t => t.Key === this.ActiveKey)\n      ?? this.Tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)\n      ?? this.Tabs[0];\n  }\n\n  /** True while the tab with `key` holds content the user hasn't visited (glow state). */\n  public IsUnseen(key: string): boolean {\n    return this.unseenKeys.has(key);\n  }\n\n  /** The stable tab key for an artifact (one tab per produced artifact VERSION). */\n  public static ArtifactTabKey(artifact: ParsedDelegationArtifact): string {\n    return `artifact:${artifact.ArtifactVersionID}`;\n  }\n\n  /**\n   * Opens (or re-focuses) the tab for an artifact a delegated run produced.\n   *\n   * First arrival: inserts an `artifact` tab AFTER existing channel/artifact tabs but\n   * BEFORE the pinned-last Activity tab, marks it as the {@link FlashKey}, and — unless\n   * `focus` is true — leaves focus alone and marks the tab UNSEEN (it glows until\n   * visited; per product direction a finished artifact never steals the screen, only the\n   * agent's first channel activity does). Subsequent calls for the same artifact version\n   * just (optionally) focus the existing tab — no duplicate, no re-flash.\n   *\n   * @param artifact The produced artifact (id + version id + display name).\n   * @param focus Whether to focus the tab (default `false` — glow, don't grab).\n   * @param markUnseen Whether an unfocused first arrival glows (default `true`). Pass\n   *   `false` for HISTORY artifacts (session-review carryover) — they're context, not news.\n   * @returns The (new or existing) tab.\n   */\n  public OpenArtifactTab(artifact: ParsedDelegationArtifact, focus: boolean = false, markUnseen: boolean = true): RealtimeSurfaceTab {\n    const key = RealtimeSurfaceTabsModel.ArtifactTabKey(artifact);\n    const existing = this.Tabs.find(t => t.Key === key);\n    if (existing) {\n      if (focus) {\n        this.Focus(key);\n      }\n      return existing;\n    }\n    const tab: RealtimeSurfaceTab = {\n      Key: key,\n      Title: artifact.Name,\n      Icon: 'fa-solid fa-file-lines',\n      Kind: 'artifact',\n      Data: { Artifact: artifact }\n    };\n    // Insert before the pinned-last Activity tab: channels… | artifacts… | Activity.\n    const at = this.activityIndex();\n    this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];\n    this.FlashKey = key;\n    if (focus) {\n      this.ActiveKey = key;\n    } else if (markUnseen) {\n      this.unseenKeys = new Set([...this.unseenKeys, key]);\n    }\n    this.Changed$.next();\n    return tab;\n  }\n\n  /**\n   * Registers (or updates) an interactive-channel tab. Re-registering an existing key\n   * replaces its title/icon/plugin/content in place (this is how a placeholder upgrades\n   * to the real surface once the channel comes online). New channel tabs lead the strip\n   * (before artifact tabs and the pinned-last Activity tab) — the marquee surfaces.\n   *\n   * @param registration The channel tab registration.\n   * @returns The (new or updated) tab.\n   */\n  public RegisterChannelTab(registration: RealtimeChannelTabRegistration): RealtimeSurfaceTab {\n    const tab: RealtimeSurfaceTab = {\n      Key: registration.Key,\n      Title: registration.Title,\n      Icon: registration.Icon,\n      Kind: 'channel',\n      Data: { Plugin: registration.Plugin, Content: registration.Content }\n    };\n    const idx = this.Tabs.findIndex(t => t.Key === registration.Key);\n    if (idx >= 0) {\n      const next = [...this.Tabs];\n      next[idx] = tab;\n      this.Tabs = next;\n    } else {\n      // Insert after existing channel tabs, before artifacts and the pinned-last Activity.\n      const firstNonChannel = this.Tabs.findIndex(t => t.Kind !== 'channel');\n      const at = firstNonChannel >= 0 ? firstNonChannel : this.Tabs.length;\n      this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];\n    }\n    if (registration.Focus) {\n      this.ActiveKey = tab.Key;\n      this.markSeen(tab.Key);\n    }\n    this.Changed$.next();\n    return tab;\n  }\n\n  /** Focuses the tab with `key` (no-op when it doesn't exist); visiting clears its unseen glow. */\n  public Focus(key: string): void {\n    if (!this.Tabs.some(t => t.Key === key)) {\n      return;\n    }\n    const changed = this.ActiveKey !== key || this.unseenKeys.has(key);\n    this.ActiveKey = key;\n    this.markSeen(key);\n    if (changed) {\n      this.Changed$.next();\n    }\n  }\n\n  /** The index of the pinned-last Activity tab (insertion boundary for content tabs). */\n  private activityIndex(): number {\n    const idx = this.Tabs.findIndex(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey);\n    return idx >= 0 ? idx : this.Tabs.length;\n  }\n\n  /** Clears a tab's unseen glow (no emission of its own — callers emit). */\n  private markSeen(key: string): void {\n    if (this.unseenKeys.has(key)) {\n      const next = new Set(this.unseenKeys);\n      next.delete(key);\n      this.unseenKeys = next;\n    }\n  }\n\n  /**\n   * Marks the tab with `key` as the {@link FlashKey} (the brief violet \"just arrived\"\n   * highlight) WITHOUT changing focus — used by the auto-reveal path when the agent first\n   * acts on a channel, so the user's eye lands on the tab that just came alive. No-op for\n   * unknown keys; the owning component clears it after a beat via {@link ClearFlash}.\n   */\n  public FlashTab(key: string): void {\n    if (this.FlashKey === key || !this.Tabs.some(t => t.Key === key)) {\n      return;\n    }\n    this.FlashKey = key;\n    this.Changed$.next();\n  }\n\n  /**\n   * Removes the tab with `key`. Rules:\n   *  - the Activity tab is IRREMOVABLE (always the panel's first tab) — removing it is a no-op;\n   *  - an unknown key is a no-op (returns `false`);\n   *  - when the removed tab was focused, focus falls back to the Activity tab;\n   *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.\n   *\n   * @param key The tab key to remove.\n   * @returns `true` when a tab was removed.\n   */\n  public RemoveTab(key: string): boolean {\n    if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.Tabs.some(t => t.Key === key)) {\n      return false;\n    }\n    this.Tabs = this.Tabs.filter(t => t.Key !== key);\n    if (this.ActiveKey === key) {\n      this.ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;\n    }\n    if (this.FlashKey === key) {\n      this.FlashKey = null;\n    }\n    this.markSeen(key); // a removed tab can't dangle an unseen glow\n    this.Changed$.next();\n    return true;\n  }\n\n  /** Clears the transient flash highlight (called by the component after a beat). */\n  public ClearFlash(): void {\n    if (this.FlashKey !== null) {\n      this.FlashKey = null;\n      this.Changed$.next();\n    }\n  }\n}\n\n/**\n * Pure decision helper for the REVIEW→LIVE continuation edge: should the overlay REMOVE the\n * review-registered (template-based, read-only) Whiteboard tab?\n *\n * Yes only when ALL hold:\n *  - a live session is active (the channel set emission belongs to a real session start, not\n *    the initial/teardown `[]` replay);\n *  - review mode actually registered a whiteboard tab (otherwise there is nothing stale);\n *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the\n *    live plugin re-registers the same tab key and upgrades the pane in place instead.\n *\n * Review ARTIFACT tabs are deliberately NOT removed — they are wanted carryover.\n *\n * Kept framework-free (like the model) so the rule is unit-testable in isolation.\n */\nexport function ShouldRemoveReviewWhiteboardTab(\n  liveSessionActive: boolean,\n  reviewWhiteboardTabRegistered: boolean,\n  liveChannels: ReadonlyArray<{ ChannelName: string }>\n): boolean {\n  if (!liveSessionActive || !reviewWhiteboardTabRegistered) {\n    return false;\n  }\n  return !liveChannels.some(c => c.ChannelName?.trim().toLowerCase() === 'whiteboard');\n}\n"]}

package/dist/lib/components/realtime/remote-browser/remote-browser-audio-player.d.ts

@@ -0,0 +1,163 @@
+/**
+ * The CLIENT-SIDE player for the Remote Browser tab-audio stream — the audio sibling of the surface's
+ * screencast canvas. The channel feeds it each pushed {@link RemoteBrowserAudioChunkInput} (a base64
+ * `audio/webm;codecs=opus` slice); the player appends them to a `MediaSource` `SourceBuffer` feeding a
+ * hidden `<audio>` element so the user HEARS what the co-agent is playing in the browser.
+ *
+ * The append/queue/seq logic is split from the DOM so it's unit-testable without a browser:
+ *  - {@link IAudioSink} is the thin DOM seam (create/append/error/muted) — faked in tests, wired to a real
+ *    `MediaSource` + `<audio>` in {@link MediaSourceAudioSink}.
+ *  - {@link RemoteBrowserAudioPlayer} owns the queue, sequential append (a `SourceBuffer` can only take one
+ *    append at a time), overflow drop, and sequence-gap resync — all framework- and DOM-free.
+ *
+ * Codec note: only `'webm-opus'` chunks are appendable to the `audio/webm;codecs=opus` SourceBuffer; other
+ * codecs (reserved for future backend capture paths) are dropped with a one-time warning.
+ */
+/** The narrow shape of a pushed audio chunk the player consumes (mirrors the server envelope fields). */
+export interface RemoteBrowserAudioChunkInput {
+    /** The encoded audio slice as raw base64 (no `data:` prefix). */
+    dataBase64: string;
+    /** The codec / container. Only `'webm-opus'` is currently playable. */
+    codec: string;
+    /** Sample rate in Hz (informational; the webm container is self-describing). */
+    sampleRate: number;
+    /** Channel count (informational). */
+    channels: number;
+    /** Monotonic sequence number for ordering / gap detection. */
+    seq: number;
+}
+/**
+ * The DOM seam the {@link RemoteBrowserAudioPlayer} drives. A real implementation wires a `MediaSource` +
+ * `SourceBuffer` + hidden `<audio>`; tests provide a fake that records appends. Kept deliberately tiny so
+ * the player's queueing logic is the part under test, not the browser media stack.
+ */
+export interface IAudioSink {
+    /**
+     * Prepares the sink for playback: creates the media source / source buffer / audio element and resolves
+     * once it is ready to accept {@link AppendChunk}. Idempotent — a second call while ready is a no-op.
+     */
+    Open(): Promise<void>;
+    /**
+     * Appends one decoded-container byte slice to the underlying buffer. Rejects if the sink isn't open or
+     * the underlying buffer rejects the append (the player then drops the chunk and continues).
+     *
+     * @param bytes The raw container bytes (e.g. a webm-opus slice) to append.
+     */
+    AppendChunk(bytes: Uint8Array): Promise<void>;
+    /** Whether the sink can currently accept an append (open and not mid-error / closed). */
+    readonly IsOpen: boolean;
+    /** Mutes or unmutes playback (the speaker toggle). */
+    SetMuted(muted: boolean): void;
+    /** Tears the sink down: stops playback and releases the media source / audio element. Idempotent. */
+    Close(): void;
+}
+/**
+ * Sequential, overflow-bounded player for a continuous webm-opus chunk stream. Construct it with an
+ * {@link IAudioSink}; call {@link Enqueue} for each pushed chunk and {@link SetMuted} for the speaker
+ * toggle; call {@link Dispose} on teardown.
+ */
+export declare class RemoteBrowserAudioPlayer {
+    /** The DOM (or fake) sink chunks are appended to. */
+    private readonly sink;
+    /** Pending decoded chunks awaiting append, oldest first. Bounded by {@link MAX_QUEUE_DEPTH}. */
+    private readonly queue;
+    /** True while an append is in flight (a SourceBuffer accepts one append at a time). */
+    private appending;
+    /** The sequence number of the last chunk we ACCEPTED, or `null` before the first. Drives gap detection. */
+    private lastSeq;
+    /** True once {@link Open} has been kicked off, so we don't re-open on every chunk. */
+    private opening;
+    /** True after {@link Dispose} so a late append / open resolution becomes a no-op. */
+    private disposed;
+    /** Pending muted state to apply once the sink opens (the toggle can fire before the first chunk). */
+    private muted;
+    /** Set once we've warned about an unplayable codec, so the log isn't spammed per chunk. */
+    private warnedUnplayableCodec;
+    /**
+     * Constructs a player over the given sink.
+     *
+     * @param sink The audio sink (real {@link MediaSourceAudioSink} in the app, a fake in tests).
+     */
+    constructor(sink: IAudioSink);
+    /** The current queue depth — exposed for tests / diagnostics. */
+    get QueueDepth(): number;
+    /**
+     * Enqueues one pushed audio chunk for playback. Drops chunks whose codec isn't playable, opens the sink
+     * lazily on the first playable chunk, detects sequence gaps (logged; the webm stream self-recovers on the
+     * next keyframe), and bounds the queue by dropping the oldest on overflow. Never throws.
+     *
+     * @param chunk The pushed chunk to play.
+     */
+    Enqueue(chunk: RemoteBrowserAudioChunkInput): void;
+    /**
+     * Mutes / unmutes playback (the speaker toggle). Safe to call before the sink opens — the state is
+     * applied once it does.
+     *
+     * @param muted `true` to mute, `false` to unmute.
+     */
+    SetMuted(muted: boolean): void;
+    /** Tears the player down: clears the queue and closes the sink. Idempotent. */
+    Dispose(): void;
+    /**
+     * Records a chunk's sequence number and logs a one-line note when a gap is detected (a non-consecutive
+     * seq). We don't try to reorder — webm-opus self-recovers at the next cluster — but the note aids
+     * diagnosis of a lossy transport.
+     *
+     * @param seq The incoming chunk's sequence number.
+     */
+    private noteSequence;
+    /** Pushes bytes onto the queue, dropping the OLDEST when the queue is at {@link MAX_QUEUE_DEPTH}. */
+    private pushBounded;
+    /**
+     * Ensures the sink is open (opening it lazily on first use) and then drains the queue. The open is
+     * kicked off once; subsequent calls just drain. Best-effort — an open/append failure is logged and the
+     * player keeps trying on the next chunk.
+     */
+    private ensureOpenThenDrain;
+    /**
+     * Appends queued chunks to the sink one at a time (a SourceBuffer rejects concurrent appends). Re-entrant
+     * safe via the {@link appending} guard; stops when the queue empties, the sink closes, or on disposal.
+     */
+    private drain;
+    /**
+     * Decodes a base64 string to bytes WITHOUT the DOM `atob` so the queueing logic is testable in Node too.
+     * Returns `null` on malformed input (the chunk is then skipped).
+     *
+     * @param base64 The base64 string to decode.
+     * @returns The decoded bytes, or `null` when the input can't be decoded.
+     */
+    private decodeBase64;
+}
+/**
+ * The real, DOM-backed {@link IAudioSink}: a `MediaSource` whose single `audio/webm;codecs=opus`
+ * `SourceBuffer` is fed appended chunks, attached to a hidden `<audio>` element that auto-plays. Autoplay
+ * is permitted because the realtime call the user already started is the activating gesture.
+ *
+ * Kept out of the player's hot path so the queueing logic stays unit-testable; this class is exercised in
+ * the live app (it can't be meaningfully unit-tested without a browser media stack).
+ */
+export declare class MediaSourceAudioSink implements IAudioSink {
+    /** MIME the SourceBuffer is created with — the in-page recorder's output container/codec. */
+    private static readonly MIME;
+    /** The hidden audio element playback is routed through; `null` before {@link Open} / after {@link Close}. */
+    private audio;
+    /** The MediaSource backing the audio element; `null` before {@link Open} / after {@link Close}. */
+    private mediaSource;
+    /** The single source buffer chunks are appended to; `null` until `sourceopen` wires it. */
+    private sourceBuffer;
+    /** Object URL bound to the audio element's `src`, revoked on {@link Close}. */
+    private objectUrl;
+    /** Latched muted state applied to the audio element as it (re)opens. */
+    private mutedState;
+    /** @inheritdoc */
+    get IsOpen(): boolean;
+    /** @inheritdoc */
+    Open(): Promise<void>;
+    /** @inheritdoc */
+    AppendChunk(bytes: Uint8Array): Promise<void>;
+    /** @inheritdoc */
+    SetMuted(muted: boolean): void;
+    /** @inheritdoc */
+    Close(): void;
+}
+//# sourceMappingURL=remote-browser-audio-player.d.ts.map

package/dist/lib/components/realtime/remote-browser/remote-browser-audio-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-audio-player.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/remote-browser/remote-browser-audio-player.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yGAAyG;AACzG,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/B,qGAAqG;IACrG,KAAK,IAAI,IAAI,CAAC;CACf;AAKD;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,uFAAuF;IACvF,OAAO,CAAC,SAAS,CAAS;IAE1B,2GAA2G;IAC3G,OAAO,CAAC,OAAO,CAAuB;IAEtC,sFAAsF;IACtF,OAAO,CAAC,OAAO,CAAS;IAExB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAS;IAEzB,qGAAqG;IACrG,OAAO,CAAC,KAAK,CAAS;IAEtB,2FAA2F;IAC3F,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;OAIG;gBACS,IAAI,EAAE,UAAU;IAI5B,iEAAiE;IACjE,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;;;;;OAMG;IACI,OAAO,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI;IAqBzD;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOrC,+EAA+E;IACxE,OAAO,IAAI,IAAI;IAMtB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAQpB,qGAAqG;IACrG,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;YACW,mBAAmB;IAmBjC;;;OAGG;YACW,KAAK;IAoBnB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAqBrB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,UAAU;IACrD,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAExD,6GAA6G;IAC7G,OAAO,CAAC,KAAK,CAAiC;IAC9C,mGAAmG;IACnG,OAAO,CAAC,WAAW,CAA4B;IAC/C,2FAA2F;IAC3F,OAAO,CAAC,YAAY,CAA6B;IACjD,+EAA+E;IAC/E,OAAO,CAAC,SAAS,CAAuB;IACxC,wEAAwE;IACxE,OAAO,CAAC,UAAU,CAAS;IAE3B,kBAAkB;IAClB,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,kBAAkB;IACL,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqClC,kBAAkB;IACL,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1D,kBAAkB;IACX,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOrC,kBAAkB;IACX,KAAK,IAAI,IAAI;CAcrB"}