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

package/dist/lib/services/conversation-liveness-dom.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-liveness-dom.service.js","sourceRoot":"","sources":["../../../src/lib/services/conversation-liveness-dom.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;;AAE7E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,OAAO,8BAA8B;IACvC;;;;;OAKG;IACK,sBAAsB,GAAwB,IAAI,CAAC;IACnD,kBAAkB,GAAwB,IAAI,CAAC;IAC/C,OAAO,GAAG,KAAK,CAAC;IAExB,sEAAsE;IAC/D,KAAK;QACR,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACnF,OAAO;QACX,CAAC;QAED,IAAI,CAAC,sBAAsB,GAAG,GAAG,EAAE;YAC/B,oFAAoF;YACpF,4DAA4D;YAC5D,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACnB,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9D,CAAC;QACL,CAAC,CAAC;QACF,IAAI,CAAC,kBAAkB,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QAE7F,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3E,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,8DAA8D;IACvD,IAAI;QACP,IAAI,IAAI,CAAC,sBAAsB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACjE,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC9E,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC9D,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAEM,WAAW;QACd,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;wHA9CQ,8BAA8B;gEAA9B,8BAA8B,WAA9B,8BAA8B,mBADjB,MAAM;;iFACnB,8BAA8B;cAD1C,UAAU;eAAC,EAAE,UAAU,EAAE,MAAM,EAAE","sourcesContent":["import { Injectable, OnDestroy } from '@angular/core';\nimport { ConversationsRuntime } from '@memberjunction/conversations-runtime';\n\n/**\n * Translates browser events into liveness signals for the framework-agnostic\n * `ConversationLiveness` supervisor in `@memberjunction/conversations-runtime` (MJ #4222).\n *\n * WHY THE SPLIT. The supervisor lives at L0 because that package already depends on\n * `@memberjunction/graphql-dataprovider` and has no Angular dependency — and because the\n * obvious alternative is closed to us: Explorer's `ServerConnectivityService` does almost\n * exactly this, but `@memberjunction/ng-conversations` declares `\"mjUILayer\": \"widgets\"`, and\n * `packages/Standards/src/checks/ui-layers.ts` forbids that layer from importing any\n * `ng-explorer*` package at severity `error`. L0 cannot own the DOM half either: the runtime is\n * documented as Node-consumable, so `document` and `window` may not exist there. Hence this thin\n * Angular-side adapter, which is the only piece that touches the DOM.\n *\n * WHAT THE SIGNALS MEAN. Neither event proves anything is reachable — `navigator.onLine` reads\n * true behind a captive portal or a dead VPN, and a tab regaining focus says nothing about the\n * server. They are prompts to re-check, and the supervisor coalesces them with the transport-level\n * signals before anyone acts.\n *\n * Root-provided so one instance serves every chat area; several open conversations must not each\n * raise their own reconciliation for the same lid-open.\n */\n@Injectable({ providedIn: 'root' })\nexport class ConversationLivenessDomService implements OnDestroy {\n    /**\n     * Stored bound references — `removeEventListener` only detaches a listener when handed the\n     * same function object `addEventListener` received. Matches the pattern already used for the\n     * resize handlers in `conversation-chat-area.component.ts` and in\n     * `packages/Angular/Generic/shared/src/lib/theme.service.ts`.\n     */\n    private boundVisibilityHandler: (() => void) | null = null;\n    private boundOnlineHandler: (() => void) | null = null;\n    private started = false;\n\n    /** Begin translating DOM events into liveness signals. Idempotent. */\n    public Start(): void {\n        if (this.started || typeof document === 'undefined' || typeof window === 'undefined') {\n            return;\n        }\n\n        this.boundVisibilityHandler = () => {\n            // Only the hidden → visible edge matters. A tab going away needs no reconciliation,\n            // and signalling on both edges would double every recovery.\n            if (!document.hidden) {\n                ConversationsRuntime.Instance.Liveness.NotifyTabVisible();\n            }\n        };\n        this.boundOnlineHandler = () => ConversationsRuntime.Instance.Liveness.NotifyBrowserOnline();\n\n        document.addEventListener('visibilitychange', this.boundVisibilityHandler);\n        window.addEventListener('online', this.boundOnlineHandler);\n        this.started = true;\n    }\n\n    /** Detach both listeners. Safe to call when never started. */\n    public Stop(): void {\n        if (this.boundVisibilityHandler && typeof document !== 'undefined') {\n            document.removeEventListener('visibilitychange', this.boundVisibilityHandler);\n            this.boundVisibilityHandler = null;\n        }\n        if (this.boundOnlineHandler && typeof window !== 'undefined') {\n            window.removeEventListener('online', this.boundOnlineHandler);\n            this.boundOnlineHandler = null;\n        }\n        this.started = false;\n    }\n\n    public ngOnDestroy(): void {\n        this.Stop();\n    }\n}\n"]}

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

@@ -6,18 +6,32 @@ 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>;
     /** @deprecated Use {@link ActionableCommandRequested}. */
@@ -46,6 +60,29 @@ export declare class UICommandHandlerService {
      * 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.

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;IAgChC,OAAO,CAAC,gBAAgB;IA/B1B;;;OAGG;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;IAcpI,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;;;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;yCA9IpB,uBAAuB;6CAAvB,uBAAuB;CA+JnC"}
+{"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,17 +1,25 @@
 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();
     /** @deprecated Use {@link ActionableCommandRequested}. */
@@ -45,16 +53,36 @@ export class UICommandHandlerService {
     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) {
@@ -75,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.

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  /** @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    } 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  /** @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   * 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"]}
+{"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-turn-routing.d.ts

@@ -12,6 +12,11 @@ export interface AgentTurnCandidates {
     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. */
@@ -26,17 +31,13 @@ export interface AgentTurnRules {
     /** The agents that may answer. Null allows every agent. */
     AllowedAgentIDs: readonly string[] | null;
 }
-/**
- * True when the agent may take a turn. A null or undefined list allows every agent; an empty
- * list allows none.
- */
-export declare function IsAgentAllowed(agentId: string | null | undefined, allowedAgentIDs: readonly string[] | null | undefined): boolean;
 /**
  * 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.
+ * 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

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

@@ -1 +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,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;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GACtD,OAAO,CAQT;AAED;;;;;;;;;;;;;;GAcG;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"}
+{"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

@@ -5,26 +5,14 @@
  *
  * @module @memberjunction/ng-conversations
  */
-import { UUIDsEqual } from '@memberjunction/global';
-/**
- * True when the agent may take a turn. A null or undefined list allows every agent; an empty
- * list allows none.
- */
-export function IsAgentAllowed(agentId, allowedAgentIDs) {
-    if (!agentId) {
-        return false;
-    }
-    if (allowedAgentIDs == null) {
-        return true;
-    }
-    return allowedAgentIDs.some(id => UUIDsEqual(id, agentId));
-}
+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.
+ * 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
@@ -43,7 +31,7 @@ export function ResolveAgentTurn(candidates, rules, isKnownAgent) {
         return null;
     }
     const implicitRoutes = [
-        ['Continuity', candidates.ContinuityAgentId],
+        [candidates.ContinuityDecisionRouted ? 'DecisionRouted' : 'Continuity', candidates.ContinuityAgentId],
         ['ConversationDefault', candidates.ConversationDefaultAgentId],
         ['HostDefault', candidates.HostDefaultAgentId],
     ];

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

@@ -1 +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 { UUIDsEqual } from '@memberjunction/global';\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    /** 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 * True when the agent may take a turn. A null or undefined list allows every agent; an empty\n * list allows none.\n */\nexport function IsAgentAllowed(\n    agentId: string | null | undefined,\n    allowedAgentIDs: readonly string[] | null | undefined\n): boolean {\n    if (!agentId) {\n        return false;\n    }\n    if (allowedAgentIDs == null) {\n        return true;\n    }\n    return allowedAgentIDs.some(id => UUIDsEqual(id, agentId));\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.\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        ['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"]}
+{"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"]}

package/dist/lib/utils/decision-routing.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Decision routing for an unmentioned message (plan Tasks 3.9 and 3.2): one typed
+ * decision that may send the message to a different agent in the conversation than the last one
+ * that answered, and may name the artifact version the message modifies.
+ *
+ * It runs before {@link ResolveAgentTurn}, which stays pure. When the answer is confident, the
+ * caller replaces the continuity candidate with {@link ApplyRoutingDecision}; otherwise nothing
+ * changes. Every failure keeps today's routing. The chat turns it on with `EnableDecisionRouting`,
+ * which is off by default.
+ *
+ * The decision itself (its input, questions and state, and how its answers are read) is built in
+ * `@memberjunction/ai-core-plus` (`conversation-routing-decision.ts`), so the Decision Eval harness
+ * measures exactly what the chat sends. What stays here is the call and what the chat does with
+ * the outcome. Import the builders and their types from `@memberjunction/ai-core-plus` directly.
+ *
+ * Kept free of Angular so the whole path, with the decision call mocked, is testable directly;
+ * `MessageInputComponent` supplies the conversation and the call.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { type RoutingDecisionInput, type RoutingDecisionOutcome } from '@memberjunction/ai-core-plus';
+import type { RunDecisionParams, RunDecisionResult } from '@memberjunction/graphql-dataprovider';
+import type { AgentReplyMode } from '../models/agent-turn.model';
+import type { AgentTurnCandidates } from './agent-turn-routing';
+/** Runs a decision on the server: `ConversationAgentService.RunDecision` in the chat. */
+export type RoutingDecisionRunner = (params: RunDecisionParams) => Promise<RunDecisionResult>;
+/** What decides whether a message gets a routing decision at all. */
+export interface RoutingDecisionGate {
+    /** The chat's `EnableDecisionRouting` input. */
+    Enabled: boolean;
+    /** The chat's reply mode. */
+    ReplyMode: AgentReplyMode;
+    /** Agents the message tags. */
+    MentionedAgentIds: readonly string[];
+    /** The message, as saved. */
+    Message: string;
+    /** The last agent that answered, other than the conversation manager. */
+    ContinuityAgentId: string | null;
+}
+/**
+ * True when a message should get a routing decision: routing is on, the reply mode is `Always`,
+ * some agent has answered before, and the message tags no agent and is not a form response. A
+ * form response always goes back to the agent that asked for it. Every other message keeps
+ * today's routing, with no call.
+ */
+export declare function ShouldRunRoutingDecision(gate: RoutingDecisionGate): boolean;
+/**
+ * Asks one routing decision and reads its answer. It fails toward continuity: an error, no answer
+ * within `timeoutMs` (the call is abandoned), or an unsure answer keeps today's routing. Never
+ * throws.
+ *
+ * @param input What to decide. Check it with `CanAskRoutingDecision` first.
+ * @param runDecision Runs the decision on the server.
+ * @param timeoutMs How long to wait. Defaults to `DECISION_ROUTING_TIMEOUT_MS`.
+ */
+export declare function RunRoutingDecision(input: RoutingDecisionInput, runDecision: RoutingDecisionRunner, timeoutMs?: number): Promise<RoutingDecisionOutcome>;
+/**
+ * The candidates with the decision applied: a routed agent replaces continuity and is labelled
+ * `DecisionRouted`, and "someone else" clears continuity. Any other outcome, or none, leaves the
+ * candidates as they are.
+ */
+export declare function ApplyRoutingDecision(candidates: AgentTurnCandidates, outcome: RoutingDecisionOutcome | null): AgentTurnCandidates;
+/**
+ * The artifact version to hand a turn's agent: the decision's target, when it is one of that
+ * agent's versions. Null otherwise, including after a redirect to another agent.
+ */
+export declare function ArtifactVersionForTurn(outcome: RoutingDecisionOutcome | null, agentId: string): string | null;
+//# sourceMappingURL=decision-routing.d.ts.map

package/dist/lib/utils/decision-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/decision-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAOH,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9F,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAChC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,+BAA+B;IAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAM3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,qBAAqB,EAClC,SAAS,GAAE,MAAoC,GAChD,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,sBAAsB,GAAG,IAAI,GACvC,mBAAmB,CAQrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7G"}

package/dist/lib/utils/decision-routing.js

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Decision routing for an unmentioned message (plan Tasks 3.9 and 3.2): one typed
+ * decision that may send the message to a different agent in the conversation than the last one
+ * that answered, and may name the artifact version the message modifies.
+ *
+ * It runs before {@link ResolveAgentTurn}, which stays pure. When the answer is confident, the
+ * caller replaces the continuity candidate with {@link ApplyRoutingDecision}; otherwise nothing
+ * changes. Every failure keeps today's routing. The chat turns it on with `EnableDecisionRouting`,
+ * which is off by default.
+ *
+ * The decision itself (its input, questions and state, and how its answers are read) is built in
+ * `@memberjunction/ai-core-plus` (`conversation-routing-decision.ts`), so the Decision Eval harness
+ * measures exactly what the chat sends. What stays here is the call and what the chat does with
+ * the outcome. Import the builders and their types from `@memberjunction/ai-core-plus` directly.
+ *
+ * Kept free of Angular so the whole path, with the decision call mocked, is testable directly;
+ * `MessageInputComponent` supplies the conversation and the call.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { BuildRoutingQuestions, BuildRoutingState, ConversationUtility, DECISION_ROUTING_TIMEOUT_MS, InterpretRoutingAnswers, KeptContinuityOutcome } from '@memberjunction/ai-core-plus';
+import { UUIDsEqual } from '@memberjunction/global';
+/**
+ * True when a message should get a routing decision: routing is on, the reply mode is `Always`,
+ * some agent has answered before, and the message tags no agent and is not a form response. A
+ * form response always goes back to the agent that asked for it. Every other message keeps
+ * today's routing, with no call.
+ */
+export function ShouldRunRoutingDecision(gate) {
+    return gate.Enabled
+        && gate.ReplyMode === 'Always'
+        && !!gate.ContinuityAgentId
+        && gate.MentionedAgentIds.length === 0
+        && !ConversationUtility.ContainsFormResponse(gate.Message);
+}
+/**
+ * Asks one routing decision and reads its answer. It fails toward continuity: an error, no answer
+ * within `timeoutMs` (the call is abandoned), or an unsure answer keeps today's routing. Never
+ * throws.
+ *
+ * @param input What to decide. Check it with `CanAskRoutingDecision` first.
+ * @param runDecision Runs the decision on the server.
+ * @param timeoutMs How long to wait. Defaults to `DECISION_ROUTING_TIMEOUT_MS`.
+ */
+export async function RunRoutingDecision(input, runDecision, timeoutMs = DECISION_ROUTING_TIMEOUT_MS) {
+    const params = {
+        State: BuildRoutingState(input),
+        Questions: BuildRoutingQuestions(input),
+        TimeoutMS: timeoutMs
+    };
+    const result = await runWithDeadline(() => runDecision(params), timeoutMs);
+    return result
+        ? InterpretRoutingAnswers(input, result)
+        : KeptContinuityOutcome(`no answer within ${timeoutMs} ms`);
+}
+/**
+ * The candidates with the decision applied: a routed agent replaces continuity and is labelled
+ * `DecisionRouted`, and "someone else" clears continuity. Any other outcome, or none, leaves the
+ * candidates as they are.
+ */
+export function ApplyRoutingDecision(candidates, outcome) {
+    if (outcome?.Verdict === 'Routed' && outcome.RoutedAgentId) {
+        return { ...candidates, ContinuityAgentId: outcome.RoutedAgentId, ContinuityDecisionRouted: true };
+    }
+    if (outcome?.Verdict === 'SomeoneElse') {
+        return { ...candidates, ContinuityAgentId: null };
+    }
+    return candidates;
+}
+/**
+ * The artifact version to hand a turn's agent: the decision's target, when it is one of that
+ * agent's versions. Null otherwise, including after a redirect to another agent.
+ */
+export function ArtifactVersionForTurn(outcome, agentId) {
+    const target = outcome?.TargetArtifact;
+    return target && UUIDsEqual(target.AgentId, agentId) ? target.ArtifactVersionId : null;
+}
+/**
+ * Runs the call, or gives up on it after `timeoutMs`. Resolves with the result, a failed result
+ * when the call throws, or null when it didn't answer in time. A late answer is ignored.
+ */
+async function runWithDeadline(call, timeoutMs) {
+    let timer;
+    const deadline = new Promise(resolve => {
+        timer = setTimeout(() => resolve(null), timeoutMs);
+    });
+    const answer = Promise.resolve()
+        .then(call)
+        .catch((error) => ({
+        Success: false,
+        ErrorMessage: error instanceof Error ? error.message : String(error),
+        Answers: {}
+    }));
+    try {
+        return await Promise.race([answer, deadline]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=decision-routing.js.map

package/dist/lib/utils/decision-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-routing.js","sourceRoot":"","sources":["../../../src/lib/utils/decision-routing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Decision routing for an unmentioned message (plan Tasks 3.9 and 3.2): one typed\n * decision that may send the message to a different agent in the conversation than the last one\n * that answered, and may name the artifact version the message modifies.\n *\n * It runs before {@link ResolveAgentTurn}, which stays pure. When the answer is confident, the\n * caller replaces the continuity candidate with {@link ApplyRoutingDecision}; otherwise nothing\n * changes. Every failure keeps today's routing. The chat turns it on with `EnableDecisionRouting`,\n * which is off by default.\n *\n * The decision itself (its input, questions and state, and how its answers are read) is built in\n * `@memberjunction/ai-core-plus` (`conversation-routing-decision.ts`), so the Decision Eval harness\n * measures exactly what the chat sends. What stays here is the call and what the chat does with\n * the outcome. Import the builders and their types from `@memberjunction/ai-core-plus` directly.\n *\n * Kept free of Angular so the whole path, with the decision call mocked, is testable directly;\n * `MessageInputComponent` supplies the conversation and the call.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport {\n    BuildRoutingQuestions,\n    BuildRoutingState,\n    ConversationUtility,\n    DECISION_ROUTING_TIMEOUT_MS,\n    InterpretRoutingAnswers,\n    KeptContinuityOutcome,\n    type RoutingDecisionInput,\n    type RoutingDecisionOutcome\n} from '@memberjunction/ai-core-plus';\nimport type { RunDecisionParams, RunDecisionResult } from '@memberjunction/graphql-dataprovider';\nimport { UUIDsEqual } from '@memberjunction/global';\nimport type { AgentReplyMode } from '../models/agent-turn.model';\nimport type { AgentTurnCandidates } from './agent-turn-routing';\n\n/** Runs a decision on the server: `ConversationAgentService.RunDecision` in the chat. */\nexport type RoutingDecisionRunner = (params: RunDecisionParams) => Promise<RunDecisionResult>;\n\n/** What decides whether a message gets a routing decision at all. */\nexport interface RoutingDecisionGate {\n    /** The chat's `EnableDecisionRouting` input. */\n    Enabled: boolean;\n    /** The chat's reply mode. */\n    ReplyMode: AgentReplyMode;\n    /** Agents the message tags. */\n    MentionedAgentIds: readonly string[];\n    /** The message, as saved. */\n    Message: string;\n    /** The last agent that answered, other than the conversation manager. */\n    ContinuityAgentId: string | null;\n}\n\n/**\n * True when a message should get a routing decision: routing is on, the reply mode is `Always`,\n * some agent has answered before, and the message tags no agent and is not a form response. A\n * form response always goes back to the agent that asked for it. Every other message keeps\n * today's routing, with no call.\n */\nexport function ShouldRunRoutingDecision(gate: RoutingDecisionGate): boolean {\n    return gate.Enabled\n        && gate.ReplyMode === 'Always'\n        && !!gate.ContinuityAgentId\n        && gate.MentionedAgentIds.length === 0\n        && !ConversationUtility.ContainsFormResponse(gate.Message);\n}\n\n/**\n * Asks one routing decision and reads its answer. It fails toward continuity: an error, no answer\n * within `timeoutMs` (the call is abandoned), or an unsure answer keeps today's routing. Never\n * throws.\n *\n * @param input What to decide. Check it with `CanAskRoutingDecision` first.\n * @param runDecision Runs the decision on the server.\n * @param timeoutMs How long to wait. Defaults to `DECISION_ROUTING_TIMEOUT_MS`.\n */\nexport async function RunRoutingDecision(\n    input: RoutingDecisionInput,\n    runDecision: RoutingDecisionRunner,\n    timeoutMs: number = DECISION_ROUTING_TIMEOUT_MS\n): Promise<RoutingDecisionOutcome> {\n    const params: RunDecisionParams = {\n        State: BuildRoutingState(input),\n        Questions: BuildRoutingQuestions(input),\n        TimeoutMS: timeoutMs\n    };\n    const result = await runWithDeadline(() => runDecision(params), timeoutMs);\n    return result\n        ? InterpretRoutingAnswers(input, result)\n        : KeptContinuityOutcome(`no answer within ${timeoutMs} ms`);\n}\n\n/**\n * The candidates with the decision applied: a routed agent replaces continuity and is labelled\n * `DecisionRouted`, and \"someone else\" clears continuity. Any other outcome, or none, leaves the\n * candidates as they are.\n */\nexport function ApplyRoutingDecision(\n    candidates: AgentTurnCandidates,\n    outcome: RoutingDecisionOutcome | null\n): AgentTurnCandidates {\n    if (outcome?.Verdict === 'Routed' && outcome.RoutedAgentId) {\n        return { ...candidates, ContinuityAgentId: outcome.RoutedAgentId, ContinuityDecisionRouted: true };\n    }\n    if (outcome?.Verdict === 'SomeoneElse') {\n        return { ...candidates, ContinuityAgentId: null };\n    }\n    return candidates;\n}\n\n/**\n * The artifact version to hand a turn's agent: the decision's target, when it is one of that\n * agent's versions. Null otherwise, including after a redirect to another agent.\n */\nexport function ArtifactVersionForTurn(outcome: RoutingDecisionOutcome | null, agentId: string): string | null {\n    const target = outcome?.TargetArtifact;\n    return target && UUIDsEqual(target.AgentId, agentId) ? target.ArtifactVersionId : null;\n}\n\n/**\n * Runs the call, or gives up on it after `timeoutMs`. Resolves with the result, a failed result\n * when the call throws, or null when it didn't answer in time. A late answer is ignored.\n */\nasync function runWithDeadline(\n    call: () => Promise<RunDecisionResult>,\n    timeoutMs: number\n): Promise<RunDecisionResult | null> {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const deadline = new Promise<null>(resolve => {\n        timer = setTimeout(() => resolve(null), timeoutMs);\n    });\n    const answer = Promise.resolve()\n        .then(call)\n        .catch((error: unknown): RunDecisionResult => ({\n            Success: false,\n            ErrorMessage: error instanceof Error ? error.message : String(error),\n            Answers: {}\n        }));\n    try {\n        return await Promise.race([answer, deadline]);\n    } finally {\n        clearTimeout(timer);\n    }\n}\n"]}

package/dist/public-api.d.ts

@@ -5,9 +5,11 @@ export * from './lib/models/lazy-artifact-info';
 export * from './lib/models/navigation-request.model';
 export * from './lib/models/agent-turn.model';
 export * from './lib/utils/agent-turn-routing';
+export * from './lib/utils/decision-routing';
 export * from './lib/services/data-cache.service';
 export * from './lib/services/artifact-state.service';
 export * from './lib/services/agent-state.service';
+export * from './lib/services/conversation-liveness-dom.service';
 export * from './lib/services/conversation-agent.service';
 export * from './lib/services/active-tasks.service';
 export * from './lib/services/conversation-streaming.service';