@memberjunction/ng-conversations 5.36.0 → 5.38.0

package/README.md

@@ -113,9 +113,9 @@ A floating chat panel (bottom-right corner) that wraps the chat area for persist
 The overlay is generic — it raises events for navigation and tool execution. The consuming application (e.g., MJExplorer) handles those events with app-specific logic like `NavigationService.OpenEntityRecord()`.
 
 **Related packages:**
-- [`@memberjunction/ai-agent-client`](../../AI/AgentsClient/README.md) — Core agent SDK (framework-agnostic, GraphQL transport, tool registry)
+- [`@memberjunction/ai-agent-client`](../../../AI/AgentsClient/README.md) — Core agent SDK (framework-agnostic, GraphQL transport, tool registry)
 - [`@memberjunction/ng-agent-client`](../agent-client/README.md) — Angular wrapper for the agent SDK
-- [`@memberjunction/core-entities`](../../../MJCoreEntities/README.md) — ConversationEngine for centralized conversation data
+- [`@memberjunction/core-entities`](../../../MJCoreEntities/readme.md) — ConversationEngine for centralized conversation data
 
 ### Message Components
 

package/dist/lib/components/conversation/conversation-agent-picker.component.d.ts

@@ -0,0 +1,47 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import type { UserInfo } from '@memberjunction/core';
+import type { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+import type { MJConversationEntity } from '@memberjunction/core-entities';
+import * as i0 from "@angular/core";
+/**
+ * Header widget that lets a user pin a default AI agent on the active
+ * conversation. The pinned agent (saved to
+ * `MJConversationEntity.DefaultAgentID`) takes precedence over the
+ * embedder-supplied default in `MessageInputComponent.routeMessage()` —
+ * non-mention messages route to it instead of Sage.
+ *
+ * Eligible agents are top-level, Active, non-Sub-Agent rows from
+ * `AIEngineBase.Instance.Agents`. The widget renders as a compact button
+ * showing the current pin (or "Auto" when nothing is pinned). Clicking
+ * opens an inline list with a "Clear" option to remove the pin.
+ *
+ * The host controls visibility via `<mj-conversation-chat-area>`'s
+ * `[showAgentPicker]` input (default true). Surfaces that don't want this
+ * UX (e.g. agent-less embed) set it to false.
+ */
+export declare class ConversationAgentPickerComponent implements OnInit {
+    /** The conversation whose `DefaultAgentID` this widget edits. */
+    Conversation: MJConversationEntity | null;
+    /** Required for the Save() audit context. */
+    CurrentUser: UserInfo | null;
+    /** Disable the picker (e.g. read-only conversation). */
+    Disabled: boolean;
+    /** Emitted after a successful save with the new (or null) agent ID. */
+    AgentChanged: EventEmitter<string | null>;
+    IsOpen: boolean;
+    EligibleAgents: MJAIAgentEntityExtended[];
+    private readonly cdr;
+    private readonly notifications;
+    ngOnInit(): Promise<void>;
+    get CurrentAgentLabel(): string;
+    get ButtonTitle(): string;
+    IconClassFor(agent: MJAIAgentEntityExtended): string;
+    IsSelected(agent: MJAIAgentEntityExtended): boolean;
+    Toggle(event: MouseEvent): void;
+    PickAgent(agent: MJAIAgentEntityExtended | null): Promise<void>;
+    /** Close the menu when the user clicks outside the picker. */
+    OnDocumentClick(_event: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConversationAgentPickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConversationAgentPickerComponent, "mj-conversation-agent-picker", never, { "Conversation": { "alias": "Conversation"; "required": false; }; "CurrentUser": { "alias": "CurrentUser"; "required": false; }; "Disabled": { "alias": "Disabled"; "required": false; }; }, { "AgentChanged": "AgentChanged"; }, never, never, false, never>;
+}
+//# sourceMappingURL=conversation-agent-picker.component.d.ts.map

package/dist/lib/components/conversation/conversation-agent-picker.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-agent-picker.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-agent-picker.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,YAAY,EAGZ,MAAM,EAGT,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;;AAI1E;;;;;;;;;;;;;;;GAeG;AACH,qBAyFa,gCAAiC,YAAW,MAAM;IAC3D,iEAAiE;IACxD,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IAE1D,6CAA6C;IACpC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAE7C,wDAAwD;IAC/C,QAAQ,EAAE,OAAO,CAAS;IAEnC,uEAAuE;IAC7D,YAAY,8BAAqC;IAEpD,MAAM,UAAS;IACf,cAAc,EAAE,uBAAuB,EAAE,CAAM;IAEtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAElD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtC,IAAW,iBAAiB,IAAI,MAAM,CAUrC;IAED,IAAW,WAAW,IAAI,MAAM,CAI/B;IAEM,YAAY,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM;IAIpD,UAAU,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAKnD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOzB,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5E,8DAA8D;IAEvD,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;yCAvGvC,gCAAgC;2CAAhC,gCAAgC;CA6G5C"}

package/dist/lib/components/conversation/conversation-agent-picker.component.js

@@ -0,0 +1,253 @@
+import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, HostListener, Input, Output, inject, } from '@angular/core';
+import { LogError } from '@memberjunction/core';
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { MJNotificationService } from '@memberjunction/ng-notifications';
+import { UUIDsEqual } from '@memberjunction/global';
+import * as i0 from "@angular/core";
+const _forTrack0 = ($index, $item) => $item.ID;
+function ConversationAgentPickerComponent_Conditional_6_Conditional_7_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "div", 10);
+    i0.ɵɵtext(1, "No agents available");
+    i0.ɵɵelementEnd();
+} }
+function ConversationAgentPickerComponent_Conditional_6_Conditional_8_For_1_Template(rf, ctx) { if (rf & 1) {
+    const _r3 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "button", 12);
+    i0.ɵɵlistener("click", function ConversationAgentPickerComponent_Conditional_6_Conditional_8_For_1_Template_button_click_0_listener() { const agent_r4 = i0.ɵɵrestoreView(_r3).$implicit; const ctx_r1 = i0.ɵɵnextContext(3); return i0.ɵɵresetView(ctx_r1.PickAgent(agent_r4)); });
+    i0.ɵɵelement(1, "i");
+    i0.ɵɵelementStart(2, "span");
+    i0.ɵɵtext(3);
+    i0.ɵɵelementEnd()();
+} if (rf & 2) {
+    const agent_r4 = ctx.$implicit;
+    const ctx_r1 = i0.ɵɵnextContext(3);
+    i0.ɵɵclassProp("mj-cv-agent-picker__item--selected", ctx_r1.IsSelected(agent_r4));
+    i0.ɵɵproperty("title", agent_r4.Description || agent_r4.Name);
+    i0.ɵɵadvance();
+    i0.ɵɵclassMap(ctx_r1.IconClassFor(agent_r4));
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(agent_r4.Name);
+} }
+function ConversationAgentPickerComponent_Conditional_6_Conditional_8_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵrepeaterCreate(0, ConversationAgentPickerComponent_Conditional_6_Conditional_8_For_1_Template, 4, 6, "button", 11, _forTrack0);
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext(2);
+    i0.ɵɵrepeater(ctx_r1.EligibleAgents);
+} }
+function ConversationAgentPickerComponent_Conditional_6_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "div", 6);
+    i0.ɵɵlistener("click", function ConversationAgentPickerComponent_Conditional_6_Template_div_click_0_listener($event) { i0.ɵɵrestoreView(_r1); return i0.ɵɵresetView($event.stopPropagation()); });
+    i0.ɵɵelementStart(1, "div", 7);
+    i0.ɵɵtext(2, "Default agent for this conversation");
+    i0.ɵɵelementEnd();
+    i0.ɵɵelementStart(3, "button", 8);
+    i0.ɵɵlistener("click", function ConversationAgentPickerComponent_Conditional_6_Template_button_click_3_listener() { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.PickAgent(null)); });
+    i0.ɵɵelement(4, "i", 9);
+    i0.ɵɵelementStart(5, "span");
+    i0.ɵɵtext(6, "Auto (use default)");
+    i0.ɵɵelementEnd()();
+    i0.ɵɵconditionalCreate(7, ConversationAgentPickerComponent_Conditional_6_Conditional_7_Template, 2, 0, "div", 10)(8, ConversationAgentPickerComponent_Conditional_6_Conditional_8_Template, 2, 0);
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵadvance(3);
+    i0.ɵɵclassProp("mj-cv-agent-picker__item--selected", !(ctx_r1.Conversation == null ? null : ctx_r1.Conversation.DefaultAgentID));
+    i0.ɵɵadvance(4);
+    i0.ɵɵconditional(ctx_r1.EligibleAgents.length === 0 ? 7 : 8);
+} }
+/**
+ * Header widget that lets a user pin a default AI agent on the active
+ * conversation. The pinned agent (saved to
+ * `MJConversationEntity.DefaultAgentID`) takes precedence over the
+ * embedder-supplied default in `MessageInputComponent.routeMessage()` —
+ * non-mention messages route to it instead of Sage.
+ *
+ * Eligible agents are top-level, Active, non-Sub-Agent rows from
+ * `AIEngineBase.Instance.Agents`. The widget renders as a compact button
+ * showing the current pin (or "Auto" when nothing is pinned). Clicking
+ * opens an inline list with a "Clear" option to remove the pin.
+ *
+ * The host controls visibility via `<mj-conversation-chat-area>`'s
+ * `[showAgentPicker]` input (default true). Surfaces that don't want this
+ * UX (e.g. agent-less embed) set it to false.
+ */
+export class ConversationAgentPickerComponent {
+    /** The conversation whose `DefaultAgentID` this widget edits. */
+    Conversation = null;
+    /** Required for the Save() audit context. */
+    CurrentUser = null;
+    /** Disable the picker (e.g. read-only conversation). */
+    Disabled = false;
+    /** Emitted after a successful save with the new (or null) agent ID. */
+    AgentChanged = new EventEmitter();
+    IsOpen = false;
+    EligibleAgents = [];
+    cdr = inject(ChangeDetectorRef);
+    notifications = inject(MJNotificationService);
+    async ngOnInit() {
+        try {
+            // AIEngineBase is the live, cached agent catalog. Ensure it's
+            // loaded — most app shells warm it up at boot, but the picker
+            // could mount before that completes.
+            await AIEngineBase.Instance.Config(false);
+            this.EligibleAgents = (AIEngineBase.Instance.Agents ?? [])
+                .filter(a => !a.ParentID &&
+                a.Status === 'Active' &&
+                a.InvocationMode !== 'Sub-Agent')
+                .sort((a, b) => (a.Name ?? '').localeCompare(b.Name ?? ''));
+            this.cdr.markForCheck();
+        }
+        catch (err) {
+            LogError(`ConversationAgentPicker.ngOnInit: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    get CurrentAgentLabel() {
+        const id = this.Conversation?.DefaultAgentID;
+        if (!id)
+            return 'Auto';
+        const match = this.EligibleAgents.find(a => UUIDsEqual(a.ID, id));
+        // If the pinned agent is no longer eligible (deactivated, demoted to
+        // sub-agent), still surface its name from the cache so the user can
+        // see what was pinned even though they can't re-pin it.
+        const fromCache = match
+            ?? (AIEngineBase.Instance.Agents ?? []).find(a => UUIDsEqual(a.ID, id));
+        return fromCache?.Name ?? 'Pinned agent';
+    }
+    get ButtonTitle() {
+        return this.Conversation?.DefaultAgentID
+            ? `This conversation routes to ${this.CurrentAgentLabel}. Click to change.`
+            : 'No agent pinned — messages route via the standard rules. Click to pin an agent.';
+    }
+    IconClassFor(agent) {
+        return agent.IconClass?.trim() || 'fa-solid fa-robot';
+    }
+    IsSelected(agent) {
+        return !!this.Conversation?.DefaultAgentID
+            && UUIDsEqual(agent.ID, this.Conversation.DefaultAgentID);
+    }
+    Toggle(event) {
+        event.stopPropagation();
+        if (this.Disabled || !this.Conversation)
+            return;
+        this.IsOpen = !this.IsOpen;
+        this.cdr.markForCheck();
+    }
+    async PickAgent(agent) {
+        this.IsOpen = false;
+        const conv = this.Conversation;
+        if (!conv)
+            return;
+        const newId = agent?.ID ?? null;
+        if (conv.DefaultAgentID === newId) {
+            this.cdr.markForCheck();
+            return;
+        }
+        const prev = conv.DefaultAgentID;
+        conv.DefaultAgentID = newId;
+        try {
+            const saved = await conv.Save();
+            if (!saved) {
+                conv.DefaultAgentID = prev;
+                this.notifications.CreateSimpleNotification(conv.LatestResult?.CompleteMessage ?? 'Failed to update conversation default agent.', 'error', 4500);
+                return;
+            }
+            this.AgentChanged.emit(newId);
+        }
+        catch (err) {
+            conv.DefaultAgentID = prev;
+            LogError(`ConversationAgentPicker.PickAgent: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            this.cdr.markForCheck();
+        }
+    }
+    /** Close the menu when the user clicks outside the picker. */
+    OnDocumentClick(_event) {
+        if (this.IsOpen) {
+            this.IsOpen = false;
+            this.cdr.markForCheck();
+        }
+    }
+    static ɵfac = function ConversationAgentPickerComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || ConversationAgentPickerComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: ConversationAgentPickerComponent, selectors: [["mj-conversation-agent-picker"]], hostBindings: function ConversationAgentPickerComponent_HostBindings(rf, ctx) { if (rf & 1) {
+            i0.ɵɵlistener("click", function ConversationAgentPickerComponent_click_HostBindingHandler($event) { return ctx.OnDocumentClick($event); }, i0.ɵɵresolveDocument);
+        } }, inputs: { Conversation: "Conversation", CurrentUser: "CurrentUser", Disabled: "Disabled" }, outputs: { AgentChanged: "AgentChanged" }, standalone: false, decls: 7, vars: 6, consts: [[1, "mj-cv-agent-picker"], ["type", "button", 1, "mj-cv-agent-picker__trigger", 3, "click", "title", "disabled"], [1, "fa-solid", "fa-robot"], [1, "mj-cv-agent-picker__label"], [1, "fa-solid", "fa-caret-down", "mj-cv-agent-picker__caret"], [1, "mj-cv-agent-picker__menu"], [1, "mj-cv-agent-picker__menu", 3, "click"], [1, "mj-cv-agent-picker__menu-header"], ["type", "button", 1, "mj-cv-agent-picker__item", 3, "click"], [1, "fa-solid", "fa-wand-magic-sparkles"], [1, "mj-cv-agent-picker__empty"], ["type", "button", 1, "mj-cv-agent-picker__item", 3, "mj-cv-agent-picker__item--selected", "title"], ["type", "button", 1, "mj-cv-agent-picker__item", 3, "click", "title"]], template: function ConversationAgentPickerComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div", 0)(1, "button", 1);
+            i0.ɵɵlistener("click", function ConversationAgentPickerComponent_Template_button_click_1_listener($event) { return ctx.Toggle($event); });
+            i0.ɵɵelement(2, "i", 2);
+            i0.ɵɵelementStart(3, "span", 3);
+            i0.ɵɵtext(4);
+            i0.ɵɵelementEnd();
+            i0.ɵɵelement(5, "i", 4);
+            i0.ɵɵelementEnd();
+            i0.ɵɵconditionalCreate(6, ConversationAgentPickerComponent_Conditional_6_Template, 9, 3, "div", 5);
+            i0.ɵɵelementEnd();
+        } if (rf & 2) {
+            i0.ɵɵclassProp("mj-cv-agent-picker--open", ctx.IsOpen);
+            i0.ɵɵadvance();
+            i0.ɵɵproperty("title", ctx.ButtonTitle)("disabled", ctx.Disabled || !ctx.Conversation);
+            i0.ɵɵadvance(3);
+            i0.ɵɵtextInterpolate(ctx.CurrentAgentLabel);
+            i0.ɵɵadvance(2);
+            i0.ɵɵconditional(ctx.IsOpen ? 6 : -1);
+        } }, styles: ["\n\n\n\n        .mj-cv-agent-picker[_ngcontent-%COMP%] { position: relative; display: inline-flex; align-items: center; }\n        .mj-cv-agent-picker__trigger[_ngcontent-%COMP%] {\n            display: inline-flex; align-items: center; gap: 6px;\n            padding: 6px 12px; min-height: 32px; box-sizing: border-box;\n            background: var(--mj-bg-surface-card); border: 1px solid var(--mj-border-default);\n            border-radius: 4px; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 0.8125rem; line-height: 1.5;\n            transition: background 120ms, border-color 120ms;\n        }\n        .mj-cv-agent-picker__trigger[_ngcontent-%COMP%]:hover:not(:disabled) {\n            background: var(--mj-bg-surface-hover); border-color: var(--mj-border-strong);\n        }\n        .mj-cv-agent-picker__trigger[_ngcontent-%COMP%]:disabled { opacity: 0.5; cursor: not-allowed; }\n        .mj-cv-agent-picker--open[_ngcontent-%COMP%]   .mj-cv-agent-picker__trigger[_ngcontent-%COMP%] { border-color: var(--mj-border-focus); }\n        .mj-cv-agent-picker__label[_ngcontent-%COMP%] { max-width: 160px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n        .mj-cv-agent-picker__caret[_ngcontent-%COMP%] { font-size: 10px; opacity: 0.7; }\n        .mj-cv-agent-picker__menu[_ngcontent-%COMP%] {\n            position: absolute; top: calc(100% + 4px); right: 0; z-index: 50;\n            min-width: 220px; max-height: 320px; overflow-y: auto;\n            background: var(--mj-bg-surface-elevated); border: 1px solid var(--mj-border-default);\n            border-radius: 6px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);\n            padding: 4px 0;\n        }\n        .mj-cv-agent-picker__menu-header[_ngcontent-%COMP%] {\n            padding: 6px 12px 4px; font-size: 11px; text-transform: uppercase;\n            letter-spacing: 0.04em; color: var(--mj-text-muted);\n        }\n        .mj-cv-agent-picker__item[_ngcontent-%COMP%] {\n            display: flex; align-items: center; gap: 8px; width: 100%;\n            padding: 6px 12px; background: transparent; border: none; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 13px; text-align: left;\n        }\n        .mj-cv-agent-picker__item[_ngcontent-%COMP%]   i[_ngcontent-%COMP%] { width: 14px; text-align: center; color: var(--mj-text-secondary); }\n        .mj-cv-agent-picker__item[_ngcontent-%COMP%]:hover { background: var(--mj-bg-surface-hover); }\n        .mj-cv-agent-picker__item--selected[_ngcontent-%COMP%] { background: color-mix(in srgb, var(--mj-brand-primary) 10%, transparent); }\n        .mj-cv-agent-picker__item--selected[_ngcontent-%COMP%]   i[_ngcontent-%COMP%] { color: var(--mj-brand-primary); }\n        .mj-cv-agent-picker__empty[_ngcontent-%COMP%] { padding: 8px 12px; font-size: 12px; color: var(--mj-text-muted); }"], changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(ConversationAgentPickerComponent, [{
+        type: Component,
+        args: [{ standalone: false, selector: 'mj-conversation-agent-picker', changeDetection: ChangeDetectionStrategy.OnPush, template: `
+        <div class="mj-cv-agent-picker" [class.mj-cv-agent-picker--open]="IsOpen">
+            <button
+                type="button"
+                class="mj-cv-agent-picker__trigger"
+                [title]="ButtonTitle"
+                [disabled]="Disabled || !Conversation"
+                (click)="Toggle($event)">
+                <i class="fa-solid fa-robot"></i>
+                <span class="mj-cv-agent-picker__label">{{ CurrentAgentLabel }}</span>
+                <i class="fa-solid fa-caret-down mj-cv-agent-picker__caret"></i>
+            </button>
+            @if (IsOpen) {
+                <div class="mj-cv-agent-picker__menu" (click)="$event.stopPropagation()">
+                    <div class="mj-cv-agent-picker__menu-header">Default agent for this conversation</div>
+                    <button
+                        type="button"
+                        class="mj-cv-agent-picker__item"
+                        [class.mj-cv-agent-picker__item--selected]="!Conversation?.DefaultAgentID"
+                        (click)="PickAgent(null)">
+                        <i class="fa-solid fa-wand-magic-sparkles"></i>
+                        <span>Auto (use default)</span>
+                    </button>
+                    @if (EligibleAgents.length === 0) {
+                        <div class="mj-cv-agent-picker__empty">No agents available</div>
+                    } @else {
+                        @for (agent of EligibleAgents; track agent.ID) {
+                            <button
+                                type="button"
+                                class="mj-cv-agent-picker__item"
+                                [class.mj-cv-agent-picker__item--selected]="IsSelected(agent)"
+                                [title]="agent.Description || agent.Name"
+                                (click)="PickAgent(agent)">
+                                <i [class]="IconClassFor(agent)"></i>
+                                <span>{{ agent.Name }}</span>
+                            </button>
+                        }
+                    }
+                </div>
+            }
+        </div>
+    `, styles: ["\n        /* Match mjButton size=\"sm\" so the trigger lines up with neighboring\n           Export / Share buttons: min-height 32px, 6px/12px padding,\n           0.8125rem font. Same border-radius as the other chrome buttons. */\n        .mj-cv-agent-picker { position: relative; display: inline-flex; align-items: center; }\n        .mj-cv-agent-picker__trigger {\n            display: inline-flex; align-items: center; gap: 6px;\n            padding: 6px 12px; min-height: 32px; box-sizing: border-box;\n            background: var(--mj-bg-surface-card); border: 1px solid var(--mj-border-default);\n            border-radius: 4px; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 0.8125rem; line-height: 1.5;\n            transition: background 120ms, border-color 120ms;\n        }\n        .mj-cv-agent-picker__trigger:hover:not(:disabled) {\n            background: var(--mj-bg-surface-hover); border-color: var(--mj-border-strong);\n        }\n        .mj-cv-agent-picker__trigger:disabled { opacity: 0.5; cursor: not-allowed; }\n        .mj-cv-agent-picker--open .mj-cv-agent-picker__trigger { border-color: var(--mj-border-focus); }\n        .mj-cv-agent-picker__label { max-width: 160px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n        .mj-cv-agent-picker__caret { font-size: 10px; opacity: 0.7; }\n        .mj-cv-agent-picker__menu {\n            position: absolute; top: calc(100% + 4px); right: 0; z-index: 50;\n            min-width: 220px; max-height: 320px; overflow-y: auto;\n            background: var(--mj-bg-surface-elevated); border: 1px solid var(--mj-border-default);\n            border-radius: 6px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);\n            padding: 4px 0;\n        }\n        .mj-cv-agent-picker__menu-header {\n            padding: 6px 12px 4px; font-size: 11px; text-transform: uppercase;\n            letter-spacing: 0.04em; color: var(--mj-text-muted);\n        }\n        .mj-cv-agent-picker__item {\n            display: flex; align-items: center; gap: 8px; width: 100%;\n            padding: 6px 12px; background: transparent; border: none; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 13px; text-align: left;\n        }\n        .mj-cv-agent-picker__item i { width: 14px; text-align: center; color: var(--mj-text-secondary); }\n        .mj-cv-agent-picker__item:hover { background: var(--mj-bg-surface-hover); }\n        .mj-cv-agent-picker__item--selected { background: color-mix(in srgb, var(--mj-brand-primary) 10%, transparent); }\n        .mj-cv-agent-picker__item--selected i { color: var(--mj-brand-primary); }\n        .mj-cv-agent-picker__empty { padding: 8px 12px; font-size: 12px; color: var(--mj-text-muted); }\n    "] }]
+    }], null, { Conversation: [{
+            type: Input
+        }], CurrentUser: [{
+            type: Input
+        }], Disabled: [{
+            type: Input
+        }], AgentChanged: [{
+            type: Output
+        }], OnDocumentClick: [{
+            type: HostListener,
+            args: ['document:click', ['$event']]
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(ConversationAgentPickerComponent, { className: "ConversationAgentPickerComponent", filePath: "src/lib/components/conversation/conversation-agent-picker.component.ts", lineNumber: 125 }); })();
+//# sourceMappingURL=conversation-agent-picker.component.js.map

package/dist/lib/components/conversation/conversation-agent-picker.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-agent-picker.component.js","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-agent-picker.component.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ChangeDetectionStrategy,\n    ChangeDetectorRef,\n    Component,\n    EventEmitter,\n    HostListener,\n    Input,\n    OnInit,\n    Output,\n    inject,\n} from '@angular/core';\nimport { LogError } from '@memberjunction/core';\nimport type { UserInfo } from '@memberjunction/core';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport type { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';\nimport type { MJConversationEntity } from '@memberjunction/core-entities';\nimport { MJNotificationService } from '@memberjunction/ng-notifications';\nimport { UUIDsEqual } from '@memberjunction/global';\n\n/**\n * Header widget that lets a user pin a default AI agent on the active\n * conversation. The pinned agent (saved to\n * `MJConversationEntity.DefaultAgentID`) takes precedence over the\n * embedder-supplied default in `MessageInputComponent.routeMessage()` —\n * non-mention messages route to it instead of Sage.\n *\n * Eligible agents are top-level, Active, non-Sub-Agent rows from\n * `AIEngineBase.Instance.Agents`. The widget renders as a compact button\n * showing the current pin (or \"Auto\" when nothing is pinned). Clicking\n * opens an inline list with a \"Clear\" option to remove the pin.\n *\n * The host controls visibility via `<mj-conversation-chat-area>`'s\n * `[showAgentPicker]` input (default true). Surfaces that don't want this\n * UX (e.g. agent-less embed) set it to false.\n */\n@Component({\n    standalone: false,\n    selector: 'mj-conversation-agent-picker',\n    changeDetection: ChangeDetectionStrategy.OnPush,\n    template: `\n        <div class=\"mj-cv-agent-picker\" [class.mj-cv-agent-picker--open]=\"IsOpen\">\n            <button\n                type=\"button\"\n                class=\"mj-cv-agent-picker__trigger\"\n                [title]=\"ButtonTitle\"\n                [disabled]=\"Disabled || !Conversation\"\n                (click)=\"Toggle($event)\">\n                <i class=\"fa-solid fa-robot\"></i>\n                <span class=\"mj-cv-agent-picker__label\">{{ CurrentAgentLabel }}</span>\n                <i class=\"fa-solid fa-caret-down mj-cv-agent-picker__caret\"></i>\n            </button>\n            @if (IsOpen) {\n                <div class=\"mj-cv-agent-picker__menu\" (click)=\"$event.stopPropagation()\">\n                    <div class=\"mj-cv-agent-picker__menu-header\">Default agent for this conversation</div>\n                    <button\n                        type=\"button\"\n                        class=\"mj-cv-agent-picker__item\"\n                        [class.mj-cv-agent-picker__item--selected]=\"!Conversation?.DefaultAgentID\"\n                        (click)=\"PickAgent(null)\">\n                        <i class=\"fa-solid fa-wand-magic-sparkles\"></i>\n                        <span>Auto (use default)</span>\n                    </button>\n                    @if (EligibleAgents.length === 0) {\n                        <div class=\"mj-cv-agent-picker__empty\">No agents available</div>\n                    } @else {\n                        @for (agent of EligibleAgents; track agent.ID) {\n                            <button\n                                type=\"button\"\n                                class=\"mj-cv-agent-picker__item\"\n                                [class.mj-cv-agent-picker__item--selected]=\"IsSelected(agent)\"\n                                [title]=\"agent.Description || agent.Name\"\n                                (click)=\"PickAgent(agent)\">\n                                <i [class]=\"IconClassFor(agent)\"></i>\n                                <span>{{ agent.Name }}</span>\n                            </button>\n                        }\n                    }\n                </div>\n            }\n        </div>\n    `,\n    styles: [`\n        /* Match mjButton size=\"sm\" so the trigger lines up with neighboring\n           Export / Share buttons: min-height 32px, 6px/12px padding,\n           0.8125rem font. Same border-radius as the other chrome buttons. */\n        .mj-cv-agent-picker { position: relative; display: inline-flex; align-items: center; }\n        .mj-cv-agent-picker__trigger {\n            display: inline-flex; align-items: center; gap: 6px;\n            padding: 6px 12px; min-height: 32px; box-sizing: border-box;\n            background: var(--mj-bg-surface-card); border: 1px solid var(--mj-border-default);\n            border-radius: 4px; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 0.8125rem; line-height: 1.5;\n            transition: background 120ms, border-color 120ms;\n        }\n        .mj-cv-agent-picker__trigger:hover:not(:disabled) {\n            background: var(--mj-bg-surface-hover); border-color: var(--mj-border-strong);\n        }\n        .mj-cv-agent-picker__trigger:disabled { opacity: 0.5; cursor: not-allowed; }\n        .mj-cv-agent-picker--open .mj-cv-agent-picker__trigger { border-color: var(--mj-border-focus); }\n        .mj-cv-agent-picker__label { max-width: 160px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n        .mj-cv-agent-picker__caret { font-size: 10px; opacity: 0.7; }\n        .mj-cv-agent-picker__menu {\n            position: absolute; top: calc(100% + 4px); right: 0; z-index: 50;\n            min-width: 220px; max-height: 320px; overflow-y: auto;\n            background: var(--mj-bg-surface-elevated); border: 1px solid var(--mj-border-default);\n            border-radius: 6px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);\n            padding: 4px 0;\n        }\n        .mj-cv-agent-picker__menu-header {\n            padding: 6px 12px 4px; font-size: 11px; text-transform: uppercase;\n            letter-spacing: 0.04em; color: var(--mj-text-muted);\n        }\n        .mj-cv-agent-picker__item {\n            display: flex; align-items: center; gap: 8px; width: 100%;\n            padding: 6px 12px; background: transparent; border: none; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 13px; text-align: left;\n        }\n        .mj-cv-agent-picker__item i { width: 14px; text-align: center; color: var(--mj-text-secondary); }\n        .mj-cv-agent-picker__item:hover { background: var(--mj-bg-surface-hover); }\n        .mj-cv-agent-picker__item--selected { background: color-mix(in srgb, var(--mj-brand-primary) 10%, transparent); }\n        .mj-cv-agent-picker__item--selected i { color: var(--mj-brand-primary); }\n        .mj-cv-agent-picker__empty { padding: 8px 12px; font-size: 12px; color: var(--mj-text-muted); }\n    `]\n})\nexport class ConversationAgentPickerComponent implements OnInit {\n    /** The conversation whose `DefaultAgentID` this widget edits. */\n    @Input() Conversation: MJConversationEntity | null = null;\n\n    /** Required for the Save() audit context. */\n    @Input() CurrentUser: UserInfo | null = null;\n\n    /** Disable the picker (e.g. read-only conversation). */\n    @Input() Disabled: boolean = false;\n\n    /** Emitted after a successful save with the new (or null) agent ID. */\n    @Output() AgentChanged = new EventEmitter<string | null>();\n\n    public IsOpen = false;\n    public EligibleAgents: MJAIAgentEntityExtended[] = [];\n\n    private readonly cdr = inject(ChangeDetectorRef);\n    private readonly notifications = inject(MJNotificationService);\n\n    public async ngOnInit(): Promise<void> {\n        try {\n            // AIEngineBase is the live, cached agent catalog. Ensure it's\n            // loaded — most app shells warm it up at boot, but the picker\n            // could mount before that completes.\n            await AIEngineBase.Instance.Config(false);\n            this.EligibleAgents = (AIEngineBase.Instance.Agents ?? [])\n                .filter(a =>\n                    !a.ParentID &&\n                    a.Status === 'Active' &&\n                    a.InvocationMode !== 'Sub-Agent'\n                )\n                .sort((a, b) => (a.Name ?? '').localeCompare(b.Name ?? ''));\n            this.cdr.markForCheck();\n        } catch (err) {\n            LogError(`ConversationAgentPicker.ngOnInit: ${err instanceof Error ? err.message : String(err)}`);\n        }\n    }\n\n    public get CurrentAgentLabel(): string {\n        const id = this.Conversation?.DefaultAgentID;\n        if (!id) return 'Auto';\n        const match = this.EligibleAgents.find(a => UUIDsEqual(a.ID, id));\n        // If the pinned agent is no longer eligible (deactivated, demoted to\n        // sub-agent), still surface its name from the cache so the user can\n        // see what was pinned even though they can't re-pin it.\n        const fromCache = match\n            ?? (AIEngineBase.Instance.Agents ?? []).find(a => UUIDsEqual(a.ID, id));\n        return fromCache?.Name ?? 'Pinned agent';\n    }\n\n    public get ButtonTitle(): string {\n        return this.Conversation?.DefaultAgentID\n            ? `This conversation routes to ${this.CurrentAgentLabel}. Click to change.`\n            : 'No agent pinned — messages route via the standard rules. Click to pin an agent.';\n    }\n\n    public IconClassFor(agent: MJAIAgentEntityExtended): string {\n        return agent.IconClass?.trim() || 'fa-solid fa-robot';\n    }\n\n    public IsSelected(agent: MJAIAgentEntityExtended): boolean {\n        return !!this.Conversation?.DefaultAgentID\n            && UUIDsEqual(agent.ID, this.Conversation.DefaultAgentID);\n    }\n\n    public Toggle(event: MouseEvent): void {\n        event.stopPropagation();\n        if (this.Disabled || !this.Conversation) return;\n        this.IsOpen = !this.IsOpen;\n        this.cdr.markForCheck();\n    }\n\n    public async PickAgent(agent: MJAIAgentEntityExtended | null): Promise<void> {\n        this.IsOpen = false;\n        const conv = this.Conversation;\n        if (!conv) return;\n        const newId = agent?.ID ?? null;\n        if (conv.DefaultAgentID === newId) {\n            this.cdr.markForCheck();\n            return;\n        }\n        const prev = conv.DefaultAgentID;\n        conv.DefaultAgentID = newId;\n        try {\n            const saved = await conv.Save();\n            if (!saved) {\n                conv.DefaultAgentID = prev;\n                this.notifications.CreateSimpleNotification(\n                    conv.LatestResult?.CompleteMessage ?? 'Failed to update conversation default agent.',\n                    'error', 4500);\n                return;\n            }\n            this.AgentChanged.emit(newId);\n        } catch (err) {\n            conv.DefaultAgentID = prev;\n            LogError(`ConversationAgentPicker.PickAgent: ${err instanceof Error ? err.message : String(err)}`);\n        } finally {\n            this.cdr.markForCheck();\n        }\n    }\n\n    /** Close the menu when the user clicks outside the picker. */\n    @HostListener('document:click', ['$event'])\n    public OnDocumentClick(_event: MouseEvent): void {\n        if (this.IsOpen) {\n            this.IsOpen = false;\n            this.cdr.markForCheck();\n        }\n    }\n}\n"]}

package/dist/lib/components/conversation/conversation-chat-area.component.d.ts

@@ -3,6 +3,7 @@ import { BaseAngularComponent } from '@memberjunction/ng-base-types';
 import { UserInfo, CompositeKey, DataSnapshot } from '@memberjunction/core';
 import { MJConversationEntity, MJConversationDetailEntity, MJAIAgentRunEntity, MJArtifactEntity, MJTaskEntity, RatingJSON } from '@memberjunction/core-entities';
 import { MJAIAgentRunEntityExtended } from "@memberjunction/ai-core-plus";
+import { UICommandHandlerService } from '../../services/ui-command-handler.service';
 import { AgentStateService } from '../../services/agent-state.service';
 import { ConversationAgentService } from '../../services/conversation-agent.service';
 import { ActiveTasksService } from '../../services/active-tasks.service';
@@ -13,7 +14,7 @@ import { MJResourcePermissionShareAdapter, ResourceShareContext } from '@memberj
 import { MessageAttachment } from '../message/message-item.component';
 import { LazyArtifactInfo } from '../../models/lazy-artifact-info';
 import { PendingAttachment } from '../mention/mention-editor.component';
-import { NavigationRequest, AnalyzeArtifactService } from '@memberjunction/ng-artifacts';
+import { NavigationRequest, AnalyzeArtifactService, InteractiveFormApplyService } from '@memberjunction/ng-artifacts';
 import { TestFeedbackDialogData, TestFeedbackDialogResult } from '@memberjunction/ng-testing';
 import { DialogService as ConversationsDialogService } from '../../services/dialog.service';
 import { Subject } from 'rxjs';
@@ -32,6 +33,8 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
     private confirmDialog;
     private bridge;
     private analyzeArtifactService;
+    private uiCommandHandler;
+    private interactiveFormApplyService;
     environmentId: string;
     currentUser: UserInfo;
     private _conversationId;
@@ -39,6 +42,30 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
     get conversationId(): string | null;
     conversation: MJConversationEntity | null;
     threadId: string | null;
+    /**
+     * When true, render the normal message-list + message-input layout even
+     * before a conversation exists, instead of the centered empty-state
+     * welcome card. Lets host pages (e.g. Form Builder cockpit) put the chat
+     * header + mode picker front-and-center on first open and let the user
+     * pick a mode before typing. The first send still routes through
+     * MessageInputComponent and triggers conversationCreated as usual.
+     */
+    suppressNewConversationEmptyState: boolean;
+    /**
+     * Host-level cap for @-mention autocomplete (agents and users).
+     * Defaults true. Hosts addressing a single fixed agent (e.g. Form Builder
+     * cockpit pinned to the Form Builder agent) should set false so the user
+     * can't accidentally redirect a turn to a different agent.
+     */
+    allowMentions: boolean;
+    /**
+     * Host-level cap for attachments. Defaults true. When false, the host
+     * disables attachments regardless of agent modality support — useful for
+     * surfaces where attachments don't make sense (cockpit text-only flows).
+     * When true (default), attachment availability still depends on the
+     * agent's modality support, computed at runtime.
+     */
+    allowAttachments: boolean;
     private _isNewConversation;
     set isNewConversation(value: boolean);
     get isNewConversation(): boolean;
@@ -60,6 +87,103 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
     showArtifactIndicator: boolean;
     /** Application context snapshot for AI agent awareness. Included in agent execution data. */
     appContext: Record<string, unknown> | null;
+    /**
+     * Optional default agent ID for the conversation. Forwarded to
+     * `<mj-message-input>` as its `[defaultAgentId]` so the first message
+     * routes directly to this agent instead of Sage. See
+     * `MessageInputComponent.routeMessage` priority rules — explicit
+     * @mention and prior-agent continuity still take precedence.
+     *
+     * Embedded chat surfaces (Form Builder cockpit, future domain chats)
+     * set this to the specialist agent's ID; the main Chat app leaves it
+     * unset to preserve the Sage-fronted UX.
+     */
+    defaultAgentId: string | null;
+    /**
+     * Scope to apply when this surface CREATES a new conversation. Forwarded
+     * to `ConversationEngine.CreateConversation` so the new row's
+     * `ApplicationScope` column is stamped correctly. Embedded surfaces
+     * (e.g. the Form Builder cockpit) set this to `'Application'` so their
+     * conversations don't pollute the main Chat app list. Main Chat leaves
+     * it as the default `'Global'`. Has no effect on existing conversations.
+     */
+    applicationScope: 'Global' | 'Application' | 'Both';
+    /**
+     * Application ID to bind a newly-created conversation to. REQUIRED when
+     * `applicationScope` is 'Application' or 'Both' (DB CHECK constraint
+     * enforces it). Used by embedded chat surfaces to scope their
+     * conversations to their owning Application.
+     */
+    applicationId: string | null;
+    /**
+     * "What is this conversation about?" — the Entity ID this conversation
+     * references. Forwarded to `ConversationEngine.CreateConversation` so
+     * the new row's `LinkedEntityID` is stamped at creation time. Paired
+     * with {@link linkedRecordId} (DB CHECK requires both populated or both
+     * null). Form Builder cockpit passes the MJ: Components entity ID;
+     * Component Studio's AI panel does the same. Surfaces use this to
+     * later list "prior conversations about THIS form/component."
+     * Has no effect on existing conversations.
+     */
+    linkedEntityId: string | null;
+    /**
+     * Primary key of the linked record, serialized as a string. Used with
+     * {@link linkedEntityId}. Form Builder cockpit passes the active
+     * form's ComponentID; Component Studio's AI panel passes the
+     * currently-selected component's ID.
+     */
+    linkedRecordId: string | null;
+    /**
+     * Whether the conversation header should render the per-conversation
+     * agent picker. Default true. The picker lets a user pin a default
+     * agent on the active conversation (saved to
+     * `MJConversationEntity.DefaultAgentID`), so non-mention messages route
+     * to that agent instead of through Sage. Surfaces with no meaningful
+     * agent-choice UX can set this to false to hide the widget.
+     */
+    showAgentPicker: boolean;
+    /**
+     * Whether the chat header should render the per-agent mode/quality
+     * picker (Draft / Standard / High, etc.). Default true. The picker
+     * auto-hides when the bound agent has fewer than 2 configured
+     * presets, so embedders rarely need to set this explicitly — turn
+     * off only when the surface should never expose model-tier choice
+     * (kiosks, specialty embeds).
+     */
+    showAgentModePicker: boolean;
+    /**
+     * The mode/preset picker's selected configuration ID, forwarded to
+     * `<mj-message-input>` so non-mention routes apply it on the next
+     * send. Past messages are NOT retroactively re-routed — the picker
+     * only affects subsequent requests. Updated when the user picks a
+     * row in the mode picker; the picker itself persists the choice
+     * per-user, per-agent via UserInfoEngine.
+     */
+    ActiveAgentConfigurationPresetId: string | null;
+    /**
+     * Agent the mode picker should target. Mirrors the routing precedence
+     * minus message-history continuity (the picker is persistent UI; it
+     * shouldn't flip as the user scrolls history).
+     *
+     * Order: conversation-pinned default → embedder default → Sage.
+     */
+    /**
+     * True when the chat header should render even before a conversation
+     * row exists. Currently means: the embedder has enabled the mode
+     * picker AND we resolved a target agent for it (so there's actually
+     * something to put in the header). Lets surfaces like the Form
+     * Builder cockpit show the mode picker on top of the empty-state
+     * instead of waiting for the first message to create a conversation.
+     */
+    get HasPreConversationHeader(): boolean;
+    get ModePickerTargetAgentId(): string | null;
+    /**
+     * Mode picker emitted a new selection. Store it; the next message's
+     * route picks it up via `<mj-message-input>`'s
+     * `[agentConfigurationPresetId]` binding. Past messages stay routed
+     * as they were — the change is forward-only.
+     */
+    OnAgentModePresetChanged(presetId: string | null): void;
     /** Greeting message shown in the empty state when no conversation is active */
     emptyStateGreeting: string;
     showSidebarToggle: boolean;
@@ -188,7 +312,17 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
     acceptedFileTypes: string;
     private conversationManagerAgent;
     private engine;
-    constructor(agentStateService: AgentStateService, conversationAgentService: ConversationAgentService, activeTasks: ActiveTasksService, cdr: ChangeDetectorRef, mentionAutocompleteService: MentionAutocompleteService, artifactPermissionService: ArtifactPermissionService, attachmentService: ConversationAttachmentService, streamingService: ConversationStreamingService, confirmDialog: ConversationsDialogService, bridge: ConversationBridgeService, analyzeArtifactService: AnalyzeArtifactService);
+    constructor(agentStateService: AgentStateService, conversationAgentService: ConversationAgentService, activeTasks: ActiveTasksService, cdr: ChangeDetectorRef, mentionAutocompleteService: MentionAutocompleteService, artifactPermissionService: ArtifactPermissionService, attachmentService: ConversationAttachmentService, streamingService: ConversationStreamingService, confirmDialog: ConversationsDialogService, bridge: ConversationBridgeService, analyzeArtifactService: AnalyzeArtifactService, uiCommandHandler: UICommandHandlerService, interactiveFormApplyService: InteractiveFormApplyService);
+    /**
+     * Apply a form-role artifact's spec as an EntityFormOverride for the
+     * current user. The service handles the Create-vs-Modify decision (based
+     * on whether an Active override already exists), confirms via dialog,
+     * and surfaces success/failure via notification.
+     */
+    OnApplyFormRequested(event: {
+        spec: unknown;
+        entityName: string;
+    }): Promise<void>;
     ngOnInit(): Promise<void>;
     /**
      * Initializes attachment support by checking if the conversation manager agent (Sage)
@@ -588,7 +722,70 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
     OnAnalyzeArtifact(event: {
         artifactId: string;
         snapshot: DataSnapshot;
-    }): Promise<void>;
+    }): Promise<PendingAttachment | null>;
+    /**
+     * Handle a `client:capture-data-snapshot` actionable command emitted by an
+     * analysis-class agent that needs the user's current view of an artifact to
+     * answer accurately but has no Data Snapshot artifact attached.
+     *
+     * Flow:
+     *  1. Resolve the target artifact — `command.artifactId` if provided,
+     *     otherwise the most-recent output artifact on the conversation.
+     *  2. Open the artifact viewer panel for it (mounts the viewer plugin if not
+     *     already mounted).
+     *  3. Poll until the viewer can produce a snapshot via
+     *     `GetCurrentStateSnapshot()`, with a short timeout.
+     *  4. Reuse the existing `OnAnalyzeArtifact` flow to persist the snapshot
+     *     as a Data Snapshot artifact + attach it as a chip on the message input.
+     *  5. If `command.followupMessage` is provided, replace the prefill and
+     *     auto-send so the agent immediately re-runs with the snapshot attached.
+     *     Otherwise, leave the chip + prefill in place for the user to send manually.
+     *
+     * Soft-fails — logs a warning and stops on any unrecoverable error rather
+     * than throwing. The user's conversation state isn't disrupted.
+     */
+    private handleCaptureDataSnapshotCommand;
+    /**
+     * Poll `artifactViewerComponent.GetCurrentStateSnapshot()` for the LIVE
+     * data snapshot. The React component inside the viewer plugin needs several
+     * render cycles after `selectedArtifactId` changes before its inner data
+     * fetches run and its `getCurrentDataState()` becomes callable via
+     * `callbacks.RegisterMethod('getCurrentDataState', ...)`.
+     *
+     * `GetCurrentStateSnapshot()` returns three distinct shapes:
+     *   - **Live**: a populated DataSnapshot with `tables[]` whose rows are filled.
+     *   - **Fallback**: an empty placeholder with only `title` + `interpretation`
+     *     ("No live data was captured — the component either has no data-fetching
+     *     hooks or has not yet run its queries"). This fires when the React
+     *     component hasn't yet registered `getCurrentDataState()`.
+     *   - **Schema-only**: a structured snapshot with real `tables`/`columns` and
+     *     metadata (e.g. `totalAvailableRowCount`) but `rows: []`. This is common
+     *     for query-backed / server-paged components whose data load hasn't
+     *     completed (or whose visible page is empty) at the moment of capture.
+     *
+     * We must accept ONLY a snapshot that actually carries rows — a schema-only
+     * or placeholder snapshot defeats the point of the pipeline (the analysis
+     * agent receives an empty table). So we key "live" on `rows.length`, not just
+     * `tables.length`, and keep polling so async/paged data has time to load.
+     * Only after timeout do we return the last available row-less snapshot (any
+     * structure is better than nothing, but the user will see an empty table in
+     * the resulting artifact).
+     */
+    private waitForViewerSnapshot;
+    /**
+     * Find the most-recent Component artifact attached as `Output` to this
+     * conversation. Used when a `client:capture-data-snapshot` command arrives
+     * without an explicit `artifactId`.
+     *
+     * Filtering to Component-typed artifacts is intentional even though the
+     * command type itself is artifact-generic: the downstream
+     * `waitForViewerSnapshot` polling waits for `tables[]` to populate (the
+     * shape Components produce via React `getCurrentDataState()`). Falling back
+     * to a non-Component artifact would 10s-timeout to a placeholder snapshot.
+     * When other artifact types need a usable fallback, generalize the polling
+     * first, then drop the filter here.
+     */
+    private findMostRecentComponentArtifactId;
     /**
      * Handle close of artifact share modal
      */
@@ -643,6 +840,6 @@ export declare class ConversationChatAreaComponent extends BaseAngularComponent
      */
     onIntentCheckCompleted(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConversationChatAreaComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConversationChatAreaComponent, "mj-conversation-chat-area", never, { "environmentId": { "alias": "environmentId"; "required": false; }; "currentUser": { "alias": "currentUser"; "required": false; }; "conversationId": { "alias": "conversationId"; "required": false; }; "conversation": { "alias": "conversation"; "required": false; }; "threadId": { "alias": "threadId"; "required": false; }; "isNewConversation": { "alias": "isNewConversation"; "required": false; }; "pendingMessage": { "alias": "pendingMessage"; "required": false; }; "pendingAttachments": { "alias": "pendingAttachments"; "required": false; }; "pendingArtifactId": { "alias": "pendingArtifactId"; "required": false; }; "pendingArtifactVersionNumber": { "alias": "pendingArtifactVersionNumber"; "required": false; }; "overlayMode": { "alias": "overlayMode"; "required": false; }; "showExportButton": { "alias": "showExportButton"; "required": false; }; "showShareButton": { "alias": "showShareButton"; "required": false; }; "showArtifactIndicator": { "alias": "showArtifactIndicator"; "required": false; }; "appContext": { "alias": "appContext"; "required": false; }; "emptyStateGreeting": { "alias": "emptyStateGreeting"; "required": false; }; "showSidebarToggle": { "alias": "showSidebarToggle"; "required": false; }; }, { "conversationRenamed": "conversationRenamed"; "openEntityRecord": "openEntityRecord"; "navigationRequest": "navigationRequest"; "taskClicked": "taskClicked"; "artifactLinkClicked": "artifactLinkClicked"; "sidebarToggleClicked": "sidebarToggleClicked"; "conversationCreated": "conversationCreated"; "threadOpened": "threadOpened"; "threadClosed": "threadClosed"; "pendingArtifactConsumed": "pendingArtifactConsumed"; "pendingMessageConsumed": "pendingMessageConsumed"; "pendingMessageRequested": "pendingMessageRequested"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConversationChatAreaComponent, "mj-conversation-chat-area", never, { "environmentId": { "alias": "environmentId"; "required": false; }; "currentUser": { "alias": "currentUser"; "required": false; }; "conversationId": { "alias": "conversationId"; "required": false; }; "conversation": { "alias": "conversation"; "required": false; }; "threadId": { "alias": "threadId"; "required": false; }; "suppressNewConversationEmptyState": { "alias": "suppressNewConversationEmptyState"; "required": false; }; "allowMentions": { "alias": "allowMentions"; "required": false; }; "allowAttachments": { "alias": "allowAttachments"; "required": false; }; "isNewConversation": { "alias": "isNewConversation"; "required": false; }; "pendingMessage": { "alias": "pendingMessage"; "required": false; }; "pendingAttachments": { "alias": "pendingAttachments"; "required": false; }; "pendingArtifactId": { "alias": "pendingArtifactId"; "required": false; }; "pendingArtifactVersionNumber": { "alias": "pendingArtifactVersionNumber"; "required": false; }; "overlayMode": { "alias": "overlayMode"; "required": false; }; "showExportButton": { "alias": "showExportButton"; "required": false; }; "showShareButton": { "alias": "showShareButton"; "required": false; }; "showArtifactIndicator": { "alias": "showArtifactIndicator"; "required": false; }; "appContext": { "alias": "appContext"; "required": false; }; "defaultAgentId": { "alias": "defaultAgentId"; "required": false; }; "applicationScope": { "alias": "applicationScope"; "required": false; }; "applicationId": { "alias": "applicationId"; "required": false; }; "linkedEntityId": { "alias": "linkedEntityId"; "required": false; }; "linkedRecordId": { "alias": "linkedRecordId"; "required": false; }; "showAgentPicker": { "alias": "showAgentPicker"; "required": false; }; "showAgentModePicker": { "alias": "showAgentModePicker"; "required": false; }; "emptyStateGreeting": { "alias": "emptyStateGreeting"; "required": false; }; "showSidebarToggle": { "alias": "showSidebarToggle"; "required": false; }; }, { "conversationRenamed": "conversationRenamed"; "openEntityRecord": "openEntityRecord"; "navigationRequest": "navigationRequest"; "taskClicked": "taskClicked"; "artifactLinkClicked": "artifactLinkClicked"; "sidebarToggleClicked": "sidebarToggleClicked"; "conversationCreated": "conversationCreated"; "threadOpened": "threadOpened"; "threadClosed": "threadClosed"; "pendingArtifactConsumed": "pendingArtifactConsumed"; "pendingMessageConsumed": "pendingMessageConsumed"; "pendingMessageRequested": "pendingMessageRequested"; }, never, never, false, never>;
 }
 //# sourceMappingURL=conversation-chat-area.component.d.ts.map