@memberjunction/ng-conversations 5.40.2 → 5.41.0

package/dist/lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component.js

@@ -0,0 +1,180 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var WhiteboardArtifactViewerComponent_1;
+import { Component } from '@angular/core';
+import { DataSnapshot } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseArtifactViewerPluginComponent } from '@memberjunction/ng-artifacts';
+import { BuildWhiteboardExportHtml, BuildWhiteboardExportSvg, ParseBoardStateJson, WhiteboardSnapshotComponent } from '@memberjunction/ng-whiteboard';
+import * as i0 from "@angular/core";
+/**
+ * ARTIFACT VIEWER PLUGIN for saved whiteboards — renders the session-channel board
+ * artifact (a {@link WhiteboardState.ToJSON} payload) as a read-only snapshot with the
+ * same export affordances the live board offers (Download HTML / Download SVG / Print).
+ *
+ * Resolved dynamically by the artifact plugin host via the MJ ClassFactory (keyed by the
+ * artifact type's DriverClass), which instantiates the class ONCE with a bare `new` to
+ * discover the component type — so this class must stay constructible outside an Angular
+ * injection context (no `inject()` field initializers, no constructor DI).
+ */
+let WhiteboardArtifactViewerComponent = class WhiteboardArtifactViewerComponent extends BaseArtifactViewerPluginComponent {
+    static { WhiteboardArtifactViewerComponent_1 = this; }
+    /** Memoized parse — keyed by the raw content string so version switches re-parse. */
+    parsedForJson = null;
+    parsedState = null;
+    /** Raw board payload fed to the snapshot component (setter-driven re-parse there). */
+    get ContentJson() {
+        return this.getRawContent() ?? '';
+    }
+    /** Rehydrated board engine for export/snapshot duty (null when content is malformed). */
+    get BoardState() {
+        const json = this.getRawContent();
+        if (json !== this.parsedForJson) {
+            this.parsedForJson = json;
+            this.parsedState = ParseBoardStateJson(json);
+        }
+        return this.parsedState;
+    }
+    get HasBoard() {
+        return this.BoardState !== null;
+    }
+    get hasDisplayContent() {
+        return this.HasBoard;
+    }
+    GetCurrentStateSnapshot() {
+        const state = this.BoardState;
+        if (!state) {
+            return null;
+        }
+        const scene = state.BuildSceneSummary();
+        const snap = new DataSnapshot();
+        snap.title = this.getDisplayTitle() ?? 'Whiteboard';
+        snap.interpretation = scene.summary;
+        snap.custom = { elementCounts: scene.counts };
+        return snap;
+    }
+    // ────────────────────────────────────────────── export actions (live-board parity)
+    /** Download the board as one self-contained HTML document. */
+    OnDownloadHtml() {
+        const state = this.BoardState;
+        if (!state) {
+            return;
+        }
+        this.downloadBlob(this.buildExportHtml(state), 'text/html', `whiteboard-${WhiteboardArtifactViewerComponent_1.exportDateStamp()}.html`);
+    }
+    /** Download the board as a standalone SVG document. */
+    OnDownloadSvg() {
+        const state = this.BoardState;
+        if (!state) {
+            return;
+        }
+        this.downloadBlob(BuildWhiteboardExportSvg(state), 'image/svg+xml', `whiteboard-${WhiteboardArtifactViewerComponent_1.exportDateStamp()}.svg`);
+    }
+    /**
+     * Print the board: open a blank window, write the self-contained export document and
+     * invoke the print dialog (same precedent as the live board host's print path). When
+     * the popup is blocked this is a logged no-op — nothing breaks, the user can retry.
+     */
+    OnPrint() {
+        const state = this.BoardState;
+        if (!state) {
+            return;
+        }
+        const printWindow = window.open('about:blank', '_blank');
+        if (!printWindow) {
+            console.warn('Whiteboard print: popup was blocked — allow popups for this site and retry.');
+            return;
+        }
+        printWindow.document.write(this.buildExportHtml(state));
+        printWindow.document.close();
+        printWindow.focus();
+        // let the document lay out before invoking the dialog (artifact-viewer precedent)
+        setTimeout(() => printWindow.print(), 250);
+    }
+    buildExportHtml(state) {
+        return BuildWhiteboardExportHtml(state, {
+            Title: this.getDisplayTitle() ?? 'Whiteboard',
+            AgentName: 'Agent',
+            GeneratedAt: new Date().toLocaleString()
+        });
+    }
+    downloadBlob(content, mimeType, fileName) {
+        const url = URL.createObjectURL(new Blob([content], { type: mimeType }));
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = fileName;
+        anchor.click();
+        URL.revokeObjectURL(url);
+    }
+    static exportDateStamp() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    static ɵfac = /*@__PURE__*/ (() => { let ɵWhiteboardArtifactViewerComponent_BaseFactory; return function WhiteboardArtifactViewerComponent_Factory(__ngFactoryType__) { return (ɵWhiteboardArtifactViewerComponent_BaseFactory || (ɵWhiteboardArtifactViewerComponent_BaseFactory = i0.ɵɵgetInheritedFactory(WhiteboardArtifactViewerComponent)))(__ngFactoryType__ || WhiteboardArtifactViewerComponent); }; })();
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: WhiteboardArtifactViewerComponent, selectors: [["mj-whiteboard-artifact-viewer"]], features: [i0.ɵɵInheritDefinitionFeature], decls: 12, vars: 8, consts: [[1, "wb-artifact-toolbar"], ["type", "button", "title", "Download as HTML", 1, "wb-tool-btn", 3, "click", "disabled"], ["aria-hidden", "true", 1, "fa-solid", "fa-file-code"], ["type", "button", "title", "Download as SVG", 1, "wb-tool-btn", 3, "click", "disabled"], ["aria-hidden", "true", 1, "fa-solid", "fa-bezier-curve"], ["type", "button", "title", "Print board", 1, "wb-tool-btn", 3, "click", "disabled"], ["aria-hidden", "true", 1, "fa-solid", "fa-print"], [1, "wb-artifact-board", 3, "StateJson"]], template: function WhiteboardArtifactViewerComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div")(1, "div", 0)(2, "button", 1);
+            i0.ɵɵlistener("click", function WhiteboardArtifactViewerComponent_Template_button_click_2_listener() { return ctx.OnDownloadHtml(); });
+            i0.ɵɵelement(3, "i", 2);
+            i0.ɵɵtext(4, " HTML ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(5, "button", 3);
+            i0.ɵɵlistener("click", function WhiteboardArtifactViewerComponent_Template_button_click_5_listener() { return ctx.OnDownloadSvg(); });
+            i0.ɵɵelement(6, "i", 4);
+            i0.ɵɵtext(7, " SVG ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(8, "button", 5);
+            i0.ɵɵlistener("click", function WhiteboardArtifactViewerComponent_Template_button_click_8_listener() { return ctx.OnPrint(); });
+            i0.ɵɵelement(9, "i", 6);
+            i0.ɵɵtext(10, " Print ");
+            i0.ɵɵelementEnd()();
+            i0.ɵɵelement(11, "mj-whiteboard-snapshot", 7);
+            i0.ɵɵelementEnd();
+        } if (rf & 2) {
+            i0.ɵɵclassMap("wb-artifact-viewer " + (ctx.cssClass || ""));
+            i0.ɵɵstyleProp("height", ctx.height || null);
+            i0.ɵɵadvance(2);
+            i0.ɵɵproperty("disabled", !ctx.HasBoard);
+            i0.ɵɵadvance(3);
+            i0.ɵɵproperty("disabled", !ctx.HasBoard);
+            i0.ɵɵadvance(3);
+            i0.ɵɵproperty("disabled", !ctx.HasBoard);
+            i0.ɵɵadvance(3);
+            i0.ɵɵproperty("StateJson", ctx.ContentJson);
+        } }, dependencies: [WhiteboardSnapshotComponent], styles: ["[_nghost-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-viewer[_ngcontent-%COMP%] {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-toolbar[_ngcontent-%COMP%] {\n      display: flex;\n      justify-content: flex-end;\n      align-items: center;\n      gap: 8px;\n      padding: 8px;\n      flex-shrink: 0;\n      background: var(--mj-bg-surface);\n      border-bottom: 1px solid var(--mj-border-default);\n    }\n    .wb-tool-btn[_ngcontent-%COMP%] {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 5px 11px;\n      font-size: 12px;\n      cursor: pointer;\n      color: var(--mj-text-secondary);\n      background: var(--mj-bg-surface);\n      border: 1px solid var(--mj-border-default);\n      border-radius: var(--mj-radius-sm, 4px);\n    }\n    .wb-tool-btn[_ngcontent-%COMP%]:hover:not(:disabled) {\n      background: var(--mj-bg-surface-hover);\n      border-color: var(--mj-border-strong);\n      color: var(--mj-text-primary);\n    }\n    .wb-tool-btn[_ngcontent-%COMP%]:disabled {\n      color: var(--mj-text-disabled);\n      cursor: default;\n    }\n    .wb-artifact-board[_ngcontent-%COMP%] {\n      flex: 1;\n      min-height: 0;\n    }"] });
+};
+WhiteboardArtifactViewerComponent = WhiteboardArtifactViewerComponent_1 = __decorate([
+    RegisterClass(BaseArtifactViewerPluginComponent, 'WhiteboardArtifactViewerPlugin')
+], WhiteboardArtifactViewerComponent);
+export { WhiteboardArtifactViewerComponent };
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(WhiteboardArtifactViewerComponent, [{
+        type: Component,
+        args: [{ standalone: true, selector: 'mj-whiteboard-artifact-viewer', imports: [WhiteboardSnapshotComponent], template: `
+    <div [class]="'wb-artifact-viewer ' + (cssClass || '')" [style.height]="height || null">
+      <div class="wb-artifact-toolbar">
+        <button type="button" class="wb-tool-btn" title="Download as HTML" [disabled]="!HasBoard" (click)="OnDownloadHtml()">
+          <i class="fa-solid fa-file-code" aria-hidden="true"></i> HTML
+        </button>
+        <button type="button" class="wb-tool-btn" title="Download as SVG" [disabled]="!HasBoard" (click)="OnDownloadSvg()">
+          <i class="fa-solid fa-bezier-curve" aria-hidden="true"></i> SVG
+        </button>
+        <button type="button" class="wb-tool-btn" title="Print board" [disabled]="!HasBoard" (click)="OnPrint()">
+          <i class="fa-solid fa-print" aria-hidden="true"></i> Print
+        </button>
+      </div>
+      <mj-whiteboard-snapshot class="wb-artifact-board" [StateJson]="ContentJson" />
+    </div>
+  `, styles: ["\n    :host {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-viewer {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-toolbar {\n      display: flex;\n      justify-content: flex-end;\n      align-items: center;\n      gap: 8px;\n      padding: 8px;\n      flex-shrink: 0;\n      background: var(--mj-bg-surface);\n      border-bottom: 1px solid var(--mj-border-default);\n    }\n    .wb-tool-btn {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 5px 11px;\n      font-size: 12px;\n      cursor: pointer;\n      color: var(--mj-text-secondary);\n      background: var(--mj-bg-surface);\n      border: 1px solid var(--mj-border-default);\n      border-radius: var(--mj-radius-sm, 4px);\n    }\n    .wb-tool-btn:hover:not(:disabled) {\n      background: var(--mj-bg-surface-hover);\n      border-color: var(--mj-border-strong);\n      color: var(--mj-text-primary);\n    }\n    .wb-tool-btn:disabled {\n      color: var(--mj-text-disabled);\n      cursor: default;\n    }\n    .wb-artifact-board {\n      flex: 1;\n      min-height: 0;\n    }\n  "] }]
+    }], null, null); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(WhiteboardArtifactViewerComponent, { className: "WhiteboardArtifactViewerComponent", filePath: "src/lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component.ts", lineNumber: 93 }); })();
+/**
+ * Tree-shaking prevention: the plugin is resolved dynamically through the MJ ClassFactory
+ * (keyed by the artifact type's DriverClass), so this static call keeps the @RegisterClass
+ * side effect from being eliminated by the bundler.
+ */
+export function LoadWhiteboardArtifactViewer() {
+    // intentional no-op — the import side effect performs the registration
+}
+//# sourceMappingURL=whiteboard-artifact-viewer.component.js.map

package/dist/lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whiteboard-artifact-viewer.component.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/whiteboard/whiteboard-artifact-viewer.component.ts"],"names":[],"mappings":"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","sourcesContent":["import { Component } from '@angular/core';\nimport { DataSnapshot } from '@memberjunction/core';\nimport { RegisterClass } from '@memberjunction/global';\nimport { BaseArtifactViewerPluginComponent } from '@memberjunction/ng-artifacts';\nimport {\n  BuildWhiteboardExportHtml, BuildWhiteboardExportSvg, ParseBoardStateJson,\n  WhiteboardSnapshotComponent, WhiteboardState\n} from '@memberjunction/ng-whiteboard';\n\n/**\n * ARTIFACT VIEWER PLUGIN for saved whiteboards — renders the session-channel board\n * artifact (a {@link WhiteboardState.ToJSON} payload) as a read-only snapshot with the\n * same export affordances the live board offers (Download HTML / Download SVG / Print).\n *\n * Resolved dynamically by the artifact plugin host via the MJ ClassFactory (keyed by the\n * artifact type's DriverClass), which instantiates the class ONCE with a bare `new` to\n * discover the component type — so this class must stay constructible outside an Angular\n * injection context (no `inject()` field initializers, no constructor DI).\n */\n@Component({\n  standalone: true,\n  selector: 'mj-whiteboard-artifact-viewer',\n  imports: [WhiteboardSnapshotComponent],\n  template: `\n    <div [class]=\"'wb-artifact-viewer ' + (cssClass || '')\" [style.height]=\"height || null\">\n      <div class=\"wb-artifact-toolbar\">\n        <button type=\"button\" class=\"wb-tool-btn\" title=\"Download as HTML\" [disabled]=\"!HasBoard\" (click)=\"OnDownloadHtml()\">\n          <i class=\"fa-solid fa-file-code\" aria-hidden=\"true\"></i> HTML\n        </button>\n        <button type=\"button\" class=\"wb-tool-btn\" title=\"Download as SVG\" [disabled]=\"!HasBoard\" (click)=\"OnDownloadSvg()\">\n          <i class=\"fa-solid fa-bezier-curve\" aria-hidden=\"true\"></i> SVG\n        </button>\n        <button type=\"button\" class=\"wb-tool-btn\" title=\"Print board\" [disabled]=\"!HasBoard\" (click)=\"OnPrint()\">\n          <i class=\"fa-solid fa-print\" aria-hidden=\"true\"></i> Print\n        </button>\n      </div>\n      <mj-whiteboard-snapshot class=\"wb-artifact-board\" [StateJson]=\"ContentJson\" />\n    </div>\n  `,\n  styles: [`\n    :host {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-viewer {\n      display: flex;\n      flex-direction: column;\n      flex: 1;\n      height: 100%;\n      min-height: 0;\n    }\n    .wb-artifact-toolbar {\n      display: flex;\n      justify-content: flex-end;\n      align-items: center;\n      gap: 8px;\n      padding: 8px;\n      flex-shrink: 0;\n      background: var(--mj-bg-surface);\n      border-bottom: 1px solid var(--mj-border-default);\n    }\n    .wb-tool-btn {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 5px 11px;\n      font-size: 12px;\n      cursor: pointer;\n      color: var(--mj-text-secondary);\n      background: var(--mj-bg-surface);\n      border: 1px solid var(--mj-border-default);\n      border-radius: var(--mj-radius-sm, 4px);\n    }\n    .wb-tool-btn:hover:not(:disabled) {\n      background: var(--mj-bg-surface-hover);\n      border-color: var(--mj-border-strong);\n      color: var(--mj-text-primary);\n    }\n    .wb-tool-btn:disabled {\n      color: var(--mj-text-disabled);\n      cursor: default;\n    }\n    .wb-artifact-board {\n      flex: 1;\n      min-height: 0;\n    }\n  `]\n})\n@RegisterClass(BaseArtifactViewerPluginComponent, 'WhiteboardArtifactViewerPlugin')\nexport class WhiteboardArtifactViewerComponent extends BaseArtifactViewerPluginComponent {\n  /** Memoized parse — keyed by the raw content string so version switches re-parse. */\n  private parsedForJson: string | null = null;\n  private parsedState: WhiteboardState | null = null;\n\n  /** Raw board payload fed to the snapshot component (setter-driven re-parse there). */\n  public get ContentJson(): string {\n    return this.getRawContent() ?? '';\n  }\n\n  /** Rehydrated board engine for export/snapshot duty (null when content is malformed). */\n  public get BoardState(): WhiteboardState | null {\n    const json = this.getRawContent();\n    if (json !== this.parsedForJson) {\n      this.parsedForJson = json;\n      this.parsedState = ParseBoardStateJson(json);\n    }\n    return this.parsedState;\n  }\n\n  public get HasBoard(): boolean {\n    return this.BoardState !== null;\n  }\n\n  public override get hasDisplayContent(): boolean {\n    return this.HasBoard;\n  }\n\n  public override GetCurrentStateSnapshot(): DataSnapshot | null {\n    const state = this.BoardState;\n    if (!state) {\n      return null;\n    }\n    const scene = state.BuildSceneSummary();\n    const snap = new DataSnapshot();\n    snap.title = this.getDisplayTitle() ?? 'Whiteboard';\n    snap.interpretation = scene.summary;\n    snap.custom = { elementCounts: scene.counts };\n    return snap;\n  }\n\n  // ────────────────────────────────────────────── export actions (live-board parity)\n\n  /** Download the board as one self-contained HTML document. */\n  public OnDownloadHtml(): void {\n    const state = this.BoardState;\n    if (!state) {\n      return;\n    }\n    this.downloadBlob(this.buildExportHtml(state), 'text/html', `whiteboard-${WhiteboardArtifactViewerComponent.exportDateStamp()}.html`);\n  }\n\n  /** Download the board as a standalone SVG document. */\n  public OnDownloadSvg(): void {\n    const state = this.BoardState;\n    if (!state) {\n      return;\n    }\n    this.downloadBlob(BuildWhiteboardExportSvg(state), 'image/svg+xml', `whiteboard-${WhiteboardArtifactViewerComponent.exportDateStamp()}.svg`);\n  }\n\n  /**\n   * Print the board: open a blank window, write the self-contained export document and\n   * invoke the print dialog (same precedent as the live board host's print path). When\n   * the popup is blocked this is a logged no-op — nothing breaks, the user can retry.\n   */\n  public OnPrint(): void {\n    const state = this.BoardState;\n    if (!state) {\n      return;\n    }\n    const printWindow = window.open('about:blank', '_blank');\n    if (!printWindow) {\n      console.warn('Whiteboard print: popup was blocked — allow popups for this site and retry.');\n      return;\n    }\n    printWindow.document.write(this.buildExportHtml(state));\n    printWindow.document.close();\n    printWindow.focus();\n    // let the document lay out before invoking the dialog (artifact-viewer precedent)\n    setTimeout(() => printWindow.print(), 250);\n  }\n\n  private buildExportHtml(state: WhiteboardState): string {\n    return BuildWhiteboardExportHtml(state, {\n      Title: this.getDisplayTitle() ?? 'Whiteboard',\n      AgentName: 'Agent',\n      GeneratedAt: new Date().toLocaleString()\n    });\n  }\n\n  private downloadBlob(content: string, mimeType: string, fileName: string): void {\n    const url = URL.createObjectURL(new Blob([content], { type: mimeType }));\n    const anchor = document.createElement('a');\n    anchor.href = url;\n    anchor.download = fileName;\n    anchor.click();\n    URL.revokeObjectURL(url);\n  }\n\n  private static exportDateStamp(): string {\n    return new Date().toISOString().slice(0, 10);\n  }\n}\n\n/**\n * Tree-shaking prevention: the plugin is resolved dynamically through the MJ ClassFactory\n * (keyed by the artifact type's DriverClass), so this static call keeps the @RegisterClass\n * side effect from being eliminated by the bundler.\n */\nexport function LoadWhiteboardArtifactViewer(): void {\n  // intentional no-op — the import side effect performs the registration\n}\n"]}

package/dist/lib/components/realtime/whiteboard/whiteboard-channel.d.ts

@@ -0,0 +1,119 @@
+import type { Type } from '@angular/core';
+import { RealtimeToolDefinition } from '@memberjunction/ai';
+import { BaseRealtimeChannelClient, ChannelOnboardingDetails } from '../channels/base-realtime-channel-client';
+import { RealtimeWhiteboardHostComponent, WhiteboardState } from '@memberjunction/ng-whiteboard';
+/**
+ * Per-widget throttle window for AMBIENT interaction context notes: at most one note per
+ * widget per this many ms — within the window the LATEST summary wins (chatty widgets
+ * collapse to one trailing-edge note instead of flooding the model's context).
+ */
+export declare const WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS = 4000;
+/**
+ * The LIVE WHITEBOARD as a pluggable interactive channel — the canonical
+ * {@link BaseRealtimeChannelClient} implementation, resolved from the `MJ: AI Agent
+ * Channels` registry row whose `ClientPluginClass` is `'RealtimeWhiteboardChannel'`.
+ *
+ * One instance per session (created via ClassFactory at session start). It owns the
+ * board's {@link WhiteboardState} engine and contributes the channel's full contract:
+ *
+ *  - **Action**: the `Whiteboard_*` client-executed tool set
+ *    ({@link WHITEBOARD_TOOL_DEFINITIONS}); {@link ApplyAgentTool} prefers the BOUND host
+ *    component (board mutation + violet pop-in / toast / presence-cursor garnish) and
+ *    falls back to the pure {@link ApplyWhiteboardAgentTool} engine call when no surface
+ *    is bound (e.g. the surface panel is collapsed) — the channel keeps working, just
+ *    without the garnish.
+ *  - **Perception**: {@link BindSurface} subscribes the host's coalesced (750 ms)
+ *    `SceneDelta` stream and pipes each delta into the live model's context as a
+ *    `[whiteboard]` background note; the agent-undo toast click flows the same way.
+ *  - **Surface**: {@link RealtimeWhiteboardHostComponent}, created dynamically by the
+ *    overlay's channel tab; the host's Focus toggle rides `Context.SetFocusMode` so the
+ *    shell can collapse/restore the main call column.
+ *  - **State of record**: every board mutation (user edits AND agent tool calls) requests
+ *    a save of {@link WhiteboardState.ToJSON} under channel name `'Whiteboard'` — the
+ *    host debounces and flushes at teardown.
+ *
+ * A PRIOR session's persisted board is restored through {@link RestoreState} (invoked by
+ * the session host after Initialize, before any surface binding): the saved JSON is
+ * rehydrated IN PLACE into the same {@link WhiteboardState} instance, so the save
+ * subscription and any later surface binding keep pointing at one engine. Malformed or
+ * incompatible payloads are tolerated — the board simply starts fresh.
+ */
+export declare class RealtimeWhiteboardChannel extends BaseRealtimeChannelClient<RealtimeWhiteboardHostComponent> {
+    /** The board's state of record — created fresh with the plugin (one per session). */
+    readonly State: WhiteboardState;
+    /** The live bound surface, when the channel tab's pane is instantiated. */
+    private host;
+    /** Output subscriptions on the bound surface (SceneDelta / AgentUndo / FocusModeChange). */
+    private surfaceSubs;
+    /** Board-mutation subscription driving the debounced state-of-record save. */
+    private stateChangedSub;
+    /** Per-widget ambient-interaction note throttles (ItemID → window state). */
+    private interactionThrottles;
+    get ChannelName(): string;
+    get ToolNamePrefix(): string;
+    get TabTitle(): string;
+    get TabIcon(): string;
+    GetToolDefinitions(): RealtimeToolDefinition[];
+    GetSurfaceComponent(): Type<RealtimeWhiteboardHostComponent>;
+    /** First-run intro shown the first time the user opens the Whiteboard tab (once per user). */
+    GetOnboardingDetails(): ChannelOnboardingDetails;
+    /** Persist the board (host-debounced) on EVERY board mutation — user edits AND agent tools. */
+    protected OnInitialize(): void;
+    /**
+     * Wires the dynamically-created board host: inputs (shared state engine + agent name)
+     * are set BEFORE the component's first change detection, and the perception/garnish
+     * outputs are subscribed back into the host context — the overlay never sees any of it.
+     */
+    BindSurface(instance: RealtimeWhiteboardHostComponent): void;
+    UnbindSurface(): void;
+    /**
+     * Routes one ambient widget-interaction batch to the agent as a throttled background
+     * context note: outside an open window the note goes out immediately and opens a
+     * {@link WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS} window; within the window the LATEST
+     * event is stashed and a trailing-edge timer sends it when the window closes (one note
+     * per widget per window, latest summary wins).
+     */
+    private onWidgetInteraction;
+    /** The ambient-note framing: background etiquette rides in the note itself (like scene deltas). */
+    private sendInteractionNote;
+    /** Cancels all pending ambient-note timers and resets the per-widget throttle windows. */
+    private clearInteractionThrottles;
+    /**
+     * Persists the current board as a `MJ: Artifacts` snapshot via the host context
+     * (best-effort; the host logs failures). On success the agent is told via a context
+     * note so it can reference the saved artifact naturally.
+     */
+    private saveBoardAsArtifact;
+    /**
+     * Executes one `Whiteboard_*` tool call LOCALLY. Prefers the live bound host (board
+     * mutation + UI garnish); falls back to the pure engine function when no surface is
+     * bound so the channel keeps working with the pane collapsed.
+     */
+    ApplyAgentTool(toolName: string, argsJson: string): string;
+    /** The board's serialized state of record (persisted under {@link ChannelName}). */
+    SerializeState(): string | null;
+    /**
+     * Rehydrates a prior session's saved board into THIS session's state engine (in place —
+     * the {@link State} instance and its subscriptions are preserved). Returns `true` on
+     * success; malformed / incompatible JSON returns `false` and the board stays fresh
+     * (never throws — {@link WhiteboardState.LoadFromJSON} is tolerant by contract).
+     */
+    RestoreState(stateJson: string): boolean;
+    /**
+     * Exit focus mode THROUGH the bound host (its own Focus button state stays in sync; it
+     * re-emits `FocusModeChange(false)` → `Context.SetFocusMode(false)`). When no surface is
+     * bound the overlay's defensive flag clear covers it.
+     */
+    RequestFocusExit(): void;
+    Dispose(): void;
+    /** Unsubscribes surface outputs, cancels pending ambient notes and drops the host reference. */
+    private releaseSurface;
+}
+/**
+ * Tree-shaking prevention: the whiteboard channel is resolved dynamically through the
+ * ClassFactory (by the registry row's `ClientPluginClass` key), so this static call is
+ * what keeps its `@RegisterClass` side effect from being eliminated by the bundler.
+ * Called by `RealtimeSessionService` alongside the realtime-client driver Load calls.
+ */
+export declare function LoadRealtimeWhiteboardChannel(): void;
+//# sourceMappingURL=whiteboard-channel.d.ts.map

package/dist/lib/components/realtime/whiteboard/whiteboard-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whiteboard-channel.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/whiteboard/whiteboard-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAC/G,OAAO,EACqB,+BAA+B,EACjC,eAAe,EACxC,MAAM,+BAA+B,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,OAAO,CAAC;AAY5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,yBAA0B,SAAQ,yBAAyB,CAAC,+BAA+B,CAAC;IACvG,qFAAqF;IACrF,SAAgB,KAAK,kBAAyB;IAE9C,2EAA2E;IAC3E,OAAO,CAAC,IAAI,CAAgD;IAC5D,4FAA4F;IAC5F,OAAO,CAAC,WAAW,CAAsB;IACzC,8EAA8E;IAC9E,OAAO,CAAC,eAAe,CAA6B;IACpD,6EAA6E;IAC7E,OAAO,CAAC,oBAAoB,CAA+C;IAE3E,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEM,kBAAkB,IAAI,sBAAsB,EAAE;IAIrC,mBAAmB,IAAI,IAAI,CAAC,+BAA+B,CAAC;IAI5E,8FAA8F;IAC9E,oBAAoB,IAAI,wBAAwB;IAehE,+FAA+F;cAC5E,YAAY,IAAI,IAAI;IAMvC;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,+BAA+B,GAAG,IAAI;IAqDnD,aAAa,IAAI,IAAI;IAIrC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAuB3B,mGAAmG;IACnG,OAAO,CAAC,mBAAmB;IAO3B,0FAA0F;IAC1F,OAAO,CAAC,yBAAyB;IASjC;;;;OAIG;YACW,mBAAmB;IAajC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAOjE,oFAAoF;IACpE,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/C;;;;;OAKG;IACa,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxD;;;;OAIG;IACa,gBAAgB,IAAI,IAAI;IAMxB,OAAO,IAAI,IAAI;IAM/B,gGAAgG;IAChG,OAAO,CAAC,cAAc;CAQvB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/lib/components/realtime/whiteboard/whiteboard-channel.js

@@ -0,0 +1,274 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseRealtimeChannelClient } from '../channels/base-realtime-channel-client';
+import { ApplyWhiteboardAgentTool, RealtimeWhiteboardHostComponent, WHITEBOARD_TOOL_DEFINITIONS, WHITEBOARD_TOOL_PREFIX, WhiteboardState } from '@memberjunction/ng-whiteboard';
+/**
+ * Per-widget throttle window for AMBIENT interaction context notes: at most one note per
+ * widget per this many ms — within the window the LATEST summary wins (chatty widgets
+ * collapse to one trailing-edge note instead of flooding the model's context).
+ */
+export const WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS = 4000;
+/**
+ * The LIVE WHITEBOARD as a pluggable interactive channel — the canonical
+ * {@link BaseRealtimeChannelClient} implementation, resolved from the `MJ: AI Agent
+ * Channels` registry row whose `ClientPluginClass` is `'RealtimeWhiteboardChannel'`.
+ *
+ * One instance per session (created via ClassFactory at session start). It owns the
+ * board's {@link WhiteboardState} engine and contributes the channel's full contract:
+ *
+ *  - **Action**: the `Whiteboard_*` client-executed tool set
+ *    ({@link WHITEBOARD_TOOL_DEFINITIONS}); {@link ApplyAgentTool} prefers the BOUND host
+ *    component (board mutation + violet pop-in / toast / presence-cursor garnish) and
+ *    falls back to the pure {@link ApplyWhiteboardAgentTool} engine call when no surface
+ *    is bound (e.g. the surface panel is collapsed) — the channel keeps working, just
+ *    without the garnish.
+ *  - **Perception**: {@link BindSurface} subscribes the host's coalesced (750 ms)
+ *    `SceneDelta` stream and pipes each delta into the live model's context as a
+ *    `[whiteboard]` background note; the agent-undo toast click flows the same way.
+ *  - **Surface**: {@link RealtimeWhiteboardHostComponent}, created dynamically by the
+ *    overlay's channel tab; the host's Focus toggle rides `Context.SetFocusMode` so the
+ *    shell can collapse/restore the main call column.
+ *  - **State of record**: every board mutation (user edits AND agent tool calls) requests
+ *    a save of {@link WhiteboardState.ToJSON} under channel name `'Whiteboard'` — the
+ *    host debounces and flushes at teardown.
+ *
+ * A PRIOR session's persisted board is restored through {@link RestoreState} (invoked by
+ * the session host after Initialize, before any surface binding): the saved JSON is
+ * rehydrated IN PLACE into the same {@link WhiteboardState} instance, so the save
+ * subscription and any later surface binding keep pointing at one engine. Malformed or
+ * incompatible payloads are tolerated — the board simply starts fresh.
+ */
+let RealtimeWhiteboardChannel = class RealtimeWhiteboardChannel extends BaseRealtimeChannelClient {
+    /** The board's state of record — created fresh with the plugin (one per session). */
+    State = new WhiteboardState();
+    /** The live bound surface, when the channel tab's pane is instantiated. */
+    host = null;
+    /** Output subscriptions on the bound surface (SceneDelta / AgentUndo / FocusModeChange). */
+    surfaceSubs = [];
+    /** Board-mutation subscription driving the debounced state-of-record save. */
+    stateChangedSub = null;
+    /** Per-widget ambient-interaction note throttles (ItemID → window state). */
+    interactionThrottles = new Map();
+    get ChannelName() {
+        return 'Whiteboard';
+    }
+    get ToolNamePrefix() {
+        return WHITEBOARD_TOOL_PREFIX;
+    }
+    get TabTitle() {
+        return 'Whiteboard';
+    }
+    get TabIcon() {
+        return 'fa-solid fa-chalkboard';
+    }
+    GetToolDefinitions() {
+        return WHITEBOARD_TOOL_DEFINITIONS;
+    }
+    GetSurfaceComponent() {
+        return RealtimeWhiteboardHostComponent;
+    }
+    /** First-run intro shown the first time the user opens the Whiteboard tab (once per user). */
+    GetOnboardingDetails() {
+        return {
+            Heading: 'Whiteboard',
+            Description: 'A shared canvas the agent can sketch, write and annotate on live during the call — ' +
+                'whatever it draws appears here instantly, and anything you add is something it can see too.',
+            Tips: [
+                'Watch the board fill in as you talk — the agent updates it in real time.',
+                'Add your own notes or shapes; the agent perceives your edits and can build on them.',
+                'Use Focus to give the board the whole screen, and save it to artifacts to keep it.'
+            ],
+            IconClass: 'fa-solid fa-chalkboard'
+        };
+    }
+    /** Persist the board (host-debounced) on EVERY board mutation — user edits AND agent tools. */
+    OnInitialize() {
+        this.stateChangedSub = this.State.Changed$.subscribe(() => {
+            this.Context?.RequestSave(this.State.ToJSON());
+        });
+    }
+    /**
+     * Wires the dynamically-created board host: inputs (shared state engine + agent name)
+     * are set BEFORE the component's first change detection, and the perception/garnish
+     * outputs are subscribed back into the host context — the overlay never sees any of it.
+     */
+    BindSurface(instance) {
+        this.releaseSurface();
+        this.host = instance;
+        instance.State = this.State;
+        instance.AgentName = this.Context?.AgentName ?? 'Agent';
+        this.surfaceSubs.push(
+        // The board's coalesced scene delta — the perception feed the agent "sees".
+        instance.SceneDelta.subscribe((deltaJson) => {
+            // Background PERCEPTION, not conversation: the model sees every user edit without
+            // being told, but must not narrate minor changes — only react when something is
+            // significant (or when asked). The etiquette rides in the note itself so any
+            // realtime model gets it regardless of system-prompt sync state.
+            this.Context?.SendContextNote('[whiteboard] board update (background context — do NOT comment on minor edits; ' +
+                'only mention it if the change is significant to the discussion): ' + deltaJson);
+        }), 
+        // The user clicked Undo on the agent-action toast (the undo already applied locally).
+        instance.AgentUndo.subscribe(() => {
+            this.Context?.SendContextNote('[whiteboard] user undid your last change');
+        }), 
+        // A sandboxed HTML widget submitted user input (MJWhiteboard.submit) — already
+        // validated, size-capped and not canceled (the host's cancelable WidgetSubmitting
+        // event ran first). Surface it to the agent so it can react to quiz answers /
+        // micro-form input it asked for.
+        instance.WidgetSubmitted.subscribe((submit) => {
+            // Durable awareness first (the note persists in the model's context)…
+            this.Context?.SendContextNote(`[whiteboard] the user submitted input in widget "${submit.Title || submit.ItemID}": ${submit.DataJson}`);
+            // …then make the model REACT — a submission is explicit user input the user is
+            // waiting on; without this trigger, SendContextNote alone produces dead silence
+            // ("I clicked Submit and nothing happened").
+            this.Context?.RequestSpokenResponse?.(`The user just submitted input in the whiteboard widget "${submit.Title || submit.ItemID}": ${submit.DataJson}. ` +
+                `React to it now in your own voice — acknowledge their choice and continue naturally.`);
+        }), 
+        // AMBIENT widget telemetry (the injected recorder, NOT widget-authored script):
+        // clicks / changes / typing summarized by the board. Pure background perception —
+        // throttled per widget so chatty widgets don't flood the model's context, and framed
+        // with do-not-respond etiquette (explicit MJWhiteboard.submit input arrives above).
+        instance.WidgetInteraction.subscribe((interaction) => {
+            this.onWidgetInteraction(interaction);
+        }), 
+        // The board's Focus toggle — ask the shell to collapse/restore the main call column.
+        instance.FocusModeChange.subscribe((focused) => {
+            this.Context?.SetFocusMode(focused);
+        }), 
+        // "Save to artifacts": snapshot the board as a first-class versioned artifact.
+        instance.SaveToArtifactsRequested.subscribe(() => {
+            void this.saveBoardAsArtifact();
+        }));
+    }
+    UnbindSurface() {
+        this.releaseSurface();
+    }
+    /**
+     * Routes one ambient widget-interaction batch to the agent as a throttled background
+     * context note: outside an open window the note goes out immediately and opens a
+     * {@link WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS} window; within the window the LATEST
+     * event is stashed and a trailing-edge timer sends it when the window closes (one note
+     * per widget per window, latest summary wins).
+     */
+    onWidgetInteraction(interaction) {
+        const now = Date.now();
+        const entry = this.interactionThrottles.get(interaction.ItemID);
+        if (!entry || (entry.Timer === null && now - entry.LastSentAt >= WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS)) {
+            this.sendInteractionNote(interaction);
+            this.interactionThrottles.set(interaction.ItemID, { LastSentAt: now, Timer: null, Pending: null });
+            return;
+        }
+        entry.Pending = interaction; // latest wins within the window
+        if (entry.Timer === null) {
+            const wait = Math.max(0, entry.LastSentAt + WHITEBOARD_INTERACTION_NOTE_THROTTLE_MS - now);
+            entry.Timer = setTimeout(() => {
+                entry.Timer = null;
+                const pending = entry.Pending;
+                entry.Pending = null;
+                if (pending) {
+                    entry.LastSentAt = Date.now();
+                    this.sendInteractionNote(pending);
+                }
+            }, wait);
+        }
+    }
+    /** The ambient-note framing: background etiquette rides in the note itself (like scene deltas). */
+    sendInteractionNote(interaction) {
+        this.Context?.SendContextNote(`[whiteboard] ambient activity in widget "${interaction.Title || interaction.ItemID}" ` +
+            '(background — do NOT respond unless it is significant or you are asked; ' +
+            `explicit submissions arrive separately): ${interaction.Summary}`);
+    }
+    /** Cancels all pending ambient-note timers and resets the per-widget throttle windows. */
+    clearInteractionThrottles() {
+        for (const entry of this.interactionThrottles.values()) {
+            if (entry.Timer !== null) {
+                clearTimeout(entry.Timer);
+            }
+        }
+        this.interactionThrottles.clear();
+    }
+    /**
+     * Persists the current board as a `MJ: Artifacts` snapshot via the host context
+     * (best-effort; the host logs failures). On success the agent is told via a context
+     * note so it can reference the saved artifact naturally.
+     */
+    async saveBoardAsArtifact() {
+        const ctx = this.Context;
+        if (!ctx) {
+            return;
+        }
+        const now = new Date();
+        const name = `Whiteboard — ${now.toLocaleDateString()} ${now.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}`;
+        const artifactId = await ctx.SaveAsArtifact(name, this.State.ToJSON());
+        if (artifactId) {
+            ctx.SendContextNote(`[whiteboard] the user saved the current board as the artifact "${name}"`);
+        }
+    }
+    /**
+     * Executes one `Whiteboard_*` tool call LOCALLY. Prefers the live bound host (board
+     * mutation + UI garnish); falls back to the pure engine function when no surface is
+     * bound so the channel keeps working with the pane collapsed.
+     */
+    ApplyAgentTool(toolName, argsJson) {
+        if (this.host) {
+            return this.host.ApplyAgentTool(toolName, argsJson);
+        }
+        return ApplyWhiteboardAgentTool(this.State, toolName, argsJson);
+    }
+    /** The board's serialized state of record (persisted under {@link ChannelName}). */
+    SerializeState() {
+        return this.State.ToJSON();
+    }
+    /**
+     * Rehydrates a prior session's saved board into THIS session's state engine (in place —
+     * the {@link State} instance and its subscriptions are preserved). Returns `true` on
+     * success; malformed / incompatible JSON returns `false` and the board stays fresh
+     * (never throws — {@link WhiteboardState.LoadFromJSON} is tolerant by contract).
+     */
+    RestoreState(stateJson) {
+        return this.State.LoadFromJSON(stateJson);
+    }
+    /**
+     * Exit focus mode THROUGH the bound host (its own Focus button state stays in sync; it
+     * re-emits `FocusModeChange(false)` → `Context.SetFocusMode(false)`). When no surface is
+     * bound the overlay's defensive flag clear covers it.
+     */
+    RequestFocusExit() {
+        if (this.host?.FocusMode) {
+            this.host.ToggleFocus();
+        }
+    }
+    Dispose() {
+        this.stateChangedSub?.unsubscribe();
+        this.stateChangedSub = null;
+        super.Dispose(); // releases the surface binding + context
+    }
+    /** Unsubscribes surface outputs, cancels pending ambient notes and drops the host reference. */
+    releaseSurface() {
+        for (const sub of this.surfaceSubs) {
+            sub.unsubscribe();
+        }
+        this.surfaceSubs = [];
+        this.clearInteractionThrottles();
+        this.host = null;
+    }
+};
+RealtimeWhiteboardChannel = __decorate([
+    RegisterClass(BaseRealtimeChannelClient, 'RealtimeWhiteboardChannel')
+], RealtimeWhiteboardChannel);
+export { RealtimeWhiteboardChannel };
+/**
+ * Tree-shaking prevention: the whiteboard channel is resolved dynamically through the
+ * ClassFactory (by the registry row's `ClientPluginClass` key), so this static call is
+ * what keeps its `@RegisterClass` side effect from being eliminated by the bundler.
+ * Called by `RealtimeSessionService` alongside the realtime-client driver Load calls.
+ */
+export function LoadRealtimeWhiteboardChannel() {
+    // intentional no-op — the import side effect performs the registration
+}
+//# sourceMappingURL=whiteboard-channel.js.map