@ai-devkit/agent-manager 0.26.0 → 0.26.2

package/dist/utils/AgentRegistry.js

@@ -1,6 +1,6 @@
-import fs from 'fs';
 import os from 'os';
 import path from 'path';
+import { DatabaseConnection, resolveAgentRegistryDbPath } from '../database/index.js';
 export class RenameNotFoundError extends Error {
     agentName;
     constructor(agentName){
@@ -18,9 +18,11 @@ export class RenameConflictError extends Error {
 const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.ai-devkit', 'agents.json');
 let defaultInstance = null;
 export class AgentRegistry {
-    filePath;
+    db;
     constructor(filePath = DEFAULT_REGISTRY_PATH){
-        this.filePath = filePath;
+        this.db = new DatabaseConnection({
+            dbPath: resolveAgentRegistryDbPath(filePath)
+        });
     }
     static default() {
         if (!defaultInstance) {
@@ -28,35 +30,80 @@ export class AgentRegistry {
         }
         return defaultInstance;
     }
-    readFile() {
-        try {
-            const raw = fs.readFileSync(this.filePath, 'utf8');
-            const parsed = JSON.parse(raw);
-            return {
-                entries: Array.isArray(parsed.entries) ? parsed.entries : []
-            };
-        } catch  {
-            return {
-                entries: []
-            };
-        }
-    }
-    writeFile(data) {
-        const dir = path.dirname(this.filePath);
-        fs.mkdirSync(dir, {
-            recursive: true
-        });
-        const tmp = `${this.filePath}.tmp`;
-        fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8');
-        fs.renameSync(tmp, this.filePath);
+    rowToEntry(row) {
+        return {
+            name: row.name,
+            type: row.type,
+            pid: row.pid,
+            tmuxSession: row.tmux_session,
+            cwd: row.cwd,
+            startedAt: row.started_at,
+            sessionId: row.session_id,
+            sessionFilePath: row.session_file_path
+        };
     }
     mergeEntry(incoming, existing) {
         if (!existing) return incoming;
+        const incomingIsManaged = Boolean(incoming.tmuxSession);
         return {
-            ...incoming,
-            tmuxSession: incoming.tmuxSession || existing.tmuxSession
+            ...existing,
+            name: incomingIsManaged ? incoming.name : existing.name,
+            tmuxSession: incoming.tmuxSession || existing.tmuxSession,
+            cwd: incoming.cwd || existing.cwd,
+            startedAt: existing.startedAt || incoming.startedAt,
+            sessionId: incoming.sessionId || existing.sessionId,
+            sessionFilePath: incoming.sessionFilePath || existing.sessionFilePath
         };
     }
+    findByIdentity(type, pid) {
+        const row = this.db.queryOne('SELECT * FROM agents WHERE type = ? AND pid = ?', [
+            type,
+            pid
+        ]);
+        return row ? this.rowToEntry(row) : undefined;
+    }
+    findByName(name) {
+        const row = this.db.queryOne('SELECT * FROM agents WHERE name = ?', [
+            name
+        ]);
+        return row ? this.rowToEntry(row) : undefined;
+    }
+    deleteNameConflict(name, type, pid) {
+        const conflict = this.findByName(name);
+        if (!conflict) return;
+        if (conflict.type === type && conflict.pid === pid) return;
+        if (!this.isAlive(conflict)) {
+            this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [
+                conflict.type,
+                conflict.pid
+            ]);
+        }
+    }
+    insertOrUpdate(entry) {
+        this.db.instance.prepare(`
+            INSERT INTO agents (
+                type, pid, name, tmux_session, cwd, started_at, session_id, session_file_path, updated_at
+            )
+            VALUES (
+                @type, @pid, @name, @tmuxSession, @cwd, @startedAt, @sessionId, @sessionFilePath, @updatedAt
+            )
+            ON CONFLICT(type, pid) DO UPDATE SET
+                name = excluded.name,
+                tmux_session = excluded.tmux_session,
+                cwd = excluded.cwd,
+                started_at = agents.started_at,
+                session_id = excluded.session_id,
+                session_file_path = excluded.session_file_path,
+                updated_at = excluded.updated_at
+        `).run({
+            ...entry,
+            updatedAt: new Date().toISOString()
+        });
+    }
+    save(entry) {
+        this.deleteNameConflict(entry.name, entry.type, entry.pid);
+        this.insertOrUpdate(entry);
+    }
     isAlive(entry) {
         try {
             process.kill(entry.pid, 0);
@@ -66,13 +113,16 @@ export class AgentRegistry {
         }
     }
     prune() {
-        const data = this.readFile();
-        const live = data.entries.filter((e)=>this.isAlive(e));
-        if (live.length !== data.entries.length) {
-            this.writeFile({
-                entries: live
-            });
-        }
+        const entries = this.list();
+        const stale = entries.filter((e)=>!this.isAlive(e));
+        this.db.transaction(()=>{
+            for (const entry of stale){
+                this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [
+                    entry.type,
+                    entry.pid
+                ]);
+            }
+        });
     }
     register(entry) {
         this.registerBatch([
@@ -81,42 +131,43 @@ export class AgentRegistry {
     }
     registerBatch(entries) {
         if (entries.length === 0) return;
-        const data = this.readFile();
-        for (const incoming of entries){
-            const idx = data.entries.findIndex((e)=>e.name === incoming.name);
-            if (idx >= 0) {
-                data.entries[idx] = this.mergeEntry(incoming, data.entries[idx]);
-            } else {
-                data.entries.push(incoming);
+        this.db.transaction(()=>{
+            for (const incoming of entries){
+                const existing = this.findByIdentity(incoming.type, incoming.pid);
+                this.save(this.mergeEntry(incoming, existing));
             }
-        }
-        this.writeFile(data);
+        });
     }
     rename(currentName, newName) {
-        const data = this.readFile();
-        const idx = data.entries.findIndex((e)=>e.name === currentName);
-        if (idx < 0) {
+        const existing = this.findByName(currentName);
+        if (!existing) {
             throw new RenameNotFoundError(currentName);
         }
-        const liveEntries = data.entries.filter((e)=>this.isAlive(e));
-        const conflict = liveEntries.find((e)=>e.name === newName);
-        if (conflict) {
+        const conflict = this.findByName(newName);
+        if (conflict && this.isAlive(conflict)) {
             throw new RenameConflictError(newName);
         }
-        const pruned = liveEntries.map((e)=>e.name === currentName ? {
-                ...e,
-                name: newName
-            } : e);
-        this.writeFile({
-            entries: pruned
+        this.db.transaction(()=>{
+            if (conflict) {
+                this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [
+                    conflict.type,
+                    conflict.pid
+                ]);
+            }
+            this.db.execute('UPDATE agents SET name = ?, updated_at = ? WHERE type = ? AND pid = ?', [
+                newName,
+                new Date().toISOString(),
+                existing.type,
+                existing.pid
+            ]);
         });
     }
     lookup(name) {
-        const data = this.readFile();
-        return data.entries.find((e)=>e.name === name) ?? null;
+        return this.findByName(name) ?? null;
     }
     list() {
-        return this.readFile().entries;
+        const rows = this.db.query('SELECT * FROM agents ORDER BY started_at ASC, name ASC');
+        return rows.map((row)=>this.rowToEntry(row));
     }
 }
 

package/dist/utils/AgentRegistry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/AgentRegistry.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport type { AgentType } from '../adapters/AgentAdapter.js';\n\nexport class RenameNotFoundError extends Error {\n    constructor(public agentName: string) {\n        super(`Agent \"${agentName}\" not found in registry.`);\n        this.name = 'RenameNotFoundError';\n    }\n}\n\nexport class RenameConflictError extends Error {\n    constructor(public agentName: string) {\n        super(`Agent \"${agentName}\" is already in use.`);\n        this.name = 'RenameConflictError';\n    }\n}\n\nexport interface RegistryEntry {\n    name: string;\n    type: AgentType;\n    pid: number;\n    tmuxSession: string;\n    cwd: string;\n    startedAt: string;  // ISO 8601\n    sessionId: string;\n    sessionFilePath: string;\n}\n\ninterface RegistryFile {\n    entries: RegistryEntry[];\n}\n\nconst DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.ai-devkit', 'agents.json');\n\nlet defaultInstance: AgentRegistry | null = null;\n\nexport class AgentRegistry {\n    private filePath: string;\n\n    constructor(filePath: string = DEFAULT_REGISTRY_PATH) {\n        this.filePath = filePath;\n    }\n\n    static default(): AgentRegistry {\n        if (!defaultInstance) {\n            defaultInstance = new AgentRegistry();\n        }\n        return defaultInstance;\n    }\n\n    private readFile(): RegistryFile {\n        try {\n            const raw = fs.readFileSync(this.filePath, 'utf8');\n            const parsed = JSON.parse(raw) as RegistryFile;\n            return { entries: Array.isArray(parsed.entries) ? parsed.entries : [] };\n        } catch {\n            return { entries: [] };\n        }\n    }\n\n    private writeFile(data: RegistryFile): void {\n        const dir = path.dirname(this.filePath);\n        fs.mkdirSync(dir, { recursive: true });\n        const tmp = `${this.filePath}.tmp`;\n        fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8');\n        fs.renameSync(tmp, this.filePath);\n    }\n\n    private mergeEntry(incoming: RegistryEntry, existing: RegistryEntry | undefined): RegistryEntry {\n        if (!existing) return incoming;\n        return {\n            ...incoming,\n            tmuxSession: incoming.tmuxSession || existing.tmuxSession,\n        };\n    }\n\n    isAlive(entry: RegistryEntry): boolean {\n        try {\n            process.kill(entry.pid, 0);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    prune(): void {\n        const data = this.readFile();\n        const live = data.entries.filter((e) => this.isAlive(e));\n        if (live.length !== data.entries.length) {\n            this.writeFile({ entries: live });\n        }\n    }\n\n    register(entry: RegistryEntry): void {\n        this.registerBatch([entry]);\n    }\n\n    registerBatch(entries: RegistryEntry[]): void {\n        if (entries.length === 0) return;\n        const data = this.readFile();\n        for (const incoming of entries) {\n            const idx = data.entries.findIndex((e) => e.name === incoming.name);\n            if (idx >= 0) {\n                data.entries[idx] = this.mergeEntry(incoming, data.entries[idx]);\n            } else {\n                data.entries.push(incoming);\n            }\n        }\n        this.writeFile(data);\n    }\n\n    rename(currentName: string, newName: string): void {\n        const data = this.readFile();\n        const idx = data.entries.findIndex((e) => e.name === currentName);\n        if (idx < 0) {\n            throw new RenameNotFoundError(currentName);\n        }\n        const liveEntries = data.entries.filter((e) => this.isAlive(e));\n        const conflict = liveEntries.find((e) => e.name === newName);\n        if (conflict) {\n            throw new RenameConflictError(newName);\n        }\n        const pruned = liveEntries.map((e) =>\n            e.name === currentName ? { ...e, name: newName } : e,\n        );\n        this.writeFile({ entries: pruned });\n    }\n\n    lookup(name: string): RegistryEntry | null {\n        const data = this.readFile();\n        return data.entries.find((e) => e.name === name) ?? null;\n    }\n\n    list(): RegistryEntry[] {\n        return this.readFile().entries;\n    }\n}\n"],"names":["fs","os","path","RenameNotFoundError","Error","agentName","name","RenameConflictError","DEFAULT_REGISTRY_PATH","join","homedir","defaultInstance","AgentRegistry","filePath","default","readFile","raw","readFileSync","parsed","JSON","parse","entries","Array","isArray","writeFile","data","dir","dirname","mkdirSync","recursive","tmp","writeFileSync","stringify","renameSync","mergeEntry","incoming","existing","tmuxSession","isAlive","entry","process","kill","pid","prune","live","filter","e","length","register","registerBatch","idx","findIndex","push","rename","currentName","newName","liveEntries","conflict","find","pruned","map","lookup","list"],"mappings":"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"}
+{"version":3,"sources":["../../src/utils/AgentRegistry.ts"],"sourcesContent":["import os from 'os';\nimport path from 'path';\nimport type { AgentType } from '../adapters/AgentAdapter.js';\nimport {\n    DatabaseConnection,\n    resolveAgentRegistryDbPath,\n} from '../database/index.js';\n\nexport class RenameNotFoundError extends Error {\n    constructor(public agentName: string) {\n        super(`Agent \"${agentName}\" not found in registry.`);\n        this.name = 'RenameNotFoundError';\n    }\n}\n\nexport class RenameConflictError extends Error {\n    constructor(public agentName: string) {\n        super(`Agent \"${agentName}\" is already in use.`);\n        this.name = 'RenameConflictError';\n    }\n}\n\nexport interface RegistryEntry {\n    name: string;\n    type: AgentType;\n    pid: number;\n    tmuxSession: string;\n    cwd: string;\n    startedAt: string;  // ISO 8601\n    sessionId: string;\n    sessionFilePath: string;\n}\n\ninterface RegistryRow {\n    name: string;\n    type: AgentType;\n    pid: number;\n    tmux_session: string;\n    cwd: string;\n    started_at: string;\n    session_id: string;\n    session_file_path: string;\n    updated_at: string;\n}\n\nconst DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.ai-devkit', 'agents.json');\n\nlet defaultInstance: AgentRegistry | null = null;\n\nexport class AgentRegistry {\n    private db: DatabaseConnection;\n\n    constructor(filePath: string = DEFAULT_REGISTRY_PATH) {\n        this.db = new DatabaseConnection({ dbPath: resolveAgentRegistryDbPath(filePath) });\n    }\n\n    static default(): AgentRegistry {\n        if (!defaultInstance) {\n            defaultInstance = new AgentRegistry();\n        }\n        return defaultInstance;\n    }\n\n    private rowToEntry(row: RegistryRow): RegistryEntry {\n        return {\n            name: row.name,\n            type: row.type,\n            pid: row.pid,\n            tmuxSession: row.tmux_session,\n            cwd: row.cwd,\n            startedAt: row.started_at,\n            sessionId: row.session_id,\n            sessionFilePath: row.session_file_path,\n        };\n    }\n\n    private mergeEntry(incoming: RegistryEntry, existing: RegistryEntry | undefined): RegistryEntry {\n        if (!existing) return incoming;\n        const incomingIsManaged = Boolean(incoming.tmuxSession);\n        return {\n            ...existing,\n            name: incomingIsManaged ? incoming.name : existing.name,\n            tmuxSession: incoming.tmuxSession || existing.tmuxSession,\n            cwd: incoming.cwd || existing.cwd,\n            startedAt: existing.startedAt || incoming.startedAt,\n            sessionId: incoming.sessionId || existing.sessionId,\n            sessionFilePath: incoming.sessionFilePath || existing.sessionFilePath,\n        };\n    }\n\n    private findByIdentity(type: AgentType, pid: number): RegistryEntry | undefined {\n        const row = this.db.queryOne<RegistryRow>(\n            'SELECT * FROM agents WHERE type = ? AND pid = ?',\n            [type, pid],\n        );\n        return row ? this.rowToEntry(row) : undefined;\n    }\n\n    private findByName(name: string): RegistryEntry | undefined {\n        const row = this.db.queryOne<RegistryRow>('SELECT * FROM agents WHERE name = ?', [name]);\n        return row ? this.rowToEntry(row) : undefined;\n    }\n\n    private deleteNameConflict(name: string, type: AgentType, pid: number): void {\n        const conflict = this.findByName(name);\n        if (!conflict) return;\n        if (conflict.type === type && conflict.pid === pid) return;\n        if (!this.isAlive(conflict)) {\n            this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [conflict.type, conflict.pid]);\n        }\n    }\n\n    private insertOrUpdate(entry: RegistryEntry): void {\n        this.db.instance.prepare(`\n            INSERT INTO agents (\n                type, pid, name, tmux_session, cwd, started_at, session_id, session_file_path, updated_at\n            )\n            VALUES (\n                @type, @pid, @name, @tmuxSession, @cwd, @startedAt, @sessionId, @sessionFilePath, @updatedAt\n            )\n            ON CONFLICT(type, pid) DO UPDATE SET\n                name = excluded.name,\n                tmux_session = excluded.tmux_session,\n                cwd = excluded.cwd,\n                started_at = agents.started_at,\n                session_id = excluded.session_id,\n                session_file_path = excluded.session_file_path,\n                updated_at = excluded.updated_at\n        `).run({ ...entry, updatedAt: new Date().toISOString() });\n    }\n\n    private save(entry: RegistryEntry): void {\n        this.deleteNameConflict(entry.name, entry.type, entry.pid);\n        this.insertOrUpdate(entry);\n    }\n\n    isAlive(entry: RegistryEntry): boolean {\n        try {\n            process.kill(entry.pid, 0);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    prune(): void {\n        const entries = this.list();\n        const stale = entries.filter((e) => !this.isAlive(e));\n        this.db.transaction(() => {\n            for (const entry of stale) {\n                this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [entry.type, entry.pid]);\n            }\n        });\n    }\n\n    register(entry: RegistryEntry): void {\n        this.registerBatch([entry]);\n    }\n\n    registerBatch(entries: RegistryEntry[]): void {\n        if (entries.length === 0) return;\n        this.db.transaction(() => {\n            for (const incoming of entries) {\n                const existing = this.findByIdentity(incoming.type, incoming.pid);\n                this.save(this.mergeEntry(incoming, existing));\n            }\n        });\n    }\n\n    rename(currentName: string, newName: string): void {\n        const existing = this.findByName(currentName);\n        if (!existing) {\n            throw new RenameNotFoundError(currentName);\n        }\n        const conflict = this.findByName(newName);\n        if (conflict && this.isAlive(conflict)) {\n            throw new RenameConflictError(newName);\n        }\n\n        this.db.transaction(() => {\n            if (conflict) {\n                this.db.execute('DELETE FROM agents WHERE type = ? AND pid = ?', [conflict.type, conflict.pid]);\n            }\n            this.db.execute(\n                'UPDATE agents SET name = ?, updated_at = ? WHERE type = ? AND pid = ?',\n                [newName, new Date().toISOString(), existing.type, existing.pid],\n            );\n        });\n    }\n\n    lookup(name: string): RegistryEntry | null {\n        return this.findByName(name) ?? null;\n    }\n\n    list(): RegistryEntry[] {\n        const rows = this.db.query<RegistryRow>('SELECT * FROM agents ORDER BY started_at ASC, name ASC');\n        return rows.map((row) => this.rowToEntry(row));\n    }\n}\n"],"names":["os","path","DatabaseConnection","resolveAgentRegistryDbPath","RenameNotFoundError","Error","agentName","name","RenameConflictError","DEFAULT_REGISTRY_PATH","join","homedir","defaultInstance","AgentRegistry","db","filePath","dbPath","default","rowToEntry","row","type","pid","tmuxSession","tmux_session","cwd","startedAt","started_at","sessionId","session_id","sessionFilePath","session_file_path","mergeEntry","incoming","existing","incomingIsManaged","Boolean","findByIdentity","queryOne","undefined","findByName","deleteNameConflict","conflict","isAlive","execute","insertOrUpdate","entry","instance","prepare","run","updatedAt","Date","toISOString","save","process","kill","prune","entries","list","stale","filter","e","transaction","register","registerBatch","length","rename","currentName","newName","lookup","rows","query","map"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-devkit/agent-manager",
-  "version": "0.26.0",
+  "version": "0.26.2",
   "type": "module",
   "description": "Standalone agent detection and management utilities for AI DevKit",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     }
   },
   "scripts": {
-    "build": "swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "build": "swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly && cp -r src/database/migrations dist/database/",
     "dev": "swc src -d dist --strip-leading-paths --watch",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/__tests__/AgentManager.test.ts

@@ -340,6 +340,43 @@ describe('AgentManager', () => {
             expect(registry.list()[0].startedAt).toBe('2026-05-30T00:00:00.000Z');
         });
 
+        it('preserves a user-managed name when a fallback row was written later for the same pid', async () => {
+            registry.register({
+                name: 'agent-list-debug',
+                type: 'codex',
+                pid: process.pid,
+                tmuxSession: 'agent-list-debug',
+                cwd: '/cwd/debug',
+                startedAt: '2026-05-30T00:00:00.000Z',
+                sessionId: 'pid-debug',
+                sessionFilePath: '',
+            });
+            registry.register({
+                name: `ai-devkit-${process.pid}`,
+                type: 'codex',
+                pid: process.pid,
+                tmuxSession: '',
+                cwd: '/cwd/debug',
+                startedAt: '2026-05-31T00:00:00.000Z',
+                sessionId: 'pid-debug',
+                sessionFilePath: '',
+            });
+
+            scopedManager.registerAdapter(new MockAdapter('codex', [
+                createMockAgent({ name: `ai-devkit-${process.pid}`, type: 'codex', pid: process.pid }),
+            ]));
+
+            const agents = await scopedManager.listAgents();
+
+            expect(agents[0].name).toBe('agent-list-debug');
+            expect(registry.list()).toHaveLength(1);
+            expect(registry.list()[0]).toMatchObject({
+                name: 'agent-list-debug',
+                pid: process.pid,
+                tmuxSession: 'agent-list-debug',
+            });
+        });
+
         it('writes a fresh startedAt for new entries', async () => {
             const before = new Date().toISOString();
             scopedManager.registerAdapter(new MockAdapter('claude', [

package/src/__tests__/adapters/CodexAdapter.test.ts

@@ -1133,6 +1133,52 @@ describe('CodexAdapter', () => {
                 expect(session.summary).toBe('Last message');
             });
 
+            it('should extract summary from current Codex response_item messages', () => {
+                const parseSession = (adapter as any).parseSession.bind(adapter);
+                const filePath = path.join(tmpDir, 'response-item-summary.jsonl');
+                fs.writeFileSync(filePath, [
+                    JSON.stringify({ type: 'session_meta', payload: { id: 'sess-ri', timestamp: '2026-03-18T15:00:00Z', cwd: '/repo' } }),
+                    JSON.stringify({
+                        type: 'response_item',
+                        timestamp: '2026-03-18T15:01:00Z',
+                        payload: {
+                            type: 'message',
+                            role: 'assistant',
+                            content: [{ type: 'output_text', text: 'Parsed from current schema' }],
+                        },
+                    }),
+                ].join('\n'));
+
+                const session = parseSession(undefined, filePath);
+                expect(session.summary).toBe('Parsed from current schema');
+                expect(session.lastPayloadType).toBe('agent_message');
+            });
+
+            it('should treat completed Codex AgentMessage events as waiting for list status', () => {
+                const parseSession = (adapter as any).parseSession.bind(adapter);
+                const determineStatus = (adapter as any).determineStatus.bind(adapter);
+                const filePath = path.join(tmpDir, 'agent-message-status.jsonl');
+                fs.writeFileSync(filePath, [
+                    JSON.stringify({ type: 'session_meta', payload: { id: 'sess-am', timestamp: '2026-03-18T15:00:00Z', cwd: '/repo' } }),
+                    JSON.stringify({
+                        type: 'event_msg',
+                        timestamp: new Date().toISOString(),
+                        payload: {
+                            type: 'item_completed',
+                            item: {
+                                type: 'AgentMessage',
+                                content: [{ type: 'Text', text: 'Waiting for the user now' }],
+                            },
+                        },
+                    }),
+                ].join('\n'));
+
+                const session = parseSession(undefined, filePath);
+                expect(session.summary).toBe('Waiting for the user now');
+                expect(session.lastPayloadType).toBe('agent_message');
+                expect(determineStatus(session)).toBe(AgentStatus.WAITING);
+            });
+
             it('should handle malformed JSON lines gracefully', () => {
                 const parseSession = (adapter as any).parseSession.bind(adapter);
                 const filePath = path.join(tmpDir, 'malformed.jsonl');
@@ -1212,6 +1258,115 @@ describe('CodexAdapter', () => {
             expect(messages[1]).toEqual({ role: 'assistant', content: 'I found the issue', timestamp: '2026-03-27T10:00:05Z' });
         });
 
+        it('should parse Codex response_item message records', () => {
+            const filePath = writeJsonl([
+                { type: 'session_meta', payload: { id: 'sess-1', cwd: '/repo', timestamp: '2026-03-27T10:00:00Z' } },
+                {
+                    type: 'response_item',
+                    timestamp: '2026-03-27T10:00:01Z',
+                    payload: {
+                        type: 'message',
+                        role: 'user',
+                        content: [{ type: 'input_text', text: 'Fix the bug' }],
+                    },
+                },
+                {
+                    type: 'response_item',
+                    timestamp: '2026-03-27T10:00:05Z',
+                    payload: {
+                        type: 'message',
+                        role: 'assistant',
+                        content: [{ type: 'output_text', text: 'I found the issue' }],
+                    },
+                },
+            ]);
+
+            const messages = adapter.getConversation(filePath);
+            expect(messages).toHaveLength(2);
+            expect(messages[0]).toEqual({ role: 'user', content: 'Fix the bug', timestamp: '2026-03-27T10:00:01Z' });
+            expect(messages[1]).toEqual({ role: 'assistant', content: 'I found the issue', timestamp: '2026-03-27T10:00:05Z' });
+        });
+
+        it('should parse completed Codex AgentMessage event records', () => {
+            const filePath = writeJsonl([
+                { type: 'session_meta', payload: { id: 'sess-1', cwd: '/repo', timestamp: '2026-03-27T10:00:00Z' } },
+                {
+                    type: 'event_msg',
+                    timestamp: '2026-03-27T10:00:05Z',
+                    payload: {
+                        type: 'item_completed',
+                        item: {
+                            type: 'AgentMessage',
+                            content: [{ type: 'Text', text: 'I found the issue' }],
+                        },
+                    },
+                },
+            ]);
+
+            const messages = adapter.getConversation(filePath);
+            expect(messages).toEqual([
+                { role: 'assistant', content: 'I found the issue', timestamp: '2026-03-27T10:00:05Z' },
+            ]);
+        });
+
+        it('should not duplicate mirrored current Codex message records', () => {
+            const filePath = writeJsonl([
+                { type: 'session_meta', payload: { id: 'sess-1', cwd: '/repo', timestamp: '2026-03-27T10:00:00Z' } },
+                {
+                    type: 'response_item',
+                    timestamp: '2026-03-27T10:00:01Z',
+                    payload: {
+                        type: 'message',
+                        role: 'user',
+                        content: [{ type: 'input_text', text: 'Fix the bug' }],
+                        internal_chat_message_metadata_passthrough: { turn_id: 'turn-1' },
+                    },
+                },
+                {
+                    type: 'event_msg',
+                    timestamp: '2026-03-27T10:00:01.001Z',
+                    payload: {
+                        type: 'item_completed',
+                        turn_id: 'turn-1',
+                        item: {
+                            type: 'UserMessage',
+                            content: [{ type: 'text', text: 'Fix the bug' }],
+                        },
+                    },
+                },
+                {
+                    type: 'event_msg',
+                    timestamp: '2026-03-27T10:00:05Z',
+                    payload: {
+                        type: 'item_completed',
+                        turn_id: 'turn-1',
+                        item: {
+                            type: 'AgentMessage',
+                            id: 'msg-1',
+                            content: [{ type: 'Text', text: 'I found the issue' }],
+                        },
+                    },
+                },
+                {
+                    type: 'response_item',
+                    timestamp: '2026-03-27T10:00:05.005Z',
+                    payload: {
+                        type: 'message',
+                        id: 'msg-1',
+                        role: 'assistant',
+                        content: [{ type: 'output_text', text: 'I found the issue' }],
+                        internal_chat_message_metadata_passthrough: { turn_id: 'turn-1' },
+                    },
+                },
+            ]);
+
+            const messages = adapter.getConversation(filePath);
+            expect(messages).toEqual([
+                { role: 'user', content: 'Fix the bug', timestamp: '2026-03-27T10:00:01Z' },
+                { role: 'assistant', content: 'I found the issue', timestamp: '2026-03-27T10:00:05.005Z' },
+            ]);
+        });
+
         it('should skip session_meta entry', () => {
             const filePath = writeJsonl([
                 { type: 'session_meta', payload: { id: 'sess-1', cwd: '/repo', timestamp: '2026-03-27T10:00:00Z' } },