ai-cli-mcp 2.19.0 → 2.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.ja.md +34 -8
  3. package/README.md +41 -8
  4. package/dist/app/cli.js +1 -0
  5. package/dist/app/mcp.js +64 -12
  6. package/dist/cli-builder.js +13 -6
  7. package/dist/cli-process-service.js +76 -91
  8. package/dist/cli-utils.js +6 -0
  9. package/dist/cli.js +1 -1
  10. package/dist/model-catalog.js +3 -2
  11. package/dist/parsers.js +8 -2
  12. package/package.json +27 -3
  13. package/server.json +3 -3
  14. package/.gemini/settings.json +0 -11
  15. package/.github/dependabot.yml +0 -28
  16. package/.github/pull_request_template.md +0 -28
  17. package/.github/workflows/ci.yml +0 -34
  18. package/.github/workflows/dependency-review.yml +0 -22
  19. package/.github/workflows/publish.yml +0 -89
  20. package/.github/workflows/test.yml +0 -20
  21. package/.github/workflows/watch-session-prs.yml +0 -276
  22. package/.husky/pre-commit +0 -1
  23. package/.mcp.json +0 -11
  24. package/.releaserc.json +0 -18
  25. package/.vscode/settings.json +0 -3
  26. package/CONTRIBUTING.md +0 -81
  27. package/dist/__tests__/app-cli.test.js +0 -392
  28. package/dist/__tests__/cli-bin-smoke.test.js +0 -101
  29. package/dist/__tests__/cli-builder.test.js +0 -442
  30. package/dist/__tests__/cli-process-service.test.js +0 -655
  31. package/dist/__tests__/cli-utils.test.js +0 -171
  32. package/dist/__tests__/e2e.test.js +0 -256
  33. package/dist/__tests__/edge-cases.test.js +0 -130
  34. package/dist/__tests__/error-cases.test.js +0 -292
  35. package/dist/__tests__/mcp-contract.test.js +0 -636
  36. package/dist/__tests__/mocks.js +0 -32
  37. package/dist/__tests__/model-alias.test.js +0 -36
  38. package/dist/__tests__/parsers.test.js +0 -646
  39. package/dist/__tests__/peek.test.js +0 -36
  40. package/dist/__tests__/process-management.test.js +0 -949
  41. package/dist/__tests__/server.test.js +0 -809
  42. package/dist/__tests__/setup.js +0 -11
  43. package/dist/__tests__/utils/claude-mock.js +0 -80
  44. package/dist/__tests__/utils/mcp-client.js +0 -121
  45. package/dist/__tests__/utils/opencode-mock.js +0 -91
  46. package/dist/__tests__/utils/persistent-mock.js +0 -28
  47. package/dist/__tests__/utils/test-helpers.js +0 -11
  48. package/dist/__tests__/validation.test.js +0 -308
  49. package/dist/__tests__/version-print.test.js +0 -65
  50. package/dist/__tests__/wait.test.js +0 -260
  51. package/docs/RELEASE_CHECKLIST.md +0 -65
  52. package/docs/cli-architecture.md +0 -275
  53. package/docs/concept.md +0 -154
  54. package/docs/development.md +0 -156
  55. package/docs/e2e-testing.md +0 -148
  56. package/docs/prd.md +0 -146
  57. package/docs/session-stacking.md +0 -67
  58. package/src/__tests__/app-cli.test.ts +0 -495
  59. package/src/__tests__/cli-bin-smoke.test.ts +0 -136
  60. package/src/__tests__/cli-builder.test.ts +0 -549
  61. package/src/__tests__/cli-process-service.test.ts +0 -759
  62. package/src/__tests__/cli-utils.test.ts +0 -200
  63. package/src/__tests__/e2e.test.ts +0 -311
  64. package/src/__tests__/edge-cases.test.ts +0 -176
  65. package/src/__tests__/error-cases.test.ts +0 -370
  66. package/src/__tests__/mcp-contract.test.ts +0 -755
  67. package/src/__tests__/mocks.ts +0 -35
  68. package/src/__tests__/model-alias.test.ts +0 -44
  69. package/src/__tests__/parsers.test.ts +0 -730
  70. package/src/__tests__/peek.test.ts +0 -44
  71. package/src/__tests__/process-management.test.ts +0 -1129
  72. package/src/__tests__/server.test.ts +0 -1020
  73. package/src/__tests__/setup.ts +0 -13
  74. package/src/__tests__/utils/claude-mock.ts +0 -87
  75. package/src/__tests__/utils/mcp-client.ts +0 -159
  76. package/src/__tests__/utils/opencode-mock.ts +0 -108
  77. package/src/__tests__/utils/persistent-mock.ts +0 -33
  78. package/src/__tests__/utils/test-helpers.ts +0 -13
  79. package/src/__tests__/validation.test.ts +0 -369
  80. package/src/__tests__/version-print.test.ts +0 -81
  81. package/src/__tests__/wait.test.ts +0 -302
  82. package/src/app/cli.ts +0 -424
  83. package/src/app/mcp.ts +0 -466
  84. package/src/bin/ai-cli-mcp.ts +0 -7
  85. package/src/bin/ai-cli.ts +0 -11
  86. package/src/cli-builder.ts +0 -274
  87. package/src/cli-parse.ts +0 -105
  88. package/src/cli-process-service.ts +0 -709
  89. package/src/cli-utils.ts +0 -258
  90. package/src/cli.ts +0 -124
  91. package/src/model-catalog.ts +0 -87
  92. package/src/parsers.ts +0 -965
  93. package/src/peek.ts +0 -95
  94. package/src/process-result.ts +0 -88
  95. package/src/process-service.ts +0 -368
  96. package/src/server.ts +0 -10
  97. package/tsconfig.json +0 -16
  98. package/vitest.config.e2e.ts +0 -27
  99. package/vitest.config.ts +0 -22
  100. package/vitest.config.unit.ts +0 -28
@@ -1,730 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { parseCodexOutput, parseClaudeOutput, parseForgeOutput, parseGeminiOutput, parseOpenCodeOutput, PeekEventExtractor, PeekMessageExtractor } from '../parsers.js';
3
-
4
- describe('parseCodexOutput', () => {
5
- it('should parse basic Codex output with message and session_id', () => {
6
- const output = `
7
- {"type":"thread.started","thread_id":"test-session-id"}
8
- {"type":"turn.started"}
9
- {"type":"item.completed","item":{"type":"agent_message","text":"Hello world"}}
10
- {"type":"turn.completed"}
11
- `;
12
- const result = parseCodexOutput(output);
13
- expect(result).toEqual({
14
- message: "Hello world",
15
- session_id: "test-session-id",
16
- token_count: null,
17
- tools: undefined
18
- });
19
- });
20
-
21
- it('should extract MCP tool calls', () => {
22
- const output = `
23
- {"type":"thread.started","thread_id":"tool-test-id"}
24
- {"type":"turn.started"}
25
- {"type":"item.completed","item":{"id":"item_1","type":"mcp_tool_call","server":"acm","tool":"run","arguments":{"model":"gemini-2.5-flash","prompt":"hi"},"result":{"content":[{"text":"started","type":"text"}]},"status":"completed"}}
26
- {"type":"item.completed","item":{"type":"agent_message","text":"Tool executed"}}
27
- {"type":"turn.completed"}
28
- `;
29
- const result = parseCodexOutput(output);
30
-
31
- expect(result.message).toBe("Tool executed");
32
- expect(result.session_id).toBe("tool-test-id");
33
- expect(result.tools).toHaveLength(1);
34
- expect(result.tools[0]).toEqual({
35
- tool: "run",
36
- server: "acm",
37
- input: { model: "gemini-2.5-flash", prompt: "hi" },
38
- output: { content: [{ text: "started", type: "text" }] }
39
- });
40
- });
41
-
42
- it('should handle multiple tool calls', () => {
43
- const output = `
44
- {"type":"item.completed","item":{"type":"mcp_tool_call","tool":"tool1","arguments":{"arg":1},"result":"res1"}}
45
- {"type":"item.completed","item":{"type":"mcp_tool_call","tool":"tool2","arguments":{"arg":2},"result":"res2"}}
46
- `;
47
- const result = parseCodexOutput(output);
48
- expect(result.tools).toHaveLength(2);
49
- expect(result.tools[0].tool).toBe("tool1");
50
- expect(result.tools[1].tool).toBe("tool2");
51
- });
52
-
53
- it('should return null for empty input', () => {
54
- expect(parseCodexOutput("")).toBeNull();
55
- });
56
-
57
- it('should handle invalid JSON gracefully', () => {
58
- const output = `
59
- {"type":"valid"}
60
- INVALID_JSON
61
- {"type":"item.completed","item":{"type":"agent_message","text":"Still parses valid lines"}}
62
- `;
63
- const result = parseCodexOutput(output);
64
- expect(result.message).toBe("Still parses valid lines");
65
- });
66
- });
67
-
68
- describe('PeekMessageExtractor', () => {
69
- const ts = '2026-04-11T12:34:56.789Z';
70
-
71
- it('extracts only Codex agent_message text', () => {
72
- const extractor = new PeekMessageExtractor('codex');
73
- const output = [
74
- '{"type":"item.completed","item":{"type":"reasoning","text":"hidden"}}',
75
- '{"type":"item.completed","item":{"type":"command_execution","aggregated_output":"secret command output"}}',
76
- '{"type":"item.completed","item":{"type":"agent_message","text":"Visible Codex message"}}',
77
- '{"msg":{"type":"token_count","total":123}}',
78
- '{"msg":{"type":"agent_message","message":"Visible legacy Codex message"}}',
79
- ].join('\n') + '\n';
80
-
81
- expect(extractor.push(output, ts)).toEqual([
82
- { ts, text: 'Visible Codex message' },
83
- { ts, text: 'Visible legacy Codex message' },
84
- ]);
85
- });
86
-
87
- it('extracts only Claude assistant text content', () => {
88
- const extractor = new PeekMessageExtractor('claude');
89
- const output = [
90
- '{"type":"assistant","message":{"content":[{"type":"text","text":"Visible Claude text"},{"type":"tool_use","id":"tool-1","name":"Read","input":{"file_path":"/tmp/a"}}]}}',
91
- '{"type":"user","message":{"content":[{"type":"tool_result","tool_use_id":"tool-1","content":"secret"}]}}',
92
- '{"type":"result","result":"Final result is not peek assistant text"}',
93
- ].join('\n') + '\n';
94
-
95
- expect(extractor.push(output, ts)).toEqual([
96
- { ts, text: 'Visible Claude text' },
97
- ]);
98
- });
99
-
100
- it('extracts only Gemini assistant message content', () => {
101
- const extractor = new PeekMessageExtractor('gemini');
102
- const output = [
103
- '{"type":"message","timestamp":"2026-04-11T14:44:42.294Z","role":"user","content":"hidden user text"}',
104
- '{"type":"message","timestamp":"2026-04-11T14:44:53.820Z","role":"assistant","content":"Visible Gemini text","delta":true}',
105
- '{"type":"tool_use","timestamp":"2026-04-11T14:44:53.821Z","tool_name":"run_shell_command","parameters":{"command":"echo secret"}}',
106
- '{"type":"tool_result","timestamp":"2026-04-11T14:45:03.011Z","status":"success","output":"secret command output"}',
107
- '{"type":"result","timestamp":"2026-04-11T14:45:10.380Z","status":"success","response":"Final result is not peek assistant text"}',
108
- ].join('\n') + '\n';
109
-
110
- expect(extractor.push(output, ts)).toEqual([
111
- { ts, text: 'Visible Gemini text' },
112
- ]);
113
- });
114
-
115
- it('joins split Gemini assistant chunks into one peek message on flush', () => {
116
- const extractor = new PeekMessageExtractor('gemini');
117
- const output = [
118
- '{"type":"message","timestamp":"2026-04-11T14:44:53.820Z","role":"assistant","content":"Step 2 done. Starting step ","delta":true}',
119
- '{"type":"message","timestamp":"2026-04-11T14:44:53.821Z","role":"assistant","content":"3.","delta":true}',
120
- ].join('\n') + '\n';
121
-
122
- expect(extractor.push(output, ts)).toEqual([]);
123
- expect(extractor.flush('2026-04-11T12:34:59.000Z')).toEqual([
124
- { ts: '2026-04-11T12:34:59.000Z', text: 'Step 2 done. Starting step 3.' },
125
- ]);
126
- });
127
-
128
- it('emits separate Gemini peek messages when a boundary separates logical messages', () => {
129
- const extractor = new PeekMessageExtractor('gemini');
130
- const output = [
131
- '{"type":"message","timestamp":"2026-04-11T14:44:53.820Z","role":"assistant","content":"Starting step ","delta":true}',
132
- '{"type":"message","timestamp":"2026-04-11T14:44:53.821Z","role":"assistant","content":"1.","delta":true}',
133
- '{"type":"tool_use","timestamp":"2026-04-11T14:44:53.822Z","tool_name":"run_shell_command","parameters":{"command":"echo secret"}}',
134
- '{"type":"tool_result","timestamp":"2026-04-11T14:45:03.011Z","status":"success","output":"secret command output"}',
135
- '{"type":"message","timestamp":"2026-04-11T14:45:10.315Z","role":"assistant","content":"Final ","delta":true}',
136
- '{"type":"message","timestamp":"2026-04-11T14:45:10.316Z","role":"assistant","content":"answer.","delta":true}',
137
- '{"type":"result","timestamp":"2026-04-11T14:45:10.380Z","status":"success","response":"Final result response is not peek text","stats":{"total_tokens":21999}}',
138
- ].join('\n') + '\n';
139
-
140
- expect(extractor.push(output, ts)).toEqual([
141
- { ts, text: 'Starting step 1.' },
142
- { ts, text: 'Final answer.' },
143
- ]);
144
- expect(extractor.flush(ts)).toEqual([]);
145
- });
146
-
147
- it('does not emit Gemini user, tool, tool result, stats, or result response text', () => {
148
- const extractor = new PeekMessageExtractor('gemini');
149
- const output = [
150
- '{"type":"message","timestamp":"2026-04-11T14:44:42.294Z","role":"user","content":"hidden user text"}',
151
- '{"type":"tool_use","timestamp":"2026-04-11T14:44:53.821Z","tool_name":"run_shell_command","parameters":{"command":"echo secret"}}',
152
- '{"type":"tool_result","timestamp":"2026-04-11T14:45:03.011Z","status":"success","output":"secret command output"}',
153
- '{"type":"result","timestamp":"2026-04-11T14:45:10.380Z","status":"success","response":"Final result response is not peek text","stats":{"total_tokens":21999}}',
154
- ].join('\n') + '\n';
155
-
156
- expect(extractor.push(output, ts)).toEqual([]);
157
- expect(extractor.flush(ts)).toEqual([]);
158
- });
159
-
160
- it('denies unsupported agents and invalid shapes by default', () => {
161
- const extractor = new PeekMessageExtractor('forge');
162
- const output = [
163
- '{"type":"assistant","message":{"content":[{"type":"text","text":"not supported here"}]}}',
164
- '{"type":"item.completed","item":{"type":"agent_message","text":"not supported here"}}',
165
- '{"type":"text","part":{"type":"text","text":"not supported here"}}',
166
- '{"type":"message","role":"assistant","content":"not supported here"}',
167
- 'plain stdout',
168
- ].join('\n') + '\n';
169
-
170
- expect(extractor.push(output, ts)).toEqual([]);
171
- });
172
-
173
- it('extracts only OpenCode natural-language text events', () => {
174
- const extractor = new PeekMessageExtractor('opencode');
175
- const output = [
176
- '{"type":"text","timestamp":1775918783605,"sessionID":"ses-1","part":{"type":"text","text":"OpenCode visible text"}}',
177
- '{"type":"tool_use","timestamp":1775918783606,"sessionID":"ses-1","part":{"type":"tool","state":{"output":"secret command output"},"metadata":{"output":"secret metadata output"}}}',
178
- '{"type":"text","timestamp":1775918783607,"sessionID":"ses-1","part":{"type":"tool","text":"wrong part type"}}',
179
- ].join('\n') + '\n';
180
-
181
- expect(extractor.push(output, ts)).toEqual([
182
- { ts, text: 'OpenCode visible text' },
183
- ]);
184
- });
185
-
186
- it('can flush a complete JSON event without a trailing newline', () => {
187
- const extractor = new PeekMessageExtractor('codex');
188
- expect(extractor.push('{"type":"item.completed","item":{"type":"agent_message","text":"pending"}}', ts)).toEqual([]);
189
- expect(extractor.flush(ts)).toEqual([{ ts, text: 'pending' }]);
190
- });
191
- });
192
-
193
- describe('PeekEventExtractor', () => {
194
- const ts = '2026-04-12T02:10:00.000Z';
195
-
196
- it('emits only message events when include_tool_calls is false', () => {
197
- const extractor = new PeekEventExtractor('codex', { includeToolCalls: false });
198
- const output = [
199
- '{"type":"item.started","item":{"id":"item_0","type":"command_execution","command":"echo secret","status":"in_progress"}}',
200
- '{"type":"item.completed","item":{"id":"item_0","type":"command_execution","command":"echo secret","aggregated_output":"secret output\\n","exit_code":0,"status":"completed"}}',
201
- '{"type":"item.completed","item":{"id":"item_1","type":"agent_message","text":"Visible Codex message"}}',
202
- ].join('\n') + '\n';
203
-
204
- expect(extractor.push(output, ts)).toEqual([
205
- { kind: 'message', ts, text: 'Visible Codex message' },
206
- ]);
207
- });
208
-
209
- it('emits Codex command and MCP tool_call events without raw output when include_tool_calls is true', () => {
210
- const extractor = new PeekEventExtractor('codex', { includeToolCalls: true });
211
- const output = [
212
- '{"type":"item.started","item":{"id":"cmd_0","type":"command_execution","command":"/bin/sh -c \\"echo secret\\"","status":"in_progress"}}',
213
- '{"type":"item.completed","item":{"id":"cmd_0","type":"command_execution","command":"/bin/sh -c \\"echo secret\\"","aggregated_output":"secret output\\n","exit_code":0,"status":"completed"}}',
214
- '{"type":"item.started","item":{"id":"mcp_0","type":"mcp_tool_call","server":"acm","tool":"list_processes","arguments":{},"status":"in_progress"}}',
215
- '{"type":"item.completed","item":{"id":"mcp_0","type":"mcp_tool_call","server":"acm","tool":"list_processes","arguments":{},"result":{"content":[{"type":"text","text":"secret result"}]},"status":"completed"}}',
216
- ].join('\n') + '\n';
217
-
218
- expect(extractor.push(output, ts)).toEqual([
219
- {
220
- kind: 'tool_call',
221
- ts,
222
- phase: 'started',
223
- id: 'cmd_0',
224
- tool: 'command_execution',
225
- summary: '/bin/sh -c "echo secret"',
226
- },
227
- {
228
- kind: 'tool_call',
229
- ts,
230
- phase: 'completed',
231
- id: 'cmd_0',
232
- tool: 'command_execution',
233
- summary: '/bin/sh -c "echo secret"',
234
- status: 'success',
235
- exit_code: 0,
236
- },
237
- {
238
- kind: 'tool_call',
239
- ts,
240
- phase: 'started',
241
- id: 'mcp_0',
242
- tool: 'list_processes',
243
- server: 'acm',
244
- summary: 'acm.list_processes',
245
- },
246
- {
247
- kind: 'tool_call',
248
- ts,
249
- phase: 'completed',
250
- id: 'mcp_0',
251
- tool: 'list_processes',
252
- server: 'acm',
253
- summary: 'acm.list_processes',
254
- status: 'success',
255
- },
256
- ]);
257
- });
258
-
259
- it('emits Claude MCP tool_call events paired by id', () => {
260
- const extractor = new PeekEventExtractor('claude', { includeToolCalls: true });
261
- const output = [
262
- '{"type":"assistant","message":{"content":[{"type":"tool_use","id":"toolu_1","name":"mcp__acm__list_processes","input":{}}]}}',
263
- '{"type":"user","message":{"content":[{"tool_use_id":"toolu_1","type":"tool_result","content":[{"type":"text","text":"secret result"}]}]}}',
264
- '{"type":"assistant","message":{"content":[{"type":"text","text":"Done."}]}}',
265
- ].join('\n') + '\n';
266
-
267
- expect(extractor.push(output, ts)).toEqual([
268
- {
269
- kind: 'tool_call',
270
- ts,
271
- phase: 'started',
272
- id: 'toolu_1',
273
- tool: 'mcp__acm__list_processes',
274
- server: 'acm',
275
- summary: 'acm.list_processes',
276
- },
277
- {
278
- kind: 'tool_call',
279
- ts,
280
- phase: 'completed',
281
- id: 'toolu_1',
282
- tool: 'mcp__acm__list_processes',
283
- server: 'acm',
284
- summary: 'acm.list_processes',
285
- status: 'success',
286
- },
287
- { kind: 'message', ts, text: 'Done.' },
288
- ]);
289
- });
290
-
291
- it('emits Gemini MCP tool_call events and joined assistant message events', () => {
292
- const extractor = new PeekEventExtractor('gemini', { includeToolCalls: true });
293
- const output = [
294
- '{"type":"tool_use","timestamp":"2026-04-12T02:56:29.992Z","tool_name":"mcp_acm_list_processes","tool_id":"mcp_1","parameters":{}}',
295
- '{"type":"tool_result","timestamp":"2026-04-12T02:56:30.059Z","tool_id":"mcp_1","status":"success","output":"secret result"}',
296
- '{"type":"message","timestamp":"2026-04-12T02:56:32.855Z","role":"assistant","content":"The tool ","delta":true}',
297
- '{"type":"message","timestamp":"2026-04-12T02:56:32.902Z","role":"assistant","content":"succeeded.","delta":true}',
298
- '{"type":"result","timestamp":"2026-04-12T02:56:32.954Z","status":"success","stats":{"tool_calls":1}}',
299
- ].join('\n') + '\n';
300
-
301
- expect(extractor.push(output, ts)).toEqual([
302
- {
303
- kind: 'tool_call',
304
- ts,
305
- phase: 'started',
306
- id: 'mcp_1',
307
- tool: 'mcp_acm_list_processes',
308
- server: 'acm',
309
- summary: 'acm.list_processes',
310
- },
311
- {
312
- kind: 'tool_call',
313
- ts,
314
- phase: 'completed',
315
- id: 'mcp_1',
316
- tool: 'mcp_acm_list_processes',
317
- server: 'acm',
318
- summary: 'acm.list_processes',
319
- status: 'success',
320
- },
321
- { kind: 'message', ts, text: 'The tool succeeded.' },
322
- ]);
323
- });
324
-
325
- it('emits OpenCode completed MCP tool_call events from tool_use state', () => {
326
- const extractor = new PeekEventExtractor('opencode', { includeToolCalls: true });
327
- const output = [
328
- '{"type":"tool_use","timestamp":1775962663837,"sessionID":"ses-1","part":{"id":"part-1","type":"tool","tool":"acm_list_processes","callID":"call_1","state":{"status":"completed","input":{},"output":"secret result","metadata":{"truncated":false},"time":{"start":1775962663834,"end":1775962663837}}}}',
329
- ].join('\n') + '\n';
330
-
331
- expect(extractor.push(output, ts)).toEqual([
332
- {
333
- kind: 'tool_call',
334
- ts,
335
- phase: 'completed',
336
- id: 'call_1',
337
- tool: 'acm_list_processes',
338
- server: 'acm',
339
- summary: 'acm.list_processes',
340
- status: 'success',
341
- duration_ms: 3,
342
- },
343
- ]);
344
- });
345
-
346
- it('emits Forge message events from Summary and Completed successfully prefixes', () => {
347
- const extractor = new PeekEventExtractor('forge');
348
- const output = [
349
- 'Summary: Forge finished the task',
350
- 'Completed successfully: Built the project',
351
- 'Summary: ',
352
- ].join('\n') + '\n';
353
-
354
- expect(extractor.push(output, ts)).toEqual([
355
- { kind: 'message', ts, text: 'Forge finished the task' },
356
- { kind: 'message', ts, text: 'Built the project' },
357
- ]);
358
- });
359
-
360
- it('preserves long Forge Summary message text without truncation', () => {
361
- const extractor = new PeekEventExtractor('forge');
362
- const longText = 'x'.repeat(260);
363
-
364
- expect(extractor.push(`Summary: ${longText}\n`, ts)).toEqual([
365
- { kind: 'message', ts, text: longText },
366
- ]);
367
- });
368
-
369
- it('emits Forge Execute tool_call starts when include_tool_calls is true', () => {
370
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
371
-
372
- expect(extractor.push("● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hi'\n", ts)).toEqual([
373
- {
374
- kind: 'tool_call',
375
- ts,
376
- phase: 'started',
377
- id: 'forge_0',
378
- tool: '/bin/zsh',
379
- summary: "/bin/sh -c 'echo hi'",
380
- },
381
- ]);
382
- });
383
-
384
- it('falls back to shell for Forge Execute labels with spaces', () => {
385
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
386
-
387
- expect(extractor.push("● [11:28:40] Execute [local shell] /bin/sh -c 'echo hi'\n", ts)).toEqual([
388
- {
389
- kind: 'tool_call',
390
- ts,
391
- phase: 'started',
392
- id: 'forge_0',
393
- tool: 'shell',
394
- summary: "/bin/sh -c 'echo hi'",
395
- },
396
- ]);
397
- });
398
-
399
- it('suppresses Forge tool_call events when include_tool_calls is false but keeps messages', () => {
400
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: false });
401
- const output = [
402
- "● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hi'",
403
- 'Summary: done',
404
- ].join('\n') + '\n';
405
-
406
- expect(extractor.push(output, ts)).toEqual([
407
- { kind: 'message', ts, text: 'done' },
408
- ]);
409
- });
410
-
411
- it('completes a pending Forge tool_call only on anchored Finished markers', () => {
412
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
413
- const output = [
414
- "● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hi'",
415
- 'This line says Finished but is not a Forge marker',
416
- '● [11:28:41] Finished abc123',
417
- ].join('\n') + '\n';
418
-
419
- expect(extractor.push(output, ts)).toEqual([
420
- {
421
- kind: 'tool_call',
422
- ts,
423
- phase: 'started',
424
- id: 'forge_0',
425
- tool: '/bin/zsh',
426
- summary: "/bin/sh -c 'echo hi'",
427
- },
428
- {
429
- kind: 'tool_call',
430
- ts,
431
- phase: 'completed',
432
- id: 'forge_0',
433
- tool: '/bin/zsh',
434
- summary: "/bin/sh -c 'echo hi'",
435
- status: 'unknown',
436
- },
437
- ]);
438
- });
439
-
440
- it('completes a pending Forge tool_call before starting a consecutive Execute marker', () => {
441
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
442
- const output = [
443
- "● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo one'",
444
- "● [11:28:41] Execute [/bin/zsh] /bin/sh -c 'echo two'",
445
- ].join('\n') + '\n';
446
-
447
- expect(extractor.push(output, ts)).toEqual([
448
- {
449
- kind: 'tool_call',
450
- ts,
451
- phase: 'started',
452
- id: 'forge_0',
453
- tool: '/bin/zsh',
454
- summary: "/bin/sh -c 'echo one'",
455
- },
456
- {
457
- kind: 'tool_call',
458
- ts,
459
- phase: 'completed',
460
- id: 'forge_0',
461
- tool: '/bin/zsh',
462
- summary: "/bin/sh -c 'echo one'",
463
- status: 'unknown',
464
- },
465
- {
466
- kind: 'tool_call',
467
- ts,
468
- phase: 'started',
469
- id: 'forge_1',
470
- tool: '/bin/zsh',
471
- summary: "/bin/sh -c 'echo two'",
472
- },
473
- ]);
474
- });
475
-
476
- it('does not synthesize Forge completion on non-terminal flush', () => {
477
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
478
-
479
- expect(extractor.push("● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hi'\n", ts)).toHaveLength(1);
480
- expect(extractor.flush(ts, { terminal: false })).toEqual([]);
481
- });
482
-
483
- it('synthesizes Forge completion with unknown status on terminal flush', () => {
484
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true });
485
-
486
- expect(extractor.push("● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hi'\n", ts)).toHaveLength(1);
487
- expect(extractor.flush('2026-04-12T02:10:05.000Z', { terminal: true })).toEqual([
488
- {
489
- kind: 'tool_call',
490
- ts: '2026-04-12T02:10:05.000Z',
491
- phase: 'completed',
492
- id: 'forge_0',
493
- tool: '/bin/zsh',
494
- summary: "/bin/sh -c 'echo hi'",
495
- status: 'unknown',
496
- },
497
- ]);
498
- });
499
-
500
- it('treats Forge stderr as a no-op source', () => {
501
- const extractor = new PeekEventExtractor('forge', { includeToolCalls: true, source: 'stderr' });
502
- const output = [
503
- 'Summary: hidden',
504
- "● [11:28:40] Execute [/bin/zsh] /bin/sh -c 'echo hidden'",
505
- '● [11:28:41] Finished',
506
- ].join('\n') + '\n';
507
-
508
- expect(extractor.push(output, ts)).toEqual([]);
509
- expect(extractor.flush(ts, { terminal: true })).toEqual([]);
510
- });
511
- });
512
-
513
- describe('parseGeminiOutput', () => {
514
- it('should parse legacy final JSON output', () => {
515
- const output = JSON.stringify({
516
- session_id: 'gemini-session-json',
517
- response: 'Legacy Gemini final response',
518
- stats: {
519
- total_tokens: 123,
520
- },
521
- });
522
-
523
- expect(parseGeminiOutput(output)).toEqual({
524
- session_id: 'gemini-session-json',
525
- response: 'Legacy Gemini final response',
526
- stats: {
527
- total_tokens: 123,
528
- },
529
- });
530
- });
531
-
532
- it('should normalize a single-line Gemini assistant stream event', () => {
533
- const output = '{"type":"message","timestamp":"2026-04-11T14:44:53.820Z","role":"assistant","content":"Only answer","delta":true}';
534
-
535
- const result = parseGeminiOutput(output);
536
-
537
- expect(result).toMatchObject({
538
- message: 'Only answer',
539
- session_id: null,
540
- });
541
- expect(result).not.toHaveProperty('type');
542
- expect(result).not.toHaveProperty('content');
543
- });
544
-
545
- it('should parse Gemini stream-json NDJSON output', () => {
546
- const output = [
547
- '{"type":"init","timestamp":"2026-04-11T14:44:42.293Z","session_id":"gemini-session-stream","model":"gemini-3.1-pro-preview"}',
548
- '{"type":"message","timestamp":"2026-04-11T14:44:42.294Z","role":"user","content":"hidden user text"}',
549
- '{"type":"message","timestamp":"2026-04-11T14:44:53.820Z","role":"assistant","content":"First logical assistant response.","delta":true}',
550
- '{"type":"tool_use","timestamp":"2026-04-11T14:44:53.821Z","tool_name":"run_shell_command","tool_id":"tool-1","parameters":{"command":"echo hidden"}}',
551
- '{"type":"tool_result","timestamp":"2026-04-11T14:45:03.011Z","tool_id":"tool-1","status":"success","output":"hidden command output"}',
552
- '{"type":"message","timestamp":"2026-04-11T14:45:10.315Z","role":"assistant","content":"Final assistant ","delta":true}',
553
- '{"type":"message","timestamp":"2026-04-11T14:45:10.316Z","role":"assistant","content":"response.","delta":true}',
554
- '{"type":"result","timestamp":"2026-04-11T14:45:10.380Z","status":"success","response":"Result response is not the parsed message","stats":{"total_tokens":21999}}',
555
- ].join('\n') + '\n';
556
-
557
- expect(parseGeminiOutput(output)).toEqual({
558
- message: 'Final assistant response.',
559
- session_id: 'gemini-session-stream',
560
- stats: {
561
- total_tokens: 21999,
562
- },
563
- tools: [
564
- {
565
- tool: 'run_shell_command',
566
- input: { command: 'echo hidden' },
567
- output: 'hidden command output',
568
- status: 'success',
569
- },
570
- ],
571
- });
572
- });
573
- });
574
-
575
- describe('parseClaudeOutput', () => {
576
- it('should parse legacy JSON output', () => {
577
- const output = JSON.stringify({
578
- content: [{ type: 'text', text: 'Hello' }]
579
- });
580
- const result = parseClaudeOutput(output);
581
- expect(result).toEqual({
582
- content: [{ type: 'text', text: 'Hello' }]
583
- });
584
- });
585
-
586
- it('should parse stream-json (NDJSON) output', () => {
587
- const output = `
588
- {"type":"system","session_id":"test-claude-session"}
589
- {"type":"assistant","message":{"content":[{"type":"text","text":"Thinking..."}]}}
590
- {"type":"assistant","message":{"content":[{"type":"tool_use","id":"call_1","name":"mcp__acm__run","input":{"prompt":"hi"}}]}}
591
- {"type":"user","message":{"content":[{"type":"tool_result","tool_use_id":"call_1","content":"done"}]}}
592
- {"type":"result","result":"Final Answer","is_error":false}
593
- `;
594
- const result = parseClaudeOutput(output);
595
-
596
- expect(result.message).toBe("Final Answer");
597
- expect(result.session_id).toBe("test-claude-session");
598
- expect(result.tools).toHaveLength(1);
599
- expect(result.tools[0]).toEqual({
600
- tool: "mcp__acm__run",
601
- input: { prompt: "hi" },
602
- output: "done"
603
- });
604
- });
605
-
606
- it('should handle invalid NDJSON lines gracefully', () => {
607
- const output = `
608
- {"type":"system"}
609
- INVALID_LINE
610
- {"type":"result","result":"Success"}
611
- `;
612
- const result = parseClaudeOutput(output);
613
- expect(result.message).toBe("Success");
614
- });
615
- });
616
-
617
- describe('parseForgeOutput', () => {
618
- it('should parse initialized forge output with a conversation id', () => {
619
- const output = `● [21:09:01] Initialize 123e4567-e89b-12d3-a456-426614174000
620
- Hello from Forge
621
- ● [21:09:08] Finished 123e4567-e89b-12d3-a456-426614174000
622
- `;
623
-
624
- expect(parseForgeOutput(output)).toEqual({
625
- message: 'Hello from Forge',
626
- session_id: '123e4567-e89b-12d3-a456-426614174000',
627
- });
628
- });
629
-
630
- it('should parse resumed forge output with multiline assistant content', () => {
631
- const output = `● [21:09:33] Continue conv-123
632
- Line one
633
-
634
- Line three
635
- ● [21:09:37] Finished conv-123
636
- `;
637
-
638
- expect(parseForgeOutput(output)).toEqual({
639
- message: 'Line one\n\nLine three',
640
- session_id: 'conv-123',
641
- });
642
- });
643
-
644
- it('should return the current message while forge output is still in progress', () => {
645
- const output = `● [21:09:33] Continue conv-456
646
- Partial answer
647
- still streaming`;
648
-
649
- expect(parseForgeOutput(output)).toEqual({
650
- message: 'Partial answer\nstill streaming',
651
- session_id: 'conv-456',
652
- });
653
- });
654
-
655
- it('should return null for unrelated forge output', () => {
656
- expect(parseForgeOutput('plain text')).toBeNull();
657
- });
658
- });
659
-
660
- describe('parseOpenCodeOutput', () => {
661
- it('parses a single completed OpenCode step', () => {
662
- const output = `{"type":"step_start","sessionID":"ses_1"}
663
- {"type":"text","sessionID":"ses_1","part":{"type":"text","text":"Hello"}}
664
- {"type":"step_finish","sessionID":"ses_1","part":{"type":"step-finish","tokens":{"total":11833},"cost":0}}`;
665
-
666
- expect(parseOpenCodeOutput(output)).toEqual({
667
- message: 'Hello',
668
- session_id: 'ses_1',
669
- tokens: { total: 11833 },
670
- cost: 0,
671
- });
672
- });
673
-
674
- it('returns the last completed step for multi-step output', () => {
675
- const output = `{"type":"step_start","sessionID":"ses_2"}
676
- {"type":"text","sessionID":"ses_2","part":{"type":"text","text":"First"}}
677
- {"type":"step_finish","sessionID":"ses_2","part":{"type":"step-finish","tokens":{"total":10},"cost":0}}
678
- {"type":"step_start","sessionID":"ses_2"}
679
- {"type":"text","sessionID":"ses_2","part":{"type":"text","text":"Second"}}
680
- {"type":"step_finish","sessionID":"ses_2","part":{"type":"step-finish","tokens":{"total":20},"cost":1}}`;
681
-
682
- expect(parseOpenCodeOutput(output)).toEqual({
683
- message: 'Second',
684
- session_id: 'ses_2',
685
- tokens: { total: 20 },
686
- cost: 1,
687
- });
688
- });
689
-
690
- it('resets the current-step buffer on each step_start', () => {
691
- const output = `{"type":"step_start","sessionID":"ses_3"}
692
- {"type":"text","sessionID":"ses_3","part":{"type":"text","text":"Discard me"}}
693
- {"type":"step_start","sessionID":"ses_3"}
694
- {"type":"text","sessionID":"ses_3","part":{"type":"text","text":"Keep me"}}
695
- {"type":"step_finish","sessionID":"ses_3","part":{"type":"step-finish","tokens":{"total":5},"cost":0}}`;
696
-
697
- expect(parseOpenCodeOutput(output)).toEqual({
698
- message: 'Keep me',
699
- session_id: 'ses_3',
700
- tokens: { total: 5 },
701
- cost: 0,
702
- });
703
- });
704
-
705
- it('returns partial output when text exists without step_finish', () => {
706
- const output = `{"type":"step_start","sessionID":"ses_4"}
707
- {"type":"text","sessionID":"ses_4","part":{"type":"text","text":"Partial"}}`;
708
-
709
- expect(parseOpenCodeOutput(output)).toEqual({
710
- message: 'Partial',
711
- session_id: 'ses_4',
712
- });
713
- });
714
-
715
- it('ignores malformed lines and unknown event types', () => {
716
- const output = `not-json
717
- {"type":"unknown","sessionID":"ses_5"}
718
- {"type":"text","sessionID":"ses_5","part":{"type":"text","text":"Hello"}}`;
719
-
720
- expect(parseOpenCodeOutput(output)).toEqual({
721
- message: 'Hello',
722
- session_id: 'ses_5',
723
- });
724
- });
725
-
726
- it('returns null when no useful OpenCode events exist', () => {
727
- expect(parseOpenCodeOutput('{"type":"unknown"}')).toBeNull();
728
- expect(parseOpenCodeOutput('')).toBeNull();
729
- });
730
- });