@memberjunction/ng-conversations 5.40.2 → 5.41.0

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

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

package/dist/__tests__/realtime-session-cancel-usage.test.d.ts

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

package/dist/__tests__/realtime-session-cancel-usage.test.d.ts.map

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

package/dist/__tests__/realtime-session-cancel-usage.test.js

@@ -0,0 +1,230 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { RealtimeSessionService } from '../lib/services/realtime-session.service';
+function internals(service) {
+    return service;
+}
+function collectResults(service) {
+    const results = [];
+    service.DelegationResult$.subscribe(r => results.push(r));
+    return results;
+}
+describe('RealtimeSessionService — CancelDelegation (per-card ✕, explicit user intent)', () => {
+    let service;
+    let executeGQL;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        executeGQL = vi.fn(async () => ({ CancelRealtimeSessionTool: { AbortedCount: 1, Success: true } }));
+        service.Provider = { ExecuteGQL: executeGQL };
+        internals(service).agentSessionId = 'sess-1';
+        internals(service).inFlightCallIds.add('call-1');
+    });
+    it('calls the CancelRealtimeSessionTool mutation with the session + call id, selecting the structured result', async () => {
+        await service.CancelDelegation('call-1');
+        expect(executeGQL).toHaveBeenCalledTimes(1);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('CancelRealtimeSessionTool'), { agentSessionId: 'sess-1', callId: 'call-1' });
+        // The mutation document selects the structured result fields (server contract).
+        const mutation = executeGQL.mock.calls[0][0];
+        expect(mutation).toContain('AbortedCount');
+        expect(mutation).toContain('Success');
+        expect(mutation).toContain('ErrorMessage');
+    });
+    it('flips the card to a FAILED "Cancelled by user" result when the server aborted the run', async () => {
+        const results = collectResults(service);
+        const ok = await service.CancelDelegation('call-1');
+        expect(ok).toBe(true);
+        expect(results).toEqual([{ CallID: 'call-1', Success: false, Output: 'Cancelled by user' }]);
+        expect(internals(service).inFlightCallIds.has('call-1')).toBe(false);
+    });
+    it('suppresses the aborted run\'s LATE real result so it cannot overwrite the cancelled card', async () => {
+        const results = collectResults(service);
+        await service.CancelDelegation('call-1');
+        // The original ExecuteRealtimeSessionTool mutation eventually resolves with the aborted outcome.
+        internals(service).emitDelegationResult('call-1', JSON.stringify({ success: false, error: 'Delegation failed: aborted' }));
+        expect(results).toHaveLength(1); // only the "Cancelled by user" card flip
+        expect(internals(service).cancelledCallIds.size).toBe(0); // the suppression marker was consumed
+    });
+    it('a DIFFERENT call\'s result still emits normally after a cancel', async () => {
+        const results = collectResults(service);
+        internals(service).inFlightCallIds.add('call-2');
+        await service.CancelDelegation('call-1');
+        internals(service).emitDelegationResult('call-2', JSON.stringify({ success: true, output: 'done' }));
+        expect(results).toHaveLength(2);
+        expect(results[1]).toMatchObject({ CallID: 'call-2', Success: true, Output: 'done' });
+    });
+    it('returns false WITHOUT flipping the card when the server had nothing to abort (result is racing in)', async () => {
+        executeGQL.mockResolvedValue({ CancelRealtimeSessionTool: { AbortedCount: 0, Success: true } });
+        const results = collectResults(service);
+        const ok = await service.CancelDelegation('call-1');
+        expect(ok).toBe(false);
+        expect(results).toEqual([]);
+        // The call stays tracked so the racing real result is processed normally.
+        expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);
+    });
+    it('treats a STRUCTURED failure (Success: false) as nothing aborted — card untouched', async () => {
+        executeGQL.mockResolvedValue({
+            CancelRealtimeSessionTool: { AbortedCount: 0, Success: false, ErrorMessage: 'registry exploded' },
+        });
+        const results = collectResults(service);
+        const ok = await service.CancelDelegation('call-1');
+        expect(ok).toBe(false);
+        expect(results).toEqual([]);
+        expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);
+    });
+    it('is a no-op (no mutation) for a call id that is not tracked in flight', async () => {
+        const ok = await service.CancelDelegation('call-unknown');
+        expect(ok).toBe(false);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('is a no-op (no mutation) when no session is open', async () => {
+        internals(service).agentSessionId = null;
+        const ok = await service.CancelDelegation('call-1');
+        expect(ok).toBe(false);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('tolerates a failed mutation (false, logged, card untouched)', async () => {
+        executeGQL.mockRejectedValue(new Error('network down'));
+        const results = collectResults(service);
+        const ok = await service.CancelDelegation('call-1');
+        expect(ok).toBe(false);
+        expect(results).toEqual([]);
+    });
+});
+describe('RealtimeSessionService — CancelInFlightDelegations (sweep cancel)', () => {
+    let service;
+    let executeGQL;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+        executeGQL = vi.fn(async () => ({ CancelRealtimeSessionTool: { AbortedCount: 2, Success: true } }));
+        service.Provider = { ExecuteGQL: executeGQL };
+        internals(service).agentSessionId = 'sess-1';
+    });
+    it('cancels ALL tracked in-flight calls with ONE callId-less mutation and flips every card', async () => {
+        internals(service).inFlightCallIds.add('call-1');
+        internals(service).inFlightCallIds.add('call-2');
+        const results = collectResults(service);
+        const count = await service.CancelInFlightDelegations();
+        expect(count).toBe(2);
+        expect(executeGQL).toHaveBeenCalledTimes(1);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('CancelRealtimeSessionTool'), { agentSessionId: 'sess-1', callId: null });
+        expect(results.map(r => r.CallID).sort()).toEqual(['call-1', 'call-2']);
+        expect(results.every(r => !r.Success && r.Output === 'Cancelled by user')).toBe(true);
+        expect(internals(service).inFlightCallIds.size).toBe(0);
+    });
+    it('returns 0 without a mutation when nothing is tracked in flight', async () => {
+        const count = await service.CancelInFlightDelegations();
+        expect(count).toBe(0);
+        expect(executeGQL).not.toHaveBeenCalled();
+    });
+    it('returns 0 (cards untouched) when the server aborted nothing', async () => {
+        executeGQL.mockResolvedValue({ CancelRealtimeSessionTool: { AbortedCount: 0, Success: true } });
+        internals(service).inFlightCallIds.add('call-1');
+        const results = collectResults(service);
+        const count = await service.CancelInFlightDelegations();
+        expect(count).toBe(0);
+        expect(results).toEqual([]);
+        expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);
+    });
+});
+describe('RealtimeSessionService — usage telemetry relay (OnUsage → RelayRealtimeUsage)', () => {
+    let service;
+    let executeGQL;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        service = new RealtimeSessionService();
+        executeGQL = vi.fn(async () => ({ RelayRealtimeUsage: true }));
+        service.Provider = { ExecuteGQL: executeGQL };
+        internals(service).agentSessionId = 'sess-1';
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('accumulates deltas and relays ONE debounced mutation (~10s) with the summed totals', async () => {
+        internals(service).onUsageDelta({ InputTokens: 100, OutputTokens: 10 });
+        internals(service).onUsageDelta({ InputTokens: 20, OutputTokens: 5 });
+        await vi.advanceTimersByTimeAsync(9999);
+        expect(executeGQL).not.toHaveBeenCalled();
+        await vi.advanceTimersByTimeAsync(1);
+        expect(executeGQL).toHaveBeenCalledTimes(1);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('RelayRealtimeUsage'), { agentSessionId: 'sess-1', inputTokens: 120, outputTokens: 15 });
+        // Accumulators were consumed by the flush.
+        expect(internals(service).pendingUsageInput).toBe(0);
+        expect(internals(service).pendingUsageOutput).toBe(0);
+    });
+    it('ignores all-zero / negative / missing deltas (no timer armed, no mutation)', async () => {
+        internals(service).onUsageDelta({});
+        internals(service).onUsageDelta({ InputTokens: -5, OutputTokens: 0 });
+        internals(service).onUsageDelta({ InputTokens: Number.NaN });
+        await vi.advanceTimersByTimeAsync(60000);
+        expect(executeGQL).not.toHaveBeenCalled();
+        expect(internals(service).usageFlushTimer).toBeNull();
+    });
+    it('clamps a negative component while accumulating the positive one', async () => {
+        internals(service).onUsageDelta({ InputTokens: -3, OutputTokens: 7 });
+        await vi.advanceTimersByTimeAsync(10000);
+        expect(executeGQL).toHaveBeenCalledWith(expect.stringContaining('RelayRealtimeUsage'), { agentSessionId: 'sess-1', inputTokens: 0, outputTokens: 7 });
+    });
+    it('re-accumulates on a failed relay so the next flush retries the same deltas', async () => {
+        executeGQL.mockRejectedValueOnce(new Error('network down'));
+        internals(service).onUsageDelta({ InputTokens: 50, OutputTokens: 5 });
+        await vi.advanceTimersByTimeAsync(10000); // flush fails
+        expect(internals(service).pendingUsageInput).toBe(50);
+        expect(internals(service).pendingUsageOutput).toBe(5);
+        internals(service).onUsageDelta({ InputTokens: 10, OutputTokens: 0 });
+        await vi.advanceTimersByTimeAsync(10000); // retry carries the combined totals
+        expect(executeGQL).toHaveBeenLastCalledWith(expect.stringContaining('RelayRealtimeUsage'), { agentSessionId: 'sess-1', inputTokens: 60, outputTokens: 5 });
+    });
+    it('flushes the unrelayed remainder at teardown BEFORE closing the server session (no debounce wait)', async () => {
+        internals(service).onUsageDelta({ InputTokens: 33, OutputTokens: 4 });
+        await internals(service).teardown(true);
+        const mutations = executeGQL.mock.calls.map(c => c[0]);
+        const usageIdx = mutations.findIndex(m => m.includes('RelayRealtimeUsage'));
+        const closeIdx = mutations.findIndex(m => m.includes('CloseAgentSession'));
+        expect(usageIdx).toBeGreaterThanOrEqual(0);
+        expect(closeIdx).toBeGreaterThan(usageIdx); // usage flushed first, then close
+        expect(executeGQL.mock.calls[usageIdx][1]).toEqual({ agentSessionId: 'sess-1', inputTokens: 33, outputTokens: 4 });
+        // Teardown leaves the relay reset (no dangling timer / pending totals).
+        expect(internals(service).usageFlushTimer).toBeNull();
+        expect(internals(service).pendingUsageInput).toBe(0);
+        expect(internals(service).pendingUsageOutput).toBe(0);
+    });
+    it('teardown without pending usage relays nothing (no spurious zero-delta mutation)', async () => {
+        await internals(service).teardown(true);
+        const mutations = executeGQL.mock.calls.map(c => c[0]);
+        expect(mutations.some(m => m.includes('RelayRealtimeUsage'))).toBe(false);
+        expect(mutations.some(m => m.includes('CloseAgentSession'))).toBe(true);
+    });
+    it('flushPendingUsage is a no-op without a session id', async () => {
+        internals(service).agentSessionId = null;
+        internals(service).onUsageDelta({ InputTokens: 9 });
+        await internals(service).flushPendingUsage();
+        expect(executeGQL).not.toHaveBeenCalled();
+        // The deltas survive for a later flush once a session id exists.
+        expect(internals(service).pendingUsageInput).toBe(9);
+    });
+});
+describe('RealtimeSessionService — OnUsage wiring through wireClientHandlers', () => {
+    /** Fake client capturing every handler wireClientHandlers registers. */
+    class FakeWiredClient {
+        UsageHandler = null;
+        OnStateChange() { }
+        OnTranscript() { }
+        OnToolCall() { }
+        OnError() { }
+        OnInterruption() { }
+        OnUsage(handler) {
+            this.UsageHandler = handler;
+        }
+    }
+    it('registers an OnUsage handler that feeds the accumulator', () => {
+        const service = new RealtimeSessionService();
+        const seam = service;
+        seam.agentSessionId = 'sess-1';
+        const client = new FakeWiredClient();
+        seam.wireClientHandlers(client);
+        expect(client.UsageHandler).toBeTypeOf('function');
+        client.UsageHandler?.({ InputTokens: 11, OutputTokens: 3 });
+        expect(seam.pendingUsageInput).toBe(11);
+        expect(seam.pendingUsageOutput).toBe(3);
+    });
+});
+//# sourceMappingURL=realtime-session-cancel-usage.test.js.map

package/dist/__tests__/realtime-session-cancel-usage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-session-cancel-usage.test.js","sourceRoot":"","sources":["../../src/__tests__/realtime-session-cancel-usage.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';\nimport { IMetadataProvider } from '@memberjunction/core';\nimport { RealtimeClientUsage } from '@memberjunction/ai-realtime-client';\nimport { RealtimeSessionService, VoiceDelegationResult } from '../lib/services/realtime-session.service';\n\n/**\n * The explicit delegation-CANCEL channel ({@link RealtimeSessionService.CancelDelegation} /\n * {@link RealtimeSessionService.CancelInFlightDelegations}) and the usage-telemetry relay\n * (`OnUsage` deltas → debounced `RelayRealtimeUsage` + teardown flush).\n *\n * Same narrow typed-seam approach as the sibling voice-session suites: a fake Provider whose\n * `ExecuteGQL` captures mutations, with private members reached through a typed internals cast.\n */\n\n/** The private surface the tests drive — no `any`, just the members under test. */\ninterface RealtimeSessionCancelUsageInternals {\n  agentSessionId: string | null;\n  inFlightCallIds: Set<string>;\n  cancelledCallIds: Set<string>;\n  pendingUsageInput: number;\n  pendingUsageOutput: number;\n  usageFlushTimer: ReturnType<typeof setTimeout> | null;\n  emitDelegationResult(callId: string, resultJson: string): void;\n  onUsageDelta(usage: RealtimeClientUsage): void;\n  flushPendingUsage(agentSessionId?: string | null): Promise<void>;\n  teardown(closeServerSession: boolean): Promise<void>;\n}\n\nfunction internals(service: RealtimeSessionService): RealtimeSessionCancelUsageInternals {\n  return service as unknown as RealtimeSessionCancelUsageInternals;\n}\n\nfunction collectResults(service: RealtimeSessionService): VoiceDelegationResult[] {\n  const results: VoiceDelegationResult[] = [];\n  service.DelegationResult$.subscribe(r => results.push(r));\n  return results;\n}\n\ndescribe('RealtimeSessionService — CancelDelegation (per-card ✕, explicit user intent)', () => {\n  let service: RealtimeSessionService;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    executeGQL = vi.fn(async () => ({ CancelRealtimeSessionTool: { AbortedCount: 1, Success: true } }));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n    internals(service).agentSessionId = 'sess-1';\n    internals(service).inFlightCallIds.add('call-1');\n  });\n\n  it('calls the CancelRealtimeSessionTool mutation with the session + call id, selecting the structured result', async () => {\n    await service.CancelDelegation('call-1');\n\n    expect(executeGQL).toHaveBeenCalledTimes(1);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('CancelRealtimeSessionTool'),\n      { agentSessionId: 'sess-1', callId: 'call-1' }\n    );\n    // The mutation document selects the structured result fields (server contract).\n    const mutation = executeGQL.mock.calls[0][0] as string;\n    expect(mutation).toContain('AbortedCount');\n    expect(mutation).toContain('Success');\n    expect(mutation).toContain('ErrorMessage');\n  });\n\n  it('flips the card to a FAILED \"Cancelled by user\" result when the server aborted the run', async () => {\n    const results = collectResults(service);\n\n    const ok = await service.CancelDelegation('call-1');\n\n    expect(ok).toBe(true);\n    expect(results).toEqual([{ CallID: 'call-1', Success: false, Output: 'Cancelled by user' }]);\n    expect(internals(service).inFlightCallIds.has('call-1')).toBe(false);\n  });\n\n  it('suppresses the aborted run\\'s LATE real result so it cannot overwrite the cancelled card', async () => {\n    const results = collectResults(service);\n    await service.CancelDelegation('call-1');\n\n    // The original ExecuteRealtimeSessionTool mutation eventually resolves with the aborted outcome.\n    internals(service).emitDelegationResult('call-1', JSON.stringify({ success: false, error: 'Delegation failed: aborted' }));\n\n    expect(results).toHaveLength(1); // only the \"Cancelled by user\" card flip\n    expect(internals(service).cancelledCallIds.size).toBe(0); // the suppression marker was consumed\n  });\n\n  it('a DIFFERENT call\\'s result still emits normally after a cancel', async () => {\n    const results = collectResults(service);\n    internals(service).inFlightCallIds.add('call-2');\n    await service.CancelDelegation('call-1');\n\n    internals(service).emitDelegationResult('call-2', JSON.stringify({ success: true, output: 'done' }));\n\n    expect(results).toHaveLength(2);\n    expect(results[1]).toMatchObject({ CallID: 'call-2', Success: true, Output: 'done' });\n  });\n\n  it('returns false WITHOUT flipping the card when the server had nothing to abort (result is racing in)', async () => {\n    executeGQL.mockResolvedValue({ CancelRealtimeSessionTool: { AbortedCount: 0, Success: true } });\n    const results = collectResults(service);\n\n    const ok = await service.CancelDelegation('call-1');\n\n    expect(ok).toBe(false);\n    expect(results).toEqual([]);\n    // The call stays tracked so the racing real result is processed normally.\n    expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);\n  });\n\n  it('treats a STRUCTURED failure (Success: false) as nothing aborted — card untouched', async () => {\n    executeGQL.mockResolvedValue({\n      CancelRealtimeSessionTool: { AbortedCount: 0, Success: false, ErrorMessage: 'registry exploded' },\n    });\n    const results = collectResults(service);\n\n    const ok = await service.CancelDelegation('call-1');\n\n    expect(ok).toBe(false);\n    expect(results).toEqual([]);\n    expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);\n  });\n\n  it('is a no-op (no mutation) for a call id that is not tracked in flight', async () => {\n    const ok = await service.CancelDelegation('call-unknown');\n    expect(ok).toBe(false);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('is a no-op (no mutation) when no session is open', async () => {\n    internals(service).agentSessionId = null;\n    const ok = await service.CancelDelegation('call-1');\n    expect(ok).toBe(false);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('tolerates a failed mutation (false, logged, card untouched)', async () => {\n    executeGQL.mockRejectedValue(new Error('network down'));\n    const results = collectResults(service);\n\n    const ok = await service.CancelDelegation('call-1');\n\n    expect(ok).toBe(false);\n    expect(results).toEqual([]);\n  });\n});\n\ndescribe('RealtimeSessionService — CancelInFlightDelegations (sweep cancel)', () => {\n  let service: RealtimeSessionService;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    service = new RealtimeSessionService();\n    executeGQL = vi.fn(async () => ({ CancelRealtimeSessionTool: { AbortedCount: 2, Success: true } }));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n    internals(service).agentSessionId = 'sess-1';\n  });\n\n  it('cancels ALL tracked in-flight calls with ONE callId-less mutation and flips every card', async () => {\n    internals(service).inFlightCallIds.add('call-1');\n    internals(service).inFlightCallIds.add('call-2');\n    const results = collectResults(service);\n\n    const count = await service.CancelInFlightDelegations();\n\n    expect(count).toBe(2);\n    expect(executeGQL).toHaveBeenCalledTimes(1);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('CancelRealtimeSessionTool'),\n      { agentSessionId: 'sess-1', callId: null }\n    );\n    expect(results.map(r => r.CallID).sort()).toEqual(['call-1', 'call-2']);\n    expect(results.every(r => !r.Success && r.Output === 'Cancelled by user')).toBe(true);\n    expect(internals(service).inFlightCallIds.size).toBe(0);\n  });\n\n  it('returns 0 without a mutation when nothing is tracked in flight', async () => {\n    const count = await service.CancelInFlightDelegations();\n    expect(count).toBe(0);\n    expect(executeGQL).not.toHaveBeenCalled();\n  });\n\n  it('returns 0 (cards untouched) when the server aborted nothing', async () => {\n    executeGQL.mockResolvedValue({ CancelRealtimeSessionTool: { AbortedCount: 0, Success: true } });\n    internals(service).inFlightCallIds.add('call-1');\n    const results = collectResults(service);\n\n    const count = await service.CancelInFlightDelegations();\n\n    expect(count).toBe(0);\n    expect(results).toEqual([]);\n    expect(internals(service).inFlightCallIds.has('call-1')).toBe(true);\n  });\n});\n\ndescribe('RealtimeSessionService — usage telemetry relay (OnUsage → RelayRealtimeUsage)', () => {\n  let service: RealtimeSessionService;\n  let executeGQL: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    vi.useFakeTimers();\n    service = new RealtimeSessionService();\n    executeGQL = vi.fn(async () => ({ RelayRealtimeUsage: true }));\n    service.Provider = { ExecuteGQL: executeGQL } as unknown as IMetadataProvider;\n    internals(service).agentSessionId = 'sess-1';\n  });\n\n  afterEach(() => {\n    vi.useRealTimers();\n  });\n\n  it('accumulates deltas and relays ONE debounced mutation (~10s) with the summed totals', async () => {\n    internals(service).onUsageDelta({ InputTokens: 100, OutputTokens: 10 });\n    internals(service).onUsageDelta({ InputTokens: 20, OutputTokens: 5 });\n\n    await vi.advanceTimersByTimeAsync(9999);\n    expect(executeGQL).not.toHaveBeenCalled();\n\n    await vi.advanceTimersByTimeAsync(1);\n    expect(executeGQL).toHaveBeenCalledTimes(1);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('RelayRealtimeUsage'),\n      { agentSessionId: 'sess-1', inputTokens: 120, outputTokens: 15 }\n    );\n    // Accumulators were consumed by the flush.\n    expect(internals(service).pendingUsageInput).toBe(0);\n    expect(internals(service).pendingUsageOutput).toBe(0);\n  });\n\n  it('ignores all-zero / negative / missing deltas (no timer armed, no mutation)', async () => {\n    internals(service).onUsageDelta({});\n    internals(service).onUsageDelta({ InputTokens: -5, OutputTokens: 0 });\n    internals(service).onUsageDelta({ InputTokens: Number.NaN });\n\n    await vi.advanceTimersByTimeAsync(60000);\n    expect(executeGQL).not.toHaveBeenCalled();\n    expect(internals(service).usageFlushTimer).toBeNull();\n  });\n\n  it('clamps a negative component while accumulating the positive one', async () => {\n    internals(service).onUsageDelta({ InputTokens: -3, OutputTokens: 7 });\n\n    await vi.advanceTimersByTimeAsync(10000);\n    expect(executeGQL).toHaveBeenCalledWith(\n      expect.stringContaining('RelayRealtimeUsage'),\n      { agentSessionId: 'sess-1', inputTokens: 0, outputTokens: 7 }\n    );\n  });\n\n  it('re-accumulates on a failed relay so the next flush retries the same deltas', async () => {\n    executeGQL.mockRejectedValueOnce(new Error('network down'));\n    internals(service).onUsageDelta({ InputTokens: 50, OutputTokens: 5 });\n    await vi.advanceTimersByTimeAsync(10000); // flush fails\n\n    expect(internals(service).pendingUsageInput).toBe(50);\n    expect(internals(service).pendingUsageOutput).toBe(5);\n\n    internals(service).onUsageDelta({ InputTokens: 10, OutputTokens: 0 });\n    await vi.advanceTimersByTimeAsync(10000); // retry carries the combined totals\n\n    expect(executeGQL).toHaveBeenLastCalledWith(\n      expect.stringContaining('RelayRealtimeUsage'),\n      { agentSessionId: 'sess-1', inputTokens: 60, outputTokens: 5 }\n    );\n  });\n\n  it('flushes the unrelayed remainder at teardown BEFORE closing the server session (no debounce wait)', async () => {\n    internals(service).onUsageDelta({ InputTokens: 33, OutputTokens: 4 });\n\n    await internals(service).teardown(true);\n\n    const mutations = executeGQL.mock.calls.map(c => c[0] as string);\n    const usageIdx = mutations.findIndex(m => m.includes('RelayRealtimeUsage'));\n    const closeIdx = mutations.findIndex(m => m.includes('CloseAgentSession'));\n    expect(usageIdx).toBeGreaterThanOrEqual(0);\n    expect(closeIdx).toBeGreaterThan(usageIdx); // usage flushed first, then close\n    expect(executeGQL.mock.calls[usageIdx][1]).toEqual({ agentSessionId: 'sess-1', inputTokens: 33, outputTokens: 4 });\n    // Teardown leaves the relay reset (no dangling timer / pending totals).\n    expect(internals(service).usageFlushTimer).toBeNull();\n    expect(internals(service).pendingUsageInput).toBe(0);\n    expect(internals(service).pendingUsageOutput).toBe(0);\n  });\n\n  it('teardown without pending usage relays nothing (no spurious zero-delta mutation)', async () => {\n    await internals(service).teardown(true);\n\n    const mutations = executeGQL.mock.calls.map(c => c[0] as string);\n    expect(mutations.some(m => m.includes('RelayRealtimeUsage'))).toBe(false);\n    expect(mutations.some(m => m.includes('CloseAgentSession'))).toBe(true);\n  });\n\n  it('flushPendingUsage is a no-op without a session id', async () => {\n    internals(service).agentSessionId = null;\n    internals(service).onUsageDelta({ InputTokens: 9 });\n\n    await internals(service).flushPendingUsage();\n\n    expect(executeGQL).not.toHaveBeenCalled();\n    // The deltas survive for a later flush once a session id exists.\n    expect(internals(service).pendingUsageInput).toBe(9);\n  });\n});\n\ndescribe('RealtimeSessionService — OnUsage wiring through wireClientHandlers', () => {\n  /** Fake client capturing every handler wireClientHandlers registers. */\n  class FakeWiredClient {\n    public UsageHandler: ((u: RealtimeClientUsage) => void) | null = null;\n    OnStateChange(): void { /* captured elsewhere */ }\n    OnTranscript(): void { /* not exercised */ }\n    OnToolCall(): void { /* not exercised */ }\n    OnError(): void { /* not exercised */ }\n    OnInterruption(): void { /* not exercised */ }\n    OnUsage(handler: (u: RealtimeClientUsage) => void): void {\n      this.UsageHandler = handler;\n    }\n  }\n\n  interface WiringInternals {\n    agentSessionId: string | null;\n    pendingUsageInput: number;\n    pendingUsageOutput: number;\n    wireClientHandlers(client: FakeWiredClient): void;\n  }\n\n  it('registers an OnUsage handler that feeds the accumulator', () => {\n    const service = new RealtimeSessionService();\n    const seam = service as unknown as WiringInternals;\n    seam.agentSessionId = 'sess-1';\n    const client = new FakeWiredClient();\n\n    seam.wireClientHandlers(client);\n    expect(client.UsageHandler).toBeTypeOf('function');\n\n    client.UsageHandler?.({ InputTokens: 11, OutputTokens: 3 });\n    expect(seam.pendingUsageInput).toBe(11);\n    expect(seam.pendingUsageOutput).toBe(3);\n  });\n});\n"]}

package/dist/__tests__/realtime-session-channels.test.d.ts

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

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

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

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

@@ -0,0 +1,252 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { RegisterClass } from '@memberjunction/global';
+import { RealtimeSessionService } from '../lib/services/realtime-session.service';
+import { BaseRealtimeChannelClient } from '../lib/components/realtime/channels/base-realtime-channel-client';
+class FakeRealtimeClient {
+    ToolResults = [];
+    SendToolResult(callId, resultJson) {
+        this.ToolResults.push({ CallID: callId, ResultJson: resultJson });
+    }
+    SendContextNote(_text) {
+        // not under test here
+    }
+    async Disconnect() {
+        // no-op for teardown
+    }
+}
+function internals(service) {
+    return service;
+}
+/** A minimal surface stand-in (never instantiated by these node tests). */
+class FakeSurface {
+}
+/**
+ * A fake interactive-channel plugin, registered exactly like production plugins
+ * (`@RegisterClass(BaseRealtimeChannelClient, '<ClientPluginClass>')`).
+ */
+let TestEchoChannel = class TestEchoChannel extends BaseRealtimeChannelClient {
+    AppliedCalls = [];
+    Disposed = false;
+    BoundSurface = null;
+    get ChannelName() {
+        return 'Echo';
+    }
+    get ToolNamePrefix() {
+        return 'Echo.';
+    }
+    get TabTitle() {
+        return 'Echo';
+    }
+    get TabIcon() {
+        return 'fa-solid fa-microphone';
+    }
+    GetToolDefinitions() {
+        return [
+            { Name: 'Echo.Say', Description: 'Echo a phrase', ParametersSchema: { type: 'object' } },
+            { Name: 'Echo.Clear', Description: 'Clear echoes', ParametersSchema: { type: 'object' } }
+        ];
+    }
+    GetSurfaceComponent() {
+        return FakeSurface;
+    }
+    BindSurface(instance) {
+        this.BoundSurface = instance;
+    }
+    ApplyAgentTool(toolName, argsJson) {
+        this.AppliedCalls.push({ ToolName: toolName, ArgsJson: argsJson });
+        return JSON.stringify({ success: true, echoed: toolName });
+    }
+    Dispose() {
+        this.Disposed = true;
+        super.Dispose();
+    }
+    /** Test seam: expose the host context the service handed us. */
+    get Ctx() {
+        return this.Context;
+    }
+};
+TestEchoChannel = __decorate([
+    RegisterClass(BaseRealtimeChannelClient, 'TestEchoChannel')
+], TestEchoChannel);
+/**
+ * Stubs the provider-scoped AIEngineBase whose cached `AgentChannels` the service reads
+ * (rows default to ACTIVE; pass `IsActive: false` to exercise the active-only filter).
+ * `success = false` makes the engine load reject — the registry-failure degradation path.
+ */
+function mockChannelRegistry(rows, success = true) {
+    const configFn = vi.fn(async () => {
+        if (!success) {
+            throw new Error('boom');
+        }
+    });
+    const fakeEngine = {
+        Config: configFn,
+        get AgentChannels() {
+            return rows.map(r => ({ IsActive: true, ...r }));
+        }
+    };
+    vi.spyOn(AIEngineBase, 'GetProviderInstance').mockReturnValue(fakeEngine);
+    return configFn;
+}
+describe('RealtimeSessionService — interactive-channel registry resolution', () => {
+    let service;
+    beforeEach(() => {
+        service = new RealtimeSessionService();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('resolves ACTIVE registry rows into per-session plugin instances via the ClassFactory', async () => {
+        const configFn = mockChannelRegistry([
+            { ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' },
+            // Inactive rows never become session plugins (parity with the old `IsActive = 1` filter).
+            { ID: 'c2', Name: 'Dormant', ClientPluginClass: 'TestEchoChannel', IsActive: false }
+        ]);
+        await internals(service).startChannels();
+        // Lazily configures the provider-scoped engine before reading the cached registry.
+        expect(configFn).toHaveBeenCalledWith(false, undefined, service.Provider);
+        expect(service.ActiveChannels).toHaveLength(1);
+        expect(service.ActiveChannels[0]).toBeInstanceOf(TestEchoChannel);
+    });
+    it('creates a FRESH instance per session (plugins are not singletons)', async () => {
+        mockChannelRegistry([{ ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }]);
+        await internals(service).startChannels();
+        const first = service.ActiveChannels[0];
+        await internals(service).startChannels();
+        expect(service.ActiveChannels[0]).not.toBe(first);
+    });
+    it('skips rows whose ClientPluginClass has no registration (logged, never fatal)', async () => {
+        const warn = vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+        mockChannelRegistry([
+            { ID: 'c1', Name: 'Ghost', ClientPluginClass: 'NoSuchChannelPlugin' },
+            { ID: 'c2', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }
+        ]);
+        await internals(service).startChannels();
+        expect(service.ActiveChannels).toHaveLength(1);
+        expect(service.ActiveChannels[0]).toBeInstanceOf(TestEchoChannel);
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("No client plugin registered for channel 'Ghost'"));
+    });
+    it('degrades to NO channels when the registry load fails (the voice session must proceed)', async () => {
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+        mockChannelRegistry([], false);
+        const tools = await internals(service).startChannels();
+        expect(tools).toEqual([]);
+        expect(service.ActiveChannels).toEqual([]);
+    });
+    it('degrades to NO channels when the engine acquisition throws', async () => {
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+        vi.spyOn(AIEngineBase, 'GetProviderInstance').mockImplementation(() => {
+            throw new Error('no provider');
+        });
+        const tools = await internals(service).startChannels();
+        expect(tools).toEqual([]);
+        expect(service.ActiveChannels).toEqual([]);
+    });
+    it('aggregates every plugin tool definition into the clientTools set for the mint', async () => {
+        mockChannelRegistry([{ ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }]);
+        const tools = await internals(service).startChannels();
+        expect(tools.map(t => t.Name)).toEqual(['Echo.Say', 'Echo.Clear']);
+    });
+    it('emits the resolved plugins on ActiveChannels$ (the overlay registers tabs from it)', async () => {
+        mockChannelRegistry([{ ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }]);
+        const emissions = [];
+        const sub = service.ActiveChannels$.subscribe(channels => emissions.push(channels.length));
+        await internals(service).startChannels();
+        sub.unsubscribe();
+        expect(emissions).toEqual([0, 1]); // BehaviorSubject replay, then the resolved set
+    });
+});
+describe('RealtimeSessionService — per-plugin tool routing + host context', () => {
+    let service;
+    let fakeClient;
+    let plugin;
+    beforeEach(async () => {
+        service = new RealtimeSessionService();
+        fakeClient = new FakeRealtimeClient();
+        internals(service).client = fakeClient;
+        mockChannelRegistry([{ ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }]);
+        await internals(service).startChannels();
+        plugin = service.ActiveChannels[0];
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('routes prefix-matched tool calls to the plugin and feeds its result back to the model', async () => {
+        await internals(service).handleToolCall({ CallID: 'call-1', ToolName: 'Echo.Say', ArgumentsJson: '{"phrase":"hi"}' });
+        expect(plugin.AppliedCalls).toEqual([{ ToolName: 'Echo.Say', ArgsJson: '{"phrase":"hi"}' }]);
+        expect(fakeClient.ToolResults).toEqual([
+            { CallID: 'call-1', ResultJson: JSON.stringify({ success: true, echoed: 'Echo.Say' }) }
+        ]);
+    });
+    it('hands each plugin a context whose AgentName matches the session agent', () => {
+        expect(plugin.Ctx?.AgentName).toBe(service.CurrentAgentName);
+    });
+    it('SetFocusMode rides ChannelFocus$ tagged with the requesting plugin', () => {
+        const events = [];
+        const sub = service.ChannelFocus$.subscribe(e => events.push(e));
+        plugin.Ctx?.SetFocusMode(true);
+        plugin.Ctx?.SetFocusMode(false);
+        sub.unsubscribe();
+        expect(events).toEqual([
+            { Channel: plugin, Focused: true },
+            { Channel: plugin, Focused: false }
+        ]);
+    });
+});
+describe('RealtimeSessionService — debounced channel saves + teardown flush/dispose', () => {
+    let service;
+    let plugin;
+    let saveSpy;
+    beforeEach(async () => {
+        vi.useFakeTimers();
+        service = new RealtimeSessionService();
+        internals(service).agentSessionId = 'session-123';
+        saveSpy = vi.spyOn(service, 'SaveChannelState').mockResolvedValue(true);
+        mockChannelRegistry([{ ID: 'c1', Name: 'Echo', ClientPluginClass: 'TestEchoChannel' }]);
+        await internals(service).startChannels();
+        plugin = service.ActiveChannels[0];
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('debounces RequestSave: a change burst becomes ONE save with the LATEST state', () => {
+        plugin.Ctx?.RequestSave('{"v":1}');
+        plugin.Ctx?.RequestSave('{"v":2}');
+        plugin.Ctx?.RequestSave('{"v":3}');
+        expect(saveSpy).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(3000);
+        expect(saveSpy).toHaveBeenCalledTimes(1);
+        expect(saveSpy).toHaveBeenCalledWith('Echo', '{"v":3}', 'session-123');
+    });
+    it('teardown FLUSHES a pending save immediately (captured session id) and disposes plugins', async () => {
+        plugin.Ctx?.RequestSave('{"final":true}');
+        await internals(service).teardown(false);
+        expect(saveSpy).toHaveBeenCalledTimes(1);
+        expect(saveSpy).toHaveBeenCalledWith('Echo', '{"final":true}', 'session-123');
+        expect(plugin.Disposed).toBe(true);
+        expect(service.ActiveChannels).toEqual([]);
+    });
+    it('teardown with nothing pending saves nothing but still disposes', async () => {
+        await internals(service).teardown(false);
+        expect(saveSpy).not.toHaveBeenCalled();
+        expect(plugin.Disposed).toBe(true);
+    });
+    it('a Dispose error in one plugin is contained (teardown completes)', async () => {
+        const error = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        vi.spyOn(plugin, 'Dispose').mockImplementation(() => {
+            throw new Error('plugin exploded');
+        });
+        await internals(service).teardown(false);
+        expect(service.ActiveChannels).toEqual([]);
+        expect(error).toHaveBeenCalledWith(expect.stringContaining("Channel 'Echo' Dispose failed"), expect.any(Error));
+    });
+});
+//# sourceMappingURL=realtime-session-channels.test.js.map