factory-factory 0.4.6 → 0.4.7

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.js

@@ -0,0 +1,120 @@
+export class SessionStartupCancelledError extends Error {
+    constructor() {
+        super('Session is currently being stopped');
+        this.name = 'SessionStartupCancelledError';
+    }
+}
+export class SessionLifecycleGate {
+    dependencies;
+    stoppingSessions = new Set();
+    shutdownSessions = new Set();
+    stopGenerationCounter = 0;
+    stopGenerations = new Map();
+    startupGenerationReferences = new Map();
+    establishedGenerations = new Set();
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async runStartup(sessionId, operation) {
+        const lease = { sessionId, generation: this.getGeneration(sessionId) };
+        const currentReferences = this.startupGenerationReferences.get(lease.generation);
+        this.startupGenerationReferences.set(lease.generation, {
+            count: (currentReferences?.count ?? 0) + 1,
+        });
+        try {
+            return await operation(lease);
+        }
+        finally {
+            this.releaseStartupLease(lease);
+        }
+    }
+    establishStartup(lease) {
+        if (this.isGenerationCurrent(lease.sessionId, lease.generation)) {
+            this.establishedGenerations.add(lease.generation);
+        }
+    }
+    assertStartupAllowed(lease) {
+        if (this.isSessionStopping(lease.sessionId) ||
+            !this.isGenerationCurrent(lease.sessionId, lease.generation)) {
+            throw new SessionStartupCancelledError();
+        }
+    }
+    reserveStop(sessionId) {
+        if (this.stoppingSessions.has(sessionId) || this.shutdownSessions.has(sessionId)) {
+            return null;
+        }
+        const generation = this.advanceGeneration(sessionId);
+        this.stoppingSessions.add(sessionId);
+        let released = false;
+        return {
+            generation,
+            release: () => {
+                if (released) {
+                    return;
+                }
+                released = true;
+                this.stoppingSessions.delete(sessionId);
+                this.deleteGeneration(sessionId);
+            },
+        };
+    }
+    reserveShutdown(sessionIds) {
+        for (const sessionId of sessionIds) {
+            if (this.shutdownSessions.has(sessionId)) {
+                continue;
+            }
+            this.advanceGeneration(sessionId);
+            this.shutdownSessions.add(sessionId);
+        }
+    }
+    releaseShutdown(sessionId) {
+        this.shutdownSessions.delete(sessionId);
+        this.deleteGeneration(sessionId);
+    }
+    isSessionStopping(sessionId) {
+        return (this.stoppingSessions.has(sessionId) ||
+            this.shutdownSessions.has(sessionId) ||
+            this.dependencies.isRuntimeStopInProgress(sessionId));
+    }
+    isStopReserved(sessionId) {
+        return this.stoppingSessions.has(sessionId);
+    }
+    getGeneration(sessionId) {
+        return this.stopGenerations.get(sessionId) ?? this.advanceGeneration(sessionId);
+    }
+    isGenerationCurrent(sessionId, generation) {
+        return this.stopGenerations.get(sessionId) === generation;
+    }
+    releaseStartupLease(lease) {
+        const references = this.startupGenerationReferences.get(lease.generation);
+        if (!references) {
+            return;
+        }
+        if (references.count > 1) {
+            this.startupGenerationReferences.set(lease.generation, {
+                count: references.count - 1,
+            });
+            return;
+        }
+        this.startupGenerationReferences.delete(lease.generation);
+        if (!(this.establishedGenerations.has(lease.generation) || this.isSessionStopping(lease.sessionId)) &&
+            this.isGenerationCurrent(lease.sessionId, lease.generation)) {
+            this.deleteGeneration(lease.sessionId);
+        }
+    }
+    advanceGeneration(sessionId) {
+        this.deleteGeneration(sessionId);
+        this.stopGenerationCounter += 1;
+        this.stopGenerations.set(sessionId, this.stopGenerationCounter);
+        return this.stopGenerationCounter;
+    }
+    deleteGeneration(sessionId) {
+        const generation = this.stopGenerations.get(sessionId);
+        if (generation === undefined) {
+            return;
+        }
+        this.stopGenerations.delete(sessionId);
+        this.establishedGenerations.delete(generation);
+    }
+}
+//# sourceMappingURL=session-lifecycle-gate.js.map

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle-gate.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/lifecycle/session-lifecycle-gate.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.d.ts

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

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle-gate.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.js

@@ -0,0 +1,192 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SessionLifecycleGate, SessionStartupCancelledError } from './session-lifecycle-gate.js';
+function createDeferred() {
+    let resolve;
+    const promise = new Promise((resolvePromise) => {
+        resolve = resolvePromise;
+    });
+    return { promise, resolve };
+}
+describe('SessionLifecycleGate', () => {
+    it('reuses one generation lease for concurrent startups instead of advancing it', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const firstDeferred = createDeferred();
+        const secondDeferred = createDeferred();
+        let firstLease;
+        let secondLease;
+        const firstStartup = gate.runStartup('session-1', async (lease) => {
+            firstLease = lease;
+            await firstDeferred.promise;
+        });
+        const secondStartup = gate.runStartup('session-1', async (lease) => {
+            secondLease = lease;
+            await secondDeferred.promise;
+        });
+        expect(secondLease).toEqual(firstLease);
+        expect(gate.isGenerationCurrent('session-1', firstLease.generation)).toBe(true);
+        firstDeferred.resolve();
+        await firstStartup;
+        expect(gate.isGenerationCurrent('session-1', secondLease.generation)).toBe(true);
+        secondDeferred.resolve();
+        await secondStartup;
+    });
+    it('invalidates an existing startup lease synchronously', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        let captured;
+        const startup = gate.runStartup('session-1', (lease) => {
+            captured = lease;
+            return Promise.resolve();
+        });
+        await startup;
+        const stop = gate.reserveStop('session-1');
+        expect(stop).not.toBeNull();
+        expect(() => gate.assertStartupAllowed(captured)).toThrow(SessionStartupCancelledError);
+        expect(() => gate.assertStartupAllowed(captured)).toThrow('Session is currently being stopped');
+        stop?.release();
+    });
+    it('rejects a duplicate reservation instead of releasing the active stop', () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const firstStop = gate.reserveStop('session-1');
+        const duplicateStop = gate.reserveStop('session-1');
+        expect(firstStop).not.toBeNull();
+        expect(duplicateStop).toBeNull();
+        expect(gate.isSessionStopping('session-1')).toBe(true);
+        firstStop?.release();
+        expect(gate.isSessionStopping('session-1')).toBe(false);
+    });
+    it('rejects an explicit stop while shutdown owns the session', () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        gate.reserveShutdown(['session-1']);
+        expect(gate.reserveStop('session-1')).toBeNull();
+        gate.releaseShutdown('session-1');
+    });
+    it('distinguishes explicit stop reservations from runtime and shutdown stops', () => {
+        const gate = new SessionLifecycleGate({
+            isRuntimeStopInProgress: (sessionId) => sessionId === 'runtime-stop',
+        });
+        const explicitStop = gate.reserveStop('explicit-stop');
+        gate.reserveShutdown(['shutdown-stop']);
+        expect(gate.isStopReserved('explicit-stop')).toBe(true);
+        expect(gate.isStopReserved('runtime-stop')).toBe(false);
+        expect(gate.isStopReserved('shutdown-stop')).toBe(false);
+        explicitStop?.release();
+        gate.releaseShutdown('shutdown-stop');
+    });
+    it('allows lifecycle cleanup to join a runtime-owned stop operation', () => {
+        const gate = new SessionLifecycleGate({
+            isRuntimeStopInProgress: (sessionId) => sessionId === 'session-1',
+        });
+        const stop = gate.reserveStop('session-1');
+        expect(stop).not.toBeNull();
+        stop?.release();
+    });
+    it('keeps a stop reservation released when its finally cleanup runs twice', () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const stop = gate.reserveStop('session-1');
+        try {
+            expect(gate.isSessionStopping('session-1')).toBe(true);
+        }
+        finally {
+            stop?.release();
+            stop?.release();
+        }
+        expect(gate.isSessionStopping('session-1')).toBe(false);
+        expect(gate.isGenerationCurrent('session-1', stop?.generation ?? -1)).toBe(false);
+    });
+    it('removes a failed startup lease instead of retaining its generation', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const failedGeneration = gate.getGeneration('session-1');
+        await expect(gate.runStartup('session-1', () => Promise.reject(new Error('spawn failed')))).rejects.toThrow('spawn failed');
+        const sentinelGeneration = gate.getGeneration('sentinel-session');
+        const nextGeneration = gate.getGeneration('session-1');
+        expect(sentinelGeneration).toBeGreaterThan(failedGeneration);
+        expect(nextGeneration).toBeGreaterThan(sentinelGeneration);
+    });
+    it('does not remove a failed lease while a concurrent startup still references it', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const deferred = createDeferred();
+        let retainedLease;
+        const retainedStartup = gate.runStartup('session-1', async (lease) => {
+            retainedLease = lease;
+            await deferred.promise;
+        });
+        await expect(gate.runStartup('session-1', () => Promise.reject(new Error('startup failed')))).rejects.toThrow('startup failed');
+        expect(gate.isGenerationCurrent('session-1', retainedLease.generation)).toBe(true);
+        deferred.resolve();
+        await retainedStartup;
+    });
+    it('retains a successful generation when a failing sibling releases last', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        const successfulDeferred = createDeferred();
+        let rejectFailure;
+        const failureBoundary = new Promise((_resolve, reject) => {
+            rejectFailure = reject;
+        });
+        let successfulLease;
+        let failingLease;
+        const successfulStartup = gate.runStartup('session-1', async (lease) => {
+            successfulLease = lease;
+            await successfulDeferred.promise;
+            gate.establishStartup(lease);
+        });
+        const failingStartup = gate.runStartup('session-1', async (lease) => {
+            failingLease = lease;
+            await failureBoundary;
+        });
+        expect(failingLease).toEqual(successfulLease);
+        successfulDeferred.resolve();
+        await successfulStartup;
+        rejectFailure(new Error('sibling failed'));
+        await expect(failingStartup).rejects.toThrow('sibling failed');
+        expect(gate.isGenerationCurrent('session-1', successfulLease.generation)).toBe(true);
+    });
+    it('retains an established generation when a later startup fails', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        let establishedLease;
+        await gate.runStartup('session-1', (lease) => {
+            establishedLease = lease;
+            gate.establishStartup(lease);
+            return Promise.resolve();
+        });
+        await expect(gate.runStartup('session-1', () => Promise.reject(new Error('duplicate startup')))).rejects.toThrow('duplicate startup');
+        expect(gate.isGenerationCurrent('session-1', establishedLease.generation)).toBe(true);
+    });
+    it('reserves shutdown sessions instead of allowing their startup leases to continue', async () => {
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress: () => false });
+        let firstLease;
+        let secondLease;
+        await Promise.all([
+            gate.runStartup('session-1', (lease) => {
+                firstLease = lease;
+                return Promise.resolve();
+            }),
+            gate.runStartup('session-2', (lease) => {
+                secondLease = lease;
+                return Promise.resolve();
+            }),
+        ]);
+        gate.reserveShutdown(['session-1', 'session-2']);
+        expect(gate.isSessionStopping('session-1')).toBe(true);
+        expect(gate.isSessionStopping('session-2')).toBe(true);
+        expect(() => gate.assertStartupAllowed(firstLease)).toThrow(SessionStartupCancelledError);
+        expect(() => gate.assertStartupAllowed(secondLease)).toThrow(SessionStartupCancelledError);
+        gate.releaseShutdown('session-1');
+        gate.releaseShutdown('session-2');
+        expect(gate.isSessionStopping('session-1')).toBe(false);
+        expect(gate.isSessionStopping('session-2')).toBe(false);
+    });
+    it('includes the injected runtime stop query instead of owning runtime state', async () => {
+        const isRuntimeStopInProgress = vi.fn(() => false);
+        const gate = new SessionLifecycleGate({ isRuntimeStopInProgress });
+        let lease;
+        await gate.runStartup('session-1', (startupLease) => {
+            lease = startupLease;
+            return Promise.resolve();
+        });
+        isRuntimeStopInProgress.mockReturnValue(true);
+        expect(gate.isSessionStopping('session-1')).toBe(true);
+        expect(isRuntimeStopInProgress).toHaveBeenCalledWith('session-1');
+        expect(() => gate.assertStartupAllowed(lease)).toThrow(SessionStartupCancelledError);
+    });
+});
+//# sourceMappingURL=session-lifecycle-gate.test.js.map

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle-gate.test.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/lifecycle/session-lifecycle-gate.test.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle.test-helpers.d.ts

@@ -0,0 +1,115 @@
+import { type Mock } from 'vitest';
+import type { AgentSessionRecord } from '../../../../../backend/services/session/resources/agent-session.accessor.js';
+import type { AcpProcessHandle, AcpRuntimeManager } from '../../../../../backend/services/session/service/acp/index.js';
+import type { SessionLifecycleMessageQueueBridge, SessionLifecycleWorkspaceBridge } from '../../../../../backend/services/session/service/bridges.js';
+import type { SessionDomainService } from '../../../../../backend/services/session/service/session-domain.service.js';
+import type { ChatMessage } from '../../../../../shared/acp-protocol/index.js';
+import type { SessionRuntimeState } from '../../../../../shared/session-runtime.js';
+import type { AcpEventProcessor } from './acp-event-processor.js';
+import type { SessionConfigService } from './session.config.service.js';
+import { SessionLifecycleService } from './session.lifecycle.service.js';
+import type { SessionPermissionService } from './session.permission.service.js';
+import type { SessionRepository } from './session.repository.js';
+import { SessionContextService, type SessionPermissionPresetPort } from './session-context.service.js';
+import type { SessionAcpEnvironmentPort } from './session-lifecycle.types.js';
+import type { SessionLifecycleEventService } from './session-lifecycle-event.service.js';
+import { SessionLifecycleGate } from './session-lifecycle-gate.js';
+import { SessionNotificationDeliveryService } from './session-notification-delivery.service.js';
+import { SessionTerminationCoordinator, type SessionTerminationCoordinatorDependencies } from './session-termination.coordinator.js';
+import { SessionWorkflowFinalizer } from './session-workflow-finalizer.js';
+export type Deferred<T> = {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+};
+export type LifecycleTestWorkspace = NonNullable<Awaited<ReturnType<SessionRepository['getWorkspaceById']>>>;
+export type LifecycleHarnessOverrides = {
+    session?: Partial<AgentSessionRecord>;
+    workspace?: Partial<LifecycleTestWorkspace>;
+    getSessionById?: SessionRepository['getSessionById'];
+    getSessionsByWorkspaceId?: SessionRepository['getSessionsByWorkspaceId'];
+    getOrCreateClient?: AcpRuntimeManager['getOrCreateClient'];
+    enqueue?: SessionDomainService['enqueue'];
+    transcript?: ChatMessage[];
+    historyHydrationSource?: 'jsonl' | 'acp_fallback' | 'none';
+    tryDispatchNextMessage?: SessionLifecycleMessageQueueBridge['tryDispatchNextMessage'];
+    getPermissionPreset?: SessionPermissionPresetPort['getPermissionPreset'];
+    provider?: AgentSessionRecord['provider'];
+    providerSessionId?: string | null;
+    providerProcessPid?: number | null;
+    worktreePath?: string | null;
+};
+type MockedPick<T, K extends keyof T> = {
+    [P in K]: T[P] extends (...args: never[]) => unknown ? Mock<T[P]> & T[P] : T[P];
+};
+export type LifecycleHarness = {
+    service: SessionLifecycleService;
+    repository: MockedPick<SessionRepository, 'getSessionById' | 'getSessionsByWorkspaceId' | 'getWorkspaceById' | 'getProjectById' | 'markWorkspaceHasHadSessions' | 'updateSession' | 'updateSessionIfStatus' | 'deleteSession' | 'recoverStaleRunningSessions'>;
+    runtimeManager: MockedPick<AcpRuntimeManager, 'isStopInProgress' | 'isSessionRunning' | 'hasClientCreationOperation' | 'isBrowseOnlySession' | 'isSessionWorking' | 'getClient' | 'getBrowseClient' | 'getPendingClient' | 'getSubagentBrowseCapability' | 'getOrCreateClient' | 'runClientCreationOperation' | 'stopClient' | 'stopAndQuiesce' | 'beginShutdown' | 'stopAllClients'>;
+    sessionDomainService: MockedPick<SessionDomainService, 'appendClaudeEvent' | 'emitDelta' | 'hasQueuedMessage' | 'enqueue' | 'removeQueuedMessage' | 'getTranscriptSnapshot' | 'getHistoryHydrationSource' | 'setRuntimeSnapshot' | 'isHistoryHydrated' | 'getRuntimeSnapshot' | 'clearQueuedWork' | 'clearSession' | 'markProcessExit' | 'markError'>;
+    acpEventProcessor: MockedPick<AcpEventProcessor, 'createRuntimeEventHandler' | 'registerSessionContext' | 'setReplaySuppression' | 'clearSessionState' | 'clearStreamingState' | 'clearReplaySuppression' | 'finalizeOrphanedToolCalls' | 'clearPendingToolCalls' | 'clearSessionContext' | 'getWorkspaceId' | 'handleAcpLog'>;
+    sessionConfigService: MockedPick<SessionConfigService, 'applyConfiguredReasoningEffort' | 'applyStartupModePreset' | 'applyConfiguredPermissionPreset' | 'persistAcpConfigSnapshot' | 'buildAcpChatBarCapabilities'>;
+    lifecycleEventService: MockedPick<SessionLifecycleEventService, 'record' | 'hydrate'>;
+    contextService: SessionContextService;
+    acpEnvironment: MockedPick<SessionAcpEnvironmentPort, 'getBackendPort' | 'getMcpServers'>;
+    lifecycleGate: SessionLifecycleGate;
+    notificationDeliveryService: SessionNotificationDeliveryService;
+    notificationService: MockedPick<SessionPermissionService, 'cancelPendingRequests'>;
+    workspaceBridge: MockedPick<SessionLifecycleWorkspaceBridge, 'markSessionRunning' | 'markSessionIdle' | 'recordRatchetSessionEnd' | 'resetPRDiscoveryBackoff'>;
+    messageQueueBridge: MockedPick<SessionLifecycleMessageQueueBridge, 'tryDispatchNextMessage'>;
+    session: AgentSessionRecord;
+    workspace: LifecycleTestWorkspace;
+    handle: AcpProcessHandle;
+    sendSessionMessage: Mock<(sessionId: string, content: string) => Promise<void>>;
+    tryDispatchNextMessage: Mock<SessionLifecycleMessageQueueBridge['tryDispatchNextMessage']>;
+};
+export type TerminationHarness = {
+    coordinator: SessionTerminationCoordinator;
+    repository: MockedPick<SessionRepository, 'getSessionById' | 'getSessionsByWorkspaceId' | 'updateSessionIfStatus'>;
+    retryService: SessionTerminationCoordinatorDependencies['retryService'];
+    runtimeManager: MockedPick<AcpRuntimeManager, 'getClient' | 'isSessionWorking' | 'isStopInProgress' | 'isSessionRunning' | 'hasClientCreationOperation' | 'isBrowseOnlySession' | 'stopAndQuiesce' | 'beginShutdown' | 'stopAllClients'>;
+    sessionDomainService: MockedPick<SessionDomainService, 'clearQueuedWork' | 'getRuntimeSnapshot' | 'setRuntimeSnapshot'>;
+    sessionPermissionService: MockedPick<SessionPermissionService, 'cancelPendingRequests'>;
+    acpEventProcessor: MockedPick<AcpEventProcessor, 'clearSessionState' | 'clearStreamingState' | 'clearReplaySuppression' | 'finalizeOrphanedToolCalls' | 'clearPendingToolCalls' | 'getWorkspaceId'>;
+    promptTurnCompletionService: {
+        clearSession: Mock<(sessionId: string) => void>;
+        clearAll: Mock<() => void>;
+    };
+    lifecycleEventService: MockedPick<SessionLifecycleEventService, 'record'>;
+    lifecycleGate: SessionLifecycleGate;
+    workflowFinalizer: MockedPick<SessionWorkflowFinalizer, 'finalizeDeliberateStop' | 'clearInactiveSession'>;
+    workspaceBridge: MockedPick<SessionLifecycleWorkspaceBridge, 'markSessionIdle'>;
+    getRuntimeSnapshot: Mock<(sessionId: string) => SessionRuntimeState>;
+    session: AgentSessionRecord;
+};
+export type TerminationHarnessOverrides = Pick<LifecycleHarnessOverrides, 'session' | 'getSessionById' | 'getSessionsByWorkspaceId'> & {
+    onBeforeStopSession?: (sessionId: string) => void;
+};
+export declare function createDeferred<T>(): Deferred<T>;
+export declare function createTerminationHarness(overrides?: TerminationHarnessOverrides): TerminationHarness;
+export declare function createLifecycleTestSession(overrides?: Partial<AgentSessionRecord>): AgentSessionRecord;
+export declare function createLifecycleTestWorkspace(overrides?: Partial<LifecycleTestWorkspace>): LifecycleTestWorkspace;
+export declare function createPendingWorkspaceNotification(overrides?: Partial<{
+    id: string;
+    workspaceId: string;
+    sourceWorkspaceId: string;
+    sourceWorkspaceName: string;
+    sourceProjectName: string;
+    message: string;
+    direction: 'PARENT_TO_CHILD' | 'CHILD_TO_PARENT';
+    deliveredAt: Date | null;
+    createdAt: Date;
+}>): {
+    id: string;
+    workspaceId: string;
+    sourceWorkspaceId: string;
+    sourceWorkspaceName: string;
+    sourceProjectName: string;
+    message: string;
+    direction: "PARENT_TO_CHILD" | "CHILD_TO_PARENT";
+    deliveredAt: Date | null;
+    createdAt: Date;
+};
+export declare function createLifecycleHarness(overrides?: LifecycleHarnessOverrides): LifecycleHarness;
+export {};
+//# sourceMappingURL=session-lifecycle.test-helpers.d.ts.map

package/dist/src/backend/services/session/service/lifecycle/session-lifecycle.test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.test-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/lifecycle/session-lifecycle.test-helpers.ts"],"names":[],"mappings":"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"}