@ai-devkit/agent-manager 0.24.0 → 0.26.0

package/README.md

@@ -24,6 +24,20 @@ ai-devkit agent send "run the tests and report back" --id <agent-name> --wait
 npm test 2>&1 | ai-devkit agent send --id <agent-name> --stdin
 ```
 
+Claude Code can also be registered as a durable print-mode agent. Registration
+does not launch Claude; each send starts one synchronous process and later sends
+resume the same Claude session:
+
+```bash
+ai-devkit agent start --type claude --mode print --name reviewer --cwd /path/to/project
+ai-devkit agent send "review the current diff" --id reviewer
+```
+
+Print mode inherits Claude Code's settings, permissions, hooks, MCP servers, and
+tool side effects for that working directory. AI DevKit adds no permission bypass
+or automatic retry, and prompts are delivered over stdin rather than command-line
+arguments. `--timeout` is not supported for print agents in this first release.
+
 Use this package directly only when building custom tooling around AI DevKit's agent detection and control surface.
 
 ## Documentation

package/dist/__tests__/adapters/GrokCliAdapter.test.js

@@ -0,0 +1,403 @@
+/**
+ * Tests for GrokCliAdapter
+ *
+ * The adapter resolves a live process to its cwd via ~/.grok/active_sessions.json
+ * and reads session details from chat_history.jsonl (not summary.json/updates.jsonl).
+ */ import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { GrokCliAdapter } from '../../adapters/GrokCliAdapter.js';
+import { AgentStatus } from '../../adapters/AgentAdapter.js';
+import { listAgentProcesses, enrichProcesses } from '../../utils/process.js';
+import { generateAgentName } from '../../utils/matching.js';
+vi.mock('../../utils/process.js', async (importOriginal)=>{
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        listAgentProcesses: vi.fn(),
+        enrichProcesses: vi.fn()
+    };
+});
+vi.mock('../../utils/matching.js', async (importOriginal)=>{
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        generateAgentName: vi.fn()
+    };
+});
+const mockedListAgentProcesses = listAgentProcesses;
+const mockedEnrichProcesses = enrichProcesses;
+const mockedGenerateAgentName = generateAgentName;
+const SESSION_ID = '019f16c3-5d5d-7dc3-85d1-bc629416ca2d';
+/** A user transcript record: the real prompt wrapped in <user_query> like Grok writes it. */ const userRecord = (text)=>({
+        type: 'user',
+        content: [
+            {
+                type: 'text',
+                text: `<user_query>\n${text}\n</user_query>`
+            }
+        ]
+    });
+/** A user context-injection record (no <user_query>) — should be ignored as a prompt. */ const contextRecord = (text)=>({
+        type: 'user',
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    });
+const assistantRecord = (text)=>({
+        type: 'assistant',
+        content: [
+            {
+                type: 'text',
+                text
+            }
+        ]
+    });
+const systemRecord = (text)=>({
+        type: 'system',
+        content: text
+    });
+describe('GrokCliAdapter', ()=>{
+    let adapter;
+    let tmpHome;
+    let cwd;
+    beforeEach(()=>{
+        tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'grok-adapter-test-'));
+        process.env.HOME = tmpHome;
+        delete process.env.GROK_HOME;
+        cwd = '/Users/dev/my-project';
+        adapter = new GrokCliAdapter();
+        mockedListAgentProcesses.mockReset();
+        mockedEnrichProcesses.mockReset();
+        mockedGenerateAgentName.mockReset();
+        mockedEnrichProcesses.mockImplementation((procs)=>procs);
+        mockedGenerateAgentName.mockImplementation((c, pid)=>`${path.basename(c) || 'unknown'}-${pid}`);
+    });
+    afterEach(()=>{
+        fs.rmSync(tmpHome, {
+            recursive: true,
+            force: true
+        });
+    });
+    /** Write a session dir under ~/.grok/sessions/<enc(cwd)>/<id>/chat_history.jsonl. */ function writeSession(opts) {
+        const sessionCwd = opts.sessionCwd ?? cwd;
+        const id = opts.id ?? SESSION_ID;
+        const sessionDir = path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(sessionCwd), id);
+        fs.mkdirSync(sessionDir, {
+            recursive: true
+        });
+        if (opts.chat !== false) {
+            const records = opts.records ?? [
+                userRecord('fix the bug')
+            ];
+            const chatPath = path.join(sessionDir, 'chat_history.jsonl');
+            fs.writeFileSync(chatPath, records.map((r)=>JSON.stringify(r)).join('\n'));
+            if (opts.mtime) fs.utimesSync(chatPath, opts.mtime, opts.mtime);
+        }
+        return sessionDir;
+    }
+    /** Write ~/.grok/active_sessions.json (the live pid -> cwd registry). */ function writeActiveSessions(entries) {
+        fs.mkdirSync(path.join(tmpHome, '.grok'), {
+            recursive: true
+        });
+        fs.writeFileSync(path.join(tmpHome, '.grok', 'active_sessions.json'), JSON.stringify(entries));
+    }
+    function proc(overrides = {}) {
+        return {
+            pid: 4242,
+            ppid: 1,
+            command: 'grok',
+            cwd,
+            tty: 'ttys010',
+            startTime: new Date(),
+            ...overrides
+        };
+    }
+    describe('initialization', ()=>{
+        it('exposes the grok_cli type', ()=>{
+            expect(adapter.type).toBe('grok_cli');
+        });
+    });
+    describe('canHandle', ()=>{
+        it('returns true for a plain grok command', ()=>{
+            expect(adapter.canHandle(proc({
+                command: 'grok'
+            }))).toBe(true);
+        });
+        it('returns true for grok with a full path and args', ()=>{
+            expect(adapter.canHandle(proc({
+                command: '/Users/dev/.grok/bin/grok --always-approve'
+            }))).toBe(true);
+        });
+        it('returns false for non-grok processes', ()=>{
+            expect(adapter.canHandle(proc({
+                command: 'node app.js'
+            }))).toBe(false);
+        });
+        it('returns false when "grok" appears only in an argument path', ()=>{
+            expect(adapter.canHandle(proc({
+                command: 'node /path/to/grok-thing.js'
+            }))).toBe(false);
+        });
+    });
+    describe('detectAgents', ()=>{
+        it('returns [] when there are no grok processes', async ()=>{
+            mockedListAgentProcesses.mockReturnValue([]);
+            expect(await adapter.detectAgents()).toEqual([]);
+        });
+        it('resolves the cwd via active_sessions.json (authoritative over the process cwd)', async ()=>{
+            const realCwd = '/Users/dev/real-project';
+            writeSession({
+                sessionCwd: realCwd
+            });
+            // The process cwd is stale/wrong; active_sessions.json has the truth.
+            writeActiveSessions([
+                {
+                    pid: 4242,
+                    cwd: realCwd,
+                    opened_at: 1
+                }
+            ]);
+            mockedListAgentProcesses.mockReturnValue([
+                proc({
+                    cwd: '/wrong/path'
+                })
+            ]);
+            const agents = await adapter.detectAgents();
+            expect(agents).toHaveLength(1);
+            expect(agents[0]).toMatchObject({
+                type: 'grok_cli',
+                pid: 4242,
+                projectPath: realCwd,
+                sessionId: SESSION_ID,
+                summary: 'fix the bug'
+            });
+            expect(agents[0].sessionFilePath).toBe(path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(realCwd), SESSION_ID, 'chat_history.jsonl'));
+        });
+        it('falls back to the process cwd when the pid is not in active_sessions.json', async ()=>{
+            writeSession({});
+            writeActiveSessions([
+                {
+                    pid: 9999,
+                    cwd: '/somewhere/else'
+                }
+            ]);
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            const agents = await adapter.detectAgents();
+            expect(agents[0]).toMatchObject({
+                projectPath: cwd,
+                sessionId: SESSION_ID
+            });
+        });
+        it('picks the most recently active session dir when a cwd has several', async ()=>{
+            const older = new Date(Date.now() - 60 * 60 * 1000);
+            writeSession({
+                id: '019f0000-0000-7000-8000-00000000000a',
+                records: [
+                    userRecord('old one')
+                ],
+                mtime: older
+            });
+            writeSession({
+                id: '019f0000-0000-7000-8000-00000000000b',
+                records: [
+                    userRecord('newest one')
+                ]
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            const agents = await adapter.detectAgents();
+            expect(agents[0].sessionId).toBe('019f0000-0000-7000-8000-00000000000b');
+            expect(agents[0].summary).toBe('newest one');
+        });
+        it('falls back to a process-only RUNNING agent when no session matches', async ()=>{
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            const agents = await adapter.detectAgents();
+            expect(agents).toHaveLength(1);
+            expect(agents[0].status).toBe(AgentStatus.RUNNING);
+            expect(agents[0].sessionId).toBe('pid-4242');
+            expect(agents[0].sessionFilePath).toBeUndefined();
+        });
+        it('treats a session dir without chat_history.jsonl as no match (process-only)', async ()=>{
+            writeSession({
+                chat: false
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            const agents = await adapter.detectAgents();
+            expect(agents).toHaveLength(1);
+            expect(agents[0].sessionId).toBe('pid-4242');
+        });
+    });
+    describe('getConversation', ()=>{
+        it('maps user (<user_query>) and assistant records to roles', ()=>{
+            const dir = writeSession({
+                records: [
+                    userRecord('hi'),
+                    assistantRecord('hello')
+                ]
+            });
+            expect(adapter.getConversation(path.join(dir, 'chat_history.jsonl'))).toEqual([
+                {
+                    role: 'user',
+                    content: 'hi'
+                },
+                {
+                    role: 'assistant',
+                    content: 'hello'
+                }
+            ]);
+        });
+        it('accepts a session dir path and skips context-injection user records', ()=>{
+            const dir = writeSession({
+                records: [
+                    contextRecord('<user_info>OS: macos</user_info>'),
+                    userRecord('do the thing')
+                ]
+            });
+            expect(adapter.getConversation(dir)).toEqual([
+                {
+                    role: 'user',
+                    content: 'do the thing'
+                }
+            ]);
+        });
+        it('skips malformed lines', ()=>{
+            const dir = writeSession({
+                records: [
+                    userRecord('hi')
+                ]
+            });
+            fs.appendFileSync(path.join(dir, 'chat_history.jsonl'), '\n{bad json');
+            expect(adapter.getConversation(dir)).toEqual([
+                {
+                    role: 'user',
+                    content: 'hi'
+                }
+            ]);
+        });
+        it('excludes system records unless verbose', ()=>{
+            const dir = writeSession({
+                records: [
+                    systemRecord('You are Grok'),
+                    userRecord('go')
+                ]
+            });
+            expect(adapter.getConversation(dir)).toEqual([
+                {
+                    role: 'user',
+                    content: 'go'
+                }
+            ]);
+            expect(adapter.getConversation(dir, {
+                verbose: true
+            }).map((m)=>m.role)).toEqual([
+                'system',
+                'user'
+            ]);
+        });
+    });
+    describe('detectAgents status + summary mapping', ()=>{
+        const detectFirst = async ()=>(await adapter.detectAgents())[0];
+        it('marks WAITING when the last transcript turn is an assistant message', async ()=>{
+            writeSession({
+                records: [
+                    userRecord('go'),
+                    assistantRecord('done')
+                ]
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            expect((await detectFirst()).status).toBe(AgentStatus.WAITING);
+        });
+        it('marks RUNNING when the last transcript turn is a user message', async ()=>{
+            writeSession({
+                records: [
+                    userRecord('still there?')
+                ]
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            expect((await detectFirst()).status).toBe(AgentStatus.RUNNING);
+        });
+        it('marks IDLE when chat_history.jsonl is older than the threshold', async ()=>{
+            const old = new Date(Date.now() - 10 * 60 * 1000);
+            writeSession({
+                records: [
+                    userRecord('go')
+                ],
+                mtime: old
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            expect((await detectFirst()).status).toBe(AgentStatus.IDLE);
+        });
+        it('uses the last user prompt as the agent summary', async ()=>{
+            writeSession({
+                records: [
+                    userRecord('refactor the parser'),
+                    assistantRecord('on it')
+                ]
+            });
+            mockedListAgentProcesses.mockReturnValue([
+                proc()
+            ]);
+            expect((await detectFirst()).summary).toBe('refactor the parser');
+        });
+    });
+    describe('listSessions', ()=>{
+        it('returns [] when the sessions dir does not exist', async ()=>{
+            expect(await adapter.listSessions()).toEqual([]);
+        });
+        it('lists historical sessions with cwd decoded from the group dir', async ()=>{
+            writeSession({});
+            const summaries = await adapter.listSessions();
+            expect(summaries).toHaveLength(1);
+            expect(summaries[0]).toMatchObject({
+                type: 'grok_cli',
+                sessionId: SESSION_ID,
+                cwd,
+                firstUserMessage: 'fix the bug'
+            });
+            expect(summaries[0].sessionFilePath).toBe(path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(cwd), SESSION_ID, 'chat_history.jsonl'));
+        });
+        it('applies the cwd filter against the decoded cwd', async ()=>{
+            writeSession({
+                sessionCwd: '/Users/dev/project-a',
+                id: '019f0000-0000-7000-8000-00000000000a'
+            });
+            writeSession({
+                sessionCwd: '/Users/dev/project-b',
+                id: '019f0000-0000-7000-8000-00000000000b'
+            });
+            const all = await adapter.listSessions();
+            expect(all).toHaveLength(2);
+            const filtered = await adapter.listSessions({
+                cwd: '/Users/dev/project-a'
+            });
+            expect(filtered).toHaveLength(1);
+            expect(filtered[0].cwd).toBe('/Users/dev/project-a');
+        });
+        it('skips non-session entries (e.g. prompt_history.jsonl) in a group dir', async ()=>{
+            writeSession({});
+            // Grok writes a group-level prompt_history.jsonl alongside session dirs.
+            fs.writeFileSync(path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(cwd), 'prompt_history.jsonl'), '{"text":"noise"}');
+            const summaries = await adapter.listSessions();
+            expect(summaries).toHaveLength(1);
+        });
+    });
+});
+
+//# sourceMappingURL=GrokCliAdapter.test.js.map

package/dist/__tests__/adapters/GrokCliAdapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/adapters/GrokCliAdapter.test.ts"],"sourcesContent":["/**\n * Tests for GrokCliAdapter\n *\n * The adapter resolves a live process to its cwd via ~/.grok/active_sessions.json\n * and reads session details from chat_history.jsonl (not summary.json/updates.jsonl).\n */\n\nimport type { MockedFunction } from 'vitest';\nimport * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\n\nimport { GrokCliAdapter } from '../../adapters/GrokCliAdapter.js';\nimport type { ProcessInfo } from '../../adapters/AgentAdapter.js';\nimport { AgentStatus } from '../../adapters/AgentAdapter.js';\nimport { listAgentProcesses, enrichProcesses } from '../../utils/process.js';\nimport { generateAgentName } from '../../utils/matching.js';\n\nvi.mock('../../utils/process.js', async (importOriginal) => {\n    const actual = (await importOriginal()) as typeof import('../../utils/process.js');\n    return {\n        ...actual,\n        listAgentProcesses: vi.fn(),\n        enrichProcesses: vi.fn(),\n    };\n});\n\nvi.mock('../../utils/matching.js', async (importOriginal) => {\n    const actual = (await importOriginal()) as typeof import('../../utils/matching.js');\n    return {\n        ...actual,\n        generateAgentName: vi.fn(),\n    };\n});\n\nconst mockedListAgentProcesses = listAgentProcesses as MockedFunction<typeof listAgentProcesses>;\nconst mockedEnrichProcesses = enrichProcesses as MockedFunction<typeof enrichProcesses>;\nconst mockedGenerateAgentName = generateAgentName as MockedFunction<typeof generateAgentName>;\n\nconst SESSION_ID = '019f16c3-5d5d-7dc3-85d1-bc629416ca2d';\n\n/** A user transcript record: the real prompt wrapped in <user_query> like Grok writes it. */\nconst userRecord = (text: string) => ({\n    type: 'user',\n    content: [{ type: 'text', text: `<user_query>\\n${text}\\n</user_query>` }],\n});\n/** A user context-injection record (no <user_query>) — should be ignored as a prompt. */\nconst contextRecord = (text: string) => ({ type: 'user', content: [{ type: 'text', text }] });\nconst assistantRecord = (text: string) => ({ type: 'assistant', content: [{ type: 'text', text }] });\nconst systemRecord = (text: string) => ({ type: 'system', content: text });\n\ndescribe('GrokCliAdapter', () => {\n    let adapter: GrokCliAdapter;\n    let tmpHome: string;\n    let cwd: string;\n\n    beforeEach(() => {\n        tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'grok-adapter-test-'));\n        process.env.HOME = tmpHome;\n        delete process.env.GROK_HOME;\n        cwd = '/Users/dev/my-project';\n\n        adapter = new GrokCliAdapter();\n\n        mockedListAgentProcesses.mockReset();\n        mockedEnrichProcesses.mockReset();\n        mockedGenerateAgentName.mockReset();\n\n        mockedEnrichProcesses.mockImplementation((procs) => procs);\n        mockedGenerateAgentName.mockImplementation((c: string, pid: number) => `${path.basename(c) || 'unknown'}-${pid}`);\n    });\n\n    afterEach(() => {\n        fs.rmSync(tmpHome, { recursive: true, force: true });\n    });\n\n    /** Write a session dir under ~/.grok/sessions/<enc(cwd)>/<id>/chat_history.jsonl. */\n    function writeSession(opts: {\n        sessionCwd?: string;\n        id?: string;\n        records?: object[];\n        chat?: boolean;\n        mtime?: Date;\n    }): string {\n        const sessionCwd = opts.sessionCwd ?? cwd;\n        const id = opts.id ?? SESSION_ID;\n        const sessionDir = path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(sessionCwd), id);\n        fs.mkdirSync(sessionDir, { recursive: true });\n\n        if (opts.chat !== false) {\n            const records = opts.records ?? [userRecord('fix the bug')];\n            const chatPath = path.join(sessionDir, 'chat_history.jsonl');\n            fs.writeFileSync(chatPath, records.map((r) => JSON.stringify(r)).join('\\n'));\n            if (opts.mtime) fs.utimesSync(chatPath, opts.mtime, opts.mtime);\n        }\n\n        return sessionDir;\n    }\n\n    /** Write ~/.grok/active_sessions.json (the live pid -> cwd registry). */\n    function writeActiveSessions(entries: Array<{ pid: number; cwd: string; opened_at?: number }>): void {\n        fs.mkdirSync(path.join(tmpHome, '.grok'), { recursive: true });\n        fs.writeFileSync(path.join(tmpHome, '.grok', 'active_sessions.json'), JSON.stringify(entries));\n    }\n\n    function proc(overrides: Partial<ProcessInfo> = {}): ProcessInfo {\n        return { pid: 4242, ppid: 1, command: 'grok', cwd, tty: 'ttys010', startTime: new Date(), ...overrides };\n    }\n\n    describe('initialization', () => {\n        it('exposes the grok_cli type', () => {\n            expect(adapter.type).toBe('grok_cli');\n        });\n    });\n\n    describe('canHandle', () => {\n        it('returns true for a plain grok command', () => {\n            expect(adapter.canHandle(proc({ command: 'grok' }))).toBe(true);\n        });\n\n        it('returns true for grok with a full path and args', () => {\n            expect(adapter.canHandle(proc({ command: '/Users/dev/.grok/bin/grok --always-approve' }))).toBe(true);\n        });\n\n        it('returns false for non-grok processes', () => {\n            expect(adapter.canHandle(proc({ command: 'node app.js' }))).toBe(false);\n        });\n\n        it('returns false when \"grok\" appears only in an argument path', () => {\n            expect(adapter.canHandle(proc({ command: 'node /path/to/grok-thing.js' }))).toBe(false);\n        });\n    });\n\n    describe('detectAgents', () => {\n        it('returns [] when there are no grok processes', async () => {\n            mockedListAgentProcesses.mockReturnValue([]);\n            expect(await adapter.detectAgents()).toEqual([]);\n        });\n\n        it('resolves the cwd via active_sessions.json (authoritative over the process cwd)', async () => {\n            const realCwd = '/Users/dev/real-project';\n            writeSession({ sessionCwd: realCwd });\n            // The process cwd is stale/wrong; active_sessions.json has the truth.\n            writeActiveSessions([{ pid: 4242, cwd: realCwd, opened_at: 1 }]);\n            mockedListAgentProcesses.mockReturnValue([proc({ cwd: '/wrong/path' })]);\n\n            const agents = await adapter.detectAgents();\n\n            expect(agents).toHaveLength(1);\n            expect(agents[0]).toMatchObject({\n                type: 'grok_cli',\n                pid: 4242,\n                projectPath: realCwd,\n                sessionId: SESSION_ID,\n                summary: 'fix the bug',\n            });\n            expect(agents[0].sessionFilePath).toBe(\n                path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(realCwd), SESSION_ID, 'chat_history.jsonl'),\n            );\n        });\n\n        it('falls back to the process cwd when the pid is not in active_sessions.json', async () => {\n            writeSession({});\n            writeActiveSessions([{ pid: 9999, cwd: '/somewhere/else' }]);\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n\n            const agents = await adapter.detectAgents();\n\n            expect(agents[0]).toMatchObject({ projectPath: cwd, sessionId: SESSION_ID });\n        });\n\n        it('picks the most recently active session dir when a cwd has several', async () => {\n            const older = new Date(Date.now() - 60 * 60 * 1000);\n            writeSession({ id: '019f0000-0000-7000-8000-00000000000a', records: [userRecord('old one')], mtime: older });\n            writeSession({ id: '019f0000-0000-7000-8000-00000000000b', records: [userRecord('newest one')] });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n\n            const agents = await adapter.detectAgents();\n\n            expect(agents[0].sessionId).toBe('019f0000-0000-7000-8000-00000000000b');\n            expect(agents[0].summary).toBe('newest one');\n        });\n\n        it('falls back to a process-only RUNNING agent when no session matches', async () => {\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n\n            const agents = await adapter.detectAgents();\n\n            expect(agents).toHaveLength(1);\n            expect(agents[0].status).toBe(AgentStatus.RUNNING);\n            expect(agents[0].sessionId).toBe('pid-4242');\n            expect(agents[0].sessionFilePath).toBeUndefined();\n        });\n\n        it('treats a session dir without chat_history.jsonl as no match (process-only)', async () => {\n            writeSession({ chat: false });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n\n            const agents = await adapter.detectAgents();\n\n            expect(agents).toHaveLength(1);\n            expect(agents[0].sessionId).toBe('pid-4242');\n        });\n    });\n\n    describe('getConversation', () => {\n        it('maps user (<user_query>) and assistant records to roles', () => {\n            const dir = writeSession({ records: [userRecord('hi'), assistantRecord('hello')] });\n            expect(adapter.getConversation(path.join(dir, 'chat_history.jsonl'))).toEqual([\n                { role: 'user', content: 'hi' },\n                { role: 'assistant', content: 'hello' },\n            ]);\n        });\n\n        it('accepts a session dir path and skips context-injection user records', () => {\n            const dir = writeSession({\n                records: [contextRecord('<user_info>OS: macos</user_info>'), userRecord('do the thing')],\n            });\n            expect(adapter.getConversation(dir)).toEqual([{ role: 'user', content: 'do the thing' }]);\n        });\n\n        it('skips malformed lines', () => {\n            const dir = writeSession({ records: [userRecord('hi')] });\n            fs.appendFileSync(path.join(dir, 'chat_history.jsonl'), '\\n{bad json');\n            expect(adapter.getConversation(dir)).toEqual([{ role: 'user', content: 'hi' }]);\n        });\n\n        it('excludes system records unless verbose', () => {\n            const dir = writeSession({ records: [systemRecord('You are Grok'), userRecord('go')] });\n            expect(adapter.getConversation(dir)).toEqual([{ role: 'user', content: 'go' }]);\n            expect(adapter.getConversation(dir, { verbose: true }).map((m) => m.role)).toEqual(['system', 'user']);\n        });\n    });\n\n    describe('detectAgents status + summary mapping', () => {\n        const detectFirst = async () => (await adapter.detectAgents())[0];\n\n        it('marks WAITING when the last transcript turn is an assistant message', async () => {\n            writeSession({ records: [userRecord('go'), assistantRecord('done')] });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n            expect((await detectFirst()).status).toBe(AgentStatus.WAITING);\n        });\n\n        it('marks RUNNING when the last transcript turn is a user message', async () => {\n            writeSession({ records: [userRecord('still there?')] });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n            expect((await detectFirst()).status).toBe(AgentStatus.RUNNING);\n        });\n\n        it('marks IDLE when chat_history.jsonl is older than the threshold', async () => {\n            const old = new Date(Date.now() - 10 * 60 * 1000);\n            writeSession({ records: [userRecord('go')], mtime: old });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n            expect((await detectFirst()).status).toBe(AgentStatus.IDLE);\n        });\n\n        it('uses the last user prompt as the agent summary', async () => {\n            writeSession({ records: [userRecord('refactor the parser'), assistantRecord('on it')] });\n            mockedListAgentProcesses.mockReturnValue([proc()]);\n            expect((await detectFirst()).summary).toBe('refactor the parser');\n        });\n    });\n\n    describe('listSessions', () => {\n        it('returns [] when the sessions dir does not exist', async () => {\n            expect(await adapter.listSessions()).toEqual([]);\n        });\n\n        it('lists historical sessions with cwd decoded from the group dir', async () => {\n            writeSession({});\n            const summaries = await adapter.listSessions();\n            expect(summaries).toHaveLength(1);\n            expect(summaries[0]).toMatchObject({\n                type: 'grok_cli',\n                sessionId: SESSION_ID,\n                cwd,\n                firstUserMessage: 'fix the bug',\n            });\n            expect(summaries[0].sessionFilePath).toBe(\n                path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(cwd), SESSION_ID, 'chat_history.jsonl'),\n            );\n        });\n\n        it('applies the cwd filter against the decoded cwd', async () => {\n            writeSession({ sessionCwd: '/Users/dev/project-a', id: '019f0000-0000-7000-8000-00000000000a' });\n            writeSession({ sessionCwd: '/Users/dev/project-b', id: '019f0000-0000-7000-8000-00000000000b' });\n\n            const all = await adapter.listSessions();\n            expect(all).toHaveLength(2);\n\n            const filtered = await adapter.listSessions({ cwd: '/Users/dev/project-a' });\n            expect(filtered).toHaveLength(1);\n            expect(filtered[0].cwd).toBe('/Users/dev/project-a');\n        });\n\n        it('skips non-session entries (e.g. prompt_history.jsonl) in a group dir', async () => {\n            writeSession({});\n            // Grok writes a group-level prompt_history.jsonl alongside session dirs.\n            fs.writeFileSync(\n                path.join(tmpHome, '.grok', 'sessions', encodeURIComponent(cwd), 'prompt_history.jsonl'),\n                '{\"text\":\"noise\"}',\n            );\n            const summaries = await adapter.listSessions();\n            expect(summaries).toHaveLength(1);\n        });\n    });\n});\n"],"names":["fs","os","path","GrokCliAdapter","AgentStatus","listAgentProcesses","enrichProcesses","generateAgentName","vi","mock","importOriginal","actual","fn","mockedListAgentProcesses","mockedEnrichProcesses","mockedGenerateAgentName","SESSION_ID","userRecord","text","type","content","contextRecord","assistantRecord","systemRecord","describe","adapter","tmpHome","cwd","beforeEach","mkdtempSync","join","tmpdir","process","env","HOME","GROK_HOME","mockReset","mockImplementation","procs","c","pid","basename","afterEach","rmSync","recursive","force","writeSession","opts","sessionCwd","id","sessionDir","encodeURIComponent","mkdirSync","chat","records","chatPath","writeFileSync","map","r","JSON","stringify","mtime","utimesSync","writeActiveSessions","entries","proc","overrides","ppid","command","tty","startTime","Date","it","expect","toBe","canHandle","mockReturnValue","detectAgents","toEqual","realCwd","opened_at","agents","toHaveLength","toMatchObject","projectPath","sessionId","summary","sessionFilePath","older","now","status","RUNNING","toBeUndefined","dir","getConversation","role","appendFileSync","verbose","m","detectFirst","WAITING","old","IDLE","listSessions","summaries","firstUserMessage","all","filtered"],"mappings":"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"}

package/dist/__tests__/print/ClaudeCliProbe.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it, vi } from 'vitest';
+describe('ClaudeCliProbe', ()=>{
+    it('validates only version/help and requires the print session flags', async ()=>{
+        const api = await import('../../index.js');
+        expect(api).toHaveProperty('ClaudeCliProbe');
+        const exec = vi.fn().mockResolvedValueOnce({
+            stdout: '2.1.220\n',
+            stderr: ''
+        }).mockResolvedValueOnce({
+            stdout: '--print --session-id --resume --output-format stream-json',
+            stderr: ''
+        });
+        const Probe = api.ClaudeCliProbe;
+        await expect(new Probe({
+            exec
+        }).validate()).resolves.toEqual({
+            executable: 'claude',
+            version: '2.1.220'
+        });
+        expect(exec.mock.calls).toEqual([
+            [
+                'claude',
+                [
+                    '--version'
+                ]
+            ],
+            [
+                'claude',
+                [
+                    '--help'
+                ]
+            ]
+        ]);
+    });
+    it('rejects a CLI missing a required capability', async ()=>{
+        const api = await import('../../index.js');
+        const exec = vi.fn().mockResolvedValueOnce({
+            stdout: 'old',
+            stderr: ''
+        }).mockResolvedValueOnce({
+            stdout: '--print only',
+            stderr: ''
+        });
+        const Probe = api.ClaudeCliProbe;
+        await expect(new Probe({
+            exec
+        }).validate()).rejects.toMatchObject({
+            code: 'CLAUDE_CLI_UNSUPPORTED'
+        });
+    });
+});
+
+//# sourceMappingURL=ClaudeCliProbe.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/print/ClaudeCliProbe.test.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest';\n\ndescribe('ClaudeCliProbe', () => {\n    it('validates only version/help and requires the print session flags', async () => {\n        const api = await import('../../index.js') as Record<string, unknown>;\n        expect(api).toHaveProperty('ClaudeCliProbe');\n        const exec = vi.fn()\n            .mockResolvedValueOnce({ stdout: '2.1.220\\n', stderr: '' })\n            .mockResolvedValueOnce({\n                stdout: '--print --session-id --resume --output-format stream-json', stderr: '',\n            });\n        const Probe = api.ClaudeCliProbe as new (options: unknown) => { validate(): Promise<unknown> };\n\n        await expect(new Probe({ exec }).validate()).resolves.toEqual({\n            executable: 'claude', version: '2.1.220',\n        });\n        expect(exec.mock.calls).toEqual([\n            ['claude', ['--version']],\n            ['claude', ['--help']],\n        ]);\n    });\n\n    it('rejects a CLI missing a required capability', async () => {\n        const api = await import('../../index.js') as Record<string, unknown>;\n        const exec = vi.fn()\n            .mockResolvedValueOnce({ stdout: 'old', stderr: '' })\n            .mockResolvedValueOnce({ stdout: '--print only', stderr: '' });\n        const Probe = api.ClaudeCliProbe as new (options: unknown) => { validate(): Promise<unknown> };\n\n        await expect(new Probe({ exec }).validate()).rejects.toMatchObject({ code: 'CLAUDE_CLI_UNSUPPORTED' });\n    });\n});\n"],"names":["describe","expect","it","vi","api","toHaveProperty","exec","fn","mockResolvedValueOnce","stdout","stderr","Probe","ClaudeCliProbe","validate","resolves","toEqual","executable","version","mock","calls","rejects","toMatchObject","code"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAS;AAElDH,SAAS,kBAAkB;IACvBE,GAAG,oEAAoE;QACnE,MAAME,MAAM,MAAM,MAAM,CAAC;QACzBH,OAAOG,KAAKC,cAAc,CAAC;QAC3B,MAAMC,OAAOH,GAAGI,EAAE,GACbC,qBAAqB,CAAC;YAAEC,QAAQ;YAAaC,QAAQ;QAAG,GACxDF,qBAAqB,CAAC;YACnBC,QAAQ;YAA6DC,QAAQ;QACjF;QACJ,MAAMC,QAAQP,IAAIQ,cAAc;QAEhC,MAAMX,OAAO,IAAIU,MAAM;YAAEL;QAAK,GAAGO,QAAQ,IAAIC,QAAQ,CAACC,OAAO,CAAC;YAC1DC,YAAY;YAAUC,SAAS;QACnC;QACAhB,OAAOK,KAAKY,IAAI,CAACC,KAAK,EAAEJ,OAAO,CAAC;YAC5B;gBAAC;gBAAU;oBAAC;iBAAY;aAAC;YACzB;gBAAC;gBAAU;oBAAC;iBAAS;aAAC;SACzB;IACL;IAEAb,GAAG,+CAA+C;QAC9C,MAAME,MAAM,MAAM,MAAM,CAAC;QACzB,MAAME,OAAOH,GAAGI,EAAE,GACbC,qBAAqB,CAAC;YAAEC,QAAQ;YAAOC,QAAQ;QAAG,GAClDF,qBAAqB,CAAC;YAAEC,QAAQ;YAAgBC,QAAQ;QAAG;QAChE,MAAMC,QAAQP,IAAIQ,cAAc;QAEhC,MAAMX,OAAO,IAAIU,MAAM;YAAEL;QAAK,GAAGO,QAAQ,IAAIO,OAAO,CAACC,aAAa,CAAC;YAAEC,MAAM;QAAyB;IACxG;AACJ"}

package/dist/__tests__/print/ClaudePrintAgent.integration.test.js

@@ -0,0 +1,69 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterEach, describe, expect, it } from 'vitest';
+import { ClaudeCliProbe, ClaudePrintAgentService, ClaudePrintRunner, PrintAgentStore } from '../../index.js';
+const roots = [];
+const originalCapture = process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE;
+afterEach(()=>{
+    if (originalCapture === undefined) delete process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE;
+    else process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE = originalCapture;
+    for (const root of roots.splice(0))fs.rmSync(root, {
+        recursive: true,
+        force: true
+    });
+});
+describe('Claude print-agent fake-provider journey', ()=>{
+    it('creates without invocation, then starts and resumes the same session through stdin', async ()=>{
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'print-agent-integration-'));
+        roots.push(root);
+        const cwd = path.join(root, 'project');
+        fs.mkdirSync(cwd);
+        const capture = path.join(root, 'capture.jsonl');
+        process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE = capture;
+        const executable = fileURLToPath(new URL('../fixtures/fake-claude.cjs', import.meta.url));
+        const store = new PrintAgentStore({
+            filePath: path.join(root, 'state', 'print-agents.json')
+        });
+        const service = new ClaudePrintAgentService({
+            store,
+            probe: new ClaudeCliProbe({
+                executable
+            }),
+            runner: new ClaudePrintRunner(),
+            executable
+        });
+        const created = await service.create({
+            name: 'reviewer',
+            cwd
+        });
+        expect(fs.existsSync(capture)).toBe(false);
+        await expect(service.send(created.id, 'first secret')).resolves.toMatchObject({
+            result: 'answer:first secret'
+        });
+        await expect(service.send(created.id, 'follow up')).resolves.toMatchObject({
+            result: 'answer:follow up'
+        });
+        const invocations = fs.readFileSync(capture, 'utf8').trim().split('\n').map((line)=>JSON.parse(line));
+        expect(invocations[0]).toMatchObject({
+            prompt: 'first secret',
+            cwd: fs.realpathSync(cwd)
+        });
+        expect(invocations[0].args).toContain('--session-id');
+        expect(invocations[0].args).not.toContain('first secret');
+        expect(invocations[1]).toMatchObject({
+            prompt: 'follow up',
+            cwd: fs.realpathSync(cwd)
+        });
+        expect(invocations[1].args).toContain('--resume');
+        expect(invocations[1].args[invocations[1].args.indexOf('--resume') + 1]).toBe(created.providerSessionId);
+        const persisted = await store.getById(created.id);
+        expect(persisted).toMatchObject({
+            state: 'ready',
+            sessionHealth: 'healthy'
+        });
+    });
+});
+
+//# sourceMappingURL=ClaudePrintAgent.integration.test.js.map

package/dist/__tests__/print/ClaudePrintAgent.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/print/ClaudePrintAgent.integration.test.ts"],"sourcesContent":["import fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { afterEach, describe, expect, it } from 'vitest';\nimport {\n    ClaudeCliProbe,\n    ClaudePrintAgentService,\n    ClaudePrintRunner,\n    PrintAgentStore,\n} from '../../index.js';\n\nconst roots: string[] = [];\nconst originalCapture = process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE;\n\nafterEach(() => {\n    if (originalCapture === undefined) delete process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE;\n    else process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE = originalCapture;\n    for (const root of roots.splice(0)) fs.rmSync(root, { recursive: true, force: true });\n});\n\ndescribe('Claude print-agent fake-provider journey', () => {\n    it('creates without invocation, then starts and resumes the same session through stdin', async () => {\n        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'print-agent-integration-'));\n        roots.push(root);\n        const cwd = path.join(root, 'project');\n        fs.mkdirSync(cwd);\n        const capture = path.join(root, 'capture.jsonl');\n        process.env.AI_DEVKIT_FAKE_CLAUDE_CAPTURE = capture;\n        const executable = fileURLToPath(new URL('../fixtures/fake-claude.cjs', import.meta.url));\n        const store = new PrintAgentStore({ filePath: path.join(root, 'state', 'print-agents.json') });\n        const service = new ClaudePrintAgentService({\n            store,\n            probe: new ClaudeCliProbe({ executable }),\n            runner: new ClaudePrintRunner(),\n            executable,\n        });\n\n        const created = await service.create({ name: 'reviewer', cwd });\n        expect(fs.existsSync(capture)).toBe(false);\n\n        await expect(service.send(created.id, 'first secret')).resolves.toMatchObject({ result: 'answer:first secret' });\n        await expect(service.send(created.id, 'follow up')).resolves.toMatchObject({ result: 'answer:follow up' });\n\n        const invocations = fs.readFileSync(capture, 'utf8').trim().split('\\n').map((line) => JSON.parse(line));\n        expect(invocations[0]).toMatchObject({ prompt: 'first secret', cwd: fs.realpathSync(cwd) });\n        expect(invocations[0].args).toContain('--session-id');\n        expect(invocations[0].args).not.toContain('first secret');\n        expect(invocations[1]).toMatchObject({ prompt: 'follow up', cwd: fs.realpathSync(cwd) });\n        expect(invocations[1].args).toContain('--resume');\n        expect(invocations[1].args[invocations[1].args.indexOf('--resume') + 1]).toBe(created.providerSessionId);\n\n        const persisted = await store.getById(created.id);\n        expect(persisted).toMatchObject({ state: 'ready', sessionHealth: 'healthy' });\n    });\n});\n"],"names":["fs","os","path","fileURLToPath","afterEach","describe","expect","it","ClaudeCliProbe","ClaudePrintAgentService","ClaudePrintRunner","PrintAgentStore","roots","originalCapture","process","env","AI_DEVKIT_FAKE_CLAUDE_CAPTURE","undefined","root","splice","rmSync","recursive","force","mkdtempSync","join","tmpdir","push","cwd","mkdirSync","capture","executable","URL","url","store","filePath","service","probe","runner","created","create","name","existsSync","toBe","send","id","resolves","toMatchObject","result","invocations","readFileSync","trim","split","map","line","JSON","parse","prompt","realpathSync","args","toContain","not","indexOf","providerSessionId","persisted","getById","state","sessionHealth"],"mappings":"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"}