@ai-devkit/agent-manager 0.26.0 → 0.26.2

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 (37) hide show
  1. package/dist/__tests__/AgentManager.test.js +37 -0
  2. package/dist/__tests__/AgentManager.test.js.map +1 -1
  3. package/dist/__tests__/adapters/CodexAdapter.test.js +249 -0
  4. package/dist/__tests__/adapters/CodexAdapter.test.js.map +1 -1
  5. package/dist/__tests__/utils/AgentRegistry.test.js +68 -46
  6. package/dist/__tests__/utils/AgentRegistry.test.js.map +1 -1
  7. package/dist/adapters/CodexAdapter.d.ts +9 -1
  8. package/dist/adapters/CodexAdapter.d.ts.map +1 -1
  9. package/dist/adapters/CodexAdapter.js +106 -24
  10. package/dist/adapters/CodexAdapter.js.map +1 -1
  11. package/dist/database/connection.d.ts +22 -0
  12. package/dist/database/connection.d.ts.map +1 -0
  13. package/dist/database/connection.js +58 -0
  14. package/dist/database/connection.js.map +1 -0
  15. package/dist/database/index.d.ts +4 -0
  16. package/dist/database/index.d.ts.map +1 -0
  17. package/dist/database/index.js +4 -0
  18. package/dist/database/index.js.map +1 -0
  19. package/dist/database/migrations/001_initial.sql +12 -0
  20. package/dist/database/schema.d.ts +4 -0
  21. package/dist/database/schema.d.ts.map +1 -0
  22. package/dist/database/schema.js +47 -0
  23. package/dist/database/schema.js.map +1 -0
  24. package/dist/utils/AgentRegistry.d.ts +7 -3
  25. package/dist/utils/AgentRegistry.d.ts.map +1 -1
  26. package/dist/utils/AgentRegistry.js +108 -57
  27. package/dist/utils/AgentRegistry.js.map +1 -1
  28. package/package.json +2 -2
  29. package/src/__tests__/AgentManager.test.ts +37 -0
  30. package/src/__tests__/adapters/CodexAdapter.test.ts +155 -0
  31. package/src/__tests__/utils/AgentRegistry.test.ts +48 -40
  32. package/src/adapters/CodexAdapter.ts +147 -27
  33. package/src/database/connection.ts +74 -0
  34. package/src/database/index.ts +7 -0
  35. package/src/database/migrations/001_initial.sql +12 -0
  36. package/src/database/schema.ts +62 -0
  37. package/src/utils/AgentRegistry.ts +109 -49
@@ -31,36 +31,37 @@ describe('AgentRegistry', ()=>{
31
31
  });
32
32
  });
33
33
  describe('register', ()=>{
34
- it('creates the file and parent directory if missing', ()=>{
34
+ it('creates the SQLite database and parent directory if missing', ()=>{
35
35
  registry.register(makeEntry());
36
- expect(fs.existsSync(regPath)).toBe(true);
37
- const parsed = JSON.parse(fs.readFileSync(regPath, 'utf8'));
38
- expect(parsed.entries).toHaveLength(1);
39
- expect(parsed.entries[0].name).toBe('agent1');
36
+ expect(fs.existsSync(regPath.replace(/\.json$/, '.db'))).toBe(true);
37
+ expect(registry.list()[0].name).toBe('agent1');
40
38
  });
41
39
  it('appends a new entry when name is unique', ()=>{
42
40
  registry.register(makeEntry({
43
41
  name: 'a'
44
42
  }));
45
43
  registry.register(makeEntry({
46
- name: 'b'
44
+ name: 'b',
45
+ pid: process.ppid
47
46
  }));
48
47
  expect(registry.list()).toHaveLength(2);
49
48
  });
50
- it('upserts in place when name already exists', ()=>{
49
+ it('upserts in place when type and pid already exist', ()=>{
51
50
  registry.register(makeEntry({
52
51
  name: 'a',
53
- pid: 100
52
+ pid: process.pid
54
53
  }));
55
54
  registry.register(makeEntry({
56
- name: 'a',
57
- pid: 200
55
+ name: 'fallback',
56
+ pid: process.pid,
57
+ tmuxSession: ''
58
58
  }));
59
59
  const all = registry.list();
60
60
  expect(all).toHaveLength(1);
61
- expect(all[0].pid).toBe(200);
61
+ expect(all[0].pid).toBe(process.pid);
62
+ expect(all[0].name).toBe('a');
62
63
  });
63
- it('writes atomically (no leftover .tmp on success)', ()=>{
64
+ it('does not write through the legacy fixed .tmp path', ()=>{
64
65
  registry.register(makeEntry());
65
66
  expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);
66
67
  });
@@ -79,24 +80,26 @@ describe('AgentRegistry', ()=>{
79
80
  tmuxSession: 'pinned'
80
81
  }));
81
82
  registry.register(makeEntry({
82
- name: 'a',
83
+ name: 'fallback',
83
84
  tmuxSession: '',
84
- pid: 999
85
+ pid: process.pid
85
86
  }));
86
87
  const saved = registry.lookup('a');
87
88
  expect(saved?.tmuxSession).toBe('pinned');
88
- expect(saved?.pid).toBe(999);
89
+ expect(saved?.pid).toBe(process.pid);
89
90
  });
90
- it('replaces tmuxSession when incoming is non-empty', ()=>{
91
+ it('lets a managed start entry replace a generated fallback for the same pid', ()=>{
91
92
  registry.register(makeEntry({
92
- name: 'a',
93
- tmuxSession: 'old'
93
+ name: `ai-devkit-${process.pid}`,
94
+ tmuxSession: ''
94
95
  }));
95
96
  registry.register(makeEntry({
96
- name: 'a',
97
- tmuxSession: 'new'
97
+ name: 'custom-name',
98
+ tmuxSession: 'custom-name'
98
99
  }));
99
- expect(registry.lookup('a')?.tmuxSession).toBe('new');
100
+ expect(registry.lookup('custom-name')?.tmuxSession).toBe('custom-name');
101
+ expect(registry.lookup(`ai-devkit-${process.pid}`)).toBeNull();
102
+ expect(registry.list()).toHaveLength(1);
100
103
  });
101
104
  });
102
105
  describe('registerBatch', ()=>{
@@ -104,21 +107,20 @@ describe('AgentRegistry', ()=>{
104
107
  registry.registerBatch([]);
105
108
  expect(fs.existsSync(regPath)).toBe(false);
106
109
  });
107
- it('upserts multiple entries with a single write', ()=>{
108
- const writeSpy = vi.spyOn(fs, 'writeFileSync');
110
+ it('upserts multiple entries in a single batch', ()=>{
109
111
  registry.registerBatch([
110
112
  makeEntry({
111
113
  name: 'a'
112
114
  }),
113
115
  makeEntry({
114
- name: 'b'
116
+ name: 'b',
117
+ pid: process.pid + 1
115
118
  }),
116
119
  makeEntry({
117
- name: 'c'
120
+ name: 'c',
121
+ pid: process.pid + 2
118
122
  })
119
123
  ]);
120
- expect(writeSpy).toHaveBeenCalledTimes(1);
121
- writeSpy.mockRestore();
122
124
  expect(registry.list()).toHaveLength(3);
123
125
  });
124
126
  it('applies the tmuxSession merge per entry', ()=>{
@@ -128,19 +130,37 @@ describe('AgentRegistry', ()=>{
128
130
  }));
129
131
  registry.registerBatch([
130
132
  makeEntry({
131
- name: 'a',
133
+ name: 'fallback',
132
134
  tmuxSession: '',
133
- pid: 7
135
+ pid: process.pid
134
136
  }),
135
137
  makeEntry({
136
138
  name: 'b',
137
- tmuxSession: ''
139
+ tmuxSession: '',
140
+ pid: process.pid + 1
138
141
  })
139
142
  ]);
140
143
  expect(registry.lookup('a')?.tmuxSession).toBe('pinned');
141
- expect(registry.lookup('a')?.pid).toBe(7);
144
+ expect(registry.lookup('a')?.pid).toBe(process.pid);
142
145
  expect(registry.lookup('b')?.tmuxSession).toBe('');
143
146
  });
147
+ it('handles concurrent registry instances without duplicate pid rows', ()=>{
148
+ const other = new AgentRegistry(regPath);
149
+ registry.register(makeEntry({
150
+ name: `ai-devkit-${process.pid}`,
151
+ tmuxSession: ''
152
+ }));
153
+ other.register(makeEntry({
154
+ name: 'custom-name',
155
+ tmuxSession: 'custom-name'
156
+ }));
157
+ registry.register(makeEntry({
158
+ name: `ai-devkit-${process.pid}`,
159
+ tmuxSession: ''
160
+ }));
161
+ expect(registry.list()).toHaveLength(1);
162
+ expect(registry.lookup('custom-name')?.pid).toBe(process.pid);
163
+ });
144
164
  });
145
165
  describe('lookup', ()=>{
146
166
  it('returns null when name not found', ()=>{
@@ -154,24 +174,26 @@ describe('AgentRegistry', ()=>{
154
174
  });
155
175
  });
156
176
  describe('list', ()=>{
157
- it('returns empty array when file does not exist', ()=>{
177
+ it('returns empty array when database does not contain entries', ()=>{
158
178
  expect(registry.list()).toEqual([]);
159
179
  });
160
- it('returns empty array when file is malformed', ()=>{
161
- fs.mkdirSync(path.dirname(regPath), {
162
- recursive: true
180
+ it('ignores existing legacy agents.json entries', ()=>{
181
+ const legacyEntry = makeEntry({
182
+ name: 'legacy',
183
+ tmuxSession: 'legacy'
163
184
  });
164
- fs.writeFileSync(regPath, 'not json', 'utf8');
165
- expect(registry.list()).toEqual([]);
166
- });
167
- it('coerces non-array entries to []', ()=>{
168
185
  fs.mkdirSync(path.dirname(regPath), {
169
186
  recursive: true
170
187
  });
171
188
  fs.writeFileSync(regPath, JSON.stringify({
172
- entries: 'oops'
189
+ entries: [
190
+ legacyEntry
191
+ ]
173
192
  }), 'utf8');
174
- expect(registry.list()).toEqual([]);
193
+ const legacyRegistry = new AgentRegistry(regPath);
194
+ expect(legacyRegistry.lookup('legacy')).toBeNull();
195
+ expect(legacyRegistry.list()).toEqual([]);
196
+ expect(fs.existsSync(regPath.replace(/\.json$/, '.db'))).toBe(true);
175
197
  });
176
198
  });
177
199
  describe('isAlive', ()=>{
@@ -205,10 +227,10 @@ describe('AgentRegistry', ()=>{
205
227
  registry.register(makeEntry({
206
228
  pid: process.pid
207
229
  }));
208
- const before = fs.readFileSync(regPath, 'utf8');
230
+ const before = registry.list();
209
231
  registry.prune();
210
- const after = fs.readFileSync(regPath, 'utf8');
211
- expect(after).toBe(before);
232
+ const after = registry.list();
233
+ expect(after).toEqual(before);
212
234
  });
213
235
  it('does nothing when file is missing', ()=>{
214
236
  expect(()=>registry.prune()).not.toThrow();
@@ -252,7 +274,7 @@ describe('AgentRegistry', ()=>{
252
274
  }));
253
275
  registry.register(makeEntry({
254
276
  name: 'agent-b',
255
- pid: process.pid
277
+ pid: process.ppid
256
278
  }));
257
279
  expect(()=>registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);
258
280
  });
@@ -268,7 +290,7 @@ describe('AgentRegistry', ()=>{
268
290
  expect(()=>registry.rename('agent-a', 'agent-b')).not.toThrow();
269
291
  expect(registry.lookup('agent-b')?.pid).toBe(process.pid);
270
292
  });
271
- it('writes atomically (no leftover .tmp on success)', ()=>{
293
+ it('does not create the legacy fixed .tmp path on rename', ()=>{
272
294
  registry.register(makeEntry({
273
295
  name: 'old-name',
274
296
  pid: process.pid
@@ -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 file and parent directory if missing', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(regPath)).toBe(true);\n const parsed = JSON.parse(fs.readFileSync(regPath, 'utf8'));\n expect(parsed.entries).toHaveLength(1);\n expect(parsed.entries[0].name).toBe('agent1');\n });\n\n it('appends a new entry when name is unique', () => {\n registry.register(makeEntry({ name: 'a' }));\n registry.register(makeEntry({ name: 'b' }));\n expect(registry.list()).toHaveLength(2);\n });\n\n it('upserts in place when name already exists', () => {\n registry.register(makeEntry({ name: 'a', pid: 100 }));\n registry.register(makeEntry({ name: 'a', pid: 200 }));\n const all = registry.list();\n expect(all).toHaveLength(1);\n expect(all[0].pid).toBe(200);\n });\n\n it('writes atomically (no leftover .tmp on success)', () => {\n registry.register(makeEntry());\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n\n it('persists session fields', () => {\n registry.register(makeEntry({ sessionId: 'sid-xyz', sessionFilePath: '/foo/bar.jsonl' }));\n const saved = registry.list()[0];\n expect(saved.sessionId).toBe('sid-xyz');\n expect(saved.sessionFilePath).toBe('/foo/bar.jsonl');\n });\n\n it('preserves existing tmuxSession when incoming is empty string', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.register(makeEntry({ name: 'a', tmuxSession: '', pid: 999 }));\n const saved = registry.lookup('a');\n expect(saved?.tmuxSession).toBe('pinned');\n expect(saved?.pid).toBe(999);\n });\n\n it('replaces tmuxSession when incoming is non-empty', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'old' }));\n registry.register(makeEntry({ name: 'a', tmuxSession: 'new' }));\n expect(registry.lookup('a')?.tmuxSession).toBe('new');\n });\n });\n\n describe('registerBatch', () => {\n it('is a no-op on empty array', () => {\n registry.registerBatch([]);\n expect(fs.existsSync(regPath)).toBe(false);\n });\n\n it('upserts multiple entries with a single write', () => {\n const writeSpy = vi.spyOn(fs, 'writeFileSync');\n registry.registerBatch([\n makeEntry({ name: 'a' }),\n makeEntry({ name: 'b' }),\n makeEntry({ name: 'c' }),\n ]);\n expect(writeSpy).toHaveBeenCalledTimes(1);\n writeSpy.mockRestore();\n expect(registry.list()).toHaveLength(3);\n });\n\n it('applies the tmuxSession merge per entry', () => {\n registry.register(makeEntry({ name: 'a', tmuxSession: 'pinned' }));\n registry.registerBatch([\n makeEntry({ name: 'a', tmuxSession: '', pid: 7 }),\n makeEntry({ name: 'b', tmuxSession: '' }),\n ]);\n expect(registry.lookup('a')?.tmuxSession).toBe('pinned');\n expect(registry.lookup('a')?.pid).toBe(7);\n expect(registry.lookup('b')?.tmuxSession).toBe('');\n });\n });\n\n describe('lookup', () => {\n it('returns null when name not found', () => {\n expect(registry.lookup('missing')).toBeNull();\n });\n\n it('returns the entry when name matches', () => {\n registry.register(makeEntry({ name: 'a' }));\n expect(registry.lookup('a')?.name).toBe('a');\n });\n });\n\n describe('list', () => {\n it('returns empty array when file does not exist', () => {\n expect(registry.list()).toEqual([]);\n });\n\n it('returns empty array when file is malformed', () => {\n fs.mkdirSync(path.dirname(regPath), { recursive: true });\n fs.writeFileSync(regPath, 'not json', 'utf8');\n expect(registry.list()).toEqual([]);\n });\n\n it('coerces non-array entries to []', () => {\n fs.mkdirSync(path.dirname(regPath), { recursive: true });\n fs.writeFileSync(regPath, JSON.stringify({ entries: 'oops' }), 'utf8');\n expect(registry.list()).toEqual([]);\n });\n });\n\n describe('isAlive', () => {\n it('returns true for the current process', () => {\n expect(registry.isAlive(makeEntry({ pid: process.pid }))).toBe(true);\n });\n\n it('returns false for a PID that does not exist', () => {\n expect(registry.isAlive(makeEntry({ pid: 999999 }))).toBe(false);\n });\n });\n\n describe('prune', () => {\n it('removes entries whose PIDs are dead', () => {\n registry.register(makeEntry({ name: 'alive', pid: process.pid }));\n registry.register(makeEntry({ name: 'dead', pid: 999999 }));\n registry.prune();\n const remaining = registry.list();\n expect(remaining).toHaveLength(1);\n expect(remaining[0].name).toBe('alive');\n });\n\n it('is a no-op when all entries are alive', () => {\n registry.register(makeEntry({ pid: process.pid }));\n const before = fs.readFileSync(regPath, 'utf8');\n registry.prune();\n const after = fs.readFileSync(regPath, 'utf8');\n expect(after).toBe(before);\n });\n\n it('does nothing when file is missing', () => {\n expect(() => registry.prune()).not.toThrow();\n });\n });\n\n describe('default()', () => {\n it('returns a singleton instance', () => {\n expect(AgentRegistry.default()).toBe(AgentRegistry.default());\n });\n });\n\n describe('rename', () => {\n it('updates the name of an existing entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(registry.lookup('new-name')?.name).toBe('new-name');\n expect(registry.lookup('old-name')).toBeNull();\n });\n\n it('preserves all other fields on the renamed entry', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid, tmuxSession: 'old-name', cwd: '/my/cwd' }));\n registry.rename('old-name', 'new-name');\n const entry = registry.lookup('new-name');\n expect(entry?.tmuxSession).toBe('old-name');\n expect(entry?.cwd).toBe('/my/cwd');\n expect(entry?.pid).toBe(process.pid);\n });\n\n it('throws RenameNotFoundError when current name does not exist', () => {\n expect(() => registry.rename('ghost', 'new-name')).toThrow(RenameNotFoundError);\n });\n\n it('throws RenameConflictError when new name is already in use by a live entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: process.pid }));\n expect(() => registry.rename('agent-a', 'agent-b')).toThrow(RenameConflictError);\n });\n\n it('succeeds when new name exists only as a stale (dead) entry', () => {\n registry.register(makeEntry({ name: 'agent-a', pid: process.pid }));\n registry.register(makeEntry({ name: 'agent-b', pid: 999999 }));\n expect(() => registry.rename('agent-a', 'agent-b')).not.toThrow();\n expect(registry.lookup('agent-b')?.pid).toBe(process.pid);\n });\n\n it('writes atomically (no leftover .tmp on success)', () => {\n registry.register(makeEntry({ name: 'old-name', pid: process.pid }));\n registry.rename('old-name', 'new-name');\n expect(fs.existsSync(`${regPath}.tmp`)).toBe(false);\n });\n });\n});\n"],"names":["fs","os","path","AgentRegistry","RenameNotFoundError","RenameConflictError","makeEntry","over","name","type","pid","process","tmuxSession","cwd","startedAt","sessionId","sessionFilePath","describe","tmpDir","regPath","registry","beforeEach","mkdtempSync","join","tmpdir","afterEach","rmSync","recursive","force","it","register","expect","existsSync","toBe","parsed","JSON","parse","readFileSync","entries","toHaveLength","list","all","saved","lookup","registerBatch","writeSpy","vi","spyOn","toHaveBeenCalledTimes","mockRestore","toBeNull","toEqual","mkdirSync","dirname","writeFileSync","stringify","isAlive","prune","remaining","before","after","not","toThrow","default","rename","entry"],"mappings":"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"}
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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"}
@@ -71,16 +71,24 @@ export declare class CodexAdapter implements AgentAdapter {
71
71
  private parseMetaTimestampMs;
72
72
  private determineStatus;
73
73
  private extractSummary;
74
+ private normalizedPayloadType;
75
+ private extractEntryText;
74
76
  private truncate;
75
77
  private isCodexExecutable;
76
78
  /**
77
79
  * Read the full conversation from a Codex session JSONL file.
78
80
  *
79
- * Codex entries use payload.type to indicate message role and payload.message for content.
81
+ * Codex entries use either legacy payload.message fields or current
82
+ * response_item/event_msg content arrays.
80
83
  */
81
84
  getConversation(sessionFilePath: string, options?: {
82
85
  verbose?: boolean;
83
86
  }): ConversationMessage[];
87
+ private toConversationMessage;
88
+ private mapCodexRole;
89
+ private mapCodexItemRole;
90
+ private mirroredMessageKey;
91
+ private extractContentText;
84
92
  listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
85
93
  /**
86
94
  * Walk every YYYY/MM/DD directory under `codexSessionsDir` and return
@@ -1 +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;AA2C1D,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;IAWtB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,iBAAiB;IAMzB;;;;OAIG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IA8C1F,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"}
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"}
@@ -390,7 +390,7 @@ export class CodexAdapter {
390
390
  }
391
391
  }
392
392
  const lastEntry = this.findLastEventEntry(entries);
393
- const lastPayloadType = lastEntry?.payload?.type;
393
+ const lastPayloadType = lastEntry ? this.normalizedPayloadType(lastEntry) : undefined;
394
394
  const lastActive = this.parseTimestamp(lastEntry?.timestamp) || this.parseTimestamp(metaEntry.payload.timestamp) || fs.statSync(filePath).mtime;
395
395
  const sessionStart = this.parseTimestamp(metaEntry.payload.timestamp) || lastActive;
396
396
  return {
@@ -461,13 +461,35 @@ export class CodexAdapter {
461
461
  }
462
462
  extractSummary(entries) {
463
463
  for(let i = entries.length - 1; i >= 0; i--){
464
- const message = entries[i]?.payload?.message;
465
- if (typeof message === 'string' && message.trim().length > 0) {
466
- return this.truncate(message.trim(), 120);
467
- }
464
+ const message = this.extractEntryText(entries[i]);
465
+ if (message) return this.truncate(message, 120);
468
466
  }
469
467
  return 'Codex session active';
470
468
  }
469
+ normalizedPayloadType(entry) {
470
+ const payloadType = entry.payload?.type;
471
+ if (entry.type === 'response_item' && payloadType === 'message') {
472
+ if (entry.payload?.role === 'assistant') return 'agent_message';
473
+ if (entry.payload?.role === 'user') return 'user_message';
474
+ return payloadType;
475
+ }
476
+ if (entry.type === 'event_msg' && payloadType === 'item_completed') {
477
+ const itemType = entry.payload?.item?.type;
478
+ if (itemType === 'AgentMessage') return 'agent_message';
479
+ if (itemType === 'UserMessage') return 'user_message';
480
+ return itemType ?? payloadType;
481
+ }
482
+ return payloadType;
483
+ }
484
+ extractEntryText(entry) {
485
+ if (!entry) return '';
486
+ const legacyMessage = entry.payload?.message;
487
+ if (typeof legacyMessage === 'string' && legacyMessage.trim().length > 0) {
488
+ return legacyMessage.trim();
489
+ }
490
+ const conversationMessage = this.toConversationMessage(entry, false);
491
+ return conversationMessage?.content.trim() ?? '';
492
+ }
471
493
  truncate(value, maxLength) {
472
494
  if (value.length <= maxLength) return value;
473
495
  return `${value.slice(0, maxLength - 3)}...`;
@@ -480,42 +502,102 @@ export class CodexAdapter {
480
502
  /**
481
503
  * Read the full conversation from a Codex session JSONL file.
482
504
  *
483
- * Codex entries use payload.type to indicate message role and payload.message for content.
505
+ * Codex entries use either legacy payload.message fields or current
506
+ * response_item/event_msg content arrays.
484
507
  */ getConversation(sessionFilePath, options) {
485
508
  const verbose = options?.verbose ?? false;
486
509
  const content = safeReadFile(sessionFilePath);
487
510
  if (content === undefined) return [];
488
511
  const lines = content.trim().split('\n');
512
+ const entries = [];
489
513
  const messages = [];
490
514
  for (const line of lines){
491
- let entry;
492
515
  try {
493
- entry = JSON.parse(line);
516
+ entries.push(JSON.parse(line));
494
517
  } catch {
495
518
  continue;
496
519
  }
497
- if (entry.type === 'session_meta') continue;
498
- const payloadType = entry.payload?.type;
499
- if (!payloadType) continue;
500
- let role;
501
- if (payloadType === 'user_message') {
502
- role = 'user';
503
- } else if (payloadType === 'agent_message' || payloadType === 'task_complete') {
504
- role = 'assistant';
505
- } else if (verbose) {
506
- role = 'system';
507
- } else {
520
+ }
521
+ const responseItemMirrorKeys = new Set();
522
+ for (const entry of entries){
523
+ if (entry.type !== 'response_item') continue;
524
+ const message = this.toConversationMessage(entry, verbose);
525
+ const mirrorKey = message ? this.mirroredMessageKey(entry, message) : null;
526
+ if (mirrorKey) responseItemMirrorKeys.add(mirrorKey);
527
+ }
528
+ for (const entry of entries){
529
+ const message = this.toConversationMessage(entry, verbose);
530
+ if (!message) continue;
531
+ const mirrorKey = this.mirroredMessageKey(entry, message);
532
+ if (entry.type === 'event_msg' && mirrorKey && responseItemMirrorKeys.has(mirrorKey)) {
508
533
  continue;
509
534
  }
510
- const text = entry.payload?.message?.trim();
511
- if (!text) continue;
512
- messages.push({
535
+ messages.push(message);
536
+ }
537
+ return messages;
538
+ }
539
+ toConversationMessage(entry, verbose) {
540
+ if (entry.type === 'session_meta') return null;
541
+ const payloadType = entry.payload?.type;
542
+ if (entry.type === 'response_item' && payloadType === 'message') {
543
+ const role = this.mapCodexRole(entry.payload?.role, verbose);
544
+ const text = this.extractContentText(entry.payload?.content);
545
+ if (!role || !text) return null;
546
+ return {
513
547
  role,
514
548
  content: text,
515
549
  timestamp: entry.timestamp
516
- });
550
+ };
517
551
  }
518
- return messages;
552
+ if (entry.type === 'event_msg' && payloadType === 'item_completed') {
553
+ const item = entry.payload?.item;
554
+ const role = this.mapCodexItemRole(item?.type, verbose);
555
+ const text = this.extractContentText(item?.content);
556
+ if (!role || !text) return null;
557
+ return {
558
+ role,
559
+ content: text,
560
+ timestamp: entry.timestamp
561
+ };
562
+ }
563
+ if (!payloadType) return null;
564
+ let role;
565
+ if (payloadType === 'user_message') {
566
+ role = 'user';
567
+ } else if (payloadType === 'agent_message' || payloadType === 'task_complete') {
568
+ role = 'assistant';
569
+ } else if (verbose) {
570
+ role = 'system';
571
+ } else {
572
+ return null;
573
+ }
574
+ const text = entry.payload?.message?.trim();
575
+ if (!text) return null;
576
+ return {
577
+ role,
578
+ content: text,
579
+ timestamp: entry.timestamp
580
+ };
581
+ }
582
+ mapCodexRole(role, verbose) {
583
+ if (role === 'user') return 'user';
584
+ if (role === 'assistant') return 'assistant';
585
+ return verbose ? 'system' : null;
586
+ }
587
+ mapCodexItemRole(itemType, verbose) {
588
+ if (itemType === 'AgentMessage') return 'assistant';
589
+ if (itemType === 'UserMessage') return 'user';
590
+ return verbose ? 'system' : null;
591
+ }
592
+ mirroredMessageKey(entry, message) {
593
+ const turnId = entry.payload?.turn_id || entry.payload?.internal_chat_message_metadata_passthrough?.turn_id;
594
+ if (!turnId) return null;
595
+ return `${turnId}\0${message.role}\0${message.content}`;
596
+ }
597
+ extractContentText(content) {
598
+ if (typeof content === 'string') return content.trim();
599
+ if (!Array.isArray(content)) return '';
600
+ return content.map((part)=>part.text).filter((text)=>typeof text === 'string' && text.trim().length > 0).map((text)=>text.trim()).join('\n').trim();
519
601
  }
520
602
  async listSessions(opts) {
521
603
  if (!isDirectory(this.codexSessionsDir)) return [];