@ai-devkit/agent-manager 0.27.0 → 0.28.0

package/dist/__tests__/print/{PrintAgentStore.test.js → DurableAgentRepository.test.js}

@@ -11,36 +11,36 @@ afterEach(()=>{
 });
 async function loadStore() {
     const api = await import('../../index.js');
-    expect(api).toHaveProperty('PrintAgentStore');
-    return api.PrintAgentStore;
+    expect(api).toHaveProperty('DurableAgentRepository');
+    return api.DurableAgentRepository;
 }
 function fixture() {
-    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'print-agent-store-'));
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'durable-agent-store-'));
     tempDirs.push(root);
     const cwd = path.join(root, 'project');
     fs.mkdirSync(cwd);
     return {
         root,
         cwd,
-        filePath: path.join(root, 'state', 'print-agents.json')
+        dbPath: path.join(root, 'state', 'agents.db')
     };
 }
-describe('PrintAgentStore create/list/resolve', ()=>{
+describe('DurableAgentRepository create/list/resolve', ()=>{
     it('creates distinct durable identities with a canonical cwd and lists them', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { cwd, filePath } = fixture();
-        const store = new PrintAgentStore({
-            filePath,
+        const DurableAgentRepository = await loadStore();
+        const { cwd, dbPath } = fixture();
+        const repository = new DurableAgentRepository({
+            dbPath,
             now: ()=>new Date('2026-08-07T09:00:00Z')
         });
-        const agent = await store.create({
+        const agent = await repository.create({
             name: 'reviewer',
             cwd
         });
         expect(agent).toMatchObject({
             name: 'reviewer',
             provider: 'claude',
-            mode: 'print',
+            mode: 'durable',
             cwd: fs.realpathSync(cwd),
             state: 'ready',
             sessionHealth: 'uninitialized',
@@ -49,96 +49,53 @@ describe('PrintAgentStore create/list/resolve', ()=>{
         expect(agent.id).toMatch(/^[0-9a-f-]{36}$/);
         expect(agent.providerSessionId).toMatch(/^[0-9a-f-]{36}$/);
         expect(agent.id).not.toBe(agent.providerSessionId);
-        expect(await store.list()).toEqual([
+        expect(await repository.list()).toEqual([
             agent
         ]);
-        expect(fs.statSync(filePath).mode & 0o777).toBe(0o600);
+        expect(fs.existsSync(dbPath)).toBe(true);
     });
     it('resolves exact ids and names and rejects duplicate names', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { cwd, filePath } = fixture();
-        const store = new PrintAgentStore({
-            filePath
+        const DurableAgentRepository = await loadStore();
+        const { cwd, dbPath } = fixture();
+        const repository = new DurableAgentRepository({
+            dbPath
         });
-        const agent = await store.create({
+        const agent = await repository.create({
             name: 'Reviewer',
             cwd
         });
-        expect(await store.resolve(agent.id)).toMatchObject({
+        expect(await repository.resolve(agent.id)).toMatchObject({
             id: agent.id
         });
-        expect(await store.resolve('reviewer')).toMatchObject({
+        expect(await repository.resolve('reviewer')).toMatchObject({
             id: agent.id
         });
-        expect(await store.resolve('view')).toBeNull();
-        await expect(store.create({
+        expect(await repository.resolve('view')).toBeNull();
+        await expect(repository.create({
             name: 'reviewer',
             cwd
         })).rejects.toMatchObject({
-            code: 'PRINT_AGENT_NAME_CONFLICT'
+            code: 'DURABLE_AGENT_NAME_CONFLICT'
         });
     });
-    it('rejects missing cwd, malformed storage, and symlinked store targets', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { root, cwd, filePath } = fixture();
-        const store = new PrintAgentStore({
-            filePath
+    it('rejects a missing cwd', async ()=>{
+        const DurableAgentRepository = await loadStore();
+        const { root, dbPath } = fixture();
+        const repository = new DurableAgentRepository({
+            dbPath
         });
-        await expect(store.create({
+        await expect(repository.create({
             name: 'missing',
             cwd: path.join(root, 'missing')
         })).rejects.toMatchObject({
-            code: 'PRINT_AGENT_STORE'
-        });
-        fs.mkdirSync(path.dirname(filePath), {
-            recursive: true
-        });
-        fs.writeFileSync(filePath, '{bad json', {
-            mode: 0o600
-        });
-        await expect(store.list()).rejects.toMatchObject({
-            code: 'PRINT_AGENT_STORE'
-        });
-        fs.rmSync(filePath);
-        const target = path.join(root, 'target.json');
-        fs.writeFileSync(target, JSON.stringify({
-            version: 1,
-            agents: []
-        }));
-        fs.symlinkSync(target, filePath);
-        await expect(store.create({
-            name: 'unsafe',
-            cwd
-        })).rejects.toMatchObject({
-            code: 'PRINT_AGENT_STORE'
-        });
-    });
-    it('recovers an abandoned old mutation lock after a crash', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { cwd, filePath } = fixture();
-        fs.mkdirSync(path.dirname(filePath), {
-            recursive: true
-        });
-        const lockPath = `${filePath}.lock`;
-        fs.mkdirSync(lockPath);
-        const old = new Date(Date.now() - 60_000);
-        fs.utimesSync(lockPath, old, old);
-        const store = new PrintAgentStore({
-            filePath,
-            mutationLockStaleMs: 10
-        });
-        await expect(store.create({
-            name: 'recovered',
-            cwd
-        })).resolves.toMatchObject({
-            name: 'recovered'
+            code: 'DURABLE_AGENT_REPOSITORY'
         });
     });
 });
-describe('PrintAgentStore run ownership', ()=>{
+describe('DurableAgentRepository run ownership', ()=>{
     it('fails fast when another exact owner is live and completes only for its token', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { cwd, filePath } = fixture();
+        const DurableAgentRepository = await loadStore();
+        const { cwd, dbPath } = fixture();
         const live = new Map([
             [
                 process.pid,
@@ -154,27 +111,27 @@ describe('PrintAgentStore run ownership', ()=>{
                 } : null;
             }
         };
-        const store = new PrintAgentStore({
-            filePath,
+        const repository = new DurableAgentRepository({
+            dbPath,
             processInspector
         });
-        const agent = await store.create({
+        const agent = await repository.create({
             name: 'runner',
             cwd
         });
-        const acquired = await store.acquireRun(agent.id);
-        await expect(store.acquireRun(agent.id)).rejects.toMatchObject({
-            code: 'PRINT_AGENT_BUSY'
+        const acquired = await repository.acquireRun(agent.id);
+        await expect(repository.acquireRun(agent.id)).rejects.toMatchObject({
+            code: 'DURABLE_AGENT_BUSY'
         });
-        await expect(store.completeRun(agent.id, 'wrong-token', {
+        await expect(repository.completeRun(agent.id, 'wrong-token', {
             status: 'succeeded',
             exitCode: 0,
             summary: 'done',
             sessionHealth: 'healthy'
         })).rejects.toMatchObject({
-            code: 'PRINT_AGENT_STORE'
+            code: 'DURABLE_AGENT_REPOSITORY'
         });
-        const completed = await store.completeRun(agent.id, acquired.token, {
+        const completed = await repository.completeRun(agent.id, acquired.token, {
             status: 'succeeded',
             exitCode: 0,
             summary: 'done',
@@ -187,8 +144,8 @@ describe('PrintAgentStore run ownership', ()=>{
         });
     });
     it('retains busy for a live provider then recovers a dead run without signaling it', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { cwd, filePath } = fixture();
+        const DurableAgentRepository = await loadStore();
+        const { cwd, dbPath } = fixture();
         const live = new Map([
             [
                 process.pid,
@@ -208,8 +165,8 @@ describe('PrintAgentStore run ownership', ()=>{
                 } : null;
             }
         };
-        const first = new PrintAgentStore({
-            filePath,
+        const first = new DurableAgentRepository({
+            dbPath,
             processInspector
         });
         const agent = await first.create({
@@ -223,7 +180,7 @@ describe('PrintAgentStore run ownership', ()=>{
         });
         live.delete(process.pid);
         await expect(first.acquireRun(agent.id)).rejects.toMatchObject({
-            code: 'PRINT_AGENT_BUSY'
+            code: 'DURABLE_AGENT_BUSY'
         });
         live.delete(4242);
         live.set(process.pid, 'replacement-owner-start');
@@ -241,17 +198,17 @@ describe('PrintAgentStore run ownership', ()=>{
             sessionHealth: 'unknown'
         });
     });
-    it('reconciles an old incomplete lock to degraded during list', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { root, cwd, filePath } = fixture();
+    it('reconciles an interrupted run to degraded during list', async ()=>{
+        const DurableAgentRepository = await loadStore();
+        const { cwd, dbPath } = fixture();
         const live = new Map([
             [
                 process.pid,
                 'owner-start'
             ]
         ]);
-        const store = new PrintAgentStore({
-            filePath,
+        const repository = new DurableAgentRepository({
+            dbPath,
             incompleteLockGraceMs: 10,
             processInspector: {
                 getIdentity: (pid)=>{
@@ -263,17 +220,13 @@ describe('PrintAgentStore run ownership', ()=>{
                 }
             }
         });
-        const agent = await store.create({
+        const agent = await repository.create({
             name: 'crashed',
             cwd
         });
-        await store.acquireRun(agent.id);
-        const lockPath = path.join(root, 'state', 'print-agent-locks', `${agent.id}.lock`);
-        fs.unlinkSync(path.join(lockPath, 'owner.json'));
-        const old = new Date(Date.now() - 1000);
-        fs.utimesSync(lockPath, old, old);
+        await repository.acquireRun(agent.id);
         live.clear();
-        const listed = await store.list();
+        const listed = await repository.list();
         expect(listed[0]).toMatchObject({
             state: 'degraded',
             sessionHealth: 'unknown',
@@ -284,12 +237,12 @@ describe('PrintAgentStore run ownership', ()=>{
         });
     });
     it('rejects send acquisition when the bound cwd is replaced by a symlink', async ()=>{
-        const PrintAgentStore = await loadStore();
-        const { root, cwd, filePath } = fixture();
-        const store = new PrintAgentStore({
-            filePath
+        const DurableAgentRepository = await loadStore();
+        const { root, cwd, dbPath } = fixture();
+        const repository = new DurableAgentRepository({
+            dbPath
         });
-        const agent = await store.create({
+        const agent = await repository.create({
             name: 'bound',
             cwd
         });
@@ -298,10 +251,10 @@ describe('PrintAgentStore run ownership', ()=>{
         fs.renameSync(cwd, moved);
         fs.mkdirSync(other);
         fs.symlinkSync(other, cwd);
-        await expect(store.acquireRun(agent.id)).rejects.toMatchObject({
-            code: 'PRINT_AGENT_STORE'
+        await expect(repository.acquireRun(agent.id)).rejects.toMatchObject({
+            code: 'DURABLE_AGENT_REPOSITORY'
         });
     });
 });
 
-//# sourceMappingURL=PrintAgentStore.test.js.map
+//# sourceMappingURL=DurableAgentRepository.test.js.map

package/dist/__tests__/print/DurableAgentRepository.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/print/DurableAgentRepository.test.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { afterEach, describe, expect, it } from 'vitest';\n\nconst tempDirs: string[] = [];\n\nafterEach(() => {\n    for (const dir of tempDirs.splice(0)) fs.rmSync(dir, { recursive: true, force: true });\n});\n\nasync function loadStore(): Promise<any> {\n    const api = await import('../../index.js') as Record<string, unknown>;\n    expect(api).toHaveProperty('DurableAgentRepository');\n    return api.DurableAgentRepository;\n}\n\nfunction fixture(): { root: string; cwd: string; dbPath: string } {\n    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'durable-agent-store-'));\n    tempDirs.push(root);\n    const cwd = path.join(root, 'project');\n    fs.mkdirSync(cwd);\n    return { root, cwd, dbPath: path.join(root, 'state', 'agents.db') };\n}\n\ndescribe('DurableAgentRepository create/list/resolve', () => {\n    it('creates distinct durable identities with a canonical cwd and lists them', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { cwd, dbPath } = fixture();\n        const repository = new DurableAgentRepository({ dbPath, now: () => new Date('2026-08-07T09:00:00Z') });\n\n        const agent = await repository.create({ name: 'reviewer', cwd });\n\n        expect(agent).toMatchObject({\n            name: 'reviewer',\n            provider: 'claude',\n            mode: 'durable',\n            cwd: fs.realpathSync(cwd),\n            state: 'ready',\n            sessionHealth: 'uninitialized',\n            activeRun: null,\n        });\n        expect(agent.id).toMatch(/^[0-9a-f-]{36}$/);\n        expect(agent.providerSessionId).toMatch(/^[0-9a-f-]{36}$/);\n        expect(agent.id).not.toBe(agent.providerSessionId);\n        expect(await repository.list()).toEqual([agent]);\n        expect(fs.existsSync(dbPath)).toBe(true);\n    });\n\n    it('resolves exact ids and names and rejects duplicate names', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { cwd, dbPath } = fixture();\n        const repository = new DurableAgentRepository({ dbPath });\n        const agent = await repository.create({ name: 'Reviewer', cwd });\n\n        expect(await repository.resolve(agent.id)).toMatchObject({ id: agent.id });\n        expect(await repository.resolve('reviewer')).toMatchObject({ id: agent.id });\n        expect(await repository.resolve('view')).toBeNull();\n        await expect(repository.create({ name: 'reviewer', cwd })).rejects.toMatchObject({\n            code: 'DURABLE_AGENT_NAME_CONFLICT',\n        });\n    });\n\n    it('rejects a missing cwd', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { root, dbPath } = fixture();\n        const repository = new DurableAgentRepository({ dbPath });\n\n        await expect(repository.create({ name: 'missing', cwd: path.join(root, 'missing') }))\n            .rejects.toMatchObject({ code: 'DURABLE_AGENT_REPOSITORY' });\n    });\n});\n\ndescribe('DurableAgentRepository run ownership', () => {\n    it('fails fast when another exact owner is live and completes only for its token', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { cwd, dbPath } = fixture();\n        const live = new Map<number, string>([[process.pid, 'owner-start']]);\n        const processInspector = { getIdentity: (pid: number) => {\n            const startedAt = live.get(pid);\n            return startedAt ? { pid, startedAt } : null;\n        } };\n        const repository = new DurableAgentRepository({ dbPath, processInspector });\n        const agent = await repository.create({ name: 'runner', cwd });\n\n        const acquired = await repository.acquireRun(agent.id);\n        await expect(repository.acquireRun(agent.id)).rejects.toMatchObject({ code: 'DURABLE_AGENT_BUSY' });\n        await expect(repository.completeRun(agent.id, 'wrong-token', {\n            status: 'succeeded', exitCode: 0, summary: 'done', sessionHealth: 'healthy',\n        })).rejects.toMatchObject({ code: 'DURABLE_AGENT_REPOSITORY' });\n\n        const completed = await repository.completeRun(agent.id, acquired.token, {\n            status: 'succeeded', exitCode: 0, summary: 'done', sessionHealth: 'healthy',\n        });\n        expect(completed).toMatchObject({ state: 'ready', sessionHealth: 'healthy', activeRun: null });\n    });\n\n    it('retains busy for a live provider then recovers a dead run without signaling it', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { cwd, dbPath } = fixture();\n        const live = new Map<number, string>([[process.pid, 'owner-start'], [4242, 'provider-start']]);\n        const processInspector = { getIdentity: (pid: number) => {\n            const startedAt = live.get(pid);\n            return startedAt ? { pid, startedAt } : null;\n        } };\n        const first = new DurableAgentRepository({ dbPath, processInspector });\n        const agent = await first.create({ name: 'recoverable', cwd });\n        const run = await first.acquireRun(agent.id);\n        await first.recordProviderProcess(agent.id, run.token, { pid: 4242, startedAt: 'provider-start' });\n\n        live.delete(process.pid);\n        await expect(first.acquireRun(agent.id)).rejects.toMatchObject({ code: 'DURABLE_AGENT_BUSY' });\n\n        live.delete(4242);\n        live.set(process.pid, 'replacement-owner-start');\n        const recovered = await first.acquireRun(agent.id);\n        expect(recovered.agent).toMatchObject({\n            state: 'running',\n            lastResult: { status: 'interrupted' },\n        });\n        await first.completeRun(agent.id, recovered.token, {\n            status: 'failed', exitCode: 1, summary: 'failed', sessionHealth: 'unknown',\n        });\n    });\n\n    it('reconciles an interrupted run to degraded during list', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { cwd, dbPath } = fixture();\n        const live = new Map<number, string>([[process.pid, 'owner-start']]);\n        const repository = new DurableAgentRepository({ dbPath, incompleteLockGraceMs: 10, processInspector: {\n            getIdentity: (pid: number) => {\n                const startedAt = live.get(pid);\n                return startedAt ? { pid, startedAt } : null;\n            },\n        } });\n        const agent = await repository.create({ name: 'crashed', cwd });\n        await repository.acquireRun(agent.id);\n        live.clear();\n\n        const listed = await repository.list();\n\n        expect(listed[0]).toMatchObject({\n            state: 'degraded',\n            sessionHealth: 'unknown',\n            activeRun: null,\n            lastResult: { status: 'interrupted' },\n        });\n    });\n\n    it('rejects send acquisition when the bound cwd is replaced by a symlink', async () => {\n        const DurableAgentRepository = await loadStore();\n        const { root, cwd, dbPath } = fixture();\n        const repository = new DurableAgentRepository({ dbPath });\n        const agent = await repository.create({ name: 'bound', cwd });\n        const moved = path.join(root, 'moved-project');\n        const other = path.join(root, 'other-project');\n        fs.renameSync(cwd, moved);\n        fs.mkdirSync(other);\n        fs.symlinkSync(other, cwd);\n\n        await expect(repository.acquireRun(agent.id)).rejects.toMatchObject({ code: 'DURABLE_AGENT_REPOSITORY' });\n    });\n});\n"],"names":["fs","os","path","afterEach","describe","expect","it","tempDirs","dir","splice","rmSync","recursive","force","loadStore","api","toHaveProperty","DurableAgentRepository","fixture","root","mkdtempSync","join","tmpdir","push","cwd","mkdirSync","dbPath","repository","now","Date","agent","create","name","toMatchObject","provider","mode","realpathSync","state","sessionHealth","activeRun","id","toMatch","providerSessionId","not","toBe","list","toEqual","existsSync","resolve","toBeNull","rejects","code","live","Map","process","pid","processInspector","getIdentity","startedAt","get","acquired","acquireRun","completeRun","status","exitCode","summary","completed","token","first","run","recordProviderProcess","delete","set","recovered","lastResult","incompleteLockGraceMs","clear","listed","moved","other","renameSync","symlinkSync"],"mappings":"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"}

package/dist/adapters/CodexAdapter.d.ts

@@ -104,5 +104,6 @@ export declare class CodexAdapter implements AgentAdapter {
      * lacks a session id.
      */
     private fileToSessionSummary;
+    private isSyntheticUserMessage;
 }
 //# sourceMappingURL=CodexAdapter.d.ts.map

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

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

package/dist/adapters/CodexAdapter.js

@@ -42,10 +42,13 @@ export class CodexAdapter {
         const relevant = filterByProcessNames(snapshot, this.processNames);
         const processes = relevant.filter((process1)=>this.canHandle(process1));
         if (processes.length === 0) return [];
-        const { cachedAgents, remaining } = this.tryRegistryCache(processes);
-        if (remaining.length === 0) return cachedAgents;
-        const mappingResult = this.mapSessionMappingMatches(remaining);
-        const { direct, fallback } = this.tryResumeMatching(mappingResult.fallback);
+        const mappingResult = this.mapSessionMappingMatches(processes);
+        const { cachedAgents, remaining } = this.tryRegistryCache(mappingResult.fallback);
+        if (remaining.length === 0) return [
+            ...mappingResult.agents,
+            ...cachedAgents
+        ];
+        const { direct, fallback } = this.tryResumeMatching(remaining);
         const directResult = this.mapDirectMatches(direct);
         const { sessions, contentCache } = this.discoverSessions(fallback);
         if (sessions.length === 0) {
@@ -678,8 +681,12 @@ export class CodexAdapter {
             }
             const ts = this.parseTimestamp(entry.timestamp);
             if (ts) lastTimestamp = ts;
-            if (!firstUserMessage && entry.payload?.type === 'user_message' && typeof entry.payload.message === 'string' && entry.payload.message.trim().length > 0) {
-                firstUserMessage = entry.payload.message.trim();
+            if (!firstUserMessage) {
+                const message = this.toConversationMessage(entry, false);
+                const content = message?.content.trim() ?? '';
+                if (message?.role === 'user' && content.length > 0 && !this.isSyntheticUserMessage(content)) {
+                    firstUserMessage = content;
+                }
             }
         }
         const stat = safeStat(filePath);
@@ -695,6 +702,9 @@ export class CodexAdapter {
             sessionFilePath: filePath
         };
     }
+    isSyntheticUserMessage(content) {
+        return content.startsWith('<environment_context>') && content.includes('</environment_context>');
+    }
 }
 
 //# sourceMappingURL=CodexAdapter.js.map