@ai-devkit/agent-manager 0.26.1 → 0.26.3

package/dist/__tests__/utils/AgentRegistry.test.js

@@ -31,36 +31,37 @@ describe('AgentRegistry', ()=>{
         });
     });
     describe('register', ()=>{
-        it('creates the file and parent directory if missing', ()=>{
+        it('creates the SQLite database and parent directory if missing', ()=>{
             registry.register(makeEntry());
-            expect(fs.existsSync(regPath)).toBe(true);
-            const parsed = JSON.parse(fs.readFileSync(regPath, 'utf8'));
-            expect(parsed.entries).toHaveLength(1);
-            expect(parsed.entries[0].name).toBe('agent1');
+            expect(fs.existsSync(regPath.replace(/\.json$/, '.db'))).toBe(true);
+            expect(registry.list()[0].name).toBe('agent1');
         });
         it('appends a new entry when name is unique', ()=>{
             registry.register(makeEntry({
                 name: 'a'
             }));
             registry.register(makeEntry({
-                name: 'b'
+                name: 'b',
+                pid: process.ppid
             }));
             expect(registry.list()).toHaveLength(2);
         });
-        it('upserts in place when name already exists', ()=>{
+        it('upserts in place when type and pid already exist', ()=>{
             registry.register(makeEntry({
                 name: 'a',
-                pid: 100
+                pid: process.pid
             }));
             registry.register(makeEntry({
-                name: 'a',
-                pid: 200
+                name: 'fallback',
+                pid: process.pid,
+                tmuxSession: ''
             }));
             const all = registry.list();
             expect(all).toHaveLength(1);
-            expect(all[0].pid).toBe(200);
+            expect(all[0].pid).toBe(process.pid);
+            expect(all[0].name).toBe('a');
         });
-        it('writes atomically (no leftover .tmp on success)', ()=>{
+        it('does not write through the legacy fixed .tmp path', ()=>{
             registry.register(makeEntry());
             expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);
         });
@@ -79,24 +80,26 @@ describe('AgentRegistry', ()=>{
                 tmuxSession: 'pinned'
             }));
             registry.register(makeEntry({
-                name: 'a',
+                name: 'fallback',
                 tmuxSession: '',
-                pid: 999
+                pid: process.pid
             }));
             const saved = registry.lookup('a');
             expect(saved?.tmuxSession).toBe('pinned');
-            expect(saved?.pid).toBe(999);
+            expect(saved?.pid).toBe(process.pid);
         });
-        it('replaces tmuxSession when incoming is non-empty', ()=>{
+        it('lets a managed start entry replace a generated fallback for the same pid', ()=>{
             registry.register(makeEntry({
-                name: 'a',
-                tmuxSession: 'old'
+                name: `ai-devkit-${process.pid}`,
+                tmuxSession: ''
             }));
             registry.register(makeEntry({
-                name: 'a',
-                tmuxSession: 'new'
+                name: 'custom-name',
+                tmuxSession: 'custom-name'
             }));
-            expect(registry.lookup('a')?.tmuxSession).toBe('new');
+            expect(registry.lookup('custom-name')?.tmuxSession).toBe('custom-name');
+            expect(registry.lookup(`ai-devkit-${process.pid}`)).toBeNull();
+            expect(registry.list()).toHaveLength(1);
         });
     });
     describe('registerBatch', ()=>{
@@ -104,21 +107,20 @@ describe('AgentRegistry', ()=>{
             registry.registerBatch([]);
             expect(fs.existsSync(regPath)).toBe(false);
         });
-        it('upserts multiple entries with a single write', ()=>{
-            const writeSpy = vi.spyOn(fs, 'writeFileSync');
+        it('upserts multiple entries in a single batch', ()=>{
             registry.registerBatch([
                 makeEntry({
                     name: 'a'
                 }),
                 makeEntry({
-                    name: 'b'
+                    name: 'b',
+                    pid: process.pid + 1
                 }),
                 makeEntry({
-                    name: 'c'
+                    name: 'c',
+                    pid: process.pid + 2
                 })
             ]);
-            expect(writeSpy).toHaveBeenCalledTimes(1);
-            writeSpy.mockRestore();
             expect(registry.list()).toHaveLength(3);
         });
         it('applies the tmuxSession merge per entry', ()=>{
@@ -128,19 +130,37 @@ describe('AgentRegistry', ()=>{
             }));
             registry.registerBatch([
                 makeEntry({
-                    name: 'a',
+                    name: 'fallback',
                     tmuxSession: '',
-                    pid: 7
+                    pid: process.pid
                 }),
                 makeEntry({
                     name: 'b',
-                    tmuxSession: ''
+                    tmuxSession: '',
+                    pid: process.pid + 1
                 })
             ]);
             expect(registry.lookup('a')?.tmuxSession).toBe('pinned');
-            expect(registry.lookup('a')?.pid).toBe(7);
+            expect(registry.lookup('a')?.pid).toBe(process.pid);
             expect(registry.lookup('b')?.tmuxSession).toBe('');
         });
+        it('handles concurrent registry instances without duplicate pid rows', ()=>{
+            const other = new AgentRegistry(regPath);
+            registry.register(makeEntry({
+                name: `ai-devkit-${process.pid}`,
+                tmuxSession: ''
+            }));
+            other.register(makeEntry({
+                name: 'custom-name',
+                tmuxSession: 'custom-name'
+            }));
+            registry.register(makeEntry({
+                name: `ai-devkit-${process.pid}`,
+                tmuxSession: ''
+            }));
+            expect(registry.list()).toHaveLength(1);
+            expect(registry.lookup('custom-name')?.pid).toBe(process.pid);
+        });
     });
     describe('lookup', ()=>{
         it('returns null when name not found', ()=>{
@@ -154,24 +174,26 @@ describe('AgentRegistry', ()=>{
         });
     });
     describe('list', ()=>{
-        it('returns empty array when file does not exist', ()=>{
+        it('returns empty array when database does not contain entries', ()=>{
             expect(registry.list()).toEqual([]);
         });
-        it('returns empty array when file is malformed', ()=>{
-            fs.mkdirSync(path.dirname(regPath), {
-                recursive: true
+        it('ignores existing legacy agents.json entries', ()=>{
+            const legacyEntry = makeEntry({
+                name: 'legacy',
+                tmuxSession: 'legacy'
             });
-            fs.writeFileSync(regPath, 'not json', 'utf8');
-            expect(registry.list()).toEqual([]);
-        });
-        it('coerces non-array entries to []', ()=>{
             fs.mkdirSync(path.dirname(regPath), {
                 recursive: true
             });
             fs.writeFileSync(regPath, JSON.stringify({
-                entries: 'oops'
+                entries: [
+                    legacyEntry
+                ]
             }), 'utf8');
-            expect(registry.list()).toEqual([]);
+            const legacyRegistry = new AgentRegistry(regPath);
+            expect(legacyRegistry.lookup('legacy')).toBeNull();
+            expect(legacyRegistry.list()).toEqual([]);
+            expect(fs.existsSync(regPath.replace(/\.json$/, '.db'))).toBe(true);
         });
     });
     describe('isAlive', ()=>{
@@ -205,10 +227,10 @@ describe('AgentRegistry', ()=>{
             registry.register(makeEntry({
                 pid: process.pid
             }));
-            const before = fs.readFileSync(regPath, 'utf8');
+            const before = registry.list();
             registry.prune();
-            const after = fs.readFileSync(regPath, 'utf8');
-            expect(after).toBe(before);
+            const after = registry.list();
+            expect(after).toEqual(before);
         });
         it('does nothing when file is missing', ()=>{
             expect(()=>registry.prune()).not.toThrow();
@@ -252,7 +274,7 @@ describe('AgentRegistry', ()=>{
             }));
             registry.register(makeEntry({
                 name: 'agent-b',
-                pid: process.pid
+                pid: process.ppid
             }));
             expect(()=>registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);
         });
@@ -268,7 +290,7 @@ describe('AgentRegistry', ()=>{
             expect(()=>registry.rename('agent-a', 'agent-b')).not.toThrow();
             expect(registry.lookup('agent-b')?.pid).toBe(process.pid);
         });
-        it('writes atomically (no leftover .tmp on success)', ()=>{
+        it('does not create the legacy fixed .tmp path on rename', ()=>{
             registry.register(makeEntry({
                 name: 'old-name',
                 pid: process.pid

package/dist/__tests__/utils/AgentRegistry.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/__tests__/utils/AgentRegistry.test.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { AgentRegistry, RenameNotFoundError, RenameConflictError, type RegistryEntry } from '../../utils/AgentRegistry.js';\n\nfunction makeEntry(over: Partial<RegistryEntry> = {}): RegistryEntry {\n    return {\n        name: 'agent1',\n        type: 'claude',\n        pid: process.pid,\n        tmuxSession: 'agent1',\n        cwd: '/tmp',\n        startedAt: '2026-05-30T00:00:00.000Z',\n        sessionId: 'sid-1',\n        sessionFilePath: '/tmp/session.jsonl',\n        ...over,\n    };\n}\n\ndescribe('AgentRegistry', () => {\n    let tmpDir: string;\n    let regPath: string;\n    let registry: AgentRegistry;\n\n    beforeEach(() => {\n        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-registry-'));\n        regPath = path.join(tmpDir, 'nested', 'agents.json');\n        registry = new AgentRegistry(regPath);\n    });\n\n    afterEach(() => {\n        fs.rmSync(tmpDir, { recursive: true, force: true });\n    });\n\n    describe('register', () => {\n        it('creates the file and parent directory if missing', () => {\n            registry.register(makeEntry());\n            expect(fs.existsSync(regPath)).toBe(true);\n            const parsed = JSON.parse(fs.readFileSync(regPath, 'utf8'));\n            expect(parsed.entries).toHaveLength(1);\n            expect(parsed.entries[0].name).toBe('agent1');\n        });\n\n        it('appends a new entry when name is unique', () => {\n            registry.register(makeEntry({ name: 'a' }));\n            registry.register(makeEntry({ name: 'b' }));\n            expect(registry.list()).toHaveLength(2);\n        });\n\n        it('upserts in place when name already exists', () => {\n            registry.register(makeEntry({ name: 'a', pid: 100 }));\n            registry.register(makeEntry({ name: 'a', pid: 200 }));\n            const all = registry.list();\n            expect(all).toHaveLength(1);\n            expect(all[0].pid).toBe(200);\n        });\n\n        it('writes atomically (no leftover .tmp on success)', () => {\n            registry.register(makeEntry());\n            expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n        });\n\n        it('persists session fields', () => {\n            registry.register(makeEntry({ sessionId: 'sid-xyz', sessionFilePath: '/foo/bar.jsonl' }));\n            const saved = registry.list()[0];\n            expect(saved.sessionId).toBe('sid-xyz');\n            expect(saved.sessionFilePath).toBe('/foo/bar.jsonl');\n        });\n\n        it('preserves existing tmuxSession when incoming is empty string', () => {\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n            registry.register(makeEntry({ name: 'a', tmuxSession: '', pid: 999 }));\n            const saved = registry.lookup('a');\n            expect(saved?.tmuxSession).toBe('pinned');\n            expect(saved?.pid).toBe(999);\n        });\n\n        it('replaces tmuxSession when incoming is non-empty', () => {\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'old' }));\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'new' }));\n            expect(registry.lookup('a')?.tmuxSession).toBe('new');\n        });\n    });\n\n    describe('registerBatch', () => {\n        it('is a no-op on empty array', () => {\n            registry.registerBatch([]);\n            expect(fs.existsSync(regPath)).toBe(false);\n        });\n\n        it('upserts multiple entries with a single write', () => {\n            const writeSpy = vi.spyOn(fs, 'writeFileSync');\n            registry.registerBatch([\n                makeEntry({ name: 'a' }),\n                makeEntry({ name: 'b' }),\n                makeEntry({ name: 'c' }),\n            ]);\n            expect(writeSpy).toHaveBeenCalledTimes(1);\n            writeSpy.mockRestore();\n            expect(registry.list()).toHaveLength(3);\n        });\n\n        it('applies the tmuxSession merge per entry', () => {\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n            registry.registerBatch([\n                makeEntry({ name: 'a', tmuxSession: '', pid: 7 }),\n                makeEntry({ name: 'b', tmuxSession: '' }),\n            ]);\n            expect(registry.lookup('a')?.tmuxSession).toBe('pinned');\n            expect(registry.lookup('a')?.pid).toBe(7);\n            expect(registry.lookup('b')?.tmuxSession).toBe('');\n        });\n    });\n\n    describe('lookup', () => {\n        it('returns null when name not found', () => {\n            expect(registry.lookup('missing')).toBeNull();\n        });\n\n        it('returns the entry when name matches', () => {\n            registry.register(makeEntry({ name: 'a' }));\n            expect(registry.lookup('a')?.name).toBe('a');\n        });\n    });\n\n    describe('list', () => {\n        it('returns empty array when file does not exist', () => {\n            expect(registry.list()).toEqual([]);\n        });\n\n        it('returns empty array when file is malformed', () => {\n            fs.mkdirSync(path.dirname(regPath), { recursive: true });\n            fs.writeFileSync(regPath, 'not json', 'utf8');\n            expect(registry.list()).toEqual([]);\n        });\n\n        it('coerces non-array entries to []', () => {\n            fs.mkdirSync(path.dirname(regPath), { recursive: true });\n            fs.writeFileSync(regPath, JSON.stringify({ entries: 'oops' }), 'utf8');\n            expect(registry.list()).toEqual([]);\n        });\n    });\n\n    describe('isAlive', () => {\n        it('returns true for the current process', () => {\n            expect(registry.isAlive(makeEntry({ pid: process.pid }))).toBe(true);\n        });\n\n        it('returns false for a PID that does not exist', () => {\n            expect(registry.isAlive(makeEntry({ pid: 999999 }))).toBe(false);\n        });\n    });\n\n    describe('prune', () => {\n        it('removes entries whose PIDs are dead', () => {\n            registry.register(makeEntry({ name: 'alive', pid: process.pid }));\n            registry.register(makeEntry({ name: 'dead', pid: 999999 }));\n            registry.prune();\n            const remaining = registry.list();\n            expect(remaining).toHaveLength(1);\n            expect(remaining[0].name).toBe('alive');\n        });\n\n        it('is a no-op when all entries are alive', () => {\n            registry.register(makeEntry({ pid: process.pid }));\n            const before = fs.readFileSync(regPath, 'utf8');\n            registry.prune();\n            const after = fs.readFileSync(regPath, 'utf8');\n            expect(after).toBe(before);\n        });\n\n        it('does nothing when file is missing', () => {\n            expect(() => registry.prune()).not.toThrow();\n        });\n    });\n\n    describe('default()', () => {\n        it('returns a singleton instance', () => {\n            expect(AgentRegistry.default()).toBe(AgentRegistry.default());\n        });\n    });\n\n    describe('rename', () => {\n        it('updates the name of an existing entry', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n            registry.rename('old-name', 'new-name');\n            expect(registry.lookup('new-name')?.name).toBe('new-name');\n            expect(registry.lookup('old-name')).toBeNull();\n        });\n\n        it('preserves all other fields on the renamed entry', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid, tmuxSession: 'old-name', cwd: '/my/cwd' }));\n            registry.rename('old-name', 'new-name');\n            const entry = registry.lookup('new-name');\n            expect(entry?.tmuxSession).toBe('old-name');\n            expect(entry?.cwd).toBe('/my/cwd');\n            expect(entry?.pid).toBe(process.pid);\n        });\n\n        it('throws RenameNotFoundError when current name does not exist', () => {\n            expect(() => registry.rename('ghost', 'new-name')).toThrow(RenameNotFoundError);\n        });\n\n        it('throws RenameConflictError when new name is already in use by a live entry', () => {\n            registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n            registry.register(makeEntry({ name: 'agent-b', pid: process.pid }));\n            expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n        });\n\n        it('succeeds when new name exists only as a stale (dead) entry', () => {\n            registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n            registry.register(makeEntry({ name: 'agent-b', pid: 999999 }));\n            expect(() => registry.rename('agent-a', 'agent-b')).not.toThrow();\n            expect(registry.lookup('agent-b')?.pid).toBe(process.pid);\n        });\n\n        it('writes atomically (no leftover .tmp on success)', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n            registry.rename('old-name', 'new-name');\n            expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n        });\n    });\n});\n"],"names":["fs","os","path","AgentRegistry","RenameNotFoundError","RenameConflictError","makeEntry","over","name","type","pid","process","tmuxSession","cwd","startedAt","sessionId","sessionFilePath","describe","tmpDir","regPath","registry","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","it","register","expect","existsSync","toBe","parsed","JSON","parse","readFileSync","entries","toHaveLength","list","all","saved","lookup","registerBatch","writeSpy","vi","spyOn","toHaveBeenCalledTimes","mockRestore","toBeNull","toEqual","mkdirSync","dirname","writeFileSync","stringify","isAlive","prune","remaining","before","after","not","toThrow","default","rename","entry"],"mappings":"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"}
+{"version":3,"sources":["../../../src/__tests__/utils/AgentRegistry.test.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { AgentRegistry, RenameNotFoundError, RenameConflictError, type RegistryEntry } from '../../utils/AgentRegistry.js';\n\nfunction makeEntry(over: Partial<RegistryEntry> = {}): RegistryEntry {\n    return {\n        name: 'agent1',\n        type: 'claude',\n        pid: process.pid,\n        tmuxSession: 'agent1',\n        cwd: '/tmp',\n        startedAt: '2026-05-30T00:00:00.000Z',\n        sessionId: 'sid-1',\n        sessionFilePath: '/tmp/session.jsonl',\n        ...over,\n    };\n}\n\ndescribe('AgentRegistry', () => {\n    let tmpDir: string;\n    let regPath: string;\n    let registry: AgentRegistry;\n\n    beforeEach(() => {\n        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-registry-'));\n        regPath = path.join(tmpDir, 'nested', 'agents.json');\n        registry = new AgentRegistry(regPath);\n    });\n\n    afterEach(() => {\n        fs.rmSync(tmpDir, { recursive: true, force: true });\n    });\n\n    describe('register', () => {\n        it('creates the SQLite database and parent directory if missing', () => {\n            registry.register(makeEntry());\n            expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n            expect(registry.list()[0].name).toBe('agent1');\n        });\n\n        it('appends a new entry when name is unique', () => {\n            registry.register(makeEntry({ name: 'a' }));\n            registry.register(makeEntry({ name: 'b', pid: process.ppid }));\n            expect(registry.list()).toHaveLength(2);\n        });\n\n        it('upserts in place when type and pid already exist', () => {\n            registry.register(makeEntry({ name: 'a', pid: process.pid }));\n            registry.register(makeEntry({ name: 'fallback', pid: process.pid, tmuxSession: '' }));\n            const all = registry.list();\n            expect(all).toHaveLength(1);\n            expect(all[0].pid).toBe(process.pid);\n            expect(all[0].name).toBe('a');\n        });\n\n        it('does not write through the legacy fixed .tmp path', () => {\n            registry.register(makeEntry());\n            expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n        });\n\n        it('persists session fields', () => {\n            registry.register(makeEntry({ sessionId: 'sid-xyz', sessionFilePath: '/foo/bar.jsonl' }));\n            const saved = registry.list()[0];\n            expect(saved.sessionId).toBe('sid-xyz');\n            expect(saved.sessionFilePath).toBe('/foo/bar.jsonl');\n        });\n\n        it('preserves existing tmuxSession when incoming is empty string', () => {\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n            registry.register(makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }));\n            const saved = registry.lookup('a');\n            expect(saved?.tmuxSession).toBe('pinned');\n            expect(saved?.pid).toBe(process.pid);\n        });\n\n        it('lets a managed start entry replace a generated fallback for the same pid', () => {\n            registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n            registry.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n            expect(registry.lookup('custom-name')?.tmuxSession).toBe('custom-name');\n            expect(registry.lookup(`ai-devkit-${process.pid}`)).toBeNull();\n            expect(registry.list()).toHaveLength(1);\n        });\n    });\n\n    describe('registerBatch', () => {\n        it('is a no-op on empty array', () => {\n            registry.registerBatch([]);\n            expect(fs.existsSync(regPath)).toBe(false);\n        });\n\n        it('upserts multiple entries in a single batch', () => {\n            registry.registerBatch([\n                makeEntry({ name: 'a' }),\n                makeEntry({ name: 'b', pid: process.pid + 1 }),\n                makeEntry({ name: 'c', pid: process.pid + 2 }),\n            ]);\n            expect(registry.list()).toHaveLength(3);\n        });\n\n        it('applies the tmuxSession merge per entry', () => {\n            registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n            registry.registerBatch([\n                makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }),\n                makeEntry({ name: 'b', tmuxSession: '', pid: process.pid + 1 }),\n            ]);\n            expect(registry.lookup('a')?.tmuxSession).toBe('pinned');\n            expect(registry.lookup('a')?.pid).toBe(process.pid);\n            expect(registry.lookup('b')?.tmuxSession).toBe('');\n        });\n\n        it('handles concurrent registry instances without duplicate pid rows', () => {\n            const other = new AgentRegistry(regPath);\n            registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n            other.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n            registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n\n            expect(registry.list()).toHaveLength(1);\n            expect(registry.lookup('custom-name')?.pid).toBe(process.pid);\n        });\n    });\n\n    describe('lookup', () => {\n        it('returns null when name not found', () => {\n            expect(registry.lookup('missing')).toBeNull();\n        });\n\n        it('returns the entry when name matches', () => {\n            registry.register(makeEntry({ name: 'a' }));\n            expect(registry.lookup('a')?.name).toBe('a');\n        });\n    });\n\n    describe('list', () => {\n        it('returns empty array when database does not contain entries', () => {\n            expect(registry.list()).toEqual([]);\n        });\n\n        it('ignores existing legacy agents.json entries', () => {\n            const legacyEntry = makeEntry({ name: 'legacy', tmuxSession: 'legacy' });\n            fs.mkdirSync(path.dirname(regPath), { recursive: true });\n            fs.writeFileSync(regPath, JSON.stringify({ entries: [legacyEntry] }), 'utf8');\n\n            const legacyRegistry = new AgentRegistry(regPath);\n\n            expect(legacyRegistry.lookup('legacy')).toBeNull();\n            expect(legacyRegistry.list()).toEqual([]);\n            expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n        });\n    });\n\n    describe('isAlive', () => {\n        it('returns true for the current process', () => {\n            expect(registry.isAlive(makeEntry({ pid: process.pid }))).toBe(true);\n        });\n\n        it('returns false for a PID that does not exist', () => {\n            expect(registry.isAlive(makeEntry({ pid: 999999 }))).toBe(false);\n        });\n    });\n\n    describe('prune', () => {\n        it('removes entries whose PIDs are dead', () => {\n            registry.register(makeEntry({ name: 'alive', pid: process.pid }));\n            registry.register(makeEntry({ name: 'dead', pid: 999999 }));\n            registry.prune();\n            const remaining = registry.list();\n            expect(remaining).toHaveLength(1);\n            expect(remaining[0].name).toBe('alive');\n        });\n\n        it('is a no-op when all entries are alive', () => {\n            registry.register(makeEntry({ pid: process.pid }));\n            const before = registry.list();\n            registry.prune();\n            const after = registry.list();\n            expect(after).toEqual(before);\n        });\n\n        it('does nothing when file is missing', () => {\n            expect(() => registry.prune()).not.toThrow();\n        });\n    });\n\n    describe('default()', () => {\n        it('returns a singleton instance', () => {\n            expect(AgentRegistry.default()).toBe(AgentRegistry.default());\n        });\n    });\n\n    describe('rename', () => {\n        it('updates the name of an existing entry', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n            registry.rename('old-name', 'new-name');\n            expect(registry.lookup('new-name')?.name).toBe('new-name');\n            expect(registry.lookup('old-name')).toBeNull();\n        });\n\n        it('preserves all other fields on the renamed entry', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid, tmuxSession: 'old-name', cwd: '/my/cwd' }));\n            registry.rename('old-name', 'new-name');\n            const entry = registry.lookup('new-name');\n            expect(entry?.tmuxSession).toBe('old-name');\n            expect(entry?.cwd).toBe('/my/cwd');\n            expect(entry?.pid).toBe(process.pid);\n        });\n\n        it('throws RenameNotFoundError when current name does not exist', () => {\n            expect(() => registry.rename('ghost', 'new-name')).toThrow(RenameNotFoundError);\n        });\n\n        it('throws RenameConflictError when new name is already in use by a live entry', () => {\n            registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n            registry.register(makeEntry({ name: 'agent-b', pid: process.ppid }));\n            expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n        });\n\n        it('succeeds when new name exists only as a stale (dead) entry', () => {\n            registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n            registry.register(makeEntry({ name: 'agent-b', pid: 999999 }));\n            expect(() => registry.rename('agent-a', 'agent-b')).not.toThrow();\n            expect(registry.lookup('agent-b')?.pid).toBe(process.pid);\n        });\n\n        it('does not create the legacy fixed .tmp path on rename', () => {\n            registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n            registry.rename('old-name', 'new-name');\n            expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n        });\n    });\n});\n"],"names":["fs","os","path","AgentRegistry","RenameNotFoundError","RenameConflictError","makeEntry","over","name","type","pid","process","tmuxSession","cwd","startedAt","sessionId","sessionFilePath","describe","tmpDir","regPath","registry","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","it","register","expect","existsSync","replace","toBe","list","ppid","toHaveLength","all","saved","lookup","toBeNull","registerBatch","other","toEqual","legacyEntry","mkdirSync","dirname","writeFileSync","JSON","stringify","entries","legacyRegistry","isAlive","prune","remaining","before","after","not","toThrow","default","rename","entry"],"mappings":"AAAA,OAAOA,QAAQ,KAAK;AACpB,OAAOC,QAAQ,KAAK;AACpB,OAAOC,UAAU,OAAO;AACxB,SAASC,aAAa,EAAEC,mBAAmB,EAAEC,mBAAmB,QAA4B,+BAA+B;AAE3H,SAASC,UAAUC,OAA+B,CAAC,CAAC;IAChD,OAAO;QACHC,MAAM;QACNC,MAAM;QACNC,KAAKC,QAAQD,GAAG;QAChBE,aAAa;QACbC,KAAK;QACLC,WAAW;QACXC,WAAW;QACXC,iBAAiB;QACjB,GAAGT,IAAI;IACX;AACJ;AAEAU,SAAS,iBAAiB;IACtB,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAEJC,WAAW;QACPH,SAASlB,GAAGsB,WAAW,CAACpB,KAAKqB,IAAI,CAACtB,GAAGuB,MAAM,IAAI;QAC/CL,UAAUjB,KAAKqB,IAAI,CAACL,QAAQ,UAAU;QACtCE,WAAW,IAAIjB,cAAcgB;IACjC;IAEAM,UAAU;QACNzB,GAAG0B,MAAM,CAACR,QAAQ;YAAES,WAAW;YAAMC,OAAO;QAAK;IACrD;IAEAX,SAAS,YAAY;QACjBY,GAAG,+DAA+D;YAC9DT,SAASU,QAAQ,CAACxB;YAClByB,OAAO/B,GAAGgC,UAAU,CAACb,QAAQc,OAAO,CAAC,WAAW,SAASC,IAAI,CAAC;YAC9DH,OAAOX,SAASe,IAAI,EAAE,CAAC,EAAE,CAAC3B,IAAI,EAAE0B,IAAI,CAAC;QACzC;QAEAL,GAAG,2CAA2C;YAC1CT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;YAAI;YACxCY,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAKE,KAAKC,QAAQyB,IAAI;YAAC;YAC3DL,OAAOX,SAASe,IAAI,IAAIE,YAAY,CAAC;QACzC;QAEAR,GAAG,oDAAoD;YACnDT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAKE,KAAKC,QAAQD,GAAG;YAAC;YAC1DU,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAYE,KAAKC,QAAQD,GAAG;gBAAEE,aAAa;YAAG;YAClF,MAAM0B,MAAMlB,SAASe,IAAI;YACzBJ,OAAOO,KAAKD,YAAY,CAAC;YACzBN,OAAOO,GAAG,CAAC,EAAE,CAAC5B,GAAG,EAAEwB,IAAI,CAACvB,QAAQD,GAAG;YACnCqB,OAAOO,GAAG,CAAC,EAAE,CAAC9B,IAAI,EAAE0B,IAAI,CAAC;QAC7B;QAEAL,GAAG,qDAAqD;YACpDT,SAASU,QAAQ,CAACxB;YAClByB,OAAO/B,GAAGgC,UAAU,CAAC,GAAGb,QAAQ,IAAI,CAAC,GAAGe,IAAI,CAAC;QACjD;QAEAL,GAAG,2BAA2B;YAC1BT,SAASU,QAAQ,CAACxB,UAAU;gBAAES,WAAW;gBAAWC,iBAAiB;YAAiB;YACtF,MAAMuB,QAAQnB,SAASe,IAAI,EAAE,CAAC,EAAE;YAChCJ,OAAOQ,MAAMxB,SAAS,EAAEmB,IAAI,CAAC;YAC7BH,OAAOQ,MAAMvB,eAAe,EAAEkB,IAAI,CAAC;QACvC;QAEAL,GAAG,gEAAgE;YAC/DT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAKI,aAAa;YAAS;YAC/DQ,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAYI,aAAa;gBAAIF,KAAKC,QAAQD,GAAG;YAAC;YAClF,MAAM6B,QAAQnB,SAASoB,MAAM,CAAC;YAC9BT,OAAOQ,OAAO3B,aAAasB,IAAI,CAAC;YAChCH,OAAOQ,OAAO7B,KAAKwB,IAAI,CAACvB,QAAQD,GAAG;QACvC;QAEAmB,GAAG,4EAA4E;YAC3ET,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM,CAAC,UAAU,EAAEG,QAAQD,GAAG,EAAE;gBAAEE,aAAa;YAAG;YAChFQ,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAeI,aAAa;YAAc;YAC9EmB,OAAOX,SAASoB,MAAM,CAAC,gBAAgB5B,aAAasB,IAAI,CAAC;YACzDH,OAAOX,SAASoB,MAAM,CAAC,CAAC,UAAU,EAAE7B,QAAQD,GAAG,EAAE,GAAG+B,QAAQ;YAC5DV,OAAOX,SAASe,IAAI,IAAIE,YAAY,CAAC;QACzC;IACJ;IAEApB,SAAS,iBAAiB;QACtBY,GAAG,6BAA6B;YAC5BT,SAASsB,aAAa,CAAC,EAAE;YACzBX,OAAO/B,GAAGgC,UAAU,CAACb,UAAUe,IAAI,CAAC;QACxC;QAEAL,GAAG,8CAA8C;YAC7CT,SAASsB,aAAa,CAAC;gBACnBpC,UAAU;oBAAEE,MAAM;gBAAI;gBACtBF,UAAU;oBAAEE,MAAM;oBAAKE,KAAKC,QAAQD,GAAG,GAAG;gBAAE;gBAC5CJ,UAAU;oBAAEE,MAAM;oBAAKE,KAAKC,QAAQD,GAAG,GAAG;gBAAE;aAC/C;YACDqB,OAAOX,SAASe,IAAI,IAAIE,YAAY,CAAC;QACzC;QAEAR,GAAG,2CAA2C;YAC1CT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAKI,aAAa;YAAS;YAC/DQ,SAASsB,aAAa,CAAC;gBACnBpC,UAAU;oBAAEE,MAAM;oBAAYI,aAAa;oBAAIF,KAAKC,QAAQD,GAAG;gBAAC;gBAChEJ,UAAU;oBAAEE,MAAM;oBAAKI,aAAa;oBAAIF,KAAKC,QAAQD,GAAG,GAAG;gBAAE;aAChE;YACDqB,OAAOX,SAASoB,MAAM,CAAC,MAAM5B,aAAasB,IAAI,CAAC;YAC/CH,OAAOX,SAASoB,MAAM,CAAC,MAAM9B,KAAKwB,IAAI,CAACvB,QAAQD,GAAG;YAClDqB,OAAOX,SAASoB,MAAM,CAAC,MAAM5B,aAAasB,IAAI,CAAC;QACnD;QAEAL,GAAG,oEAAoE;YACnE,MAAMc,QAAQ,IAAIxC,cAAcgB;YAChCC,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM,CAAC,UAAU,EAAEG,QAAQD,GAAG,EAAE;gBAAEE,aAAa;YAAG;YAChF+B,MAAMb,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAeI,aAAa;YAAc;YAC3EQ,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM,CAAC,UAAU,EAAEG,QAAQD,GAAG,EAAE;gBAAEE,aAAa;YAAG;YAEhFmB,OAAOX,SAASe,IAAI,IAAIE,YAAY,CAAC;YACrCN,OAAOX,SAASoB,MAAM,CAAC,gBAAgB9B,KAAKwB,IAAI,CAACvB,QAAQD,GAAG;QAChE;IACJ;IAEAO,SAAS,UAAU;QACfY,GAAG,oCAAoC;YACnCE,OAAOX,SAASoB,MAAM,CAAC,YAAYC,QAAQ;QAC/C;QAEAZ,GAAG,uCAAuC;YACtCT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;YAAI;YACxCuB,OAAOX,SAASoB,MAAM,CAAC,MAAMhC,MAAM0B,IAAI,CAAC;QAC5C;IACJ;IAEAjB,SAAS,QAAQ;QACbY,GAAG,8DAA8D;YAC7DE,OAAOX,SAASe,IAAI,IAAIS,OAAO,CAAC,EAAE;QACtC;QAEAf,GAAG,+CAA+C;YAC9C,MAAMgB,cAAcvC,UAAU;gBAAEE,MAAM;gBAAUI,aAAa;YAAS;YACtEZ,GAAG8C,SAAS,CAAC5C,KAAK6C,OAAO,CAAC5B,UAAU;gBAAEQ,WAAW;YAAK;YACtD3B,GAAGgD,aAAa,CAAC7B,SAAS8B,KAAKC,SAAS,CAAC;gBAAEC,SAAS;oBAACN;iBAAY;YAAC,IAAI;YAEtE,MAAMO,iBAAiB,IAAIjD,cAAcgB;YAEzCY,OAAOqB,eAAeZ,MAAM,CAAC,WAAWC,QAAQ;YAChDV,OAAOqB,eAAejB,IAAI,IAAIS,OAAO,CAAC,EAAE;YACxCb,OAAO/B,GAAGgC,UAAU,CAACb,QAAQc,OAAO,CAAC,WAAW,SAASC,IAAI,CAAC;QAClE;IACJ;IAEAjB,SAAS,WAAW;QAChBY,GAAG,wCAAwC;YACvCE,OAAOX,SAASiC,OAAO,CAAC/C,UAAU;gBAAEI,KAAKC,QAAQD,GAAG;YAAC,KAAKwB,IAAI,CAAC;QACnE;QAEAL,GAAG,+CAA+C;YAC9CE,OAAOX,SAASiC,OAAO,CAAC/C,UAAU;gBAAEI,KAAK;YAAO,KAAKwB,IAAI,CAAC;QAC9D;IACJ;IAEAjB,SAAS,SAAS;QACdY,GAAG,uCAAuC;YACtCT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAASE,KAAKC,QAAQD,GAAG;YAAC;YAC9DU,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAQE,KAAK;YAAO;YACxDU,SAASkC,KAAK;YACd,MAAMC,YAAYnC,SAASe,IAAI;YAC/BJ,OAAOwB,WAAWlB,YAAY,CAAC;YAC/BN,OAAOwB,SAAS,CAAC,EAAE,CAAC/C,IAAI,EAAE0B,IAAI,CAAC;QACnC;QAEAL,GAAG,yCAAyC;YACxCT,SAASU,QAAQ,CAACxB,UAAU;gBAAEI,KAAKC,QAAQD,GAAG;YAAC;YAC/C,MAAM8C,SAASpC,SAASe,IAAI;YAC5Bf,SAASkC,KAAK;YACd,MAAMG,QAAQrC,SAASe,IAAI;YAC3BJ,OAAO0B,OAAOb,OAAO,CAACY;QAC1B;QAEA3B,GAAG,qCAAqC;YACpCE,OAAO,IAAMX,SAASkC,KAAK,IAAII,GAAG,CAACC,OAAO;QAC9C;IACJ;IAEA1C,SAAS,aAAa;QAClBY,GAAG,gCAAgC;YAC/BE,OAAO5B,cAAcyD,OAAO,IAAI1B,IAAI,CAAC/B,cAAcyD,OAAO;QAC9D;IACJ;IAEA3C,SAAS,UAAU;QACfY,GAAG,yCAAyC;YACxCT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAYE,KAAKC,QAAQD,GAAG;YAAC;YACjEU,SAASyC,MAAM,CAAC,YAAY;YAC5B9B,OAAOX,SAASoB,MAAM,CAAC,aAAahC,MAAM0B,IAAI,CAAC;YAC/CH,OAAOX,SAASoB,MAAM,CAAC,aAAaC,QAAQ;QAChD;QAEAZ,GAAG,mDAAmD;YAClDT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAYE,KAAKC,QAAQD,GAAG;gBAAEE,aAAa;gBAAYC,KAAK;YAAU;YAC1GO,SAASyC,MAAM,CAAC,YAAY;YAC5B,MAAMC,QAAQ1C,SAASoB,MAAM,CAAC;YAC9BT,OAAO+B,OAAOlD,aAAasB,IAAI,CAAC;YAChCH,OAAO+B,OAAOjD,KAAKqB,IAAI,CAAC;YACxBH,OAAO+B,OAAOpD,KAAKwB,IAAI,CAACvB,QAAQD,GAAG;QACvC;QAEAmB,GAAG,+DAA+D;YAC9DE,OAAO,IAAMX,SAASyC,MAAM,CAAC,SAAS,aAAaF,OAAO,CAACvD;QAC/D;QAEAyB,GAAG,8EAA8E;YAC7ET,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAWE,KAAKC,QAAQD,GAAG;YAAC;YAChEU,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAWE,KAAKC,QAAQyB,IAAI;YAAC;YACjEL,OAAO,IAAMX,SAASyC,MAAM,CAAC,WAAW,YAAYF,OAAO,CAACtD;QAChE;QAEAwB,GAAG,8DAA8D;YAC7DT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAWE,KAAKC,QAAQD,GAAG;YAAC;YAChEU,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAWE,KAAK;YAAO;YAC3DqB,OAAO,IAAMX,SAASyC,MAAM,CAAC,WAAW,YAAYH,GAAG,CAACC,OAAO;YAC/D5B,OAAOX,SAASoB,MAAM,CAAC,YAAY9B,KAAKwB,IAAI,CAACvB,QAAQD,GAAG;QAC5D;QAEAmB,GAAG,wDAAwD;YACvDT,SAASU,QAAQ,CAACxB,UAAU;gBAAEE,MAAM;gBAAYE,KAAKC,QAAQD,GAAG;YAAC;YACjEU,SAASyC,MAAM,CAAC,YAAY;YAC5B9B,OAAO/B,GAAGgC,UAAU,CAAC,GAAGb,QAAQ,IAAI,CAAC,GAAGe,IAAI,CAAC;QACjD;IACJ;AACJ"}

package/dist/__tests__/utils/process.test.js

@@ -1,11 +1,99 @@
 /**
  * Tests for new functions in utils/process.ts
- */ import { execFileSync } from 'child_process';
-import { listAgentProcesses, batchGetProcessCwds, batchGetProcessStartTimes, enrichProcesses, findWrapperProcess, findWrapperProcessPids } from '../../utils/process.js';
+ */ import { execFile, execFileSync } from 'child_process';
+import { listAgentProcesses, batchGetProcessCwds, batchGetProcessStartTimes, enrichProcesses, findWrapperProcess, findWrapperProcessPids, captureProcessSnapshot, filterByProcessNames } from '../../utils/process.js';
 vi.mock('child_process', ()=>({
+        execFile: vi.fn(),
         execFileSync: vi.fn()
     }));
 const mockedExecFileSync = execFileSync;
+const mockedExecFile = execFile;
+describe('captureProcessSnapshot', ()=>{
+    beforeEach(()=>{
+        mockedExecFile.mockReset();
+        mockedExecFileSync.mockReset();
+    });
+    it('captures and enriches relevant processes without synchronous scans', async ()=>{
+        mockedExecFile.mockImplementation((file, args, _options, callback)=>{
+            queueMicrotask(()=>{
+                if (file === 'ps' && args.includes('-axo')) {
+                    callback(null, '100 1 s001 /usr/bin/claude --resume abc\n' + '200 1 s002 C:\\\\tools\\\\node.exe C:\\\\bin\\\\pi.js\n' + '300 1 s003 /usr/bin/unrelated\n', '');
+                    return;
+                }
+                if (file === 'lsof') {
+                    callback(null, 'p100\nn/projects/claude\np200\nn/projects/pi\n', '');
+                    return;
+                }
+                if (file === 'ps' && args.some((arg)=>arg.includes('lstart='))) {
+                    callback(null, '100 Wed Mar 18 23:18:01 2026\n' + '200 Thu Mar 19 10:00:00 2026\n', '');
+                    return;
+                }
+                callback(new Error(`unexpected command: ${file} ${args.join(' ')}`), '', '');
+            });
+        });
+        const snapshot = await captureProcessSnapshot([
+            'claude',
+            'node'
+        ]);
+        expect(snapshot.map((process)=>process.pid)).toEqual([
+            100,
+            200
+        ]);
+        expect(snapshot.map((process)=>process.cwd)).toEqual([
+            '/projects/claude',
+            '/projects/pi'
+        ]);
+        expect(snapshot.map((process)=>process.startTime)).toEqual([
+            expect.any(Date),
+            expect.any(Date)
+        ]);
+        expect(mockedExecFileSync).not.toHaveBeenCalled();
+        expect(mockedExecFile.mock.calls.filter(([, args])=>args.includes('-axo'))).toHaveLength(1);
+        for (const [, , options] of mockedExecFile.mock.calls){
+            expect(options).toMatchObject({
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024
+            });
+            expect(options).not.toHaveProperty('stdio');
+        }
+    });
+});
+describe('filterByProcessNames', ()=>{
+    it('matches only argv[0] and normalizes Windows paths and executable suffixes', ()=>{
+        const processes = [
+            {
+                pid: 1,
+                command: 'C:\\tools\\node.exe C:\\bin\\pi.js',
+                cwd: '',
+                tty: ''
+            },
+            {
+                pid: 2,
+                command: '/usr/local/bin/node /opt/gemini.js',
+                cwd: '',
+                tty: ''
+            },
+            {
+                pid: 3,
+                command: 'codex exec --cd C:\\repos\\node',
+                cwd: '',
+                tty: ''
+            }
+        ];
+        expect(filterByProcessNames(processes, [
+            'node'
+        ])).toEqual([
+            processes[0],
+            processes[1]
+        ]);
+        expect(filterByProcessNames(processes, [
+            'node.exe'
+        ])).toEqual([
+            processes[0],
+            processes[1]
+        ]);
+    });
+});
 describe('listAgentProcesses', ()=>{
     beforeEach(()=>{
         mockedExecFileSync.mockReset();

package/dist/__tests__/utils/process.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/__tests__/utils/process.test.ts"],"sourcesContent":["/**\n * Tests for new functions in utils/process.ts\n */\n\nimport type { MockedFunction } from 'vitest';\n\nimport { execFileSync } from 'child_process';\nimport {\n    listAgentProcesses,\n    batchGetProcessCwds,\n    batchGetProcessStartTimes,\n    enrichProcesses,\n    findWrapperProcess,\n    findWrapperProcessPids,\n} from '../../utils/process.js';\n\nvi.mock('child_process', () => ({\n    execFileSync: vi.fn(),\n}));\n\nconst mockedExecFileSync = execFileSync as MockedFunction<typeof execFileSync>;\n\ndescribe('listAgentProcesses', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse ps output and post-filter by executable name', () => {\n        mockedExecFileSync.mockReturnValue(\n            '78070     1 s018     claude\\n' +\n            '55106 55100 s015     claude\\n',\n        );\n\n        const processes = listAgentProcesses('claude');\n        expect(processes).toHaveLength(2);\n        expect(processes[0].pid).toBe(78070);\n        expect(processes[0].ppid).toBe(1);\n        expect(processes[0].command).toBe('claude');\n        expect(processes[0].tty).toBe('s018');\n        expect(processes[0].cwd).toBe(''); // not populated yet\n        expect(processes[1].pid).toBe(55106);\n        expect(processes[1].ppid).toBe(55100);\n    });\n\n    it('should filter out non-matching executables', () => {\n        mockedExecFileSync.mockReturnValue(\n            '100 1 s001 claude\\n' +\n            '200 1 s002 claude-helper --pid 100\\n' +\n            '300 1 s003 /usr/bin/claude\\n',\n        );\n\n        const processes = listAgentProcesses('claude');\n        expect(processes).toHaveLength(2);\n        expect(processes.map(p => p.pid)).toEqual([100, 300]);\n    });\n\n    it('should return empty array on command failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        expect(listAgentProcesses('claude')).toEqual([]);\n    });\n\n    it('should handle empty output', () => {\n        mockedExecFileSync.mockReturnValue('');\n        expect(listAgentProcesses('claude')).toEqual([]);\n    });\n\n    it('should reject empty pattern', () => {\n        expect(listAgentProcesses('')).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should reject patterns with shell injection characters', () => {\n        expect(listAgentProcesses('claude; rm -rf /')).toEqual([]);\n        expect(listAgentProcesses(\"claude' || true\")).toEqual([]);\n        expect(listAgentProcesses('$(whoami)')).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should accept valid patterns with dashes and underscores', () => {\n        mockedExecFileSync.mockReturnValue('');\n        listAgentProcesses('claude-code');\n        expect(mockedExecFileSync).toHaveBeenCalledWith(\n            'ps',\n            ['-axo', 'pid=,ppid=,tty=,command='],\n            { encoding: 'utf-8' },\n        );\n\n        mockedExecFileSync.mockReset();\n        mockedExecFileSync.mockReturnValue('');\n        listAgentProcesses('my_agent');\n        expect(mockedExecFileSync).toHaveBeenCalled();\n    });\n});\n\ndescribe('batchGetProcessCwds', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse batched lsof output', () => {\n        mockedExecFileSync.mockReturnValue(\n            'p78070\\nn/Users/user/ai-devkit\\np55106\\nn/Users/user/other-project\\n',\n        );\n\n        const cwds = batchGetProcessCwds([78070, 55106]);\n        expect(cwds.get(78070)).toBe('/Users/user/ai-devkit');\n        expect(cwds.get(55106)).toBe('/Users/user/other-project');\n    });\n\n    it('should return empty map for empty pids', () => {\n        expect(batchGetProcessCwds([])).toEqual(new Map());\n    });\n\n    it('should return partial results when lsof succeeds for some PIDs', () => {\n        // lsof might not return entries for dead processes\n        mockedExecFileSync.mockReturnValue(\n            'p78070\\nn/Users/user/ai-devkit\\n',\n        );\n\n        const cwds = batchGetProcessCwds([78070, 99999]);\n        expect(cwds.size).toBe(1);\n        expect(cwds.get(78070)).toBe('/Users/user/ai-devkit');\n    });\n\n    it('should return empty map on total failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        const cwds = batchGetProcessCwds([78070]);\n        // Falls through to pwdx fallback which also fails\n        expect(cwds.size).toBe(0);\n    });\n});\n\ndescribe('batchGetProcessStartTimes', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse ps lstart output', () => {\n        mockedExecFileSync.mockReturnValue(\n            ' 78070 Wed Mar 18 23:18:01 2026\\n' +\n            ' 55106 Mon Mar  9 21:41:42 2026\\n',\n        );\n\n        const times = batchGetProcessStartTimes([78070, 55106]);\n        expect(times.size).toBe(2);\n        expect(times.get(78070)?.getFullYear()).toBe(2026);\n        expect(times.get(55106)?.getMonth()).toBe(2); // March = 2\n    });\n\n    it('should return empty map for empty pids', () => {\n        expect(batchGetProcessStartTimes([])).toEqual(new Map());\n    });\n\n    it('should skip lines with unparseable dates', () => {\n        mockedExecFileSync.mockReturnValue(\n            ' 78070 Wed Mar 18 23:18:01 2026\\n' +\n            ' 99999 INVALID_DATE\\n',\n        );\n\n        const times = batchGetProcessStartTimes([78070, 99999]);\n        expect(times.size).toBe(1);\n        expect(times.has(78070)).toBe(true);\n    });\n\n    it('should return empty map on failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        expect(batchGetProcessStartTimes([78070])).toEqual(new Map());\n    });\n});\n\ndescribe('enrichProcesses', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should populate cwd and startTime on processes', () => {\n        // First call: batchGetProcessCwds (lsof)\n        // Second call: batchGetProcessStartTimes (ps lstart)\n        mockedExecFileSync\n            .mockReturnValueOnce('p100\\nn/projects/app\\n')\n            .mockReturnValueOnce(' 100 Wed Mar 18 23:18:01 2026\\n');\n\n        const processes = [\n            { pid: 100, command: 'claude', cwd: '', tty: 's001' },\n        ];\n\n        const enriched = enrichProcesses(processes);\n        expect(enriched[0].cwd).toBe('/projects/app');\n        expect(enriched[0].startTime).toBeDefined();\n    });\n\n    it('should return empty array for empty input', () => {\n        expect(enrichProcesses([])).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should handle partial failures', () => {\n        // lsof succeeds, ps lstart fails\n        mockedExecFileSync\n            .mockReturnValueOnce('p100\\nn/projects/app\\n')\n            .mockImplementationOnce(() => { throw new Error('fail'); });\n\n        const processes = [\n            { pid: 100, command: 'claude', cwd: '', tty: 's001' },\n        ];\n\n        const enriched = enrichProcesses(processes);\n        expect(enriched[0].cwd).toBe('/projects/app');\n        expect(enriched[0].startTime).toBeUndefined();\n    });\n});\n\ndescribe('wrapper process detection', () => {\n    it('finds the parent wrapper process for a child in the same terminal and cwd', () => {\n        const wrapper = { pid: 100, ppid: 1, command: 'node /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n\n        expect(findWrapperProcess([wrapper, child], child)).toBe(wrapper);\n        expect(findWrapperProcessPids([wrapper, child])).toEqual(new Set([100]));\n    });\n\n    it('does not mark a matched child process as its own wrapper', () => {\n        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n\n        expect(findWrapperProcessPids([child], [child])).toEqual(new Set());\n    });\n});\n"],"names":["execFileSync","listAgentProcesses","batchGetProcessCwds","batchGetProcessStartTimes","enrichProcesses","findWrapperProcess","findWrapperProcessPids","vi","mock","fn","mockedExecFileSync","describe","beforeEach","mockReset","it","mockReturnValue","processes","expect","toHaveLength","pid","toBe","ppid","command","tty","cwd","map","p","toEqual","mockImplementation","Error","not","toHaveBeenCalled","toHaveBeenCalledWith","encoding","cwds","get","Map","size","times","getFullYear","getMonth","has","mockReturnValueOnce","enriched","startTime","toBeDefined","mockImplementationOnce","toBeUndefined","wrapper","child","Set"],"mappings":"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"}
+{"version":3,"sources":["../../../src/__tests__/utils/process.test.ts"],"sourcesContent":["/**\n * Tests for new functions in utils/process.ts\n */\n\nimport type { MockedFunction } from 'vitest';\n\nimport { execFile, execFileSync } from 'child_process';\nimport {\n    listAgentProcesses,\n    batchGetProcessCwds,\n    batchGetProcessStartTimes,\n    enrichProcesses,\n    findWrapperProcess,\n    findWrapperProcessPids,\n    captureProcessSnapshot,\n    filterByProcessNames,\n} from '../../utils/process.js';\n\nvi.mock('child_process', () => ({\n    execFile: vi.fn(),\n    execFileSync: vi.fn(),\n}));\n\nconst mockedExecFileSync = execFileSync as MockedFunction<typeof execFileSync>;\nconst mockedExecFile = execFile as unknown as MockedFunction<(\n    file: string,\n    args: readonly string[],\n    options: object,\n    callback: (error: Error | null, stdout: string, stderr: string) => void,\n) => void>;\n\ndescribe('captureProcessSnapshot', () => {\n    beforeEach(() => {\n        mockedExecFile.mockReset();\n        mockedExecFileSync.mockReset();\n    });\n\n    it('captures and enriches relevant processes without synchronous scans', async () => {\n        mockedExecFile.mockImplementation((file, args, _options, callback) => {\n            queueMicrotask(() => {\n                if (file === 'ps' && args.includes('-axo')) {\n                    callback(null,\n                        '100 1 s001 /usr/bin/claude --resume abc\\n' +\n                        '200 1 s002 C:\\\\\\\\tools\\\\\\\\node.exe C:\\\\\\\\bin\\\\\\\\pi.js\\n' +\n                        '300 1 s003 /usr/bin/unrelated\\n',\n                        '');\n                    return;\n                }\n                if (file === 'lsof') {\n                    callback(null, 'p100\\nn/projects/claude\\np200\\nn/projects/pi\\n', '');\n                    return;\n                }\n                if (file === 'ps' && args.some((arg) => arg.includes('lstart='))) {\n                    callback(null,\n                        '100 Wed Mar 18 23:18:01 2026\\n' +\n                        '200 Thu Mar 19 10:00:00 2026\\n',\n                        '');\n                    return;\n                }\n                callback(new Error(`unexpected command: ${file} ${args.join(' ')}`), '', '');\n            });\n        });\n\n        const snapshot = await captureProcessSnapshot(['claude', 'node']);\n\n        expect(snapshot.map((process) => process.pid)).toEqual([100, 200]);\n        expect(snapshot.map((process) => process.cwd)).toEqual(['/projects/claude', '/projects/pi']);\n        expect(snapshot.map((process) => process.startTime)).toEqual([\n            expect.any(Date),\n            expect.any(Date),\n        ]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n        expect(mockedExecFile.mock.calls.filter(([, args]) => args.includes('-axo'))).toHaveLength(1);\n        for (const [, , options] of mockedExecFile.mock.calls) {\n            expect(options).toMatchObject({ encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });\n            expect(options).not.toHaveProperty('stdio');\n        }\n    });\n});\n\ndescribe('filterByProcessNames', () => {\n    it('matches only argv[0] and normalizes Windows paths and executable suffixes', () => {\n        const processes: ProcessInfo[] = [\n            { pid: 1, command: 'C:\\\\tools\\\\node.exe C:\\\\bin\\\\pi.js', cwd: '', tty: '' },\n            { pid: 2, command: '/usr/local/bin/node /opt/gemini.js', cwd: '', tty: '' },\n            { pid: 3, command: 'codex exec --cd C:\\\\repos\\\\node', cwd: '', tty: '' },\n        ];\n\n        expect(filterByProcessNames(processes, ['node'])).toEqual([processes[0], processes[1]]);\n        expect(filterByProcessNames(processes, ['node.exe'])).toEqual([processes[0], processes[1]]);\n    });\n});\n\ndescribe('listAgentProcesses', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse ps output and post-filter by executable name', () => {\n        mockedExecFileSync.mockReturnValue(\n            '78070     1 s018     claude\\n' +\n            '55106 55100 s015     claude\\n',\n        );\n\n        const processes = listAgentProcesses('claude');\n        expect(processes).toHaveLength(2);\n        expect(processes[0].pid).toBe(78070);\n        expect(processes[0].ppid).toBe(1);\n        expect(processes[0].command).toBe('claude');\n        expect(processes[0].tty).toBe('s018');\n        expect(processes[0].cwd).toBe(''); // not populated yet\n        expect(processes[1].pid).toBe(55106);\n        expect(processes[1].ppid).toBe(55100);\n    });\n\n    it('should filter out non-matching executables', () => {\n        mockedExecFileSync.mockReturnValue(\n            '100 1 s001 claude\\n' +\n            '200 1 s002 claude-helper --pid 100\\n' +\n            '300 1 s003 /usr/bin/claude\\n',\n        );\n\n        const processes = listAgentProcesses('claude');\n        expect(processes).toHaveLength(2);\n        expect(processes.map(p => p.pid)).toEqual([100, 300]);\n    });\n\n    it('should return empty array on command failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        expect(listAgentProcesses('claude')).toEqual([]);\n    });\n\n    it('should handle empty output', () => {\n        mockedExecFileSync.mockReturnValue('');\n        expect(listAgentProcesses('claude')).toEqual([]);\n    });\n\n    it('should reject empty pattern', () => {\n        expect(listAgentProcesses('')).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should reject patterns with shell injection characters', () => {\n        expect(listAgentProcesses('claude; rm -rf /')).toEqual([]);\n        expect(listAgentProcesses(\"claude' || true\")).toEqual([]);\n        expect(listAgentProcesses('$(whoami)')).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should accept valid patterns with dashes and underscores', () => {\n        mockedExecFileSync.mockReturnValue('');\n        listAgentProcesses('claude-code');\n        expect(mockedExecFileSync).toHaveBeenCalledWith(\n            'ps',\n            ['-axo', 'pid=,ppid=,tty=,command='],\n            { encoding: 'utf-8' },\n        );\n\n        mockedExecFileSync.mockReset();\n        mockedExecFileSync.mockReturnValue('');\n        listAgentProcesses('my_agent');\n        expect(mockedExecFileSync).toHaveBeenCalled();\n    });\n});\n\ndescribe('batchGetProcessCwds', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse batched lsof output', () => {\n        mockedExecFileSync.mockReturnValue(\n            'p78070\\nn/Users/user/ai-devkit\\np55106\\nn/Users/user/other-project\\n',\n        );\n\n        const cwds = batchGetProcessCwds([78070, 55106]);\n        expect(cwds.get(78070)).toBe('/Users/user/ai-devkit');\n        expect(cwds.get(55106)).toBe('/Users/user/other-project');\n    });\n\n    it('should return empty map for empty pids', () => {\n        expect(batchGetProcessCwds([])).toEqual(new Map());\n    });\n\n    it('should return partial results when lsof succeeds for some PIDs', () => {\n        // lsof might not return entries for dead processes\n        mockedExecFileSync.mockReturnValue(\n            'p78070\\nn/Users/user/ai-devkit\\n',\n        );\n\n        const cwds = batchGetProcessCwds([78070, 99999]);\n        expect(cwds.size).toBe(1);\n        expect(cwds.get(78070)).toBe('/Users/user/ai-devkit');\n    });\n\n    it('should return empty map on total failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        const cwds = batchGetProcessCwds([78070]);\n        // Falls through to pwdx fallback which also fails\n        expect(cwds.size).toBe(0);\n    });\n});\n\ndescribe('batchGetProcessStartTimes', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should parse ps lstart output', () => {\n        mockedExecFileSync.mockReturnValue(\n            ' 78070 Wed Mar 18 23:18:01 2026\\n' +\n            ' 55106 Mon Mar  9 21:41:42 2026\\n',\n        );\n\n        const times = batchGetProcessStartTimes([78070, 55106]);\n        expect(times.size).toBe(2);\n        expect(times.get(78070)?.getFullYear()).toBe(2026);\n        expect(times.get(55106)?.getMonth()).toBe(2); // March = 2\n    });\n\n    it('should return empty map for empty pids', () => {\n        expect(batchGetProcessStartTimes([])).toEqual(new Map());\n    });\n\n    it('should skip lines with unparseable dates', () => {\n        mockedExecFileSync.mockReturnValue(\n            ' 78070 Wed Mar 18 23:18:01 2026\\n' +\n            ' 99999 INVALID_DATE\\n',\n        );\n\n        const times = batchGetProcessStartTimes([78070, 99999]);\n        expect(times.size).toBe(1);\n        expect(times.has(78070)).toBe(true);\n    });\n\n    it('should return empty map on failure', () => {\n        mockedExecFileSync.mockImplementation(() => { throw new Error('fail'); });\n        expect(batchGetProcessStartTimes([78070])).toEqual(new Map());\n    });\n});\n\ndescribe('enrichProcesses', () => {\n    beforeEach(() => {\n        mockedExecFileSync.mockReset();\n    });\n\n    it('should populate cwd and startTime on processes', () => {\n        // First call: batchGetProcessCwds (lsof)\n        // Second call: batchGetProcessStartTimes (ps lstart)\n        mockedExecFileSync\n            .mockReturnValueOnce('p100\\nn/projects/app\\n')\n            .mockReturnValueOnce(' 100 Wed Mar 18 23:18:01 2026\\n');\n\n        const processes = [\n            { pid: 100, command: 'claude', cwd: '', tty: 's001' },\n        ];\n\n        const enriched = enrichProcesses(processes);\n        expect(enriched[0].cwd).toBe('/projects/app');\n        expect(enriched[0].startTime).toBeDefined();\n    });\n\n    it('should return empty array for empty input', () => {\n        expect(enrichProcesses([])).toEqual([]);\n        expect(mockedExecFileSync).not.toHaveBeenCalled();\n    });\n\n    it('should handle partial failures', () => {\n        // lsof succeeds, ps lstart fails\n        mockedExecFileSync\n            .mockReturnValueOnce('p100\\nn/projects/app\\n')\n            .mockImplementationOnce(() => { throw new Error('fail'); });\n\n        const processes = [\n            { pid: 100, command: 'claude', cwd: '', tty: 's001' },\n        ];\n\n        const enriched = enrichProcesses(processes);\n        expect(enriched[0].cwd).toBe('/projects/app');\n        expect(enriched[0].startTime).toBeUndefined();\n    });\n});\n\ndescribe('wrapper process detection', () => {\n    it('finds the parent wrapper process for a child in the same terminal and cwd', () => {\n        const wrapper = { pid: 100, ppid: 1, command: 'node /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n\n        expect(findWrapperProcess([wrapper, child], child)).toBe(wrapper);\n        expect(findWrapperProcessPids([wrapper, child])).toEqual(new Set([100]));\n    });\n\n    it('does not mark a matched child process as its own wrapper', () => {\n        const child = { pid: 200, ppid: 100, command: 'node --max-old-space-size=8192 /bin/gemini', cwd: '/repo', tty: 'ttys001' };\n\n        expect(findWrapperProcessPids([child], [child])).toEqual(new Set());\n    });\n});\n"],"names":["execFile","execFileSync","listAgentProcesses","batchGetProcessCwds","batchGetProcessStartTimes","enrichProcesses","findWrapperProcess","findWrapperProcessPids","captureProcessSnapshot","filterByProcessNames","vi","mock","fn","mockedExecFileSync","mockedExecFile","describe","beforeEach","mockReset","it","mockImplementation","file","args","_options","callback","queueMicrotask","includes","some","arg","Error","join","snapshot","expect","map","process","pid","toEqual","cwd","startTime","any","Date","not","toHaveBeenCalled","calls","filter","toHaveLength","options","toMatchObject","encoding","maxBuffer","toHaveProperty","processes","command","tty","mockReturnValue","toBe","ppid","p","toHaveBeenCalledWith","cwds","get","Map","size","times","getFullYear","getMonth","has","mockReturnValueOnce","enriched","toBeDefined","mockImplementationOnce","toBeUndefined","wrapper","child","Set"],"mappings":"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"}

package/dist/adapters/AgentAdapter.d.ts

@@ -46,7 +46,7 @@ export interface AgentInfo {
 export interface ProcessInfo {
     /** Process ID */
     pid: number;
-    /** Parent process ID, populated by listAgentProcesses when available */
+    /** Parent process ID, populated by process discovery when available */
     ppid?: number;
     /** Process command */
     command: string;
@@ -54,7 +54,7 @@ export interface ProcessInfo {
     cwd: string;
     /** Terminal TTY (e.g., "ttys030") */
     tty: string;
-    /** Process start time, populated by enrichProcesses */
+    /** Process start time, populated by process enrichment */
     startTime?: Date;
 }
 /**
@@ -120,6 +120,10 @@ export interface ListSessionsOptions {
      */
     type?: AgentType;
 }
+export interface AgentDetectionContext {
+    /** One enriched process snapshot shared across this manager refresh. */
+    readonly processes: readonly ProcessInfo[];
+}
 /**
  * Agent Adapter Interface
  *
@@ -128,11 +132,13 @@ export interface ListSessionsOptions {
 export interface AgentAdapter {
     /** Type of agent this adapter handles */
     readonly type: AgentType;
+    /** Executable basenames required for shared process discovery. */
+    readonly processNames?: readonly string[];
     /**
      * Detect running agents of this type
      * @returns List of detected agents
      */
-    detectAgents(): Promise<AgentInfo[]>;
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
     /**
      * Check if this adapter can handle the given process
      * @param processInfo Process information

package/dist/adapters/AgentAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AgentAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC;AAEjH;;GAEG;AACH,oBAAY,WAAW;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,OAAO,YAAY;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,SAAS,CAAC;IAEhB,qBAAqB;IACrB,MAAM,EAAE,WAAW,CAAC;IAEpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC;IAEjB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IAEZ,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAEhB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+EAA+E;IAC/E,UAAU,EAAE,IAAI,CAAC;IAEjB,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC;IAEhB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE,CAAC;IAEjG;;;;;;;;;OASG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE"}
+{"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AgentAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/AgentAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/AgentAdapter.ts"],"sourcesContent":["/**\n * Agent Adapter Interface\n * \n * Defines the contract for detecting and managing different types of AI agents.\n * Each adapter is responsible for detecting agents of a specific type (e.g., claude).\n */\n\n/**\n * Type of AI agent\n */\nexport type AgentType = 'claude' | 'gemini_cli' | 'grok_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';\n\n/**\n * Current status of an agent\n */\nexport enum AgentStatus {\n    RUNNING = 'running',\n    WAITING = 'waiting',\n    IDLE = 'idle',\n    UNKNOWN = 'unknown'\n}\n\n/**\n * Information about a detected agent\n */\nexport interface AgentInfo {\n    /** Project-based name (e.g., \"ai-devkit\" or \"ai-devkit (merry)\") */\n    name: string;\n\n    /** Type of agent */\n    type: AgentType;\n\n    /** Current status */\n    status: AgentStatus;\n\n    /** Last user prompt from history */\n    summary: string;\n\n    /** Process ID */\n    pid: number;\n\n    /** Working directory/project path */\n    projectPath: string;\n\n    /** Session UUID */\n    sessionId: string;\n\n    /** Timestamp of last activity */\n    lastActive: Date;\n\n    /** Path to the session JSONL file on disk */\n    sessionFilePath?: string;\n}\n\n/**\n * Information about a running process\n */\nexport interface ProcessInfo {\n    /** Process ID */\n    pid: number;\n\n    /** Parent process ID, populated by listAgentProcesses when available */\n    ppid?: number;\n\n    /** Process command */\n    command: string;\n\n    /** Working directory */\n    cwd: string;\n\n    /** Terminal TTY (e.g., \"ttys030\") */\n    tty: string;\n\n    /** Process start time, populated by enrichProcesses */\n    startTime?: Date;\n}\n\n/**\n * A single message in a conversation\n */\nexport interface ConversationMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\n    timestamp?: string;\n}\n\n/**\n * A historical session discovered on disk (running or not).\n *\n * Used by `listSessions` to surface enough context for a user to identify\n * a session and resume it via the originating tool's resume command.\n */\nexport interface SessionSummary {\n    /** Tool that produced this session */\n    type: AgentType;\n\n    /**\n     * ID accepted by the tool's resume command. Adapters MUST pass this\n     * through verbatim — no normalization, no encoding/decoding — so it\n     * round-trips into `claude --resume <id>` (and equivalents).\n     */\n    sessionId: string;\n\n    /** Working directory the session was started in (best-known value) */\n    cwd: string;\n\n    /**\n     * Trimmed first user message; empty string if none. Adapters apply\n     * the same noise-filter their existing parsers use (skip tool_result\n     * blocks, request-interruption notices, system-injected skill\n     * content). The CLI table renderer substitutes a placeholder for\n     * empty values; JSON output keeps the empty string raw.\n     */\n    firstUserMessage: string;\n\n    /** Last activity timestamp (from session content; falls back to file mtime) */\n    lastActive: Date;\n\n    /** Session start time (from session content; falls back to file birthtime/mtime) */\n    startedAt: Date;\n\n    /** Absolute path to the session file on disk (debug/diagnostics) */\n    sessionFilePath: string;\n}\n\n/**\n * Filters passed by the CLI to {@link AgentAdapter.listSessions}.\n *\n * The CLI is the source of truth for filter defaults and semantics\n * (e.g. cwd defaults to process.cwd(); --all clears it). Adapters apply\n * the values they receive — they don't invent defaults.\n */\nexport interface ListSessionsOptions {\n    /**\n     * Filter to sessions whose recorded cwd matches this path using strict\n     * equality (no prefix/ancestor matching in v1). Undefined = no cwd\n     * filter.\n     */\n    cwd?: string;\n\n    /**\n     * Filter to a single tool. Enforced by `AgentManager.listSessions`,\n     * which skips adapters whose `type` doesn't match. Adapters MAY\n     * ignore this field — by the time their `listSessions` runs, the\n     * type filter is already satisfied. Undefined = include every\n     * registered adapter.\n     */\n    type?: AgentType;\n}\n\n/**\n * Agent Adapter Interface\n *\n * Implementations must provide detection logic for a specific agent type.\n */\nexport interface AgentAdapter {\n    /** Type of agent this adapter handles */\n    readonly type: AgentType;\n\n    /**\n     * Detect running agents of this type\n     * @returns List of detected agents\n     */\n    detectAgents(): Promise<AgentInfo[]>;\n\n    /**\n     * Check if this adapter can handle the given process\n     * @param processInfo Process information\n     * @returns True if this adapter can handle the process\n     */\n    canHandle(processInfo: ProcessInfo): boolean;\n\n    /**\n     * Read the full conversation from a session file\n     * @param sessionFilePath Path to the session JSONL file\n     * @param options.verbose Include tool call/result details\n     * @returns Array of conversation messages\n     */\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[];\n\n    /**\n     * Enumerate historical sessions for this tool from disk.\n     *\n     * Applies `opts.cwd` as a strict-equality filter when set. Returns\n     * {@link SessionSummary} entries unsorted; sorting and global filters\n     * are handled by `AgentManager` and the CLI.\n     *\n     * @param opts Filter options computed by the CLI\n     * @returns Array of sessions discovered on disk\n     */\n    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;\n}\n"],"names":["AgentStatus"],"mappings":"AAAA;;;;;CAKC,GAED;;CAEC,GAGD;;CAEC,GACD,OAAO,IAAA,AAAKA,qCAAAA;;;;;WAAAA;MAKX"}
+{"version":3,"sources":["../../src/adapters/AgentAdapter.ts"],"sourcesContent":["/**\n * Agent Adapter Interface\n * \n * Defines the contract for detecting and managing different types of AI agents.\n * Each adapter is responsible for detecting agents of a specific type (e.g., claude).\n */\n\n/**\n * Type of AI agent\n */\nexport type AgentType = 'claude' | 'gemini_cli' | 'grok_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';\n\n/**\n * Current status of an agent\n */\nexport enum AgentStatus {\n    RUNNING = 'running',\n    WAITING = 'waiting',\n    IDLE = 'idle',\n    UNKNOWN = 'unknown'\n}\n\n/**\n * Information about a detected agent\n */\nexport interface AgentInfo {\n    /** Project-based name (e.g., \"ai-devkit\" or \"ai-devkit (merry)\") */\n    name: string;\n\n    /** Type of agent */\n    type: AgentType;\n\n    /** Current status */\n    status: AgentStatus;\n\n    /** Last user prompt from history */\n    summary: string;\n\n    /** Process ID */\n    pid: number;\n\n    /** Working directory/project path */\n    projectPath: string;\n\n    /** Session UUID */\n    sessionId: string;\n\n    /** Timestamp of last activity */\n    lastActive: Date;\n\n    /** Path to the session JSONL file on disk */\n    sessionFilePath?: string;\n}\n\n/**\n * Information about a running process\n */\nexport interface ProcessInfo {\n    /** Process ID */\n    pid: number;\n\n    /** Parent process ID, populated by process discovery when available */\n    ppid?: number;\n\n    /** Process command */\n    command: string;\n\n    /** Working directory */\n    cwd: string;\n\n    /** Terminal TTY (e.g., \"ttys030\") */\n    tty: string;\n\n    /** Process start time, populated by process enrichment */\n    startTime?: Date;\n}\n\n/**\n * A single message in a conversation\n */\nexport interface ConversationMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\n    timestamp?: string;\n}\n\n/**\n * A historical session discovered on disk (running or not).\n *\n * Used by `listSessions` to surface enough context for a user to identify\n * a session and resume it via the originating tool's resume command.\n */\nexport interface SessionSummary {\n    /** Tool that produced this session */\n    type: AgentType;\n\n    /**\n     * ID accepted by the tool's resume command. Adapters MUST pass this\n     * through verbatim — no normalization, no encoding/decoding — so it\n     * round-trips into `claude --resume <id>` (and equivalents).\n     */\n    sessionId: string;\n\n    /** Working directory the session was started in (best-known value) */\n    cwd: string;\n\n    /**\n     * Trimmed first user message; empty string if none. Adapters apply\n     * the same noise-filter their existing parsers use (skip tool_result\n     * blocks, request-interruption notices, system-injected skill\n     * content). The CLI table renderer substitutes a placeholder for\n     * empty values; JSON output keeps the empty string raw.\n     */\n    firstUserMessage: string;\n\n    /** Last activity timestamp (from session content; falls back to file mtime) */\n    lastActive: Date;\n\n    /** Session start time (from session content; falls back to file birthtime/mtime) */\n    startedAt: Date;\n\n    /** Absolute path to the session file on disk (debug/diagnostics) */\n    sessionFilePath: string;\n}\n\n/**\n * Filters passed by the CLI to {@link AgentAdapter.listSessions}.\n *\n * The CLI is the source of truth for filter defaults and semantics\n * (e.g. cwd defaults to process.cwd(); --all clears it). Adapters apply\n * the values they receive — they don't invent defaults.\n */\nexport interface ListSessionsOptions {\n    /**\n     * Filter to sessions whose recorded cwd matches this path using strict\n     * equality (no prefix/ancestor matching in v1). Undefined = no cwd\n     * filter.\n     */\n    cwd?: string;\n\n    /**\n     * Filter to a single tool. Enforced by `AgentManager.listSessions`,\n     * which skips adapters whose `type` doesn't match. Adapters MAY\n     * ignore this field — by the time their `listSessions` runs, the\n     * type filter is already satisfied. Undefined = include every\n     * registered adapter.\n     */\n    type?: AgentType;\n}\n\nexport interface AgentDetectionContext {\n    /** One enriched process snapshot shared across this manager refresh. */\n    readonly processes: readonly ProcessInfo[];\n}\n\n/**\n * Agent Adapter Interface\n *\n * Implementations must provide detection logic for a specific agent type.\n */\nexport interface AgentAdapter {\n    /** Type of agent this adapter handles */\n    readonly type: AgentType;\n\n    /** Executable basenames required for shared process discovery. */\n    readonly processNames?: readonly string[];\n\n    /**\n     * Detect running agents of this type\n     * @returns List of detected agents\n     */\n    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;\n\n    /**\n     * Check if this adapter can handle the given process\n     * @param processInfo Process information\n     * @returns True if this adapter can handle the process\n     */\n    canHandle(processInfo: ProcessInfo): boolean;\n\n    /**\n     * Read the full conversation from a session file\n     * @param sessionFilePath Path to the session JSONL file\n     * @param options.verbose Include tool call/result details\n     * @returns Array of conversation messages\n     */\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[];\n\n    /**\n     * Enumerate historical sessions for this tool from disk.\n     *\n     * Applies `opts.cwd` as a strict-equality filter when set. Returns\n     * {@link SessionSummary} entries unsorted; sorting and global filters\n     * are handled by `AgentManager` and the CLI.\n     *\n     * @param opts Filter options computed by the CLI\n     * @returns Array of sessions discovered on disk\n     */\n    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;\n}\n"],"names":["AgentStatus"],"mappings":"AAAA;;;;;CAKC,GAED;;CAEC,GAGD;;CAEC,GACD,OAAO,IAAA,AAAKA,qCAAAA;;;;;WAAAA;MAKX"}

package/dist/adapters/ClaudeCodeAdapter.d.ts

@@ -1,23 +1,24 @@
-import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions } from './AgentAdapter.js';
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from './AgentAdapter.js';
 /**
  * Claude Code Adapter
  *
  * Detects Claude Code agents by:
- * 1. Finding running claude processes via shared listAgentProcesses()
- * 2. Enriching with CWD and start times via shared enrichProcesses()
+ * 1. Filtering Claude processes from a shared asynchronous process snapshot
+ * 2. Using snapshot CWD and start-time enrichment
  * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json
  * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file
  * 5. Extracting summary from last user message in session JSONL
  */
 export declare class ClaudeCodeAdapter implements AgentAdapter {
     readonly type: "claude";
+    readonly processNames: readonly ["claude"];
     private projectsDir;
     private sessionsDir;
     private parser;
     constructor();
     canHandle(processInfo: ProcessInfo): boolean;
     private isClaudeExecutable;
-    detectAgents(): Promise<AgentInfo[]>;
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
     /**
      * Discover session files for the given processes.
      *

package/dist/adapters/ClaudeCodeAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClaudeCodeAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ClaudeCodeAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACtB,MAAM,mBAAmB,CAAC;AAiD3B;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAsB;;IASpC,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C,OAAO,CAAC,kBAAkB;IAMpB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAmE1C;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,sBAAsB;IAK9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,mBAAmB;IAa3B,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAI1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkCzE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;CAqB/B"}
+{"version":3,"file":"ClaudeCodeAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ClaudeCodeAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAiD3B;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,YAAY,sBAAuB;IAE5C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAsB;;IASpC,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C,OAAO,CAAC,kBAAkB;IAKpB,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqEzE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,sBAAsB;IAK9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,mBAAmB;IAa3B,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAI1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkCzE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;CAqB/B"}