@cloudcli-ai/cloudcli 1.37.2 → 1.37.4

package/dist-server/server/modules/providers/tests/session-history-cache.service.test.js

@@ -0,0 +1,139 @@
+import assert from 'node:assert/strict';
+import { appendFile, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { createSessionHistoryCache } from '../../../modules/providers/services/session-history-cache.service.js';
+function historyResult(marker) {
+    const message = {
+        id: marker,
+        sessionId: 'session',
+        timestamp: '2026-01-01T00:00:00.000Z',
+        provider: 'claude',
+        kind: 'text',
+        role: 'user',
+        content: marker,
+    };
+    return { messages: [message], total: 1, hasMore: false, offset: 0, limit: null };
+}
+async function withTranscriptFile(runTest) {
+    const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'session-history-cache-'));
+    const transcriptPath = path.join(tempDirectory, 'session.jsonl');
+    await writeFile(transcriptPath, '{"type":"user"}\n', 'utf8');
+    try {
+        await runTest(transcriptPath);
+    }
+    finally {
+        await rm(tempDirectory, { recursive: true, force: true });
+    }
+}
+test('an unchanged transcript file is loaded once and then served from cache', async () => {
+    await withTranscriptFile(async (transcriptPath) => {
+        const cache = createSessionHistoryCache();
+        let loads = 0;
+        const loadFull = async () => {
+            loads += 1;
+            return historyResult(`load-${loads}`);
+        };
+        const first = await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        const second = await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        assert.equal(loads, 1);
+        assert.equal(second, first);
+    });
+});
+test('growing the transcript file invalidates the cached load', async () => {
+    await withTranscriptFile(async (transcriptPath) => {
+        const cache = createSessionHistoryCache();
+        let loads = 0;
+        const loadFull = async () => {
+            loads += 1;
+            return historyResult(`load-${loads}`);
+        };
+        await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        await appendFile(transcriptPath, '{"type":"assistant"}\n', 'utf8');
+        const afterAppend = await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        assert.equal(loads, 2);
+        assert.equal(afterAppend?.messages[0]?.id, 'load-2');
+    });
+});
+test('a missing transcript path or file bypasses the cache', async () => {
+    const cache = createSessionHistoryCache();
+    let loads = 0;
+    const loadFull = async () => {
+        loads += 1;
+        return historyResult('unused');
+    };
+    assert.equal(await cache.getFullHistory({ sessionId: 's1', transcriptPath: null, loadFull }), null);
+    assert.equal(await cache.getFullHistory({
+        sessionId: 's1',
+        transcriptPath: path.join(os.tmpdir(), 'session-history-cache-does-not-exist.jsonl'),
+        loadFull,
+    }), null);
+    assert.equal(loads, 0);
+});
+test('concurrent misses share a single load', async () => {
+    await withTranscriptFile(async (transcriptPath) => {
+        const cache = createSessionHistoryCache();
+        let loads = 0;
+        let release;
+        const gate = new Promise((resolve) => { release = resolve; });
+        const loadFull = async () => {
+            loads += 1;
+            await gate;
+            return historyResult(`load-${loads}`);
+        };
+        const firstRequest = cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        const secondRequest = cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        release();
+        const [first, second] = await Promise.all([firstRequest, secondRequest]);
+        assert.equal(loads, 1);
+        assert.equal(second, first);
+    });
+});
+test('the oldest entries are evicted over budget, but the newest survives alone', async () => {
+    const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'session-history-cache-evict-'));
+    try {
+        const firstPath = path.join(tempDirectory, 'first.jsonl');
+        const secondPath = path.join(tempDirectory, 'second.jsonl');
+        // Each file is 100 bytes, so a 150-byte budget holds exactly one entry —
+        // and the newest entry stays cached even though it exceeds nothing alone.
+        await writeFile(firstPath, 'x'.repeat(100), 'utf8');
+        await writeFile(secondPath, 'y'.repeat(100), 'utf8');
+        const cache = createSessionHistoryCache(150);
+        const loadsBySession = new Map();
+        const loaderFor = (sessionId) => async () => {
+            loadsBySession.set(sessionId, (loadsBySession.get(sessionId) ?? 0) + 1);
+            return historyResult(sessionId);
+        };
+        await cache.getFullHistory({ sessionId: 's1', transcriptPath: firstPath, loadFull: loaderFor('s1') });
+        await cache.getFullHistory({ sessionId: 's2', transcriptPath: secondPath, loadFull: loaderFor('s2') });
+        // s2 is still cached; s1 was evicted to fit the budget.
+        await cache.getFullHistory({ sessionId: 's2', transcriptPath: secondPath, loadFull: loaderFor('s2') });
+        await cache.getFullHistory({ sessionId: 's1', transcriptPath: firstPath, loadFull: loaderFor('s1') });
+        assert.equal(loadsBySession.get('s2'), 1);
+        assert.equal(loadsBySession.get('s1'), 2);
+    }
+    finally {
+        await rm(tempDirectory, { recursive: true, force: true });
+    }
+});
+test('invalidating a session re-parses its unchanged transcript on the next read', async () => {
+    await withTranscriptFile(async (transcriptPath) => {
+        const cache = createSessionHistoryCache();
+        let loads = 0;
+        const loadFull = async () => {
+            loads += 1;
+            return historyResult(`load-${loads}`);
+        };
+        // Claude's history reader decides a background agent's status from whether
+        // the session's CLI process is up — nothing the file's stat can reflect —
+        // so the runtime drops the entry when that process starts or ends.
+        const first = await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        cache.invalidate('s1');
+        const second = await cache.getFullHistory({ sessionId: 's1', transcriptPath, loadFull });
+        assert.equal(loads, 2);
+        assert.notEqual(second, first);
+        assert.equal(second?.messages[0]?.content, 'load-2');
+    });
+});
+//# sourceMappingURL=session-history-cache.service.test.js.map

package/dist-server/server/modules/providers/tests/session-history-cache.service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history-cache.service.test.js","sourceRoot":"","sources":["../../../../../server/modules/providers/tests/session-history-cache.service.test.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/providers/tests/session-orphan-prune.test.js

@@ -0,0 +1,90 @@
+import assert from 'node:assert/strict';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { closeConnection, initializeDatabase, sessionsDb } from '../../../modules/database/index.js';
+// Each provider synchronizer resolves `os.homedir()` when the registry module is
+// first imported, so HOME has to point at an empty fixture home *before* that
+// import runs. Otherwise the sync pass walks the developer's real ~/.claude.
+const fixtureHome = await mkdtemp(path.join(os.tmpdir(), 'session-prune-home-'));
+const previousHome = process.env.HOME;
+const previousUserProfile = process.env.USERPROFILE;
+process.env.HOME = fixtureHome;
+process.env.USERPROFILE = fixtureHome;
+const { sessionSynchronizerService } = await import('../../../modules/providers/services/session-synchronizer.service.js');
+process.on('exit', () => {
+    if (previousHome === undefined) {
+        delete process.env.HOME;
+    }
+    else {
+        process.env.HOME = previousHome;
+    }
+    if (previousUserProfile === undefined) {
+        delete process.env.USERPROFILE;
+    }
+    else {
+        process.env.USERPROFILE = previousUserProfile;
+    }
+});
+async function withIsolatedDatabase(runTest) {
+    const previousDatabasePath = process.env.DATABASE_PATH;
+    const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'session-prune-db-'));
+    closeConnection();
+    process.env.DATABASE_PATH = path.join(tempDirectory, 'auth.db');
+    await initializeDatabase();
+    try {
+        await runTest(tempDirectory);
+    }
+    finally {
+        closeConnection();
+        if (previousDatabasePath === undefined) {
+            delete process.env.DATABASE_PATH;
+        }
+        else {
+            process.env.DATABASE_PATH = previousDatabasePath;
+        }
+        await rm(tempDirectory, { recursive: true, force: true });
+    }
+}
+const PROJECT_PATH = '/tmp/session-prune-project';
+test('synchronizeSessions drops indexed sessions whose transcript file was deleted', async () => {
+    await withIsolatedDatabase(async (workspace) => {
+        const transcriptDirectory = path.join(workspace, 'transcripts');
+        await mkdir(transcriptDirectory, { recursive: true });
+        const livePath = path.join(transcriptDirectory, 'live.jsonl');
+        await writeFile(livePath, '{}\n');
+        const deletedPath = path.join(transcriptDirectory, 'deleted.jsonl');
+        sessionsDb.createSession('live-session', 'claude', PROJECT_PATH, 'Live', undefined, undefined, livePath);
+        sessionsDb.createSession('orphan-session', 'claude', PROJECT_PATH, 'Untitled Claude Session', undefined, undefined, deletedPath);
+        const result = await sessionSynchronizerService.synchronizeSessions();
+        assert.deepEqual(result.failures, []);
+        assert.equal(result.prunedOrphans, 1);
+        assert.equal(sessionsDb.getSessionById('orphan-session'), null);
+        assert.ok(sessionsDb.getSessionById('live-session'), 'a session whose transcript still exists must survive');
+    });
+});
+test('synchronizeSessions keeps sessions whose whole transcript directory is missing', async () => {
+    await withIsolatedDatabase(async (workspace) => {
+        // Stands in for an unmounted or not-yet-created home: every transcript
+        // "looks" deleted, so pruning here would wipe the entire index.
+        const unmountedPath = path.join(workspace, 'not-mounted', 'session.jsonl');
+        sessionsDb.createSession('unmounted-session', 'claude', PROJECT_PATH, 'Unmounted', undefined, undefined, unmountedPath);
+        const result = await sessionSynchronizerService.synchronizeSessions();
+        assert.equal(result.prunedOrphans, 0);
+        assert.ok(sessionsDb.getSessionById('unmounted-session'));
+    });
+});
+test('synchronizeSessions keeps sessions that have no transcript path yet', async () => {
+    await withIsolatedDatabase(async () => {
+        // App-created rows (jsonl_path NULL until the first provider write) and
+        // OpenCode rows (one shared sqlite file, so jsonl_path stays NULL).
+        sessionsDb.createAppSession('pending-app-session', 'claude', PROJECT_PATH, 'Pending');
+        sessionsDb.createSession('opencode-session', 'opencode', PROJECT_PATH, 'OpenCode', undefined, undefined, null);
+        const result = await sessionSynchronizerService.synchronizeSessions();
+        assert.equal(result.prunedOrphans, 0);
+        assert.ok(sessionsDb.getSessionById('pending-app-session'));
+        assert.ok(sessionsDb.getSessionById('opencode-session'));
+    });
+});
+//# sourceMappingURL=session-orphan-prune.test.js.map

package/dist-server/server/modules/providers/tests/session-orphan-prune.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-orphan-prune.test.js","sourceRoot":"","sources":["../../../../../server/modules/providers/tests/session-orphan-prune.test.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/providers/tests/session-synchronizer-coalescing.test.js

@@ -0,0 +1,122 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { closeConnection, initializeDatabase } from '../../../modules/database/index.js';
+// Each provider synchronizer resolves `os.homedir()` when the registry module is
+// first imported, so HOME has to point at an empty fixture home *before* that
+// import runs. The registry is stubbed per test, but the import still happens.
+const fixtureHome = await mkdtemp(path.join(os.tmpdir(), 'session-sync-home-'));
+const previousHome = process.env.HOME;
+const previousUserProfile = process.env.USERPROFILE;
+process.env.HOME = fixtureHome;
+process.env.USERPROFILE = fixtureHome;
+const { providerRegistry } = await import('../../../modules/providers/provider.registry.js');
+const { sessionSynchronizerService } = await import('../../../modules/providers/services/session-synchronizer.service.js');
+process.on('exit', () => {
+    if (previousHome === undefined) {
+        delete process.env.HOME;
+    }
+    else {
+        process.env.HOME = previousHome;
+    }
+    if (previousUserProfile === undefined) {
+        delete process.env.USERPROFILE;
+    }
+    else {
+        process.env.USERPROFILE = previousUserProfile;
+    }
+});
+async function withIsolatedDatabase(runTest) {
+    const previousDatabasePath = process.env.DATABASE_PATH;
+    const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'session-sync-db-'));
+    closeConnection();
+    process.env.DATABASE_PATH = path.join(tempDirectory, 'auth.db');
+    await initializeDatabase();
+    try {
+        await runTest();
+    }
+    finally {
+        closeConnection();
+        if (previousDatabasePath === undefined) {
+            delete process.env.DATABASE_PATH;
+        }
+        else {
+            process.env.DATABASE_PATH = previousDatabasePath;
+        }
+        await rm(tempDirectory, { recursive: true, force: true });
+    }
+}
+/**
+ * Installs a single fake provider whose scan only settles when the returned
+ * `release` is called, so a second caller can be observed arriving mid-scan.
+ */
+function stubSlowProvider() {
+    const originalListProviders = providerRegistry.listProviders;
+    let synchronizeCalls = 0;
+    let releaseScan = () => { };
+    const scanStarted = new Promise((resolveStarted) => {
+        const fakeProvider = {
+            id: 'claude',
+            sessionSynchronizer: {
+                async synchronize() {
+                    synchronizeCalls += 1;
+                    resolveStarted();
+                    await new Promise((resolveScan) => {
+                        releaseScan = resolveScan;
+                    });
+                    return 7;
+                },
+            },
+        };
+        providerRegistry.listProviders = () => [fakeProvider];
+    });
+    return {
+        scanStarted,
+        release: () => releaseScan(),
+        getSynchronizeCalls: () => synchronizeCalls,
+        restore: () => {
+            providerRegistry.listProviders = originalListProviders;
+        },
+    };
+}
+test('concurrent synchronizeSessions callers share one provider scan', async () => {
+    await withIsolatedDatabase(async () => {
+        const providerStub = stubSlowProvider();
+        try {
+            const first = sessionSynchronizerService.synchronizeSessions();
+            await providerStub.scanStarted;
+            // Opening the UI fires /api/projects and /api/projects/archived at once;
+            // the second must join the running scan instead of starting its own.
+            const second = sessionSynchronizerService.synchronizeSessions();
+            providerStub.release();
+            const [firstResult, secondResult] = await Promise.all([first, second]);
+            assert.equal(providerStub.getSynchronizeCalls(), 1);
+            assert.equal(firstResult.processedByProvider.claude, 7);
+            assert.deepEqual(secondResult, firstResult);
+        }
+        finally {
+            providerStub.restore();
+        }
+    });
+});
+test('a synchronizeSessions call after the shared scan settles starts a new scan', async () => {
+    await withIsolatedDatabase(async () => {
+        const providerStub = stubSlowProvider();
+        try {
+            const first = sessionSynchronizerService.synchronizeSessions();
+            await providerStub.scanStarted;
+            providerStub.release();
+            await first;
+            const second = sessionSynchronizerService.synchronizeSessions();
+            providerStub.release();
+            await second;
+            assert.equal(providerStub.getSynchronizeCalls(), 2);
+        }
+        finally {
+            providerStub.restore();
+        }
+    });
+});
+//# sourceMappingURL=session-synchronizer-coalescing.test.js.map

package/dist-server/server/modules/providers/tests/session-synchronizer-coalescing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-synchronizer-coalescing.test.js","sourceRoot":"","sources":["../../../../../server/modules/providers/tests/session-synchronizer-coalescing.test.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/providers/tests/sessions.service.test.js

@@ -1,10 +1,12 @@
 import assert from 'node:assert/strict';
-import { mkdtemp, rm } from 'node:fs/promises';
+import { appendFile, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import test from 'node:test';
 import { closeConnection, initializeDatabase, projectsDb, sessionsDb } from '../../../modules/database/index.js';
+import { providerRegistry } from '../../../modules/providers/provider.registry.js';
 import { sessionsService } from '../../../modules/providers/services/sessions.service.js';
+import { chatRunRegistry } from '../../../modules/websocket/index.js';
 async function withIsolatedDatabase(runTest) {
     const previousDatabasePath = process.env.DATABASE_PATH;
     const tempDirectory = await mkdtemp(path.join(os.tmpdir(), 'sessions-service-db-'));
@@ -84,4 +86,220 @@ test('recent sessions map project metadata and preserve database pagination', {
         });
     });
 });
+/** One Claude transcript row of user or assistant text, linked by uuid chain. */
+function claudeTextRow(sessionId, role, text, ordinal) {
+    return {
+        type: role,
+        uuid: `row-${ordinal}`,
+        parentUuid: ordinal === 0 ? null : `row-${ordinal - 1}`,
+        timestamp: new Date(Date.UTC(2026, 0, 1, 0, 0, ordinal)).toISOString(),
+        sessionId,
+        message: { role, content: [{ type: 'text', text }] },
+    };
+}
+test('history pages are sliced from the cached full transcript and see appended rows', { concurrency: false }, async () => {
+    const transcriptDirectory = await mkdtemp(path.join(os.tmpdir(), 'sessions-service-history-'));
+    const sessionId = 'claude-history-cache-session';
+    const transcriptPath = path.join(transcriptDirectory, `${sessionId}.jsonl`);
+    try {
+        await withIsolatedDatabase(async () => {
+            const rows = [
+                claudeTextRow(sessionId, 'user', 'one', 0),
+                claudeTextRow(sessionId, 'assistant', 'reply one', 1),
+                claudeTextRow(sessionId, 'user', 'two', 2),
+                claudeTextRow(sessionId, 'assistant', 'reply two', 3),
+            ];
+            await writeFile(transcriptPath, `${rows.map((row) => JSON.stringify(row)).join('\n')}\n`, 'utf8');
+            sessionsDb.createSession(sessionId, 'claude', '/tmp/history-cache-project', 'History cache conversation', '2026-01-01T00:00:00.000Z', '2026-01-01T00:00:10.000Z', transcriptPath);
+            const page = await sessionsService.fetchHistory(sessionId, { limit: 2, offset: 0 });
+            assert.equal(page.total, 4);
+            assert.equal(page.hasMore, true);
+            assert.deepEqual(page.messages.map((message) => message.content), ['two', 'reply two']);
+            // A row appended after the page was cached must appear on the next read.
+            await appendFile(transcriptPath, `${JSON.stringify(claudeTextRow(sessionId, 'user', 'three', 4))}\n`, 'utf8');
+            const refreshed = await sessionsService.fetchHistory(sessionId, { limit: 2, offset: 0 });
+            assert.equal(refreshed.total, 5);
+            assert.deepEqual(refreshed.messages.map((message) => message.content), ['reply two', 'three']);
+            // An older page keeps the tail-offset contract while served from cache.
+            const older = await sessionsService.fetchHistory(sessionId, { limit: 2, offset: 2 });
+            assert.deepEqual(older.messages.map((message) => message.content), ['reply one', 'two']);
+            assert.equal(older.hasMore, true);
+        });
+    }
+    finally {
+        await rm(transcriptDirectory, { recursive: true, force: true });
+    }
+});
+/**
+ * Stands in for the provider registry with one provider per id, each with the
+ * runtime given — the seam through which a runtime's background work reaches
+ * the running-sessions list without an SDK run behind it.
+ */
+async function withProviders(runtimes, runTest) {
+    const realListProviders = providerRegistry.listProviders;
+    providerRegistry.listProviders = () => Object.entries(runtimes).map(([id, runtime]) => ({ id, runtime }));
+    try {
+        await runTest();
+    }
+    finally {
+        providerRegistry.listProviders = realListProviders;
+        chatRunRegistry.clearAll();
+    }
+}
+/**
+ * Runs `runTest` against a Claude CLI process registry containing exactly
+ * `records`, so the running-sessions tests never read the developer's real
+ * `~/.claude/sessions`.
+ */
+async function withClaudeCliRegistry(records, runTest) {
+    const homeDirectory = await mkdtemp(path.join(os.tmpdir(), 'claude-cli-registry-'));
+    await mkdir(path.join(homeDirectory, '.claude', 'sessions'), { recursive: true });
+    for (const record of records) {
+        await writeFile(path.join(homeDirectory, '.claude', 'sessions', `${record.pid}.json`), JSON.stringify(record), 'utf8');
+    }
+    const realHomedir = os.homedir;
+    os.homedir = () => homeDirectory;
+    try {
+        await runTest();
+    }
+    finally {
+        os.homedir = realHomedir;
+        await rm(homeDirectory, { recursive: true, force: true });
+    }
+}
+const task = (taskId, startedAt) => ({
+    taskId,
+    toolUseId: `toolu_${taskId}`,
+    taskType: 'local_agent',
+    description: `Task ${taskId}`,
+    startedAt,
+});
+test('running sessions list a session whose background work outlived its turn', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('held-session', 'claude', '/tmp/running-project');
+        // The turn ran and completed: the registry still holds the finished run.
+        const run = chatRunRegistry.startRun({
+            appSessionId: 'held-session', provider: 'claude', providerSessionId: null, connection: null, userId: null,
+        });
+        assert.ok(run);
+        run.writer.send({ kind: 'text', content: 'launched', sessionId: 'held-session', provider: 'claude' });
+        run.writer.sendComplete({ exitCode: 0 });
+        assert.equal(run.status, 'completed');
+        const tasks = [task('late', 2_000), task('early', 1_000)];
+        await withClaudeCliRegistry([], async () => await withProviders({ claude: { run: async () => undefined, abort: () => false, listBackgroundWork: () => [{ sessionId: 'held-session', tasks }] } }, async () => {
+            assert.deepEqual(await sessionsService.listRunningSessions(), [{
+                    sessionId: 'held-session',
+                    provider: 'claude',
+                    startedAt: 1_000,
+                    lastSeq: run.lastSeq,
+                    background: true,
+                    canInterrupt: false,
+                    tasks,
+                }]);
+            assert.ok(run.lastSeq > 0, 'the finished run still reports its sequence for replay');
+        }));
+    });
+});
+test('running sessions carry their tasks on a chat run that is still going', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('busy-session', 'claude', '/tmp/running-project');
+        sessionsDb.createAppSession('idle-session', 'codex', '/tmp/running-project');
+        const run = chatRunRegistry.startRun({
+            appSessionId: 'busy-session', provider: 'claude', providerSessionId: null, connection: null, userId: null,
+        });
+        assert.ok(run);
+        const tasks = [task('agent', 5_000)];
+        await withClaudeCliRegistry([], async () => await withProviders({
+            claude: { run: async () => undefined, abort: () => false, listBackgroundWork: () => [{ sessionId: 'busy-session', tasks }] },
+            // A runtime without background work contributes chat runs alone.
+            codex: { run: async () => undefined, abort: () => false },
+        }, async () => {
+            const sessions = await sessionsService.listRunningSessions();
+            assert.equal(sessions.length, 1, 'a session with a running chat run is listed once');
+            assert.deepEqual(sessions[0], {
+                sessionId: 'busy-session',
+                provider: 'claude',
+                startedAt: run.startedAt,
+                lastSeq: 0,
+                tasks,
+            });
+        }));
+    });
+});
+test('running sessions with no background work are the chat runs alone', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('plain-session', 'codex', '/tmp/running-project');
+        const run = chatRunRegistry.startRun({
+            appSessionId: 'plain-session', provider: 'codex', providerSessionId: null, connection: null, userId: null,
+        });
+        assert.ok(run);
+        await withClaudeCliRegistry([], async () => await withProviders({ codex: { run: async () => undefined, abort: () => false } }, async () => {
+            assert.deepEqual(await sessionsService.listRunningSessions(), [{
+                    sessionId: 'plain-session', provider: 'codex', startedAt: run.startedAt, lastSeq: 0,
+                }]);
+        }));
+    });
+});
+test('running sessions report a turn driven by the Claude CLI', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('cli-session', 'claude', '/tmp/running-project');
+        sessionsDb.assignProviderSessionId('cli-session', 'claude-native-1');
+        // `process.pid` is the one pid guaranteed to be alive; omitting procStart
+        // keeps the fixture portable, since the start-time cross-check is Linux-only.
+        await withClaudeCliRegistry([{ pid: process.pid, sessionId: 'claude-native-1', status: 'busy', entrypoint: 'cli', startedAt: 4_000 }], async () => await withProviders({ claude: { run: async () => undefined, abort: () => false } }, async () => {
+            assert.deepEqual(await sessionsService.listRunningSessions(), [{
+                    sessionId: 'cli-session',
+                    provider: 'claude',
+                    startedAt: 4_000,
+                    lastSeq: 0,
+                    canInterrupt: false,
+                    statusText: 'Running in the Claude CLI',
+                }]);
+        }));
+    });
+});
+test('running sessions ignore registry files a crash left behind', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('stale-session', 'claude', '/tmp/running-project');
+        sessionsDb.assignProviderSessionId('stale-session', 'claude-native-stale');
+        await withClaudeCliRegistry([
+            // The process is gone: signal 0 cannot find this pid.
+            { pid: 4_194_302, sessionId: 'claude-native-stale', status: 'busy', startedAt: 1_000 },
+            // Alive, but waiting for input rather than producing a response.
+            { pid: process.pid, sessionId: 'claude-native-idle', status: 'idle', startedAt: 2_000 },
+        ], async () => await withProviders({ claude: { run: async () => undefined, abort: () => false } }, async () => {
+            assert.deepEqual(await sessionsService.listRunningSessions(), []);
+        }));
+    });
+});
+test('a CLI turn does not duplicate a session already running a chat run', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('both-session', 'claude', '/tmp/running-project');
+        sessionsDb.assignProviderSessionId('both-session', 'claude-native-both');
+        const run = chatRunRegistry.startRun({
+            appSessionId: 'both-session', provider: 'claude', providerSessionId: 'claude-native-both', connection: null, userId: null,
+        });
+        assert.ok(run);
+        await withClaudeCliRegistry([{ pid: process.pid, sessionId: 'claude-native-both', status: 'busy', startedAt: 3_000 }], async () => await withProviders({ claude: { run: async () => undefined, abort: () => false } }, async () => {
+            const sessions = await sessionsService.listRunningSessions();
+            assert.equal(sessions.length, 1, 'the chat run already covers this session');
+            assert.equal(sessions[0].canInterrupt, undefined, 'the interruptible chat run entry wins');
+        }));
+    });
+});
+test('an unreadable registry never fails the running-sessions poll', { concurrency: false }, async () => {
+    await withIsolatedDatabase(async () => {
+        sessionsDb.createAppSession('safe-session', 'claude', '/tmp/running-project');
+        sessionsDb.assignProviderSessionId('safe-session', 'claude-native-safe');
+        await withClaudeCliRegistry([{ pid: process.pid, sessionId: 'claude-native-safe', status: 'busy', startedAt: 5_000 }], async () => {
+            // A half-written file sits alongside the good one; it must be skipped
+            // rather than abort the whole poll.
+            await writeFile(path.join(os.homedir(), '.claude', 'sessions', 'broken.json'), '{"pid":', 'utf8');
+            await withProviders({ claude: { run: async () => undefined, abort: () => false } }, async () => {
+                const sessions = await sessionsService.listRunningSessions();
+                assert.deepEqual(sessions.map((session) => session.sessionId), ['safe-session']);
+            });
+        });
+    });
+});
 //# sourceMappingURL=sessions.service.test.js.map