@google/gemini-cli-core 0.70.0-preview.0 → 0.71.0-preview.0

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 (43) hide show
  1. package/dist/docs/changelogs/index.md +23 -0
  2. package/dist/docs/changelogs/latest.md +112 -98
  3. package/dist/docs/changelogs/preview.md +82 -115
  4. package/dist/src/confirmation-bus/types.d.ts +1 -0
  5. package/dist/src/confirmation-bus/types.js.map +1 -1
  6. package/dist/src/generated/git-commit.d.ts +2 -2
  7. package/dist/src/generated/git-commit.js +2 -2
  8. package/dist/src/policy/policy-engine.d.ts +1 -0
  9. package/dist/src/policy/policy-engine.js +15 -6
  10. package/dist/src/policy/policy-engine.js.map +1 -1
  11. package/dist/src/sandbox/utils/commandUtils.js +35 -25
  12. package/dist/src/sandbox/utils/commandUtils.js.map +1 -1
  13. package/dist/src/sandbox/windows/WindowsSandboxManager.d.ts +1 -0
  14. package/dist/src/sandbox/windows/WindowsSandboxManager.js +9 -2
  15. package/dist/src/sandbox/windows/WindowsSandboxManager.js.map +1 -1
  16. package/dist/src/sandbox/windows/commandSafety.js +4 -2
  17. package/dist/src/sandbox/windows/commandSafety.js.map +1 -1
  18. package/dist/src/scheduler/policy.js +6 -0
  19. package/dist/src/scheduler/policy.js.map +1 -1
  20. package/dist/src/scheduler/scheduler.js +79 -59
  21. package/dist/src/scheduler/scheduler.js.map +1 -1
  22. package/dist/src/tools/shell-powershell-parsing.integration.test.d.ts +6 -0
  23. package/dist/src/tools/shell-powershell-parsing.integration.test.js +576 -0
  24. package/dist/src/tools/shell-powershell-parsing.integration.test.js.map +1 -0
  25. package/dist/src/tools/shell.d.ts +6 -1
  26. package/dist/src/tools/shell.js +281 -189
  27. package/dist/src/tools/shell.js.map +1 -1
  28. package/dist/src/tools/tools.d.ts +1 -0
  29. package/dist/src/tools/tools.js.map +1 -1
  30. package/dist/src/utils/shell-parse-cache.d.ts +37 -0
  31. package/dist/src/utils/shell-parse-cache.js +55 -0
  32. package/dist/src/utils/shell-parse-cache.js.map +1 -0
  33. package/dist/src/utils/shell-parse-cache.test.d.ts +6 -0
  34. package/dist/src/utils/shell-parse-cache.test.js +478 -0
  35. package/dist/src/utils/shell-parse-cache.test.js.map +1 -0
  36. package/dist/src/utils/shell-utils.d.ts +27 -29
  37. package/dist/src/utils/shell-utils.js +385 -89
  38. package/dist/src/utils/shell-utils.js.map +1 -1
  39. package/dist/src/utils/untrustedContextTracker.d.ts +2 -6
  40. package/dist/src/utils/untrustedContextTracker.js +65 -27
  41. package/dist/src/utils/untrustedContextTracker.js.map +1 -1
  42. package/dist/tsconfig.tsbuildinfo +1 -1
  43. package/package.json +1 -1
@@ -0,0 +1,478 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { EventEmitter } from 'node:events';
7
+ import { PassThrough } from 'node:stream';
8
+ import { afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from 'vitest';
9
+ const mockPlatform = vi.hoisted(() => vi.fn());
10
+ const mockSpawn = vi.hoisted(() => vi.fn());
11
+ const mockSpawnSync = vi.hoisted(() => vi.fn());
12
+ vi.mock('node:os', async (importOriginal) => {
13
+ const actualOs = await importOriginal();
14
+ return {
15
+ ...actualOs,
16
+ default: {
17
+ ...actualOs,
18
+ platform: mockPlatform,
19
+ },
20
+ platform: mockPlatform,
21
+ };
22
+ });
23
+ vi.mock('node:child_process', () => ({
24
+ spawn: mockSpawn,
25
+ spawnSync: mockSpawnSync,
26
+ }));
27
+ import { CommandParseCache, getActiveCommandParseCache, runWithCommandParseCache, } from './shell-parse-cache.js';
28
+ import { getCommandName, getCommandRootAsync, getCommandRoots, getCommandRootsAsync, hasRedirection, hasRedirectionAsync, initializeShellParsers, isInteractiveGeminiCommand, isInteractiveGeminiCommandAsync, isKnownInteractiveGeminiCommandSync, parseCommandDetails, parseCommandDetailsAsync, splitCommands, splitCommandsAsync, } from './shell-utils.js';
29
+ import { isBuildOrTestCommandAsync, isRemoteContentCommandAsync, } from './untrustedContextTracker.js';
30
+ function createFakeChildProcess(options) {
31
+ const emitter = new EventEmitter();
32
+ const stdoutStream = new PassThrough();
33
+ const stderrStream = new PassThrough();
34
+ const proc = Object.assign(emitter, {
35
+ stdout: stdoutStream,
36
+ stderr: stderrStream,
37
+ pid: 4242,
38
+ kill: () => true,
39
+ });
40
+ const delay = options.delayMs ?? 5;
41
+ const timer = setTimeout(() => {
42
+ if (options.emitError) {
43
+ emitter.emit('error', options.emitError);
44
+ return;
45
+ }
46
+ if (options.stderr) {
47
+ stderrStream.write(options.stderr);
48
+ }
49
+ stderrStream.end();
50
+ if (options.stdout !== undefined) {
51
+ stdoutStream.write(options.stdout);
52
+ }
53
+ stdoutStream.end();
54
+ emitter.emit('close', options.exitCode ?? 0);
55
+ }, delay);
56
+ if (options.signal) {
57
+ const onAbort = () => {
58
+ clearTimeout(timer);
59
+ const abortErr = new Error('The operation was aborted');
60
+ abortErr.name = 'AbortError';
61
+ emitter.emit('error', abortErr);
62
+ };
63
+ if (options.signal.aborted) {
64
+ queueMicrotask(onAbort);
65
+ }
66
+ else {
67
+ options.signal.addEventListener('abort', onAbort, { once: true });
68
+ }
69
+ }
70
+ return proc;
71
+ }
72
+ describe('CommandParseCache and async PowerShell parsing (#30249)', () => {
73
+ beforeAll(async () => {
74
+ mockPlatform.mockReturnValue('linux');
75
+ await initializeShellParsers();
76
+ });
77
+ beforeEach(() => {
78
+ mockPlatform.mockReturnValue('win32');
79
+ vi.stubEnv('ComSpec', 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe');
80
+ mockSpawn.mockReset();
81
+ mockSpawnSync.mockReset();
82
+ });
83
+ afterEach(() => {
84
+ vi.unstubAllEnvs();
85
+ vi.clearAllMocks();
86
+ });
87
+ describe('CommandParseCache scoping', () => {
88
+ it('isolates independent scopes while sharing nested runWithCommandParseCache scopes', () => {
89
+ expect(getActiveCommandParseCache()).toBeUndefined();
90
+ let firstScopeCache;
91
+ runWithCommandParseCache((outerCache) => {
92
+ firstScopeCache = outerCache;
93
+ expect(getActiveCommandParseCache()).toBe(outerCache);
94
+ outerCache.setCompleted('powershell.exe', 'Get-ChildItem', {
95
+ details: [
96
+ { name: 'Get-ChildItem', text: 'Get-ChildItem', startIndex: 0 },
97
+ ],
98
+ hasError: false,
99
+ });
100
+ runWithCommandParseCache((innerCache) => {
101
+ expect(innerCache).toBe(outerCache);
102
+ expect(innerCache.getCompleted('powershell.exe', 'Get-ChildItem')).toBeDefined();
103
+ });
104
+ });
105
+ expect(getActiveCommandParseCache()).toBeUndefined();
106
+ runWithCommandParseCache((secondScopeCache) => {
107
+ expect(secondScopeCache).not.toBe(firstScopeCache);
108
+ expect(secondScopeCache.getCompleted('powershell.exe', 'Get-ChildItem')).toBeUndefined();
109
+ });
110
+ });
111
+ it('separates entries by executable and exact command string', () => {
112
+ const cache = new CommandParseCache();
113
+ cache.setCompleted('pwsh.exe', 'Get-Date', {
114
+ details: [{ name: 'Get-Date', text: 'Get-Date', startIndex: 0 }],
115
+ hasError: false,
116
+ });
117
+ expect(cache.getCompleted('pwsh.exe', 'Get-Date')).toBeDefined();
118
+ expect(cache.getCompleted('powershell.exe', 'Get-Date')).toBeUndefined();
119
+ expect(cache.getCompleted('pwsh.exe', 'Get-Date ')).toBeUndefined();
120
+ });
121
+ });
122
+ describe('Async PowerShell AST parsing and cache reuse', () => {
123
+ it('parses pipelines via async spawn without calling spawnSync and reuses cached results across sync and async helpers', async () => {
124
+ const cmd = 'Get-ChildItem | Sort-Object LastWriteTime -Descending | Select-Object -First 5 Name';
125
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
126
+ stdout: JSON.stringify({
127
+ success: true,
128
+ commands: [
129
+ {
130
+ name: 'Get-ChildItem',
131
+ text: 'Get-ChildItem',
132
+ startIndex: 0,
133
+ args: [],
134
+ },
135
+ {
136
+ name: 'Sort-Object',
137
+ text: 'Sort-Object LastWriteTime -Descending',
138
+ startIndex: 16,
139
+ args: ['LastWriteTime', '-Descending'],
140
+ },
141
+ {
142
+ name: 'Select-Object',
143
+ text: 'Select-Object -First 5 Name',
144
+ startIndex: 56,
145
+ args: ['-First', '5', 'Name'],
146
+ },
147
+ ],
148
+ hasRedirection: false,
149
+ hasCommandSubstitution: false,
150
+ }),
151
+ }));
152
+ await runWithCommandParseCache(async () => {
153
+ const parsed = await parseCommandDetailsAsync(cmd);
154
+ expect(parsed).toEqual({
155
+ details: [
156
+ {
157
+ name: 'Get-ChildItem',
158
+ text: 'Get-ChildItem',
159
+ startIndex: 0,
160
+ args: [],
161
+ },
162
+ {
163
+ name: 'Sort-Object',
164
+ text: 'Sort-Object LastWriteTime -Descending',
165
+ startIndex: 16,
166
+ args: ['LastWriteTime', '-Descending'],
167
+ },
168
+ {
169
+ name: 'Select-Object',
170
+ text: 'Select-Object -First 5 Name',
171
+ startIndex: 56,
172
+ args: ['-First', '5', 'Name'],
173
+ },
174
+ ],
175
+ hasError: false,
176
+ hasRedirection: false,
177
+ hasCommandSubstitution: false,
178
+ });
179
+ // Subsequent async and sync helpers inside the same scope reuse the cached parse
180
+ expect(await getCommandRootAsync(cmd)).toBe('Get-ChildItem');
181
+ expect(await getCommandRootsAsync(cmd)).toEqual([
182
+ 'Get-ChildItem',
183
+ 'Sort-Object',
184
+ 'Select-Object',
185
+ ]);
186
+ expect(await splitCommandsAsync(cmd)).toEqual([
187
+ 'Get-ChildItem',
188
+ 'Sort-Object LastWriteTime -Descending',
189
+ 'Select-Object -First 5 Name',
190
+ ]);
191
+ expect(getCommandRoots(cmd)).toEqual([
192
+ 'Get-ChildItem',
193
+ 'Sort-Object',
194
+ 'Select-Object',
195
+ ]);
196
+ expect(splitCommands(cmd)).toEqual([
197
+ 'Get-ChildItem',
198
+ 'Sort-Object LastWriteTime -Descending',
199
+ 'Select-Object -First 5 Name',
200
+ ]);
201
+ expect(parseCommandDetails(cmd)?.details).toHaveLength(3);
202
+ expect(isInteractiveGeminiCommand(cmd)).toBe(false);
203
+ expect(await isInteractiveGeminiCommandAsync(cmd)).toBe(false);
204
+ expect(await isBuildOrTestCommandAsync(cmd)).toBe(false);
205
+ expect(await isRemoteContentCommandAsync(cmd)).toBe(false);
206
+ });
207
+ expect(mockSpawn).toHaveBeenCalledTimes(1);
208
+ expect(mockSpawnSync).not.toHaveBeenCalled();
209
+ expect(mockSpawn).toHaveBeenCalledWith('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', expect.arrayContaining([
210
+ '-NoLogo',
211
+ '-NoProfile',
212
+ '-NonInteractive',
213
+ '-EncodedCommand',
214
+ ]), expect.objectContaining({
215
+ windowsHide: true,
216
+ stdio: ['ignore', 'pipe', 'pipe'],
217
+ }));
218
+ });
219
+ it('deduplicates concurrent in-flight async parses within the same cache scope', async () => {
220
+ const cmd = 'Write-Output "a -> b"';
221
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
222
+ delayMs: 30,
223
+ stdout: JSON.stringify({
224
+ success: true,
225
+ commands: {
226
+ name: 'Write-Output',
227
+ text: 'Write-Output "a -> b"',
228
+ startIndex: 0,
229
+ args: ['"a -> b"'],
230
+ },
231
+ hasRedirection: false,
232
+ hasCommandSubstitution: false,
233
+ }),
234
+ }));
235
+ await runWithCommandParseCache(async () => {
236
+ const [details, roots, redirected] = await Promise.all([
237
+ parseCommandDetailsAsync(cmd),
238
+ getCommandRootsAsync(cmd),
239
+ hasRedirectionAsync(cmd),
240
+ ]);
241
+ expect(details?.hasError).toBe(false);
242
+ expect(roots).toEqual(['Write-Output']);
243
+ expect(redirected).toBe(false);
244
+ expect(hasRedirection(cmd)).toBe(false);
245
+ });
246
+ expect(mockSpawn).toHaveBeenCalledTimes(1);
247
+ expect(mockSpawnSync).not.toHaveBeenCalled();
248
+ });
249
+ it('handles empty input without spawning PowerShell', async () => {
250
+ const result = await parseCommandDetailsAsync(' ');
251
+ expect(result).toEqual({ details: [], hasError: true });
252
+ expect(await getCommandRootsAsync('')).toEqual([]);
253
+ expect(await hasRedirectionAsync('Get-ChildItem')).toBe(false);
254
+ expect(mockSpawn).not.toHaveBeenCalled();
255
+ expect(mockSpawnSync).not.toHaveBeenCalled();
256
+ });
257
+ it('falls back to Bash parser for simple commands when PowerShell spawn errors or exits non-zero', async () => {
258
+ mockSpawn.mockImplementationOnce(() => createFakeChildProcess({
259
+ emitError: new Error('ENOENT'),
260
+ }));
261
+ const fromSpawnError = await getCommandRootsAsync('git status && npm ci');
262
+ expect(fromSpawnError).toEqual(['git', 'npm']);
263
+ mockSpawn.mockImplementationOnce(() => createFakeChildProcess({
264
+ exitCode: 1,
265
+ stderr: 'ConstrainedLanguage error',
266
+ }));
267
+ const fromNonZero = await splitCommandsAsync('echo hello | cat');
268
+ expect(fromNonZero).toEqual(['echo hello', 'cat']);
269
+ });
270
+ it('never falls back to Bash parser when PowerShell command substitution is detected', async () => {
271
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
272
+ stdout: JSON.stringify({ success: false }),
273
+ }));
274
+ const subExprResult = await parseCommandDetailsAsync('Write-Output @(Get-Process)');
275
+ expect(subExprResult).toEqual({ details: [], hasError: true });
276
+ const bareParenResult = await parseCommandDetailsAsync('Write-Output (whoami)');
277
+ expect(bareParenResult).toEqual({ details: [], hasError: true });
278
+ });
279
+ it('falls back to regex redirection detection when PowerShell parsing fails', async () => {
280
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
281
+ stdout: 'not-valid-json',
282
+ }));
283
+ expect(await hasRedirectionAsync('Write-Output "a -> b"')).toBe(true);
284
+ });
285
+ it('detects interactive gemini commands and remote/build commands asynchronously', async () => {
286
+ mockSpawn.mockImplementation((_exe, _args, opts) => {
287
+ const cmd = opts?.env?.['__GCLI_POWERSHELL_COMMAND__'] ?? '';
288
+ const parts = cmd.split(';').map((s, idx) => ({
289
+ name: s.trim().split(/\s+/)[0] ?? '',
290
+ text: s.trim(),
291
+ startIndex: idx * 10,
292
+ }));
293
+ return createFakeChildProcess({
294
+ stdout: JSON.stringify({
295
+ success: true,
296
+ commands: parts,
297
+ hasRedirection: false,
298
+ }),
299
+ });
300
+ });
301
+ expect(await isInteractiveGeminiCommandAsync('powershell.exe -NoProfile -Command "echo ok; gemini config list"')).toBe(true);
302
+ expect(await isInteractiveGeminiCommandAsync('gemini mcp list')).toBe(false);
303
+ expect(await isBuildOrTestCommandAsync('npm test')).toBe(true);
304
+ expect(await isRemoteContentCommandAsync('curl https://example.com')).toBe(true);
305
+ expect(await getCommandName('powershell.exe', ['-Command', 'git status'])).toBe('git');
306
+ expect(mockSpawnSync).not.toHaveBeenCalled();
307
+ });
308
+ it('caches failed PowerShell parses (null) within a scope so subsequent sync helpers do not invoke spawnSync', async () => {
309
+ const cmd = 'git status && echo "a -> b"';
310
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
311
+ exitCode: 1,
312
+ stderr: 'Policy error',
313
+ }));
314
+ await runWithCommandParseCache(async (cache) => {
315
+ expect(await getCommandRootsAsync(cmd)).toEqual(['git', 'echo']);
316
+ expect(cache.hasCompleted('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', cmd)).toBe(true);
317
+ expect(cache.getCompleted('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', cmd)).toBeNull();
318
+ // Subsequent sync and async calls inside the same scope reuse cached null
319
+ // and fall back in-process without calling spawnSync or re-spawning.
320
+ expect(getCommandRoots(cmd)).toEqual(['git', 'echo']);
321
+ expect(hasRedirection(cmd)).toBe(true);
322
+ expect(parseCommandDetails(cmd)?.details.map((d) => d.name)).toEqual([
323
+ 'git',
324
+ 'echo',
325
+ ]);
326
+ expect(await hasRedirectionAsync(cmd)).toBe(true);
327
+ });
328
+ expect(mockSpawn).toHaveBeenCalledTimes(1);
329
+ expect(mockSpawnSync).not.toHaveBeenCalled();
330
+ });
331
+ it('coalesces concurrent in-flight async parses across separate scopes without retaining process-wide state after completion', async () => {
332
+ const cmd = 'Get-ChildItem > out.txt';
333
+ mockSpawn.mockImplementation(() => createFakeChildProcess({
334
+ delayMs: 30,
335
+ stdout: JSON.stringify({
336
+ success: true,
337
+ commands: {
338
+ name: 'Get-ChildItem',
339
+ text: 'Get-ChildItem > out.txt',
340
+ startIndex: 0,
341
+ args: [],
342
+ },
343
+ hasRedirection: true,
344
+ hasCommandSubstitution: false,
345
+ }),
346
+ }));
347
+ // Simulate Scheduler (inside CommandParseCache) and UI hook (outside cache)
348
+ // requesting the exact same command parse concurrently.
349
+ const [schedulerParsed, uiRedirected] = await Promise.all([
350
+ runWithCommandParseCache(() => parseCommandDetailsAsync(cmd)),
351
+ hasRedirectionAsync(cmd),
352
+ ]);
353
+ expect(schedulerParsed?.hasRedirection).toBe(true);
354
+ expect(uiRedirected).toBe(true);
355
+ expect(mockSpawn).toHaveBeenCalledTimes(1);
356
+ // Once settled, global in-flight map is empty, so a later parse in a new
357
+ // scope spawns fresh rather than reading stale process-wide state.
358
+ await runWithCommandParseCache(() => parseCommandDetailsAsync(cmd));
359
+ expect(mockSpawn).toHaveBeenCalledTimes(2);
360
+ expect(mockSpawnSync).not.toHaveBeenCalled();
361
+ });
362
+ it('short-circuits non-gemini and obvious interactive gemini commands without spawning and disambiguates ambiguous commands asynchronously', async () => {
363
+ expect(isKnownInteractiveGeminiCommandSync('dir')).toBe(false);
364
+ expect(isKnownInteractiveGeminiCommandSync('Get-ChildItem')).toBe(false);
365
+ expect(isInteractiveGeminiCommand('Get-ChildItem')).toBe(false);
366
+ expect(await isInteractiveGeminiCommandAsync('Get-ChildItem')).toBe(false);
367
+ expect(isKnownInteractiveGeminiCommandSync('gemini config set default-model gemini-2.5 -y')).toBe(true);
368
+ expect(isInteractiveGeminiCommand('powershell.exe -NoProfile -Command "echo ok; gemini"')).toBe(true);
369
+ expect(mockSpawn).not.toHaveBeenCalled();
370
+ expect(mockSpawnSync).not.toHaveBeenCalled();
371
+ // Ambiguous commands containing g..e..m..i..n..i return undefined from sync fast check
372
+ expect(isKnownInteractiveGeminiCommandSync('Get-Content GEMINI.md')).toBeUndefined();
373
+ mockSpawn.mockImplementationOnce(() => createFakeChildProcess({
374
+ stdout: JSON.stringify({
375
+ success: true,
376
+ commands: [
377
+ {
378
+ name: 'Get-Content',
379
+ text: 'Get-Content GEMINI.md',
380
+ startIndex: 0,
381
+ args: ['GEMINI.md'],
382
+ },
383
+ ],
384
+ hasRedirection: false,
385
+ }),
386
+ }));
387
+ expect(await isInteractiveGeminiCommandAsync('Get-Content GEMINI.md')).toBe(false);
388
+ mockSpawn.mockImplementationOnce(() => createFakeChildProcess({
389
+ stdout: JSON.stringify({
390
+ success: true,
391
+ commands: [
392
+ {
393
+ name: 'Get-Item',
394
+ text: 'Get-Item foo',
395
+ startIndex: 0,
396
+ args: ['foo'],
397
+ },
398
+ {
399
+ name: 'gemini',
400
+ text: 'gemini',
401
+ startIndex: 31,
402
+ args: [],
403
+ },
404
+ ],
405
+ hasRedirection: false,
406
+ }),
407
+ }));
408
+ expect(await isInteractiveGeminiCommandAsync('Get-Item foo | ForEach-Object { gemini }')).toBe(true);
409
+ expect(mockSpawn).toHaveBeenCalledTimes(2);
410
+ expect(mockSpawnSync).not.toHaveBeenCalled();
411
+ });
412
+ it('propagates AbortSignal to spawn and avoids caching null when aborted', async () => {
413
+ const cmd = 'Get-ChildItem > aborted.txt';
414
+ const preAborted = new AbortController();
415
+ preAborted.abort();
416
+ await runWithCommandParseCache(async (cache) => {
417
+ expect(await parseCommandDetailsAsync(cmd, cache, preAborted.signal)).toBeNull();
418
+ expect(await hasRedirectionAsync(cmd, cache, preAborted.signal)).toBe(false);
419
+ expect(mockSpawn).not.toHaveBeenCalled();
420
+ expect(cache.hasCompleted('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', cmd)).toBe(false);
421
+ });
422
+ const inFlightAbort = new AbortController();
423
+ mockSpawn.mockImplementationOnce((_exe, _args, opts) => createFakeChildProcess({
424
+ delayMs: 100,
425
+ signal: opts?.signal,
426
+ stdout: JSON.stringify({ success: true, commands: [] }),
427
+ }));
428
+ await runWithCommandParseCache(async (cache) => {
429
+ const pending = parseCommandDetailsAsync(cmd, cache, inFlightAbort.signal);
430
+ inFlightAbort.abort();
431
+ expect(await pending).toBeNull();
432
+ expect(mockSpawn).toHaveBeenCalledTimes(1);
433
+ expect(mockSpawn).toHaveBeenLastCalledWith('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', expect.any(Array), expect.objectContaining({ signal: inFlightAbort.signal }));
434
+ // Aborted parse must not poison the cache with null
435
+ expect(cache.hasCompleted('C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe', cmd)).toBe(false);
436
+ // Subsequent un-aborted parse in the same cache succeeds cleanly
437
+ mockSpawn.mockImplementationOnce(() => createFakeChildProcess({
438
+ stdout: JSON.stringify({
439
+ success: true,
440
+ commands: [
441
+ {
442
+ name: 'Get-ChildItem',
443
+ text: cmd,
444
+ startIndex: 0,
445
+ args: [],
446
+ },
447
+ ],
448
+ hasRedirection: true,
449
+ }),
450
+ }));
451
+ expect(await hasRedirectionAsync(cmd, cache)).toBe(true);
452
+ expect(mockSpawn).toHaveBeenCalledTimes(2);
453
+ });
454
+ expect(mockSpawnSync).not.toHaveBeenCalled();
455
+ });
456
+ it('runs isKnownInteractiveGeminiCommandSync in linear time on adversarial non-matching input and handles multiline subsequences', () => {
457
+ // Adversarial input that triggers O(N^5) backtracking on /g[\s\S]*e[\s\S]*m[\s\S]*i[\s\S]*n[\s\S]*i/i
458
+ const adversarial = 'g'.repeat(10_000) +
459
+ 'e'.repeat(10_000) +
460
+ 'm'.repeat(10_000) +
461
+ 'i'.repeat(10_000) +
462
+ 'n'.repeat(10_000);
463
+ const start = performance.now();
464
+ expect(isKnownInteractiveGeminiCommandSync(adversarial)).toBe(false);
465
+ const elapsedMs = performance.now() - start;
466
+ expect(elapsedMs).toBeLessThan(200);
467
+ // Multiline subsequence (e.g. PowerShell backtick-newline continuation) must still be considered a candidate
468
+ expect(isKnownInteractiveGeminiCommandSync('Write-Output "g`\ne`\nm`\ni`\nn`\ni"')).toBeUndefined();
469
+ // Non-candidate multiline command returns false immediately
470
+ expect(isKnownInteractiveGeminiCommandSync('Get-ChildItem\nSort-Object Name')).toBe(false);
471
+ // Direct interactive invocation still returns true synchronously
472
+ expect(isKnownInteractiveGeminiCommandSync('GEMINI config list')).toBe(true);
473
+ expect(mockSpawn).not.toHaveBeenCalled();
474
+ expect(mockSpawnSync).not.toHaveBeenCalled();
475
+ });
476
+ });
477
+ });
478
+ //# sourceMappingURL=shell-parse-cache.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell-parse-cache.test.js","sourceRoot":"","sources":["../../../src/utils/shell-parse-cache.test.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,8 @@
5
5
  */
6
6
  import { type ParseEntry } from 'shell-quote';
7
7
  import { type SpawnOptionsWithoutStdio } from 'node:child_process';
8
+ import { CommandParseCache, getActiveCommandParseCache, runWithCommandParseCache, type CommandParseResult, type ParsedCommandDetail } from './shell-parse-cache.js';
9
+ export { CommandParseCache, getActiveCommandParseCache, runWithCommandParseCache, type CommandParseResult, type ParsedCommandDetail, };
8
10
  /**
9
11
  * Extracts the primary command name from a potentially wrapped shell command.
10
12
  * Strips shell wrappers and handles shopt/set/etc.
@@ -44,18 +46,6 @@ export interface ShellConfiguration {
44
46
  }
45
47
  export declare function resolveExecutable(exe: string): string | undefined;
46
48
  export declare function initializeShellParsers(): Promise<void>;
47
- export interface ParsedCommandDetail {
48
- name: string;
49
- text: string;
50
- startIndex: number;
51
- args?: string[];
52
- }
53
- interface CommandParseResult {
54
- details: ParsedCommandDetail[];
55
- hasError: boolean;
56
- hasRedirection?: boolean;
57
- hasCommandSubstitution?: boolean;
58
- }
59
49
  export declare const REDIRECTION_NAMES: Set<string>;
60
50
  /**
61
51
  * Normalizes a command name for sandbox policy lookups.
@@ -66,7 +56,9 @@ export declare const REDIRECTION_NAMES: Set<string>;
66
56
  */
67
57
  export declare function normalizeCommand(commandName: string): string;
68
58
  export declare function parseBashCommandDetails(command: string): CommandParseResult | null;
69
- export declare function parseCommandDetails(command: string): CommandParseResult | null;
59
+ export declare function parseCommandDetails(command: string, cache?: CommandParseCache): CommandParseResult | null;
60
+ export declare function parseCommandDetailsAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<CommandParseResult | null>;
61
+ export declare function isDefaultParseCommandDetails(fn: unknown): boolean;
70
62
  /**
71
63
  * Determines the appropriate shell configuration for the current platform.
72
64
  *
@@ -97,17 +89,8 @@ export declare const isWindows: () => boolean;
97
89
  * @returns The shell-escaped string.
98
90
  */
99
91
  export declare function escapeShellArg(arg: string, shell: ShellType): string;
100
- /**
101
- * Splits a shell command into a list of individual commands, respecting quotes.
102
- * This is used to separate chained commands (e.g., using &&, ||, ;).
103
- * @param command The shell command string to parse
104
- * @returns An array of individual command strings
105
- */
106
- /**
107
- * Checks if a command contains redirection operators.
108
- * Uses shell-specific parsers where possible, falling back to a broad regex check.
109
- */
110
- export declare function hasRedirection(command: string): boolean;
92
+ export declare function hasRedirection(command: string, cache?: CommandParseCache): boolean;
93
+ export declare function hasRedirectionAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<boolean>;
111
94
  /**
112
95
  * Checks whether bash would rewrite the arguments of a command before running
113
96
  * it, so the unexpanded text doesn't describe what runs. This covers brace
@@ -121,7 +104,8 @@ export declare function hasRedirection(command: string): boolean;
121
104
  * bash.
122
105
  */
123
106
  export declare function hasUnresolvedShellExpansion(command: string): boolean;
124
- export declare function splitCommands(command: string): string[];
107
+ export declare function splitCommands(command: string, cache?: CommandParseCache): string[];
108
+ export declare function splitCommandsAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<string[]>;
125
109
  /**
126
110
  * Extracts the root command from a given shell command string.
127
111
  * This is used to identify the base command for permission checks.
@@ -130,8 +114,13 @@ export declare function splitCommands(command: string): string[];
130
114
  * @example getCommandRoot("ls -la /tmp") returns "ls"
131
115
  * @example getCommandRoot("git status && npm test") returns "git"
132
116
  */
133
- export declare function getCommandRoot(command: string): string | undefined;
134
- export declare function getCommandRoots(command: string): string[];
117
+ export declare function getCommandRoot(command: string, cache?: CommandParseCache): string | undefined;
118
+ export declare function getCommandRootAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<string | undefined>;
119
+ export declare function getCommandRoots(command: string, cache?: CommandParseCache): string[];
120
+ export declare function getCommandRootsAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<string[]>;
121
+ export declare function isDefaultHasRedirection(fn: unknown): boolean;
122
+ export declare function isDefaultSplitCommands(fn: unknown): boolean;
123
+ export declare function isDefaultGetCommandRoots(fn: unknown): boolean;
135
124
  export declare function stripShellWrapper(command: string): string;
136
125
  /**
137
126
  * Detects command substitution patterns in a shell command, following bash quoting rules:
@@ -172,10 +161,19 @@ export declare function execStreaming(command: string, args: string[], options?:
172
161
  sandboxManager?: SandboxManager;
173
162
  }): AsyncGenerator<string, void, void>;
174
163
  export declare function detectCommandSubstitution(command: string): boolean;
164
+ /**
165
+ * Performs purely in-process checks for interactive `gemini` commands without
166
+ * spawning any external shell parser. Returns `false` when the command cannot
167
+ * invoke `gemini`, `true` when synchronous segment tokenization already detects
168
+ * an interactive `gemini` invocation, or `undefined` when AST command splitting
169
+ * is still required to disambiguate.
170
+ */
171
+ export declare function isKnownInteractiveGeminiCommandSync(command: string): boolean | undefined;
175
172
  /**
176
173
  * Checks whether a shell command string attempts to invoke an interactive
177
174
  * `gemini` CLI session or an invalid management subcommand such as
178
175
  * `gemini config ...`.
179
176
  */
180
- export declare function isInteractiveGeminiCommand(command: string): boolean;
181
- export {};
177
+ export declare function isInteractiveGeminiCommand(command: string, cache?: CommandParseCache): boolean;
178
+ export declare function isInteractiveGeminiCommandAsync(command: string, cache?: CommandParseCache, signal?: AbortSignal): Promise<boolean>;
179
+ export declare function isDefaultIsInteractiveGeminiCommand(fn: unknown): boolean;