factory-factory 0.4.5 → 0.4.7

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.js

@@ -0,0 +1,208 @@
+import { randomUUID } from 'node:crypto';
+import { createLogger } from '../../../../../backend/services/logger.service.js';
+import { acpTraceLogger } from '../../../../../backend/services/session/service/logging/acp-trace-logger.service.js';
+import { SessionLifecycleEventKind, SessionLifecycleEventReason, SessionStatus, } from '../../../../../shared/core/index.js';
+const logger = createLogger('session');
+function getPersistedStatusForExitCode(exitCode) {
+    return exitCode === 0 ? SessionStatus.COMPLETED : SessionStatus.FAILED;
+}
+export class SessionRuntimeExitCoordinator {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    createHandlers(input) {
+        const runtimeEventHandler = this.dependencies.acpEventProcessor.createRuntimeEventHandler(input.sessionId);
+        const legacyIncarnationId = randomUUID();
+        return {
+            ...runtimeEventHandler,
+            ...(input.persistProviderSessionId
+                ? { onSessionId: this.createProviderSessionIdHandler() }
+                : {}),
+            onRuntimeExit: (event) => this.handleExit(event),
+            onRuntimeError: (event) => {
+                this.handleRuntimeError(event);
+            },
+            onExit: async (sessionId, exitCode) => {
+                await this.handleExit({
+                    sessionId,
+                    exitCode,
+                    incarnationId: legacyIncarnationId,
+                    purpose: input.purpose,
+                    managed: this.dependencies.lifecycleGate.isSessionStopping(sessionId),
+                });
+            },
+            onError: (sessionId, error) => {
+                this.handleRuntimeError({
+                    sessionId,
+                    error,
+                    incarnationId: legacyIncarnationId,
+                    purpose: input.purpose,
+                });
+            },
+            onAcpLog: (sessionId, payload) => {
+                this.dependencies.acpEventProcessor.handleAcpLog(sessionId, payload);
+            },
+        };
+    }
+    async handleExit(event) {
+        try {
+            const stopWillPersistIdle = this.dependencies.lifecycleGate.isStopReserved(event.sessionId);
+            const deliberate = event.managed || this.dependencies.lifecycleGate.isSessionStopping(event.sessionId);
+            this.dependencies.lifecycleGate.releaseShutdown(event.sessionId);
+            if (event.purpose === 'browse') {
+                this.dependencies.acpEventProcessor.clearSessionState(event.sessionId);
+                return;
+            }
+            this.prepareRuntimeExit(event.sessionId, event.exitCode);
+            await this.handleActiveExit(event, deliberate, stopWillPersistIdle);
+        }
+        finally {
+            if (event.purpose === 'browse') {
+                acpTraceLogger.closeSession(event.sessionId);
+            }
+            else {
+                try {
+                    this.dependencies.workflowFinalizer.clearInactiveSession(event.sessionId, 'runtime_exit');
+                }
+                finally {
+                    acpTraceLogger.closeSession(event.sessionId);
+                }
+            }
+        }
+    }
+    createProviderSessionIdHandler() {
+        return async (sessionId, providerSessionId) => {
+            try {
+                await this.dependencies.repository.updateSession(sessionId, { providerSessionId });
+                acpTraceLogger.log(sessionId, 'runtime_metadata', {
+                    type: 'provider_session_id',
+                    providerSessionId,
+                });
+                logger.debug('Updated session with ACP providerSessionId', {
+                    sessionId,
+                    providerSessionId,
+                });
+            }
+            catch (error) {
+                logger.warn('Failed to update session with ACP providerSessionId', {
+                    sessionId,
+                    providerSessionId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        };
+    }
+    handleRuntimeError(event) {
+        acpTraceLogger.log(event.sessionId, 'runtime_error', {
+            message: event.error.message,
+            stack: event.error.stack,
+        });
+        if (event.purpose !== 'browse') {
+            this.dependencies.sessionDomainService.markError(event.sessionId, event.error.message);
+        }
+        logger.error('ACP client error', {
+            sessionId: event.sessionId,
+            error: event.error.message,
+            stack: event.error.stack,
+        });
+    }
+    async handleActiveExit(event, deliberate, stopWillPersistIdle) {
+        try {
+            this.dependencies.sessionDomainService.markProcessExit(event.sessionId, event.exitCode);
+            const session = await this.dependencies.repository.getSessionById(event.sessionId);
+            if (!session) {
+                logger.warn('Failed to find ACP session on exit', { sessionId: event.sessionId });
+                return;
+            }
+            if (!(stopWillPersistIdle && event.exitCode !== 0)) {
+                await this.updatePersistedStatus(event);
+            }
+            try {
+                await this.recordUnexpectedExitIfNeeded(session, event, deliberate);
+            }
+            catch (error) {
+                logger.warn('Failed recording unexpected ACP session exit', {
+                    sessionId: event.sessionId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            await this.dependencies.workflowFinalizer.finalizeRuntimeExit({
+                session,
+                sessionId: event.sessionId,
+                exitCode: event.exitCode,
+                deliberate,
+            });
+        }
+        catch (error) {
+            logger.warn('Failed to process ACP session exit', {
+                sessionId: event.sessionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    prepareRuntimeExit(sessionId, exitCode) {
+        this.dependencies.promptTurnCompletionService.clearSession(sessionId);
+        try {
+            this.dependencies.onSessionExit?.(sessionId);
+        }
+        catch (error) {
+            logger.warn('Failed handling ACP session exit callback', {
+                sessionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        this.finalizeOrphanedToolCalls(sessionId);
+        this.dependencies.acpEventProcessor.clearSessionState(sessionId);
+        this.dependencies.sessionPermissionService.cancelPendingRequests(sessionId);
+        acpTraceLogger.log(sessionId, 'runtime_exit', { exitCode });
+    }
+    finalizeOrphanedToolCalls(sessionId) {
+        try {
+            this.dependencies.acpEventProcessor.finalizeOrphanedToolCalls(sessionId, 'runtime_exit');
+        }
+        catch (error) {
+            logger.warn('Failed finalizing orphaned ACP tool calls', {
+                sessionId,
+                reason: 'runtime_exit',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            this.dependencies.acpEventProcessor.clearPendingToolCalls(sessionId);
+        }
+    }
+    async updatePersistedStatus(event) {
+        const persistedStatus = getPersistedStatusForExitCode(event.exitCode);
+        try {
+            await this.dependencies.repository.updateSession(event.sessionId, {
+                status: persistedStatus,
+            });
+            logger.debug('Updated ACP session status on exit', {
+                sessionId: event.sessionId,
+                exitCode: event.exitCode,
+                status: persistedStatus,
+            });
+        }
+        catch (error) {
+            logger.warn('Failed to update ACP session status on exit', {
+                sessionId: event.sessionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    async recordUnexpectedExitIfNeeded(session, event, deliberate) {
+        if (deliberate) {
+            return;
+        }
+        await this.dependencies.lifecycleEventService.record({
+            workspaceId: session.workspaceId,
+            sessionId: event.sessionId,
+            kind: SessionLifecycleEventKind.SESSION_STOPPED,
+            reason: SessionLifecycleEventReason.UNEXPECTED_EXIT,
+            message: event.exitCode === null
+                ? 'Session stopped: agent process exited unexpectedly.'
+                : `Session stopped: agent process exited unexpectedly (code ${event.exitCode}).`,
+            dedupeKey: `process-exit:${event.incarnationId}:${event.exitCode ?? 'signal'}`,
+        });
+    }
+}
+//# sourceMappingURL=session-runtime-exit.coordinator.js.map

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.js.map

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

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.test.d.ts

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

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.test.d.ts.map

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

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.test.js

@@ -0,0 +1,274 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { SessionStatus } from '../../../../../shared/core/index.js';
+import { createLifecycleTestSession } from './session-lifecycle.test-helpers.js';
+import { SessionRuntimeExitCoordinator } from './session-runtime-exit.coordinator.js';
+const { mockTraceLog, mockTraceClose } = vi.hoisted(() => ({
+    mockTraceLog: vi.fn(),
+    mockTraceClose: vi.fn(),
+}));
+vi.mock('@/backend/services/logger.service', () => ({
+    createLogger: () => ({
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    }),
+    getCurrentProcessEnv: () => ({ NODE_ENV: 'test' }),
+}));
+vi.mock('@/backend/services/session/service/logging/acp-trace-logger.service', () => ({
+    acpTraceLogger: {
+        log: mockTraceLog,
+        closeSession: mockTraceClose,
+    },
+}));
+function createExitCoordinatorHarness(options) {
+    const session = createLifecycleTestSession();
+    const repository = {
+        getSessionById: vi.fn(async () => session),
+        updateSession: vi.fn(async () => session),
+    };
+    const domain = {
+        markError: vi.fn(),
+        markProcessExit: vi.fn(),
+    };
+    const permission = {
+        cancelPendingRequests: vi.fn(),
+    };
+    const processorHandlers = {
+        onAcpEvent: vi.fn(),
+    };
+    const processor = {
+        createRuntimeEventHandler: vi.fn(() => processorHandlers),
+        clearSessionState: vi.fn(),
+        finalizeOrphanedToolCalls: vi.fn(),
+        clearPendingToolCalls: vi.fn(),
+        handleAcpLog: vi.fn(),
+    };
+    const promptCompletion = {
+        clearSession: vi.fn(),
+    };
+    const lifecycleEvents = {
+        record: vi.fn(async () => null),
+    };
+    const lifecycleGate = {
+        isSessionStopping: vi.fn(() => options?.lifecycleStopping ?? false),
+        isStopReserved: vi.fn(() => options?.explicitStopReserved ?? false),
+        releaseShutdown: vi.fn(),
+    };
+    const workflowFinalizer = {
+        finalizeRuntimeExit: vi.fn(async () => undefined),
+        clearInactiveSession: vi.fn(),
+    };
+    const onSessionExit = vi.fn();
+    const coordinator = new SessionRuntimeExitCoordinator({
+        repository,
+        sessionDomainService: domain,
+        sessionPermissionService: permission,
+        acpEventProcessor: processor,
+        promptTurnCompletionService: promptCompletion,
+        lifecycleEventService: lifecycleEvents,
+        lifecycleGate,
+        workflowFinalizer,
+        onSessionExit,
+    });
+    const purpose = options?.browse ? 'browse' : 'active';
+    const handlers = coordinator.createHandlers({
+        sessionId: 'session-1',
+        purpose,
+        persistProviderSessionId: !options?.browse,
+    });
+    return {
+        coordinator,
+        handlers,
+        repository,
+        domain,
+        permission,
+        processor,
+        processorHandlers,
+        promptCompletion,
+        lifecycleEvents,
+        lifecycleGate,
+        workflowFinalizer,
+        onSessionExit,
+        session,
+    };
+}
+function runtimeExit(overrides = {}) {
+    return {
+        sessionId: 'session-1',
+        exitCode: 1,
+        incarnationId: '11111111-1111-4111-8111-111111111111',
+        purpose: 'active',
+        managed: false,
+        ...overrides,
+    };
+}
+describe('SessionRuntimeExitCoordinator', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('creates ACP handlers and persists provider session identity for active runtimes', async () => {
+        const harness = createExitCoordinatorHarness();
+        await harness.handlers.onSessionId?.('session-1', 'provider-session-9');
+        expect(harness.processor.createRuntimeEventHandler).toHaveBeenCalledWith('session-1');
+        expect(harness.handlers.onAcpEvent).toBe(harness.processorHandlers.onAcpEvent);
+        expect(harness.repository.updateSession).toHaveBeenCalledWith('session-1', {
+            providerSessionId: 'provider-session-9',
+        });
+        expect(mockTraceLog).toHaveBeenCalledWith('session-1', 'runtime_metadata', {
+            type: 'provider_session_id',
+            providerSessionId: 'provider-session-9',
+        });
+    });
+    it('omits provider session persistence for browse runtimes', () => {
+        const harness = createExitCoordinatorHarness({ browse: true });
+        expect(harness.handlers.onSessionId).toBeUndefined();
+    });
+    it('public handleExit cleans up a browse exit without finalizing the active session', async () => {
+        const harness = createExitCoordinatorHarness({ browse: true });
+        await harness.coordinator.handleExit(runtimeExit({ purpose: 'browse' }));
+        expect(harness.lifecycleGate.releaseShutdown).toHaveBeenCalledWith('session-1');
+        expect(harness.processor.clearSessionState).toHaveBeenCalledWith('session-1');
+        expect(mockTraceClose).toHaveBeenCalledWith('session-1');
+        expect(harness.domain.markProcessExit).not.toHaveBeenCalled();
+        expect(harness.repository.getSessionById).not.toHaveBeenCalled();
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).not.toHaveBeenCalled();
+    });
+    it('records runtime errors only for active runtimes', () => {
+        const active = createExitCoordinatorHarness();
+        const browse = createExitCoordinatorHarness({ browse: true });
+        const runtimeError = new Error('provider transport failed');
+        active.handlers.onError?.('session-1', runtimeError);
+        browse.handlers.onError?.('session-1', runtimeError);
+        expect(active.domain.markError).toHaveBeenCalledWith('session-1', 'provider transport failed');
+        expect(browse.domain.markError).not.toHaveBeenCalled();
+        expect(mockTraceLog).toHaveBeenCalledWith('session-1', 'runtime_error', expect.objectContaining({ message: 'provider transport failed' }));
+    });
+    it('uses typed runtime error purpose instead of handler creation purpose', () => {
+        const harness = createExitCoordinatorHarness({ browse: true });
+        const runtimeError = new Error('promoted runtime failed');
+        harness.handlers.onRuntimeError?.({
+            sessionId: 'session-1',
+            error: runtimeError,
+            incarnationId: '11111111-1111-4111-8111-111111111111',
+            purpose: 'active',
+        });
+        expect(harness.domain.markError).toHaveBeenCalledWith('session-1', 'promoted runtime failed');
+    });
+    it('records the process-exit snapshot and successful persisted status', async () => {
+        const harness = createExitCoordinatorHarness();
+        await harness.coordinator.handleExit(runtimeExit({ exitCode: 0 }));
+        expect(harness.domain.markProcessExit).toHaveBeenCalledWith('session-1', 0);
+        expect(harness.repository.updateSession).toHaveBeenCalledWith('session-1', {
+            status: SessionStatus.COMPLETED,
+        });
+    });
+    it('continues durable exit effects after the persisted status update fails', async () => {
+        const harness = createExitCoordinatorHarness();
+        harness.repository.updateSession.mockRejectedValueOnce(new Error('database write failed'));
+        await harness.coordinator.handleExit(runtimeExit());
+        expect(harness.lifecycleEvents.record).toHaveBeenCalledOnce();
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledOnce();
+    });
+    it('continues workflow finalization when unexpected-exit history fails', async () => {
+        const harness = createExitCoordinatorHarness();
+        harness.lifecycleEvents.record.mockRejectedValueOnce(new Error('history write failed'));
+        await harness.coordinator.handleExit(runtimeExit());
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledOnce();
+    });
+    it.each([
+        [1, 'Session stopped: agent process exited unexpectedly (code 1).', '1'],
+        [null, 'Session stopped: agent process exited unexpectedly.', 'signal'],
+    ])('records unmanaged exit code %s with an incarnation-scoped dedupe key', async (exitCode, message, dedupeSuffix) => {
+        const harness = createExitCoordinatorHarness();
+        await harness.coordinator.handleExit(runtimeExit({ exitCode }));
+        expect(harness.lifecycleEvents.record).toHaveBeenCalledWith({
+            workspaceId: 'workspace-1',
+            sessionId: 'session-1',
+            kind: 'SESSION_STOPPED',
+            reason: 'UNEXPECTED_EXIT',
+            message,
+            dedupeKey: `process-exit:11111111-1111-4111-8111-111111111111:${dedupeSuffix}`,
+        });
+    });
+    it('preserves idle status when an explicit lifecycle stop owns the transition', async () => {
+        const harness = createExitCoordinatorHarness({
+            lifecycleStopping: true,
+            explicitStopReserved: true,
+        });
+        await harness.coordinator.handleExit(runtimeExit({ managed: true, exitCode: null }));
+        expect(harness.repository.updateSession).not.toHaveBeenCalled();
+        expect(harness.lifecycleEvents.record).not.toHaveBeenCalled();
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledWith(expect.objectContaining({ deliberate: true }));
+    });
+    it.each([
+        ['runtime-managed', false],
+        ['shutdown-managed', true],
+    ])('persists failed status for %s exits without an explicit stop reservation', async (_caseName, lifecycleStopping) => {
+        const harness = createExitCoordinatorHarness({ lifecycleStopping });
+        await harness.coordinator.handleExit(runtimeExit({ managed: true, exitCode: null }));
+        expect(harness.repository.updateSession).toHaveBeenCalledWith('session-1', {
+            status: SessionStatus.FAILED,
+        });
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledWith(expect.objectContaining({ deliberate: true }));
+    });
+    it('prepares active runtime state and delegates workflow-specific exit effects', async () => {
+        const harness = createExitCoordinatorHarness({ lifecycleStopping: true });
+        await harness.coordinator.handleExit(runtimeExit());
+        expect(harness.promptCompletion.clearSession).toHaveBeenCalledWith('session-1');
+        expect(harness.onSessionExit).toHaveBeenCalledWith('session-1');
+        expect(harness.processor.finalizeOrphanedToolCalls).toHaveBeenCalledWith('session-1', 'runtime_exit');
+        expect(harness.processor.clearSessionState).toHaveBeenCalledWith('session-1');
+        expect(harness.permission.cancelPendingRequests).toHaveBeenCalledWith('session-1');
+        expect(mockTraceLog).toHaveBeenCalledWith('session-1', 'runtime_exit', { exitCode: 1 });
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledWith({
+            session: harness.session,
+            sessionId: 'session-1',
+            exitCode: 1,
+            deliberate: true,
+        });
+    });
+    it('continues cleanup when the session-exit callback fails', async () => {
+        const harness = createExitCoordinatorHarness();
+        harness.onSessionExit.mockImplementationOnce(() => {
+            throw new Error('queue cleanup failed');
+        });
+        await harness.coordinator.handleExit(runtimeExit());
+        expect(harness.processor.finalizeOrphanedToolCalls).toHaveBeenCalledWith('session-1', 'runtime_exit');
+        expect(harness.processor.clearSessionState).toHaveBeenCalledWith('session-1');
+        expect(harness.permission.cancelPendingRequests).toHaveBeenCalledWith('session-1');
+        expect(harness.repository.updateSession).toHaveBeenCalledWith('session-1', {
+            status: SessionStatus.FAILED,
+        });
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).toHaveBeenCalledOnce();
+    });
+    it('closes the trace without active finalization when browse cleanup fails', async () => {
+        const harness = createExitCoordinatorHarness({ browse: true });
+        harness.processor.clearSessionState.mockImplementationOnce(() => {
+            throw new Error('browse cleanup failed');
+        });
+        await expect(harness.coordinator.handleExit(runtimeExit({ purpose: 'browse' }))).rejects.toThrow('browse cleanup failed');
+        expect(mockTraceClose).toHaveBeenCalledWith('session-1');
+        expect(harness.domain.markProcessExit).not.toHaveBeenCalled();
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).not.toHaveBeenCalled();
+    });
+    it('closes the trace without finalization when active preparation fails', async () => {
+        const harness = createExitCoordinatorHarness();
+        harness.promptCompletion.clearSession.mockImplementationOnce(() => {
+            throw new Error('active preparation failed');
+        });
+        await expect(harness.coordinator.handleExit(runtimeExit())).rejects.toThrow('active preparation failed');
+        expect(mockTraceClose).toHaveBeenCalledWith('session-1');
+        expect(harness.domain.markProcessExit).not.toHaveBeenCalled();
+        expect(harness.workflowFinalizer.finalizeRuntimeExit).not.toHaveBeenCalled();
+    });
+    it('closes the trace in finally when inactive cleanup fails', async () => {
+        const harness = createExitCoordinatorHarness();
+        harness.workflowFinalizer.clearInactiveSession.mockImplementationOnce(() => {
+            throw new Error('inactive cleanup failed');
+        });
+        await expect(harness.coordinator.handleExit(runtimeExit())).rejects.toThrow('inactive cleanup failed');
+        expect(mockTraceClose).toHaveBeenCalledWith('session-1');
+    });
+});
+//# sourceMappingURL=session-runtime-exit.coordinator.test.js.map

package/dist/src/backend/services/session/service/lifecycle/session-runtime-exit.coordinator.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,105 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { chatMessageHandlerService as publicChatMessageHandlerService, sessionLifecycleService as publicSessionLifecycleService, } from '../../../../../backend/services/session/index.js';
+import { WorkspaceStatus } from '../../../../../shared/core/index.js';
+import { unsafeCoerce } from '../../../../../test-utils/unsafe-coerce.js';
+import { sessionLifecycleService as coreSessionLifecycleService } from './session-core-services.js';
+import { createLifecycleHarness, createLifecycleTestSession, } from './session-lifecycle.test-helpers.js';
+import { chatMessageHandlerService, sessionLifecycleService } from './session-services.js';
+describe('session services composition', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('exports one configured chat singleton whose startup adapter filters chat-only options', async () => {
+        expect(publicChatMessageHandlerService).toBe(chatMessageHandlerService);
+        expect(publicSessionLifecycleService).toBe(sessionLifecycleService);
+        expect(coreSessionLifecycleService).toBe(sessionLifecycleService);
+        vi.spyOn(sessionLifecycleService, 'getSessionOptions').mockResolvedValue({
+            workingDir: '/tmp/worktree',
+            resumeProviderSessionId: undefined,
+            systemPrompt: undefined,
+            model: 'sonnet',
+            workspaceStatus: WorkspaceStatus.READY,
+        });
+        const getOrCreateSessionClient = vi
+            .spyOn(sessionLifecycleService, 'getOrCreateSessionClient')
+            .mockResolvedValue(unsafeCoerce({ sessionId: 'session-1' }));
+        await chatMessageHandlerService.handleMessage(unsafeCoerce({ send: vi.fn() }), 'session-1', '/tmp/worktree', {
+            type: 'start',
+            thinkingEnabled: true,
+            planModeEnabled: true,
+            selectedModel: 'opus',
+            reasoningEffort: 'high',
+        });
+        expect(getOrCreateSessionClient).toHaveBeenCalledOnce();
+        expect(getOrCreateSessionClient).toHaveBeenCalledWith('session-1', {
+            thinkingEnabled: true,
+            model: 'opus',
+            reasoningEffort: 'high',
+        });
+    });
+    it('composes browse startup through the real startup coordinator', async () => {
+        const { service, runtimeManager } = createLifecycleHarness({
+            provider: 'CODEX',
+            providerSessionId: 'provider-session-1',
+        });
+        runtimeManager.getSubagentBrowseCapability.mockImplementation(() => runtimeManager.getOrCreateClient.mock.calls.length > 0
+            ? { version: 1, list: true, read: true, notifications: true }
+            : null);
+        await expect(service.ensureSubagentBrowseSession('session-1')).resolves.toBe(true);
+        expect(runtimeManager.getOrCreateClient).toHaveBeenCalledWith('session-1', expect.objectContaining({
+            provider: 'CODEX',
+            purpose: 'browse',
+            resumeProviderSessionId: 'provider-session-1',
+        }), expect.objectContaining({
+            onRuntimeError: expect.any(Function),
+            onRuntimeExit: expect.any(Function),
+        }), {
+            workspaceId: 'workspace-1',
+            workingDir: '/tmp/workspace',
+        });
+    });
+    it('builds runtime handlers backed by complete lifecycle harness ports', async () => {
+        const { service, runtimeManager, sessionDomainService, acpEventProcessor } = createLifecycleHarness();
+        await service.getOrCreateSessionClient('session-1');
+        const handlers = runtimeManager.getOrCreateClient.mock.calls[0]?.[2];
+        expect(handlers?.onRuntimeError).toEqual(expect.any(Function));
+        expect(handlers?.onAcpLog).toEqual(expect.any(Function));
+        handlers?.onRuntimeError?.({
+            sessionId: 'session-1',
+            error: new Error('runtime failed'),
+            incarnationId: 'incarnation-1',
+            purpose: 'active',
+        });
+        handlers?.onAcpLog?.('session-1', { message: 'provider log' });
+        expect(sessionDomainService.markError).toHaveBeenCalledWith('session-1', 'runtime failed');
+        expect(acpEventProcessor.handleAcpLog).toHaveBeenCalledWith('session-1', {
+            message: 'provider log',
+        });
+    });
+    it('builds workflow finalization with recovery and transient deletion ports', async () => {
+        const { service, sessionDomainService } = createLifecycleHarness({
+            session: { workflow: 'ratchet' },
+        });
+        await expect(service.recoverStaleRunningSessions()).resolves.toBe(0);
+        await service.stopSession('session-1', {
+            cleanupTransientRatchetSession: true,
+            recordLifecycleEvent: false,
+        });
+        expect(sessionDomainService.clearSession).toHaveBeenCalledWith('session-1');
+    });
+    it('wires a lifecycle coordinator to a later workspace bridge without mutating the singleton', async () => {
+        const { service, repository, runtimeManager } = createLifecycleHarness();
+        const workspaceBridge = {
+            markSessionIdle: vi.fn(),
+        };
+        service.configure({ workspace: unsafeCoerce(workspaceBridge) });
+        repository.getSessionById.mockResolvedValue(createLifecycleTestSession({ id: 'session-composed', workspaceId: 'workspace-composed' }));
+        repository.updateSessionIfStatus.mockResolvedValue(1);
+        await service.stopSession('session-composed', {
+            recordLifecycleEvent: false,
+        });
+        expect(runtimeManager.stopAndQuiesce).toHaveBeenCalledWith('session-composed');
+        expect(workspaceBridge.markSessionIdle).toHaveBeenCalledWith('workspace-composed', 'session-composed');
+    });
+});
+//# sourceMappingURL=session-services.composition.test.js.map