@ai-devkit/agent-manager 0.26.2 → 0.26.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/dist/AgentManager.d.ts +5 -2
  2. package/dist/AgentManager.d.ts.map +1 -1
  3. package/dist/AgentManager.js +28 -10
  4. package/dist/AgentManager.js.map +1 -1
  5. package/dist/__tests__/AgentManager.test.js +289 -4
  6. package/dist/__tests__/AgentManager.test.js.map +1 -1
  7. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js +13 -4
  8. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js.map +1 -1
  9. package/dist/__tests__/adapters/CodexAdapter.test.js +13 -4
  10. package/dist/__tests__/adapters/CodexAdapter.test.js.map +1 -1
  11. package/dist/__tests__/adapters/CopilotAdapter.test.js +7 -2
  12. package/dist/__tests__/adapters/CopilotAdapter.test.js.map +1 -1
  13. package/dist/__tests__/adapters/GeminiCliAdapter.test.js +18 -5
  14. package/dist/__tests__/adapters/GeminiCliAdapter.test.js.map +1 -1
  15. package/dist/__tests__/adapters/GrokCliAdapter.test.js +7 -2
  16. package/dist/__tests__/adapters/GrokCliAdapter.test.js.map +1 -1
  17. package/dist/__tests__/adapters/OpenCodeAdapter.test.js +13 -4
  18. package/dist/__tests__/adapters/OpenCodeAdapter.test.js.map +1 -1
  19. package/dist/__tests__/adapters/PiAdapter.test.js +32 -4
  20. package/dist/__tests__/adapters/PiAdapter.test.js.map +1 -1
  21. package/dist/__tests__/utils/AgentRegistry.test.js +140 -0
  22. package/dist/__tests__/utils/AgentRegistry.test.js.map +1 -1
  23. package/dist/__tests__/utils/process.test.js +90 -2
  24. package/dist/__tests__/utils/process.test.js.map +1 -1
  25. package/dist/adapters/AgentAdapter.d.ts +9 -3
  26. package/dist/adapters/AgentAdapter.d.ts.map +1 -1
  27. package/dist/adapters/AgentAdapter.js.map +1 -1
  28. package/dist/adapters/ClaudeCodeAdapter.d.ts +5 -4
  29. package/dist/adapters/ClaudeCodeAdapter.d.ts.map +1 -1
  30. package/dist/adapters/ClaudeCodeAdapter.js +11 -7
  31. package/dist/adapters/ClaudeCodeAdapter.js.map +1 -1
  32. package/dist/adapters/CodexAdapter.d.ts +5 -4
  33. package/dist/adapters/CodexAdapter.d.ts.map +1 -1
  34. package/dist/adapters/CodexAdapter.js +11 -7
  35. package/dist/adapters/CodexAdapter.js.map +1 -1
  36. package/dist/adapters/CopilotAdapter.d.ts +5 -4
  37. package/dist/adapters/CopilotAdapter.d.ts.map +1 -1
  38. package/dist/adapters/CopilotAdapter.js +11 -7
  39. package/dist/adapters/CopilotAdapter.js.map +1 -1
  40. package/dist/adapters/GeminiCliAdapter.d.ts +6 -5
  41. package/dist/adapters/GeminiCliAdapter.d.ts.map +1 -1
  42. package/dist/adapters/GeminiCliAdapter.js +12 -8
  43. package/dist/adapters/GeminiCliAdapter.js.map +1 -1
  44. package/dist/adapters/GrokCliAdapter.d.ts +3 -2
  45. package/dist/adapters/GrokCliAdapter.d.ts.map +1 -1
  46. package/dist/adapters/GrokCliAdapter.js +10 -6
  47. package/dist/adapters/GrokCliAdapter.js.map +1 -1
  48. package/dist/adapters/OpenCodeAdapter.d.ts +5 -4
  49. package/dist/adapters/OpenCodeAdapter.d.ts.map +1 -1
  50. package/dist/adapters/OpenCodeAdapter.js +11 -7
  51. package/dist/adapters/OpenCodeAdapter.js.map +1 -1
  52. package/dist/adapters/PiAdapter.d.ts +3 -2
  53. package/dist/adapters/PiAdapter.d.ts.map +1 -1
  54. package/dist/adapters/PiAdapter.js +12 -9
  55. package/dist/adapters/PiAdapter.js.map +1 -1
  56. package/dist/adapters/index.d.ts +1 -1
  57. package/dist/adapters/index.d.ts.map +1 -1
  58. package/dist/adapters/index.js.map +1 -1
  59. package/dist/database/connection.d.ts +1 -1
  60. package/dist/database/connection.d.ts.map +1 -1
  61. package/dist/database/connection.js +1 -1
  62. package/dist/database/connection.js.map +1 -1
  63. package/dist/index.d.ts +3 -2
  64. package/dist/index.d.ts.map +1 -1
  65. package/dist/index.js +1 -0
  66. package/dist/index.js.map +1 -1
  67. package/dist/utils/AgentRegistry.d.ts +14 -1
  68. package/dist/utils/AgentRegistry.d.ts.map +1 -1
  69. package/dist/utils/AgentRegistry.js +65 -20
  70. package/dist/utils/AgentRegistry.js.map +1 -1
  71. package/dist/utils/index.d.ts +1 -1
  72. package/dist/utils/index.d.ts.map +1 -1
  73. package/dist/utils/index.js +1 -1
  74. package/dist/utils/index.js.map +1 -1
  75. package/dist/utils/process.d.ts +9 -1
  76. package/dist/utils/process.d.ts.map +1 -1
  77. package/dist/utils/process.js +155 -10
  78. package/dist/utils/process.js.map +1 -1
  79. package/package.json +1 -1
  80. package/src/AgentManager.ts +35 -8
  81. package/src/__tests__/AgentManager.test.ts +231 -4
  82. package/src/__tests__/adapters/ClaudeCodeAdapter.test.ts +16 -5
  83. package/src/__tests__/adapters/CodexAdapter.test.ts +16 -5
  84. package/src/__tests__/adapters/CopilotAdapter.test.ts +8 -1
  85. package/src/__tests__/adapters/GeminiCliAdapter.test.ts +20 -4
  86. package/src/__tests__/adapters/GrokCliAdapter.test.ts +8 -1
  87. package/src/__tests__/adapters/OpenCodeAdapter.test.ts +16 -5
  88. package/src/__tests__/adapters/PiAdapter.test.ts +28 -5
  89. package/src/__tests__/utils/AgentRegistry.test.ts +119 -0
  90. package/src/__tests__/utils/process.test.ts +72 -1
  91. package/src/adapters/AgentAdapter.ts +11 -3
  92. package/src/adapters/ClaudeCodeAdapter.ts +10 -7
  93. package/src/adapters/CodexAdapter.ts +10 -7
  94. package/src/adapters/CopilotAdapter.ts +16 -7
  95. package/src/adapters/GeminiCliAdapter.ts +17 -8
  96. package/src/adapters/GrokCliAdapter.ts +9 -6
  97. package/src/adapters/OpenCodeAdapter.ts +10 -7
  98. package/src/adapters/PiAdapter.ts +10 -9
  99. package/src/adapters/index.ts +1 -1
  100. package/src/database/connection.ts +4 -2
  101. package/src/index.ts +3 -1
  102. package/src/utils/AgentRegistry.ts +85 -17
  103. package/src/utils/index.ts +1 -1
  104. package/src/utils/process.ts +160 -10
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../src/__tests__/utils/AgentRegistry.test.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { AgentRegistry, RenameNotFoundError, RenameConflictError, type RegistryEntry } from '../../utils/AgentRegistry.js';\n\nfunction makeEntry(over: Partial<RegistryEntry> = {}): RegistryEntry {\n return {\n name: 'agent1',\n type: 'claude',\n pid: process.pid,\n tmuxSession: 'agent1',\n cwd: '/tmp',\n startedAt: '2026-05-30T00:00:00.000Z',\n sessionId: 'sid-1',\n sessionFilePath: '/tmp/session.jsonl',\n ...over,\n };\n}\n\ndescribe('AgentRegistry', () => {\n let tmpDir: string;\n let regPath: string;\n let registry: AgentRegistry;\n\n beforeEach(() => {\n tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-registry-'));\n regPath = path.join(tmpDir, 'nested', 'agents.json');\n registry = new AgentRegistry(regPath);\n });\n\n afterEach(() => {\n fs.rmSync(tmpDir, { recursive: true, force: true });\n });\n\n describe('register', () => {\n it('creates the SQLite database and parent directory if missing', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n expect(registry.list()[0].name).toBe('agent1');\n });\n\n it('appends a new entry when name is unique', () => {\n registry.register(makeEntry({ name: 'a' }));\n registry.register(makeEntry({ name: 'b', pid: process.ppid }));\n expect(registry.list()).toHaveLength(2);\n });\n\n it('upserts in place when type and pid already exist', () => {\n registry.register(makeEntry({ name: 'a', pid: process.pid }));\n registry.register(makeEntry({ name: 'fallback', pid: process.pid, tmuxSession: '' }));\n const all = registry.list();\n expect(all).toHaveLength(1);\n expect(all[0].pid).toBe(process.pid);\n expect(all[0].name).toBe('a');\n });\n\n it('does not write through the legacy fixed .tmp path', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n\n it('persists session fields', () => {\n registry.register(makeEntry({ sessionId: 'sid-xyz', sessionFilePath: '/foo/bar.jsonl' }));\n const saved = registry.list()[0];\n expect(saved.sessionId).toBe('sid-xyz');\n expect(saved.sessionFilePath).toBe('/foo/bar.jsonl');\n });\n\n it('preserves existing tmuxSession when incoming is empty string', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.register(makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }));\n const saved = registry.lookup('a');\n expect(saved?.tmuxSession).toBe('pinned');\n expect(saved?.pid).toBe(process.pid);\n });\n\n it('lets a managed start entry replace a generated fallback for the same pid', () => {\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n registry.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n expect(registry.lookup('custom-name')?.tmuxSession).toBe('custom-name');\n expect(registry.lookup(`ai-devkit-${process.pid}`)).toBeNull();\n expect(registry.list()).toHaveLength(1);\n });\n });\n\n describe('registerBatch', () => {\n it('is a no-op on empty array', () => {\n registry.registerBatch([]);\n expect(fs.existsSync(regPath)).toBe(false);\n });\n\n it('upserts multiple entries in a single batch', () => {\n registry.registerBatch([\n makeEntry({ name: 'a' }),\n makeEntry({ name: 'b', pid: process.pid + 1 }),\n makeEntry({ name: 'c', pid: process.pid + 2 }),\n ]);\n expect(registry.list()).toHaveLength(3);\n });\n\n it('applies the tmuxSession merge per entry', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.registerBatch([\n makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }),\n makeEntry({ name: 'b', tmuxSession: '', pid: process.pid + 1 }),\n ]);\n expect(registry.lookup('a')?.tmuxSession).toBe('pinned');\n expect(registry.lookup('a')?.pid).toBe(process.pid);\n expect(registry.lookup('b')?.tmuxSession).toBe('');\n });\n\n it('handles concurrent registry instances without duplicate pid rows', () => {\n const other = new AgentRegistry(regPath);\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n other.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n\n expect(registry.list()).toHaveLength(1);\n expect(registry.lookup('custom-name')?.pid).toBe(process.pid);\n });\n });\n\n describe('lookup', () => {\n it('returns null when name not found', () => {\n expect(registry.lookup('missing')).toBeNull();\n });\n\n it('returns the entry when name matches', () => {\n registry.register(makeEntry({ name: 'a' }));\n expect(registry.lookup('a')?.name).toBe('a');\n });\n });\n\n describe('list', () => {\n it('returns empty array when database does not contain entries', () => {\n expect(registry.list()).toEqual([]);\n });\n\n it('ignores existing legacy agents.json entries', () => {\n const legacyEntry = makeEntry({ name: 'legacy', tmuxSession: 'legacy' });\n fs.mkdirSync(path.dirname(regPath), { recursive: true });\n fs.writeFileSync(regPath, JSON.stringify({ entries: [legacyEntry] }), 'utf8');\n\n const legacyRegistry = new AgentRegistry(regPath);\n\n expect(legacyRegistry.lookup('legacy')).toBeNull();\n expect(legacyRegistry.list()).toEqual([]);\n expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n });\n });\n\n describe('isAlive', () => {\n it('returns true for the current process', () => {\n expect(registry.isAlive(makeEntry({ pid: process.pid }))).toBe(true);\n });\n\n it('returns false for a PID that does not exist', () => {\n expect(registry.isAlive(makeEntry({ pid: 999999 }))).toBe(false);\n });\n });\n\n describe('prune', () => {\n it('removes entries whose PIDs are dead', () => {\n registry.register(makeEntry({ name: 'alive', pid: process.pid }));\n registry.register(makeEntry({ name: 'dead', pid: 999999 }));\n registry.prune();\n const remaining = registry.list();\n expect(remaining).toHaveLength(1);\n expect(remaining[0].name).toBe('alive');\n });\n\n it('is a no-op when all entries are alive', () => {\n registry.register(makeEntry({ pid: process.pid }));\n const before = registry.list();\n registry.prune();\n const after = registry.list();\n expect(after).toEqual(before);\n });\n\n it('does nothing when file is missing', () => {\n expect(() => registry.prune()).not.toThrow();\n });\n });\n\n describe('default()', () => {\n it('returns a singleton instance', () => {\n expect(AgentRegistry.default()).toBe(AgentRegistry.default());\n });\n });\n\n describe('rename', () => {\n it('updates the name of an existing entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(registry.lookup('new-name')?.name).toBe('new-name');\n expect(registry.lookup('old-name')).toBeNull();\n });\n\n it('preserves all other fields on the renamed entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid, tmuxSession: 'old-name', cwd: '/my/cwd' }));\n registry.rename('old-name', 'new-name');\n const entry = registry.lookup('new-name');\n expect(entry?.tmuxSession).toBe('old-name');\n expect(entry?.cwd).toBe('/my/cwd');\n expect(entry?.pid).toBe(process.pid);\n });\n\n it('throws RenameNotFoundError when current name does not exist', () => {\n expect(() => registry.rename('ghost', 'new-name')).toThrow(RenameNotFoundError);\n });\n\n it('throws RenameConflictError when new name is already in use by a live entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: process.ppid }));\n expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n });\n\n it('succeeds when new name exists only as a stale (dead) entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: 999999 }));\n expect(() => registry.rename('agent-a', 'agent-b')).not.toThrow();\n expect(registry.lookup('agent-b')?.pid).toBe(process.pid);\n });\n\n it('does not create the legacy fixed .tmp path on rename', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n });\n});\n"],"names":["fs","os","path","AgentRegistry","RenameNotFoundError","RenameConflictError","makeEntry","over","name","type","pid","process","tmuxSession","cwd","startedAt","sessionId","sessionFilePath","describe","tmpDir","regPath","registry","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","it","register","expect","existsSync","replace","toBe","list","ppid","toHaveLength","all","saved","lookup","toBeNull","registerBatch","other","toEqual","legacyEntry","mkdirSync","dirname","writeFileSync","JSON","stringify","entries","legacyRegistry","isAlive","prune","remaining","before","after","not","toThrow","default","rename","entry"],"mappings":"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"}
1
+ {"version":3,"sources":["../../../src/__tests__/utils/AgentRegistry.test.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { AgentRegistry, RenameNotFoundError, RenameConflictError, type RegistryEntry } from '../../utils/AgentRegistry.js';\n\nfunction makeEntry(over: Partial<RegistryEntry> = {}): RegistryEntry {\n return {\n name: 'agent1',\n type: 'claude',\n pid: process.pid,\n tmuxSession: 'agent1',\n cwd: '/tmp',\n startedAt: '2026-05-30T00:00:00.000Z',\n sessionId: 'sid-1',\n sessionFilePath: '/tmp/session.jsonl',\n ...over,\n };\n}\n\ndescribe('AgentRegistry', () => {\n let tmpDir: string;\n let regPath: string;\n let registry: AgentRegistry;\n\n beforeEach(() => {\n tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-registry-'));\n regPath = path.join(tmpDir, 'nested', 'agents.json');\n registry = new AgentRegistry(regPath);\n });\n\n afterEach(() => {\n vi.restoreAllMocks();\n fs.rmSync(tmpDir, { recursive: true, force: true });\n });\n\n describe('register', () => {\n it('creates the SQLite database and parent directory if missing', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n expect(registry.list()[0].name).toBe('agent1');\n });\n\n it('appends a new entry when name is unique', () => {\n registry.register(makeEntry({ name: 'a' }));\n registry.register(makeEntry({ name: 'b', pid: process.ppid }));\n expect(registry.list()).toHaveLength(2);\n });\n\n it('upserts in place when type and pid already exist', () => {\n registry.register(makeEntry({ name: 'a', pid: process.pid }));\n registry.register(makeEntry({ name: 'fallback', pid: process.pid, tmuxSession: '' }));\n const all = registry.list();\n expect(all).toHaveLength(1);\n expect(all[0].pid).toBe(process.pid);\n expect(all[0].name).toBe('a');\n });\n\n it('does not write through the legacy fixed .tmp path', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n\n it('persists session fields', () => {\n registry.register(makeEntry({ sessionId: 'sid-xyz', sessionFilePath: '/foo/bar.jsonl' }));\n const saved = registry.list()[0];\n expect(saved.sessionId).toBe('sid-xyz');\n expect(saved.sessionFilePath).toBe('/foo/bar.jsonl');\n });\n\n it('preserves existing tmuxSession when incoming is empty string', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.register(makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }));\n const saved = registry.lookup('a');\n expect(saved?.tmuxSession).toBe('pinned');\n expect(saved?.pid).toBe(process.pid);\n });\n\n it('lets a managed start entry replace a generated fallback for the same pid', () => {\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n registry.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n expect(registry.lookup('custom-name')?.tmuxSession).toBe('custom-name');\n expect(registry.lookup(`ai-devkit-${process.pid}`)).toBeNull();\n expect(registry.list()).toHaveLength(1);\n });\n\n it('preserves an existing name conflict when its probe fails with EPERM', () => {\n registry.register(makeEntry({ name: 'claimed-name', pid: process.pid }));\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('operation not permitted'), { code: 'EPERM' });\n });\n\n expect(() => registry.register(makeEntry({\n name: 'claimed-name',\n pid: process.pid + 1,\n }))).toThrow();\n expect(registry.lookup('claimed-name')?.pid).toBe(process.pid);\n });\n });\n\n describe('registerBatch', () => {\n it('is a no-op on empty array', () => {\n registry.registerBatch([]);\n expect(fs.existsSync(regPath)).toBe(false);\n });\n\n it('upserts multiple entries in a single batch', () => {\n registry.registerBatch([\n makeEntry({ name: 'a' }),\n makeEntry({ name: 'b', pid: process.pid + 1 }),\n makeEntry({ name: 'c', pid: process.pid + 2 }),\n ]);\n expect(registry.list()).toHaveLength(3);\n });\n\n it('applies the tmuxSession merge per entry', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.registerBatch([\n makeEntry({ name: 'fallback', tmuxSession: '', pid: process.pid }),\n makeEntry({ name: 'b', tmuxSession: '', pid: process.pid + 1 }),\n ]);\n expect(registry.lookup('a')?.tmuxSession).toBe('pinned');\n expect(registry.lookup('a')?.pid).toBe(process.pid);\n expect(registry.lookup('b')?.tmuxSession).toBe('');\n });\n\n it('handles concurrent registry instances without duplicate pid rows', () => {\n const other = new AgentRegistry(regPath);\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n other.register(makeEntry({ name: 'custom-name', tmuxSession: 'custom-name' }));\n registry.register(makeEntry({ name: `ai-devkit-${process.pid}`, tmuxSession: '' }));\n\n expect(registry.list()).toHaveLength(1);\n expect(registry.lookup('custom-name')?.pid).toBe(process.pid);\n });\n\n it('cleans up a cross-type row when its pid has been reused', () => {\n registry.register(makeEntry({ name: 'old-claude', type: 'claude', pid: process.pid }));\n\n registry.register(makeEntry({\n name: 'new-codex',\n type: 'codex',\n pid: process.pid,\n tmuxSession: '',\n }));\n\n expect(registry.lookup('old-claude')).toBeNull();\n expect(registry.lookup('new-codex')).toMatchObject({ type: 'codex', pid: process.pid });\n expect(registry.list()).toHaveLength(1);\n });\n\n it('rolls back the whole batch when a live name conflict rejects one entry', () => {\n registry.register(makeEntry({ name: 'taken', pid: process.pid }));\n\n expect(() => registry.registerBatch([\n makeEntry({ name: 'fresh', pid: 999998 }),\n makeEntry({ name: 'taken', type: 'codex', pid: 999997 }),\n ])).toThrow(/UNIQUE constraint failed/);\n\n expect(registry.lookup('fresh')).toBeNull();\n expect(registry.lookup('taken')?.pid).toBe(process.pid);\n });\n });\n\n describe('lookup', () => {\n it('returns null when name not found', () => {\n expect(registry.lookup('missing')).toBeNull();\n });\n\n it('returns the entry when name matches', () => {\n registry.register(makeEntry({ name: 'a' }));\n expect(registry.lookup('a')?.name).toBe('a');\n });\n });\n\n describe('list', () => {\n it('returns empty array when database does not contain entries', () => {\n expect(registry.list()).toEqual([]);\n });\n\n it('ignores existing legacy agents.json entries', () => {\n const legacyEntry = makeEntry({ name: 'legacy', tmuxSession: 'legacy' });\n fs.mkdirSync(path.dirname(regPath), { recursive: true });\n fs.writeFileSync(regPath, JSON.stringify({ entries: [legacyEntry] }), 'utf8');\n\n const legacyRegistry = new AgentRegistry(regPath);\n\n expect(legacyRegistry.lookup('legacy')).toBeNull();\n expect(legacyRegistry.list()).toEqual([]);\n expect(fs.existsSync(regPath.replace(/\\.json$/, '.db'))).toBe(true);\n });\n });\n\n describe('isAlive', () => {\n it('returns true for the current process', () => {\n expect(registry.isAlive(makeEntry({ pid: process.pid }))).toBe(true);\n });\n\n it('returns false for a PID that does not exist', () => {\n expect(registry.isAlive(makeEntry({ pid: 999999 }))).toBe(false);\n });\n\n it('returns true when the process probe is forbidden with EPERM', () => {\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('operation not permitted'), { code: 'EPERM' });\n });\n\n expect(registry.isAlive(makeEntry())).toBe(true);\n });\n\n it('returns false when the process probe reports ESRCH', () => {\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('no such process'), { code: 'ESRCH' });\n });\n\n expect(registry.isAlive(makeEntry())).toBe(false);\n });\n\n it('returns true when the process probe fails without a definitive error code', () => {\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw new Error('indeterminate probe failure');\n });\n\n expect(registry.isAlive(makeEntry())).toBe(true);\n });\n });\n\n describe('prune', () => {\n it('removes entries whose PIDs are dead', () => {\n registry.register(makeEntry({ name: 'alive', pid: process.pid }));\n registry.register(makeEntry({ name: 'dead', pid: 999999 }));\n registry.prune();\n const remaining = registry.list();\n expect(remaining).toHaveLength(1);\n expect(remaining[0].name).toBe('alive');\n });\n\n it('is a no-op when all entries are alive', () => {\n registry.register(makeEntry({ pid: process.pid }));\n const before = registry.list();\n registry.prune();\n const after = registry.list();\n expect(after).toEqual(before);\n });\n\n it('preserves entries when liveness probing fails with EPERM', () => {\n registry.register(makeEntry({ name: 'custom-name', tmuxSession: 'tmux-custom' }));\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('operation not permitted'), { code: 'EPERM' });\n });\n\n registry.prune();\n\n expect(registry.lookup('custom-name')).toMatchObject({\n name: 'custom-name',\n tmuxSession: 'tmux-custom',\n });\n });\n\n it('removes entries when liveness probing fails with ESRCH', () => {\n registry.register(makeEntry({ name: 'dead' }));\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('no such process'), { code: 'ESRCH' });\n });\n\n registry.prune();\n\n expect(registry.lookup('dead')).toBeNull();\n });\n\n it('does nothing when file is missing', () => {\n expect(() => registry.prune()).not.toThrow();\n });\n\n it('keeps forced prune available before the passive cadence is due', () => {\n let nowMs = Date.parse('2026-08-14T10:00:00.000Z');\n const clocked = new AgentRegistry(regPath, {\n now: () => new Date(nowMs),\n pruneIntervalMs: 30_000,\n });\n clocked.register(makeEntry({ name: 'forced', pid: process.pid }));\n const alive = vi.spyOn(clocked, 'isAlive').mockReturnValue(true);\n clocked.pruneIfDue();\n alive.mockReturnValue(false);\n nowMs += 1;\n\n clocked.prune();\n\n expect(alive).toHaveBeenCalledTimes(2);\n expect(clocked.lookup('forced')).toBeNull();\n });\n });\n\n describe('default()', () => {\n it('returns a singleton instance', () => {\n expect(AgentRegistry.default()).toBe(AgentRegistry.default());\n });\n });\n\n describe('rename', () => {\n it('updates the name of an existing entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(registry.lookup('new-name')?.name).toBe('new-name');\n expect(registry.lookup('old-name')).toBeNull();\n });\n\n it('preserves all other fields on the renamed entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid, tmuxSession: 'old-name', cwd: '/my/cwd' }));\n registry.rename('old-name', 'new-name');\n const entry = registry.lookup('new-name');\n expect(entry?.tmuxSession).toBe('old-name');\n expect(entry?.cwd).toBe('/my/cwd');\n expect(entry?.pid).toBe(process.pid);\n });\n\n it('throws RenameNotFoundError when current name does not exist', () => {\n expect(() => registry.rename('ghost', 'new-name')).toThrow(RenameNotFoundError);\n });\n\n it('throws RenameConflictError when new name is already in use by a live entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: process.ppid }));\n expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n });\n\n it('throws RenameConflictError when the conflicting entry probe fails with EPERM', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: process.ppid }));\n vi.spyOn(process, 'kill').mockImplementation(() => {\n throw Object.assign(new Error('operation not permitted'), { code: 'EPERM' });\n });\n\n expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n expect(registry.lookup('agent-b')?.pid).toBe(process.ppid);\n });\n\n it('succeeds when new name exists only as a stale (dead) entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: 999999 }));\n expect(() => registry.rename('agent-a', 'agent-b')).not.toThrow();\n expect(registry.lookup('agent-b')?.pid).toBe(process.pid);\n });\n\n it('does not create the legacy fixed .tmp path on rename', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n });\n});\n"],"names":["fs","os","path","AgentRegistry","RenameNotFoundError","RenameConflictError","makeEntry","over","name","type","pid","process","tmuxSession","cwd","startedAt","sessionId","sessionFilePath","describe","tmpDir","regPath","registry","beforeEach","mkdtempSync","join","tmpdir","afterEach","vi","restoreAllMocks","rmSync","recursive","force","it","register","expect","existsSync","replace","toBe","list","ppid","toHaveLength","all","saved","lookup","toBeNull","spyOn","mockImplementation","Object","assign","Error","code","toThrow","registerBatch","other","toMatchObject","toEqual","legacyEntry","mkdirSync","dirname","writeFileSync","JSON","stringify","entries","legacyRegistry","isAlive","prune","remaining","before","after","not","nowMs","Date","parse","clocked","now","pruneIntervalMs","alive","mockReturnValue","pruneIfDue","toHaveBeenCalledTimes","default","rename","entry"],"mappings":"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"}
@@ -1,11 +1,99 @@
1
1
  /**
2
2
  * Tests for new functions in utils/process.ts
3
- */ import { execFileSync } from 'child_process';
4
- import { listAgentProcesses, batchGetProcessCwds, batchGetProcessStartTimes, enrichProcesses, findWrapperProcess, findWrapperProcessPids } from '../../utils/process.js';
3
+ */ import { execFile, execFileSync } from 'child_process';
4
+ import { listAgentProcesses, batchGetProcessCwds, batchGetProcessStartTimes, enrichProcesses, findWrapperProcess, findWrapperProcessPids, captureProcessSnapshot, filterByProcessNames } from '../../utils/process.js';
5
5
  vi.mock('child_process', ()=>({
6
+ execFile: vi.fn(),
6
7
  execFileSync: vi.fn()
7
8
  }));
8
9
  const mockedExecFileSync = execFileSync;
10
+ const mockedExecFile = execFile;
11
+ describe('captureProcessSnapshot', ()=>{
12
+ beforeEach(()=>{
13
+ mockedExecFile.mockReset();
14
+ mockedExecFileSync.mockReset();
15
+ });
16
+ it('captures and enriches relevant processes without synchronous scans', async ()=>{
17
+ mockedExecFile.mockImplementation((file, args, _options, callback)=>{
18
+ queueMicrotask(()=>{
19
+ if (file === 'ps' && args.includes('-axo')) {
20
+ callback(null, '100 1 s001 /usr/bin/claude --resume abc\n' + '200 1 s002 C:\\\\tools\\\\node.exe C:\\\\bin\\\\pi.js\n' + '300 1 s003 /usr/bin/unrelated\n', '');
21
+ return;
22
+ }
23
+ if (file === 'lsof') {
24
+ callback(null, 'p100\nn/projects/claude\np200\nn/projects/pi\n', '');
25
+ return;
26
+ }
27
+ if (file === 'ps' && args.some((arg)=>arg.includes('lstart='))) {
28
+ callback(null, '100 Wed Mar 18 23:18:01 2026\n' + '200 Thu Mar 19 10:00:00 2026\n', '');
29
+ return;
30
+ }
31
+ callback(new Error(`unexpected command: ${file} ${args.join(' ')}`), '', '');
32
+ });
33
+ });
34
+ const snapshot = await captureProcessSnapshot([
35
+ 'claude',
36
+ 'node'
37
+ ]);
38
+ expect(snapshot.map((process)=>process.pid)).toEqual([
39
+ 100,
40
+ 200
41
+ ]);
42
+ expect(snapshot.map((process)=>process.cwd)).toEqual([
43
+ '/projects/claude',
44
+ '/projects/pi'
45
+ ]);
46
+ expect(snapshot.map((process)=>process.startTime)).toEqual([
47
+ expect.any(Date),
48
+ expect.any(Date)
49
+ ]);
50
+ expect(mockedExecFileSync).not.toHaveBeenCalled();
51
+ expect(mockedExecFile.mock.calls.filter(([, args])=>args.includes('-axo'))).toHaveLength(1);
52
+ for (const [, , options] of mockedExecFile.mock.calls){
53
+ expect(options).toMatchObject({
54
+ encoding: 'utf-8',
55
+ maxBuffer: 10 * 1024 * 1024
56
+ });
57
+ expect(options).not.toHaveProperty('stdio');
58
+ }
59
+ });
60
+ });
61
+ describe('filterByProcessNames', ()=>{
62
+ it('matches only argv[0] and normalizes Windows paths and executable suffixes', ()=>{
63
+ const processes = [
64
+ {
65
+ pid: 1,
66
+ command: 'C:\\tools\\node.exe C:\\bin\\pi.js',
67
+ cwd: '',
68
+ tty: ''
69
+ },
70
+ {
71
+ pid: 2,
72
+ command: '/usr/local/bin/node /opt/gemini.js',
73
+ cwd: '',
74
+ tty: ''
75
+ },
76
+ {
77
+ pid: 3,
78
+ command: 'codex exec --cd C:\\repos\\node',
79
+ cwd: '',
80
+ tty: ''
81
+ }
82
+ ];
83
+ expect(filterByProcessNames(processes, [
84
+ 'node'
85
+ ])).toEqual([
86
+ processes[0],
87
+ processes[1]
88
+ ]);
89
+ expect(filterByProcessNames(processes, [
90
+ 'node.exe'
91
+ ])).toEqual([
92
+ processes[0],
93
+ processes[1]
94
+ ]);
95
+ });
96
+ });
9
97
  describe('listAgentProcesses', ()=>{
10
98
  beforeEach(()=>{
11
99
  mockedExecFileSync.mockReset();
@@ -1 +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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"}
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 { 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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"}
@@ -46,7 +46,7 @@ export interface AgentInfo {
46
46
  export interface ProcessInfo {
47
47
  /** Process ID */
48
48
  pid: number;
49
- /** Parent process ID, populated by listAgentProcesses when available */
49
+ /** Parent process ID, populated by process discovery when available */
50
50
  ppid?: number;
51
51
  /** Process command */
52
52
  command: string;
@@ -54,7 +54,7 @@ export interface ProcessInfo {
54
54
  cwd: string;
55
55
  /** Terminal TTY (e.g., "ttys030") */
56
56
  tty: string;
57
- /** Process start time, populated by enrichProcesses */
57
+ /** Process start time, populated by process enrichment */
58
58
  startTime?: Date;
59
59
  }
60
60
  /**
@@ -120,6 +120,10 @@ export interface ListSessionsOptions {
120
120
  */
121
121
  type?: AgentType;
122
122
  }
123
+ export interface AgentDetectionContext {
124
+ /** One enriched process snapshot shared across this manager refresh. */
125
+ readonly processes: readonly ProcessInfo[];
126
+ }
123
127
  /**
124
128
  * Agent Adapter Interface
125
129
  *
@@ -128,11 +132,13 @@ export interface ListSessionsOptions {
128
132
  export interface AgentAdapter {
129
133
  /** Type of agent this adapter handles */
130
134
  readonly type: AgentType;
135
+ /** Executable basenames required for shared process discovery. */
136
+ readonly processNames?: readonly string[];
131
137
  /**
132
138
  * Detect running agents of this type
133
139
  * @returns List of detected agents
134
140
  */
135
- detectAgents(): Promise<AgentInfo[]>;
141
+ detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
136
142
  /**
137
143
  * Check if this adapter can handle the given process
138
144
  * @param processInfo Process information
@@ -1 +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"}
1
+ {"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AgentAdapter.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
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 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"}
@@ -1,23 +1,24 @@
1
- import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions } from './AgentAdapter.js';
1
+ import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions, AgentDetectionContext } from './AgentAdapter.js';
2
2
  /**
3
3
  * Claude Code Adapter
4
4
  *
5
5
  * Detects Claude Code agents by:
6
- * 1. Finding running claude processes via shared listAgentProcesses()
7
- * 2. Enriching with CWD and start times via shared enrichProcesses()
6
+ * 1. Filtering Claude processes from a shared asynchronous process snapshot
7
+ * 2. Using snapshot CWD and start-time enrichment
8
8
  * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json
9
9
  * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file
10
10
  * 5. Extracting summary from last user message in session JSONL
11
11
  */
12
12
  export declare class ClaudeCodeAdapter implements AgentAdapter {
13
13
  readonly type: "claude";
14
+ readonly processNames: readonly ["claude"];
14
15
  private projectsDir;
15
16
  private sessionsDir;
16
17
  private parser;
17
18
  constructor();
18
19
  canHandle(processInfo: ProcessInfo): boolean;
19
20
  private isClaudeExecutable;
20
- detectAgents(): Promise<AgentInfo[]>;
21
+ detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
21
22
  /**
22
23
  * Discover session files for the given processes.
23
24
  *
@@ -1 +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"}
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,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"}
@@ -1,7 +1,7 @@
1
1
  import * as fs from 'fs';
2
2
  import * as path from 'path';
3
3
  import { AgentStatus } from './AgentAdapter.js';
4
- import { listAgentProcesses, enrichProcesses } from '../utils/process.js';
4
+ import { captureProcessSnapshot, executableBasename, filterByProcessNames } from '../utils/process.js';
5
5
  import { batchGetSessionFileBirthtimes, isDirectory, listJsonl, safeReaddir, safeStat } from '../utils/session.js';
6
6
  import { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';
7
7
  import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';
@@ -10,13 +10,16 @@ import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';
10
10
  * Claude Code Adapter
11
11
  *
12
12
  * Detects Claude Code agents by:
13
- * 1. Finding running claude processes via shared listAgentProcesses()
14
- * 2. Enriching with CWD and start times via shared enrichProcesses()
13
+ * 1. Filtering Claude processes from a shared asynchronous process snapshot
14
+ * 2. Using snapshot CWD and start-time enrichment
15
15
  * 3. Attempting authoritative PID-file matching via ~/.claude/sessions/<pid>.json
16
16
  * 4. Falling back to CWD+birthtime heuristic (matchProcessesToSessions) for processes without a PID file
17
17
  * 5. Extracting summary from last user message in session JSONL
18
18
  */ export class ClaudeCodeAdapter {
19
19
  type = 'claude';
20
+ processNames = [
21
+ 'claude'
22
+ ];
20
23
  projectsDir;
21
24
  sessionsDir;
22
25
  parser;
@@ -30,12 +33,13 @@ import { ClaudeSessionParser } from '../utils/ClaudeSessionParser.js';
30
33
  return this.isClaudeExecutable(processInfo.command);
31
34
  }
32
35
  isClaudeExecutable(command) {
33
- const executable = command.trim().split(/\s+/)[0] || '';
34
- const base = path.basename(executable).toLowerCase();
36
+ const base = executableBasename(command);
35
37
  return base === 'claude' || base === 'claude.exe';
36
38
  }
37
- async detectAgents() {
38
- const processes = enrichProcesses(listAgentProcesses('claude'));
39
+ async detectAgents(context) {
40
+ const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
41
+ const relevant = filterByProcessNames(snapshot, this.processNames);
42
+ const processes = relevant.filter((process1)=>this.canHandle(process1));
39
43
  if (processes.length === 0) {
40
44
  return [];
41
45
  }