@ai-devkit/agent-manager 0.26.2 → 0.26.3

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"}

package/dist/adapters/ClaudeCodeAdapter.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { AgentStatus } from './AgentAdapter.js';
-import { listAgentProcesses, enrichProcesses } from '../utils/process.js';
+import { captureProcessSnapshot, executableBasename, filterByProcessNames } from '../utils/process.js';
 import { batchGetSessionFileBirthtimes, isDirectory, listJsonl, safeReaddir, safeStat } from '../utils/session.js';
 import { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';
 import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';
@@ -10,13 +10,16 @@ import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.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 class ClaudeCodeAdapter {
     type = 'claude';
+    processNames = [
+        'claude'
+    ];
     projectsDir;
     sessionsDir;
     parser;
@@ -30,12 +33,13 @@ import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';
         return this.isClaudeExecutable(processInfo.command);
     }
     isClaudeExecutable(command) {
-        const executable = command.trim().split(/\s+/)[0] || '';
-        const base = path.basename(executable).toLowerCase();
+        const base = executableBasename(command);
         return base === 'claude' || base === 'claude.exe';
     }
-    async detectAgents() {
-        const processes = enrichProcesses(listAgentProcesses('claude'));
+    async detectAgents(context) {
+        const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
+        const relevant = filterByProcessNames(snapshot, this.processNames);
+        const processes = relevant.filter((process1)=>this.canHandle(process1));
         if (processes.length === 0) {
             return [];
         }

package/dist/adapters/ClaudeCodeAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/ClaudeCodeAdapter.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport type {\n    AgentAdapter,\n    AgentInfo,\n    ProcessInfo,\n    ConversationMessage,\n    SessionSummary,\n    ListSessionsOptions,\n} from './AgentAdapter.js';\nimport { AgentStatus } from './AgentAdapter.js';\nimport { listAgentProcesses, enrichProcesses } from '../utils/process.js';\nimport { batchGetSessionFileBirthtimes, isDirectory, listJsonl, safeReaddir, safeStat } from '../utils/session.js';\nimport type { SessionFile } from '../utils/session.js';\nimport { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';\nimport { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';\nimport type { ClaudeSession } from '../utils/ClaudeSessionParser.js';\n\n/**\n * Entry in ~/.claude/sessions/<pid>.json written by Claude Code.\n * Maps a running process to its session file via PID.\n */\ninterface PidFileEntry {\n    pid: number;\n    sessionId: string;\n    cwd: string;\n    /** Epoch milliseconds when the Claude Code process started */\n    startedAt: number;\n    kind: string;\n    entrypoint: string;\n    /**\n     * Authoritative live status published by the Claude Code process\n     * (e.g., 'running', 'waiting', 'idle'). Preferred over JSONL-derived\n     * status because trailing entries like 'permission-mode' / 'ai-title'\n     * can mask the real conversational state.\n     */\n    status?: string;\n    /** Short description of what the agent is waiting on (e.g., \"approve Read\"). */\n    waitingFor?: string;\n}\n\n/**\n * A process directly matched to a session via PID file (authoritative path).\n *\n * When the matching PID file also exposes live status/waitingFor metadata,\n * those values are carried here so `mapSessionToAgent` can prefer them\n * over the JSONL-derived heuristic.\n */\ninterface DirectMatch {\n    process: ProcessInfo;\n    sessionFile: SessionFile;\n    pidStatus?: AgentStatus;\n    waitingFor?: string;\n}\n\n/** Maximum allowed delta (ms) between process start time and PID file startedAt. */\nconst PID_FILE_STALENESS_MS = 60000;\n\n/**\n * Claude Code Adapter\n *\n * Detects Claude Code agents by:\n * 1. Finding running claude processes via shared listAgentProcesses()\n * 2. Enriching with CWD and start times via shared enrichProcesses()\n * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json\n * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file\n * 5. Extracting summary from last user message in session JSONL\n */\nexport class ClaudeCodeAdapter implements AgentAdapter {\n    readonly type = 'claude' as const;\n\n    private projectsDir: string;\n    private sessionsDir: string;\n    private parser: ClaudeSessionParser;\n\n    constructor() {\n        const homeDir = process.env.HOME || process.env.USERPROFILE || '';\n        this.projectsDir = path.join(homeDir, '.claude', 'projects');\n        this.sessionsDir = path.join(homeDir, '.claude', 'sessions');\n        this.parser = new ClaudeSessionParser();\n    }\n\n    canHandle(processInfo: ProcessInfo): boolean {\n        return this.isClaudeExecutable(processInfo.command);\n    }\n\n    private isClaudeExecutable(command: string): boolean {\n        const executable = command.trim().split(/\\s+/)[0] || '';\n        const base = path.basename(executable).toLowerCase();\n        return base === 'claude' || base === 'claude.exe';\n    }\n\n    async detectAgents(): Promise<AgentInfo[]> {\n        const processes = enrichProcesses(listAgentProcesses('claude'));\n        if (processes.length === 0) {\n            return [];\n        }\n\n        // Step 1: extract `--resume <id>` from command line — authoritative for\n        // resumed sessions where the JSONL predates the process and PID-file/\n        // birthtime heuristics can't match it.\n        const { direct: resumeDirect, fallback: noResume } = this.tryResumeMatching(processes);\n\n        // Step 2: try authoritative PID-file matching for the rest\n        const { direct: pidDirect, fallback } = this.tryPidFileMatching(noResume);\n\n        const direct = [...resumeDirect, ...pidDirect];\n\n        // Step 3: run legacy CWD+birthtime matching only for processes without a PID file\n        const legacySessions = this.discoverSessions(fallback);\n        const legacyMatches =\n            fallback.length > 0 && legacySessions.length > 0\n                ? matchProcessesToSessions(fallback, legacySessions)\n                : [];\n\n        const matchedPids = new Set([\n            ...direct.map((d) => d.process.pid),\n            ...legacyMatches.map((m) => m.process.pid),\n        ]);\n\n        const agents: AgentInfo[] = [];\n\n        // Build agents from direct (resume + PID-file) matches\n        for (const match of direct) {\n            const { process: proc, sessionFile } = match;\n            const sessionData = this.parser.readSession(sessionFile.filePath, sessionFile.resolvedCwd);\n            if (sessionData) {\n                agents.push(this.mapSessionToAgent(sessionData, proc, sessionFile, {\n                    pidStatus: match.pidStatus,\n                    waitingFor: match.waitingFor,\n                }));\n            } else {\n                matchedPids.delete(proc.pid);\n            }\n        }\n\n        // Build agents from legacy matches\n        for (const match of legacyMatches) {\n            const sessionData = this.parser.readSession(\n                match.session.filePath,\n                match.session.resolvedCwd,\n            );\n            if (sessionData) {\n                agents.push(this.mapSessionToAgent(sessionData, match.process, match.session));\n            } else {\n                matchedPids.delete(match.process.pid);\n            }\n        }\n\n        // Any process with no match (direct or legacy) appears as IDLE\n        for (const proc of processes) {\n            if (!matchedPids.has(proc.pid)) {\n                agents.push(this.mapProcessOnlyAgent(proc));\n            }\n        }\n\n        return agents;\n    }\n\n    /**\n     * Discover session files for the given processes.\n     *\n     * For each unique process CWD, encodes it to derive the expected\n     * ~/.claude/projects/<encoded>/ directory, then gets session file birthtimes\n     * via a single batched stat call across all directories.\n     */\n    private discoverSessions(processes: ProcessInfo[]): SessionFile[] {\n        const dirToCwd = new Map<string, string>();\n\n        for (const proc of processes) {\n            if (!proc.cwd) continue;\n\n            const projectDir = this.getProjectDir(proc.cwd);\n            if (dirToCwd.has(projectDir)) continue;\n\n            try {\n                if (!fs.statSync(projectDir).isDirectory()) continue;\n            } catch {\n                continue;\n            }\n\n            dirToCwd.set(projectDir, proc.cwd);\n        }\n\n        if (dirToCwd.size === 0) return [];\n\n        const files = batchGetSessionFileBirthtimes([...dirToCwd.keys()]);\n\n        for (const file of files) {\n            file.resolvedCwd = dirToCwd.get(file.projectDir) || '';\n        }\n\n        return files;\n    }\n\n    /**\n     * Match processes via `claude --resume <uuid>` in their command line.\n     * This works for resumed sessions, where the JSONL was created earlier\n     * (so its birthtime is far from the process startTime and the legacy\n     * matcher can't pair them) and the PID file may also be misaligned.\n     */\n    private tryResumeMatching(processes: ProcessInfo[]): {\n        direct: DirectMatch[];\n        fallback: ProcessInfo[];\n    } {\n        const direct: DirectMatch[] = [];\n        const fallback: ProcessInfo[] = [];\n\n        for (const proc of processes) {\n            const sessionId = this.extractResumeSessionId(proc.command);\n            if (!sessionId || !proc.cwd) {\n                fallback.push(proc);\n                continue;\n            }\n\n            const projectDir = this.getProjectDir(proc.cwd);\n            const jsonlPath = path.join(projectDir, `${sessionId}.jsonl`);\n\n            const stat = safeStat(jsonlPath);\n            if (!stat) {\n                fallback.push(proc);\n                continue;\n            }\n\n            // Best-effort: the PID file (if present for this proc) is the\n            // authoritative source of live status. We still match the session\n            // via --resume, but we read the PID file alongside to capture\n            // status/waitingFor.\n            const pidEntry = this.readMatchingPidFile(proc.pid, proc.startTime);\n\n            direct.push({\n                process: proc,\n                sessionFile: {\n                    sessionId,\n                    filePath: jsonlPath,\n                    projectDir,\n                    birthtimeMs: stat.birthtimeMs,\n                    resolvedCwd: proc.cwd,\n                },\n                pidStatus: this.mapPidStatus(pidEntry?.status),\n                waitingFor: pidEntry?.waitingFor,\n            });\n        }\n\n        return { direct, fallback };\n    }\n\n    private extractResumeSessionId(command: string): string | null {\n        const match = command.match(/--resume\\s+([0-9a-f-]{36})/i);\n        return match?.[1] ?? null;\n    }\n\n    /**\n     * Read and parse ~/.claude/sessions/<pid>.json, returning null on any\n     * I/O / parse failure or when the file is stale relative to the live\n     * process.\n     *\n     * \"Stale\" means the PID file's startedAt diverges from the process's\n     * start time by more than {@link PID_FILE_STALENESS_MS} — typically\n     * a previous Claude Code process recycled the same PID without cleanup.\n     */\n    private readMatchingPidFile(pid: number, procStartTime?: Date): PidFileEntry | null {\n        const pidFilePath = path.join(this.sessionsDir, `${pid}.json`);\n        try {\n            const entry = JSON.parse(\n                fs.readFileSync(pidFilePath, 'utf-8'),\n            ) as PidFileEntry;\n\n            if (procStartTime) {\n                const deltaMs = Math.abs(procStartTime.getTime() - entry.startedAt);\n                if (deltaMs > PID_FILE_STALENESS_MS) {\n                    return null;\n                }\n            }\n\n            return entry;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Map the PID file's live status string to {@link AgentStatus}.\n     *\n     * Returns undefined for missing / unrecognized values so the caller\n     * can fall back to JSONL-derived heuristics.\n     */\n    private mapPidStatus(status: string | undefined): AgentStatus | undefined {\n        switch (status) {\n            case 'running':\n                return AgentStatus.RUNNING;\n            case 'waiting':\n                return AgentStatus.WAITING;\n            case 'idle':\n                return AgentStatus.IDLE;\n            default:\n                return undefined;\n        }\n    }\n\n    /**\n     * Attempt to match each process to its session via ~/.claude/sessions/<pid>.json.\n     *\n     * Returns:\n     *   direct  — processes matched authoritatively via PID file\n     *   fallback — processes with no valid PID file (sent to legacy matching)\n     *\n     * Per-process fallback triggers on: file absent, malformed JSON,\n     * stale startedAt (>60s from proc.startTime), or missing JSONL.\n     */\n    private tryPidFileMatching(processes: ProcessInfo[]): {\n        direct: DirectMatch[];\n        fallback: ProcessInfo[];\n    } {\n        const direct: DirectMatch[] = [];\n        const fallback: ProcessInfo[] = [];\n\n        for (const proc of processes) {\n            const entry = this.readMatchingPidFile(proc.pid, proc.startTime);\n            if (!entry) {\n                fallback.push(proc);\n                continue;\n            }\n\n            const projectDir = this.getProjectDir(entry.cwd);\n            const jsonlPath = path.join(projectDir, `${entry.sessionId}.jsonl`);\n\n            if (!fs.existsSync(jsonlPath)) {\n                fallback.push(proc);\n                continue;\n            }\n\n            direct.push({\n                process: proc,\n                sessionFile: {\n                    sessionId: entry.sessionId,\n                    filePath: jsonlPath,\n                    projectDir,\n                    birthtimeMs: entry.startedAt,\n                    resolvedCwd: entry.cwd,\n                },\n                pidStatus: this.mapPidStatus(entry.status),\n                waitingFor: entry.waitingFor,\n            });\n        }\n\n        return { direct, fallback };\n    }\n\n    /**\n     * Derive the Claude Code project directory for a given CWD.\n     *\n     * Claude Code encodes paths by replacing every non-alphanumeric\n     * character with '-', so '/', '_', '.', spaces, etc. all collapse:\n     *   /Users/foo/bar          → -Users-foo-bar\n     *   /Users/foo/my_project   → -Users-foo-my-project\n     *   /Users/foo/.worktrees/x → -Users-foo--worktrees-x\n     *\n     * The encoding is lossy — multiple real paths can collide on the\n     * same encoded dir. Callers that need to disambiguate must read the\n     * `cwd` field inside each session JSONL.\n     */\n    private getProjectDir(cwd: string): string {\n        const encoded = cwd.replace(/[^a-zA-Z0-9]/g, '-');\n        return path.join(this.projectsDir, encoded);\n    }\n\n    private mapSessionToAgent(\n        session: ClaudeSession,\n        processInfo: ProcessInfo,\n        sessionFile: SessionFile,\n        liveInfo?: { pidStatus?: AgentStatus; waitingFor?: string },\n    ): AgentInfo {\n        // Live PID-file status is authoritative when present — JSONL-derived\n        // status mis-classifies sessions whose latest entry is a UI-state\n        // event like `permission-mode` or `ai-title`.\n        const status = liveInfo?.pidStatus ?? this.parser.determineStatus(session);\n        const baseSummary = session.lastUserMessage || 'Session started';\n        const summary = status === AgentStatus.WAITING && liveInfo?.waitingFor\n            ? `${baseSummary} — waiting for ${liveInfo.waitingFor}`\n            : baseSummary;\n\n        return {\n            name: generateAgentName(processInfo.cwd, processInfo.pid),\n            type: this.type,\n            status,\n            summary,\n            pid: processInfo.pid,\n            projectPath: sessionFile.resolvedCwd || processInfo.cwd || '',\n            sessionId: sessionFile.sessionId,\n            lastActive: session.lastActive,\n            sessionFilePath: sessionFile.filePath,\n        };\n    }\n\n    private mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n        return {\n            name: generateAgentName(processInfo.cwd || '', processInfo.pid),\n            type: this.type,\n            status: AgentStatus.IDLE,\n            summary: 'Unknown',\n            pid: processInfo.pid,\n            projectPath: processInfo.cwd || '',\n            sessionId: `pid-${processInfo.pid}`,\n            lastActive: new Date(),\n        };\n    }\n\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n        return this.parser.getConversation(sessionFilePath, options);\n    }\n\n    async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n        const filterCwd = opts?.cwd;\n        const candidates = this.discoverSessionFiles();\n        const summaries: SessionSummary[] = [];\n\n        for (const { filePath, defaultCwd } of candidates) {\n            const session = this.parser.readSession(filePath, defaultCwd);\n            if (!session) continue;\n\n            // Drop sessions whose JSONL had no parseable conversation entries.\n            // readSession is permissive (returns a shell record even when every\n            // line fails to parse); listSessions needs at least one real entry\n            // so we don't surface garbage files.\n            if (!session.lastEntryType) continue;\n\n            const recordedCwd = session.lastCwd || defaultCwd;\n            if (filterCwd !== undefined && recordedCwd !== filterCwd) continue;\n\n            const stat = safeStat(filePath);\n\n            summaries.push({\n                type: 'claude',\n                sessionId: session.sessionId,\n                cwd: recordedCwd,\n                firstUserMessage: session.firstUserMessage || '',\n                lastActive: session.lastActive ?? stat?.mtime ?? new Date(),\n                startedAt: session.sessionStart ?? stat?.birthtime ?? stat?.mtime ?? new Date(),\n                sessionFilePath: filePath,\n            });\n        }\n\n        return summaries;\n    }\n\n    /**\n     * Discover candidate session files for {@link listSessions}.\n     *\n     * Always walks every subdirectory of `projectsDir`. We can't use the\n     * encoded-dir shortcut for the cwd-scoped path because Claude Code\n     * indexes session files by where the *process was launched*, not by\n     * the recorded `cwd` field inside the session — these diverge in\n     * worktrees and similar setups. The cwd filter is applied later\n     * against `session.lastCwd` so callers see exactly the sessions whose\n     * recorded cwd matches.\n     */\n    private discoverSessionFiles(): Array<{ filePath: string; defaultCwd: string }> {\n        const out: Array<{ filePath: string; defaultCwd: string }> = [];\n\n        if (!isDirectory(this.projectsDir)) return out;\n\n        for (const dirName of safeReaddir(this.projectsDir)) {\n            const projectDir = path.join(this.projectsDir, dirName);\n            if (!isDirectory(projectDir)) continue;\n\n            // Best-effort decode for the rare case session content has no\n            // recorded cwd: '-Users-foo-bar' → '/Users/foo/bar'. Lossy for\n            // paths containing '-'; session content's lastCwd overrides\n            // this when available.\n            const decoded = dirName.replace(/-/g, '/');\n            for (const name of listJsonl(projectDir)) {\n                out.push({ filePath: path.join(projectDir, name), defaultCwd: decoded });\n            }\n        }\n\n        return out;\n    }\n}\n"],"names":["fs","path","AgentStatus","listAgentProcesses","enrichProcesses","batchGetSessionFileBirthtimes","isDirectory","listJsonl","safeReaddir","safeStat","matchProcessesToSessions","generateAgentName","ClaudeSessionParser","PID_FILE_STALENESS_MS","ClaudeCodeAdapter","type","projectsDir","sessionsDir","parser","homeDir","process","env","HOME","USERPROFILE","join","canHandle","processInfo","isClaudeExecutable","command","executable","trim","split","base","basename","toLowerCase","detectAgents","processes","length","direct","resumeDirect","fallback","noResume","tryResumeMatching","pidDirect","tryPidFileMatching","legacySessions","discoverSessions","legacyMatches","matchedPids","Set","map","d","pid","m","agents","match","proc","sessionFile","sessionData","readSession","filePath","resolvedCwd","push","mapSessionToAgent","pidStatus","waitingFor","delete","session","has","mapProcessOnlyAgent","dirToCwd","Map","cwd","projectDir","getProjectDir","statSync","set","size","files","keys","file","get","sessionId","extractResumeSessionId","jsonlPath","stat","pidEntry","readMatchingPidFile","startTime","birthtimeMs","mapPidStatus","status","procStartTime","pidFilePath","entry","JSON","parse","readFileSync","deltaMs","Math","abs","getTime","startedAt","RUNNING","WAITING","IDLE","undefined","existsSync","encoded","replace","liveInfo","determineStatus","baseSummary","lastUserMessage","summary","name","projectPath","lastActive","sessionFilePath","Date","getConversation","options","listSessions","opts","filterCwd","candidates","discoverSessionFiles","summaries","defaultCwd","lastEntryType","recordedCwd","lastCwd","firstUserMessage","mtime","sessionStart","birthtime","out","dirName","decoded"],"mappings":"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"}
+{"version":3,"sources":["../../src/adapters/ClaudeCodeAdapter.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport type {\n    AgentAdapter,\n    AgentInfo,\n    ProcessInfo,\n    ConversationMessage,\n    SessionSummary,\n    ListSessionsOptions,\n    AgentDetectionContext,\n} from './AgentAdapter.js';\nimport { AgentStatus } from './AgentAdapter.js';\nimport { captureProcessSnapshot, executableBasename, filterByProcessNames } from '../utils/process.js';\nimport { batchGetSessionFileBirthtimes, isDirectory, listJsonl, safeReaddir, safeStat } from '../utils/session.js';\nimport type { SessionFile } from '../utils/session.js';\nimport { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';\nimport { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';\nimport type { ClaudeSession } from '../utils/ClaudeSessionParser.js';\n\n/**\n * Entry in ~/.claude/sessions/<pid>.json written by Claude Code.\n * Maps a running process to its session file via PID.\n */\ninterface PidFileEntry {\n    pid: number;\n    sessionId: string;\n    cwd: string;\n    /** Epoch milliseconds when the Claude Code process started */\n    startedAt: number;\n    kind: string;\n    entrypoint: string;\n    /**\n     * Authoritative live status published by the Claude Code process\n     * (e.g., 'running', 'waiting', 'idle'). Preferred over JSONL-derived\n     * status because trailing entries like 'permission-mode' / 'ai-title'\n     * can mask the real conversational state.\n     */\n    status?: string;\n    /** Short description of what the agent is waiting on (e.g., \"approve Read\"). */\n    waitingFor?: string;\n}\n\n/**\n * A process directly matched to a session via PID file (authoritative path).\n *\n * When the matching PID file also exposes live status/waitingFor metadata,\n * those values are carried here so `mapSessionToAgent` can prefer them\n * over the JSONL-derived heuristic.\n */\ninterface DirectMatch {\n    process: ProcessInfo;\n    sessionFile: SessionFile;\n    pidStatus?: AgentStatus;\n    waitingFor?: string;\n}\n\n/** Maximum allowed delta (ms) between process start time and PID file startedAt. */\nconst PID_FILE_STALENESS_MS = 60000;\n\n/**\n * Claude Code Adapter\n *\n * Detects Claude Code agents by:\n * 1. Filtering Claude processes from a shared asynchronous process snapshot\n * 2. Using snapshot CWD and start-time enrichment\n * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json\n * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file\n * 5. Extracting summary from last user message in session JSONL\n */\nexport class ClaudeCodeAdapter implements AgentAdapter {\n    readonly type = 'claude' as const;\n    readonly processNames = ['claude'] as const;\n\n    private projectsDir: string;\n    private sessionsDir: string;\n    private parser: ClaudeSessionParser;\n\n    constructor() {\n        const homeDir = process.env.HOME || process.env.USERPROFILE || '';\n        this.projectsDir = path.join(homeDir, '.claude', 'projects');\n        this.sessionsDir = path.join(homeDir, '.claude', 'sessions');\n        this.parser = new ClaudeSessionParser();\n    }\n\n    canHandle(processInfo: ProcessInfo): boolean {\n        return this.isClaudeExecutable(processInfo.command);\n    }\n\n    private isClaudeExecutable(command: string): boolean {\n        const base = executableBasename(command);\n        return base === 'claude' || base === 'claude.exe';\n    }\n\n    async detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]> {\n        const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);\n        const relevant = filterByProcessNames(snapshot, this.processNames);\n        const processes = relevant.filter((process) => this.canHandle(process));\n        if (processes.length === 0) {\n            return [];\n        }\n\n        // Step 1: extract `--resume <id>` from command line — authoritative for\n        // resumed sessions where the JSONL predates the process and PID-file/\n        // birthtime heuristics can't match it.\n        const { direct: resumeDirect, fallback: noResume } = this.tryResumeMatching(processes);\n\n        // Step 2: try authoritative PID-file matching for the rest\n        const { direct: pidDirect, fallback } = this.tryPidFileMatching(noResume);\n\n        const direct = [...resumeDirect, ...pidDirect];\n\n        // Step 3: run legacy CWD+birthtime matching only for processes without a PID file\n        const legacySessions = this.discoverSessions(fallback);\n        const legacyMatches =\n            fallback.length > 0 && legacySessions.length > 0\n                ? matchProcessesToSessions(fallback, legacySessions)\n                : [];\n\n        const matchedPids = new Set([\n            ...direct.map((d) => d.process.pid),\n            ...legacyMatches.map((m) => m.process.pid),\n        ]);\n\n        const agents: AgentInfo[] = [];\n\n        // Build agents from direct (resume + PID-file) matches\n        for (const match of direct) {\n            const { process: proc, sessionFile } = match;\n            const sessionData = this.parser.readSession(sessionFile.filePath, sessionFile.resolvedCwd);\n            if (sessionData) {\n                agents.push(this.mapSessionToAgent(sessionData, proc, sessionFile, {\n                    pidStatus: match.pidStatus,\n                    waitingFor: match.waitingFor,\n                }));\n            } else {\n                matchedPids.delete(proc.pid);\n            }\n        }\n\n        // Build agents from legacy matches\n        for (const match of legacyMatches) {\n            const sessionData = this.parser.readSession(\n                match.session.filePath,\n                match.session.resolvedCwd,\n            );\n            if (sessionData) {\n                agents.push(this.mapSessionToAgent(sessionData, match.process, match.session));\n            } else {\n                matchedPids.delete(match.process.pid);\n            }\n        }\n\n        // Any process with no match (direct or legacy) appears as IDLE\n        for (const proc of processes) {\n            if (!matchedPids.has(proc.pid)) {\n                agents.push(this.mapProcessOnlyAgent(proc));\n            }\n        }\n\n        return agents;\n    }\n\n    /**\n     * Discover session files for the given processes.\n     *\n     * For each unique process CWD, encodes it to derive the expected\n     * ~/.claude/projects/<encoded>/ directory, then gets session file birthtimes\n     * via a single batched stat call across all directories.\n     */\n    private discoverSessions(processes: ProcessInfo[]): SessionFile[] {\n        const dirToCwd = new Map<string, string>();\n\n        for (const proc of processes) {\n            if (!proc.cwd) continue;\n\n            const projectDir = this.getProjectDir(proc.cwd);\n            if (dirToCwd.has(projectDir)) continue;\n\n            try {\n                if (!fs.statSync(projectDir).isDirectory()) continue;\n            } catch {\n                continue;\n            }\n\n            dirToCwd.set(projectDir, proc.cwd);\n        }\n\n        if (dirToCwd.size === 0) return [];\n\n        const files = batchGetSessionFileBirthtimes([...dirToCwd.keys()]);\n\n        for (const file of files) {\n            file.resolvedCwd = dirToCwd.get(file.projectDir) || '';\n        }\n\n        return files;\n    }\n\n    /**\n     * Match processes via `claude --resume <uuid>` in their command line.\n     * This works for resumed sessions, where the JSONL was created earlier\n     * (so its birthtime is far from the process startTime and the legacy\n     * matcher can't pair them) and the PID file may also be misaligned.\n     */\n    private tryResumeMatching(processes: ProcessInfo[]): {\n        direct: DirectMatch[];\n        fallback: ProcessInfo[];\n    } {\n        const direct: DirectMatch[] = [];\n        const fallback: ProcessInfo[] = [];\n\n        for (const proc of processes) {\n            const sessionId = this.extractResumeSessionId(proc.command);\n            if (!sessionId || !proc.cwd) {\n                fallback.push(proc);\n                continue;\n            }\n\n            const projectDir = this.getProjectDir(proc.cwd);\n            const jsonlPath = path.join(projectDir, `${sessionId}.jsonl`);\n\n            const stat = safeStat(jsonlPath);\n            if (!stat) {\n                fallback.push(proc);\n                continue;\n            }\n\n            // Best-effort: the PID file (if present for this proc) is the\n            // authoritative source of live status. We still match the session\n            // via --resume, but we read the PID file alongside to capture\n            // status/waitingFor.\n            const pidEntry = this.readMatchingPidFile(proc.pid, proc.startTime);\n\n            direct.push({\n                process: proc,\n                sessionFile: {\n                    sessionId,\n                    filePath: jsonlPath,\n                    projectDir,\n                    birthtimeMs: stat.birthtimeMs,\n                    resolvedCwd: proc.cwd,\n                },\n                pidStatus: this.mapPidStatus(pidEntry?.status),\n                waitingFor: pidEntry?.waitingFor,\n            });\n        }\n\n        return { direct, fallback };\n    }\n\n    private extractResumeSessionId(command: string): string | null {\n        const match = command.match(/--resume\\s+([0-9a-f-]{36})/i);\n        return match?.[1] ?? null;\n    }\n\n    /**\n     * Read and parse ~/.claude/sessions/<pid>.json, returning null on any\n     * I/O / parse failure or when the file is stale relative to the live\n     * process.\n     *\n     * \"Stale\" means the PID file's startedAt diverges from the process's\n     * start time by more than {@link PID_FILE_STALENESS_MS} — typically\n     * a previous Claude Code process recycled the same PID without cleanup.\n     */\n    private readMatchingPidFile(pid: number, procStartTime?: Date): PidFileEntry | null {\n        const pidFilePath = path.join(this.sessionsDir, `${pid}.json`);\n        try {\n            const entry = JSON.parse(\n                fs.readFileSync(pidFilePath, 'utf-8'),\n            ) as PidFileEntry;\n\n            if (procStartTime) {\n                const deltaMs = Math.abs(procStartTime.getTime() - entry.startedAt);\n                if (deltaMs > PID_FILE_STALENESS_MS) {\n                    return null;\n                }\n            }\n\n            return entry;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Map the PID file's live status string to {@link AgentStatus}.\n     *\n     * Returns undefined for missing / unrecognized values so the caller\n     * can fall back to JSONL-derived heuristics.\n     */\n    private mapPidStatus(status: string | undefined): AgentStatus | undefined {\n        switch (status) {\n            case 'running':\n                return AgentStatus.RUNNING;\n            case 'waiting':\n                return AgentStatus.WAITING;\n            case 'idle':\n                return AgentStatus.IDLE;\n            default:\n                return undefined;\n        }\n    }\n\n    /**\n     * Attempt to match each process to its session via ~/.claude/sessions/<pid>.json.\n     *\n     * Returns:\n     *   direct  — processes matched authoritatively via PID file\n     *   fallback — processes with no valid PID file (sent to legacy matching)\n     *\n     * Per-process fallback triggers on: file absent, malformed JSON,\n     * stale startedAt (>60s from proc.startTime), or missing JSONL.\n     */\n    private tryPidFileMatching(processes: ProcessInfo[]): {\n        direct: DirectMatch[];\n        fallback: ProcessInfo[];\n    } {\n        const direct: DirectMatch[] = [];\n        const fallback: ProcessInfo[] = [];\n\n        for (const proc of processes) {\n            const entry = this.readMatchingPidFile(proc.pid, proc.startTime);\n            if (!entry) {\n                fallback.push(proc);\n                continue;\n            }\n\n            const projectDir = this.getProjectDir(entry.cwd);\n            const jsonlPath = path.join(projectDir, `${entry.sessionId}.jsonl`);\n\n            if (!fs.existsSync(jsonlPath)) {\n                fallback.push(proc);\n                continue;\n            }\n\n            direct.push({\n                process: proc,\n                sessionFile: {\n                    sessionId: entry.sessionId,\n                    filePath: jsonlPath,\n                    projectDir,\n                    birthtimeMs: entry.startedAt,\n                    resolvedCwd: entry.cwd,\n                },\n                pidStatus: this.mapPidStatus(entry.status),\n                waitingFor: entry.waitingFor,\n            });\n        }\n\n        return { direct, fallback };\n    }\n\n    /**\n     * Derive the Claude Code project directory for a given CWD.\n     *\n     * Claude Code encodes paths by replacing every non-alphanumeric\n     * character with '-', so '/', '_', '.', spaces, etc. all collapse:\n     *   /Users/foo/bar          → -Users-foo-bar\n     *   /Users/foo/my_project   → -Users-foo-my-project\n     *   /Users/foo/.worktrees/x → -Users-foo--worktrees-x\n     *\n     * The encoding is lossy — multiple real paths can collide on the\n     * same encoded dir. Callers that need to disambiguate must read the\n     * `cwd` field inside each session JSONL.\n     */\n    private getProjectDir(cwd: string): string {\n        const encoded = cwd.replace(/[^a-zA-Z0-9]/g, '-');\n        return path.join(this.projectsDir, encoded);\n    }\n\n    private mapSessionToAgent(\n        session: ClaudeSession,\n        processInfo: ProcessInfo,\n        sessionFile: SessionFile,\n        liveInfo?: { pidStatus?: AgentStatus; waitingFor?: string },\n    ): AgentInfo {\n        // Live PID-file status is authoritative when present — JSONL-derived\n        // status mis-classifies sessions whose latest entry is a UI-state\n        // event like `permission-mode` or `ai-title`.\n        const status = liveInfo?.pidStatus ?? this.parser.determineStatus(session);\n        const baseSummary = session.lastUserMessage || 'Session started';\n        const summary = status === AgentStatus.WAITING && liveInfo?.waitingFor\n            ? `${baseSummary} — waiting for ${liveInfo.waitingFor}`\n            : baseSummary;\n\n        return {\n            name: generateAgentName(processInfo.cwd, processInfo.pid),\n            type: this.type,\n            status,\n            summary,\n            pid: processInfo.pid,\n            projectPath: sessionFile.resolvedCwd || processInfo.cwd || '',\n            sessionId: sessionFile.sessionId,\n            lastActive: session.lastActive,\n            sessionFilePath: sessionFile.filePath,\n        };\n    }\n\n    private mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n        return {\n            name: generateAgentName(processInfo.cwd || '', processInfo.pid),\n            type: this.type,\n            status: AgentStatus.IDLE,\n            summary: 'Unknown',\n            pid: processInfo.pid,\n            projectPath: processInfo.cwd || '',\n            sessionId: `pid-${processInfo.pid}`,\n            lastActive: new Date(),\n        };\n    }\n\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[] {\n        return this.parser.getConversation(sessionFilePath, options);\n    }\n\n    async listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]> {\n        const filterCwd = opts?.cwd;\n        const candidates = this.discoverSessionFiles();\n        const summaries: SessionSummary[] = [];\n\n        for (const { filePath, defaultCwd } of candidates) {\n            const session = this.parser.readSession(filePath, defaultCwd);\n            if (!session) continue;\n\n            // Drop sessions whose JSONL had no parseable conversation entries.\n            // readSession is permissive (returns a shell record even when every\n            // line fails to parse); listSessions needs at least one real entry\n            // so we don't surface garbage files.\n            if (!session.lastEntryType) continue;\n\n            const recordedCwd = session.lastCwd || defaultCwd;\n            if (filterCwd !== undefined && recordedCwd !== filterCwd) continue;\n\n            const stat = safeStat(filePath);\n\n            summaries.push({\n                type: 'claude',\n                sessionId: session.sessionId,\n                cwd: recordedCwd,\n                firstUserMessage: session.firstUserMessage || '',\n                lastActive: session.lastActive ?? stat?.mtime ?? new Date(),\n                startedAt: session.sessionStart ?? stat?.birthtime ?? stat?.mtime ?? new Date(),\n                sessionFilePath: filePath,\n            });\n        }\n\n        return summaries;\n    }\n\n    /**\n     * Discover candidate session files for {@link listSessions}.\n     *\n     * Always walks every subdirectory of `projectsDir`. We can't use the\n     * encoded-dir shortcut for the cwd-scoped path because Claude Code\n     * indexes session files by where the *process was launched*, not by\n     * the recorded `cwd` field inside the session — these diverge in\n     * worktrees and similar setups. The cwd filter is applied later\n     * against `session.lastCwd` so callers see exactly the sessions whose\n     * recorded cwd matches.\n     */\n    private discoverSessionFiles(): Array<{ filePath: string; defaultCwd: string }> {\n        const out: Array<{ filePath: string; defaultCwd: string }> = [];\n\n        if (!isDirectory(this.projectsDir)) return out;\n\n        for (const dirName of safeReaddir(this.projectsDir)) {\n            const projectDir = path.join(this.projectsDir, dirName);\n            if (!isDirectory(projectDir)) continue;\n\n            // Best-effort decode for the rare case session content has no\n            // recorded cwd: '-Users-foo-bar' → '/Users/foo/bar'. Lossy for\n            // paths containing '-'; session content's lastCwd overrides\n            // this when available.\n            const decoded = dirName.replace(/-/g, '/');\n            for (const name of listJsonl(projectDir)) {\n                out.push({ filePath: path.join(projectDir, name), defaultCwd: decoded });\n            }\n        }\n\n        return out;\n    }\n}\n"],"names":["fs","path","AgentStatus","captureProcessSnapshot","executableBasename","filterByProcessNames","batchGetSessionFileBirthtimes","isDirectory","listJsonl","safeReaddir","safeStat","matchProcessesToSessions","generateAgentName","ClaudeSessionParser","PID_FILE_STALENESS_MS","ClaudeCodeAdapter","type","processNames","projectsDir","sessionsDir","parser","homeDir","process","env","HOME","USERPROFILE","join","canHandle","processInfo","isClaudeExecutable","command","base","detectAgents","context","snapshot","processes","relevant","filter","length","direct","resumeDirect","fallback","noResume","tryResumeMatching","pidDirect","tryPidFileMatching","legacySessions","discoverSessions","legacyMatches","matchedPids","Set","map","d","pid","m","agents","match","proc","sessionFile","sessionData","readSession","filePath","resolvedCwd","push","mapSessionToAgent","pidStatus","waitingFor","delete","session","has","mapProcessOnlyAgent","dirToCwd","Map","cwd","projectDir","getProjectDir","statSync","set","size","files","keys","file","get","sessionId","extractResumeSessionId","jsonlPath","stat","pidEntry","readMatchingPidFile","startTime","birthtimeMs","mapPidStatus","status","procStartTime","pidFilePath","entry","JSON","parse","readFileSync","deltaMs","Math","abs","getTime","startedAt","RUNNING","WAITING","IDLE","undefined","existsSync","encoded","replace","liveInfo","determineStatus","baseSummary","lastUserMessage","summary","name","projectPath","lastActive","sessionFilePath","Date","getConversation","options","listSessions","opts","filterCwd","candidates","discoverSessionFiles","summaries","defaultCwd","lastEntryType","recordedCwd","lastCwd","firstUserMessage","mtime","sessionStart","birthtime","out","dirName","decoded"],"mappings":"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"}

package/dist/adapters/CodexAdapter.d.ts

@@ -2,18 +2,19 @@
  * Codex Adapter
  *
  * Detects running Codex agents by:
- * 1. Finding running codex processes via shared listAgentProcesses()
- * 2. Enriching with CWD and start times via shared enrichProcesses()
+ * 1. Filtering Codex processes from a shared asynchronous process snapshot
+ * 2. Using snapshot CWD and start-time enrichment
  * 3. Matching exact PID-to-session metadata from ~/.codex/ai-devkit/sessions.json
  * 4. Discovering session files from ~/.codex/sessions/YYYY/MM/DD/ via shared batchGetSessionFileBirthtimes()
  * 5. Setting resolvedCwd from session_meta first line
  * 6. Matching sessions to processes via shared matchProcessesToSessions()
  * 7. Extracting summary from last event entry in session JSONL
  */
-import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions } from './AgentAdapter.js';
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from './AgentAdapter.js';
 import { AgentRegistry } from '../utils/AgentRegistry.js';
 export declare class CodexAdapter implements AgentAdapter {
     readonly type: "codex";
+    readonly processNames: readonly ["codex"];
     private static readonly IDLE_THRESHOLD_MINUTES;
     /** Include session files around process start day to recover long-lived processes. */
     private static readonly PROCESS_START_DAY_WINDOW_DAYS;
@@ -25,7 +26,7 @@ export declare class CodexAdapter implements AgentAdapter {
     /**
      * Detect running Codex agents
      */
-    detectAgents(): Promise<AgentInfo[]>;
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
     private mapSessionMappingMatches;
     private matchFromSessionMapping;
     private readSessionMapping;

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

@@ -1 +1 @@
-{"version":3,"file":"CodexAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/CodexAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACtB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA4D1D,qBAAa,YAAa,YAAW,YAAY;IAC7C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAK;IAE1D,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,QAAQ,GAAE,aAAuC;IAO7D,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAmD1C,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,gBAAgB;IAiCxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAW1B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAwDpB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,iBAAiB;IAMzB;;;;;OAKG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IA8ChG,OAAO,CAAC,qBAAqB;IAwC7B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAYpB,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBzE;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,6BAA6B;IAarC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;CA8D/B"}
+{"version":3,"file":"CodexAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/CodexAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA4D1D,qBAAa,YAAa,YAAW,YAAY;IAC7C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,YAAY,qBAAsB;IAE3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAK;IAE1D,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,QAAQ,GAAE,aAAuC;IAO7D,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C;;OAEG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqDzE,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,gBAAgB;IAiCxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAW1B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAwDpB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,iBAAiB;IAKzB;;;;;OAKG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IA8ChG,OAAO,CAAC,qBAAqB;IAwC7B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAYpB,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBzE;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,6BAA6B;IAarC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;CA8D/B"}

package/dist/adapters/CodexAdapter.js

@@ -2,8 +2,8 @@
  * Codex Adapter
  *
  * Detects running Codex agents by:
- * 1. Finding running codex processes via shared listAgentProcesses()
- * 2. Enriching with CWD and start times via shared enrichProcesses()
+ * 1. Filtering Codex processes from a shared asynchronous process snapshot
+ * 2. Using snapshot CWD and start-time enrichment
  * 3. Matching exact PID-to-session metadata from ~/.codex/ai-devkit/sessions.json
  * 4. Discovering session files from ~/.codex/sessions/YYYY/MM/DD/ via shared batchGetSessionFileBirthtimes()
  * 5. Setting resolvedCwd from session_meta first line
@@ -12,12 +12,15 @@
  */ import * as fs from 'fs';
 import * as path from 'path';
 import { AgentStatus } from './AgentAdapter.js';
-import { listAgentProcesses, enrichProcesses } from '../utils/process.js';
+import { captureProcessSnapshot, executableBasename, filterByProcessNames } from '../utils/process.js';
 import { batchGetSessionFileBirthtimes, isDirectory, safeReadFile, safeReaddir, safeStat } from '../utils/session.js';
 import { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';
 import { AgentRegistry } from '../utils/AgentRegistry.js';
 export class CodexAdapter {
     type = 'codex';
+    processNames = [
+        'codex'
+    ];
     static IDLE_THRESHOLD_MINUTES = 5;
     /** Include session files around process start day to recover long-lived processes. */ static PROCESS_START_DAY_WINDOW_DAYS = 1;
     codexSessionsDir;
@@ -34,8 +37,10 @@ export class CodexAdapter {
     }
     /**
      * Detect running Codex agents
-     */ async detectAgents() {
-        const processes = enrichProcesses(listAgentProcesses('codex'));
+     */ async detectAgents(context) {
+        const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
+        const relevant = filterByProcessNames(snapshot, this.processNames);
+        const processes = relevant.filter((process1)=>this.canHandle(process1));
         if (processes.length === 0) return [];
         const { cachedAgents, remaining } = this.tryRegistryCache(processes);
         if (remaining.length === 0) return cachedAgents;
@@ -495,8 +500,7 @@ export class CodexAdapter {
         return `${value.slice(0, maxLength - 3)}...`;
     }
     isCodexExecutable(command) {
-        const executable = command.trim().split(/\s+/)[0] || '';
-        const base = path.basename(executable).toLowerCase();
+        const base = executableBasename(command);
         return base === 'codex' || base === 'codex.exe';
     }
     /**