@zgsm/costrict-cli 0.0.1

package/dist/src/ui/utils/clipboardUtils.js

@@ -0,0 +1,212 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { debugLogger, spawnAsync, unescapePath, escapePath, } from '@google/gemini-cli-core';
+/**
+ * Supported image file extensions based on Gemini API.
+ * See: https://ai.google.dev/gemini-api/docs/image-understanding
+ */
+export const IMAGE_EXTENSIONS = [
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.webp',
+    '.heic',
+    '.heif',
+];
+/** Matches strings that start with a path prefix (/, ~, ., Windows drive letter, or UNC path) */
+const PATH_PREFIX_PATTERN = /^([/~.]|[a-zA-Z]:|\\\\)/;
+/**
+ * Checks if the system clipboard contains an image (macOS only for now)
+ * @returns true if clipboard contains an image
+ */
+export async function clipboardHasImage() {
+    if (process.platform !== 'darwin') {
+        return false;
+    }
+    try {
+        // Use osascript to check clipboard type
+        const { stdout } = await spawnAsync('osascript', ['-e', 'clipboard info']);
+        const imageRegex = /«class PNGf»|TIFF picture|JPEG picture|GIF picture|«class JPEG»|«class TIFF»/;
+        return imageRegex.test(stdout);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Saves the image from clipboard to a temporary file (macOS only for now)
+ * @param targetDir The target directory to create temp files within
+ * @returns The path to the saved image file, or null if no image or error
+ */
+export async function saveClipboardImage(targetDir) {
+    if (process.platform !== 'darwin') {
+        return null;
+    }
+    try {
+        // Create a temporary directory for clipboard images within the target directory
+        // This avoids security restrictions on paths outside the target directory
+        const baseDir = targetDir || process.cwd();
+        const tempDir = path.join(baseDir, '.gemini-clipboard');
+        await fs.mkdir(tempDir, { recursive: true });
+        // Generate a unique filename with timestamp
+        const timestamp = new Date().getTime();
+        // AppleScript clipboard classes to try, in order of preference.
+        // macOS converts clipboard images to these formats (WEBP/HEIC/HEIF not supported by osascript).
+        const formats = [
+            { class: 'PNGf', extension: 'png' },
+            { class: 'JPEG', extension: 'jpg' },
+        ];
+        for (const format of formats) {
+            const tempFilePath = path.join(tempDir, `clipboard-${timestamp}.${format.extension}`);
+            // Try to save clipboard as this format
+            const script = `
+        try
+          set imageData to the clipboard as «class ${format.class}»
+          set fileRef to open for access POSIX file "${tempFilePath}" with write permission
+          write imageData to fileRef
+          close access fileRef
+          return "success"
+        on error errMsg
+          try
+            close access POSIX file "${tempFilePath}"
+          end try
+          return "error"
+        end try
+      `;
+            const { stdout } = await spawnAsync('osascript', ['-e', script]);
+            if (stdout.trim() === 'success') {
+                // Verify the file was created and has content
+                try {
+                    const stats = await fs.stat(tempFilePath);
+                    if (stats.size > 0) {
+                        return tempFilePath;
+                    }
+                }
+                catch (e) {
+                    // File doesn't exist, continue to next format
+                    debugLogger.debug('Clipboard image file not found:', tempFilePath, e);
+                }
+            }
+            // Clean up failed attempt
+            try {
+                await fs.unlink(tempFilePath);
+            }
+            catch (e) {
+                // Ignore cleanup errors
+                debugLogger.debug('Failed to clean up temp file:', tempFilePath, e);
+            }
+        }
+        // No format worked
+        return null;
+    }
+    catch (error) {
+        debugLogger.warn('Error saving clipboard image:', error);
+        return null;
+    }
+}
+/**
+ * Cleans up old temporary clipboard image files
+ * Removes files older than 1 hour
+ * @param targetDir The target directory where temp files are stored
+ */
+export async function cleanupOldClipboardImages(targetDir) {
+    try {
+        const baseDir = targetDir || process.cwd();
+        const tempDir = path.join(baseDir, '.gemini-clipboard');
+        const files = await fs.readdir(tempDir);
+        const oneHourAgo = Date.now() - 60 * 60 * 1000;
+        for (const file of files) {
+            const ext = path.extname(file).toLowerCase();
+            if (file.startsWith('clipboard-') && IMAGE_EXTENSIONS.includes(ext)) {
+                const filePath = path.join(tempDir, file);
+                const stats = await fs.stat(filePath);
+                if (stats.mtimeMs < oneHourAgo) {
+                    await fs.unlink(filePath);
+                }
+            }
+        }
+    }
+    catch (e) {
+        // Ignore errors in cleanup
+        debugLogger.debug('Failed to clean up old clipboard images:', e);
+    }
+}
+/**
+ * Splits text into individual path segments, respecting escaped spaces.
+ * Unescaped spaces act as separators between paths, while "\ " is preserved
+ * as part of a filename.
+ *
+ * Example: "/img1.png /path/my\ image.png" → ["/img1.png", "/path/my\ image.png"]
+ *
+ * @param text The text to split
+ * @returns Array of path segments (still escaped)
+ */
+export function splitEscapedPaths(text) {
+    const paths = [];
+    let current = '';
+    let i = 0;
+    while (i < text.length) {
+        const char = text[i];
+        if (char === '\\' && i + 1 < text.length && text[i + 1] === ' ') {
+            // Escaped space - part of filename, preserve the escape sequence
+            current += '\\ ';
+            i += 2;
+        }
+        else if (char === ' ') {
+            // Unescaped space - path separator
+            if (current.trim()) {
+                paths.push(current.trim());
+            }
+            current = '';
+            i++;
+        }
+        else {
+            current += char;
+            i++;
+        }
+    }
+    // Don't forget the last segment
+    if (current.trim()) {
+        paths.push(current.trim());
+    }
+    return paths;
+}
+/**
+ * Processes pasted text containing file paths, adding @ prefix to valid paths.
+ * Handles both single and multiple space-separated paths.
+ *
+ * @param text The pasted text (potentially space-separated paths)
+ * @param isValidPath Function to validate if a path exists/is valid
+ * @returns Processed string with @ prefixes on valid paths, or null if no valid paths
+ */
+export function parsePastedPaths(text, isValidPath) {
+    // First, check if the entire text is a single valid path
+    if (PATH_PREFIX_PATTERN.test(text) && isValidPath(text)) {
+        return `@${escapePath(text)} `;
+    }
+    // Otherwise, try splitting on unescaped spaces
+    const segments = splitEscapedPaths(text);
+    if (segments.length === 0) {
+        return null;
+    }
+    let anyValidPath = false;
+    const processedPaths = segments.map((segment) => {
+        // Quick rejection: skip segments that can't be paths
+        if (!PATH_PREFIX_PATTERN.test(segment)) {
+            return segment;
+        }
+        const unescaped = unescapePath(segment);
+        if (isValidPath(unescaped)) {
+            anyValidPath = true;
+            return `@${segment}`;
+        }
+        return segment;
+    });
+    return anyValidPath ? processedPaths.join(' ') + ' ' : null;
+}
+//# sourceMappingURL=clipboardUtils.js.map

package/dist/src/ui/utils/clipboardUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardUtils.js","sourceRoot":"","sources":["../../../../src/ui/utils/clipboardUtils.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/utils/clipboardUtils.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/utils/clipboardUtils.test.js

@@ -0,0 +1,187 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { clipboardHasImage, saveClipboardImage, cleanupOldClipboardImages, splitEscapedPaths, parsePastedPaths, } from './clipboardUtils.js';
+describe('clipboardUtils', () => {
+    describe('clipboardHasImage', () => {
+        it('should return false on non-macOS platforms', async () => {
+            if (process.platform !== 'darwin') {
+                const result = await clipboardHasImage();
+                expect(result).toBe(false);
+            }
+            else {
+                // Skip on macOS as it would require actual clipboard state
+                expect(true).toBe(true);
+            }
+        });
+        it('should return boolean on macOS', async () => {
+            if (process.platform === 'darwin') {
+                const result = await clipboardHasImage();
+                expect(typeof result).toBe('boolean');
+            }
+            else {
+                // Skip on non-macOS
+                expect(true).toBe(true);
+            }
+        });
+    });
+    describe('saveClipboardImage', () => {
+        it('should return null on non-macOS platforms', async () => {
+            if (process.platform !== 'darwin') {
+                const result = await saveClipboardImage();
+                expect(result).toBe(null);
+            }
+            else {
+                // Skip on macOS
+                expect(true).toBe(true);
+            }
+        });
+        it('should handle errors gracefully', async () => {
+            // Test with invalid directory (should not throw)
+            const result = await saveClipboardImage('/invalid/path/that/does/not/exist');
+            if (process.platform === 'darwin') {
+                // On macOS, might return null due to various errors
+                expect(result === null || typeof result === 'string').toBe(true);
+            }
+            else {
+                // On other platforms, should always return null
+                expect(result).toBe(null);
+            }
+        });
+    });
+    describe('cleanupOldClipboardImages', () => {
+        it('should not throw errors', async () => {
+            // Should handle missing directories gracefully
+            await expect(cleanupOldClipboardImages('/path/that/does/not/exist')).resolves.not.toThrow();
+        });
+        it('should complete without errors on valid directory', async () => {
+            await expect(cleanupOldClipboardImages('.')).resolves.not.toThrow();
+        });
+    });
+    describe('splitEscapedPaths', () => {
+        it('should return single path when no spaces', () => {
+            expect(splitEscapedPaths('/path/to/image.png')).toEqual([
+                '/path/to/image.png',
+            ]);
+        });
+        it('should split simple space-separated paths', () => {
+            expect(splitEscapedPaths('/img1.png /img2.png')).toEqual([
+                '/img1.png',
+                '/img2.png',
+            ]);
+        });
+        it('should split three paths', () => {
+            expect(splitEscapedPaths('/a.png /b.jpg /c.heic')).toEqual([
+                '/a.png',
+                '/b.jpg',
+                '/c.heic',
+            ]);
+        });
+        it('should preserve escaped spaces within filenames', () => {
+            expect(splitEscapedPaths('/my\\ image.png')).toEqual(['/my\\ image.png']);
+        });
+        it('should handle multiple paths with escaped spaces', () => {
+            expect(splitEscapedPaths('/my\\ img1.png /my\\ img2.png')).toEqual([
+                '/my\\ img1.png',
+                '/my\\ img2.png',
+            ]);
+        });
+        it('should handle path with multiple escaped spaces', () => {
+            expect(splitEscapedPaths('/path/to/my\\ cool\\ image.png')).toEqual([
+                '/path/to/my\\ cool\\ image.png',
+            ]);
+        });
+        it('should handle multiple consecutive spaces between paths', () => {
+            expect(splitEscapedPaths('/img1.png   /img2.png')).toEqual([
+                '/img1.png',
+                '/img2.png',
+            ]);
+        });
+        it('should handle trailing and leading whitespace', () => {
+            expect(splitEscapedPaths('  /img1.png /img2.png  ')).toEqual([
+                '/img1.png',
+                '/img2.png',
+            ]);
+        });
+        it('should return empty array for empty string', () => {
+            expect(splitEscapedPaths('')).toEqual([]);
+        });
+        it('should return empty array for whitespace only', () => {
+            expect(splitEscapedPaths('   ')).toEqual([]);
+        });
+    });
+    describe('parsePastedPaths', () => {
+        it('should return null for empty string', () => {
+            const result = parsePastedPaths('', () => true);
+            expect(result).toBe(null);
+        });
+        it('should add @ prefix to single valid path', () => {
+            const result = parsePastedPaths('/path/to/file.txt', () => true);
+            expect(result).toBe('@/path/to/file.txt ');
+        });
+        it('should return null for single invalid path', () => {
+            const result = parsePastedPaths('/path/to/file.txt', () => false);
+            expect(result).toBe(null);
+        });
+        it('should add @ prefix to all valid paths', () => {
+            // Use Set to model reality: individual paths exist, combined string doesn't
+            const validPaths = new Set(['/path/to/file1.txt', '/path/to/file2.txt']);
+            const result = parsePastedPaths('/path/to/file1.txt /path/to/file2.txt', (p) => validPaths.has(p));
+            expect(result).toBe('@/path/to/file1.txt @/path/to/file2.txt ');
+        });
+        it('should only add @ prefix to valid paths', () => {
+            const result = parsePastedPaths('/valid/file.txt /invalid/file.jpg', (p) => p.endsWith('.txt'));
+            expect(result).toBe('@/valid/file.txt /invalid/file.jpg ');
+        });
+        it('should return null if no paths are valid', () => {
+            const result = parsePastedPaths('/path/to/file1.txt /path/to/file2.txt', () => false);
+            expect(result).toBe(null);
+        });
+        it('should handle paths with escaped spaces', () => {
+            // Use Set to model reality: individual paths exist, combined string doesn't
+            const validPaths = new Set(['/path/to/my file.txt', '/other/path.txt']);
+            const result = parsePastedPaths('/path/to/my\\ file.txt /other/path.txt', (p) => validPaths.has(p));
+            expect(result).toBe('@/path/to/my\\ file.txt @/other/path.txt ');
+        });
+        it('should unescape paths before validation', () => {
+            // Use Set to model reality: individual paths exist, combined string doesn't
+            const validPaths = new Set(['/my file.txt', '/other.txt']);
+            const validatedPaths = [];
+            parsePastedPaths('/my\\ file.txt /other.txt', (p) => {
+                validatedPaths.push(p);
+                return validPaths.has(p);
+            });
+            // First checks entire string, then individual unescaped segments
+            expect(validatedPaths).toEqual([
+                '/my\\ file.txt /other.txt',
+                '/my file.txt',
+                '/other.txt',
+            ]);
+        });
+        it('should handle single path with unescaped spaces from copy-paste', () => {
+            const result = parsePastedPaths('/path/to/my file.txt', () => true);
+            expect(result).toBe('@/path/to/my\\ file.txt ');
+        });
+        it('should handle Windows path', () => {
+            const result = parsePastedPaths('C:\\Users\\file.txt', () => true);
+            expect(result).toBe('@C:\\Users\\file.txt ');
+        });
+        it('should handle Windows path with unescaped spaces', () => {
+            const result = parsePastedPaths('C:\\My Documents\\file.txt', () => true);
+            expect(result).toBe('@C:\\My\\ Documents\\file.txt ');
+        });
+        it('should handle multiple Windows paths', () => {
+            const validPaths = new Set(['C:\\file1.txt', 'D:\\file2.txt']);
+            const result = parsePastedPaths('C:\\file1.txt D:\\file2.txt', (p) => validPaths.has(p));
+            expect(result).toBe('@C:\\file1.txt @D:\\file2.txt ');
+        });
+        it('should handle Windows UNC path', () => {
+            const result = parsePastedPaths('\\\\server\\share\\file.txt', () => true);
+            expect(result).toBe('@\\\\server\\share\\file.txt ');
+        });
+    });
+});
+//# sourceMappingURL=clipboardUtils.test.js.map

package/dist/src/ui/utils/clipboardUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardUtils.test.js","sourceRoot":"","sources":["../../../../src/ui/utils/clipboardUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/utils/commandUtils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SlashCommand } from '../commands/types.js';
+/**
+ * Checks if a query string potentially represents an '@' command.
+ * It triggers if the query starts with '@' or contains '@' preceded by whitespace
+ * and followed by a non-whitespace character.
+ *
+ * @param query The input query string.
+ * @returns True if the query looks like an '@' command, false otherwise.
+ */
+export declare const isAtCommand: (query: string) => boolean;
+/**
+ * Checks if a query string potentially represents an '/' command.
+ * It triggers if the query starts with '/' but excludes code comments like '//' and '/*'.
+ *
+ * @param query The input query string.
+ * @returns True if the query looks like an '/' command, false otherwise.
+ */
+export declare const isSlashCommand: (query: string) => boolean;
+export declare const copyToClipboard: (text: string) => Promise<void>;
+export declare const getUrlOpenCommand: () => string;
+/**
+ * Determines if a slash command should auto-execute when selected.
+ *
+ * All built-in commands have autoExecute explicitly set to true or false.
+ * Custom commands (.toml files) and extension commands without this flag
+ * will default to false (safe default - won't auto-execute).
+ *
+ * @param command The slash command to check
+ * @returns true if the command should auto-execute on Enter
+ */
+export declare function isAutoExecutableCommand(command: SlashCommand | undefined | null): boolean;

package/dist/src/ui/utils/commandUtils.js

@@ -0,0 +1,189 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '@google/gemini-cli-core';
+import clipboardy from 'clipboardy';
+import fs from 'node:fs';
+/**
+ * Checks if a query string potentially represents an '@' command.
+ * It triggers if the query starts with '@' or contains '@' preceded by whitespace
+ * and followed by a non-whitespace character.
+ *
+ * @param query The input query string.
+ * @returns True if the query looks like an '@' command, false otherwise.
+ */
+export const isAtCommand = (query) => 
+// Check if starts with @ OR has a space, then @
+query.startsWith('@') || /\s@/.test(query);
+/**
+ * Checks if a query string potentially represents an '/' command.
+ * It triggers if the query starts with '/' but excludes code comments like '//' and '/*'.
+ *
+ * @param query The input query string.
+ * @returns True if the query looks like an '/' command, false otherwise.
+ */
+export const isSlashCommand = (query) => {
+    if (!query.startsWith('/')) {
+        return false;
+    }
+    // Exclude line comments that start with '//'
+    if (query.startsWith('//')) {
+        return false;
+    }
+    // Exclude block comments that start with '/*'
+    if (query.startsWith('/*')) {
+        return false;
+    }
+    return true;
+};
+const ESC = '\u001B';
+const BEL = '\u0007';
+const ST = '\u001B\\';
+const MAX_OSC52_SEQUENCE_BYTES = 100_000;
+const OSC52_HEADER = `${ESC}]52;c;`;
+const OSC52_FOOTER = BEL;
+const MAX_OSC52_BODY_B64_BYTES = MAX_OSC52_SEQUENCE_BYTES -
+    Buffer.byteLength(OSC52_HEADER) -
+    Buffer.byteLength(OSC52_FOOTER);
+const MAX_OSC52_DATA_BYTES = Math.floor(MAX_OSC52_BODY_B64_BYTES / 4) * 3;
+// Conservative chunk size for GNU screen DCS passthrough.
+const SCREEN_DCS_CHUNK_SIZE = 240;
+const pickTty = () => {
+    // Prefer the controlling TTY to avoid interleaving escape sequences with piped stdout.
+    try {
+        const devTty = fs.createWriteStream('/dev/tty');
+        return { stream: devTty, closeAfter: true };
+    }
+    catch {
+        // fall through
+    }
+    if (process.stderr?.isTTY)
+        return { stream: process.stderr, closeAfter: false };
+    if (process.stdout?.isTTY)
+        return { stream: process.stdout, closeAfter: false };
+    return null;
+};
+const inTmux = () => Boolean(process.env['TMUX'] || (process.env['TERM'] ?? '').startsWith('tmux'));
+const inScreen = () => Boolean(process.env['STY'] || (process.env['TERM'] ?? '').startsWith('screen'));
+const isSSH = () => Boolean(process.env['SSH_TTY'] ||
+    process.env['SSH_CONNECTION'] ||
+    process.env['SSH_CLIENT']);
+const isWSL = () => Boolean(process.env['WSL_DISTRO_NAME'] ||
+    process.env['WSLENV'] ||
+    process.env['WSL_INTEROP']);
+const isDumbTerm = () => (process.env['TERM'] ?? '') === 'dumb';
+const shouldUseOsc52 = (tty) => Boolean(tty) &&
+    !isDumbTerm() &&
+    (isSSH() || inTmux() || inScreen() || isWSL());
+const safeUtf8Truncate = (buf, maxBytes) => {
+    if (buf.length <= maxBytes)
+        return buf;
+    let end = maxBytes;
+    // Back up to the start of a UTF-8 code point if we cut through a continuation byte (10xxxxxx).
+    while (end > 0 && (buf[end - 1] & 0b1100_0000) === 0b1000_0000)
+        end--;
+    return buf.subarray(0, end);
+};
+const buildOsc52 = (text) => {
+    const raw = Buffer.from(text, 'utf8');
+    const safe = safeUtf8Truncate(raw, MAX_OSC52_DATA_BYTES);
+    const b64 = safe.toString('base64');
+    return `${OSC52_HEADER}${b64}${OSC52_FOOTER}`;
+};
+const wrapForTmux = (seq) => {
+    // Double ESC bytes in payload without a control-character regex.
+    const doubledEsc = seq.split(ESC).join(ESC + ESC);
+    return `${ESC}Ptmux;${doubledEsc}${ST}`;
+};
+const wrapForScreen = (seq) => {
+    let out = '';
+    for (let i = 0; i < seq.length; i += SCREEN_DCS_CHUNK_SIZE) {
+        out += `${ESC}P${seq.slice(i, i + SCREEN_DCS_CHUNK_SIZE)}${ST}`;
+    }
+    return out;
+};
+const writeAll = (stream, data) => new Promise((resolve, reject) => {
+    const onError = (err) => {
+        cleanup();
+        reject(err);
+    };
+    const onDrain = () => {
+        cleanup();
+        resolve();
+    };
+    const cleanup = () => {
+        stream.off('error', onError);
+        stream.off('drain', onDrain);
+        // Writable.write() handlers may not emit 'drain' if the first write succeeded.
+    };
+    stream.once('error', onError);
+    if (stream.write(data)) {
+        cleanup();
+        resolve();
+    }
+    else {
+        stream.once('drain', onDrain);
+    }
+});
+// Copies a string snippet to the clipboard with robust OSC-52 support.
+export const copyToClipboard = async (text) => {
+    if (!text)
+        return;
+    const tty = pickTty();
+    if (shouldUseOsc52(tty)) {
+        const osc = buildOsc52(text);
+        const payload = inTmux()
+            ? wrapForTmux(osc)
+            : inScreen()
+                ? wrapForScreen(osc)
+                : osc;
+        await writeAll(tty.stream, payload);
+        if (tty.closeAfter) {
+            tty.stream.end();
+        }
+        return;
+    }
+    // Local / non-TTY fallback
+    await clipboardy.write(text);
+};
+export const getUrlOpenCommand = () => {
+    // --- Determine the OS-specific command to open URLs ---
+    let openCmd;
+    switch (process.platform) {
+        case 'darwin':
+            openCmd = 'open';
+            break;
+        case 'win32':
+            openCmd = 'start';
+            break;
+        case 'linux':
+            openCmd = 'xdg-open';
+            break;
+        default:
+            // Default to xdg-open, which appears to be supported for the less popular operating systems.
+            openCmd = 'xdg-open';
+            debugLogger.warn(`Unknown platform: ${process.platform}. Attempting to open URLs with: ${openCmd}.`);
+            break;
+    }
+    return openCmd;
+};
+/**
+ * Determines if a slash command should auto-execute when selected.
+ *
+ * All built-in commands have autoExecute explicitly set to true or false.
+ * Custom commands (.toml files) and extension commands without this flag
+ * will default to false (safe default - won't auto-execute).
+ *
+ * @param command The slash command to check
+ * @returns true if the command should auto-execute on Enter
+ */
+export function isAutoExecutableCommand(command) {
+    if (!command) {
+        return false;
+    }
+    // Simply return the autoExecute flag value, defaulting to false if undefined
+    return command.autoExecute ?? false;
+}
+//# sourceMappingURL=commandUtils.js.map