@memberjunction/ng-conversations 5.40.2 → 5.41.0

package/dist/__tests__/realtime-disclosure.test.js

@@ -0,0 +1,164 @@
+/**
+ * Unit tests for the realtime overlay's PROGRESSIVE DISCLOSURE engine — the
+ * framework-free levels/milestones model behind the pure-audio-first call UX
+ * (persisted per-user via UserInfoEngine under `mj.realtimeVoice.uxMilestones.v1`).
+ */
+import { describe, it, expect } from 'vitest';
+import { ClampUxLevel, DefaultUxMilestones, EffectiveBaseLevel, ParseUxMilestones, RatchetedMilestones, RealtimeDisclosureModel, SerializeUxMilestones, REALTIME_UX_MAX_LEVEL, REALTIME_UX_PREF_KEY, REALTIME_UX_PRO_CALLS } from '../lib/components/realtime/realtime-disclosure';
+describe('pref key', () => {
+    it('uses the versioned mj.* naming convention', () => {
+        expect(REALTIME_UX_PREF_KEY).toBe('mj.realtimeVoice.uxMilestones.v1');
+    });
+});
+describe('ClampUxLevel', () => {
+    it('passes valid levels through and clamps the band edges', () => {
+        expect(ClampUxLevel(0)).toBe(0);
+        expect(ClampUxLevel(3)).toBe(3);
+        expect(ClampUxLevel(-2)).toBe(0);
+        expect(ClampUxLevel(9)).toBe(REALTIME_UX_MAX_LEVEL);
+    });
+    it('rounds fractional and zeroes non-finite levels', () => {
+        expect(ClampUxLevel(2.6)).toBe(3);
+        expect(ClampUxLevel(NaN)).toBe(0);
+        expect(ClampUxLevel(Infinity)).toBe(0);
+    });
+});
+describe('ParseUxMilestones / SerializeUxMilestones', () => {
+    it('round-trips milestones', () => {
+        const m = { Level: 3, Calls: 7, Density: 'pro' };
+        expect(ParseUxMilestones(SerializeUxMilestones(m))).toEqual(m);
+    });
+    it.each([
+        ['missing', undefined],
+        ['null', null],
+        ['blank', ''],
+        ['malformed JSON', '{level:'],
+        ['non-object', '"3"'],
+        ['JSON null', 'null']
+    ])('falls back to defaults (never throws) for %s', (_label, raw) => {
+        expect(ParseUxMilestones(raw)).toEqual(DefaultUxMilestones());
+    });
+    it('repairs field-wise: bad level/calls/density fall back individually', () => {
+        expect(ParseUxMilestones('{"level":"high","calls":2,"density":"standard"}'))
+            .toEqual({ Level: 0, Calls: 2, Density: 'standard' });
+        expect(ParseUxMilestones('{"level":3,"calls":-4,"density":"ultra"}'))
+            .toEqual({ Level: 3, Calls: 0, Density: 'auto' });
+        expect(ParseUxMilestones('{"level":99,"calls":1.7,"density":"simple"}'))
+            .toEqual({ Level: REALTIME_UX_MAX_LEVEL, Calls: 2, Density: 'simple' });
+    });
+});
+describe('EffectiveBaseLevel', () => {
+    it('day one: a brand-new user starts at PURE AUDIO (level 0)', () => {
+        expect(EffectiveBaseLevel(DefaultUxMilestones())).toBe(0);
+    });
+    it('auto density follows the earned ratchet', () => {
+        expect(EffectiveBaseLevel({ Level: 2, Calls: 1, Density: 'auto' })).toBe(2);
+    });
+    it(`auto density promotes to the full console after ${REALTIME_UX_PRO_CALLS} completed calls`, () => {
+        expect(EffectiveBaseLevel({ Level: 1, Calls: REALTIME_UX_PRO_CALLS, Density: 'auto' })).toBe(REALTIME_UX_MAX_LEVEL);
+        expect(EffectiveBaseLevel({ Level: 1, Calls: REALTIME_UX_PRO_CALLS - 1, Density: 'auto' })).toBe(1);
+    });
+    it('manual density overrides win outright (the escape hatch)', () => {
+        const earned = { Level: 4, Calls: 10, Density: 'simple' };
+        expect(EffectiveBaseLevel(earned)).toBe(0);
+        expect(EffectiveBaseLevel({ ...earned, Density: 'standard' })).toBe(2);
+        expect(EffectiveBaseLevel({ Level: 0, Calls: 0, Density: 'pro' })).toBe(REALTIME_UX_MAX_LEVEL);
+    });
+});
+describe('RatchetedMilestones (call end)', () => {
+    it('increments calls and ratchets the level to the session peak', () => {
+        expect(RatchetedMilestones({ Level: 1, Calls: 1, Density: 'auto' }, 3))
+            .toEqual({ Level: 3, Calls: 2, Density: 'auto' });
+    });
+    it('a completed first call always earns at least level 1 (text next time)', () => {
+        expect(RatchetedMilestones(DefaultUxMilestones(), 0))
+            .toEqual({ Level: 1, Calls: 1, Density: 'auto' });
+    });
+    it('NEVER lowers the earned level (ratchet)', () => {
+        expect(RatchetedMilestones({ Level: 4, Calls: 5, Density: 'auto' }, 0).Level).toBe(4);
+    });
+    it('preserves the density override', () => {
+        expect(RatchetedMilestones({ Level: 0, Calls: 0, Density: 'simple' }, 2).Density).toBe('simple');
+    });
+});
+describe('RealtimeDisclosureModel', () => {
+    it('Load resets the session level to the effective base', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(SerializeUxMilestones({ Level: 2, Calls: 1, Density: 'auto' }));
+        expect(m.SessionLevel).toBe(2);
+        expect(m.ShowThread).toBe(true);
+        expect(m.ShowComposer).toBe(true);
+        expect(m.ShowPanel).toBe(true);
+        expect(m.PowerLevel).toBe(false);
+    });
+    it('day one exposes NOTHING beyond pure audio', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(null);
+        expect(m.SessionLevel).toBe(0);
+        expect(m.ShowThread).toBe(false);
+        expect(m.ShowComposer).toBe(false);
+        expect(m.ShowPanel).toBe(false);
+        expect(m.ShowGear).toBe(false);
+    });
+    it('Raise only raises — and reports whether anything changed', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(null);
+        expect(m.Raise('engaged')).toBe(true);
+        expect(m.SessionLevel).toBe(2);
+        expect(m.Raise('text')).toBe(false); // lower event after a higher one: no-op
+        expect(m.SessionLevel).toBe(2);
+        expect(m.Raise('channel')).toBe(true);
+        expect(m.SessionLevel).toBe(3);
+    });
+    it('emits Changed$ on raises that change the level (and not on no-ops)', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(null);
+        let emissions = 0;
+        m.Changed$.subscribe(() => emissions++);
+        m.Raise('text');
+        m.Raise('text');
+        expect(emissions).toBe(1);
+    });
+    it('BeginSession resets the volatile level back to the base', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(null);
+        m.Raise('channel');
+        m.BeginSession();
+        expect(m.SessionLevel).toBe(0);
+    });
+    it('ReturnToPureAudio steps the volatile level back to 0 WITHOUT touching the ratchet', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(SerializeUxMilestones({ Level: 2, Calls: 1, Density: 'auto' }));
+        m.Raise('power');
+        let emissions = 0;
+        m.Changed$.subscribe(() => emissions++);
+        m.ReturnToPureAudio();
+        expect(m.SessionLevel).toBe(0);
+        expect(m.ShowThread).toBe(false);
+        expect(m.Milestones.Level).toBe(2); // the cross-session ratchet is untouched
+        m.ReturnToPureAudio(); // already there — no extra emission
+        expect(emissions).toBe(1);
+        // the user can step back up afterward — the door swings both ways
+        expect(m.Raise('text')).toBe(true);
+        expect(m.SessionLevel).toBe(1);
+    });
+    it('SetDensity applies immediately — simple retracts even a mid-call console', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(SerializeUxMilestones({ Level: 4, Calls: 9, Density: 'auto' }));
+        expect(m.SessionLevel).toBe(4);
+        m.SetDensity('simple');
+        expect(m.SessionLevel).toBe(0);
+        expect(m.Milestones.Density).toBe('simple');
+        m.SetDensity('pro');
+        expect(m.SessionLevel).toBe(REALTIME_UX_MAX_LEVEL);
+    });
+    it('RatchetOnSessionEnd replaces milestones and returns the persistable payload', () => {
+        const m = new RealtimeDisclosureModel();
+        m.Load(null);
+        m.Raise('channel');
+        const serialized = m.RatchetOnSessionEnd();
+        expect(m.Milestones).toEqual({ Level: 3, Calls: 1, Density: 'auto' });
+        expect(ParseUxMilestones(serialized)).toEqual(m.Milestones);
+    });
+});
+//# sourceMappingURL=realtime-disclosure.test.js.map

package/dist/__tests__/realtime-disclosure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-disclosure.test.js","sourceRoot":"","sources":["../../src/__tests__/realtime-disclosure.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unit tests for the realtime overlay's PROGRESSIVE DISCLOSURE engine — the\n * framework-free levels/milestones model behind the pure-audio-first call UX\n * (persisted per-user via UserInfoEngine under `mj.realtimeVoice.uxMilestones.v1`).\n */\nimport { describe, it, expect } from 'vitest';\nimport {\n  ClampUxLevel,\n  DefaultUxMilestones,\n  EffectiveBaseLevel,\n  ParseUxMilestones,\n  RatchetedMilestones,\n  RealtimeDisclosureModel,\n  SerializeUxMilestones,\n  REALTIME_UX_MAX_LEVEL,\n  REALTIME_UX_PREF_KEY,\n  REALTIME_UX_PRO_CALLS\n} from '../lib/components/realtime/realtime-disclosure';\n\ndescribe('pref key', () => {\n  it('uses the versioned mj.* naming convention', () => {\n    expect(REALTIME_UX_PREF_KEY).toBe('mj.realtimeVoice.uxMilestones.v1');\n  });\n});\n\ndescribe('ClampUxLevel', () => {\n  it('passes valid levels through and clamps the band edges', () => {\n    expect(ClampUxLevel(0)).toBe(0);\n    expect(ClampUxLevel(3)).toBe(3);\n    expect(ClampUxLevel(-2)).toBe(0);\n    expect(ClampUxLevel(9)).toBe(REALTIME_UX_MAX_LEVEL);\n  });\n\n  it('rounds fractional and zeroes non-finite levels', () => {\n    expect(ClampUxLevel(2.6)).toBe(3);\n    expect(ClampUxLevel(NaN)).toBe(0);\n    expect(ClampUxLevel(Infinity)).toBe(0);\n  });\n});\n\ndescribe('ParseUxMilestones / SerializeUxMilestones', () => {\n  it('round-trips milestones', () => {\n    const m = { Level: 3, Calls: 7, Density: 'pro' as const };\n    expect(ParseUxMilestones(SerializeUxMilestones(m))).toEqual(m);\n  });\n\n  it.each([\n    ['missing', undefined],\n    ['null', null],\n    ['blank', ''],\n    ['malformed JSON', '{level:'],\n    ['non-object', '\"3\"'],\n    ['JSON null', 'null']\n  ])('falls back to defaults (never throws) for %s', (_label, raw) => {\n    expect(ParseUxMilestones(raw as string | null | undefined)).toEqual(DefaultUxMilestones());\n  });\n\n  it('repairs field-wise: bad level/calls/density fall back individually', () => {\n    expect(ParseUxMilestones('{\"level\":\"high\",\"calls\":2,\"density\":\"standard\"}'))\n      .toEqual({ Level: 0, Calls: 2, Density: 'standard' });\n    expect(ParseUxMilestones('{\"level\":3,\"calls\":-4,\"density\":\"ultra\"}'))\n      .toEqual({ Level: 3, Calls: 0, Density: 'auto' });\n    expect(ParseUxMilestones('{\"level\":99,\"calls\":1.7,\"density\":\"simple\"}'))\n      .toEqual({ Level: REALTIME_UX_MAX_LEVEL, Calls: 2, Density: 'simple' });\n  });\n});\n\ndescribe('EffectiveBaseLevel', () => {\n  it('day one: a brand-new user starts at PURE AUDIO (level 0)', () => {\n    expect(EffectiveBaseLevel(DefaultUxMilestones())).toBe(0);\n  });\n\n  it('auto density follows the earned ratchet', () => {\n    expect(EffectiveBaseLevel({ Level: 2, Calls: 1, Density: 'auto' })).toBe(2);\n  });\n\n  it(`auto density promotes to the full console after ${REALTIME_UX_PRO_CALLS} completed calls`, () => {\n    expect(EffectiveBaseLevel({ Level: 1, Calls: REALTIME_UX_PRO_CALLS, Density: 'auto' })).toBe(REALTIME_UX_MAX_LEVEL);\n    expect(EffectiveBaseLevel({ Level: 1, Calls: REALTIME_UX_PRO_CALLS - 1, Density: 'auto' })).toBe(1);\n  });\n\n  it('manual density overrides win outright (the escape hatch)', () => {\n    const earned = { Level: 4, Calls: 10, Density: 'simple' as const };\n    expect(EffectiveBaseLevel(earned)).toBe(0);\n    expect(EffectiveBaseLevel({ ...earned, Density: 'standard' })).toBe(2);\n    expect(EffectiveBaseLevel({ Level: 0, Calls: 0, Density: 'pro' })).toBe(REALTIME_UX_MAX_LEVEL);\n  });\n});\n\ndescribe('RatchetedMilestones (call end)', () => {\n  it('increments calls and ratchets the level to the session peak', () => {\n    expect(RatchetedMilestones({ Level: 1, Calls: 1, Density: 'auto' }, 3))\n      .toEqual({ Level: 3, Calls: 2, Density: 'auto' });\n  });\n\n  it('a completed first call always earns at least level 1 (text next time)', () => {\n    expect(RatchetedMilestones(DefaultUxMilestones(), 0))\n      .toEqual({ Level: 1, Calls: 1, Density: 'auto' });\n  });\n\n  it('NEVER lowers the earned level (ratchet)', () => {\n    expect(RatchetedMilestones({ Level: 4, Calls: 5, Density: 'auto' }, 0).Level).toBe(4);\n  });\n\n  it('preserves the density override', () => {\n    expect(RatchetedMilestones({ Level: 0, Calls: 0, Density: 'simple' }, 2).Density).toBe('simple');\n  });\n});\n\ndescribe('RealtimeDisclosureModel', () => {\n  it('Load resets the session level to the effective base', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(SerializeUxMilestones({ Level: 2, Calls: 1, Density: 'auto' }));\n    expect(m.SessionLevel).toBe(2);\n    expect(m.ShowThread).toBe(true);\n    expect(m.ShowComposer).toBe(true);\n    expect(m.ShowPanel).toBe(true);\n    expect(m.PowerLevel).toBe(false);\n  });\n\n  it('day one exposes NOTHING beyond pure audio', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(null);\n    expect(m.SessionLevel).toBe(0);\n    expect(m.ShowThread).toBe(false);\n    expect(m.ShowComposer).toBe(false);\n    expect(m.ShowPanel).toBe(false);\n    expect(m.ShowGear).toBe(false);\n  });\n\n  it('Raise only raises — and reports whether anything changed', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(null);\n    expect(m.Raise('engaged')).toBe(true);\n    expect(m.SessionLevel).toBe(2);\n    expect(m.Raise('text')).toBe(false); // lower event after a higher one: no-op\n    expect(m.SessionLevel).toBe(2);\n    expect(m.Raise('channel')).toBe(true);\n    expect(m.SessionLevel).toBe(3);\n  });\n\n  it('emits Changed$ on raises that change the level (and not on no-ops)', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(null);\n    let emissions = 0;\n    m.Changed$.subscribe(() => emissions++);\n    m.Raise('text');\n    m.Raise('text');\n    expect(emissions).toBe(1);\n  });\n\n  it('BeginSession resets the volatile level back to the base', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(null);\n    m.Raise('channel');\n    m.BeginSession();\n    expect(m.SessionLevel).toBe(0);\n  });\n\n  it('ReturnToPureAudio steps the volatile level back to 0 WITHOUT touching the ratchet', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(SerializeUxMilestones({ Level: 2, Calls: 1, Density: 'auto' }));\n    m.Raise('power');\n    let emissions = 0;\n    m.Changed$.subscribe(() => emissions++);\n\n    m.ReturnToPureAudio();\n    expect(m.SessionLevel).toBe(0);\n    expect(m.ShowThread).toBe(false);\n    expect(m.Milestones.Level).toBe(2); // the cross-session ratchet is untouched\n    m.ReturnToPureAudio(); // already there — no extra emission\n    expect(emissions).toBe(1);\n\n    // the user can step back up afterward — the door swings both ways\n    expect(m.Raise('text')).toBe(true);\n    expect(m.SessionLevel).toBe(1);\n  });\n\n  it('SetDensity applies immediately — simple retracts even a mid-call console', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(SerializeUxMilestones({ Level: 4, Calls: 9, Density: 'auto' }));\n    expect(m.SessionLevel).toBe(4);\n    m.SetDensity('simple');\n    expect(m.SessionLevel).toBe(0);\n    expect(m.Milestones.Density).toBe('simple');\n    m.SetDensity('pro');\n    expect(m.SessionLevel).toBe(REALTIME_UX_MAX_LEVEL);\n  });\n\n  it('RatchetOnSessionEnd replaces milestones and returns the persistable payload', () => {\n    const m = new RealtimeDisclosureModel();\n    m.Load(null);\n    m.Raise('channel');\n    const serialized = m.RatchetOnSessionEnd();\n    expect(m.Milestones).toEqual({ Level: 3, Calls: 1, Density: 'auto' });\n    expect(ParseUxMilestones(serialized)).toEqual(m.Milestones);\n  });\n});\n"]}

package/dist/__tests__/realtime-pairing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realtime-pairing.test.d.ts.map

package/dist/__tests__/realtime-pairing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-pairing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/realtime-pairing.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/realtime-pairing.test.js

@@ -0,0 +1,207 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { BuildRealtimeConfigOverridesJson, ConstrainTargetsToPairings, DefaultPairedTargetId, FilterRealtimeCoAgents, LoadCoAgentPairings, PairingsAllowTarget, SortPairings, } from '../lib/services/realtime-pairing';
+/**
+ * Pure co-agent pairing helpers — the client side of the `MJ: AI Agent Co Agents`
+ * semantics: a co-agent with ZERO rows is universal (today's flow untouched); with rows,
+ * its allowed targets are exactly those rows (Sequence order, IsDefault preselected).
+ * Also covers the pinned `configOverridesJson` envelope builder and the Realtime-type
+ * co-agent filter.
+ */
+const CO_AGENT = 'C0000000-0000-0000-0000-000000000001';
+function pairing(overrides) {
+    return {
+        ID: `P-${overrides.TargetAgentID}`,
+        CoAgentID: CO_AGENT,
+        TargetAgent: null,
+        IsDefault: false,
+        Sequence: 0,
+        Type: 'CoAgent',
+        Status: 'Active',
+        ...overrides,
+    };
+}
+const TARGET_A = 'A0000000-0000-0000-0000-00000000000A';
+const TARGET_B = 'B0000000-0000-0000-0000-00000000000B';
+const TARGET_C = 'D0000000-0000-0000-0000-00000000000D';
+const agents = [
+    { ID: TARGET_A, Name: 'Alpha' },
+    { ID: TARGET_B, Name: 'Beta' },
+    { ID: TARGET_C, Name: 'Gamma' },
+];
+describe('ConstrainTargetsToPairings', () => {
+    it('returns the candidates unchanged when there are zero pairing rows (universal co-agent)', () => {
+        const result = ConstrainTargetsToPairings(agents, []);
+        expect(result.map(a => a.ID)).toEqual([TARGET_A, TARGET_B, TARGET_C]);
+    });
+    it('constrains to exactly the paired targets, in pairing Sequence order', () => {
+        const pairings = [
+            pairing({ TargetAgentID: TARGET_C, Sequence: 2 }),
+            pairing({ TargetAgentID: TARGET_B, Sequence: 1 }),
+        ];
+        const result = ConstrainTargetsToPairings(agents, pairings);
+        expect(result.map(a => a.Name)).toEqual(['Beta', 'Gamma']);
+    });
+    it('silently drops paired targets the user cannot see/run (absent from the candidate list)', () => {
+        const pairings = [
+            pairing({ TargetAgentID: 'F0000000-0000-0000-0000-0000000000FF', Sequence: 1 }),
+            pairing({ TargetAgentID: TARGET_A, Sequence: 2 }),
+        ];
+        const result = ConstrainTargetsToPairings(agents, pairings);
+        expect(result.map(a => a.ID)).toEqual([TARGET_A]);
+    });
+    it('matches target ids across UUID casing and de-duplicates repeated targets', () => {
+        const pairings = [
+            pairing({ TargetAgentID: TARGET_B.toLowerCase(), Sequence: 1 }),
+            pairing({ TargetAgentID: TARGET_B.toUpperCase(), Sequence: 2 }),
+        ];
+        const result = ConstrainTargetsToPairings(agents, pairings);
+        expect(result.map(a => a.ID)).toEqual([TARGET_B]);
+    });
+});
+describe('SortPairings', () => {
+    it('orders by Sequence ascending with null sequences last, ties by target name', () => {
+        const rows = [
+            pairing({ TargetAgentID: TARGET_A, Sequence: null, TargetAgent: 'Alpha' }),
+            pairing({ TargetAgentID: TARGET_C, Sequence: 1, TargetAgent: 'Gamma' }),
+            pairing({ TargetAgentID: TARGET_B, Sequence: 1, TargetAgent: 'Beta' }),
+        ];
+        expect(SortPairings(rows).map(r => r.TargetAgentID)).toEqual([TARGET_B, TARGET_C, TARGET_A]);
+    });
+    it('does not mutate the input array', () => {
+        const rows = [pairing({ TargetAgentID: TARGET_B, Sequence: 2 }), pairing({ TargetAgentID: TARGET_A, Sequence: 1 })];
+        SortPairings(rows);
+        expect(rows[0].TargetAgentID).toBe(TARGET_B);
+    });
+});
+describe('DefaultPairedTargetId', () => {
+    it('returns the IsDefault row target', () => {
+        const pairings = [
+            pairing({ TargetAgentID: TARGET_A, Sequence: 1 }),
+            pairing({ TargetAgentID: TARGET_B, Sequence: 2, IsDefault: true }),
+        ];
+        expect(DefaultPairedTargetId(pairings)).toBe(TARGET_B);
+    });
+    it('returns the FIRST default in Sequence order when (defensively) more than one exists', () => {
+        const pairings = [
+            pairing({ TargetAgentID: TARGET_B, Sequence: 2, IsDefault: true }),
+            pairing({ TargetAgentID: TARGET_A, Sequence: 1, IsDefault: true }),
+        ];
+        expect(DefaultPairedTargetId(pairings)).toBe(TARGET_A);
+    });
+    it('returns null when no row is marked default or there are no rows', () => {
+        expect(DefaultPairedTargetId([pairing({ TargetAgentID: TARGET_A })])).toBeNull();
+        expect(DefaultPairedTargetId([])).toBeNull();
+    });
+});
+describe('PairingsAllowTarget', () => {
+    it('always allows when there are zero rows (universal co-agent)', () => {
+        expect(PairingsAllowTarget([], TARGET_A)).toBe(true);
+        expect(PairingsAllowTarget([], null)).toBe(true);
+    });
+    it('allows only the paired targets when rows exist (UUID-casing safe)', () => {
+        const pairings = [pairing({ TargetAgentID: TARGET_A })];
+        expect(PairingsAllowTarget(pairings, TARGET_A.toLowerCase())).toBe(true);
+        expect(PairingsAllowTarget(pairings, TARGET_B)).toBe(false);
+    });
+    it('never allows a missing target against a constrained co-agent', () => {
+        expect(PairingsAllowTarget([pairing({ TargetAgentID: TARGET_A })], null)).toBe(false);
+        expect(PairingsAllowTarget([pairing({ TargetAgentID: TARGET_A })], '')).toBe(false);
+    });
+});
+describe('FilterRealtimeCoAgents', () => {
+    it('keeps only agents whose Type is Realtime (trim + case-insensitive)', () => {
+        const candidates = [
+            { ID: '1', Type: 'Realtime' },
+            { ID: '2', Type: ' realtime ' },
+            { ID: '3', Type: 'Loop' },
+            { ID: '4', Type: null },
+        ];
+        expect(FilterRealtimeCoAgents(candidates).map(a => a.ID)).toEqual(['1', '2']);
+    });
+});
+describe('LoadCoAgentPairings', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    /**
+     * Stubs the provider-scoped AIEngineBase the loader reads (suite convention: spy on the
+     * static `GetProviderInstance`, the way other suites spy `AIEngineBase.Instance`). The
+     * engine cache — not a RunView — is the only data surface the loader touches.
+     */
+    function engineReturning(rows) {
+        const config = vi.fn(async () => {
+            if (rows instanceof Error) {
+                throw rows;
+            }
+        });
+        const fakeEngine = {
+            Config: config,
+            get AgentCoAgents() {
+                if (rows instanceof Error) {
+                    throw rows;
+                }
+                return rows;
+            },
+        };
+        const getProviderInstance = vi
+            .spyOn(AIEngineBase, 'GetProviderInstance')
+            .mockReturnValue(fakeEngine);
+        return { provider: {}, config, getProviderInstance };
+    }
+    it('reads the engine cache filtered to the co-agent (UUID-casing safe) and returns Sequence order', async () => {
+        const { provider, config, getProviderInstance } = engineReturning([
+            pairing({ TargetAgentID: TARGET_B, Sequence: 2, CoAgentID: CO_AGENT.toLowerCase() }),
+            pairing({ TargetAgentID: TARGET_A, Sequence: 1 }),
+            // Another co-agent's row — must be filtered out client-side.
+            pairing({ TargetAgentID: TARGET_C, Sequence: 0, CoAgentID: 'E0000000-0000-0000-0000-0000000000EE' }),
+            // Disabled row — ignored by resolution/pickers.
+            pairing({ TargetAgentID: TARGET_C, Sequence: 0, Status: 'Disabled' }),
+            // Reserved relationship type — ignored until its feature ships.
+            pairing({ TargetAgentID: TARGET_C, Sequence: 0, Type: 'Peer' }),
+        ]);
+        const rows = await LoadCoAgentPairings(provider, CO_AGENT);
+        expect(rows.map(r => r.TargetAgentID)).toEqual([TARGET_A, TARGET_B]);
+        // Provider-scoped engine instance, lazily configured against the SAME provider.
+        expect(getProviderInstance).toHaveBeenCalledWith(provider, AIEngineBase);
+        expect(config).toHaveBeenCalledWith(false, undefined, provider);
+    });
+    it('returns plain projected rows carrying the pairing fields the UI consumes', async () => {
+        const { provider } = engineReturning([
+            pairing({ TargetAgentID: TARGET_A, Sequence: 3, IsDefault: true, TargetAgent: 'Alpha' }),
+        ]);
+        const rows = await LoadCoAgentPairings(provider, CO_AGENT);
+        expect(rows).toEqual([
+            {
+                ID: `P-${TARGET_A}`,
+                CoAgentID: CO_AGENT,
+                TargetAgentID: TARGET_A,
+                TargetAgent: 'Alpha',
+                IsDefault: true,
+                Sequence: 3,
+            },
+        ]);
+    });
+    it('degrades to an empty list (no constraint) when the engine load throws', async () => {
+        const { provider } = engineReturning(new Error('offline'));
+        await expect(LoadCoAgentPairings(provider, CO_AGENT)).resolves.toEqual([]);
+    });
+    it('returns an empty list without touching the engine when the co-agent id is blank', async () => {
+        const { provider, getProviderInstance } = engineReturning([]);
+        await expect(LoadCoAgentPairings(provider, '  ')).resolves.toEqual([]);
+        expect(getProviderInstance).not.toHaveBeenCalled();
+    });
+});
+describe('BuildRealtimeConfigOverridesJson', () => {
+    it('returns null when nothing was overridden', () => {
+        expect(BuildRealtimeConfigOverridesJson(null)).toBeNull();
+        expect(BuildRealtimeConfigOverridesJson(undefined)).toBeNull();
+        expect(BuildRealtimeConfigOverridesJson('   ')).toBeNull();
+    });
+    it('emits the pinned override envelope for an explicit model pick', () => {
+        const json = BuildRealtimeConfigOverridesJson('model-77');
+        expect(json).toBe('{"realtime":{"modelPreference":"model-77"}}');
+        expect(JSON.parse(json)).toEqual({ realtime: { modelPreference: 'model-77' } });
+    });
+});
+//# sourceMappingURL=realtime-pairing.test.js.map

package/dist/__tests__/realtime-pairing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-pairing.test.js","sourceRoot":"","sources":["../../src/__tests__/realtime-pairing.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect, vi, afterEach } from 'vitest';\nimport { IMetadataProvider } from '@memberjunction/core';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport {\n  BuildRealtimeConfigOverridesJson,\n  ConstrainTargetsToPairings,\n  DefaultPairedTargetId,\n  FilterRealtimeCoAgents,\n  LoadCoAgentPairings,\n  PairingsAllowTarget,\n  SortPairings,\n  RealtimePairedAgentRow,\n} from '../lib/services/realtime-pairing';\n\n/**\n * Pure co-agent pairing helpers — the client side of the `MJ: AI Agent Co Agents`\n * semantics: a co-agent with ZERO rows is universal (today's flow untouched); with rows,\n * its allowed targets are exactly those rows (Sequence order, IsDefault preselected).\n * Also covers the pinned `configOverridesJson` envelope builder and the Realtime-type\n * co-agent filter.\n */\n\nconst CO_AGENT = 'C0000000-0000-0000-0000-000000000001';\n\n/** The engine-cache row shape LoadCoAgentPairings filters on (the new AIAgentCoAgent contract). */\ninterface FakeCoAgentEngineRow extends RealtimePairedAgentRow {\n  Type: 'CoAgent' | 'Peer';\n  Status: 'Active' | 'Disabled';\n  TargetAgentTypeID?: string | null;\n}\n\nfunction pairing(overrides: Partial<FakeCoAgentEngineRow> & { TargetAgentID: string }): FakeCoAgentEngineRow {\n  return {\n    ID: `P-${overrides.TargetAgentID}`,\n    CoAgentID: CO_AGENT,\n    TargetAgent: null,\n    IsDefault: false,\n    Sequence: 0,\n    Type: 'CoAgent',\n    Status: 'Active',\n    ...overrides,\n  };\n}\n\nconst TARGET_A = 'A0000000-0000-0000-0000-00000000000A';\nconst TARGET_B = 'B0000000-0000-0000-0000-00000000000B';\nconst TARGET_C = 'D0000000-0000-0000-0000-00000000000D';\n\ninterface FakeAgent { ID: string; Name: string }\nconst agents: FakeAgent[] = [\n  { ID: TARGET_A, Name: 'Alpha' },\n  { ID: TARGET_B, Name: 'Beta' },\n  { ID: TARGET_C, Name: 'Gamma' },\n];\n\ndescribe('ConstrainTargetsToPairings', () => {\n  it('returns the candidates unchanged when there are zero pairing rows (universal co-agent)', () => {\n    const result = ConstrainTargetsToPairings(agents, []);\n    expect(result.map(a => a.ID)).toEqual([TARGET_A, TARGET_B, TARGET_C]);\n  });\n\n  it('constrains to exactly the paired targets, in pairing Sequence order', () => {\n    const pairings = [\n      pairing({ TargetAgentID: TARGET_C, Sequence: 2 }),\n      pairing({ TargetAgentID: TARGET_B, Sequence: 1 }),\n    ];\n    const result = ConstrainTargetsToPairings(agents, pairings);\n    expect(result.map(a => a.Name)).toEqual(['Beta', 'Gamma']);\n  });\n\n  it('silently drops paired targets the user cannot see/run (absent from the candidate list)', () => {\n    const pairings = [\n      pairing({ TargetAgentID: 'F0000000-0000-0000-0000-0000000000FF', Sequence: 1 }),\n      pairing({ TargetAgentID: TARGET_A, Sequence: 2 }),\n    ];\n    const result = ConstrainTargetsToPairings(agents, pairings);\n    expect(result.map(a => a.ID)).toEqual([TARGET_A]);\n  });\n\n  it('matches target ids across UUID casing and de-duplicates repeated targets', () => {\n    const pairings = [\n      pairing({ TargetAgentID: TARGET_B.toLowerCase(), Sequence: 1 }),\n      pairing({ TargetAgentID: TARGET_B.toUpperCase(), Sequence: 2 }),\n    ];\n    const result = ConstrainTargetsToPairings(agents, pairings);\n    expect(result.map(a => a.ID)).toEqual([TARGET_B]);\n  });\n});\n\ndescribe('SortPairings', () => {\n  it('orders by Sequence ascending with null sequences last, ties by target name', () => {\n    const rows = [\n      pairing({ TargetAgentID: TARGET_A, Sequence: null, TargetAgent: 'Alpha' }),\n      pairing({ TargetAgentID: TARGET_C, Sequence: 1, TargetAgent: 'Gamma' }),\n      pairing({ TargetAgentID: TARGET_B, Sequence: 1, TargetAgent: 'Beta' }),\n    ];\n    expect(SortPairings(rows).map(r => r.TargetAgentID)).toEqual([TARGET_B, TARGET_C, TARGET_A]);\n  });\n\n  it('does not mutate the input array', () => {\n    const rows = [pairing({ TargetAgentID: TARGET_B, Sequence: 2 }), pairing({ TargetAgentID: TARGET_A, Sequence: 1 })];\n    SortPairings(rows);\n    expect(rows[0].TargetAgentID).toBe(TARGET_B);\n  });\n});\n\ndescribe('DefaultPairedTargetId', () => {\n  it('returns the IsDefault row target', () => {\n    const pairings = [\n      pairing({ TargetAgentID: TARGET_A, Sequence: 1 }),\n      pairing({ TargetAgentID: TARGET_B, Sequence: 2, IsDefault: true }),\n    ];\n    expect(DefaultPairedTargetId(pairings)).toBe(TARGET_B);\n  });\n\n  it('returns the FIRST default in Sequence order when (defensively) more than one exists', () => {\n    const pairings = [\n      pairing({ TargetAgentID: TARGET_B, Sequence: 2, IsDefault: true }),\n      pairing({ TargetAgentID: TARGET_A, Sequence: 1, IsDefault: true }),\n    ];\n    expect(DefaultPairedTargetId(pairings)).toBe(TARGET_A);\n  });\n\n  it('returns null when no row is marked default or there are no rows', () => {\n    expect(DefaultPairedTargetId([pairing({ TargetAgentID: TARGET_A })])).toBeNull();\n    expect(DefaultPairedTargetId([])).toBeNull();\n  });\n});\n\ndescribe('PairingsAllowTarget', () => {\n  it('always allows when there are zero rows (universal co-agent)', () => {\n    expect(PairingsAllowTarget([], TARGET_A)).toBe(true);\n    expect(PairingsAllowTarget([], null)).toBe(true);\n  });\n\n  it('allows only the paired targets when rows exist (UUID-casing safe)', () => {\n    const pairings = [pairing({ TargetAgentID: TARGET_A })];\n    expect(PairingsAllowTarget(pairings, TARGET_A.toLowerCase())).toBe(true);\n    expect(PairingsAllowTarget(pairings, TARGET_B)).toBe(false);\n  });\n\n  it('never allows a missing target against a constrained co-agent', () => {\n    expect(PairingsAllowTarget([pairing({ TargetAgentID: TARGET_A })], null)).toBe(false);\n    expect(PairingsAllowTarget([pairing({ TargetAgentID: TARGET_A })], '')).toBe(false);\n  });\n});\n\ndescribe('FilterRealtimeCoAgents', () => {\n  it('keeps only agents whose Type is Realtime (trim + case-insensitive)', () => {\n    const candidates = [\n      { ID: '1', Type: 'Realtime' },\n      { ID: '2', Type: ' realtime ' },\n      { ID: '3', Type: 'Loop' },\n      { ID: '4', Type: null },\n    ];\n    expect(FilterRealtimeCoAgents(candidates).map(a => a.ID)).toEqual(['1', '2']);\n  });\n});\n\ndescribe('LoadCoAgentPairings', () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  /**\n   * Stubs the provider-scoped AIEngineBase the loader reads (suite convention: spy on the\n   * static `GetProviderInstance`, the way other suites spy `AIEngineBase.Instance`). The\n   * engine cache — not a RunView — is the only data surface the loader touches.\n   */\n  function engineReturning(rows: FakeCoAgentEngineRow[] | Error): {\n    provider: IMetadataProvider;\n    config: ReturnType<typeof vi.fn>;\n    getProviderInstance: ReturnType<typeof vi.spyOn>;\n  } {\n    const config = vi.fn(async () => {\n      if (rows instanceof Error) {\n        throw rows;\n      }\n    });\n    const fakeEngine = {\n      Config: config,\n      get AgentCoAgents(): FakeCoAgentEngineRow[] {\n        if (rows instanceof Error) {\n          throw rows;\n        }\n        return rows;\n      },\n    };\n    const getProviderInstance = vi\n      .spyOn(AIEngineBase, 'GetProviderInstance')\n      .mockReturnValue(fakeEngine as unknown as AIEngineBase);\n    return { provider: {} as IMetadataProvider, config, getProviderInstance };\n  }\n\n  it('reads the engine cache filtered to the co-agent (UUID-casing safe) and returns Sequence order', async () => {\n    const { provider, config, getProviderInstance } = engineReturning([\n      pairing({ TargetAgentID: TARGET_B, Sequence: 2, CoAgentID: CO_AGENT.toLowerCase() }),\n      pairing({ TargetAgentID: TARGET_A, Sequence: 1 }),\n      // Another co-agent's row — must be filtered out client-side.\n      pairing({ TargetAgentID: TARGET_C, Sequence: 0, CoAgentID: 'E0000000-0000-0000-0000-0000000000EE' }),\n      // Disabled row — ignored by resolution/pickers.\n      pairing({ TargetAgentID: TARGET_C, Sequence: 0, Status: 'Disabled' }),\n      // Reserved relationship type — ignored until its feature ships.\n      pairing({ TargetAgentID: TARGET_C, Sequence: 0, Type: 'Peer' }),\n    ]);\n    const rows = await LoadCoAgentPairings(provider, CO_AGENT);\n    expect(rows.map(r => r.TargetAgentID)).toEqual([TARGET_A, TARGET_B]);\n    // Provider-scoped engine instance, lazily configured against the SAME provider.\n    expect(getProviderInstance).toHaveBeenCalledWith(provider, AIEngineBase);\n    expect(config).toHaveBeenCalledWith(false, undefined, provider);\n  });\n\n  it('returns plain projected rows carrying the pairing fields the UI consumes', async () => {\n    const { provider } = engineReturning([\n      pairing({ TargetAgentID: TARGET_A, Sequence: 3, IsDefault: true, TargetAgent: 'Alpha' }),\n    ]);\n    const rows = await LoadCoAgentPairings(provider, CO_AGENT);\n    expect(rows).toEqual([\n      {\n        ID: `P-${TARGET_A}`,\n        CoAgentID: CO_AGENT,\n        TargetAgentID: TARGET_A,\n        TargetAgent: 'Alpha',\n        IsDefault: true,\n        Sequence: 3,\n      },\n    ]);\n  });\n\n  it('degrades to an empty list (no constraint) when the engine load throws', async () => {\n    const { provider } = engineReturning(new Error('offline'));\n    await expect(LoadCoAgentPairings(provider, CO_AGENT)).resolves.toEqual([]);\n  });\n\n  it('returns an empty list without touching the engine when the co-agent id is blank', async () => {\n    const { provider, getProviderInstance } = engineReturning([]);\n    await expect(LoadCoAgentPairings(provider, '  ')).resolves.toEqual([]);\n    expect(getProviderInstance).not.toHaveBeenCalled();\n  });\n});\n\ndescribe('BuildRealtimeConfigOverridesJson', () => {\n  it('returns null when nothing was overridden', () => {\n    expect(BuildRealtimeConfigOverridesJson(null)).toBeNull();\n    expect(BuildRealtimeConfigOverridesJson(undefined)).toBeNull();\n    expect(BuildRealtimeConfigOverridesJson('   ')).toBeNull();\n  });\n\n  it('emits the pinned override envelope for an explicit model pick', () => {\n    const json = BuildRealtimeConfigOverridesJson('model-77');\n    expect(json).toBe('{\"realtime\":{\"modelPreference\":\"model-77\"}}');\n    expect(JSON.parse(json as string)).toEqual({ realtime: { modelPreference: 'model-77' } });\n  });\n});\n"]}

package/dist/__tests__/realtime-review-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+import '@angular/compiler';
+//# sourceMappingURL=realtime-review-lifecycle.test.d.ts.map

package/dist/__tests__/realtime-review-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-review-lifecycle.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/realtime-review-lifecycle.test.ts"],"names":[],"mappings":"AAEA,OAAO,mBAAmB,CAAC"}

package/dist/__tests__/realtime-review-lifecycle.test.js

@@ -0,0 +1,154 @@
+// Angular components in this package are partial-compiled — load the JIT compiler first
+// (same convention as the other component suites in this node test environment).
+import '@angular/compiler';
+import { describe, it, expect, vi } from 'vitest';
+import { ConversationChatAreaComponent } from '../lib/components/conversation/conversation-chat-area.component';
+/**
+ * SESSION-REVIEW overlay lifecycle on the chat area — every path that must CLEAR (or
+ * refuse to host) a review so the overlay can never go stale:
+ *
+ *  1. Changing the active conversation clears any hosted review (the original stuck
+ *     repro: an old session opened in review mode survived conversation switches).
+ *  2. The overlay's Close handler clears.
+ *  3. The async open path discards stale loads: a live call (before or during the
+ *     load) wins; a conversation switch mid-load discards the review UNLESS the
+ *     review belongs to the newly active conversation (the deep-link race).
+ *
+ * Class-level tests without TestBed: the component is created via
+ * `Object.create(prototype)` (skipping ctor/inject) and the few collaborators the
+ * review paths touch are stubbed directly.
+ */
+function review(overrides = {}) {
+    return {
+        SessionID: 'SESSION-1',
+        AgentID: 'AGENT-1',
+        AgentName: 'Voice Co-Agent',
+        TargetAgentID: 'AGENT-1',
+        ConversationID: 'CONV-A',
+        Status: 'Closed',
+        CloseReason: 'Explicit',
+        StartedAt: new Date(2026, 5, 1, 10, 0, 0),
+        LastActiveAt: null,
+        ClosedAt: new Date(2026, 5, 1, 10, 10, 0),
+        Turns: [],
+        DelegatedRuns: [],
+        ChannelStates: [],
+        Legs: [],
+        Artifacts: [],
+        ...overrides
+    };
+}
+/** Bare component over the real prototype: real lifecycle methods, stubbed collaborators. */
+function createHarness() {
+    const component = Object.create(ConversationChatAreaComponent.prototype);
+    const stubs = {
+        voiceSession: { IsActive: false },
+        loadSessionReview: vi.fn(),
+        detectChanges: vi.fn()
+    };
+    const open = component;
+    open['RealtimeReview'] = null;
+    open['_conversationId'] = null;
+    open['isInitialized'] = false; // keep the setter from invoking the heavy load path
+    open['Provider'] = {}; // ProviderToUse resolves to this stub, never the global Metadata.Provider
+    open['RealtimeSession'] = stubs.voiceSession;
+    open['realtimeReviewService'] = { LoadSessionReview: stubs.loadSessionReview };
+    open['cdr'] = { detectChanges: stubs.detectChanges };
+    return { component, stubs };
+}
+describe('Conversation change clears the session review (the stuck-overlay repro)', () => {
+    it('clears a hosted review when the conversationId input changes', () => {
+        const { component } = createHarness();
+        component.conversationId = 'CONV-A';
+        component.RealtimeReview = review();
+        component.conversationId = 'CONV-B';
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('clears a hosted review when the conversation changes to NULL (no selection)', () => {
+        const { component } = createHarness();
+        component.conversationId = 'CONV-A';
+        component.RealtimeReview = review();
+        component.conversationId = null;
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('keeps the review when the input re-fires with the SAME conversation', () => {
+        const { component } = createHarness();
+        component.conversationId = 'CONV-A';
+        const hosted = review();
+        component.RealtimeReview = hosted;
+        component.conversationId = 'CONV-A';
+        expect(component.RealtimeReview).toBe(hosted);
+    });
+});
+describe('Overlay Close + explicit clear', () => {
+    it('onReviewClosed (the overlay ReviewClosed output) clears the review', () => {
+        const { component } = createHarness();
+        component.RealtimeReview = review();
+        component.onReviewClosed();
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('ClearRealtimeSessionReview is a safe no-op when nothing is hosted', () => {
+        const { component } = createHarness();
+        expect(() => component.ClearRealtimeSessionReview()).not.toThrow();
+        expect(component.RealtimeReview).toBeNull();
+    });
+});
+describe('OpenRealtimeSessionReview — hosting and staleness guards', () => {
+    it('hosts the loaded review for the current conversation and reports success', async () => {
+        const { component, stubs } = createHarness();
+        component.conversationId = 'CONV-A';
+        stubs.loadSessionReview.mockResolvedValue(review({ ConversationID: 'CONV-A' }));
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(true);
+        expect(component.RealtimeReview?.SessionID).toBe('SESSION-1');
+        expect(stubs.detectChanges).toHaveBeenCalled();
+    });
+    it('refuses while a LIVE call is active (never fights the live overlay) and does not even load', async () => {
+        const { component, stubs } = createHarness();
+        stubs.voiceSession.IsActive = true;
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(false);
+        expect(stubs.loadSessionReview).not.toHaveBeenCalled();
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('reports failure (and hosts nothing) when the session cannot be loaded', async () => {
+        const { component, stubs } = createHarness();
+        stubs.loadSessionReview.mockResolvedValue(null);
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(false);
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('discards a load that resolves AFTER a live call started (the call wins)', async () => {
+        const { component, stubs } = createHarness();
+        stubs.loadSessionReview.mockImplementation(async () => {
+            stubs.voiceSession.IsActive = true; // call starts while the review loads
+            return review();
+        });
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(false);
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('discards a load that resolves after the user switched to a DIFFERENT conversation', async () => {
+        const { component, stubs } = createHarness();
+        component.conversationId = 'CONV-A';
+        stubs.loadSessionReview.mockImplementation(async () => {
+            component.conversationId = 'CONV-B'; // user moved on mid-load
+            return review({ ConversationID: 'CONV-A' });
+        });
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(false);
+        expect(component.RealtimeReview).toBeNull();
+    });
+    it('still hosts when the conversation switched mid-load but the review BELONGS to the new one (deep-link race)', async () => {
+        const { component, stubs } = createHarness();
+        component.conversationId = 'CONV-A';
+        stubs.loadSessionReview.mockImplementation(async () => {
+            component.conversationId = 'CONV-B'; // deep link selected the session's own conversation
+            return review({ ConversationID: 'conv-b' }); // case-insensitive UUID compare
+        });
+        const opened = await component.OpenRealtimeSessionReview('SESSION-1');
+        expect(opened).toBe(true);
+        expect(component.RealtimeReview?.ConversationID).toBe('conv-b');
+    });
+});
+//# sourceMappingURL=realtime-review-lifecycle.test.js.map