@ai-devkit/agent-manager 0.24.0 → 0.25.0

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__/utils/agents.test.js

@@ -12,6 +12,12 @@ describe('AGENTS', ()=>{
         expect(AGENTS.pi.matches('/usr/local/bin/pi --model x')).toBe(true);
         expect(AGENTS.pi.matches('node /repo/feature-pi-adapter/script.js')).toBe(false);
     });
+    it('includes Grok as a startable agent', ()=>{
+        expect(AGENTS.grok_cli.command).toBe('grok');
+        expect(AGENTS.grok_cli.matches('grok')).toBe(true);
+        expect(AGENTS.grok_cli.matches('/Users/dev/.grok/bin/grok --always-approve')).toBe(true);
+        expect(AGENTS.grok_cli.matches('node /repo/feature-grok-cli/script.js')).toBe(false);
+    });
 });
 
 //# sourceMappingURL=agents.test.js.map

package/dist/__tests__/utils/agents.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/__tests__/utils/agents.test.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { AGENTS } from '../../../src/utils/agents.js';\n\ndescribe('AGENTS', () => {\n    it('includes Copilot as a startable agent', () => {\n        expect(AGENTS.copilot.command).toBe('copilot');\n        expect(AGENTS.copilot.matches('/opt/homebrew/Caskroom/copilot-cli/1.0.60/copilot')).toBe(true);\n        expect(AGENTS.copilot.matches('node /repo/feature-cli-copilot-cli/script.js')).toBe(false);\n    });\n\n    it('includes Pi as a startable agent', () => {\n        expect(AGENTS.pi.command).toBe('pi');\n        expect(AGENTS.pi.matches('pi')).toBe(true);\n        expect(AGENTS.pi.matches('/usr/local/bin/pi --model x')).toBe(true);\n        expect(AGENTS.pi.matches('node /repo/feature-pi-adapter/script.js')).toBe(false);\n    });\n});\n"],"names":["describe","expect","it","AGENTS","copilot","command","toBe","matches","pi"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAS;AAC9C,SAASC,MAAM,QAAQ,+BAA+B;AAEtDH,SAAS,UAAU;IACfE,GAAG,yCAAyC;QACxCD,OAAOE,OAAOC,OAAO,CAACC,OAAO,EAAEC,IAAI,CAAC;QACpCL,OAAOE,OAAOC,OAAO,CAACG,OAAO,CAAC,sDAAsDD,IAAI,CAAC;QACzFL,OAAOE,OAAOC,OAAO,CAACG,OAAO,CAAC,iDAAiDD,IAAI,CAAC;IACxF;IAEAJ,GAAG,oCAAoC;QACnCD,OAAOE,OAAOK,EAAE,CAACH,OAAO,EAAEC,IAAI,CAAC;QAC/BL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,OAAOD,IAAI,CAAC;QACrCL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,gCAAgCD,IAAI,CAAC;QAC9DL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,4CAA4CD,IAAI,CAAC;IAC9E;AACJ"}
+{"version":3,"sources":["../../../src/__tests__/utils/agents.test.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { AGENTS } from '../../../src/utils/agents.js';\n\ndescribe('AGENTS', () => {\n    it('includes Copilot as a startable agent', () => {\n        expect(AGENTS.copilot.command).toBe('copilot');\n        expect(AGENTS.copilot.matches('/opt/homebrew/Caskroom/copilot-cli/1.0.60/copilot')).toBe(true);\n        expect(AGENTS.copilot.matches('node /repo/feature-cli-copilot-cli/script.js')).toBe(false);\n    });\n\n    it('includes Pi as a startable agent', () => {\n        expect(AGENTS.pi.command).toBe('pi');\n        expect(AGENTS.pi.matches('pi')).toBe(true);\n        expect(AGENTS.pi.matches('/usr/local/bin/pi --model x')).toBe(true);\n        expect(AGENTS.pi.matches('node /repo/feature-pi-adapter/script.js')).toBe(false);\n    });\n\n    it('includes Grok as a startable agent', () => {\n        expect(AGENTS.grok_cli.command).toBe('grok');\n        expect(AGENTS.grok_cli.matches('grok')).toBe(true);\n        expect(AGENTS.grok_cli.matches('/Users/dev/.grok/bin/grok --always-approve')).toBe(true);\n        expect(AGENTS.grok_cli.matches('node /repo/feature-grok-cli/script.js')).toBe(false);\n    });\n});\n"],"names":["describe","expect","it","AGENTS","copilot","command","toBe","matches","pi","grok_cli"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAS;AAC9C,SAASC,MAAM,QAAQ,+BAA+B;AAEtDH,SAAS,UAAU;IACfE,GAAG,yCAAyC;QACxCD,OAAOE,OAAOC,OAAO,CAACC,OAAO,EAAEC,IAAI,CAAC;QACpCL,OAAOE,OAAOC,OAAO,CAACG,OAAO,CAAC,sDAAsDD,IAAI,CAAC;QACzFL,OAAOE,OAAOC,OAAO,CAACG,OAAO,CAAC,iDAAiDD,IAAI,CAAC;IACxF;IAEAJ,GAAG,oCAAoC;QACnCD,OAAOE,OAAOK,EAAE,CAACH,OAAO,EAAEC,IAAI,CAAC;QAC/BL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,OAAOD,IAAI,CAAC;QACrCL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,gCAAgCD,IAAI,CAAC;QAC9DL,OAAOE,OAAOK,EAAE,CAACD,OAAO,CAAC,4CAA4CD,IAAI,CAAC;IAC9E;IAEAJ,GAAG,sCAAsC;QACrCD,OAAOE,OAAOM,QAAQ,CAACJ,OAAO,EAAEC,IAAI,CAAC;QACrCL,OAAOE,OAAOM,QAAQ,CAACF,OAAO,CAAC,SAASD,IAAI,CAAC;QAC7CL,OAAOE,OAAOM,QAAQ,CAACF,OAAO,CAAC,+CAA+CD,IAAI,CAAC;QACnFL,OAAOE,OAAOM,QAAQ,CAACF,OAAO,CAAC,0CAA0CD,IAAI,CAAC;IAClF;AACJ"}

package/dist/adapters/AgentAdapter.d.ts

@@ -7,7 +7,7 @@
 /**
  * Type of AI agent
  */
-export type AgentType = 'claude' | 'gemini_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';
+export type AgentType = 'claude' | 'gemini_cli' | 'grok_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';
 /**
  * Current status of an agent
  */

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

@@ -1 +1 @@
-{"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AgentAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC;AAEpG;;GAEG;AACH,oBAAY,WAAW;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,OAAO,YAAY;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,SAAS,CAAC;IAEhB,qBAAqB;IACrB,MAAM,EAAE,WAAW,CAAC;IAEpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC;IAEjB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IAEZ,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAEhB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+EAA+E;IAC/E,UAAU,EAAE,IAAI,CAAC;IAEjB,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC;IAEhB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE,CAAC;IAEjG;;;;;;;;;OASG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE"}
+{"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/AgentAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC;AAEjH;;GAEG;AACH,oBAAY,WAAW;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,OAAO,YAAY;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,SAAS,CAAC;IAEhB,qBAAqB;IACrB,MAAM,EAAE,WAAW,CAAC;IAEpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC;IAEjB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IAEZ,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAEhB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB,+EAA+E;IAC/E,UAAU,EAAE,IAAI,CAAC;IAEjB,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC;IAEhB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAE7C;;;;;OAKG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE,CAAC;IAEjG;;;;;;;;;OASG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE"}

package/dist/adapters/AgentAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/AgentAdapter.ts"],"sourcesContent":["/**\n * Agent Adapter Interface\n * \n * Defines the contract for detecting and managing different types of AI agents.\n * Each adapter is responsible for detecting agents of a specific type (e.g., claude).\n */\n\n/**\n * Type of AI agent\n */\nexport type AgentType = 'claude' | 'gemini_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';\n\n/**\n * Current status of an agent\n */\nexport enum AgentStatus {\n    RUNNING = 'running',\n    WAITING = 'waiting',\n    IDLE = 'idle',\n    UNKNOWN = 'unknown'\n}\n\n/**\n * Information about a detected agent\n */\nexport interface AgentInfo {\n    /** Project-based name (e.g., \"ai-devkit\" or \"ai-devkit (merry)\") */\n    name: string;\n\n    /** Type of agent */\n    type: AgentType;\n\n    /** Current status */\n    status: AgentStatus;\n\n    /** Last user prompt from history */\n    summary: string;\n\n    /** Process ID */\n    pid: number;\n\n    /** Working directory/project path */\n    projectPath: string;\n\n    /** Session UUID */\n    sessionId: string;\n\n    /** Timestamp of last activity */\n    lastActive: Date;\n\n    /** Path to the session JSONL file on disk */\n    sessionFilePath?: string;\n}\n\n/**\n * Information about a running process\n */\nexport interface ProcessInfo {\n    /** Process ID */\n    pid: number;\n\n    /** Parent process ID, populated by listAgentProcesses when available */\n    ppid?: number;\n\n    /** Process command */\n    command: string;\n\n    /** Working directory */\n    cwd: string;\n\n    /** Terminal TTY (e.g., \"ttys030\") */\n    tty: string;\n\n    /** Process start time, populated by enrichProcesses */\n    startTime?: Date;\n}\n\n/**\n * A single message in a conversation\n */\nexport interface ConversationMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\n    timestamp?: string;\n}\n\n/**\n * A historical session discovered on disk (running or not).\n *\n * Used by `listSessions` to surface enough context for a user to identify\n * a session and resume it via the originating tool's resume command.\n */\nexport interface SessionSummary {\n    /** Tool that produced this session */\n    type: AgentType;\n\n    /**\n     * ID accepted by the tool's resume command. Adapters MUST pass this\n     * through verbatim — no normalization, no encoding/decoding — so it\n     * round-trips into `claude --resume <id>` (and equivalents).\n     */\n    sessionId: string;\n\n    /** Working directory the session was started in (best-known value) */\n    cwd: string;\n\n    /**\n     * Trimmed first user message; empty string if none. Adapters apply\n     * the same noise-filter their existing parsers use (skip tool_result\n     * blocks, request-interruption notices, system-injected skill\n     * content). The CLI table renderer substitutes a placeholder for\n     * empty values; JSON output keeps the empty string raw.\n     */\n    firstUserMessage: string;\n\n    /** Last activity timestamp (from session content; falls back to file mtime) */\n    lastActive: Date;\n\n    /** Session start time (from session content; falls back to file birthtime/mtime) */\n    startedAt: Date;\n\n    /** Absolute path to the session file on disk (debug/diagnostics) */\n    sessionFilePath: string;\n}\n\n/**\n * Filters passed by the CLI to {@link AgentAdapter.listSessions}.\n *\n * The CLI is the source of truth for filter defaults and semantics\n * (e.g. cwd defaults to process.cwd(); --all clears it). Adapters apply\n * the values they receive — they don't invent defaults.\n */\nexport interface ListSessionsOptions {\n    /**\n     * Filter to sessions whose recorded cwd matches this path using strict\n     * equality (no prefix/ancestor matching in v1). Undefined = no cwd\n     * filter.\n     */\n    cwd?: string;\n\n    /**\n     * Filter to a single tool. Enforced by `AgentManager.listSessions`,\n     * which skips adapters whose `type` doesn't match. Adapters MAY\n     * ignore this field — by the time their `listSessions` runs, the\n     * type filter is already satisfied. Undefined = include every\n     * registered adapter.\n     */\n    type?: AgentType;\n}\n\n/**\n * Agent Adapter Interface\n *\n * Implementations must provide detection logic for a specific agent type.\n */\nexport interface AgentAdapter {\n    /** Type of agent this adapter handles */\n    readonly type: AgentType;\n\n    /**\n     * Detect running agents of this type\n     * @returns List of detected agents\n     */\n    detectAgents(): Promise<AgentInfo[]>;\n\n    /**\n     * Check if this adapter can handle the given process\n     * @param processInfo Process information\n     * @returns True if this adapter can handle the process\n     */\n    canHandle(processInfo: ProcessInfo): boolean;\n\n    /**\n     * Read the full conversation from a session file\n     * @param sessionFilePath Path to the session JSONL file\n     * @param options.verbose Include tool call/result details\n     * @returns Array of conversation messages\n     */\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[];\n\n    /**\n     * Enumerate historical sessions for this tool from disk.\n     *\n     * Applies `opts.cwd` as a strict-equality filter when set. Returns\n     * {@link SessionSummary} entries unsorted; sorting and global filters\n     * are handled by `AgentManager` and the CLI.\n     *\n     * @param opts Filter options computed by the CLI\n     * @returns Array of sessions discovered on disk\n     */\n    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;\n}\n"],"names":["AgentStatus"],"mappings":"AAAA;;;;;CAKC,GAED;;CAEC,GAGD;;CAEC,GACD,OAAO,IAAA,AAAKA,qCAAAA;;;;;WAAAA;MAKX"}
+{"version":3,"sources":["../../src/adapters/AgentAdapter.ts"],"sourcesContent":["/**\n * Agent Adapter Interface\n * \n * Defines the contract for detecting and managing different types of AI agents.\n * Each adapter is responsible for detecting agents of a specific type (e.g., claude).\n */\n\n/**\n * Type of AI agent\n */\nexport type AgentType = 'claude' | 'gemini_cli' | 'grok_cli' | 'codex' | 'opencode' | 'copilot' | 'pi' | 'other';\n\n/**\n * Current status of an agent\n */\nexport enum AgentStatus {\n    RUNNING = 'running',\n    WAITING = 'waiting',\n    IDLE = 'idle',\n    UNKNOWN = 'unknown'\n}\n\n/**\n * Information about a detected agent\n */\nexport interface AgentInfo {\n    /** Project-based name (e.g., \"ai-devkit\" or \"ai-devkit (merry)\") */\n    name: string;\n\n    /** Type of agent */\n    type: AgentType;\n\n    /** Current status */\n    status: AgentStatus;\n\n    /** Last user prompt from history */\n    summary: string;\n\n    /** Process ID */\n    pid: number;\n\n    /** Working directory/project path */\n    projectPath: string;\n\n    /** Session UUID */\n    sessionId: string;\n\n    /** Timestamp of last activity */\n    lastActive: Date;\n\n    /** Path to the session JSONL file on disk */\n    sessionFilePath?: string;\n}\n\n/**\n * Information about a running process\n */\nexport interface ProcessInfo {\n    /** Process ID */\n    pid: number;\n\n    /** Parent process ID, populated by listAgentProcesses when available */\n    ppid?: number;\n\n    /** Process command */\n    command: string;\n\n    /** Working directory */\n    cwd: string;\n\n    /** Terminal TTY (e.g., \"ttys030\") */\n    tty: string;\n\n    /** Process start time, populated by enrichProcesses */\n    startTime?: Date;\n}\n\n/**\n * A single message in a conversation\n */\nexport interface ConversationMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\n    timestamp?: string;\n}\n\n/**\n * A historical session discovered on disk (running or not).\n *\n * Used by `listSessions` to surface enough context for a user to identify\n * a session and resume it via the originating tool's resume command.\n */\nexport interface SessionSummary {\n    /** Tool that produced this session */\n    type: AgentType;\n\n    /**\n     * ID accepted by the tool's resume command. Adapters MUST pass this\n     * through verbatim — no normalization, no encoding/decoding — so it\n     * round-trips into `claude --resume <id>` (and equivalents).\n     */\n    sessionId: string;\n\n    /** Working directory the session was started in (best-known value) */\n    cwd: string;\n\n    /**\n     * Trimmed first user message; empty string if none. Adapters apply\n     * the same noise-filter their existing parsers use (skip tool_result\n     * blocks, request-interruption notices, system-injected skill\n     * content). The CLI table renderer substitutes a placeholder for\n     * empty values; JSON output keeps the empty string raw.\n     */\n    firstUserMessage: string;\n\n    /** Last activity timestamp (from session content; falls back to file mtime) */\n    lastActive: Date;\n\n    /** Session start time (from session content; falls back to file birthtime/mtime) */\n    startedAt: Date;\n\n    /** Absolute path to the session file on disk (debug/diagnostics) */\n    sessionFilePath: string;\n}\n\n/**\n * Filters passed by the CLI to {@link AgentAdapter.listSessions}.\n *\n * The CLI is the source of truth for filter defaults and semantics\n * (e.g. cwd defaults to process.cwd(); --all clears it). Adapters apply\n * the values they receive — they don't invent defaults.\n */\nexport interface ListSessionsOptions {\n    /**\n     * Filter to sessions whose recorded cwd matches this path using strict\n     * equality (no prefix/ancestor matching in v1). Undefined = no cwd\n     * filter.\n     */\n    cwd?: string;\n\n    /**\n     * Filter to a single tool. Enforced by `AgentManager.listSessions`,\n     * which skips adapters whose `type` doesn't match. Adapters MAY\n     * ignore this field — by the time their `listSessions` runs, the\n     * type filter is already satisfied. Undefined = include every\n     * registered adapter.\n     */\n    type?: AgentType;\n}\n\n/**\n * Agent Adapter Interface\n *\n * Implementations must provide detection logic for a specific agent type.\n */\nexport interface AgentAdapter {\n    /** Type of agent this adapter handles */\n    readonly type: AgentType;\n\n    /**\n     * Detect running agents of this type\n     * @returns List of detected agents\n     */\n    detectAgents(): Promise<AgentInfo[]>;\n\n    /**\n     * Check if this adapter can handle the given process\n     * @param processInfo Process information\n     * @returns True if this adapter can handle the process\n     */\n    canHandle(processInfo: ProcessInfo): boolean;\n\n    /**\n     * Read the full conversation from a session file\n     * @param sessionFilePath Path to the session JSONL file\n     * @param options.verbose Include tool call/result details\n     * @returns Array of conversation messages\n     */\n    getConversation(sessionFilePath: string, options?: { verbose?: boolean }): ConversationMessage[];\n\n    /**\n     * Enumerate historical sessions for this tool from disk.\n     *\n     * Applies `opts.cwd` as a strict-equality filter when set. Returns\n     * {@link SessionSummary} entries unsorted; sorting and global filters\n     * are handled by `AgentManager` and the CLI.\n     *\n     * @param opts Filter options computed by the CLI\n     * @returns Array of sessions discovered on disk\n     */\n    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;\n}\n"],"names":["AgentStatus"],"mappings":"AAAA;;;;;CAKC,GAED;;CAEC,GAGD;;CAEC,GACD,OAAO,IAAA,AAAKA,qCAAAA;;;;;WAAAA;MAKX"}

package/dist/adapters/GrokCliAdapter.d.ts

@@ -0,0 +1,79 @@
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, SessionSummary, ListSessionsOptions } from './AgentAdapter.js';
+export declare class GrokCliAdapter implements AgentAdapter {
+    readonly type: "grok_cli";
+    private base;
+    private sessionsDir;
+    constructor();
+    canHandle(processInfo: ProcessInfo): boolean;
+    private isGrokExecutable;
+    detectAgents(): Promise<AgentInfo[]>;
+    /**
+     * Read ~/.grok/active_sessions.json into a pid -> cwd map. Grok writes one
+     * { pid, cwd, opened_at } entry per running session and removes it on exit,
+     * so this is the reliable way to learn a live process's working directory.
+     */
+    private readActiveSessions;
+    /**
+     * Full paths of the session subdirectories directly under a group dir,
+     * skipping any non-directory entries. Shared by latestSessionDir() and
+     * listSessions() so both enumerate session dirs the same way.
+     */
+    private listSessionDirs;
+    /**
+     * Return the most recently active session subdirectory for a cwd, i.e. the
+     * ~/.grok/sessions/<encodeURIComponent(cwd)>/<id>/ whose chat_history.jsonl
+     * was written last. Returns null when the group dir or any transcript is
+     * missing.
+     */
+    private latestSessionDir;
+    private mapSessionToAgent;
+    private mapProcessOnlyAgent;
+    getConversation(sessionFilePath: string, options?: {
+        verbose?: boolean;
+    }): ConversationMessage[];
+    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
+    /**
+     * Parse a session directory into a {@link GrokSession} from its
+     * chat_history.jsonl transcript. Returns null when the transcript is
+     * missing — i.e. there is no real session to surface.
+     */
+    private readSession;
+    /**
+     * Determine agent status from parsed session state.
+     *
+     * - past the idle threshold → IDLE
+     * - last transcript turn is an assistant message → WAITING (awaiting user)
+     * - otherwise (last turn was a user message, or unknown) → RUNNING
+     */
+    private determineStatus;
+    /**
+     * Single pass over chat_history.jsonl. Each line is a
+     * { type: 'system' | 'user' | 'assistant', content } record where content is
+     * either a string or an array of { type: 'text', text } blocks.
+     *
+     * Grok wraps the real user prompt in <user_query>...</user_query>; the other
+     * user records are context injections (<user_info>, <system-reminder>, ...)
+     * and are skipped so the summary is the actual prompt, not boilerplate.
+     */
+    private parseChatHistory;
+    /** Flatten a chat record's content (string or text-block array) to text. */
+    private extractText;
+    /**
+     * Extract the prompt inside <user_query>...</user_query>. Returns null when
+     * the record has no such tag (a context injection rather than a prompt).
+     */
+    private extractUserQuery;
+    /** Resolve a session dir or an explicit chat_history.jsonl path to the file. */
+    private resolveChatPath;
+    private getProjectDir;
+    /**
+     * Resolve the working directory a session group dir was created for.
+     *
+     * The common case is `decodeURIComponent(<group-name>)`. For paths whose
+     * encoded form exceeds the filesystem limit Grok uses a slug+hash and records
+     * the original path in a `.cwd` file inside the group — prefer that when
+     * present.
+     */
+    private decodeGroupCwd;
+}
+//# sourceMappingURL=GrokCliAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrokCliAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/GrokCliAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACtB,MAAM,mBAAmB,CAAC;AA6D3B,qBAAa,cAAe,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAS;;IAW5B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C,OAAO,CAAC,gBAAgB;IAMlB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA0B1C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,mBAAmB;IAc3B,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,EAAE;IAI1F,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCzE;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAqBnB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IA2CxB,4EAA4E;IAC5E,OAAO,CAAC,WAAW;IAcnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB,gFAAgF;IAChF,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,aAAa;IAIrB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CASzB"}