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

package/dist/lib/directives/chat-slot.directive.d.ts

@@ -33,8 +33,12 @@ import * as i0 from "@angular/core";
  * ADDITIVE — it renders the projected template inside the DEFAULT header's
  * action strip, after the stock buttons. Projecting `header` suppresses
  * `headerActions` (the replacement owns the whole header, actions included).
+ *
+ * `composerExtra` is ADDITIVE too: host UI rendered directly above the composer (a
+ * "who will see this" line, a visibility toggle, a note about which agents answer here),
+ * wherever the chat area shows one — the new-conversation composer included.
  */
-export type MJChatSlotName = 'emptyState' | 'agentPresence' | 'header' | 'headerActions' | 'messageExtra' | 'demonstrationSurface' | 'messageRenderer';
+export type MJChatSlotName = 'emptyState' | 'agentPresence' | 'header' | 'headerActions' | 'composerExtra' | 'messageExtra' | 'demonstrationSurface' | 'messageRenderer';
 /**
  * Marks an `<ng-template>` as a slot fill for the chat-area.
  *

package/dist/lib/directives/chat-slot.directive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-slot.directive.d.ts","sourceRoot":"","sources":["../../../src/lib/directives/chat-slot.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAoB,WAAW,EAAE,MAAM,eAAe,CAAC;;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACpB,YAAY,GACZ,eAAe,GACf,QAAQ,GACR,eAAe,GACf,cAAc,GACd,sBAAsB,GACtB,iBAAiB,CAAC;AAExB;;;;;GAKG;AACH,qBAIa,iBAAiB;aAIE,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;IAH1D,sCAAsC;IACV,QAAQ,EAAG,cAAc,CAAC;gBAE1B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;yCAJjD,iBAAiB;2CAAjB,iBAAiB;CAK7B"}
+{"version":3,"file":"chat-slot.directive.d.ts","sourceRoot":"","sources":["../../../src/lib/directives/chat-slot.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAoB,WAAW,EAAE,MAAM,eAAe,CAAC;;AAE9D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GACpB,YAAY,GACZ,eAAe,GACf,QAAQ,GACR,eAAe,GACf,eAAe,GACf,cAAc,GACd,sBAAsB,GACtB,iBAAiB,CAAC;AAExB;;;;;GAKG;AACH,qBAIa,iBAAiB;aAIE,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;IAH1D,sCAAsC;IACV,QAAQ,EAAG,cAAc,CAAC;gBAE1B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;yCAJjD,iBAAiB;2CAAjB,iBAAiB;CAK7B"}

package/dist/lib/directives/chat-slot.directive.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-slot.directive.js","sourceRoot":"","sources":["../../../src/lib/directives/chat-slot.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAe,MAAM,eAAe,CAAC;;AAoB9D;;;;;GAKG;AAKH,MAAM,OAAO,iBAAiB;IAIE;IAH5B,sCAAsC;IACV,QAAQ,CAAkB;IAEtD,YAA4B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;IAAG,CAAC;2GAJrD,iBAAiB;6DAAjB,iBAAiB;;iFAAjB,iBAAiB;cAJ7B,SAAS;eAAC;gBACP,QAAQ,EAAE,cAAc;gBACxB,UAAU,EAAE,IAAI;aACnB;;kBAGI,KAAK;mBAAC,YAAY","sourcesContent":["/**\n * @fileoverview ChatSlotDirective — content-projection lookup for chat-area slots.\n *\n * Consumers project a template into a specific slot by attaching this directive:\n *\n * ```html\n * <mj-conversation-chat-area>\n *   <ng-template mjChatSlot=\"emptyState\">\n *     <warm-tutor-welcome />\n *   </ng-template>\n *\n *   <ng-template mjChatSlot=\"agentPresence\" let-state>\n *     <my-character-presence [State]=\"state\" />\n *   </ng-template>\n * </mj-conversation-chat-area>\n * ```\n *\n * The chat-area component queries `@ContentChildren(ChatSlotDirective)` and\n * looks up the `TemplateRef` for each known slot name. When a consumer template\n * is present for a slot, the component renders it via `*ngTemplateOutlet`\n * (with a typed context); when absent, the component falls back to its\n * exported standalone default component for that slot.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport { Directive, Input, TemplateRef } from '@angular/core';\n\n/**\n * Named slots the chat-area exposes. Keep in sync with the slot-interfaces module.\n *\n * Note the header pair: `header` REPLACES the entire chat header (the consumer\n * owns title, badges, and every action button), while `headerActions` is\n * ADDITIVE — it renders the projected template inside the DEFAULT header's\n * action strip, after the stock buttons. Projecting `header` suppresses\n * `headerActions` (the replacement owns the whole header, actions included).\n */\nexport type MJChatSlotName =\n    | 'emptyState'\n    | 'agentPresence'\n    | 'header'\n    | 'headerActions'\n    | 'messageExtra'\n    | 'demonstrationSurface'\n    | 'messageRenderer';\n\n/**\n * Marks an `<ng-template>` as a slot fill for the chat-area.\n *\n * Standalone — no module declaration required; consumers import it as part of\n * the conversations module's exports.\n */\n@Directive({\n    selector: '[mjChatSlot]',\n    standalone: true,\n})\nexport class ChatSlotDirective {\n    /** Which slot this template fills. */\n    @Input('mjChatSlot') public SlotName!: MJChatSlotName;\n\n    constructor(public readonly Template: TemplateRef<unknown>) {}\n}\n"]}
+{"version":3,"file":"chat-slot.directive.js","sourceRoot":"","sources":["../../../src/lib/directives/chat-slot.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAe,MAAM,eAAe,CAAC;;AAyB9D;;;;;GAKG;AAKH,MAAM,OAAO,iBAAiB;IAIE;IAH5B,sCAAsC;IACV,QAAQ,CAAkB;IAEtD,YAA4B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;IAAG,CAAC;2GAJrD,iBAAiB;6DAAjB,iBAAiB;;iFAAjB,iBAAiB;cAJ7B,SAAS;eAAC;gBACP,QAAQ,EAAE,cAAc;gBACxB,UAAU,EAAE,IAAI;aACnB;;kBAGI,KAAK;mBAAC,YAAY","sourcesContent":["/**\n * @fileoverview ChatSlotDirective — content-projection lookup for chat-area slots.\n *\n * Consumers project a template into a specific slot by attaching this directive:\n *\n * ```html\n * <mj-conversation-chat-area>\n *   <ng-template mjChatSlot=\"emptyState\">\n *     <warm-tutor-welcome />\n *   </ng-template>\n *\n *   <ng-template mjChatSlot=\"agentPresence\" let-state>\n *     <my-character-presence [State]=\"state\" />\n *   </ng-template>\n * </mj-conversation-chat-area>\n * ```\n *\n * The chat-area component queries `@ContentChildren(ChatSlotDirective)` and\n * looks up the `TemplateRef` for each known slot name. When a consumer template\n * is present for a slot, the component renders it via `*ngTemplateOutlet`\n * (with a typed context); when absent, the component falls back to its\n * exported standalone default component for that slot.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport { Directive, Input, TemplateRef } from '@angular/core';\n\n/**\n * Named slots the chat-area exposes. Keep in sync with the slot-interfaces module.\n *\n * Note the header pair: `header` REPLACES the entire chat header (the consumer\n * owns title, badges, and every action button), while `headerActions` is\n * ADDITIVE — it renders the projected template inside the DEFAULT header's\n * action strip, after the stock buttons. Projecting `header` suppresses\n * `headerActions` (the replacement owns the whole header, actions included).\n *\n * `composerExtra` is ADDITIVE too: host UI rendered directly above the composer (a\n * \"who will see this\" line, a visibility toggle, a note about which agents answer here),\n * wherever the chat area shows one — the new-conversation composer included.\n */\nexport type MJChatSlotName =\n    | 'emptyState'\n    | 'agentPresence'\n    | 'header'\n    | 'headerActions'\n    | 'composerExtra'\n    | 'messageExtra'\n    | 'demonstrationSurface'\n    | 'messageRenderer';\n\n/**\n * Marks an `<ng-template>` as a slot fill for the chat-area.\n *\n * Standalone — no module declaration required; consumers import it as part of\n * the conversations module's exports.\n */\n@Directive({\n    selector: '[mjChatSlot]',\n    standalone: true,\n})\nexport class ChatSlotDirective {\n    /** Which slot this template fills. */\n    @Input('mjChatSlot') public SlotName!: MJChatSlotName;\n\n    constructor(public readonly Template: TemplateRef<unknown>) {}\n}\n"]}

package/dist/lib/directives/search-shortcut.directive.d.ts

@@ -6,12 +6,20 @@ import * as i0 from "@angular/core";
  * <div mjSearchShortcut (searchTriggered)="openSearch()">
  */
 export declare class SearchShortcutDirective {
+    SearchTriggered: EventEmitter<void>;
+    /**
+     * @deprecated Use {@link SearchTriggered}.
+     *
+     * The same emitter under the old binding name, so a template still binding
+     * (searchTriggered) keeps working. Must stay AFTER SearchTriggered: class fields
+     * initialise in order, and the other way round this captures undefined.
+     */
     searchTriggered: EventEmitter<void>;
     /**
      * Listen for Ctrl+K or Cmd+K
      */
     handleKeyboardEvent(event: KeyboardEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SearchShortcutDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<SearchShortcutDirective, "[mjSearchShortcut]", never, {}, { "searchTriggered": "searchTriggered"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SearchShortcutDirective, "[mjSearchShortcut]", never, {}, { "SearchTriggered": "SearchTriggered"; "searchTriggered": "searchTriggered"; }, never, never, false, never>;
 }
 //# sourceMappingURL=search-shortcut.directive.d.ts.map

package/dist/lib/directives/search-shortcut.directive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-shortcut.directive.d.ts","sourceRoot":"","sources":["../../../src/lib/directives/search-shortcut.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,YAAY,EAAE,MAAM,eAAe,CAAC;;AAE9E;;;;GAIG;AACH,qBAIa,uBAAuB;IACxB,eAAe,qBAA4B;IAErD;;OAEG;IAEH,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;yCAPpC,uBAAuB;2CAAvB,uBAAuB;CAkBnC"}
+{"version":3,"file":"search-shortcut.directive.d.ts","sourceRoot":"","sources":["../../../src/lib/directives/search-shortcut.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,YAAY,EAAE,MAAM,eAAe,CAAC;;AAE9E;;;;GAIG;AACH,qBAIa,uBAAuB;IACxB,eAAe,qBAA4B;IAErD;;;;;;OAMG;IACO,eAAe,qBAAwB;IAEjD;;OAEG;IAEH,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;yCAhBpC,uBAAuB;2CAAvB,uBAAuB;CA2BnC"}

package/dist/lib/directives/search-shortcut.directive.js

@@ -6,7 +6,15 @@ import * as i0 from "@angular/core";
  * <div mjSearchShortcut (searchTriggered)="openSearch()">
  */
 export class SearchShortcutDirective {
-    searchTriggered = new EventEmitter();
+    SearchTriggered = new EventEmitter();
+    /**
+     * @deprecated Use {@link SearchTriggered}.
+     *
+     * The same emitter under the old binding name, so a template still binding
+     * (searchTriggered) keeps working. Must stay AFTER SearchTriggered: class fields
+     * initialise in order, and the other way round this captures undefined.
+     */
+    searchTriggered = this.SearchTriggered;
     /**
      * Listen for Ctrl+K or Cmd+K
      */
@@ -17,13 +25,13 @@ export class SearchShortcutDirective {
         if (isCtrlOrCmd && event.key === 'k') {
             event.preventDefault();
             event.stopPropagation();
-            this.searchTriggered.emit();
+            this.SearchTriggered.emit();
         }
     }
     static ɵfac = function SearchShortcutDirective_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SearchShortcutDirective)(); };
     static ɵdir = /*@__PURE__*/ i0.ɵɵdefineDirective({ type: SearchShortcutDirective, selectors: [["", "mjSearchShortcut", ""]], hostBindings: function SearchShortcutDirective_HostBindings(rf, ctx) { if (rf & 1) {
             i0.ɵɵlistener("keydown", function SearchShortcutDirective_keydown_HostBindingHandler($event) { return ctx.handleKeyboardEvent($event); }, i0.ɵɵresolveDocument);
-        } }, outputs: { searchTriggered: "searchTriggered" }, standalone: false });
+        } }, outputs: { SearchTriggered: "SearchTriggered", searchTriggered: "searchTriggered" }, standalone: false });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SearchShortcutDirective, [{
         type: Directive,
@@ -31,7 +39,9 @@ export class SearchShortcutDirective {
                 standalone: false,
                 selector: '[mjSearchShortcut]'
             }]
-    }], null, { searchTriggered: [{
+    }], null, { SearchTriggered: [{
+            type: Output
+        }], searchTriggered: [{
             type: Output
         }], handleKeyboardEvent: [{
             type: HostListener,

package/dist/lib/directives/search-shortcut.directive.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-shortcut.directive.js","sourceRoot":"","sources":["../../../src/lib/directives/search-shortcut.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;;AAE9E;;;;GAIG;AAKH,MAAM,OAAO,uBAAuB;IACxB,eAAe,GAAG,IAAI,YAAY,EAAQ,CAAC;IAErD;;OAEG;IAEH,mBAAmB,CAAC,KAAoB;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAE1D,4BAA4B;QAC5B,IAAI,WAAW,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACrC,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;iHAjBU,uBAAuB;6DAAvB,uBAAuB;YAAvB,sGAAA,+BACZ,0BADmC;;;iFAAvB,uBAAuB;cAJnC,SAAS;eAAC;gBACT,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,oBAAoB;aAC/B;;kBAEE,MAAM;;kBAKN,YAAY;mBAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC","sourcesContent":["import { Directive, HostListener, Output, EventEmitter } from '@angular/core';\n\n/**\n * Directive to handle global search keyboard shortcut (Ctrl+K or Cmd+K)\n * Usage: Add to your main app component or workspace component\n * <div mjSearchShortcut (searchTriggered)=\"openSearch()\">\n */\n@Directive({\n  standalone: false,\n  selector: '[mjSearchShortcut]'\n})\nexport class SearchShortcutDirective {\n  @Output() searchTriggered = new EventEmitter<void>();\n\n  /**\n   * Listen for Ctrl+K or Cmd+K\n   */\n  @HostListener('document:keydown', ['$event'])\n  handleKeyboardEvent(event: KeyboardEvent): void {\n    const isMac = navigator.platform.toUpperCase().indexOf('MAC') >= 0;\n    const isCtrlOrCmd = isMac ? event.metaKey : event.ctrlKey;\n\n    // Check for Ctrl+K or Cmd+K\n    if (isCtrlOrCmd && event.key === 'k') {\n      event.preventDefault();\n      event.stopPropagation();\n      this.searchTriggered.emit();\n    }\n  }\n}\n"]}
+{"version":3,"file":"search-shortcut.directive.js","sourceRoot":"","sources":["../../../src/lib/directives/search-shortcut.directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;;AAE9E;;;;GAIG;AAKH,MAAM,OAAO,uBAAuB;IACxB,eAAe,GAAG,IAAI,YAAY,EAAQ,CAAC;IAErD;;;;;;OAMG;IACO,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IAEjD;;OAEG;IAEH,mBAAmB,CAAC,KAAoB;QACtC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAE1D,4BAA4B;QAC5B,IAAI,WAAW,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACrC,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;iHA1BU,uBAAuB;6DAAvB,uBAAuB;YAAvB,sGAAA,+BACZ,0BADmC;;;iFAAvB,uBAAuB;cAJnC,SAAS;eAAC;gBACT,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,oBAAoB;aAC/B;;kBAEE,MAAM;;kBASN,MAAM;;kBAKN,YAAY;mBAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC","sourcesContent":["import { Directive, HostListener, Output, EventEmitter } from '@angular/core';\n\n/**\n * Directive to handle global search keyboard shortcut (Ctrl+K or Cmd+K)\n * Usage: Add to your main app component or workspace component\n * <div mjSearchShortcut (searchTriggered)=\"openSearch()\">\n */\n@Directive({\n  standalone: false,\n  selector: '[mjSearchShortcut]'\n})\nexport class SearchShortcutDirective {\n  @Output() SearchTriggered = new EventEmitter<void>();\n\n  /**\n   * @deprecated Use {@link SearchTriggered}.\n   *\n   * The same emitter under the old binding name, so a template still binding\n   * (searchTriggered) keeps working. Must stay AFTER SearchTriggered: class fields\n   * initialise in order, and the other way round this captures undefined.\n   */\n  @Output() searchTriggered = this.SearchTriggered;\n\n  /**\n   * Listen for Ctrl+K or Cmd+K\n   */\n  @HostListener('document:keydown', ['$event'])\n  handleKeyboardEvent(event: KeyboardEvent): void {\n    const isMac = navigator.platform.toUpperCase().indexOf('MAC') >= 0;\n    const isCtrlOrCmd = isMac ? event.metaKey : event.ctrlKey;\n\n    // Check for Ctrl+K or Cmd+K\n    if (isCtrlOrCmd && event.key === 'k') {\n      event.preventDefault();\n      event.stopPropagation();\n      this.SearchTriggered.emit();\n    }\n  }\n}\n"]}

package/dist/lib/events/chat-events.d.ts

@@ -17,6 +17,7 @@
  * @module @memberjunction/ng-conversations
  */
 import type { ExecuteAgentResult } from '@memberjunction/ai-core-plus';
+import type { AgentTurnInfo, AgentTurnRoute } from '../models/agent-turn.model';
 /**
  * Base class for cancelable chat events. Listeners flip `Cancel = true` to
  * halt the default behavior; the matching `After*` event will NOT fire.
@@ -27,20 +28,46 @@ export declare class CancellableChatEventArgs {
     CancelReason?: string;
 }
 /**
- * Fired BEFORE a user message is sent to the agent. Listeners can cancel
- * (e.g., a guardrail that blocks empty messages or messages matching a
- * forbidden pattern).
+ * Fired once per agent turn, BEFORE any reply row exists: the person's message is saved and the
+ * chat area has picked the agent that will answer it, on whichever route chose it (a tagged
+ * agent, the last agent that answered, a pinned or host default agent, or the conversation
+ * manager). A message that starts no turn (see `AgentReplyMode`) fires nothing.
+ *
+ * A listener can:
+ * - cancel the turn (`Cancel = true`). Nothing more is written: no placeholder, no reply row,
+ *   and `AfterAgentTurn` does not fire. `CancelReason` is logged, not shown.
+ * - send the turn to a different agent by setting {@link RedirectAgentId}. The agent must be
+ *   one the chat allows (`AllowedAgentIDs`); otherwise the turn is refused with a notice.
+ *
+ * Listeners run synchronously: the chat area reads `Cancel` and `RedirectAgentId` as soon as
+ * `emit()` returns.
+ *
+ * Earlier releases fired this event only on the conversation-manager route, after that route's
+ * placeholder row was saved, so a cancel left the row behind marked "Turn canceled".
  */
 export declare class BeforeAgentTurnEventArgs extends CancellableChatEventArgs {
     readonly ConversationId: string;
     readonly MessageText: string;
     readonly ApplicationId: string | null;
-    constructor(ConversationId: string, MessageText: string, ApplicationId?: string | null);
+    /** The agent the turn resolved to. Null only when the args were built without turn details. */
+    readonly AgentId: string | null;
+    /** The agent's name, when known. */
+    readonly AgentName: string | null;
+    /** How the agent was chosen. */
+    readonly Route: AgentTurnRoute | null;
+    /** The person's saved message the turn answers. */
+    readonly UserMessageId: string | null;
+    /**
+     * Set to send the turn to a different agent instead. Null (the default) keeps
+     * {@link AgentId}. The turn then runs with `Route` `'Redirect'`.
+     */
+    RedirectAgentId: string | null;
+    constructor(ConversationId: string, MessageText: string, ApplicationId?: string | null, turn?: AgentTurnInfo | null);
 }
 /**
- * Fired AFTER a successful agent turn completes. Carries the agent run id
- * and the underlying `ExecuteAgentResult`. NOT fired when the corresponding
- * `BeforeAgentTurnEventArgs` was canceled or the turn errored.
+ * Fired AFTER a successful agent turn, on every route. Carries the agent run id and the
+ * underlying `ExecuteAgentResult`. NOT fired when the corresponding `BeforeAgentTurnEventArgs`
+ * was canceled, when the turn failed, or when a host `AgentTurnHandler` reported no `Result`.
  */
 export declare class AfterAgentTurnEventArgs {
     readonly ConversationId: string;

package/dist/lib/events/chat-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-events.d.ts","sourceRoot":"","sources":["../../../src/lib/events/chat-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;GAIG;AACH,qBAAa,wBAAwB;IAC1B,MAAM,EAAE,OAAO,CAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,wBAAwB;aAE9C,cAAc,EAAE,MAAM;aACtB,WAAW,EAAE,MAAM;aACnB,aAAa,EAAE,MAAM,GAAG,IAAI;gBAF5B,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,MAAM,GAAG,IAAW;CAI1D;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;aAEZ,cAAc,EAAE,MAAM;aACtB,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,kBAAkB;gBAF1B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB;CAEjD;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,0BAA2B,SAAQ,wBAAwB;aAEhD,QAAQ,EAAE,MAAM;aAChB,IAAI,EAAE,OAAO;gBADb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO;CAIpC;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;aAEd,QAAQ,EAAE,MAAM;aAChB,IAAI,EAAE,OAAO;aACb,MAAM,EAAE,OAAO;gBAFf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,OAAO;CAEtC;AAMD;;;;GAIG;AACH,qBAAa,oCAAqC,SAAQ,wBAAwB;aAE1D,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAD/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAItD;AAED;;;;GAIG;AACH,qBAAa,mCAAmC;aAExB,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAD/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAEtD;AAaD;;;;;GAKG;AACH,qBAAa,uBAAuB;aAEZ,SAAS,EAAE,MAAM;aACjB,YAAY,EAAE,SAAS,MAAM,EAAE;gBAD/B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,SAAS,MAAM,EAAE;CAEtD;AAED;;;GAGG;AACH,qBAAa,mCAAmC;aAExB,SAAS,EAAE,MAAM;aACjB,WAAW,EAAE,MAAM;aACnB,KAAK,EAAE,MAAM,GAAG,QAAQ;gBAFxB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,QAAQ;CAE/C;AAED;;;GAGG;AACH,qBAAa,qBAAqB;aAEV,SAAS,EAAE,MAAM;aACjB,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS;gBADxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS;CAE/D"}
+{"version":3,"file":"chat-events.d.ts","sourceRoot":"","sources":["../../../src/lib/events/chat-events.ts"],"names":[],"mappings":"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"}

package/dist/lib/events/chat-events.js

@@ -29,25 +29,55 @@ export class CancellableChatEventArgs {
 // Agent-turn lifecycle
 // ────────────────────────────────────────────────────────────────────
 /**
- * Fired BEFORE a user message is sent to the agent. Listeners can cancel
- * (e.g., a guardrail that blocks empty messages or messages matching a
- * forbidden pattern).
+ * Fired once per agent turn, BEFORE any reply row exists: the person's message is saved and the
+ * chat area has picked the agent that will answer it, on whichever route chose it (a tagged
+ * agent, the last agent that answered, a pinned or host default agent, or the conversation
+ * manager). A message that starts no turn (see `AgentReplyMode`) fires nothing.
+ *
+ * A listener can:
+ * - cancel the turn (`Cancel = true`). Nothing more is written: no placeholder, no reply row,
+ *   and `AfterAgentTurn` does not fire. `CancelReason` is logged, not shown.
+ * - send the turn to a different agent by setting {@link RedirectAgentId}. The agent must be
+ *   one the chat allows (`AllowedAgentIDs`); otherwise the turn is refused with a notice.
+ *
+ * Listeners run synchronously: the chat area reads `Cancel` and `RedirectAgentId` as soon as
+ * `emit()` returns.
+ *
+ * Earlier releases fired this event only on the conversation-manager route, after that route's
+ * placeholder row was saved, so a cancel left the row behind marked "Turn canceled".
  */
 export class BeforeAgentTurnEventArgs extends CancellableChatEventArgs {
     ConversationId;
     MessageText;
     ApplicationId;
-    constructor(ConversationId, MessageText, ApplicationId = null) {
+    /** The agent the turn resolved to. Null only when the args were built without turn details. */
+    AgentId;
+    /** The agent's name, when known. */
+    AgentName;
+    /** How the agent was chosen. */
+    Route;
+    /** The person's saved message the turn answers. */
+    UserMessageId;
+    /**
+     * Set to send the turn to a different agent instead. Null (the default) keeps
+     * {@link AgentId}. The turn then runs with `Route` `'Redirect'`.
+     */
+    RedirectAgentId = null;
+    constructor(ConversationId, MessageText, ApplicationId = null, turn = null) {
         super();
         this.ConversationId = ConversationId;
         this.MessageText = MessageText;
         this.ApplicationId = ApplicationId;
+        this.AgentId = turn?.AgentId ?? null;
+        this.AgentName = turn?.AgentName ?? null;
+        this.Route = turn?.Route ?? null;
+        this.UserMessageId = turn?.UserMessageId ?? null;
     }
 }
 /**
- * Fired AFTER a successful agent turn completes. Carries the agent run id
- * and the underlying `ExecuteAgentResult`. NOT fired when the corresponding
- * `BeforeAgentTurnEventArgs` was canceled or the turn errored.
+ * Fired AFTER a successful agent turn, on every route. Carries the agent run id and the
+ * underlying `ExecuteAgentResult`. NOT fired when the corresponding `BeforeAgentTurnEventArgs`
+ * was canceled, when the turn failed, or when a host `AgentTurnHandler` reported no `Result`.
  */
 export class AfterAgentTurnEventArgs {
     ConversationId;

package/dist/lib/events/chat-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-events.js","sourceRoot":"","sources":["../../../src/lib/events/chat-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAC1B,MAAM,GAAY,KAAK,CAAC;IACxB,YAAY,CAAU;CAChC;AAED,uEAAuE;AACvE,uBAAuB;AACvB,uEAAuE;AAEvE;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,wBAAwB;IAE9C;IACA;IACA;IAHpB,YACoB,cAAsB,EACtB,WAAmB,EACnB,gBAA+B,IAAI;QAEnD,KAAK,EAAE,CAAC;QAJQ,mBAAc,GAAd,cAAc,CAAQ;QACtB,gBAAW,GAAX,WAAW,CAAQ;QACnB,kBAAa,GAAb,aAAa,CAAsB;IAGvD,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAEZ;IACA;IACA;IAHpB,YACoB,cAAsB,EACtB,UAAkB,EAClB,MAA0B;QAF1B,mBAAc,GAAd,cAAc,CAAQ;QACtB,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAoB;IAC3C,CAAC;CACP;AAED,uEAAuE;AACvE,mBAAmB;AACnB,uEAAuE;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,0BAA2B,SAAQ,wBAAwB;IAEhD;IACA;IAFpB,YACoB,QAAgB,EAChB,IAAa;QAE7B,KAAK,EAAE,CAAC;QAHQ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAS;IAGjC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAEd;IACA;IACA;IAHpB,YACoB,QAAgB,EAChB,IAAa,EACb,MAAe;QAFf,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAS;QACb,WAAM,GAAN,MAAM,CAAS;IAChC,CAAC;CACP;AAED,uEAAuE;AACvE,iBAAiB;AACjB,uEAAuE;AAEvE;;;;GAIG;AACH,MAAM,OAAO,oCAAqC,SAAQ,wBAAwB;IAE1D;IACA;IAFpB,YACoB,MAAc,EACd,MAA+B;QAE/C,KAAK,EAAE,CAAC;QAHQ,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAyB;IAGnD,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,OAAO,mCAAmC;IAExB;IACA;IAFpB,YACoB,MAAc,EACd,MAA+B;QAD/B,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAyB;IAChD,CAAC;CACP;AAED,uEAAuE;AACvE,qDAAqD;AACrD,uEAAuE;AACvE,EAAE;AACF,+DAA+D;AAC/D,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,wEAAwE;AACxE,8DAA8D;AAE9D;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAEZ;IACA;IAFpB,YACoB,SAAiB,EACjB,YAA+B;QAD/B,cAAS,GAAT,SAAS,CAAQ;QACjB,iBAAY,GAAZ,YAAY,CAAmB;IAChD,CAAC;CACP;AAED;;;GAGG;AACH,MAAM,OAAO,mCAAmC;IAExB;IACA;IACA;IAHpB,YACoB,SAAiB,EACjB,WAAmB,EACnB,KAAwB;QAFxB,cAAS,GAAT,SAAS,CAAQ;QACjB,gBAAW,GAAX,WAAW,CAAQ;QACnB,UAAK,GAAL,KAAK,CAAmB;IACzC,CAAC;CACP;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAEV;IACA;IAFpB,YACoB,SAAiB,EACjB,MAAwC;QADxC,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAkC;IACzD,CAAC;CACP","sourcesContent":["/**\n * @fileoverview Before/After cancelable event argument classes for the\n * conversations widget.\n *\n * Follows MJ's established Before/After cancelable event pattern (see\n * `packages/Angular/Generic/trees/src/lib/events/tree-events.ts` and\n * `packages/Angular/Generic/base-forms/src/lib/types/form-events.ts`).\n *\n * **Contract:** Action events come as `Before*` / `After*` pairs. The\n * `Before*` event carries an args object extending {@link CancellableChatEventArgs}\n * with a `Cancel: boolean` property the listener can flip. The component\n * checks `if (event.Cancel) return;` before proceeding and emits the\n * corresponding `After*` only on the non-canceled path. Informational\n * events (progress, shown-notifications, session lifecycle) stay as single\n * emitters without a Before-pair.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport type { ExecuteAgentResult } from '@memberjunction/ai-core-plus';\n\n/**\n * Base class for cancelable chat events. Listeners flip `Cancel = true` to\n * halt the default behavior; the matching `After*` event will NOT fire.\n * The optional `CancelReason` is a free-form string for telemetry / debug.\n */\nexport class CancellableChatEventArgs {\n    public Cancel: boolean = false;\n    public CancelReason?: string;\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Agent-turn lifecycle\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired BEFORE a user message is sent to the agent. Listeners can cancel\n * (e.g., a guardrail that blocks empty messages or messages matching a\n * forbidden pattern).\n */\nexport class BeforeAgentTurnEventArgs extends CancellableChatEventArgs {\n    constructor(\n        public readonly ConversationId: string,\n        public readonly MessageText: string,\n        public readonly ApplicationId: string | null = null\n    ) {\n        super();\n    }\n}\n\n/**\n * Fired AFTER a successful agent turn completes. Carries the agent run id\n * and the underlying `ExecuteAgentResult`. NOT fired when the corresponding\n * `BeforeAgentTurnEventArgs` was canceled or the turn errored.\n */\nexport class AfterAgentTurnEventArgs {\n    constructor(\n        public readonly ConversationId: string,\n        public readonly AgentRunId: string,\n        public readonly Result: ExecuteAgentResult\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Tool invocations\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired BEFORE the agent invokes a registered client tool. Listeners can veto\n * the dispatch by setting `event.Cancel = true` — `AgentClientSession`\n * short-circuits, the tool handler does NOT run, `afterToolInvoked` does NOT\n * fire, and the server receives a failure response carrying the optional\n * `CancelReason`.\n *\n * @example Confirm before a destructive tool runs\n * ```typescript\n * onBeforeToolInvoked(event: BeforeToolInvokedEventArgs) {\n *   if (event.ToolName === 'deleteRecord') {\n *     if (!confirm('Agent wants to delete a record. Allow?')) {\n *       event.Cancel = true;\n *       event.CancelReason = 'User declined deletion';\n *     }\n *   }\n * }\n * ```\n */\nexport class BeforeToolInvokedEventArgs extends CancellableChatEventArgs {\n    constructor(\n        public readonly ToolName: string,\n        public readonly Args: unknown\n    ) {\n        super();\n    }\n}\n\n/**\n * Fired AFTER a tool invocation completes. Carries the tool name, the\n * arguments it was called with, and the result it produced. NOT fired when\n * the corresponding `BeforeToolInvokedEventArgs` was canceled — the contract\n * is enforced in `AgentClientSession.handleToolRequest`.\n */\nexport class AfterToolInvokedEventArgs {\n    constructor(\n        public readonly ToolName: string,\n        public readonly Args: unknown,\n        public readonly Result: unknown\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Response forms\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired BEFORE a response form's submitted values are sent back to the\n * agent. Listeners can cancel (e.g., a validation pass that blocks\n * submission until certain fields are populated).\n */\nexport class BeforeResponseFormSubmittedEventArgs extends CancellableChatEventArgs {\n    constructor(\n        public readonly FormId: string,\n        public readonly Values: Record<string, unknown>\n    ) {\n        super();\n    }\n}\n\n/**\n * Fired AFTER a response form's submitted values have been sent. NOT fired\n * when the corresponding `BeforeResponseFormSubmittedEventArgs` was\n * canceled.\n */\nexport class AfterResponseFormSubmittedEventArgs {\n    constructor(\n        public readonly FormId: string,\n        public readonly Values: Record<string, unknown>\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Session lifecycle (informational — no Before-pair)\n// ────────────────────────────────────────────────────────────────────\n//\n// These re-broadcast the `SessionLifecycleEvent` variants from\n// `@memberjunction/conversations-runtime`'s `SessionsObserver`. State/Reason\n// union types are intentionally narrowed to what's distinguishable client-side\n// today — see the `ISessionsAdapter` JSDoc in the runtime package for the full\n// rationale (no per-channel `opening`/`closing` observable, server-only\n// `Janitor`/`Shutdown` reasons that never reach the browser).\n\n/**\n * Informational event — fired when a realtime session has fully started\n * (server-issued `sessionId` is set AND the realtime client is connected).\n * Cancellation of voice/realtime activity lives at the Sessions layer\n * (PR #2787), not here.\n */\nexport class SessionStartedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly ChannelKinds: readonly string[]\n    ) {}\n}\n\n/**\n * Informational. A channel inside a session opened or closed. Narrowed to\n * `open | closed` — see {@link SessionStartedEventArgs} module comment.\n */\nexport class SessionChannelStateChangedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly ChannelKind: string,\n        public readonly State: 'open' | 'closed'\n    ) {}\n}\n\n/**\n * Informational. A session ended client-side. Narrowed to\n * `explicit | error | unknown` — see {@link SessionStartedEventArgs} module comment.\n */\nexport class SessionEndedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly Reason: 'explicit' | 'error' | 'unknown'\n    ) {}\n}\n"]}
+{"version":3,"file":"chat-events.js","sourceRoot":"","sources":["../../../src/lib/events/chat-events.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Before/After cancelable event argument classes for the\n * conversations widget.\n *\n * Follows MJ's established Before/After cancelable event pattern (see\n * `packages/Angular/Generic/trees/src/lib/events/tree-events.ts` and\n * `packages/Angular/Generic/base-forms/src/lib/types/form-events.ts`).\n *\n * **Contract:** Action events come as `Before*` / `After*` pairs. The\n * `Before*` event carries an args object extending {@link CancellableChatEventArgs}\n * with a `Cancel: boolean` property the listener can flip. The component\n * checks `if (event.Cancel) return;` before proceeding and emits the\n * corresponding `After*` only on the non-canceled path. Informational\n * events (progress, shown-notifications, session lifecycle) stay as single\n * emitters without a Before-pair.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport type { ExecuteAgentResult } from '@memberjunction/ai-core-plus';\nimport type { AgentTurnInfo, AgentTurnRoute } from '../models/agent-turn.model';\n\n/**\n * Base class for cancelable chat events. Listeners flip `Cancel = true` to\n * halt the default behavior; the matching `After*` event will NOT fire.\n * The optional `CancelReason` is a free-form string for telemetry / debug.\n */\nexport class CancellableChatEventArgs {\n    public Cancel: boolean = false;\n    public CancelReason?: string;\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Agent-turn lifecycle\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired once per agent turn, BEFORE any reply row exists: the person's message is saved and the\n * chat area has picked the agent that will answer it, on whichever route chose it (a tagged\n * agent, the last agent that answered, a pinned or host default agent, or the conversation\n * manager). A message that starts no turn (see `AgentReplyMode`) fires nothing.\n *\n * A listener can:\n * - cancel the turn (`Cancel = true`). Nothing more is written: no placeholder, no reply row,\n *   and `AfterAgentTurn` does not fire. `CancelReason` is logged, not shown.\n * - send the turn to a different agent by setting {@link RedirectAgentId}. The agent must be\n *   one the chat allows (`AllowedAgentIDs`); otherwise the turn is refused with a notice.\n *\n * Listeners run synchronously: the chat area reads `Cancel` and `RedirectAgentId` as soon as\n * `emit()` returns.\n *\n * Earlier releases fired this event only on the conversation-manager route, after that route's\n * placeholder row was saved, so a cancel left the row behind marked \"Turn canceled\".\n */\nexport class BeforeAgentTurnEventArgs extends CancellableChatEventArgs {\n    /** The agent the turn resolved to. Null only when the args were built without turn details. */\n    public readonly AgentId: string | null;\n    /** The agent's name, when known. */\n    public readonly AgentName: string | null;\n    /** How the agent was chosen. */\n    public readonly Route: AgentTurnRoute | null;\n    /** The person's saved message the turn answers. */\n    public readonly UserMessageId: string | null;\n    /**\n     * Set to send the turn to a different agent instead. Null (the default) keeps\n     * {@link AgentId}. The turn then runs with `Route` `'Redirect'`.\n     */\n    public RedirectAgentId: string | null = null;\n\n    constructor(\n        public readonly ConversationId: string,\n        public readonly MessageText: string,\n        public readonly ApplicationId: string | null = null,\n        turn: AgentTurnInfo | null = null\n    ) {\n        super();\n        this.AgentId = turn?.AgentId ?? null;\n        this.AgentName = turn?.AgentName ?? null;\n        this.Route = turn?.Route ?? null;\n        this.UserMessageId = turn?.UserMessageId ?? null;\n    }\n}\n\n/**\n * Fired AFTER a successful agent turn, on every route. Carries the agent run id and the\n * underlying `ExecuteAgentResult`. NOT fired when the corresponding `BeforeAgentTurnEventArgs`\n * was canceled, when the turn failed, or when a host `AgentTurnHandler` reported no `Result`.\n */\nexport class AfterAgentTurnEventArgs {\n    constructor(\n        public readonly ConversationId: string,\n        public readonly AgentRunId: string,\n        public readonly Result: ExecuteAgentResult\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Tool invocations\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired BEFORE the agent invokes a registered client tool. Listeners can veto\n * the dispatch by setting `event.Cancel = true` — `AgentClientSession`\n * short-circuits, the tool handler does NOT run, `afterToolInvoked` does NOT\n * fire, and the server receives a failure response carrying the optional\n * `CancelReason`.\n *\n * @example Confirm before a destructive tool runs\n * ```typescript\n * onBeforeToolInvoked(event: BeforeToolInvokedEventArgs) {\n *   if (event.ToolName === 'deleteRecord') {\n *     if (!confirm('Agent wants to delete a record. Allow?')) {\n *       event.Cancel = true;\n *       event.CancelReason = 'User declined deletion';\n *     }\n *   }\n * }\n * ```\n */\nexport class BeforeToolInvokedEventArgs extends CancellableChatEventArgs {\n    constructor(\n        public readonly ToolName: string,\n        public readonly Args: unknown\n    ) {\n        super();\n    }\n}\n\n/**\n * Fired AFTER a tool invocation completes. Carries the tool name, the\n * arguments it was called with, and the result it produced. NOT fired when\n * the corresponding `BeforeToolInvokedEventArgs` was canceled — the contract\n * is enforced in `AgentClientSession.handleToolRequest`.\n */\nexport class AfterToolInvokedEventArgs {\n    constructor(\n        public readonly ToolName: string,\n        public readonly Args: unknown,\n        public readonly Result: unknown\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Response forms\n// ────────────────────────────────────────────────────────────────────\n\n/**\n * Fired BEFORE a response form's submitted values are sent back to the\n * agent. Listeners can cancel (e.g., a validation pass that blocks\n * submission until certain fields are populated).\n */\nexport class BeforeResponseFormSubmittedEventArgs extends CancellableChatEventArgs {\n    constructor(\n        public readonly FormId: string,\n        public readonly Values: Record<string, unknown>\n    ) {\n        super();\n    }\n}\n\n/**\n * Fired AFTER a response form's submitted values have been sent. NOT fired\n * when the corresponding `BeforeResponseFormSubmittedEventArgs` was\n * canceled.\n */\nexport class AfterResponseFormSubmittedEventArgs {\n    constructor(\n        public readonly FormId: string,\n        public readonly Values: Record<string, unknown>\n    ) {}\n}\n\n// ────────────────────────────────────────────────────────────────────\n// Session lifecycle (informational — no Before-pair)\n// ────────────────────────────────────────────────────────────────────\n//\n// These re-broadcast the `SessionLifecycleEvent` variants from\n// `@memberjunction/conversations-runtime`'s `SessionsObserver`. State/Reason\n// union types are intentionally narrowed to what's distinguishable client-side\n// today — see the `ISessionsAdapter` JSDoc in the runtime package for the full\n// rationale (no per-channel `opening`/`closing` observable, server-only\n// `Janitor`/`Shutdown` reasons that never reach the browser).\n\n/**\n * Informational event — fired when a realtime session has fully started\n * (server-issued `sessionId` is set AND the realtime client is connected).\n * Cancellation of voice/realtime activity lives at the Sessions layer\n * (PR #2787), not here.\n */\nexport class SessionStartedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly ChannelKinds: readonly string[]\n    ) {}\n}\n\n/**\n * Informational. A channel inside a session opened or closed. Narrowed to\n * `open | closed` — see {@link SessionStartedEventArgs} module comment.\n */\nexport class SessionChannelStateChangedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly ChannelKind: string,\n        public readonly State: 'open' | 'closed'\n    ) {}\n}\n\n/**\n * Informational. A session ended client-side. Narrowed to\n * `explicit | error | unknown` — see {@link SessionStartedEventArgs} module comment.\n */\nexport class SessionEndedEventArgs {\n    constructor(\n        public readonly SessionId: string,\n        public readonly Reason: 'explicit' | 'error' | 'unknown'\n    ) {}\n}\n"]}

package/dist/lib/models/agent-turn.model.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview The host-facing contract for an agent turn in `mj-conversation-chat-area`.
+ *
+ * An agent turn is what may follow a person's saved message. The chat area picks one agent by a
+ * fixed order of routes, announces the turn with `BeforeAgentTurn` (which a host can cancel or
+ * redirect), and then runs it: on MJ's own path, or on the host's server through an
+ * {@link AgentTurnHandler}. These types are what a host reads and writes along the way.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import type { ExecuteAgentResult } from '@memberjunction/ai-core-plus';
+/**
+ * When a message starts an agent turn.
+ *
+ * - `Always` (the default): every message does, as it always has.
+ * - `MentionOnly`: only a message that tags an agent does. Any other message is posted with no
+ *   turn at all: no reply row, no placeholder and no turn events.
+ */
+export type AgentReplyMode = 'Always' | 'MentionOnly';
+/**
+ * How the turn's agent was chosen. MJ tries the routes in this order and takes the first that
+ * applies; under `MentionOnly`, only `Mention` applies.
+ *
+ * - `Mention`: the message tags the agent.
+ * - `Continuity`: the last agent that answered in the conversation, other than the
+ *   conversation manager.
+ * - `DecisionRouted`: another agent in the conversation, which a confident routing decision chose
+ *   in continuity's place. Only with the chat's `EnableDecisionRouting` on.
+ * - `ConversationDefault`: the agent pinned on the conversation (`Conversation.DefaultAgentID`).
+ * - `HostDefault`: the host's `DefaultAgentId` input.
+ * - `ConversationManager`: MJ's conversation manager agent (Sage unless configured otherwise),
+ *   which may delegate to another agent.
+ * - `Redirect`: a `BeforeAgentTurn` listener sent the turn to a different agent.
+ */
+export type AgentTurnRoute = 'Mention' | 'Continuity' | 'DecisionRouted' | 'ConversationDefault' | 'HostDefault' | 'ConversationManager' | 'Redirect';
+/** The agent a turn resolved to, and the route that chose it. */
+export interface AgentTurnTarget {
+    /** The agent that takes the turn. */
+    AgentId: string;
+    /** How the agent was chosen. */
+    Route: AgentTurnRoute;
+}
+/** What `BeforeAgentTurn` tells its listeners about the turn it announces. */
+export interface AgentTurnInfo extends AgentTurnTarget {
+    /** The agent's name, when MJ knows it. */
+    AgentName: string | null;
+    /** The person's saved message that the turn answers. */
+    UserMessageId: string | null;
+}
+/**
+ * Everything the chat area knows about a turn it hands to an {@link AgentTurnHandler}.
+ * No reply row exists yet when the handler is called.
+ */
+export interface AgentTurnRequest {
+    /** The conversation the message was posted in. */
+    ConversationId: string;
+    /** The person's saved message (`MJ: Conversation Details`, Role `User`). */
+    UserMessageId: string;
+    /** The message text, with mentions in their stored JSON form. */
+    MessageText: string;
+    /** The agent the turn resolved to, after any redirect. */
+    AgentId: string;
+    /** The agent's name, when MJ knows it. */
+    AgentName: string | null;
+    /** How the agent was chosen. */
+    Route: AgentTurnRoute;
+    /** The chat area's `ApplicationId` input. */
+    ApplicationId: string | null;
+    /** The chat area's `AppContext` input. */
+    AppContext: Record<string, unknown> | null;
+    /** The chat area's `AgentHistoryFrom` input: the first moment of the conversation the turn may read. */
+    AgentHistoryFrom: Date | null;
+    /**
+     * The agent configuration preset (`MJ: AI Agent Configurations.ID`) the person chose: the one
+     * on the mention for a `Mention` turn, otherwise the header mode picker's selection.
+     */
+    ConfigurationPresetId: string | null;
+    /** Skills the person asked for with `/skill` in this message. */
+    RequestedSkillIDs: string[];
+    /** Whether Plan Mode is on for the conversation. */
+    PlanMode: boolean;
+    /**
+     * The artifact version (`MJ: Artifact Versions.ID`) the message modifies, when the chat's
+     * routing decision (`EnableDecisionRouting`) confidently named one this agent produced. MJ's
+     * own path continues from that version instead of the agent's latest output. Null otherwise.
+     */
+    TargetArtifactVersionId: string | null;
+}
+/** What an {@link AgentTurnHandler} reports back to the chat area. */
+export interface AgentTurnResult {
+    /** False when the turn failed. The chat area shows {@link ErrorMessage} and writes nothing. */
+    Success: boolean;
+    /** Why the turn failed, shown to the person. */
+    ErrorMessage?: string;
+    /**
+     * The rows the host wrote for the turn, oldest first: the agent's reply and any status rows.
+     * The chat area loads and shows them. A row still `In-Progress` is followed like any other
+     * in-progress reply. The host reports that row's live status through `AgentRunStatusPublisher`
+     * (`@memberjunction/server`) on the caller's session: significant-step progress, streamed text,
+     * the partial result, and the completion. The completion's `conversationDetailId` is the reply row.
+     */
+    ReplyDetailIds?: string[];
+    /** The agent run, when the host has one. Carried on `AfterAgentTurn`. */
+    AgentRunId?: string;
+    /** The agent's result, when the host has one. `AfterAgentTurn` fires only when it's present. */
+    Result?: ExecuteAgentResult;
+}
+/**
+ * Runs an agent turn on the host's server instead of MJ's own path. The chat area calls it once
+ * per turn, after `BeforeAgentTurn` and before any reply row exists, and shows the rows it reports.
+ */
+export type AgentTurnHandler = (request: AgentTurnRequest) => Promise<AgentTurnResult>;
+//# sourceMappingURL=agent-turn.model.d.ts.map

package/dist/lib/models/agent-turn.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-turn.model.d.ts","sourceRoot":"","sources":["../../../src/lib/models/agent-turn.model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GACpB,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,qBAAqB,GACrB,aAAa,GACb,qBAAqB,GACrB,UAAU,CAAC;AAEjB,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC5B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,EAAE,cAAc,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAc,SAAQ,eAAe;IAClD,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wDAAwD;IACxD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gCAAgC;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,wGAAwG;IACxG,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC5B,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/lib/models/agent-turn.model.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview The host-facing contract for an agent turn in `mj-conversation-chat-area`.
+ *
+ * An agent turn is what may follow a person's saved message. The chat area picks one agent by a
+ * fixed order of routes, announces the turn with `BeforeAgentTurn` (which a host can cancel or
+ * redirect), and then runs it: on MJ's own path, or on the host's server through an
+ * {@link AgentTurnHandler}. These types are what a host reads and writes along the way.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+export {};
+//# sourceMappingURL=agent-turn.model.js.map

package/dist/lib/models/agent-turn.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-turn.model.js","sourceRoot":"","sources":["../../../src/lib/models/agent-turn.model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG","sourcesContent":["/**\n * @fileoverview The host-facing contract for an agent turn in `mj-conversation-chat-area`.\n *\n * An agent turn is what may follow a person's saved message. The chat area picks one agent by a\n * fixed order of routes, announces the turn with `BeforeAgentTurn` (which a host can cancel or\n * redirect), and then runs it: on MJ's own path, or on the host's server through an\n * {@link AgentTurnHandler}. These types are what a host reads and writes along the way.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport type { ExecuteAgentResult } from '@memberjunction/ai-core-plus';\n\n/**\n * When a message starts an agent turn.\n *\n * - `Always` (the default): every message does, as it always has.\n * - `MentionOnly`: only a message that tags an agent does. Any other message is posted with no\n *   turn at all: no reply row, no placeholder and no turn events.\n */\nexport type AgentReplyMode = 'Always' | 'MentionOnly';\n\n/**\n * How the turn's agent was chosen. MJ tries the routes in this order and takes the first that\n * applies; under `MentionOnly`, only `Mention` applies.\n *\n * - `Mention`: the message tags the agent.\n * - `Continuity`: the last agent that answered in the conversation, other than the\n *   conversation manager.\n * - `DecisionRouted`: another agent in the conversation, which a confident routing decision chose\n *   in continuity's place. Only with the chat's `EnableDecisionRouting` on.\n * - `ConversationDefault`: the agent pinned on the conversation (`Conversation.DefaultAgentID`).\n * - `HostDefault`: the host's `DefaultAgentId` input.\n * - `ConversationManager`: MJ's conversation manager agent (Sage unless configured otherwise),\n *   which may delegate to another agent.\n * - `Redirect`: a `BeforeAgentTurn` listener sent the turn to a different agent.\n */\nexport type AgentTurnRoute =\n    | 'Mention'\n    | 'Continuity'\n    | 'DecisionRouted'\n    | 'ConversationDefault'\n    | 'HostDefault'\n    | 'ConversationManager'\n    | 'Redirect';\n\n/** The agent a turn resolved to, and the route that chose it. */\nexport interface AgentTurnTarget {\n    /** The agent that takes the turn. */\n    AgentId: string;\n    /** How the agent was chosen. */\n    Route: AgentTurnRoute;\n}\n\n/** What `BeforeAgentTurn` tells its listeners about the turn it announces. */\nexport interface AgentTurnInfo extends AgentTurnTarget {\n    /** The agent's name, when MJ knows it. */\n    AgentName: string | null;\n    /** The person's saved message that the turn answers. */\n    UserMessageId: string | null;\n}\n\n/**\n * Everything the chat area knows about a turn it hands to an {@link AgentTurnHandler}.\n * No reply row exists yet when the handler is called.\n */\nexport interface AgentTurnRequest {\n    /** The conversation the message was posted in. */\n    ConversationId: string;\n    /** The person's saved message (`MJ: Conversation Details`, Role `User`). */\n    UserMessageId: string;\n    /** The message text, with mentions in their stored JSON form. */\n    MessageText: string;\n    /** The agent the turn resolved to, after any redirect. */\n    AgentId: string;\n    /** The agent's name, when MJ knows it. */\n    AgentName: string | null;\n    /** How the agent was chosen. */\n    Route: AgentTurnRoute;\n    /** The chat area's `ApplicationId` input. */\n    ApplicationId: string | null;\n    /** The chat area's `AppContext` input. */\n    AppContext: Record<string, unknown> | null;\n    /** The chat area's `AgentHistoryFrom` input: the first moment of the conversation the turn may read. */\n    AgentHistoryFrom: Date | null;\n    /**\n     * The agent configuration preset (`MJ: AI Agent Configurations.ID`) the person chose: the one\n     * on the mention for a `Mention` turn, otherwise the header mode picker's selection.\n     */\n    ConfigurationPresetId: string | null;\n    /** Skills the person asked for with `/skill` in this message. */\n    RequestedSkillIDs: string[];\n    /** Whether Plan Mode is on for the conversation. */\n    PlanMode: boolean;\n    /**\n     * The artifact version (`MJ: Artifact Versions.ID`) the message modifies, when the chat's\n     * routing decision (`EnableDecisionRouting`) confidently named one this agent produced. MJ's\n     * own path continues from that version instead of the agent's latest output. Null otherwise.\n     */\n    TargetArtifactVersionId: string | null;\n}\n\n/** What an {@link AgentTurnHandler} reports back to the chat area. */\nexport interface AgentTurnResult {\n    /** False when the turn failed. The chat area shows {@link ErrorMessage} and writes nothing. */\n    Success: boolean;\n    /** Why the turn failed, shown to the person. */\n    ErrorMessage?: string;\n    /**\n     * The rows the host wrote for the turn, oldest first: the agent's reply and any status rows.\n     * The chat area loads and shows them. A row still `In-Progress` is followed like any other\n     * in-progress reply. The host reports that row's live status through `AgentRunStatusPublisher`\n     * (`@memberjunction/server`) on the caller's session: significant-step progress, streamed text,\n     * the partial result, and the completion. The completion's `conversationDetailId` is the reply row.\n     */\n    ReplyDetailIds?: string[];\n    /** The agent run, when the host has one. Carried on `AfterAgentTurn`. */\n    AgentRunId?: string;\n    /** The agent's result, when the host has one. `AfterAgentTurn` fires only when it's present. */\n    Result?: ExecuteAgentResult;\n}\n\n/**\n * Runs an agent turn on the host's server instead of MJ's own path. The chat area calls it once\n * per turn, after `BeforeAgentTurn` and before any reply row exists, and shows the rows it reports.\n */\nexport type AgentTurnHandler = (request: AgentTurnRequest) => Promise<AgentTurnResult>;\n"]}

package/dist/lib/models/collection-view.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-view.model.js","sourceRoot":"","sources":["../../../src/lib/models/collection-view.model.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * View modes for collections display\n */\nexport type CollectionViewMode = 'grid' | 'list';\n\n/**\n * Sort options for collections view\n */\nexport type CollectionSortBy = 'name' | 'date' | 'type';\nexport type CollectionSortOrder = 'asc' | 'desc';\n\n/**\n * Unified item type for displaying both collections and artifacts together\n */\nexport interface CollectionViewItem {\n  type: 'folder' | 'artifact';\n  id: string;\n  name: string;\n  description?: string;\n  icon: string;\n  selected?: boolean; // For multi-select\n\n  // Folder-specific\n  itemCount?: number;\n  owner?: string;\n  isShared?: boolean;\n\n  // Artifact-specific\n  versionNumber?: number;\n  artifactType?: string;\n  lastModified?: Date;\n\n  // Original entities for actions\n  collection?: any;\n  artifact?: any;\n  version?: any;\n}\n"]}
+{"version":3,"file":"collection-view.model.js","sourceRoot":"","sources":["../../../src/lib/models/collection-view.model.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * View modes for collections display\n */\nexport type CollectionViewMode = 'grid' | 'list';\n\n/**\n * Sort options for collections view\n */\nexport type CollectionSortBy = 'name' | 'date' | 'type';\nexport type CollectionSortOrder = 'asc' | 'desc';\n\n/**\n * Unified item type for displaying both collections and artifacts together\n */\nexport interface CollectionViewItem {\n  type: 'folder' | 'artifact';  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  id: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  name: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  description?: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  icon: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  selected?: boolean; // For multi-select — case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n\n  // Folder-specific\n  itemCount?: number;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  owner?: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  isShared?: boolean;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n\n  // Artifact-specific\n  versionNumber?: number;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  artifactType?: string;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  lastModified?: Date;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n\n  // Original entities for actions\n  collection?: any;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  artifact?: any;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n  version?: any;  // case-violation-ok-legacy-back-compat: the type is named in an exported signature, so consumers build object literals against it; an interface has no runtime carrier for a stub\n}\n"]}

package/dist/lib/models/conversation-state.model.d.ts

@@ -78,6 +78,14 @@ export type ArtifactSortBy = 'name' | 'date' | 'type' | 'modified';
  * Grouping options for conversations
  */
 export type ConversationGroupBy = 'project' | 'date' | 'none';
+/**
+ * Field the conversation list is sorted on.
+ */
+export type ConversationSortBy = 'date' | 'name';
+/**
+ * Direction of the conversation list sort.
+ */
+export type ConversationSortDirection = 'asc' | 'desc';
 /**
  * Type of entity being mentioned
  */

package/dist/lib/models/conversation-state.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-state.model.d.ts","sourceRoot":"","sources":["../../../src/lib/models/conversation-state.model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,EAAE;QACT,0BAA0B;QAC1B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,2CAA2C;QAC3C,OAAO,EAAE,uBAAuB,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC7D,yDAAyD;IACzD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE;QAC/B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,OAAO,EAAE,uBAAuB,CAAC;KAClC,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"conversation-state.model.d.ts","sourceRoot":"","sources":["../../../src/lib/models/conversation-state.model.ts"],"names":[],"mappings":"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"}

package/dist/lib/models/conversation-state.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-state.model.js","sourceRoot":"","sources":["../../../src/lib/models/conversation-state.model.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  MJArtifactEntity,\n  MJArtifactVersionEntity\n} from '@memberjunction/core-entities';\n\nimport {\n  MJAIAgentRunEntityExtended\n} from \"@memberjunction/ai-core-plus\";\n\n/**\n * Peripheral data loaded for a conversation detail message\n * Contains related entities like agent runs and artifacts\n */\nexport interface ConversationDetailPeripheralData {\n  /** Agent run information if this message was generated by an agent */\n  agentRun?: MJAIAgentRunEntityExtended;\n  /** Artifact information if this message has an output artifact */\n  artifact?: {\n    /** The artifact entity */\n    artifact: MJArtifactEntity;\n    /** The specific version of the artifact */\n    version: MJArtifactVersionEntity;\n  };\n}\n\n/**\n * Type-safe maps for peripheral data indexed by ConversationDetailID\n */\nexport interface PeripheralDataMaps {\n  /** Map of ConversationDetailID -> AIAgentRun */\n  agentRunsByDetailId: Map<string, MJAIAgentRunEntityExtended>;\n  /** Map of ConversationDetailID -> {artifact, version} */\n  artifactsByDetailId: Map<string, {\n    artifact: MJArtifactEntity;\n    version: MJArtifactVersionEntity;\n  }>;\n}\n\n/**\n * Represents an active agent process\n */\nexport interface AgentProcess {\n  id: string;\n  agentId: string;\n  agentName: string;\n  agentColor: string;\n  status: 'pending' | 'in_progress' | 'complete' | 'failed';\n  message: string;\n  progress?: number;\n  startedAt: Date;\n}\n\n/**\n * Options for filtering tasks\n */\nexport interface TaskFilters {\n  status?: string[];\n  projectId?: string;\n  assignedToUserId?: string;\n  assignedToAgentId?: string;\n  environmentId?: string;\n}\n\n/**\n * Options for creating public links\n */\nexport interface PublicLinkOptions {\n  password?: string;\n  expiresAt?: Date;\n  maxViews?: number;\n}\n\n/**\n * Tab types for the main navigation\n */\nexport type NavigationTab = 'conversations' | 'collections' | 'tasks';\n\n/**\n * Layout modes for the workspace\n */\nexport type WorkspaceLayout = 'full' | 'compact' | 'embedded';\n\n/**\n * View modes for collections\n */\nexport type CollectionViewMode = 'grid' | 'list';\n\n/**\n * Sort options for artifacts\n */\nexport type ArtifactSortBy = 'name' | 'date' | 'type' | 'modified';\n\n/**\n * Grouping options for conversations\n */\nexport type ConversationGroupBy = 'project' | 'date' | 'none';\n\n/**\n * Type of entity being mentioned\n */\nexport type MentionType = 'agent' | 'user' | 'entity' | 'query' | 'skill';\n\n/**\n * Represents a mention in a message (@Agent, @User, #Entity, or /Skill)\n */\nexport interface Mention {\n  type: MentionType;\n  id: string;\n  name: string;\n  configurationId?: string; // Optional AI configuration preset ID for agents\n}\n\n/**\n * Result of parsing mentions from a message.\n * Structurally mirrors `MentionParseResult` from `@memberjunction/conversations-runtime`\n * (deliberate duplicate — cross-package re-exports are prohibited). Keep in sync.\n */\nexport interface MentionParseResult {\n  mentions: Mention[];\n  agentMention: Mention | null; // Single agent mention (first one found)\n  userMentions: Mention[]; // All user mentions\n  entityMentions: Mention[]; // All entity mentions (#Entity)\n  skillMentions: Mention[]; // All skill mentions (/Skill)\n}"]}
+{"version":3,"file":"conversation-state.model.js","sourceRoot":"","sources":["../../../src/lib/models/conversation-state.model.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  MJArtifactEntity,\n  MJArtifactVersionEntity\n} from '@memberjunction/core-entities';\n\nimport {\n  MJAIAgentRunEntityExtended\n} from \"@memberjunction/ai-core-plus\";\n\n/**\n * Peripheral data loaded for a conversation detail message\n * Contains related entities like agent runs and artifacts\n */\nexport interface ConversationDetailPeripheralData {\n  /** Agent run information if this message was generated by an agent */\n  agentRun?: MJAIAgentRunEntityExtended;\n  /** Artifact information if this message has an output artifact */\n  artifact?: {\n    /** The artifact entity */\n    artifact: MJArtifactEntity;\n    /** The specific version of the artifact */\n    version: MJArtifactVersionEntity;\n  };\n}\n\n/**\n * Type-safe maps for peripheral data indexed by ConversationDetailID\n */\nexport interface PeripheralDataMaps {\n  /** Map of ConversationDetailID -> AIAgentRun */\n  agentRunsByDetailId: Map<string, MJAIAgentRunEntityExtended>;\n  /** Map of ConversationDetailID -> {artifact, version} */\n  artifactsByDetailId: Map<string, {\n    artifact: MJArtifactEntity;\n    version: MJArtifactVersionEntity;\n  }>;\n}\n\n/**\n * Represents an active agent process\n */\nexport interface AgentProcess {\n  id: string;\n  agentId: string;\n  agentName: string;\n  agentColor: string;\n  status: 'pending' | 'in_progress' | 'complete' | 'failed';\n  message: string;\n  progress?: number;\n  startedAt: Date;\n}\n\n/**\n * Options for filtering tasks\n */\nexport interface TaskFilters {\n  status?: string[];\n  projectId?: string;\n  assignedToUserId?: string;\n  assignedToAgentId?: string;\n  environmentId?: string;\n}\n\n/**\n * Options for creating public links\n */\nexport interface PublicLinkOptions {\n  password?: string;\n  expiresAt?: Date;\n  maxViews?: number;\n}\n\n/**\n * Tab types for the main navigation\n */\nexport type NavigationTab = 'conversations' | 'collections' | 'tasks';\n\n/**\n * Layout modes for the workspace\n */\nexport type WorkspaceLayout = 'full' | 'compact' | 'embedded';\n\n/**\n * View modes for collections\n */\nexport type CollectionViewMode = 'grid' | 'list';\n\n/**\n * Sort options for artifacts\n */\nexport type ArtifactSortBy = 'name' | 'date' | 'type' | 'modified';\n\n/**\n * Grouping options for conversations\n */\nexport type ConversationGroupBy = 'project' | 'date' | 'none';\n\n/**\n * Field the conversation list is sorted on.\n */\nexport type ConversationSortBy = 'date' | 'name';\n\n/**\n * Direction of the conversation list sort.\n */\nexport type ConversationSortDirection = 'asc' | 'desc';\n\n/**\n * Type of entity being mentioned\n */\nexport type MentionType = 'agent' | 'user' | 'entity' | 'query' | 'skill';\n\n/**\n * Represents a mention in a message (@Agent, @User, #Entity, or /Skill)\n */\nexport interface Mention {\n  type: MentionType;\n  id: string;\n  name: string;\n  configurationId?: string; // Optional AI configuration preset ID for agents\n}\n\n/**\n * Result of parsing mentions from a message.\n * Structurally mirrors `MentionParseResult` from `@memberjunction/conversations-runtime`\n * (deliberate duplicate — cross-package re-exports are prohibited). Keep in sync.\n */\nexport interface MentionParseResult {\n  mentions: Mention[];\n  agentMention: Mention | null; // Single agent mention (first one found)\n  userMentions: Mention[]; // All user mentions\n  entityMentions: Mention[]; // All entity mentions (#Entity)\n  skillMentions: Mention[]; // All skill mentions (/Skill)\n}"]}