@memberjunction/ai-agents 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/prior-turn-tool-result-cache.d.ts

@@ -20,6 +20,13 @@ import { CarryForwardStepRecord } from './tool-result-format.js';
  * - Entries are keyed by conversation AND agent, mirroring the DB path's `AgentID`
  *   filter — in a multi-agent conversation, agent B must never inherit agent A's
  *   results labeled "your previous turn".
+ * - Entries are also keyed by branch, mirroring the DB path's branch-path filter — a
+ *   run never inherits results from a run whose reply row is off its path. A branch with
+ *   no entry yet falls back to the DB path, which can return a trunk run from before the fork.
+ * - Entries carry the reply row of the run that stored them. When a save on this server
+ *   marks that row replaced (`ReplacedAt` set by an in-place rerun of its turn), the entry
+ *   is no longer served, just as the DB path leaves out runs whose reply row is replaced:
+ *   a replaced answer's tool results are never carried forward.
  * - Values are the raw completed-`Tool`-step `OutputData` projections; eligibility is
  *   still decided downstream by `BuildPriorTurnToolResultsMessage` via `toolFamily`,
  *   identical for cached and DB-loaded records.
@@ -38,9 +45,14 @@ import { CarryForwardStepRecord } from './tool-result-format.js';
  * the TTL bounds the staleness window, and each node self-heals on its next completed
  * run for that conversation — so the fallback keeps the default single-node deployment
  * exact while multi-node degrades gracefully rather than paying the queries every turn.
+ * The replaced-row rule has the same limit: a replacement saved on another server is not
+ * seen here, so this node can still serve that run's entry until it expires or is replaced.
  */
 export declare class PriorTurnToolResultCache extends BaseSingleton<PriorTurnToolResultCache> {
-    /** Protected per the {@link BaseSingleton} contract — obtain via {@link Instance}. */
+    /**
+     * Protected per the {@link BaseSingleton} contract — obtain via {@link Instance}. Listens for
+     * entity saves on this server to learn which conversation details were replaced.
+     */
     protected constructor();
     /** Process-wide singleton accessor (Global Object Store backed, bundler-duplication safe). */
     static get Instance(): PriorTurnToolResultCache;
@@ -51,21 +63,28 @@ export declare class PriorTurnToolResultCache extends BaseSingleton<PriorTurnToo
      * bounding the multi-node staleness window described above.
      */
     private cache;
-    /**
-     * Cache key: normalized conversation + agent, so agent B never inherits agent A's
-     * results in a multi-agent conversation. `::` is safe (UUIDs cannot contain it).
-     */
+    /** Normalized ids of conversation details replaced by an in-place rerun, seen on this server. */
+    private replacedDetails;
+    /** Key: conversation, agent and branch ('trunk' when none), so an entry serves only runs on the branch that stored it. */
     private static buildKey;
     /**
      * Returns the carry-forward records of this agent's most recent settled root run in
-     * the conversation on this node — `[]` means "settled with no tool results" (a
-     * valid, query-skipping answer); `undefined` means "not known here, ask the
-     * database".
+     * the conversation on this node, on one branch path (`branchId` null is the trunk) —
+     * `[]` means "settled with no tool results" (a valid, query-skipping answer);
+     * `undefined` means "not known here, ask the database". An entry whose run's reply row
+     * was replaced is dropped and reads as `undefined`.
+     */
+    Get(conversationId: string, agentId: string, branchId: string | null): CarryForwardStepRecord[] | undefined;
+    /**
+     * Records a settled root run's carry-forward projections (empty array included) for one branch path.
+     * `sourceDetailId` is the run's reply row; the entry is not served once that row is replaced.
      */
-    Get(conversationId: string, agentId: string): CarryForwardStepRecord[] | undefined;
-    /** Records a settled root run's carry-forward projections (empty array included). */
-    Set(conversationId: string, agentId: string, steps: CarryForwardStepRecord[]): void;
-    /** Drops every entry — test isolation hook. */
+    Set(conversationId: string, agentId: string, branchId: string | null, steps: CarryForwardStepRecord[], sourceDetailId?: string | null): void;
+    /** Records that an in-place rerun replaced a conversation detail; entries whose run replied with it are no longer served. */
+    MarkDetailReplaced(detailId: string): void;
+    /** Drops every entry and every replaced-detail mark — test isolation hook. */
     Clear(): void;
+    /** Marks a conversation detail replaced when a save on this server leaves its `ReplacedAt` set. */
+    private onGlobalEvent;
 }
 //# sourceMappingURL=prior-turn-tool-result-cache.d.ts.map

package/dist/prior-turn-tool-result-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prior-turn-tool-result-cache.d.ts","sourceRoot":"","sources":["../src/prior-turn-tool-result-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,wBAAyB,SAAQ,aAAa,CAAC,wBAAwB,CAAC;IACjF,sFAAsF;IACtF,SAAS;IAIT,8FAA8F;IAC9F,WAAkB,QAAQ,IAAI,wBAAwB,CAErD;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,CAGV;IAEH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB;;;;;OAKG;IACI,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE,GAAG,SAAS;IAIzF,qFAAqF;IAC9E,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAI1F,+CAA+C;IACxC,KAAK,IAAI,IAAI;CAGvB"}
+{"version":3,"file":"prior-turn-tool-result-cache.d.ts","sourceRoot":"","sources":["../src/prior-turn-tool-result-cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAkE,MAAM,wBAAwB,CAAC;AACvH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAS9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,wBAAyB,SAAQ,aAAa,CAAC,wBAAwB,CAAC;IACjF;;;OAGG;IACH,SAAS;IAKT,8FAA8F;IAC9F,WAAkB,QAAQ,IAAI,wBAAwB,CAErD;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,CAGV;IAEH,iGAAiG;IACjG,OAAO,CAAC,eAAe,CAAmD;IAE1E,0HAA0H;IAC1H,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB;;;;;;OAMG;IACI,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,sBAAsB,EAAE,GAAG,SAAS;IAalH;;;OAGG;IACI,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,cAAc,GAAE,MAAM,GAAG,IAAW,GAAG,IAAI;IAIzJ,6HAA6H;IACtH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjD,8EAA8E;IACvE,KAAK,IAAI,IAAI;IAKpB,mGAAmG;IACnG,OAAO,CAAC,aAAa;CAUxB"}

package/dist/prior-turn-tool-result-cache.js

@@ -1,4 +1,6 @@
-import { BaseSingleton, MJLruCache, NormalizeUUID } from '@memberjunction/global';
+import { BaseEntity } from '@memberjunction/core';
+import { ConversationEngine, MJConversationDetailEntity } from '@memberjunction/core-entities';
+import { BaseSingleton, MJEventType, MJGlobal, MJLruCache, NormalizeUUID } from '@memberjunction/global';
 /**
  * Process-wide cache of the most recent settled root run's Tool-step results per
  * conversation + agent, keeping the prior-turn carry-forward check off the database on
@@ -19,6 +21,13 @@ import { BaseSingleton, MJLruCache, NormalizeUUID } from '@memberjunction/global
  * - Entries are keyed by conversation AND agent, mirroring the DB path's `AgentID`
  *   filter — in a multi-agent conversation, agent B must never inherit agent A's
  *   results labeled "your previous turn".
+ * - Entries are also keyed by branch, mirroring the DB path's branch-path filter — a
+ *   run never inherits results from a run whose reply row is off its path. A branch with
+ *   no entry yet falls back to the DB path, which can return a trunk run from before the fork.
+ * - Entries carry the reply row of the run that stored them. When a save on this server
+ *   marks that row replaced (`ReplacedAt` set by an in-place rerun of its turn), the entry
+ *   is no longer served, just as the DB path leaves out runs whose reply row is replaced:
+ *   a replaced answer's tool results are never carried forward.
  * - Values are the raw completed-`Tool`-step `OutputData` projections; eligibility is
  *   still decided downstream by `BuildPriorTurnToolResultsMessage` via `toolFamily`,
  *   identical for cached and DB-loaded records.
@@ -37,9 +46,14 @@ import { BaseSingleton, MJLruCache, NormalizeUUID } from '@memberjunction/global
  * the TTL bounds the staleness window, and each node self-heals on its next completed
  * run for that conversation — so the fallback keeps the default single-node deployment
  * exact while multi-node degrades gracefully rather than paying the queries every turn.
+ * The replaced-row rule has the same limit: a replacement saved on another server is not
+ * seen here, so this node can still serve that run's entry until it expires or is replaced.
  */
 export class PriorTurnToolResultCache extends BaseSingleton {
-    /** Protected per the {@link BaseSingleton} contract — obtain via {@link Instance}. */
+    /**
+     * Protected per the {@link BaseSingleton} contract — obtain via {@link Instance}. Listens for
+     * entity saves on this server to learn which conversation details were replaced.
+     */
     constructor() {
         super();
         /**
@@ -52,34 +66,63 @@ export class PriorTurnToolResultCache extends BaseSingleton {
             maxSize: 500,
             ttlMs: 30 * 60 * 1000
         });
+        /** Normalized ids of conversation details replaced by an in-place rerun, seen on this server. */
+        this.replacedDetails = new MJLruCache({ maxSize: 5000 });
+        MJGlobal.Instance.GetEventListener(false).subscribe(event => this.onGlobalEvent(event));
     }
     /** Process-wide singleton accessor (Global Object Store backed, bundler-duplication safe). */
     static get Instance() {
         return super.getInstance();
     }
+    /** Key: conversation, agent and branch ('trunk' when none), so an entry serves only runs on the branch that stored it. */
+    static buildKey(conversationId, agentId, branchId) {
+        return `${NormalizeUUID(conversationId)}::${NormalizeUUID(agentId)}::${branchId ? NormalizeUUID(branchId) : 'trunk'}`;
+    }
     /**
-     * Cache key: normalized conversation + agent, so agent B never inherits agent A's
-     * results in a multi-agent conversation. `::` is safe (UUIDs cannot contain it).
+     * Returns the carry-forward records of this agent's most recent settled root run in
+     * the conversation on this node, on one branch path (`branchId` null is the trunk) —
+     * `[]` means "settled with no tool results" (a valid, query-skipping answer);
+     * `undefined` means "not known here, ask the database". An entry whose run's reply row
+     * was replaced is dropped and reads as `undefined`.
      */
-    static buildKey(conversationId, agentId) {
-        return `${NormalizeUUID(conversationId)}::${NormalizeUUID(agentId)}`;
+    Get(conversationId, agentId, branchId) {
+        const key = PriorTurnToolResultCache.buildKey(conversationId, agentId, branchId);
+        const entry = this.cache.Get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (entry.SourceDetailID && this.replacedDetails.Has(NormalizeUUID(entry.SourceDetailID))) {
+            this.cache.Delete(key);
+            return undefined;
+        }
+        return entry.Steps;
     }
     /**
-     * Returns the carry-forward records of this agent's most recent settled root run in
-     * the conversation on this node — `[]` means "settled with no tool results" (a
-     * valid, query-skipping answer); `undefined` means "not known here, ask the
-     * database".
+     * Records a settled root run's carry-forward projections (empty array included) for one branch path.
+     * `sourceDetailId` is the run's reply row; the entry is not served once that row is replaced.
      */
-    Get(conversationId, agentId) {
-        return this.cache.Get(PriorTurnToolResultCache.buildKey(conversationId, agentId));
+    Set(conversationId, agentId, branchId, steps, sourceDetailId = null) {
+        this.cache.Set(PriorTurnToolResultCache.buildKey(conversationId, agentId, branchId), { Steps: steps, SourceDetailID: sourceDetailId });
     }
-    /** Records a settled root run's carry-forward projections (empty array included). */
-    Set(conversationId, agentId, steps) {
-        this.cache.Set(PriorTurnToolResultCache.buildKey(conversationId, agentId), steps);
+    /** Records that an in-place rerun replaced a conversation detail; entries whose run replied with it are no longer served. */
+    MarkDetailReplaced(detailId) {
+        this.replacedDetails.Set(NormalizeUUID(detailId), true);
     }
-    /** Drops every entry — test isolation hook. */
+    /** Drops every entry and every replaced-detail mark — test isolation hook. */
     Clear() {
         this.cache.Clear();
+        this.replacedDetails.Clear();
+    }
+    /** Marks a conversation detail replaced when a save on this server leaves its `ReplacedAt` set. */
+    onGlobalEvent(event) {
+        if (event.event !== MJEventType.ComponentEvent || event.eventCode !== BaseEntity.BaseEventCode) {
+            return;
+        }
+        const entityEvent = event.args;
+        const detail = entityEvent?.baseEntity;
+        if (entityEvent?.type === 'save' && detail instanceof MJConversationDetailEntity && ConversationEngine.IsReplacedRow(detail)) {
+            this.MarkDetailReplaced(detail.ID);
+        }
     }
 }
 //# sourceMappingURL=prior-turn-tool-result-cache.js.map

package/dist/prior-turn-tool-result-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"prior-turn-tool-result-cache.js","sourceRoot":"","sources":["../src/prior-turn-tool-result-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,wBAAyB,SAAQ,aAAuC;IACjF,sFAAsF;IACtF;QACI,KAAK,EAAE,CAAC;QAQZ;;;;;WAKG;QACK,UAAK,GAAG,IAAI,UAAU,CAAmC;YAC7D,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;SACxB,CAAC,CAAC;IAhBH,CAAC;IAED,8FAA8F;IACvF,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAA4B,CAAC;IACzD,CAAC;IAaD;;;OAGG;IACK,MAAM,CAAC,QAAQ,CAAC,cAAsB,EAAE,OAAe;QAC3D,OAAO,GAAG,aAAa,CAAC,cAAc,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,cAAsB,EAAE,OAAe;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,qFAAqF;IAC9E,GAAG,CAAC,cAAsB,EAAE,OAAe,EAAE,KAA+B;QAC/E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACtF,CAAC;IAED,+CAA+C;IACxC,KAAK;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ"}
+{"version":3,"file":"prior-turn-tool-result-cache.js","sourceRoot":"","sources":["../src/prior-turn-tool-result-cache.ts"],"names":[],"mappings":"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"}

package/dist/realtime/bridge-host-params.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Type guards for the host-supplied extras that ride `ExecuteAgentParams.data` into a bridged
+ * realtime session (`realtimeHostTools`, `realtimeHostFraming`, `realtimePriorTranscript`, `conversationId`).
+ *
+ * `data` is an open bag, so a value of the wrong shape is possible (a host bug, a stale caller). A malformed
+ * value is ignored and logged rather than thrown on, so one bad optional extra cannot fail a call.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import type { RealtimeToolDefinition } from '@memberjunction/ai';
+/**
+ * Reads `data.realtimeHostTools`. Absent yields `undefined`; a value that is not an array of well-formed tool
+ * definitions is ignored (logged) as a whole, so the model never sees a half-valid tool set.
+ */
+export declare function ReadHostTools(value: unknown): RealtimeToolDefinition[] | undefined;
+/**
+ * Reads a trimmed, non-empty string from the data bag. Absent or blank yields `undefined`; a non-string value is
+ * ignored and logged under `name`.
+ */
+export declare function ReadTrimmedString(value: unknown, name: string): string | undefined;
+//# sourceMappingURL=bridge-host-params.d.ts.map

package/dist/realtime/bridge-host-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-host-params.d.ts","sourceRoot":"","sources":["../../src/realtime/bridge-host-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAkBjE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,EAAE,GAAG,SAAS,CASlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASlF"}

package/dist/realtime/bridge-host-params.js

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Type guards for the host-supplied extras that ride `ExecuteAgentParams.data` into a bridged
+ * realtime session (`realtimeHostTools`, `realtimeHostFraming`, `realtimePriorTranscript`, `conversationId`).
+ *
+ * `data` is an open bag, so a value of the wrong shape is possible (a host bug, a stale caller). A malformed
+ * value is ignored and logged rather than thrown on, so one bad optional extra cannot fail a call.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { LogError } from '@memberjunction/core';
+/** Whether a value is a well-formed tool definition (a name, a description, and an object parameter schema). */
+function isToolDefinition(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.Name === 'string' &&
+        candidate.Name.trim().length > 0 &&
+        typeof candidate.Description === 'string' &&
+        typeof candidate.ParametersSchema === 'object' &&
+        candidate.ParametersSchema !== null &&
+        !Array.isArray(candidate.ParametersSchema));
+}
+/**
+ * Reads `data.realtimeHostTools`. Absent yields `undefined`; a value that is not an array of well-formed tool
+ * definitions is ignored (logged) as a whole, so the model never sees a half-valid tool set.
+ */
+export function ReadHostTools(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value) || !value.every(isToolDefinition)) {
+        LogError('[BridgeRealtime] ignoring malformed realtimeHostTools (expected an array of { Name, Description, ParametersSchema }).');
+        return undefined;
+    }
+    return value.length > 0 ? value : undefined;
+}
+/**
+ * Reads a trimmed, non-empty string from the data bag. Absent or blank yields `undefined`; a non-string value is
+ * ignored and logged under `name`.
+ */
+export function ReadTrimmedString(value, name) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        LogError(`[BridgeRealtime] ignoring ${name}: expected a string, got ${typeof value}.`);
+        return undefined;
+    }
+    return value.trim() || undefined;
+}
+//# sourceMappingURL=bridge-host-params.js.map

package/dist/realtime/bridge-host-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-host-params.js","sourceRoot":"","sources":["../../src/realtime/bridge-host-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,gHAAgH;AAChH,SAAS,gBAAgB,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,SAAS,GAAG,KAA+D,CAAC;IAClF,OAAO,CACH,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAChC,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;QACzC,OAAO,SAAS,CAAC,gBAAgB,KAAK,QAAQ;QAC9C,SAAS,CAAC,gBAAgB,KAAK,IAAI;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAC7C,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,uHAAuH,CAAC,CAAC;QAClI,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,IAAY;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,QAAQ,CAAC,6BAA6B,IAAI,4BAA4B,OAAO,KAAK,GAAG,CAAC,CAAC;QACvF,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AACrC,CAAC"}

package/dist/realtime/bridge-realtime-session-factory.d.ts

@@ -16,8 +16,9 @@
  * @module @memberjunction/ai-agents
  * @author MemberJunction.com
  */
-import { IRealtimeSession, RealtimeVoiceOption, AIAPIKeyResolver } from '@memberjunction/ai';
+import { IRealtimeSession, ChatMessage, RealtimeVoiceOption, RealtimeToolDefinition, AIAPIKeyResolver } from '@memberjunction/ai';
 import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { RealtimeHostToolsResolver } from './realtime-client-session-service.js';
 /**
  * The context a bridge passes to {@link CreateBridgeRealtimeSession}. Structurally compatible with the
  * LiveKit coordinator's `RealtimeSessionStartContext` (and any future bridge's equivalent) so this factory
@@ -64,6 +65,40 @@ export interface BridgeRealtimeSessionContext {
     MeetingMode?: boolean;
     /** The names the agent answers to (display name + aliases) — phrasing for the meeting prompt only. */
     SelfNames?: string[];
+    /**
+     * Tools the host declares and executes itself (a phone call's `transfer_call` / `send_dtmf` / `end_call`).
+     * Added to the model's tool set; executed through the runtime's local tool handler
+     * (see `GetBridgeRealtimeRuntime`).
+     */
+    HostTools?: RealtimeToolDefinition[];
+    /**
+     * Optional callback that allows the host to resolve host tools dynamically based on
+     * the model, vendor, and driver actually resolved for the session, before session opening.
+     */
+    ResolveHostTools?: RealtimeHostToolsResolver;
+    /** Host-authored instructions appended to the system prompt (e.g. the phone-call and caller framing). */
+    HostFraming?: string;
+    /**
+     * Role-tagged transcript lines (`User: …` / `Assistant: …`) of the conversation so far, framed into the
+     * prompt as "earlier in this conversation". Set when a lost model session is re-opened mid-call so the new
+     * session remembers what was said.
+     */
+    PriorTranscript?: string;
+    /** Earlier turns to seed the model's context. Defaults to none (a fresh call has no history). */
+    ConversationMessages?: ChatMessage[];
+    /** The `MJ: Conversations` row the session writes to — stamped on the co-agent observability run. */
+    ConversationID?: string;
+    /**
+     * `'room'` when the bridge's bot can publish the agent's avatar into the room (the LiveKit coordinator asks its native
+     * module first). Flows to the session's avatar request, so the driver may render it. Absent: audio only.
+     */
+    AvatarDelivery?: 'room';
+    /**
+     * `true` when the session is a phone call (a carrier call, or a SIP call in a LiveKit room). Flows to
+     * `params.data.realtimePhoneCall`: the session then asks the driver for no avatar (the caller sees no video) and
+     * reports `phone` as its avatar status.
+     */
+    PhoneCall?: boolean;
 }
 /**
  * Opens a raw {@link IRealtimeSession} for the agent named in `ctx`. Bind this onto a bridge's
@@ -88,20 +123,45 @@ export declare function CreateBridgeRealtimeSession(ctx: BridgeRealtimeSessionCo
  * @param provider The metadata provider (required — skipped without it).
  */
 export declare function FinalizeBridgeCoAgentRuns(agentSessionID: string, success: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
+/**
+ * A voice the dev model/voice picker offers: one per persona, or one per voice only the driver declares. Two personas can
+ * share a voice `ID` (a voice, and the same voice with a face), so {@link PersonaID} tells them apart. A persona voice also
+ * carries the avatar that comes with it and the persona's preview image; a voice only the driver declares carries none of
+ * the three.
+ */
+export interface RealtimeModelVoiceOption extends RealtimeVoiceOption {
+    /** The persona this voice belongs to (`MJ: AI Personas.ID`). Absent for a voice only the driver declares. */
+    PersonaID?: string;
+    /**
+     * The avatar that comes with this voice: the `APIName` of the persona's preset Video binding on the model's vendor,
+     * which is what `realtime.video.avatarId` takes. Absent when the persona has no such binding there, or only a custom
+     * one (custom avatars are not supported), and on a model that shows no avatar there (its Video/Output row turns
+     * video off, or its driver renders none on that vendor's endpoint).
+     */
+    AvatarID?: string;
+    /** The persona's preview image (`MJ: AI Personas.PreviewImageURL`), when it has one. */
+    PreviewImageURL?: string;
+}
 /** An active Realtime model paired with the voices its driver supports — for the dev model/voice picker. */
 export interface RealtimeModelVoices {
     /** The `MJ: AI Models` row id. */
     ModelID: string;
     /** The model's display name. */
     ModelName: string;
-    /** The provider-native voices the model's driver declares (empty when it declares none). */
-    Voices: RealtimeVoiceOption[];
+    /** The model's persona voices on its vendor, then the driver's other voices (empty when there are none). */
+    Voices: RealtimeModelVoiceOption[];
 }
 /**
  * Enumerates the active Realtime models with each driver's supported voices — the source for the dev
  * model/voice picker. Only models with an Active vendor + resolvable API key + ClassFactory driver are
  * returned (a model you can't actually run isn't worth offering). Voices come from the driver
  * ({@link BaseRealtimeModel.SupportedVoices}) — the near-term, driver-owned source of truth.
+ * A persona voice whose persona also has a preset Video binding on the same vendor names that avatar
+ * ({@link RealtimeModelVoiceOption.AvatarID}), when the model shows avatars on that vendor
+ * ({@link RealtimeModelShowsAvatar}: its Video/Output row allows video or it has none, and the driver
+ * renders avatars on its endpoint); driver voices never do. So the picker marks a voice "Comes with an
+ * avatar" only where a call can show one. A persona with a face doesn't stand in for its plain voice, so
+ * the plain voice is listed too.
  *
  * @param contextUser The user the engine config runs as (server-side).
  * @param provider The request-scoped metadata provider (multi-provider safe).

package/dist/realtime/bridge-realtime-session-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-realtime-session-factory.d.ts","sourceRoot":"","sources":["../../src/realtime/bridge-realtime-session-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAkC,mBAAmB,EAAE,gBAAgB,EAAwB,MAAM,oBAAoB,CAAC;AACnJ,OAAO,EAAE,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQ7E;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,4BAA4B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8E9G;AA8BD;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC3C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,4GAA4G;AAC5G,MAAM,WAAW,mBAAmB;IAChC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,MAAM,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CACxC,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,aAAa,GAAE,gBAAyC,GACzD,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA8ChC"}
+{"version":3,"file":"bridge-realtime-session-factory.d.ts","sourceRoot":"","sources":["../../src/realtime/bridge-realtime-session-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAqB,mBAAmB,EAAE,sBAAsB,EAAE,gBAAgB,EAAwB,MAAM,oBAAoB,CAAC;AAC3K,OAAO,EAAE,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAM7E,OAAO,EAAgC,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAI5G;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC;IACrC,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,4BAA4B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+E9G;AAmDD;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC3C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACjE,6GAA6G;IAC7G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4GAA4G;AAC5G,MAAM,WAAW,mBAAmB;IAChC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,4GAA4G;IAC5G,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,sBAAsB,CACxC,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,aAAa,GAAE,gBAAyC,GACzD,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA+BhC"}

package/dist/realtime/bridge-realtime-session-factory.js

@@ -18,11 +18,12 @@
  */
 import { BaseRealtimeModel, MakeAIAPIKeyResolver } from '@memberjunction/ai';
 import { Metadata } from '@memberjunction/core';
-import { MJGlobal, UUIDsEqual } from '@memberjunction/global';
+import { MJGlobal, UUIDsEqual, IndexByUUID } from '@memberjunction/global';
 import { AIEngine } from '@memberjunction/aiengine';
 import { BaseAgent } from '../base-agent.js';
 import { RealtimeClientSessionService } from './realtime-client-session-service.js';
 import { SelectRealtimeVendorForModel } from './realtime-vendor-resolution.js';
+import { RealtimeModelShowsAvatar } from './realtime-video-output-gate.js';
 /**
  * Opens a raw {@link IRealtimeSession} for the agent named in `ctx`. Bind this onto a bridge's
  * session-factory seam (e.g. `LiveKitAgentRoomCoordinator.Instance.SetSessionFactory(CreateBridgeRealtimeSession)`).
@@ -97,8 +98,9 @@ export async function CreateBridgeRealtimeSession(ctx) {
         agent,
         contextUser: ctx.ContextUser,
         provider,
-        // A fresh bridge session starts with no prior turns; memory context degrades gracefully to empty.
-        conversationMessages: [],
+        // A fresh bridge session starts with no prior turns; memory context degrades gracefully to empty. A
+        // re-opened session (model-drop recovery) is given what was said so far via PriorTranscript instead.
+        conversationMessages: ctx.ConversationMessages ?? [],
         // Realtime extras ride params.data: the TARGET agent the co-agent voices via `invoke-target-agent`
         // (without it the co-agent stays idle), plus optional per-session dev overrides for the model/voice
         // so two agents in the same room can sound distinct. Omitted keys are simply absent.
@@ -127,9 +129,30 @@ function buildRealtimeData(ctx) {
     if (ctx.MeetingMode === true) {
         data.realtimeMeetingMode = true;
     }
+    if (ctx.HostTools && ctx.HostTools.length > 0) {
+        data.realtimeHostTools = ctx.HostTools;
+    }
+    if (ctx.ResolveHostTools) {
+        data.resolveHostTools = ctx.ResolveHostTools;
+    }
+    if (ctx.HostFraming && ctx.HostFraming.trim().length > 0) {
+        data.realtimeHostFraming = ctx.HostFraming.trim();
+    }
+    if (ctx.PriorTranscript && ctx.PriorTranscript.trim().length > 0) {
+        data.realtimePriorTranscript = ctx.PriorTranscript.trim();
+    }
+    if (ctx.ConversationID && ctx.ConversationID.trim().length > 0) {
+        data.conversationId = ctx.ConversationID.trim();
+    }
     if (ctx.SelfNames && ctx.SelfNames.length > 0) {
         data.realtimeSelfNames = ctx.SelfNames;
     }
+    if (ctx.AvatarDelivery === 'room') {
+        data.realtimeAvatarDelivery = 'room';
+    }
+    if (ctx.PhoneCall === true) {
+        data.realtimePhoneCall = true;
+    }
     return Object.keys(data).length > 0 ? data : undefined;
 }
 /**
@@ -155,6 +178,12 @@ export async function FinalizeBridgeCoAgentRuns(agentSessionID, success, context
  * model/voice picker. Only models with an Active vendor + resolvable API key + ClassFactory driver are
  * returned (a model you can't actually run isn't worth offering). Voices come from the driver
  * ({@link BaseRealtimeModel.SupportedVoices}) — the near-term, driver-owned source of truth.
+ * A persona voice whose persona also has a preset Video binding on the same vendor names that avatar
+ * ({@link RealtimeModelVoiceOption.AvatarID}), when the model shows avatars on that vendor
+ * ({@link RealtimeModelShowsAvatar}: its Video/Output row allows video or it has none, and the driver
+ * renders avatars on its endpoint); driver voices never do. So the picker marks a voice "Comes with an
+ * avatar" only where a call can show one. A persona with a face doesn't stand in for its plain voice, so
+ * the plain voice is listed too.
  *
  * @param contextUser The user the engine config runs as (server-side).
  * @param provider The request-scoped metadata provider (multi-provider safe).
@@ -176,30 +205,62 @@ export async function GetRealtimeModelVoices(contextUser, provider, resolveAPIKe
         if (!driverClass) {
             continue; // no active vendor with a resolvable key — not runnable, so omit
         }
-        // 1. Consult metadata first (Personas & PersonaVendors carry curated names/descriptions)
-        const modelPersonas = AIEngine.Instance.GetModelPersonas(model.ID, 'Audio', selection.VendorID);
-        const voices = modelPersonas.map((rp) => ({
-            ID: rp.PersonaVendor.APIName,
-            Name: rp.Persona.Name,
-        }));
-        // Collect explicitly excluded voice IDs (IsSupported === false) for this model and vendor
-        const excludedVoiceApiNames = new Set(AIEngine.Instance.GetModelPersonaExclusions(model.ID, 'Audio', selection.VendorID)
-            .map((name) => name.toLowerCase()));
-        // 2. Union with driver SupportedVoices: append any driver voices not already present or explicitly excluded
         const instance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseRealtimeModel, driverClass, resolveAPIKey(driverClass));
-        for (const dv of instance?.SupportedVoices ?? []) {
-            const dvIdLower = dv.ID.toLowerCase();
-            if (excludedVoiceApiNames.has(dvIdLower)) {
-                continue;
-            }
-            if (!voices.some((v) => v.ID.toLowerCase() === dvIdLower)) {
-                voices.push(dv);
-            }
-        }
+        // 1. Consult metadata first (Personas & PersonaVendors carry curated names/descriptions, and avatars where the
+        //    model shows them on this vendor)
+        const showsAvatar = instance ? RealtimeModelShowsAvatar({ ModelID: model.ID, APIName: selection.APIName, Model: instance }, AIEngine.Instance) : false;
+        const voices = personaVoiceOptions(model.ID, selection.VendorID, showsAvatar);
+        // 2. Union with driver SupportedVoices: append the driver voices no persona offers plainly, unless excluded
+        appendDriverVoices(voices, instance?.SupportedVoices ?? [], model.ID, selection.VendorID);
         out.push({ ModelID: model.ID, ModelName: model.Name ?? '', Voices: voices });
     }
     return out;
 }
+/**
+ * Appends the driver's voices that no persona already offers as a plain voice (without a face), skipping the ones the
+ * model explicitly excludes (`IsSupported === false`). A persona with a face doesn't stand in for its plain voice, so the
+ * voice stays pickable without the face. Driver voices have no persona: no avatar, no image.
+ */
+function appendDriverVoices(voices, driverVoices, modelID, vendorID) {
+    const excluded = new Set(AIEngine.Instance.GetModelPersonaExclusions(modelID, 'Audio', vendorID).map((name) => name.toLowerCase()));
+    for (const dv of driverVoices) {
+        const id = dv.ID.toLowerCase();
+        if (!excluded.has(id) && !voices.some((v) => !v.AvatarID && v.ID.toLowerCase() === id)) {
+            voices.push({ ID: dv.ID, Name: dv.Name });
+        }
+    }
+}
+/**
+ * The model's persona voices on a vendor, one per persona, in persona order. On a model that shows avatars there, a
+ * persona whose preset Video binding on the same vendor the model supports carries that binding's `APIName` as its avatar
+ * (the face the session asks for when the voice is picked); a binding on any other vendor doesn't count, nor does a custom
+ * one, and with no vendor there is nothing to match. On a model that shows none, no voice comes with an avatar.
+ *
+ * @param showsAvatar Whether the model shows avatars on this vendor ({@link RealtimeModelShowsAvatar}).
+ */
+function personaVoiceOptions(modelID, vendorID, showsAvatar) {
+    const faces = vendorID && showsAvatar ? AIEngine.Instance.GetModelPersonas(modelID, 'Video', vendorID).filter(isPresetFace) : [];
+    // First face per persona wins, as faces.find() would.
+    const facesByPersona = IndexByUUID(faces, (f) => f.Persona.ID);
+    return AIEngine.Instance.GetModelPersonas(modelID, 'Audio', vendorID).map((voice) => {
+        const face = facesByPersona.Get(voice.Persona.ID);
+        const image = voice.Persona.PreviewImageURL?.trim();
+        return {
+            ID: voice.PersonaVendor.APIName,
+            Name: voice.Persona.Name,
+            PersonaID: voice.Persona.ID,
+            ...(face ? { AvatarID: face.PersonaVendor.APIName.trim() } : {}),
+            ...(image ? { PreviewImageURL: image } : {}),
+        };
+    });
+}
+/**
+ * Whether a Video binding is a face a picked voice can bring: a preset (`Avatar.Kind` absent or `'preset'`). Custom avatars
+ * are not supported, so a session asking for one would stay audio only.
+ */
+function isPresetFace(face) {
+    return (face.PersonaVendor.VendorSettingsObject?.Avatar?.Kind ?? 'preset') !== 'custom';
+}
 /** Resolves the agent entity from the engine cache by id (preferred), then by case-insensitive name. */
 function resolveAgentEntity(ctx) {
     const agents = AIEngine.Instance.Agents;

package/dist/realtime/bridge-realtime-session-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-realtime-session-factory.js","sourceRoot":"","sources":["../../src/realtime/bridge-realtime-session-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bridge-realtime-session-factory.js","sourceRoot":"","sources":["../../src/realtime/bridge-realtime-session-factory.ts"],"names":[],"mappings":"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"}