@memberjunction/ng-conversations 6.2.0-edge.0 → 6.2.0-edge.2

package/dist/lib/services/toast.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"toast.service.js","sourceRoot":"","sources":["../../../src/lib/services/toast.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAc,MAAM,MAAM,CAAC;;AAenD,MAAM,OAAO,YAAY;IACf,aAAa,GAAG,IAAI,eAAe,CAAU,EAAE,CAAC,CAAC;IAClD,OAAO,GAAwB,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;IAEhE,SAAS,GAAG,CAAC,CAAC;IAEtB;;OAEG;IACI,IAAI,CAAC,OAAe,EAAE,OAAkB,MAAM,EAAE,WAAmB,IAAI;QAC5E,MAAM,KAAK,GAAU;YACnB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YAC7C,OAAO;YACP,IAAI;YACJ,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAC/C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;QAEnD,8BAA8B;QAC9B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC,EAAE,QAAQ,CAAC,CAAC;QACf,CAAC;QAED,OAAO,KAAK,CAAC,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,OAAe,EAAE,WAAmB,IAAI;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAe,EAAE,WAAmB,IAAI;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,OAAe,EAAE,WAAmB,IAAI;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,OAAe,EAAE,WAAmB,IAAI;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,EAAU;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAC/C,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;sGAzEU,YAAY;gEAAZ,YAAY,WAAZ,YAAY,mBAFX,MAAM;;iFAEP,YAAY;cAHxB,UAAU;eAAC;gBACV,UAAU,EAAE,MAAM;aACnB","sourcesContent":["import { Injectable } from '@angular/core';\nimport { BehaviorSubject, Observable } from 'rxjs';\n\nexport type ToastType = 'success' | 'error' | 'warning' | 'info';\n\nexport interface Toast {\n  id: string;\n  message: string;\n  type: ToastType;\n  duration: number;\n  timestamp: number;\n}\n\n@Injectable({\n  providedIn: 'root'\n})\nexport class ToastService {\n  private toastsSubject = new BehaviorSubject<Toast[]>([]);\n  public toasts$: Observable<Toast[]> = this.toastsSubject.asObservable();\n\n  private idCounter = 0;\n\n  /**\n   * Show a toast notification\n   */\n  public show(message: string, type: ToastType = 'info', duration: number = 3000): string {\n    const toast: Toast = {\n      id: `toast-${++this.idCounter}-${Date.now()}`,\n      message,\n      type,\n      duration,\n      timestamp: Date.now()\n    };\n\n    const currentToasts = this.toastsSubject.value;\n    this.toastsSubject.next([...currentToasts, toast]);\n\n    // Auto-dismiss after duration\n    if (duration > 0) {\n      setTimeout(() => {\n        this.dismiss(toast.id);\n      }, duration);\n    }\n\n    return toast.id;\n  }\n\n  /**\n   * Show a success toast\n   */\n  public success(message: string, duration: number = 3000): string {\n    return this.show(message, 'success', duration);\n  }\n\n  /**\n   * Show an error toast\n   */\n  public error(message: string, duration: number = 5000): string {\n    return this.show(message, 'error', duration);\n  }\n\n  /**\n   * Show a warning toast\n   */\n  public warning(message: string, duration: number = 4000): string {\n    return this.show(message, 'warning', duration);\n  }\n\n  /**\n   * Show an info toast\n   */\n  public info(message: string, duration: number = 3000): string {\n    return this.show(message, 'info', duration);\n  }\n\n  /**\n   * Dismiss a specific toast by ID\n   */\n  public dismiss(id: string): void {\n    const currentToasts = this.toastsSubject.value;\n    const filteredToasts = currentToasts.filter(t => t.id !== id);\n    this.toastsSubject.next(filteredToasts);\n  }\n\n  /**\n   * Clear all toasts\n   */\n  public clear(): void {\n    this.toastsSubject.next([]);\n  }\n}\n"]}
+{"version":3,"file":"toast.service.js","sourceRoot":"","sources":["../../../src/lib/services/toast.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { BehaviorSubject, Observable } from 'rxjs';\n\nexport type ToastType = 'success' | 'error' | 'warning' | 'info';\n\nexport interface Toast {\n  id: string;\n  message: string;\n  type: ToastType;\n  duration: number;\n  timestamp: number;\n}\n\n@Injectable({\n  providedIn: 'root'\n})\nexport class ToastService {\n  private toastsSubject = new BehaviorSubject<Toast[]>([]);\n  public Toasts$: Observable<Toast[]> = this.toastsSubject.asObservable();\n\n  /** @deprecated Use {@link Toasts$}. */\n  public get toasts$(): Observable<Toast[]> {\n    return this.Toasts$;\n  }\n  /** @deprecated Use {@link Toasts$}. */\n  public set toasts$(value: Observable<Toast[]>) {\n    this.Toasts$ = value;\n  }\n\n  private idCounter = 0;\n\n  /**\n   * Show a toast notification\n   */\n  public Show(message: string, type: ToastType = 'info', duration: number = 3000): string {\n    const toast: Toast = {\n      id: `toast-${++this.idCounter}-${Date.now()}`,\n      message,\n      type,\n      duration,\n      timestamp: Date.now()\n    };\n\n    const currentToasts = this.toastsSubject.value;\n    this.toastsSubject.next([...currentToasts, toast]);\n\n    // Auto-dismiss after duration\n    if (duration > 0) {\n      setTimeout(() => {\n        this.Dismiss(toast.id);\n      }, duration);\n    }\n\n    return toast.id;\n  }\n\n  /** @deprecated Use {@link Show}. */\n  public show(message: string, type: ToastType = 'info', duration: number = 3000): string {\n    return this.Show(message, type, duration);\n  }\n\n  /**\n   * Show a success toast\n   */\n  public Success(message: string, duration: number = 3000): string {\n    return this.Show(message, 'success', duration);\n  }\n\n  /** @deprecated Use {@link Success}. */\n  public success(message: string, duration: number = 3000): string {\n    return this.Success(message, duration);\n  }\n\n  /**\n   * Show an error toast\n   */\n  public Error(message: string, duration: number = 5000): string {\n    return this.Show(message, 'error', duration);\n  }\n\n  /** @deprecated Use {@link Error}. */\n  public error(message: string, duration: number = 5000): string {\n    return this.Error(message, duration);\n  }\n\n  /**\n   * Show a warning toast\n   */\n  public Warning(message: string, duration: number = 4000): string {\n    return this.Show(message, 'warning', duration);\n  }\n\n  /** @deprecated Use {@link Warning}. */\n  public warning(message: string, duration: number = 4000): string {\n    return this.Warning(message, duration);\n  }\n\n  /**\n   * Show an info toast\n   */\n  public Info(message: string, duration: number = 3000): string {\n    return this.Show(message, 'info', duration);\n  }\n\n  /** @deprecated Use {@link Info}. */\n  public info(message: string, duration: number = 3000): string {\n    return this.Info(message, duration);\n  }\n\n  /**\n   * Dismiss a specific toast by ID\n   */\n  public Dismiss(id: string): void {\n    const currentToasts = this.toastsSubject.value;\n    const filteredToasts = currentToasts.filter(t => t.id !== id);\n    this.toastsSubject.next(filteredToasts);\n  }\n\n  /** @deprecated Use {@link Dismiss}. */\n  public dismiss(id: string): void {\n    return this.Dismiss(id);\n  }\n\n  /**\n   * Clear all toasts\n   */\n  public Clear(): void {\n    this.toastsSubject.next([]);\n  }\n\n  /** @deprecated Use {@link Clear}. */\n  public clear(): void {\n    return this.Clear();\n  }\n}\n"]}

package/dist/lib/services/ui-command-handler.service.d.ts

@@ -6,36 +6,83 @@ export interface ActionableCommandRequest {
     command: ActionableCommand;
     conversationId?: string | null;
     conversationDetailId?: string | null;
+    /**
+     * Set only on the compose:email over-length fallback: whether the draft body is now on the
+     * user's clipboard. The copy overwrites whatever the user had copied, so the host must say it
+     * happened, and must not claim it when this is false (no body, clipboard unavailable over plain
+     * HTTP, or denied by permissions policy).
+     */
+    DraftCopiedToClipboard?: boolean;
 }
 /**
  * Service for handling UI commands from agents.
  *
- * Generic commands (open:url) are handled directly by this service.
- * App-specific commands (open:resource) are emitted for the host application to handle.
+ * Generic commands (open:url, and compose:email while it fits in a mailto: URL) are handled
+ * directly by this service. App-specific commands (open:resource, and the compose:email
+ * over-length fallback) are emitted for the host application to handle.
  */
 export declare class UICommandHandlerService {
     private dataCacheService;
     /**
      * Event emitted when an actionable command requires host-app handling.
-     * Currently only open:resource commands are emitted — open:url is handled directly.
+     *
+     * open:resource is always emitted. compose:email is emitted ONLY as a fallback, when the draft
+     * is too long for a mailto: URL and the host must open the draft artifact instead; a draft
+     * within the limit is handled here and never reaches the host. On that fallback the host also
+     * owns telling the user why their mail client did not open, because only the host knows whether
+     * a draft artifact opened (see {@link ActionableCommandRequest.DraftCopiedToClipboard}).
+     * open:url is always handled here.
      */
-    actionableCommandRequested: EventEmitter<ActionableCommandRequest>;
+    ActionableCommandRequested: EventEmitter<ActionableCommandRequest>;
+    /** @deprecated Use {@link ActionableCommandRequested}. */
+    get actionableCommandRequested(): EventEmitter<ActionableCommandRequest>;
+    /** @deprecated Use {@link ActionableCommandRequested}. */
+    set actionableCommandRequested(value: EventEmitter<ActionableCommandRequest>);
     /**
      * Event emitted when an automatic command should be executed
      * Host application should subscribe to this and handle the command appropriately
      */
-    automaticCommandRequested: EventEmitter<AutomaticCommand>;
+    AutomaticCommandRequested: EventEmitter<AutomaticCommand>;
+    /** @deprecated Use {@link AutomaticCommandRequested}. */
+    get automaticCommandRequested(): EventEmitter<AutomaticCommand>;
+    /** @deprecated Use {@link AutomaticCommandRequested}. */
+    set automaticCommandRequested(value: EventEmitter<AutomaticCommand>);
     constructor(dataCacheService: DataCacheService);
     /**
      * Execute an actionable command (triggered by user clicking a button).
      * Generic commands like open:url are handled directly; others are emitted to the host.
      */
+    ExecuteActionableCommand(command: ActionableCommand, origin?: Omit<ActionableCommandRequest, 'command'>): Promise<void>;
+    /** @deprecated Use {@link ExecuteActionableCommand}. */
     executeActionableCommand(command: ActionableCommand, origin?: Omit<ActionableCommandRequest, 'command'>): Promise<void>;
     /**
      * Handle open:url commands directly by opening the URL in a browser tab.
      * Data URIs are converted to Blob URLs because Chrome blocks window.open with data: URIs.
      */
     private handleOpenUrl;
+    /**
+     * Best-effort copy of an over-length draft's body, so the text is not lost even when the host
+     * cannot open the draft artifact.
+     *
+     * Never rejects, so a clipboard that is unavailable (plain HTTP) or denied by permissions policy
+     * cannot stop the fallback. Nothing on the click path awaits before writeText is called, so it
+     * still runs inside the click's user activation; the fallback then awaits the outcome only so
+     * the host's notice can say whether the copy happened.
+     *
+     * @returns true only when the body is on the clipboard, so the host never claims a copy that
+     *          did not happen.
+     */
+    private copyDraftBody;
+    /**
+     * Open the user's own mail client with a compose:email draft's fields pre-filled, via a
+     * synthesized anchor click.
+     *
+     * NOTHING IS SENT HERE. The agent drafted; the user sends. This only opens a compose window.
+     *
+     * Deliberately not window.open: Chrome treats window.open with a non-http scheme as a popup and
+     * strands an about:blank tab behind the compose window.
+     */
+    private openMailto;
     /**
      * Open a data URI by converting it to a Blob URL.
      * Chrome blocks window.open('data:...') for security, so we create a Blob URL instead.
@@ -45,10 +92,14 @@ export declare class UICommandHandlerService {
      * Execute an automatic command (runs immediately without user interaction)
      * Special handling: refresh:data commands execute locally, others emit to host
      */
+    ExecuteAutomaticCommand(command: AutomaticCommand): Promise<void>;
+    /** @deprecated Use {@link ExecuteAutomaticCommand}. */
     executeAutomaticCommand(command: AutomaticCommand): Promise<void>;
     /**
      * Execute all automatic commands from an agent result
      */
+    ExecuteAutomaticCommands(commands: AutomaticCommand[]): Promise<void>;
+    /** @deprecated Use {@link ExecuteAutomaticCommands}. */
     executeAutomaticCommands(commands: AutomaticCommand[]): Promise<void>;
     /**
      * Handle refreshing data (entity data or caches)

package/dist/lib/services/ui-command-handler.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-command-handler.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/ui-command-handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAsC,MAAM,8BAA8B,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;;AAExD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAGa,uBAAuB;IAchC,OAAO,CAAC,gBAAgB;IAb1B;;;OAGG;IACI,0BAA0B,yCAAgD;IAEjF;;;OAGG;IACI,yBAAyB,iCAAwC;gBAG9D,gBAAgB,EAAE,gBAAgB;IAG5C;;;OAGG;IACU,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpI;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACU,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9E;;OAEG;IACU,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAclF;;;OAGG;YACW,iBAAiB;yCA7GpB,uBAAuB;6CAAvB,uBAAuB;CA8HnC"}
+{"version":3,"file":"ui-command-handler.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/ui-command-handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAKjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;;AAExD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;GAMG;AACH,qBAGa,uBAAuB;IAsChC,OAAO,CAAC,gBAAgB;IArC1B;;;;;;;;;OASG;IACI,0BAA0B,yCAAgD;IAEjF,0DAA0D;IAC1D,IAAW,0BAA0B,2CAEpC;IACD,0DAA0D;IAC1D,IAAW,0BAA0B,CAAC,KAAK,wCAAA,EAE1C;IAED;;;OAGG;IACI,yBAAyB,iCAAwC;IAExE,yDAAyD;IACzD,IAAW,yBAAyB,mCAEnC;IACD,yDAAyD;IACzD,IAAW,yBAAyB,CAAC,KAAK,gCAAA,EAEzC;gBAGS,gBAAgB,EAAE,gBAAgB;IAG5C;;;OAGG;IACU,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCpI,wDAAwD;IAC3C,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpI;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;;;;;;OAWG;YACW,aAAa;IAY3B;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACU,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9E,uDAAuD;IAC1C,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E;;OAEG;IACU,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAclF,wDAAwD;IAC3C,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF;;;OAGG;YACW,iBAAiB;yCArNpB,uBAAuB;6CAAvB,uBAAuB;CAsOnC"}

package/dist/lib/services/ui-command-handler.service.js

@@ -1,24 +1,48 @@
 import { Injectable, EventEmitter } from '@angular/core';
+import { BuildMailtoURL } from '@memberjunction/ai-core-plus';
 import * as i0 from "@angular/core";
 import * as i1 from "./data-cache.service";
 /**
  * Service for handling UI commands from agents.
  *
- * Generic commands (open:url) are handled directly by this service.
- * App-specific commands (open:resource) are emitted for the host application to handle.
+ * Generic commands (open:url, and compose:email while it fits in a mailto: URL) are handled
+ * directly by this service. App-specific commands (open:resource, and the compose:email
+ * over-length fallback) are emitted for the host application to handle.
  */
 export class UICommandHandlerService {
     dataCacheService;
     /**
      * Event emitted when an actionable command requires host-app handling.
-     * Currently only open:resource commands are emitted — open:url is handled directly.
+     *
+     * open:resource is always emitted. compose:email is emitted ONLY as a fallback, when the draft
+     * is too long for a mailto: URL and the host must open the draft artifact instead; a draft
+     * within the limit is handled here and never reaches the host. On that fallback the host also
+     * owns telling the user why their mail client did not open, because only the host knows whether
+     * a draft artifact opened (see {@link ActionableCommandRequest.DraftCopiedToClipboard}).
+     * open:url is always handled here.
      */
-    actionableCommandRequested = new EventEmitter();
+    ActionableCommandRequested = new EventEmitter();
+    /** @deprecated Use {@link ActionableCommandRequested}. */
+    get actionableCommandRequested() {
+        return this.ActionableCommandRequested;
+    }
+    /** @deprecated Use {@link ActionableCommandRequested}. */
+    set actionableCommandRequested(value) {
+        this.ActionableCommandRequested = value;
+    }
     /**
      * Event emitted when an automatic command should be executed
      * Host application should subscribe to this and handle the command appropriately
      */
-    automaticCommandRequested = new EventEmitter();
+    AutomaticCommandRequested = new EventEmitter();
+    /** @deprecated Use {@link AutomaticCommandRequested}. */
+    get automaticCommandRequested() {
+        return this.AutomaticCommandRequested;
+    }
+    /** @deprecated Use {@link AutomaticCommandRequested}. */
+    set automaticCommandRequested(value) {
+        this.AutomaticCommandRequested = value;
+    }
     constructor(dataCacheService) {
         this.dataCacheService = dataCacheService;
     }
@@ -26,19 +50,43 @@ export class UICommandHandlerService {
      * Execute an actionable command (triggered by user clicking a button).
      * Generic commands like open:url are handled directly; others are emitted to the host.
      */
-    async executeActionableCommand(command, origin) {
+    async ExecuteActionableCommand(command, origin) {
         if (command.type === 'open:url') {
             this.handleOpenUrl(command);
+            return;
+        }
+        const request = {
+            command,
+            conversationId: origin?.conversationId ?? null,
+            conversationDetailId: origin?.conversationDetailId ?? null
+        };
+        if (command.type === 'compose:email') {
+            const { url, withinLimit } = BuildMailtoURL(command);
+            if (withinLimit) {
+                this.openMailto(url);
+                return;
+            }
+            // Too long for a mailto: URL. We do NOT open it: a mail client past its limit does not
+            // refuse the URL, it opens a draft with the body SILENTLY TRUNCATED and the user sends half
+            // a message without noticing. Falls through to the host, which opens the full draft
+            // artifact and tells the user what happened.
+            request.DraftCopiedToClipboard = await this.copyDraftBody(command);
+        }
+        // open:resource (and the compose:email fallback above) require app-specific navigation.
+        // compose:email is logged by TYPE ONLY: its body is free-text member correspondence, and the
+        // whole command object would otherwise land in the browser console and any console-forwarding
+        // telemetry.
+        if (command.type === 'compose:email') {
+            console.log('📤 Emitting actionable command for host app:', command.type);
         }
         else {
-            // open:resource requires app-specific navigation — emit for host to handle
             console.log('📤 Emitting actionable command for host app:', command);
-            this.actionableCommandRequested.emit({
-                command,
-                conversationId: origin?.conversationId ?? null,
-                conversationDetailId: origin?.conversationDetailId ?? null
-            });
         }
+        this.ActionableCommandRequested.emit(request);
+    }
+    /** @deprecated Use {@link ExecuteActionableCommand}. */
+    async executeActionableCommand(command, origin) {
+        return this.ExecuteActionableCommand(command, origin);
     }
     /**
      * Handle open:url commands directly by opening the URL in a browser tab.
@@ -55,6 +103,47 @@ export class UICommandHandlerService {
             window.open(url, target, target === '_blank' ? 'noopener,noreferrer' : undefined);
         }
     }
+    /**
+     * Best-effort copy of an over-length draft's body, so the text is not lost even when the host
+     * cannot open the draft artifact.
+     *
+     * Never rejects, so a clipboard that is unavailable (plain HTTP) or denied by permissions policy
+     * cannot stop the fallback. Nothing on the click path awaits before writeText is called, so it
+     * still runs inside the click's user activation; the fallback then awaits the outcome only so
+     * the host's notice can say whether the copy happened.
+     *
+     * @returns true only when the body is on the clipboard, so the host never claims a copy that
+     *          did not happen.
+     */
+    async copyDraftBody(command) {
+        if (!command.body || !navigator.clipboard) {
+            return false;
+        }
+        try {
+            await navigator.clipboard.writeText(command.body);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Open the user's own mail client with a compose:email draft's fields pre-filled, via a
+     * synthesized anchor click.
+     *
+     * NOTHING IS SENT HERE. The agent drafted; the user sends. This only opens a compose window.
+     *
+     * Deliberately not window.open: Chrome treats window.open with a non-http scheme as a popup and
+     * strands an about:blank tab behind the compose window.
+     */
+    openMailto(url) {
+        const a = document.createElement('a');
+        a.href = url;
+        a.style.display = 'none';
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+    }
     /**
      * Open a data URI by converting it to a Blob URL.
      * Chrome blocks window.open('data:...') for security, so we create a Blob URL instead.
@@ -76,7 +165,7 @@ export class UICommandHandlerService {
      * Execute an automatic command (runs immediately without user interaction)
      * Special handling: refresh:data commands execute locally, others emit to host
      */
-    async executeAutomaticCommand(command) {
+    async ExecuteAutomaticCommand(command) {
         console.log('Executing automatic command:', command);
         if (command.type === 'refresh:data') {
             // Handle data refresh locally as it's a generic operation
@@ -85,25 +174,33 @@ export class UICommandHandlerService {
         else {
             // Emit other automatic commands (like notifications) for host to handle
             console.log('📤 Emitting automatic command for host app:', command);
-            this.automaticCommandRequested.emit(command);
+            this.AutomaticCommandRequested.emit(command);
         }
     }
+    /** @deprecated Use {@link ExecuteAutomaticCommand}. */
+    async executeAutomaticCommand(command) {
+        return this.ExecuteAutomaticCommand(command);
+    }
     /**
      * Execute all automatic commands from an agent result
      */
-    async executeAutomaticCommands(commands) {
+    async ExecuteAutomaticCommands(commands) {
         if (!commands || commands.length === 0) {
             return;
         }
         for (const command of commands) {
             try {
-                await this.executeAutomaticCommand(command);
+                await this.ExecuteAutomaticCommand(command);
             }
             catch (error) {
                 console.error('Error executing automatic command:', command, error);
             }
         }
     }
+    /** @deprecated Use {@link ExecuteAutomaticCommands}. */
+    async executeAutomaticCommands(commands) {
+        return this.ExecuteAutomaticCommands(commands);
+    }
     /**
      * Handle refreshing data (entity data or caches)
      * This is handled locally as it's a generic operation that doesn't require host app knowledge

package/dist/lib/services/ui-command-handler.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-command-handler.service.js","sourceRoot":"","sources":["../../../src/lib/services/ui-command-handler.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, EventEmitter } from '@angular/core';\nimport { ActionableCommand, AutomaticCommand, RefreshDataCommand, OpenURLCommand } from '@memberjunction/ai-core-plus';\nimport { DataCacheService } from './data-cache.service';\n\nexport interface ActionableCommandRequest {\n  command: ActionableCommand;\n  conversationId?: string | null;\n  conversationDetailId?: string | null;\n}\n\n/**\n * Service for handling UI commands from agents.\n *\n * Generic commands (open:url) are handled directly by this service.\n * App-specific commands (open:resource) are emitted for the host application to handle.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class UICommandHandlerService {\n  /**\n   * Event emitted when an actionable command requires host-app handling.\n   * Currently only open:resource commands are emitted — open:url is handled directly.\n   */\n  public actionableCommandRequested = new EventEmitter<ActionableCommandRequest>();\n\n  /**\n   * Event emitted when an automatic command should be executed\n   * Host application should subscribe to this and handle the command appropriately\n   */\n  public automaticCommandRequested = new EventEmitter<AutomaticCommand>();\n\n  constructor(\n    private dataCacheService: DataCacheService\n  ) {}\n\n  /**\n   * Execute an actionable command (triggered by user clicking a button).\n   * Generic commands like open:url are handled directly; others are emitted to the host.\n   */\n  public async executeActionableCommand(command: ActionableCommand, origin?: Omit<ActionableCommandRequest, 'command'>): Promise<void> {\n    if (command.type === 'open:url') {\n      this.handleOpenUrl(command);\n    } else {\n      // open:resource requires app-specific navigation — emit for host to handle\n      console.log('📤 Emitting actionable command for host app:', command);\n      this.actionableCommandRequested.emit({\n        command,\n        conversationId: origin?.conversationId ?? null,\n        conversationDetailId: origin?.conversationDetailId ?? null\n      });\n    }\n  }\n\n  /**\n   * Handle open:url commands directly by opening the URL in a browser tab.\n   * Data URIs are converted to Blob URLs because Chrome blocks window.open with data: URIs.\n   */\n  private handleOpenUrl(command: OpenURLCommand): void {\n    const url = command.url;\n    const newTab = command.newTab !== false;\n\n    if (url.startsWith('data:')) {\n      this.openDataUri(url);\n    } else {\n      const target = newTab ? '_blank' : '_self';\n      window.open(url, target, target === '_blank' ? 'noopener,noreferrer' : undefined);\n    }\n  }\n\n  /**\n   * Open a data URI by converting it to a Blob URL.\n   * Chrome blocks window.open('data:...') for security, so we create a Blob URL instead.\n   */\n  private openDataUri(dataUri: string): void {\n    const [header, base64Data] = dataUri.split(',');\n    const mimeMatch = header.match(/data:([^;]+)/);\n    const mimeType = mimeMatch ? mimeMatch[1] : 'application/octet-stream';\n\n    const byteString = atob(base64Data);\n    const byteArray = new Uint8Array(byteString.length);\n    for (let i = 0; i < byteString.length; i++) {\n      byteArray[i] = byteString.charCodeAt(i);\n    }\n\n    const blob = new Blob([byteArray], { type: mimeType });\n    const blobUrl = URL.createObjectURL(blob);\n    window.open(blobUrl, '_blank');\n  }\n\n  /**\n   * Execute an automatic command (runs immediately without user interaction)\n   * Special handling: refresh:data commands execute locally, others emit to host\n   */\n  public async executeAutomaticCommand(command: AutomaticCommand): Promise<void> {\n    console.log('Executing automatic command:', command);\n\n    if (command.type === 'refresh:data') {\n      // Handle data refresh locally as it's a generic operation\n      await this.handleRefreshData(command);\n    } else {\n      // Emit other automatic commands (like notifications) for host to handle\n      console.log('📤 Emitting automatic command for host app:', command);\n      this.automaticCommandRequested.emit(command);\n    }\n  }\n\n  /**\n   * Execute all automatic commands from an agent result\n   */\n  public async executeAutomaticCommands(commands: AutomaticCommand[]): Promise<void> {\n    if (!commands || commands.length === 0) {\n      return;\n    }\n\n    for (const command of commands) {\n      try {\n        await this.executeAutomaticCommand(command);\n      } catch (error) {\n        console.error('Error executing automatic command:', command, error);\n      }\n    }\n  }\n\n  /**\n   * Handle refreshing data (entity data or caches)\n   * This is handled locally as it's a generic operation that doesn't require host app knowledge\n   */\n  private async handleRefreshData(command: RefreshDataCommand): Promise<void> {\n    const { scope, entityNames, cacheName } = command;\n\n    if (scope === 'entity' && entityNames && entityNames.length > 0) {\n      // Refresh specific entity data\n      for (const entityName of entityNames) {\n        await this.dataCacheService.refreshEntity(entityName);\n      }\n      console.log('Refreshed entity data:', entityNames);\n    } else if (scope === 'cache' && cacheName) {\n      // Refresh a specific cache\n      await this.dataCacheService.refreshCache(cacheName);\n      console.log('Refreshed cache:', cacheName);\n    } else {\n      console.warn('Invalid refresh:data command parameters:', command);\n    }\n  }\n}\n"]}
+{"version":3,"file":"ui-command-handler.service.js","sourceRoot":"","sources":["../../../src/lib/services/ui-command-handler.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, EventEmitter } from '@angular/core';\nimport {\n  ActionableCommand,\n  AutomaticCommand,\n  RefreshDataCommand,\n  OpenURLCommand,\n  ComposeEmailCommand,\n  BuildMailtoURL\n} from '@memberjunction/ai-core-plus';\nimport { DataCacheService } from './data-cache.service';\n\nexport interface ActionableCommandRequest {\n  command: ActionableCommand;\n  conversationId?: string | null;\n  conversationDetailId?: string | null;\n  /**\n   * Set only on the compose:email over-length fallback: whether the draft body is now on the\n   * user's clipboard. The copy overwrites whatever the user had copied, so the host must say it\n   * happened, and must not claim it when this is false (no body, clipboard unavailable over plain\n   * HTTP, or denied by permissions policy).\n   */\n  DraftCopiedToClipboard?: boolean;\n}\n\n/**\n * Service for handling UI commands from agents.\n *\n * Generic commands (open:url, and compose:email while it fits in a mailto: URL) are handled\n * directly by this service. App-specific commands (open:resource, and the compose:email\n * over-length fallback) are emitted for the host application to handle.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class UICommandHandlerService {\n  /**\n   * Event emitted when an actionable command requires host-app handling.\n   *\n   * open:resource is always emitted. compose:email is emitted ONLY as a fallback, when the draft\n   * is too long for a mailto: URL and the host must open the draft artifact instead; a draft\n   * within the limit is handled here and never reaches the host. On that fallback the host also\n   * owns telling the user why their mail client did not open, because only the host knows whether\n   * a draft artifact opened (see {@link ActionableCommandRequest.DraftCopiedToClipboard}).\n   * open:url is always handled here.\n   */\n  public ActionableCommandRequested = new EventEmitter<ActionableCommandRequest>();\n\n  /** @deprecated Use {@link ActionableCommandRequested}. */\n  public get actionableCommandRequested() {\n    return this.ActionableCommandRequested;\n  }\n  /** @deprecated Use {@link ActionableCommandRequested}. */\n  public set actionableCommandRequested(value) {\n    this.ActionableCommandRequested = value;\n  }\n\n  /**\n   * Event emitted when an automatic command should be executed\n   * Host application should subscribe to this and handle the command appropriately\n   */\n  public AutomaticCommandRequested = new EventEmitter<AutomaticCommand>();\n\n  /** @deprecated Use {@link AutomaticCommandRequested}. */\n  public get automaticCommandRequested() {\n    return this.AutomaticCommandRequested;\n  }\n  /** @deprecated Use {@link AutomaticCommandRequested}. */\n  public set automaticCommandRequested(value) {\n    this.AutomaticCommandRequested = value;\n  }\n\n  constructor(\n    private dataCacheService: DataCacheService\n  ) {}\n\n  /**\n   * Execute an actionable command (triggered by user clicking a button).\n   * Generic commands like open:url are handled directly; others are emitted to the host.\n   */\n  public async ExecuteActionableCommand(command: ActionableCommand, origin?: Omit<ActionableCommandRequest, 'command'>): Promise<void> {\n    if (command.type === 'open:url') {\n      this.handleOpenUrl(command);\n      return;\n    }\n\n    const request: ActionableCommandRequest = {\n      command,\n      conversationId: origin?.conversationId ?? null,\n      conversationDetailId: origin?.conversationDetailId ?? null\n    };\n\n    if (command.type === 'compose:email') {\n      const { url, withinLimit } = BuildMailtoURL(command);\n      if (withinLimit) {\n        this.openMailto(url);\n        return;\n      }\n      // Too long for a mailto: URL. We do NOT open it: a mail client past its limit does not\n      // refuse the URL, it opens a draft with the body SILENTLY TRUNCATED and the user sends half\n      // a message without noticing. Falls through to the host, which opens the full draft\n      // artifact and tells the user what happened.\n      request.DraftCopiedToClipboard = await this.copyDraftBody(command);\n    }\n\n    // open:resource (and the compose:email fallback above) require app-specific navigation.\n    // compose:email is logged by TYPE ONLY: its body is free-text member correspondence, and the\n    // whole command object would otherwise land in the browser console and any console-forwarding\n    // telemetry.\n    if (command.type === 'compose:email') {\n      console.log('📤 Emitting actionable command for host app:', command.type);\n    } else {\n      console.log('📤 Emitting actionable command for host app:', command);\n    }\n    this.ActionableCommandRequested.emit(request);\n  }\n\n  /** @deprecated Use {@link ExecuteActionableCommand}. */\n  public async executeActionableCommand(command: ActionableCommand, origin?: Omit<ActionableCommandRequest, 'command'>): Promise<void> {\n    return this.ExecuteActionableCommand(command, origin);\n  }\n\n  /**\n   * Handle open:url commands directly by opening the URL in a browser tab.\n   * Data URIs are converted to Blob URLs because Chrome blocks window.open with data: URIs.\n   */\n  private handleOpenUrl(command: OpenURLCommand): void {\n    const url = command.url;\n    const newTab = command.newTab !== false;\n\n    if (url.startsWith('data:')) {\n      this.openDataUri(url);\n    } else {\n      const target = newTab ? '_blank' : '_self';\n      window.open(url, target, target === '_blank' ? 'noopener,noreferrer' : undefined);\n    }\n  }\n\n  /**\n   * Best-effort copy of an over-length draft's body, so the text is not lost even when the host\n   * cannot open the draft artifact.\n   *\n   * Never rejects, so a clipboard that is unavailable (plain HTTP) or denied by permissions policy\n   * cannot stop the fallback. Nothing on the click path awaits before writeText is called, so it\n   * still runs inside the click's user activation; the fallback then awaits the outcome only so\n   * the host's notice can say whether the copy happened.\n   *\n   * @returns true only when the body is on the clipboard, so the host never claims a copy that\n   *          did not happen.\n   */\n  private async copyDraftBody(command: ComposeEmailCommand): Promise<boolean> {\n    if (!command.body || !navigator.clipboard) {\n      return false;\n    }\n    try {\n      await navigator.clipboard.writeText(command.body);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Open the user's own mail client with a compose:email draft's fields pre-filled, via a\n   * synthesized anchor click.\n   *\n   * NOTHING IS SENT HERE. The agent drafted; the user sends. This only opens a compose window.\n   *\n   * Deliberately not window.open: Chrome treats window.open with a non-http scheme as a popup and\n   * strands an about:blank tab behind the compose window.\n   */\n  private openMailto(url: string): void {\n    const a = document.createElement('a');\n    a.href = url;\n    a.style.display = 'none';\n    document.body.appendChild(a);\n    a.click();\n    document.body.removeChild(a);\n  }\n\n  /**\n   * Open a data URI by converting it to a Blob URL.\n   * Chrome blocks window.open('data:...') for security, so we create a Blob URL instead.\n   */\n  private openDataUri(dataUri: string): void {\n    const [header, base64Data] = dataUri.split(',');\n    const mimeMatch = header.match(/data:([^;]+)/);\n    const mimeType = mimeMatch ? mimeMatch[1] : 'application/octet-stream';\n\n    const byteString = atob(base64Data);\n    const byteArray = new Uint8Array(byteString.length);\n    for (let i = 0; i < byteString.length; i++) {\n      byteArray[i] = byteString.charCodeAt(i);\n    }\n\n    const blob = new Blob([byteArray], { type: mimeType });\n    const blobUrl = URL.createObjectURL(blob);\n    window.open(blobUrl, '_blank');\n  }\n\n  /**\n   * Execute an automatic command (runs immediately without user interaction)\n   * Special handling: refresh:data commands execute locally, others emit to host\n   */\n  public async ExecuteAutomaticCommand(command: AutomaticCommand): Promise<void> {\n    console.log('Executing automatic command:', command);\n\n    if (command.type === 'refresh:data') {\n      // Handle data refresh locally as it's a generic operation\n      await this.handleRefreshData(command);\n    } else {\n      // Emit other automatic commands (like notifications) for host to handle\n      console.log('📤 Emitting automatic command for host app:', command);\n      this.AutomaticCommandRequested.emit(command);\n    }\n  }\n\n  /** @deprecated Use {@link ExecuteAutomaticCommand}. */\n  public async executeAutomaticCommand(command: AutomaticCommand): Promise<void> {\n    return this.ExecuteAutomaticCommand(command);\n  }\n\n  /**\n   * Execute all automatic commands from an agent result\n   */\n  public async ExecuteAutomaticCommands(commands: AutomaticCommand[]): Promise<void> {\n    if (!commands || commands.length === 0) {\n      return;\n    }\n\n    for (const command of commands) {\n      try {\n        await this.ExecuteAutomaticCommand(command);\n      } catch (error) {\n        console.error('Error executing automatic command:', command, error);\n      }\n    }\n  }\n\n  /** @deprecated Use {@link ExecuteAutomaticCommands}. */\n  public async executeAutomaticCommands(commands: AutomaticCommand[]): Promise<void> {\n    return this.ExecuteAutomaticCommands(commands);\n  }\n\n  /**\n   * Handle refreshing data (entity data or caches)\n   * This is handled locally as it's a generic operation that doesn't require host app knowledge\n   */\n  private async handleRefreshData(command: RefreshDataCommand): Promise<void> {\n    const { scope, entityNames, cacheName } = command;\n\n    if (scope === 'entity' && entityNames && entityNames.length > 0) {\n      // Refresh specific entity data\n      for (const entityName of entityNames) {\n        await this.dataCacheService.refreshEntity(entityName);\n      }\n      console.log('Refreshed entity data:', entityNames);\n    } else if (scope === 'cache' && cacheName) {\n      // Refresh a specific cache\n      await this.dataCacheService.refreshCache(cacheName);\n      console.log('Refreshed cache:', cacheName);\n    } else {\n      console.warn('Invalid refresh:data command parameters:', command);\n    }\n  }\n}\n"]}

package/dist/lib/utils/agent-artifact-summary.d.ts

@@ -30,9 +30,9 @@ export interface AgentArtifactRow {
 export interface AgentArtifactSummary {
     artifactId: string;
     artifactName: string;
-    artifactType: string;
+    ArtifactType: string;
     /** Newest first, so `versions[0]` is the latest. */
-    versions: Array<{
+    Versions: Array<{
         versionId: string;
         versionNumber: number;
         versionName: string | null;

package/dist/lib/utils/agent-artifact-summary.js

@@ -33,12 +33,12 @@ export function GroupVersionsByArtifact(versions, artifactsById) {
             summary = {
                 artifactId: version.ArtifactID,
                 artifactName: artifact.Name,
-                artifactType: artifact.Type,
-                versions: []
+                ArtifactType: artifact.Type,
+                Versions: []
             };
             byArtifact.set(version.ArtifactID, summary);
         }
-        summary.versions.push({
+        summary.Versions.push({
             versionId: version.ID,
             versionNumber: version.VersionNumber,
             versionName: version.Name

package/dist/lib/utils/agent-artifact-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-artifact-summary.js","sourceRoot":"","sources":["../../../src/lib/utils/agent-artifact-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACnC,QAA4C,EAC5C,aAAoD;IAEpD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,6EAA6E;YAC7E,8EAA8E;YAC9E,wEAAwE;YACxE,SAAS;QACb,CAAC;QACD,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,GAAG;gBACN,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,QAAQ,EAAE,EAAE;aACf,CAAC;YACF,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,IAAI;SAC5B,CAAC,CAAC;IACP,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["/**\n * Grouping for the \"Prior Artifacts Created by This Agent\" block fed to the Check Sage Intent\n * prompt.\n *\n * PURE (no Angular, no entities, no provider) so the ordering contract below is unit-testable\n * without the service's DI — same reason `conversation-detail-window.ts` and `date-jump.ts`\n * live out here rather than on their consumers.\n */\n\n/** The version fields the grouping needs. Structural, so the RunView row type satisfies it. */\nexport interface AgentArtifactVersionRow {\n    ID: string;\n    ArtifactID: string;\n    VersionNumber: number;\n    Name: string | null;\n}\n\n/** The artifact fields the prompt prints. */\nexport interface AgentArtifactRow {\n    ID: string;\n    Name: string;\n    Type: string;\n}\n\n/**\n * One artifact an agent produced in this conversation, with its versions newest-first.\n *\n * Deliberately narrower than the array-scan shape it replaces, which also carried `runId`,\n * `artifactDescription`, `versionDescription` and `createdAt` — none of which the intent\n * prompt ever read. Dropping them is what lets the caller resolve this without joining back\n * to agent runs, turning a four-table reconstruction into two reads.\n */\nexport interface AgentArtifactSummary {\n    artifactId: string;\n    artifactName: string;\n    artifactType: string;\n    /** Newest first, so `versions[0]` is the latest. */\n    versions: Array<{ versionId: string; versionNumber: number; versionName: string | null }>;\n}\n\n/**\n * Folds versions into per-artifact summaries.\n *\n * NO SORT, and that is deliberate rather than an omission. The caller reads versions\n * `__mj_CreatedAt DESC`, so inserting in arrival order leaves each artifact's versions\n * newest-first AND leaves the Map ordered by whichever artifact was touched most recently —\n * which is exactly what the explicit sort in the array-scan version used to compute. The\n * assumption is load-bearing and invisible, so it is pinned by tests.\n *\n * @param versions - Artifact versions, newest first\n * @param artifactsById - The artifact rows behind those versions\n */\nexport function GroupVersionsByArtifact(\n    versions: readonly AgentArtifactVersionRow[],\n    artifactsById: ReadonlyMap<string, AgentArtifactRow>\n): AgentArtifactSummary[] {\n    const byArtifact = new Map<string, AgentArtifactSummary>();\n\n    for (const version of versions) {\n        const artifact = artifactsById.get(version.ArtifactID);\n        if (!artifact) {\n            // Mirrors the stored query's INNER JOIN semantics. A version can outlive the\n            // artifact row the caller can read; emitting a summary with an undefined name\n            // would put the string \"undefined\" straight into the classifier prompt.\n            continue;\n        }\n        let summary = byArtifact.get(version.ArtifactID);\n        if (!summary) {\n            summary = {\n                artifactId: version.ArtifactID,\n                artifactName: artifact.Name,\n                artifactType: artifact.Type,\n                versions: []\n            };\n            byArtifact.set(version.ArtifactID, summary);\n        }\n        summary.versions.push({\n            versionId: version.ID,\n            versionNumber: version.VersionNumber,\n            versionName: version.Name\n        });\n    }\n    return [...byArtifact.values()];\n}\n"]}
+{"version":3,"file":"agent-artifact-summary.js","sourceRoot":"","sources":["../../../src/lib/utils/agent-artifact-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACnC,QAA4C,EAC5C,aAAoD;IAEpD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,6EAA6E;YAC7E,8EAA8E;YAC9E,wEAAwE;YACxE,SAAS;QACb,CAAC;QACD,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,GAAG;gBACN,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,QAAQ,EAAE,EAAE;aACf,CAAC;YACF,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAClB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,IAAI;SAC5B,CAAC,CAAC;IACP,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["/**\n * Grouping for the \"Prior Artifacts Created by This Agent\" block fed to the Check Sage Intent\n * prompt.\n *\n * PURE (no Angular, no entities, no provider) so the ordering contract below is unit-testable\n * without the service's DI — same reason `conversation-detail-window.ts` and `date-jump.ts`\n * live out here rather than on their consumers.\n */\n\n/** The version fields the grouping needs. Structural, so the RunView row type satisfies it. */\nexport interface AgentArtifactVersionRow {\n    ID: string;\n    ArtifactID: string;\n    VersionNumber: number;\n    Name: string | null;\n}\n\n/** The artifact fields the prompt prints. */\nexport interface AgentArtifactRow {\n    ID: string;\n    Name: string;\n    Type: string;\n}\n\n/**\n * One artifact an agent produced in this conversation, with its versions newest-first.\n *\n * Deliberately narrower than the array-scan shape it replaces, which also carried `runId`,\n * `artifactDescription`, `versionDescription` and `createdAt` — none of which the intent\n * prompt ever read. Dropping them is what lets the caller resolve this without joining back\n * to agent runs, turning a four-table reconstruction into two reads.\n */\nexport interface AgentArtifactSummary {\n    artifactId: string;  // case-violation-ok-legacy-back-compat: the old name is also read off a value typed `any`, where a rename would compile and silently return undefined\n    artifactName: string;  // case-violation-ok-legacy-back-compat: the old name is also read off a value typed `any`, where a rename would compile and silently return undefined\n    ArtifactType: string;\n    /** Newest first, so `versions[0]` is the latest. */\n    Versions: Array<{ versionId: string; versionNumber: number; versionName: string | null }>;\n}\n\n/**\n * Folds versions into per-artifact summaries.\n *\n * NO SORT, and that is deliberate rather than an omission. The caller reads versions\n * `__mj_CreatedAt DESC`, so inserting in arrival order leaves each artifact's versions\n * newest-first AND leaves the Map ordered by whichever artifact was touched most recently —\n * which is exactly what the explicit sort in the array-scan version used to compute. The\n * assumption is load-bearing and invisible, so it is pinned by tests.\n *\n * @param versions - Artifact versions, newest first\n * @param artifactsById - The artifact rows behind those versions\n */\nexport function GroupVersionsByArtifact(\n    versions: readonly AgentArtifactVersionRow[],\n    artifactsById: ReadonlyMap<string, AgentArtifactRow>\n): AgentArtifactSummary[] {\n    const byArtifact = new Map<string, AgentArtifactSummary>();\n\n    for (const version of versions) {\n        const artifact = artifactsById.get(version.ArtifactID);\n        if (!artifact) {\n            // Mirrors the stored query's INNER JOIN semantics. A version can outlive the\n            // artifact row the caller can read; emitting a summary with an undefined name\n            // would put the string \"undefined\" straight into the classifier prompt.\n            continue;\n        }\n        let summary = byArtifact.get(version.ArtifactID);\n        if (!summary) {\n            summary = {\n                artifactId: version.ArtifactID,\n                artifactName: artifact.Name,\n                ArtifactType: artifact.Type,\n                Versions: []\n            };\n            byArtifact.set(version.ArtifactID, summary);\n        }\n        summary.Versions.push({\n            versionId: version.ID,\n            versionNumber: version.VersionNumber,\n            versionName: version.Name\n        });\n    }\n    return [...byArtifact.values()];\n}\n"]}

package/dist/lib/utils/agent-turn-routing.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Pure routing rules for an agent turn: which agent answers a message, and whether
+ * any does. Kept free of Angular and of I/O so the whole matrix (reply mode × mention × allowed
+ * list × route) is testable directly; `MessageInputComponent` supplies the candidates.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import type { AgentReplyMode, AgentTurnTarget } from '../models/agent-turn.model';
+/** The agent each route would use for one message, before the host's rules are applied. */
+export interface AgentTurnCandidates {
+    /** Agents the message tags, in the order they appear. */
+    MentionedAgentIds: readonly string[];
+    /** The last agent that answered in the conversation, other than the conversation manager. */
+    ContinuityAgentId: string | null;
+    /**
+     * True when a routing decision put `ContinuityAgentId` there in place of the last agent that
+     * answered. The turn is then labelled `DecisionRouted` instead of `Continuity`.
+     */
+    ContinuityDecisionRouted?: boolean;
+    /** The agent pinned on the conversation. */
+    ConversationDefaultAgentId: string | null;
+    /** The host's `DefaultAgentId` input. */
+    HostDefaultAgentId: string | null;
+    /** MJ's conversation manager agent. */
+    ConversationManagerAgentId: string | null;
+}
+/** The host's rules for the chat. */
+export interface AgentTurnRules {
+    /** When a message starts a turn. */
+    ReplyMode: AgentReplyMode;
+    /** The agents that may answer. Null allows every agent. */
+    AllowedAgentIDs: readonly string[] | null;
+}
+/**
+ * Picks the agent and route for one message, or null when no turn starts.
+ *
+ * The order is MJ's: the first tagged agent the host allows, then (under `Always` only) the last
+ * agent that answered, the conversation's pinned agent, the host's default agent, and the
+ * conversation manager. A candidate the host doesn't allow is skipped. A continuity candidate that
+ * a routing decision chose (`ContinuityDecisionRouted`) takes the `DecisionRouted` label.
+ *
+ * A continuity or default candidate that `isKnownAgent` doesn't recognise falls back to the
+ * conversation manager, as MJ always has, rather than to the next route. A tagged agent is taken
+ * as tagged.
+ *
+ * @param candidates The agent each route would use.
+ * @param rules The host's reply mode and allowed list.
+ * @param isKnownAgent True when the agent exists in the client's agent catalog.
+ */
+export declare function ResolveAgentTurn(candidates: AgentTurnCandidates, rules: AgentTurnRules, isKnownAgent: (agentId: string) => boolean): AgentTurnTarget | null;
+/** A task-graph step that runs an agent, as the conversation manager emits it. */
+interface AgentTaskStep {
+    kind: string;
+    configuration?: {
+        agentName?: string;
+    } | object;
+}
+/**
+ * The agent names in a task graph that the host doesn't allow. The conversation manager can
+ * answer with a multi-step workflow instead of a single delegation; each `Agent` step names the
+ * agent that runs it, so the allowed list has to hold there too.
+ *
+ * @param steps The graph's tasks.
+ * @param allowedAgentIDs The host's allowed list. Null allows every agent.
+ * @param resolveAgentId Maps an agent name to its ID, or null when no such agent exists.
+ * @returns The disallowed names, each once, in the order they appear. Empty when all are allowed.
+ */
+export declare function FindDisallowedTaskGraphAgents(steps: ReadonlyArray<AgentTaskStep>, allowedAgentIDs: readonly string[] | null, resolveAgentId: (agentName: string) => string | null): string[];
+export {};
+//# sourceMappingURL=agent-turn-routing.d.ts.map

package/dist/lib/utils/agent-turn-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-turn-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/agent-turn-routing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAkB,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElG,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAChC,yDAAyD;IACzD,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4CAA4C;IAC5C,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uCAAuC;IACvC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC3B,oCAAoC;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,2DAA2D;IAC3D,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC5B,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAC3C,eAAe,GAAG,IAAI,CAsBxB;AAUD,kFAAkF;AAClF,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,EACnC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,EACzC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACrD,MAAM,EAAE,CAYV"}

package/dist/lib/utils/agent-turn-routing.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Pure routing rules for an agent turn: which agent answers a message, and whether
+ * any does. Kept free of Angular and of I/O so the whole matrix (reply mode × mention × allowed
+ * list × route) is testable directly; `MessageInputComponent` supplies the candidates.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { IsAgentAllowed } from '@memberjunction/ai-core-plus';
+/**
+ * Picks the agent and route for one message, or null when no turn starts.
+ *
+ * The order is MJ's: the first tagged agent the host allows, then (under `Always` only) the last
+ * agent that answered, the conversation's pinned agent, the host's default agent, and the
+ * conversation manager. A candidate the host doesn't allow is skipped. A continuity candidate that
+ * a routing decision chose (`ContinuityDecisionRouted`) takes the `DecisionRouted` label.
+ *
+ * A continuity or default candidate that `isKnownAgent` doesn't recognise falls back to the
+ * conversation manager, as MJ always has, rather than to the next route. A tagged agent is taken
+ * as tagged.
+ *
+ * @param candidates The agent each route would use.
+ * @param rules The host's reply mode and allowed list.
+ * @param isKnownAgent True when the agent exists in the client's agent catalog.
+ */
+export function ResolveAgentTurn(candidates, rules, isKnownAgent) {
+    const mentioned = candidates.MentionedAgentIds.find(id => IsAgentAllowed(id, rules.AllowedAgentIDs));
+    if (mentioned) {
+        return { AgentId: mentioned, Route: 'Mention' };
+    }
+    if (rules.ReplyMode === 'MentionOnly') {
+        return null;
+    }
+    const implicitRoutes = [
+        [candidates.ContinuityDecisionRouted ? 'DecisionRouted' : 'Continuity', candidates.ContinuityAgentId],
+        ['ConversationDefault', candidates.ConversationDefaultAgentId],
+        ['HostDefault', candidates.HostDefaultAgentId],
+    ];
+    for (const [route, agentId] of implicitRoutes) {
+        if (agentId && IsAgentAllowed(agentId, rules.AllowedAgentIDs)) {
+            return isKnownAgent(agentId)
+                ? { AgentId: agentId, Route: route }
+                : conversationManagerTarget(candidates, rules);
+        }
+    }
+    return conversationManagerTarget(candidates, rules);
+}
+/** The conversation manager's turn, when there is one and the host allows it. */
+function conversationManagerTarget(candidates, rules) {
+    const agentId = candidates.ConversationManagerAgentId;
+    return agentId && IsAgentAllowed(agentId, rules.AllowedAgentIDs)
+        ? { AgentId: agentId, Route: 'ConversationManager' }
+        : null;
+}
+/**
+ * The agent names in a task graph that the host doesn't allow. The conversation manager can
+ * answer with a multi-step workflow instead of a single delegation; each `Agent` step names the
+ * agent that runs it, so the allowed list has to hold there too.
+ *
+ * @param steps The graph's tasks.
+ * @param allowedAgentIDs The host's allowed list. Null allows every agent.
+ * @param resolveAgentId Maps an agent name to its ID, or null when no such agent exists.
+ * @returns The disallowed names, each once, in the order they appear. Empty when all are allowed.
+ */
+export function FindDisallowedTaskGraphAgents(steps, allowedAgentIDs, resolveAgentId) {
+    if (allowedAgentIDs == null) {
+        return [];
+    }
+    const disallowed = [];
+    for (const step of steps) {
+        const agentName = step.kind === 'Agent' ? agentNameOf(step.configuration) : null;
+        if (agentName && !IsAgentAllowed(resolveAgentId(agentName), allowedAgentIDs) && !disallowed.includes(agentName)) {
+            disallowed.push(agentName);
+        }
+    }
+    return disallowed;
+}
+/** The `agentName` of an Agent step's configuration, when it has one. */
+function agentNameOf(configuration) {
+    if (configuration && 'agentName' in configuration && typeof configuration.agentName === 'string') {
+        return configuration.agentName;
+    }
+    return null;
+}
+//# sourceMappingURL=agent-turn-routing.js.map

package/dist/lib/utils/agent-turn-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-turn-routing.js","sourceRoot":"","sources":["../../../src/lib/utils/agent-turn-routing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure routing rules for an agent turn: which agent answers a message, and whether\n * any does. Kept free of Angular and of I/O so the whole matrix (reply mode × mention × allowed\n * list × route) is testable directly; `MessageInputComponent` supplies the candidates.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport { IsAgentAllowed } from '@memberjunction/ai-core-plus';\nimport type { AgentReplyMode, AgentTurnRoute, AgentTurnTarget } from '../models/agent-turn.model';\n\n/** The agent each route would use for one message, before the host's rules are applied. */\nexport interface AgentTurnCandidates {\n    /** Agents the message tags, in the order they appear. */\n    MentionedAgentIds: readonly string[];\n    /** The last agent that answered in the conversation, other than the conversation manager. */\n    ContinuityAgentId: string | null;\n    /**\n     * True when a routing decision put `ContinuityAgentId` there in place of the last agent that\n     * answered. The turn is then labelled `DecisionRouted` instead of `Continuity`.\n     */\n    ContinuityDecisionRouted?: boolean;\n    /** The agent pinned on the conversation. */\n    ConversationDefaultAgentId: string | null;\n    /** The host's `DefaultAgentId` input. */\n    HostDefaultAgentId: string | null;\n    /** MJ's conversation manager agent. */\n    ConversationManagerAgentId: string | null;\n}\n\n/** The host's rules for the chat. */\nexport interface AgentTurnRules {\n    /** When a message starts a turn. */\n    ReplyMode: AgentReplyMode;\n    /** The agents that may answer. Null allows every agent. */\n    AllowedAgentIDs: readonly string[] | null;\n}\n\n/**\n * Picks the agent and route for one message, or null when no turn starts.\n *\n * The order is MJ's: the first tagged agent the host allows, then (under `Always` only) the last\n * agent that answered, the conversation's pinned agent, the host's default agent, and the\n * conversation manager. A candidate the host doesn't allow is skipped. A continuity candidate that\n * a routing decision chose (`ContinuityDecisionRouted`) takes the `DecisionRouted` label.\n *\n * A continuity or default candidate that `isKnownAgent` doesn't recognise falls back to the\n * conversation manager, as MJ always has, rather than to the next route. A tagged agent is taken\n * as tagged.\n *\n * @param candidates The agent each route would use.\n * @param rules The host's reply mode and allowed list.\n * @param isKnownAgent True when the agent exists in the client's agent catalog.\n */\nexport function ResolveAgentTurn(\n    candidates: AgentTurnCandidates,\n    rules: AgentTurnRules,\n    isKnownAgent: (agentId: string) => boolean\n): AgentTurnTarget | null {\n    const mentioned = candidates.MentionedAgentIds.find(id => IsAgentAllowed(id, rules.AllowedAgentIDs));\n    if (mentioned) {\n        return { AgentId: mentioned, Route: 'Mention' };\n    }\n    if (rules.ReplyMode === 'MentionOnly') {\n        return null;\n    }\n\n    const implicitRoutes: ReadonlyArray<[AgentTurnRoute, string | null]> = [\n        [candidates.ContinuityDecisionRouted ? 'DecisionRouted' : 'Continuity', candidates.ContinuityAgentId],\n        ['ConversationDefault', candidates.ConversationDefaultAgentId],\n        ['HostDefault', candidates.HostDefaultAgentId],\n    ];\n    for (const [route, agentId] of implicitRoutes) {\n        if (agentId && IsAgentAllowed(agentId, rules.AllowedAgentIDs)) {\n            return isKnownAgent(agentId)\n                ? { AgentId: agentId, Route: route }\n                : conversationManagerTarget(candidates, rules);\n        }\n    }\n    return conversationManagerTarget(candidates, rules);\n}\n\n/** The conversation manager's turn, when there is one and the host allows it. */\nfunction conversationManagerTarget(candidates: AgentTurnCandidates, rules: AgentTurnRules): AgentTurnTarget | null {\n    const agentId = candidates.ConversationManagerAgentId;\n    return agentId && IsAgentAllowed(agentId, rules.AllowedAgentIDs)\n        ? { AgentId: agentId, Route: 'ConversationManager' }\n        : null;\n}\n\n/** A task-graph step that runs an agent, as the conversation manager emits it. */\ninterface AgentTaskStep {\n    kind: string;\n    configuration?: { agentName?: string } | object;\n}\n\n/**\n * The agent names in a task graph that the host doesn't allow. The conversation manager can\n * answer with a multi-step workflow instead of a single delegation; each `Agent` step names the\n * agent that runs it, so the allowed list has to hold there too.\n *\n * @param steps The graph's tasks.\n * @param allowedAgentIDs The host's allowed list. Null allows every agent.\n * @param resolveAgentId Maps an agent name to its ID, or null when no such agent exists.\n * @returns The disallowed names, each once, in the order they appear. Empty when all are allowed.\n */\nexport function FindDisallowedTaskGraphAgents(\n    steps: ReadonlyArray<AgentTaskStep>,\n    allowedAgentIDs: readonly string[] | null,\n    resolveAgentId: (agentName: string) => string | null\n): string[] {\n    if (allowedAgentIDs == null) {\n        return [];\n    }\n    const disallowed: string[] = [];\n    for (const step of steps) {\n        const agentName = step.kind === 'Agent' ? agentNameOf(step.configuration) : null;\n        if (agentName && !IsAgentAllowed(resolveAgentId(agentName), allowedAgentIDs) && !disallowed.includes(agentName)) {\n            disallowed.push(agentName);\n        }\n    }\n    return disallowed;\n}\n\n/** The `agentName` of an Agent step's configuration, when it has one. */\nfunction agentNameOf(configuration: AgentTaskStep['configuration']): string | null {\n    if (configuration && 'agentName' in configuration && typeof configuration.agentName === 'string') {\n        return configuration.agentName;\n    }\n    return null;\n}\n"]}