@memberjunction/ng-conversations 5.40.1 → 5.41.0

package/dist/__tests__/realtime-session-policy.test.js

@@ -0,0 +1,303 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { RealtimeSessionService } from '../lib/services/realtime-session.service';
+/**
+ * Provider-agnostic POLICY surfaces of the voice session service that no other suite
+ * covered: typed-text injection (`SendText`), mic mute toggling, the client→UI
+ * connection-state mapping (incl. the 'connected' suppression and the error latch),
+ * session-config parsing resilience, and the `SaveChannelState` failure paths.
+ *
+ * Same narrow typed-seam approach as the sibling voice-session suites: a fake realtime
+ * client + fake Provider, with private members reached through a typed internals cast.
+ */
+class FakeRealtimeClient {
+    TextsSent = [];
+    MuteCalls = [];
+    ToolResults = [];
+    SendText(text) {
+        this.TextsSent.push(text);
+    }
+    SetMuted(muted) {
+        this.MuteCalls.push(muted);
+    }
+    SendToolResult(callId, resultJson) {
+        this.ToolResults.push({ CallID: callId, ResultJson: resultJson });
+    }
+    async Disconnect() {
+        // no-op
+    }
+}
+function internals(service) {
+    return service;
+}
+function latestState(service) {
+    let state = 'closed';
+    service.ConnectionState$.subscribe(s => (state = s)).unsubscribe();
+    return state;
+}
+describe('RealtimeSessionService — SendText (typed turn injection)', () => {
+    let service;
+    let client;
+    let executeGQL;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        client = new FakeRealtimeClient();
+        executeGQL = vi.fn(async () => ({}));
+        service.Provider = { ExecuteGQL: executeGQL };
+        internals(service).client = client;
+        internals(service).agentSessionId = 'sess-1';
+    });
+    it('injects the trimmed text and relays it through the SAME user-turn path as speech', async () => {
+        internals(service).onClientStateChange('listening');
+        service.SendText('  hello there  ');
+        await vi.waitFor(() => expect(executeGQL).toHaveBeenCalled());
+        expect(client.TextsSent).toEqual(['hello there']);
+        let captions = [];
+        service.Captions$.subscribe(c => (captions = c)).unsubscribe();
+        expect(captions).toEqual([{ Role: 'User', Text: 'hello there' }]);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('RelayRealtimeTranscript'), expect.objectContaining({ agentSessionId: 'sess-1', role: 'user', text: 'hello there' }));
+    });
+    it('is a no-op for empty / whitespace-only text', () => {
+        internals(service).onClientStateChange('listening');
+        service.SendText('');
+        service.SendText('   ');
+        expect(client.TextsSent).toEqual([]);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('is a no-op when the session is not live (state closed)', () => {
+        service.SendText('hello');
+        expect(client.TextsSent).toEqual([]);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('is a no-op when there is no client', () => {
+        internals(service).onClientStateChange('listening');
+        internals(service).client = null;
+        service.SendText('hello');
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('still captions the turn when no agent session id exists (relay silently skipped)', async () => {
+        internals(service).onClientStateChange('listening');
+        internals(service).agentSessionId = null;
+        service.SendText('typed while minting');
+        await Promise.resolve(); // let the relay microtask settle
+        expect(client.TextsSent).toEqual(['typed while minting']);
+        let captions = [];
+        service.Captions$.subscribe(c => (captions = c)).unsubscribe();
+        expect(captions).toEqual([{ Role: 'User', Text: 'typed while minting' }]);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+});
+describe('RealtimeSessionService — ToggleMute', () => {
+    let service;
+    let client;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        client = new FakeRealtimeClient();
+        internals(service).client = client;
+    });
+    it('returns false and touches nothing when there is no local stream', () => {
+        expect(service.ToggleMute()).toBe(false);
+        expect(client.MuteCalls).toEqual([]);
+    });
+    it('returns false when the stream has no audio tracks', () => {
+        internals(service).localStream = { getAudioTracks: () => [], getTracks: () => [] };
+        expect(service.ToggleMute()).toBe(false);
+        expect(client.MuteCalls).toEqual([]);
+    });
+    it('mutes via the client when the track is currently enabled', () => {
+        const track = { enabled: true, stop: () => undefined };
+        internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };
+        expect(service.ToggleMute()).toBe(true);
+        expect(client.MuteCalls).toEqual([true]);
+    });
+    it('unmutes via the client when the track is currently disabled', () => {
+        const track = { enabled: false, stop: () => undefined };
+        internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };
+        expect(service.ToggleMute()).toBe(false);
+        expect(client.MuteCalls).toEqual([false]);
+    });
+});
+describe('RealtimeSessionService — client→UI connection-state mapping', () => {
+    let service;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+    });
+    it("maps 'connecting' / 'listening' / 'speaking' straight through", () => {
+        internals(service).onClientStateChange('connecting');
+        expect(latestState(service)).toBe('connecting');
+        internals(service).onClientStateChange('listening');
+        expect(latestState(service)).toBe('listening');
+        internals(service).onClientStateChange('speaking');
+        expect(latestState(service)).toBe('speaking');
+    });
+    it("suppresses 'connected' — the UI stays in its prior state until the control channel opens", () => {
+        internals(service).onClientStateChange('connecting');
+        internals(service).onClientStateChange('connected');
+        expect(latestState(service)).toBe('connecting');
+    });
+    it("maps 'closed' through when no error was recorded", () => {
+        internals(service).onClientStateChange('listening');
+        internals(service).onClientStateChange('closed');
+        expect(latestState(service)).toBe('closed');
+    });
+    it("never lets a trailing 'closed' overwrite a terminal 'error'", () => {
+        internals(service).onClientStateChange('error');
+        internals(service).onClientStateChange('closed');
+        expect(latestState(service)).toBe('error');
+    });
+});
+describe('RealtimeSessionService — parseSessionConfig resilience', () => {
+    let service;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+    });
+    it('parses a valid config JSON', () => {
+        expect(internals(service).parseSessionConfig('{"instructions":"be brief"}')).toEqual({ instructions: 'be brief' });
+    });
+    it('returns an empty config for null (nothing to apply — the session still opens)', () => {
+        expect(internals(service).parseSessionConfig(null)).toEqual({});
+    });
+    it('returns an empty config (logged) for malformed JSON', () => {
+        const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        expect(internals(service).parseSessionConfig('{not json')).toEqual({});
+        expect(error).toHaveBeenCalledWith(expect.stringContaining('SessionConfigJson'), expect.any(Error));
+    });
+});
+describe('RealtimeSessionService — EndVoiceSession / teardown lifecycle', () => {
+    let service;
+    let client;
+    let executeGQL;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        client = new FakeRealtimeClient();
+        executeGQL = vi.fn(async () => ({}));
+        service.Provider = { ExecuteGQL: executeGQL };
+    });
+    it('is a safe no-op when no session is active and none was minted', async () => {
+        await service.EndVoiceSession();
+        expect(executeGQL).not.toHaveBeenCalled();
+        expect(latestState(service)).toBe('closed');
+    });
+    it('closes the server session, disconnects the client, stops the mic, and resets state', async () => {
+        const track = { enabled: true, stop: vi.fn() };
+        const disconnect = vi.spyOn(client, 'Disconnect');
+        internals(service).client = client;
+        internals(service).agentSessionId = 'sess-9';
+        internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };
+        internals(service).onClientStateChange('listening');
+        service.SetMinimized(true);
+        await service.EndVoiceSession();
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('CloseAgentSession'), { agentSessionId: 'sess-9' });
+        expect(disconnect).toHaveBeenCalledTimes(1);
+        expect(track.stop).toHaveBeenCalled();
+        expect(service.CurrentAgentSessionId).toBeNull();
+        expect(service.IsMinimized).toBe(false);
+        expect(service.IsActive).toBe(false);
+        expect(latestState(service)).toBe('closed');
+    });
+    it('teardown clears the client-tool handler registry', async () => {
+        internals(service).agentSessionId = 'sess-9';
+        const handler = vi.fn(() => '{"success":true}');
+        service.RegisterClientToolHandler('Whiteboard_', handler);
+        await service.EndVoiceSession();
+        // After teardown the prefix no longer routes locally — the registry was cleared.
+        internals(service).client = client;
+        internals(service).agentSessionId = 'sess-10';
+        await service
+            .handleToolCall({ CallID: 'c1', ToolName: 'Whiteboard_AddNote', ArgumentsJson: '{}' });
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it('a CloseAgentSession failure is contained (logged) and teardown still completes', async () => {
+        const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        executeGQL.mockRejectedValueOnce(new Error('server gone'));
+        internals(service).agentSessionId = 'sess-9';
+        await service.EndVoiceSession();
+        expect(service.CurrentAgentSessionId).toBeNull();
+        expect(error).toHaveBeenCalledWith(expect.stringContaining('Failed to close server session'), expect.any(Error));
+    });
+    it("teardown preserves a terminal 'error' state instead of overwriting it with 'closed'", async () => {
+        internals(service).agentSessionId = 'sess-9';
+        internals(service).onClientStateChange('error');
+        await service.EndVoiceSession();
+        expect(latestState(service)).toBe('error');
+    });
+});
+describe('RealtimeSessionService — SaveChannelState (explicit id + failure paths)', () => {
+    let service;
+    let executeGQL;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        executeGQL = vi.fn(async () => ({ SaveSessionChannelState: true }));
+        service.Provider = { ExecuteGQL: executeGQL };
+    });
+    it('uses the EXPLICIT session id even when no live session exists (the teardown-flush case)', async () => {
+        const saved = await service.SaveChannelState('Whiteboard', '{"v":1}', 'closed-session-7');
+        expect(saved).toBe(true);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('SaveSessionChannelState'), { agentSessionId: 'closed-session-7', channelName: 'Whiteboard', stateJson: '{"v":1}' });
+    });
+    it('prefers the explicit id over the live session id', async () => {
+        internals(service).agentSessionId = 'live-session';
+        await service.SaveChannelState('Whiteboard', '{}', 'captured-session');
+        expect(executeGQL.mock.calls[0][1]).toMatchObject({ agentSessionId: 'captured-session' });
+    });
+    it('returns false (logged, never thrown) when the mutation throws', async () => {
+        const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        executeGQL.mockRejectedValueOnce(new Error('network down'));
+        const saved = await service.SaveChannelState('Whiteboard', '{}', 'sess-1');
+        expect(saved).toBe(false);
+        expect(error).toHaveBeenCalledWith(expect.stringContaining('Failed to save channel state'), expect.any(Error));
+    });
+    it('returns false when the server reports a falsy result', async () => {
+        executeGQL.mockResolvedValueOnce({ SaveSessionChannelState: false });
+        expect(await service.SaveChannelState('Whiteboard', '{}', 'sess-1')).toBe(false);
+        executeGQL.mockResolvedValueOnce({});
+        expect(await service.SaveChannelState('Whiteboard', '{}', 'sess-1')).toBe(false);
+    });
+});
+describe('RealtimeSessionService — transcript correction (ReplacesPrevious)', () => {
+    let service;
+    let executeGQL;
+    function transcriptInternals(s) {
+        return s;
+    }
+    function captionsOf(s) {
+        let captions = [];
+        s.Captions$.subscribe(c => (captions = c)).unsubscribe();
+        return captions;
+    }
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        executeGQL = vi.fn(async () => ({}));
+        service.Provider = { ExecuteGQL: executeGQL };
+        internals(service).agentSessionId = 'sess-1';
+    });
+    it('a correction REPLACES the last assistant caption in place and relays update semantics', async () => {
+        const t = transcriptInternals(service);
+        await t.onClientTranscript({ Role: 'Assistant', Text: 'The answer is forty-two and', IsFinal: true, Kind: 'normal' });
+        await t.onClientTranscript({ Role: 'Assistant', Text: 'The answer is', IsFinal: true, Kind: 'normal', ReplacesPrevious: true });
+        expect(captionsOf(service)).toEqual([{ Role: 'Assistant', Text: 'The answer is' }]); // replaced, not appended
+        expect(executeGQL).toHaveBeenLastCalledWith(expect.stringContaining('RelayRealtimeTranscript'), expect.objectContaining({ role: 'assistant', text: 'The answer is', replacesPrevious: true }));
+    });
+    it('a correction replaces the LAST assistant caption, leaving later user turns alone', async () => {
+        const t = transcriptInternals(service);
+        await t.onClientTranscript({ Role: 'Assistant', Text: 'truncated turn that', IsFinal: true, Kind: 'normal' });
+        await t.onClientTranscript({ Role: 'User', Text: 'wait, stop', IsFinal: true, Kind: 'normal' });
+        await t.onClientTranscript({ Role: 'Assistant', Text: 'truncated turn', IsFinal: true, Kind: 'normal', ReplacesPrevious: true });
+        expect(captionsOf(service)).toEqual([
+            { Role: 'Assistant', Text: 'truncated turn' },
+            { Role: 'User', Text: 'wait, stop' }
+        ]);
+    });
+    it('a correction with NO prior assistant caption appends (never lost)', async () => {
+        await transcriptInternals(service).onClientTranscript({
+            Role: 'Assistant', Text: 'orphan correction', IsFinal: true, Kind: 'normal', ReplacesPrevious: true
+        });
+        expect(captionsOf(service)).toEqual([{ Role: 'Assistant', Text: 'orphan correction' }]);
+    });
+    it('ordinary finals relay with replacesPrevious=false', async () => {
+        await transcriptInternals(service).onClientTranscript({
+            Role: 'Assistant', Text: 'normal turn', IsFinal: true, Kind: 'normal'
+        });
+        expect(executeGQL).toHaveBeenLastCalledWith(expect.stringContaining('RelayRealtimeTranscript'), expect.objectContaining({ replacesPrevious: false }));
+    });
+});
+//# sourceMappingURL=realtime-session-policy.test.js.map

package/dist/__tests__/realtime-session-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-session-policy.test.js","sourceRoot":"","sources":["../../src/__tests__/realtime-session-policy.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect, beforeEach, vi } from 'vitest';\nimport { IMetadataProvider } from '@memberjunction/core';\nimport { JSONObject } from '@memberjunction/ai';\nimport { RealtimeSessionService, VoiceCaption, VoiceConnectionState } from '../lib/services/realtime-session.service';\n\n/**\n * Provider-agnostic POLICY surfaces of the voice session service that no other suite\n * covered: typed-text injection (`SendText`), mic mute toggling, the client→UI\n * connection-state mapping (incl. the 'connected' suppression and the error latch),\n * session-config parsing resilience, and the `SaveChannelState` failure paths.\n *\n * Same narrow typed-seam approach as the sibling voice-session suites: a fake realtime\n * client + fake Provider, with private members reached through a typed internals cast.\n */\n\nclass FakeRealtimeClient {\n  public TextsSent: string[] = [];\n  public MuteCalls: boolean[] = [];\n  public ToolResults: Array<{ CallID: string; ResultJson: string }> = [];\n  public SendText(text: string): void {\n    this.TextsSent.push(text);\n  }\n  public SetMuted(muted: boolean): void {\n    this.MuteCalls.push(muted);\n  }\n  public SendToolResult(callId: string, resultJson: string): void {\n    this.ToolResults.push({ CallID: callId, ResultJson: resultJson });\n  }\n  public async Disconnect(): Promise<void> {\n    // no-op\n  }\n}\n\n/** A minimal MediaStreamTrack stand-in (node tests have no real media stack). */\ninterface FakeTrack {\n  enabled: boolean;\n  stop(): void;\n}\n\n/** The private surface the tests drive — no `any`, just the members under test. */\ninterface RealtimeSessionPolicyInternals {\n  client: FakeRealtimeClient | null;\n  agentSessionId: string | null;\n  localStream: { getAudioTracks(): FakeTrack[]; getTracks(): FakeTrack[] } | null;\n  onClientStateChange(state: 'connecting' | 'connected' | 'listening' | 'speaking' | 'closed' | 'error'): void;\n  parseSessionConfig(sessionConfigJson: string | null): JSONObject;\n}\n\nfunction internals(service: RealtimeSessionService): RealtimeSessionPolicyInternals {\n  return service as unknown as RealtimeSessionPolicyInternals;\n}\n\nfunction latestState(service: RealtimeSessionService): VoiceConnectionState {\n  let state: VoiceConnectionState = 'closed';\n  service.ConnectionState$.subscribe(s => (state = s)).unsubscribe();\n  return state;\n}\n\ndescribe('RealtimeSessionService — SendText (typed turn injection)', () => {\n  let service: RealtimeSessionService;\n  let client: FakeRealtimeClient;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    client = new FakeRealtimeClient();\n    executeGQL = vi.fn(async () => ({}));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n    internals(service).client = client;\n    internals(service).agentSessionId = 'sess-1';\n  });\n\n  it('injects the trimmed text and relays it through the SAME user-turn path as speech', async () => {\n    internals(service).onClientStateChange('listening');\n\n    service.SendText('  hello there  ');\n    await vi.waitFor(() => expect(executeGQL).toHaveBeenCalled());\n\n    expect(client.TextsSent).toEqual(['hello there']);\n    let captions: VoiceCaption[] = [];\n    service.Captions$.subscribe(c => (captions = c)).unsubscribe();\n    expect(captions).toEqual([{ Role: 'User', Text: 'hello there' }]);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('RelayRealtimeTranscript'),\n      expect.objectContaining({ agentSessionId: 'sess-1', role: 'user', text: 'hello there' })\n    );\n  });\n\n  it('is a no-op for empty / whitespace-only text', () => {\n    internals(service).onClientStateChange('listening');\n\n    service.SendText('');\n    service.SendText('   ');\n\n    expect(client.TextsSent).toEqual([]);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('is a no-op when the session is not live (state closed)', () => {\n    service.SendText('hello');\n\n    expect(client.TextsSent).toEqual([]);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('is a no-op when there is no client', () => {\n    internals(service).onClientStateChange('listening');\n    internals(service).client = null;\n\n    service.SendText('hello');\n\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('still captions the turn when no agent session id exists (relay silently skipped)', async () => {\n    internals(service).onClientStateChange('listening');\n    internals(service).agentSessionId = null;\n\n    service.SendText('typed while minting');\n    await Promise.resolve(); // let the relay microtask settle\n\n    expect(client.TextsSent).toEqual(['typed while minting']);\n    let captions: VoiceCaption[] = [];\n    service.Captions$.subscribe(c => (captions = c)).unsubscribe();\n    expect(captions).toEqual([{ Role: 'User', Text: 'typed while minting' }]);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n});\n\ndescribe('RealtimeSessionService — ToggleMute', () => {\n  let service: RealtimeSessionService;\n  let client: FakeRealtimeClient;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    client = new FakeRealtimeClient();\n    internals(service).client = client;\n  });\n\n  it('returns false and touches nothing when there is no local stream', () => {\n    expect(service.ToggleMute()).toBe(false);\n    expect(client.MuteCalls).toEqual([]);\n  });\n\n  it('returns false when the stream has no audio tracks', () => {\n    internals(service).localStream = { getAudioTracks: () => [], getTracks: () => [] };\n    expect(service.ToggleMute()).toBe(false);\n    expect(client.MuteCalls).toEqual([]);\n  });\n\n  it('mutes via the client when the track is currently enabled', () => {\n    const track: FakeTrack = { enabled: true, stop: () => undefined };\n    internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };\n\n    expect(service.ToggleMute()).toBe(true);\n    expect(client.MuteCalls).toEqual([true]);\n  });\n\n  it('unmutes via the client when the track is currently disabled', () => {\n    const track: FakeTrack = { enabled: false, stop: () => undefined };\n    internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };\n\n    expect(service.ToggleMute()).toBe(false);\n    expect(client.MuteCalls).toEqual([false]);\n  });\n});\n\ndescribe('RealtimeSessionService — client→UI connection-state mapping', () => {\n  let service: RealtimeSessionService;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n  });\n\n  it(\"maps 'connecting' / 'listening' / 'speaking' straight through\", () => {\n    internals(service).onClientStateChange('connecting');\n    expect(latestState(service)).toBe('connecting');\n\n    internals(service).onClientStateChange('listening');\n    expect(latestState(service)).toBe('listening');\n\n    internals(service).onClientStateChange('speaking');\n    expect(latestState(service)).toBe('speaking');\n  });\n\n  it(\"suppresses 'connected' — the UI stays in its prior state until the control channel opens\", () => {\n    internals(service).onClientStateChange('connecting');\n    internals(service).onClientStateChange('connected');\n    expect(latestState(service)).toBe('connecting');\n  });\n\n  it(\"maps 'closed' through when no error was recorded\", () => {\n    internals(service).onClientStateChange('listening');\n    internals(service).onClientStateChange('closed');\n    expect(latestState(service)).toBe('closed');\n  });\n\n  it(\"never lets a trailing 'closed' overwrite a terminal 'error'\", () => {\n    internals(service).onClientStateChange('error');\n    internals(service).onClientStateChange('closed');\n    expect(latestState(service)).toBe('error');\n  });\n});\n\ndescribe('RealtimeSessionService — parseSessionConfig resilience', () => {\n  let service: RealtimeSessionService;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n  });\n\n  it('parses a valid config JSON', () => {\n    expect(internals(service).parseSessionConfig('{\"instructions\":\"be brief\"}')).toEqual({ instructions: 'be brief' });\n  });\n\n  it('returns an empty config for null (nothing to apply — the session still opens)', () => {\n    expect(internals(service).parseSessionConfig(null)).toEqual({});\n  });\n\n  it('returns an empty config (logged) for malformed JSON', () => {\n    const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);\n    expect(internals(service).parseSessionConfig('{not json')).toEqual({});\n    expect(error).toHaveBeenCalledWith(expect.stringContaining('SessionConfigJson'), expect.any(Error));\n  });\n});\n\ndescribe('RealtimeSessionService — EndVoiceSession / teardown lifecycle', () => {\n  let service: RealtimeSessionService;\n  let client: FakeRealtimeClient;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    client = new FakeRealtimeClient();\n    executeGQL = vi.fn(async () => ({}));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n  });\n\n  it('is a safe no-op when no session is active and none was minted', async () => {\n    await service.EndVoiceSession();\n    expect(executeGQL).not.toHaveBeenCalled();\n    expect(latestState(service)).toBe('closed');\n  });\n\n  it('closes the server session, disconnects the client, stops the mic, and resets state', async () => {\n    const track: FakeTrack = { enabled: true, stop: vi.fn() };\n    const disconnect = vi.spyOn(client, 'Disconnect');\n    internals(service).client = client;\n    internals(service).agentSessionId = 'sess-9';\n    internals(service).localStream = { getAudioTracks: () => [track], getTracks: () => [track] };\n    internals(service).onClientStateChange('listening');\n    service.SetMinimized(true);\n\n    await service.EndVoiceSession();\n\n    expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('CloseAgentSession'), { agentSessionId: 'sess-9' });\n    expect(disconnect).toHaveBeenCalledTimes(1);\n    expect(track.stop).toHaveBeenCalled();\n    expect(service.CurrentAgentSessionId).toBeNull();\n    expect(service.IsMinimized).toBe(false);\n    expect(service.IsActive).toBe(false);\n    expect(latestState(service)).toBe('closed');\n  });\n\n  it('teardown clears the client-tool handler registry', async () => {\n    internals(service).agentSessionId = 'sess-9';\n    const handler = vi.fn(() => '{\"success\":true}');\n    service.RegisterClientToolHandler('Whiteboard_', handler);\n\n    await service.EndVoiceSession();\n\n    // After teardown the prefix no longer routes locally — the registry was cleared.\n    internals(service).client = client;\n    internals(service).agentSessionId = 'sess-10';\n    await (service as unknown as { handleToolCall(c: { CallID: string; ToolName: string; ArgumentsJson: string }): Promise<void> })\n      .handleToolCall({ CallID: 'c1', ToolName: 'Whiteboard_AddNote', ArgumentsJson: '{}' });\n    expect(handler).not.toHaveBeenCalled();\n  });\n\n  it('a CloseAgentSession failure is contained (logged) and teardown still completes', async () => {\n    const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);\n    executeGQL.mockRejectedValueOnce(new Error('server gone'));\n    internals(service).agentSessionId = 'sess-9';\n\n    await service.EndVoiceSession();\n\n    expect(service.CurrentAgentSessionId).toBeNull();\n    expect(error).toHaveBeenCalledWith(expect.stringContaining('Failed to close server session'), expect.any(Error));\n  });\n\n  it(\"teardown preserves a terminal 'error' state instead of overwriting it with 'closed'\", async () => {\n    internals(service).agentSessionId = 'sess-9';\n    internals(service).onClientStateChange('error');\n\n    await service.EndVoiceSession();\n\n    expect(latestState(service)).toBe('error');\n  });\n});\n\ndescribe('RealtimeSessionService — SaveChannelState (explicit id + failure paths)', () => {\n  let service: RealtimeSessionService;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    executeGQL = vi.fn(async () => ({ SaveSessionChannelState: true }));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n  });\n\n  it('uses the EXPLICIT session id even when no live session exists (the teardown-flush case)', async () => {\n    const saved = await service.SaveChannelState('Whiteboard', '{\"v\":1}', 'closed-session-7');\n\n    expect(saved).toBe(true);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('SaveSessionChannelState'),\n      { agentSessionId: 'closed-session-7', channelName: 'Whiteboard', stateJson: '{\"v\":1}' }\n    );\n  });\n\n  it('prefers the explicit id over the live session id', async () => {\n    internals(service).agentSessionId = 'live-session';\n\n    await service.SaveChannelState('Whiteboard', '{}', 'captured-session');\n\n    expect(executeGQL.mock.calls[0][1]).toMatchObject({ agentSessionId: 'captured-session' });\n  });\n\n  it('returns false (logged, never thrown) when the mutation throws', async () => {\n    const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);\n    executeGQL.mockRejectedValueOnce(new Error('network down'));\n\n    const saved = await service.SaveChannelState('Whiteboard', '{}', 'sess-1');\n\n    expect(saved).toBe(false);\n    expect(error).toHaveBeenCalledWith(expect.stringContaining('Failed to save channel state'), expect.any(Error));\n  });\n\n  it('returns false when the server reports a falsy result', async () => {\n    executeGQL.mockResolvedValueOnce({ SaveSessionChannelState: false });\n    expect(await service.SaveChannelState('Whiteboard', '{}', 'sess-1')).toBe(false);\n\n    executeGQL.mockResolvedValueOnce({});\n    expect(await service.SaveChannelState('Whiteboard', '{}', 'sess-1')).toBe(false);\n  });\n});\n\ndescribe('RealtimeSessionService — transcript correction (ReplacesPrevious)', () => {\n  let service: RealtimeSessionService;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  /** The private transcript entry point the client driver feeds. */\n  interface TranscriptInternals {\n    onClientTranscript(t: {\n      Role: 'User' | 'Assistant'; Text: string; IsFinal: boolean;\n      Kind: 'normal' | 'narration'; ReplacesPrevious?: boolean;\n    }): Promise<void>;\n  }\n\n  function transcriptInternals(s: RealtimeSessionService): TranscriptInternals {\n    return s as unknown as TranscriptInternals;\n  }\n\n  function captionsOf(s: RealtimeSessionService): VoiceCaption[] {\n    let captions: VoiceCaption[] = [];\n    s.Captions$.subscribe(c => (captions = c)).unsubscribe();\n    return captions;\n  }\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    executeGQL = vi.fn(async () => ({}));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n    internals(service).agentSessionId = 'sess-1';\n  });\n\n  it('a correction REPLACES the last assistant caption in place and relays update semantics', async () => {\n    const t = transcriptInternals(service);\n    await t.onClientTranscript({ Role: 'Assistant', Text: 'The answer is forty-two and', IsFinal: true, Kind: 'normal' });\n    await t.onClientTranscript({ Role: 'Assistant', Text: 'The answer is', IsFinal: true, Kind: 'normal', ReplacesPrevious: true });\n\n    expect(captionsOf(service)).toEqual([{ Role: 'Assistant', Text: 'The answer is' }]); // replaced, not appended\n    expect(executeGQL).toHaveBeenLastCalledWith(\n      expect.stringContaining('RelayRealtimeTranscript'),\n      expect.objectContaining({ role: 'assistant', text: 'The answer is', replacesPrevious: true })\n    );\n  });\n\n  it('a correction replaces the LAST assistant caption, leaving later user turns alone', async () => {\n    const t = transcriptInternals(service);\n    await t.onClientTranscript({ Role: 'Assistant', Text: 'truncated turn that', IsFinal: true, Kind: 'normal' });\n    await t.onClientTranscript({ Role: 'User', Text: 'wait, stop', IsFinal: true, Kind: 'normal' });\n    await t.onClientTranscript({ Role: 'Assistant', Text: 'truncated turn', IsFinal: true, Kind: 'normal', ReplacesPrevious: true });\n\n    expect(captionsOf(service)).toEqual([\n      { Role: 'Assistant', Text: 'truncated turn' },\n      { Role: 'User', Text: 'wait, stop' }\n    ]);\n  });\n\n  it('a correction with NO prior assistant caption appends (never lost)', async () => {\n    await transcriptInternals(service).onClientTranscript({\n      Role: 'Assistant', Text: 'orphan correction', IsFinal: true, Kind: 'normal', ReplacesPrevious: true\n    });\n    expect(captionsOf(service)).toEqual([{ Role: 'Assistant', Text: 'orphan correction' }]);\n  });\n\n  it('ordinary finals relay with replacesPrevious=false', async () => {\n    await transcriptInternals(service).onClientTranscript({\n      Role: 'Assistant', Text: 'normal turn', IsFinal: true, Kind: 'normal'\n    });\n    expect(executeGQL).toHaveBeenLastCalledWith(\n      expect.stringContaining('RelayRealtimeTranscript'),\n      expect.objectContaining({ replacesPrevious: false })\n    );\n  });\n});\n"]}

package/dist/__tests__/realtime-session-review.service.test.d.ts

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

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

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