agent-tower 0.7.4 → 0.7.5-beta.5

package/dist/services/__tests__/preview-runtime-manager.test.js

@@ -1,123 +1,50 @@
-import { EventEmitter } from 'node:events';
 import http from 'node:http';
-import { afterEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, describe, expect, it } from 'vitest';
 import { normalizePreviewTarget } from '../preview.service.js';
 import { PreviewRuntimeManager, rewriteTargetCookie } from '../preview-runtime-manager.js';
-class FakeTunnel extends EventEmitter {
-    stopped = false;
-    stop() {
-        this.stopped = true;
-        this.emit('exit', 0, null);
-        return true;
-    }
-}
 const managers = [];
 afterEach(async () => {
     await Promise.all(managers.splice(0).map((manager) => manager.stopAll()));
 });
 describe('PreviewRuntimeManager lifecycle', () => {
-    it('starts one remote tunnel per workspace and reuses it across active leases', async () => {
-        const tunnels = [];
-        const ensureTunnelBinary = vi.fn(async () => { });
-        const manager = new PreviewRuntimeManager({
-            listenHost: '127.0.0.1',
-            ensureTunnelBinary,
-            createTunnel: () => {
-                const tunnel = new FakeTunnel();
-                tunnels.push(tunnel);
-                setTimeout(() => tunnel.emit('url', 'https://preview-test.trycloudflare.com'), 0);
-                return tunnel;
-            },
-        });
-        managers.push(manager);
-        const target = normalizePreviewTarget('http://127.0.0.1:3000');
-        const [first, second] = await Promise.all([
-            manager.acquire('workspace-1', target, 'remote', 'localhost'),
-            manager.acquire('workspace-1', target, 'remote', 'localhost'),
-        ]);
-        expect(first.viewBaseUrl).toBe('https://preview-test.trycloudflare.com');
-        expect(second.viewBaseUrl).toBe(first.viewBaseUrl);
-        expect(tunnels).toHaveLength(1);
-        expect(ensureTunnelBinary).toHaveBeenCalledTimes(1);
-    });
     it('reclaims every gateway after simultaneous first acquisition', async () => {
         const manager = new PreviewRuntimeManager({ listenHost: '127.0.0.1' });
         managers.push(manager);
         const target = normalizePreviewTarget('http://127.0.0.1:3000');
         const sessions = await Promise.all([
-            manager.acquire('same-workspace', target, 'local', 'localhost'),
-            manager.acquire('same-workspace', target, 'local', 'localhost'),
+            manager.acquire('same-workspace', target, 'localhost'),
+            manager.acquire('same-workspace', target, 'localhost'),
         ]);
         expect(sessions[0].viewBaseUrl).toBe(sessions[1].viewBaseUrl);
         expect(await manager.heartbeat('same-workspace', sessions[0].id)).not.toBeNull();
         await manager.stopAll();
         await expect(fetch(sessions[0].viewBaseUrl)).rejects.toThrow();
     });
-    it('cancels binary setup on invalidation and never launches the old tunnel', async () => {
-        let finishSetup;
-        const setup = new Promise((resolve) => { finishSetup = resolve; });
-        const ensureTunnelBinary = vi.fn(() => setup);
-        const createTunnel = vi.fn(() => new FakeTunnel());
-        const manager = new PreviewRuntimeManager({ listenHost: '127.0.0.1', ensureTunnelBinary, createTunnel });
-        managers.push(manager);
-        const opening = manager.acquire('invalidated', normalizePreviewTarget('http://127.0.0.1:3000'), 'remote', 'localhost');
-        const rejected = expect(opening).rejects.toThrow('cancelled');
-        await vi.waitFor(() => expect(ensureTunnelBinary).toHaveBeenCalled());
-        await manager.invalidate('invalidated');
-        finishSetup();
-        await rejected;
-        expect(createTunnel).not.toHaveBeenCalled();
-    });
     it('closes a gateway invalidated before listen completes and rejects shutdown opens', async () => {
         const manager = new PreviewRuntimeManager({ listenHost: '127.0.0.1' });
         managers.push(manager);
         const target = normalizePreviewTarget('http://127.0.0.1:3000');
-        const opening = manager.acquire('pending-listen', target, 'local', 'localhost');
+        const opening = manager.acquire('pending-listen', target, 'localhost');
         const rejected = expect(opening).rejects.toThrow('invalidated');
         await manager.invalidate('pending-listen');
         await rejected;
         await manager.stopAll();
-        await expect(manager.acquire('after-stop', target, 'local', 'localhost')).rejects.toThrow('stopped');
+        await expect(manager.acquire('after-stop', target, 'localhost')).rejects.toThrow('stopped');
     });
-    it('retains a tunnel after failed invalidation and retries it on shutdown', async () => {
-        const tunnel = new FakeTunnel();
-        const manager = new PreviewRuntimeManager({ listenHost: '127.0.0.1', createTunnel: () => {
-                queueMicrotask(() => tunnel.emit('url', 'https://retry.trycloudflare.com'));
-                return tunnel;
-            } });
+    it('formats IPv6 browser hostnames for the gateway URL', async () => {
+        const manager = new PreviewRuntimeManager({ listenHost: '127.0.0.1' });
         managers.push(manager);
-        await manager.acquire('retry-workspace', normalizePreviewTarget('http://127.0.0.1:3000'), 'remote', 'localhost');
-        const stop = vi.spyOn(tunnel, 'stop').mockImplementation(() => true);
-        vi.useFakeTimers();
-        try {
-            const invalidating = manager.invalidate('retry-workspace');
-            const rejected = expect(invalidating).rejects.toThrow('did not exit');
-            await vi.advanceTimersByTimeAsync(3000);
-            await rejected;
-            stop.mockRestore();
-            await manager.stopAll();
-            expect(tunnel.stopped).toBe(true);
-        }
-        finally {
-            stop.mockRestore();
-            vi.useRealTimers();
-        }
+        const session = await manager.acquire('ipv6', normalizePreviewTarget('http://127.0.0.1:3000'), '::1');
+        expect(session.viewBaseUrl).toMatch(/^http:\/\/\[::1\]:\d+$/);
     });
-    it('stops the tunnel and local gateway after the last lease becomes idle', async () => {
+    it('stops the local gateway after the last lease becomes idle', async () => {
         let now = 0;
-        const tunnels = [];
         const manager = new PreviewRuntimeManager({
             listenHost: '127.0.0.1',
             idleTtlMs: 20,
             leaseTtlMs: 20,
             sweepIntervalMs: 5,
             now: () => now,
-            createTunnel: () => {
-                const tunnel = new FakeTunnel();
-                tunnels.push(tunnel);
-                setTimeout(() => tunnel.emit('url', 'https://preview-idle.trycloudflare.com'), 0);
-                return tunnel;
-            },
         });
         managers.push(manager);
         const targetServer = http.createServer((_request, response) => response.end('ok'));
@@ -127,42 +54,16 @@ describe('PreviewRuntimeManager lifecycle', () => {
             throw new Error('Target server did not start');
         try {
             const target = normalizePreviewTarget(`http://127.0.0.1:${address.port}`);
-            const session = await manager.acquire('workspace-idle', target, 'remote', 'localhost');
+            const session = await manager.acquire('workspace-idle', target, 'localhost');
             manager.release('workspace-idle', session.id);
             now = 100;
-            await expect.poll(() => tunnels[0]?.stopped, { timeout: 500 }).toBe(true);
-            expect(await manager.heartbeat('workspace-idle', session.id)).toBeNull();
+            await expect.poll(async () => manager.heartbeat('workspace-idle', session.id), { timeout: 500 }).toBeNull();
+            await expect(fetch(session.viewBaseUrl)).rejects.toThrow();
         }
         finally {
             await new Promise((resolve) => targetServer.close(() => resolve()));
         }
     });
-    it('reclaims an idle remote tunnel while keeping an active local gateway session', async () => {
-        let now = 0;
-        const tunnels = [];
-        const manager = new PreviewRuntimeManager({
-            listenHost: '127.0.0.1',
-            idleTtlMs: 20,
-            leaseTtlMs: 1_000,
-            sweepIntervalMs: 5,
-            now: () => now,
-            createTunnel: () => {
-                const tunnel = new FakeTunnel();
-                tunnels.push(tunnel);
-                setTimeout(() => tunnel.emit('url', 'https://preview-mixed.trycloudflare.com'), 0);
-                return tunnel;
-            },
-        });
-        managers.push(manager);
-        const target = normalizePreviewTarget('http://127.0.0.1:3000');
-        const localSession = await manager.acquire('workspace-mixed', target, 'local', 'localhost');
-        const remoteSession = await manager.acquire('workspace-mixed', target, 'remote', 'localhost');
-        manager.release('workspace-mixed', remoteSession.id);
-        now = 100;
-        await expect.poll(() => tunnels[0]?.stopped, { timeout: 500 }).toBe(true);
-        expect(await manager.heartbeat('workspace-mixed', localSession.id)).not.toBeNull();
-        expect(tunnels).toHaveLength(1);
-    });
 });
 describe('preview target cookies', () => {
     const target = normalizePreviewTarget('http://127.0.0.1:3000/app');

package/dist/services/__tests__/preview-runtime-manager.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview-runtime-manager.test.js","sourceRoot":"","sources":["../../../src/services/__tests__/preview-runtime-manager.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preview-runtime-manager.test.js","sourceRoot":"","sources":["../../../src/services/__tests__/preview-runtime-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/services/__tests__/preview.service.test.js

@@ -1,29 +1,28 @@
 import { describe, expect, it } from 'vitest';
-import { ServiceError } from '../../errors.js';
 import { normalizePreviewTarget } from '../preview.service.js';
 describe('normalizePreviewTarget', () => {
     it('accepts shorthand ports and loopback URLs', () => {
         expect(normalizePreviewTarget('3000').target).toBe('http://127.0.0.1:3000');
         expect(normalizePreviewTarget('localhost:5173').target).toBe('http://127.0.0.1:5173');
-        expect(normalizePreviewTarget('http://127.0.0.1:5173/app').target).toBe('http://127.0.0.1:5173/app');
-        expect(normalizePreviewTarget('https://[::1]:8443').target).toBe('https://[::1]:8443');
+        expect(normalizePreviewTarget('http://[::1]:8080/app/').target).toBe('http://[::1]:8080/app');
+        expect(normalizePreviewTarget('https://127.0.0.1:8443/dash').basePath).toBe('/dash');
     });
-    it('normalizes 0.0.0.0 to 127.0.0.1', () => {
-        expect(normalizePreviewTarget('0.0.0.0:3000').target).toBe('http://127.0.0.1:3000');
+    it('normalizes wildcard listen addresses to loopback', () => {
+        expect(normalizePreviewTarget('http://0.0.0.0:3000').target).toBe('http://127.0.0.1:3000');
     });
-    it('rejects non-loopback hosts', () => {
-        expect(() => normalizePreviewTarget('http://example.com:3000')).toThrow(ServiceError);
-        expect(() => normalizePreviewTarget('http://192.168.1.10:3000')).toThrow(ServiceError);
-        expect(() => normalizePreviewTarget('http://169.254.169.254/latest/meta-data')).toThrow(ServiceError);
+    it('accepts any host the Agent Tower server can reach', () => {
+        expect(normalizePreviewTarget('192.168.1.20:8080').target).toBe('http://192.168.1.20:8080');
+        expect(normalizePreviewTarget('http://api:4000/health').target).toBe('http://api:4000/health');
+        expect(normalizePreviewTarget('https://Staging.Example.com').origin).toBe('https://staging.example.com');
     });
     it('rejects unsupported schemes and credentials', () => {
-        expect(() => normalizePreviewTarget('file:///tmp/index.html')).toThrow(ServiceError);
-        expect(() => normalizePreviewTarget('ftp://localhost:2121')).toThrow(ServiceError);
-        expect(() => normalizePreviewTarget('http://user:pass@localhost:3000')).toThrow(ServiceError);
+        expect(() => normalizePreviewTarget('ftp://127.0.0.1:21')).toThrow('must use http or https');
+        expect(() => normalizePreviewTarget('http://user:pass@127.0.0.1:3000')).toThrow('credentials');
+        expect(() => normalizePreviewTarget('   ')).toThrow('required');
     });
     it('rejects invalid ports', () => {
-        expect(() => normalizePreviewTarget('localhost:0')).toThrow(ServiceError);
-        expect(() => normalizePreviewTarget('localhost:70000')).toThrow(ServiceError);
+        expect(() => normalizePreviewTarget('http://127.0.0.1:70000')).toThrow();
+        expect(() => normalizePreviewTarget('http://127.0.0.1:0')).toThrow();
     });
 });
 //# sourceMappingURL=preview.service.test.js.map

package/dist/services/__tests__/preview.service.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview.service.test.js","sourceRoot":"","sources":["../../../src/services/__tests__/preview.service.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC5E,MAAM,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtF,MAAM,CAAC,sBAAsB,CAAC,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACrG,MAAM,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtF,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvF,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,yCAAyC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACrF,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACnF,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1E,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"preview.service.test.js","sourceRoot":"","sources":["../../../src/services/__tests__/preview.service.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC5E,MAAM,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtF,MAAM,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC9F,MAAM,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC5F,MAAM,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC/F,MAAM,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAC7F,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/F,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACzE,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/services/__tests__/session-manager.lifecycle.test.js

@@ -1209,6 +1209,70 @@ describe('SessionManager session status vs real process state', () => {
         })).toBe(0);
         await manager.destroyAll();
     });
+    it.each([
+        ['start', 'entry'], ['startFollowUp', 'entry'],
+        ['start', 'backend'], ['startFollowUp', 'backend'],
+    ])('resolves a Claude MCP %s failure with missing %s and permits cleanup and retry', async (method, missing) => {
+        const { ClaudeCodeExecutor } = await import('../../executors/claude-code.executor.js');
+        // Exercise the real configuration builder and CLI Driver; only substitute
+        // the PTY transport after configuration succeeds.
+        class TestClaudeExecutor extends ClaudeCodeExecutor {
+            async spawnWithStdin() { return spawnMock(); }
+        }
+        const executor = new TestClaudeExecutor({ executionPermission: 'FULL_ACCESS' });
+        const provider = {
+            id: 'claude-mcp-recovery', name: 'Claude MCP recovery', agentType: AgentType.CLAUDE_CODE,
+            runtimeType: RuntimeType.CLI, executionPermission: 'FULL_ACCESS',
+            config: {}, env: {}, isDefault: false,
+        };
+        getProviderByIdMock.mockReturnValue(provider);
+        getExecutorByProviderMock.mockReturnValue(executor);
+        const { workspace, session } = await createSessionFixture({ providerId: provider.id, agentType: AgentType.CLAUDE_CODE });
+        const resumeSource = await prisma.session.create({ data: {
+                workspaceId: workspace.id, agentType: AgentType.CLAUDE_CODE, prompt: 'previous turn',
+                status: SessionStatus.COMPLETED, externalSessionId: 'previous-claude-session',
+            } });
+        const entry = path.join(serverRoot, 'src', 'mcp', 'index.ts');
+        const manager = new SessionManager(new EventBus());
+        const pty = new ControlledPty();
+        spawnMock.mockReset();
+        spawnMock.mockResolvedValueOnce(spawnResultFor(pty));
+        vi.stubEnv('AGENT_TOWER_DESKTOP_RUNTIME_MODE', undefined);
+        vi.stubEnv('AGENT_TOWER_MCP_ENTRY', missing === 'entry' ? path.join(testDir, 'missing-mcp.js') : entry);
+        vi.stubEnv('AGENT_TOWER_URL', missing === 'backend' ? undefined : 'http://127.0.0.1:12580');
+        vi.stubEnv('AGENT_TOWER_PORT', undefined);
+        try {
+            const starting = method === 'start' ? manager.start(session.id) : manager.startFollowUp(session.id, resumeSource.id);
+            await expect(starting).rejects.toThrow(missing === 'entry'
+                ? 'Agent Tower MCP entry not found'
+                : 'AGENT_TOWER_URL or AGENT_TOWER_PORT is required');
+            expect(spawnMock).not.toHaveBeenCalled();
+            expect(await prisma.executionProcess.count({ where: { sessionId: session.id } })).toBe(0);
+            await expect(prisma.session.findUniqueOrThrow({ where: { id: session.id } })).resolves.toMatchObject({
+                status: SessionStatus.CANCELLED, runtimeLaunchState: 'SAFE_PRE_CHILD_FAILURE',
+                runtimeLaunchClaimCount: 1, runtimeLaunchResolvedCount: 1, runtimeLaunchProcessCount: 0,
+            });
+            expect(await manager.isRuntimeCleanupConfirmed(session.id)).toBe(true);
+            await expect(manager.stop(session.id)).resolves.toMatchObject({ id: session.id });
+            vi.stubEnv('AGENT_TOWER_MCP_ENTRY', entry);
+            vi.stubEnv('AGENT_TOWER_URL', 'http://127.0.0.1:12580');
+            await expect(manager.sendMessage(session.id, 'retry after correcting MCP configuration')).resolves.toMatchObject({ id: session.id });
+            expect(spawnMock).toHaveBeenCalledOnce();
+            await expect(prisma.session.findUniqueOrThrow({ where: { id: session.id } })).resolves.toMatchObject({
+                status: SessionStatus.RUNNING, runtimeLaunchState: 'PROCESS_RECORDED',
+                runtimeLaunchClaimCount: 2, runtimeLaunchResolvedCount: 2, runtimeLaunchProcessCount: 1,
+            });
+            await manager.stop(session.id);
+            expect(pty.killed).toBe(true);
+            expect(await manager.isRuntimeCleanupConfirmed(session.id)).toBe(true);
+            expect(await prisma.executionProcess.findMany({ where: { sessionId: session.id } }))
+                .toMatchObject([{ launchClaimNumber: 2, cleanupState: 'CONFIRMED' }]);
+        }
+        finally {
+            vi.unstubAllEnvs();
+            await manager.destroyAll();
+        }
+    });
     it.each(['start', 'startFollowUp'])('revokes a public %s before runtime admission when stop wins during preparation', async (method) => {
         const { workspace, session } = await createSessionFixture();
         const resumeSource = await prisma.session.create({
@@ -1358,6 +1422,8 @@ describe('SessionManager session status vs real process state', () => {
             expect(checkpoint).toHaveBeenCalledWith(session.id);
             feed({ type: 'stream_event', event: { type: 'content_block_start', index: 2, content_block: { type: 'text', text: 'B after tool' } } });
             feed({ type: 'result', subtype: 'success', num_turns: 1 });
+            // A Claude run ends when its process exits, not at the result.
+            pty.emitExit(0);
             await completed;
             const row = await prisma.session.findUniqueOrThrow({ where: { id: session.id } });
             expect(JSON.parse(row.logSnapshot).entries.at(-1)).toMatchObject({ content: 'B after tool', metadata: { textBlock: { state: 'SEALED', sealedReason: 'TURN_END' } } });
@@ -1499,6 +1565,78 @@ describe('SessionManager session status vs real process state', () => {
         expect(snapshot.entries.map((entry) => entry.content))
             .toContain('fast logical completion');
     });
+    it('keeps a Claude Code session running after its result while background work is pending and completes on exit', async () => {
+        const { session } = await createSessionFixture({ agentType: AgentType.CLAUDE_CODE });
+        const pty = new ControlledPty();
+        spawnMock.mockResolvedValueOnce(spawnResultFor(pty));
+        const eventBus = new EventBus();
+        const manager = new SessionManager(eventBus);
+        const completed = waitForEvent(eventBus, 'session:completed');
+        const states = [];
+        eventBus.on('session:runtime_state_changed', ({ state }) => states.push(state));
+        try {
+            await manager.start(session.id);
+            const line = (message) => pty.emitData(JSON.stringify(message) + '\n');
+            line({ type: 'system', subtype: 'init', session_id: 'claude-native' });
+            line({ type: 'assistant', message: { id: 'm1', role: 'assistant', content: [{ type: 'text', text: 'WAITING for the router' }] } });
+            line({ type: 'system', subtype: 'background_tasks_changed', tasks: [{ task_id: 'bg-1', task_type: 'local_bash', description: 'router watch' }] });
+            line({ type: 'result', subtype: 'success', result: 'WAITING for the router', num_turns: 1, result_index: 0, uuid: 'r0', origin: null });
+            await vi.waitFor(() => {
+                expect(states.some((state) => state.backgroundTasks?.some((task) => task.taskId === 'bg-1'))).toBe(true);
+            }, { timeout: 2000 });
+            await new Promise((resolve) => setTimeout(resolve, 300));
+            expect(manager.hasActiveTurn(session.id)).toBe(true);
+            expect(pty.killed).toBe(false);
+            expect((await prisma.session.findUnique({ where: { id: session.id } }))?.status).toBe(SessionStatus.RUNNING);
+            line({ type: 'system', subtype: 'task_notification', task_id: 'bg-1', status: 'completed', summary: 'Background command "router watch" completed (exit code 0)' });
+            line({ type: 'system', subtype: 'background_tasks_changed', tasks: [] });
+            line({ type: 'system', subtype: 'init', session_id: 'claude-native' });
+            line({ type: 'assistant', message: { id: 'm2', role: 'assistant', content: [{ type: 'text', text: 'FINISHED routing' }] } });
+            line({ type: 'result', subtype: 'success', result: 'FINISHED routing', num_turns: 1, result_index: 1, uuid: 'r1', origin: { kind: 'task-notification' } });
+            pty.emitExit(0);
+            const payload = await completed;
+            expect(payload.status).toBe(SessionStatus.COMPLETED);
+            await vi.waitFor(() => expect(manager.hasActiveTurn(session.id)).toBe(false), { timeout: 2000 });
+            const persisted = await prisma.session.findUnique({ where: { id: session.id } });
+            expect(persisted?.status).toBe(SessionStatus.COMPLETED);
+            const contents = JSON.parse(persisted?.logSnapshot ?? '{}').entries.map((entry) => entry.content);
+            expect(contents).toContain('FINISHED routing');
+            expect(contents).toContain('Background command "router watch" completed (exit code 0)');
+        }
+        finally {
+            await manager.destroyAll();
+        }
+    });
+    it('stops a waiting Claude Code run when a follow-up arrives and tags wake-up messages as system events', async () => {
+        const { session } = await createSessionFixture({ agentType: AgentType.CLAUDE_CODE });
+        const first = new ControlledPty();
+        const second = new ControlledPty();
+        second.pid = 4343;
+        spawnMock.mockResolvedValueOnce(spawnResultFor(first)).mockResolvedValueOnce(spawnResultFor(second));
+        const eventBus = new EventBus();
+        const manager = new SessionManager(eventBus);
+        try {
+            await manager.start(session.id);
+            const line = (pty, message) => pty.emitData(JSON.stringify(message) + '\n');
+            line(first, { type: 'system', subtype: 'background_tasks_changed', tasks: [{ task_id: 'bg-1', description: 'watch' }] });
+            line(first, { type: 'result', subtype: 'success', result: 'WAITING', num_turns: 1, result_index: 0, uuid: 'r0', origin: null });
+            await new Promise((resolve) => setTimeout(resolve, 200));
+            expect(first.killed).toBe(false);
+            await manager.sendMessage(session.id, 'wake-up text', undefined, undefined, { origin: 'SYSTEM_EVENT' });
+            expect(first.killed).toBe(true);
+            const completed = waitForEvent(eventBus, 'session:completed');
+            line(second, { type: 'result', subtype: 'success', result: 'done', result_index: 0, uuid: 'r0', origin: null });
+            second.emitExit(0);
+            await completed;
+            const persisted = await prisma.session.findUnique({ where: { id: session.id } });
+            const entries = JSON.parse(persisted?.logSnapshot ?? '{}').entries;
+            const wakeup = entries.find((entry) => entry.content === 'wake-up text');
+            expect(wakeup).toMatchObject({ entryType: 'user_message', metadata: { origin: 'SYSTEM_EVENT' } });
+        }
+        finally {
+            await manager.destroyAll();
+        }
+    });
     it('waits for the completed generation auto-commit before starting an immediate follow-up', async () => {
         const { session } = await createSessionFixture();
         const firstPty = new ControlledPty();
@@ -1722,7 +1860,7 @@ describe('SessionManager session status vs real process state', () => {
         expect(spawnMock).toHaveBeenCalledTimes(2);
         await manager.destroyAll();
     });
-    it.each(['success', 'error_during_execution'])('persists Claude final %s and automatically reclaims the CLI process', async (subtype) => {
+    it.each(['success', 'error_during_execution'])('persists Claude final %s and reclaims a CLI process that lingers after its result', async (subtype) => {
         const { task, session } = await createSessionFixture({ agentType: AgentType.CLAUDE_CODE });
         const pty = new ControlledPty();
         spawnMock.mockResolvedValueOnce(spawnResultFor(pty));
@@ -1730,6 +1868,9 @@ describe('SessionManager session status vs real process state', () => {
         const manager = new SessionManager(eventBus);
         const completed = waitForEvent(eventBus, 'session:completed');
         const expectedStatus = subtype === 'success' ? SessionStatus.COMPLETED : SessionStatus.FAILED;
+        // The process reports no background work and never exits: Tower treats it as hung after the idle grace.
+        const previousGrace = process.env.AGENT_TOWER_CLAUDE_IDLE_EXIT_GRACE_MS;
+        process.env.AGENT_TOWER_CLAUDE_IDLE_EXIT_GRACE_MS = '200';
         try {
             await manager.start(session.id);
             pty.emitData(JSON.stringify({
@@ -1765,8 +1906,13 @@ describe('SessionManager session status vs real process state', () => {
                 }));
                 expect((await prisma.task.findUniqueOrThrow({ where: { id: task.id } })).status).not.toBe('IN_REVIEW');
             }
+            expect(snapshot.entries).toContainEqual(expect.objectContaining({ entryType: 'warning_message' }));
         }
         finally {
+            if (previousGrace === undefined)
+                delete process.env.AGENT_TOWER_CLAUDE_IDLE_EXIT_GRACE_MS;
+            else
+                process.env.AGENT_TOWER_CLAUDE_IDLE_EXIT_GRACE_MS = previousGrace;
             await manager.destroyAll();
         }
     });