@zgsm/costrict-cli 0.0.1

package/dist/src/services/prompt-processors/shellProcessor.js.map

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

package/dist/src/services/prompt-processors/shellProcessor.test.d.ts

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

package/dist/src/services/prompt-processors/shellProcessor.test.js

@@ -0,0 +1,482 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ConfirmationRequiredError, ShellProcessor } from './shellProcessor.js';
+import { createMockCommandContext } from '../../test-utils/mockCommandContext.js';
+import { ApprovalMode, getShellConfiguration } from '@google/gemini-cli-core';
+import { quote } from 'shell-quote';
+import { createPartFromText } from '@google/genai';
+// Helper function to determine the expected escaped string based on the current OS,
+// mirroring the logic in the actual `escapeShellArg` implementation.
+function getExpectedEscapedArgForPlatform(arg) {
+    const { shell } = getShellConfiguration();
+    switch (shell) {
+        case 'powershell':
+            return `'${arg.replace(/'/g, "''")}'`;
+        case 'cmd':
+            return `"${arg.replace(/"/g, '""')}"`;
+        case 'bash':
+        default:
+            return quote([arg]);
+    }
+}
+// Helper to create PromptPipelineContent
+function createPromptPipelineContent(text) {
+    return [createPartFromText(text)];
+}
+const mockCheckCommandPermissions = vi.hoisted(() => vi.fn());
+const mockShellExecute = vi.hoisted(() => vi.fn());
+vi.mock('@google/gemini-cli-core', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        checkCommandPermissions: mockCheckCommandPermissions,
+        ShellExecutionService: {
+            execute: mockShellExecute,
+        },
+    };
+});
+const SUCCESS_RESULT = {
+    output: 'default shell output',
+    exitCode: 0,
+    error: null,
+    aborted: false,
+    signal: null,
+};
+describe('ShellProcessor', () => {
+    let context;
+    let mockConfig;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockConfig = {
+            getTargetDir: vi.fn().mockReturnValue('/test/dir'),
+            getApprovalMode: vi.fn().mockReturnValue(ApprovalMode.DEFAULT),
+            getEnableInteractiveShell: vi.fn().mockReturnValue(false),
+            getShellExecutionConfig: vi.fn().mockReturnValue({}),
+        };
+        context = createMockCommandContext({
+            invocation: {
+                raw: '/cmd default args',
+                name: 'cmd',
+                args: 'default args',
+            },
+            services: {
+                config: mockConfig,
+            },
+            session: {
+                sessionShellAllowlist: new Set(),
+            },
+        });
+        mockShellExecute.mockReturnValue({
+            result: Promise.resolve(SUCCESS_RESULT),
+        });
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: true,
+            disallowedCommands: [],
+        });
+    });
+    it('should throw an error if config is missing', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('!{ls}');
+        const contextWithoutConfig = createMockCommandContext({
+            services: {
+                config: null,
+            },
+        });
+        await expect(processor.process(prompt, contextWithoutConfig)).rejects.toThrow(/Security configuration not loaded/);
+    });
+    it('should not change the prompt if no shell injections are present', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('This is a simple prompt with no injections.');
+        const result = await processor.process(prompt, context);
+        expect(result).toEqual(prompt);
+        expect(mockShellExecute).not.toHaveBeenCalled();
+    });
+    it('should process a single valid shell injection if allowed', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('The current status is: !{git status}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: true,
+            disallowedCommands: [],
+        });
+        mockShellExecute.mockReturnValue({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: 'On branch main' }),
+        });
+        const result = await processor.process(prompt, context);
+        expect(mockCheckCommandPermissions).toHaveBeenCalledWith('git status', expect.any(Object), context.session.sessionShellAllowlist);
+        expect(mockShellExecute).toHaveBeenCalledWith('git status', expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+        expect(result).toEqual([{ text: 'The current status is: On branch main' }]);
+    });
+    it('should process multiple valid shell injections if all are allowed', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('!{git status} in !{pwd}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: true,
+            disallowedCommands: [],
+        });
+        mockShellExecute
+            .mockReturnValueOnce({
+            result: Promise.resolve({
+                ...SUCCESS_RESULT,
+                output: 'On branch main',
+            }),
+        })
+            .mockReturnValueOnce({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: '/usr/home' }),
+        });
+        const result = await processor.process(prompt, context);
+        expect(mockCheckCommandPermissions).toHaveBeenCalledTimes(2);
+        expect(mockShellExecute).toHaveBeenCalledTimes(2);
+        expect(result).toEqual([{ text: 'On branch main in /usr/home' }]);
+    });
+    it('should throw ConfirmationRequiredError if a command is not allowed in default mode', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Do something dangerous: !{rm -rf /}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: false,
+            disallowedCommands: ['rm -rf /'],
+        });
+        await expect(processor.process(prompt, context)).rejects.toThrow(ConfirmationRequiredError);
+    });
+    it('should NOT throw ConfirmationRequiredError if a command is not allowed but approval mode is YOLO', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Do something dangerous: !{rm -rf /}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: false,
+            disallowedCommands: ['rm -rf /'],
+        });
+        // Override the approval mode for this test
+        mockConfig.getApprovalMode.mockReturnValue(ApprovalMode.YOLO);
+        mockShellExecute.mockReturnValue({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: 'deleted' }),
+        });
+        const result = await processor.process(prompt, context);
+        // It should proceed with execution
+        expect(mockShellExecute).toHaveBeenCalledWith('rm -rf /', expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+        expect(result).toEqual([{ text: 'Do something dangerous: deleted' }]);
+    });
+    it('should still throw an error for a hard-denied command even in YOLO mode', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Do something forbidden: !{reboot}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: false,
+            disallowedCommands: ['reboot'],
+            isHardDenial: true, // This is the key difference
+            blockReason: 'System commands are blocked',
+        });
+        // Set approval mode to YOLO
+        mockConfig.getApprovalMode.mockReturnValue(ApprovalMode.YOLO);
+        await expect(processor.process(prompt, context)).rejects.toThrow(/Blocked command: "reboot". Reason: System commands are blocked/);
+        // Ensure it never tried to execute
+        expect(mockShellExecute).not.toHaveBeenCalled();
+    });
+    it('should throw ConfirmationRequiredError with the correct command', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Do something dangerous: !{rm -rf /}');
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: false,
+            disallowedCommands: ['rm -rf /'],
+        });
+        try {
+            await processor.process(prompt, context);
+            // Fail if it doesn't throw
+            expect(true).toBe(false);
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ConfirmationRequiredError);
+            if (e instanceof ConfirmationRequiredError) {
+                expect(e.commandsToConfirm).toEqual(['rm -rf /']);
+            }
+        }
+        expect(mockShellExecute).not.toHaveBeenCalled();
+    });
+    it('should throw ConfirmationRequiredError with multiple commands if multiple are disallowed', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('!{cmd1} and !{cmd2}');
+        mockCheckCommandPermissions.mockImplementation((cmd) => {
+            if (cmd === 'cmd1') {
+                return { allAllowed: false, disallowedCommands: ['cmd1'] };
+            }
+            if (cmd === 'cmd2') {
+                return { allAllowed: false, disallowedCommands: ['cmd2'] };
+            }
+            return { allAllowed: true, disallowedCommands: [] };
+        });
+        try {
+            await processor.process(prompt, context);
+            // Fail if it doesn't throw
+            expect(true).toBe(false);
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ConfirmationRequiredError);
+            if (e instanceof ConfirmationRequiredError) {
+                expect(e.commandsToConfirm).toEqual(['cmd1', 'cmd2']);
+            }
+        }
+    });
+    it('should not execute any commands if at least one requires confirmation', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('First: !{echo "hello"}, Second: !{rm -rf /}');
+        mockCheckCommandPermissions.mockImplementation((cmd) => {
+            if (cmd.includes('rm')) {
+                return { allAllowed: false, disallowedCommands: [cmd] };
+            }
+            return { allAllowed: true, disallowedCommands: [] };
+        });
+        await expect(processor.process(prompt, context)).rejects.toThrow(ConfirmationRequiredError);
+        // Ensure no commands were executed because the pipeline was halted.
+        expect(mockShellExecute).not.toHaveBeenCalled();
+    });
+    it('should only request confirmation for disallowed commands in a mixed prompt', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Allowed: !{ls -l}, Disallowed: !{rm -rf /}');
+        mockCheckCommandPermissions.mockImplementation((cmd) => ({
+            allAllowed: !cmd.includes('rm'),
+            disallowedCommands: cmd.includes('rm') ? [cmd] : [],
+        }));
+        try {
+            await processor.process(prompt, context);
+            expect.fail('Should have thrown ConfirmationRequiredError');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ConfirmationRequiredError);
+            if (e instanceof ConfirmationRequiredError) {
+                expect(e.commandsToConfirm).toEqual(['rm -rf /']);
+            }
+        }
+    });
+    it('should execute all commands if they are on the session allowlist', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Run !{cmd1} and !{cmd2}');
+        // Add commands to the session allowlist
+        context.session.sessionShellAllowlist = new Set(['cmd1', 'cmd2']);
+        // checkCommandPermissions should now pass for these
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: true,
+            disallowedCommands: [],
+        });
+        mockShellExecute
+            .mockReturnValueOnce({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: 'output1' }),
+        })
+            .mockReturnValueOnce({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: 'output2' }),
+        });
+        const result = await processor.process(prompt, context);
+        expect(mockCheckCommandPermissions).toHaveBeenCalledWith('cmd1', expect.any(Object), context.session.sessionShellAllowlist);
+        expect(mockCheckCommandPermissions).toHaveBeenCalledWith('cmd2', expect.any(Object), context.session.sessionShellAllowlist);
+        expect(mockShellExecute).toHaveBeenCalledTimes(2);
+        expect(result).toEqual([{ text: 'Run output1 and output2' }]);
+    });
+    it('should trim whitespace from the command inside the injection before interpolation', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('Files: !{  ls {{args}} -l  }');
+        const rawArgs = context.invocation.args;
+        const expectedEscapedArgs = getExpectedEscapedArgForPlatform(rawArgs);
+        const expectedCommand = `ls ${expectedEscapedArgs} -l`;
+        mockCheckCommandPermissions.mockReturnValue({
+            allAllowed: true,
+            disallowedCommands: [],
+        });
+        mockShellExecute.mockReturnValue({
+            result: Promise.resolve({ ...SUCCESS_RESULT, output: 'total 0' }),
+        });
+        await processor.process(prompt, context);
+        expect(mockCheckCommandPermissions).toHaveBeenCalledWith(expectedCommand, expect.any(Object), context.session.sessionShellAllowlist);
+        expect(mockShellExecute).toHaveBeenCalledWith(expectedCommand, expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+    });
+    it('should handle an empty command inside the injection gracefully (skips execution)', async () => {
+        const processor = new ShellProcessor('test-command');
+        const prompt = createPromptPipelineContent('This is weird: !{}');
+        const result = await processor.process(prompt, context);
+        expect(mockCheckCommandPermissions).not.toHaveBeenCalled();
+        expect(mockShellExecute).not.toHaveBeenCalled();
+        // It replaces !{} with an empty string.
+        expect(result).toEqual([{ text: 'This is weird: ' }]);
+    });
+    describe('Error Reporting', () => {
+        it('should append exit code and command name on failure', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{cmd}');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({
+                    ...SUCCESS_RESULT,
+                    output: 'some error output',
+                    stderr: '',
+                    exitCode: 1,
+                }),
+            });
+            const result = await processor.process(prompt, context);
+            expect(result).toEqual([
+                {
+                    text: "some error output\n[Shell command 'cmd' exited with code 1]",
+                },
+            ]);
+        });
+        it('should append signal info and command name if terminated by signal', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{cmd}');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({
+                    ...SUCCESS_RESULT,
+                    output: 'output',
+                    stderr: '',
+                    exitCode: null,
+                    signal: 'SIGTERM',
+                }),
+            });
+            const result = await processor.process(prompt, context);
+            expect(result).toEqual([
+                {
+                    text: "output\n[Shell command 'cmd' terminated by signal SIGTERM]",
+                },
+            ]);
+        });
+        it('should throw a detailed error if the shell fails to spawn', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{bad-command}');
+            const spawnError = new Error('spawn EACCES');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({
+                    ...SUCCESS_RESULT,
+                    stdout: '',
+                    stderr: '',
+                    exitCode: null,
+                    error: spawnError,
+                    aborted: false,
+                }),
+            });
+            await expect(processor.process(prompt, context)).rejects.toThrow("Failed to start shell command in 'test-command': spawn EACCES. Command: bad-command");
+        });
+        it('should report abort status with command name if aborted', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{long-running-command}');
+            const spawnError = new Error('Aborted');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({
+                    ...SUCCESS_RESULT,
+                    output: 'partial output',
+                    stderr: '',
+                    exitCode: null,
+                    error: spawnError,
+                    aborted: true, // Key difference
+                }),
+            });
+            const result = await processor.process(prompt, context);
+            expect(result).toEqual([
+                {
+                    text: "partial output\n[Shell command 'long-running-command' aborted]",
+                },
+            ]);
+        });
+    });
+    describe('Context-Aware Argument Interpolation ({{args}})', () => {
+        const rawArgs = 'user input';
+        beforeEach(() => {
+            // Update context for these tests to use specific arguments
+            context.invocation.args = rawArgs;
+        });
+        it('should perform raw replacement if no shell injections are present (optimization path)', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('The user said: {{args}}');
+            const result = await processor.process(prompt, context);
+            expect(result).toEqual([{ text: `The user said: ${rawArgs}` }]);
+            expect(mockShellExecute).not.toHaveBeenCalled();
+        });
+        it('should perform raw replacement outside !{} blocks', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('Outside: {{args}}. Inside: !{echo "hello"}');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({ ...SUCCESS_RESULT, output: 'hello' }),
+            });
+            const result = await processor.process(prompt, context);
+            expect(result).toEqual([{ text: `Outside: ${rawArgs}. Inside: hello` }]);
+        });
+        it('should perform escaped replacement inside !{} blocks', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('Command: !{grep {{args}} file.txt}');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({ ...SUCCESS_RESULT, output: 'match found' }),
+            });
+            const result = await processor.process(prompt, context);
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(rawArgs);
+            const expectedCommand = `grep ${expectedEscapedArgs} file.txt`;
+            expect(mockShellExecute).toHaveBeenCalledWith(expectedCommand, expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+            expect(result).toEqual([{ text: 'Command: match found' }]);
+        });
+        it('should handle both raw (outside) and escaped (inside) injection simultaneously', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('User "({{args}})" requested search: !{search {{args}}}');
+            mockShellExecute.mockReturnValue({
+                result: Promise.resolve({ ...SUCCESS_RESULT, output: 'results' }),
+            });
+            const result = await processor.process(prompt, context);
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(rawArgs);
+            const expectedCommand = `search ${expectedEscapedArgs}`;
+            expect(mockShellExecute).toHaveBeenCalledWith(expectedCommand, expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+            expect(result).toEqual([
+                { text: `User "(${rawArgs})" requested search: results` },
+            ]);
+        });
+        it('should perform security checks on the final, resolved (escaped) command', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{rm {{args}}}');
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(rawArgs);
+            const expectedResolvedCommand = `rm ${expectedEscapedArgs}`;
+            mockCheckCommandPermissions.mockReturnValue({
+                allAllowed: false,
+                disallowedCommands: [expectedResolvedCommand],
+                isHardDenial: false,
+            });
+            await expect(processor.process(prompt, context)).rejects.toThrow(ConfirmationRequiredError);
+            expect(mockCheckCommandPermissions).toHaveBeenCalledWith(expectedResolvedCommand, expect.any(Object), context.session.sessionShellAllowlist);
+        });
+        it('should report the resolved command if a hard denial occurs', async () => {
+            const processor = new ShellProcessor('test-command');
+            const prompt = createPromptPipelineContent('!{rm {{args}}}');
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(rawArgs);
+            const expectedResolvedCommand = `rm ${expectedEscapedArgs}`;
+            mockCheckCommandPermissions.mockReturnValue({
+                allAllowed: false,
+                disallowedCommands: [expectedResolvedCommand],
+                isHardDenial: true,
+                blockReason: 'It is forbidden.',
+            });
+            await expect(processor.process(prompt, context)).rejects.toThrow(`Blocked command: "${expectedResolvedCommand}". Reason: It is forbidden.`);
+        });
+    });
+    describe('Real-World Escaping Scenarios', () => {
+        it('should correctly handle multiline arguments', async () => {
+            const processor = new ShellProcessor('test-command');
+            const multilineArgs = 'first line\nsecond line';
+            context.invocation.args = multilineArgs;
+            const prompt = createPromptPipelineContent('Commit message: !{git commit -m {{args}}}');
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(multilineArgs);
+            const expectedCommand = `git commit -m ${expectedEscapedArgs}`;
+            await processor.process(prompt, context);
+            expect(mockShellExecute).toHaveBeenCalledWith(expectedCommand, expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+        });
+        it.each([
+            { name: 'spaces', input: 'file with spaces.txt' },
+            { name: 'double quotes', input: 'a "quoted" string' },
+            { name: 'single quotes', input: "it's a string" },
+            { name: 'command substitution (backticks)', input: '`reboot`' },
+            { name: 'command substitution (dollar)', input: '$(reboot)' },
+            { name: 'variable expansion', input: '$HOME' },
+            { name: 'command chaining (semicolon)', input: 'a; reboot' },
+            { name: 'command chaining (ampersand)', input: 'a && reboot' },
+        ])('should safely escape args containing $name', async ({ input }) => {
+            const processor = new ShellProcessor('test-command');
+            context.invocation.args = input;
+            const prompt = createPromptPipelineContent('!{echo {{args}}}');
+            const expectedEscapedArgs = getExpectedEscapedArgForPlatform(input);
+            const expectedCommand = `echo ${expectedEscapedArgs}`;
+            await processor.process(prompt, context);
+            expect(mockShellExecute).toHaveBeenCalledWith(expectedCommand, expect.any(String), expect.any(Function), expect.any(Object), false, expect.any(Object));
+        });
+    });
+});
+//# sourceMappingURL=shellProcessor.test.js.map

package/dist/src/services/prompt-processors/shellProcessor.test.js.map

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

package/dist/src/services/prompt-processors/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandContext } from '../../ui/commands/types.js';
+import type { PartUnion } from '@google/genai';
+/**
+ * Defines the input/output type for prompt processors.
+ */
+export type PromptPipelineContent = PartUnion[];
+/**
+ * Defines the interface for a prompt processor, a module that can transform
+ * a prompt string before it is sent to the model. Processors are chained
+ * together to create a processing pipeline.
+ */
+export interface IPromptProcessor {
+    /**
+     * Processes a prompt input (which may contain text and multi-modal parts),
+     * applying a specific transformation as part of a pipeline.
+     *
+     * @param prompt The current state of the prompt string. This may have been
+     *   modified by previous processors in the pipeline.
+     * @param context The full command context, providing access to invocation
+     *   details (like `context.invocation.raw` and `context.invocation.args`),
+     *   application services, and UI handlers.
+     * @returns A promise that resolves to the transformed prompt string, which
+     *   will be passed to the next processor or, if it's the last one, sent to the model.
+     */
+    process(prompt: PromptPipelineContent, context: CommandContext): Promise<PromptPipelineContent>;
+}
+/**
+ * The placeholder string for shorthand argument injection in custom commands.
+ * When used outside of !{...}, arguments are injected raw.
+ * When used inside !{...}, arguments are shell-escaped.
+ */
+export declare const SHORTHAND_ARGS_PLACEHOLDER = "{{args}}";
+/**
+ * The trigger string for shell command injection in custom commands.
+ */
+export declare const SHELL_INJECTION_TRIGGER = "!{";
+/**
+ * The trigger string for at file injection in custom commands.
+ */
+export declare const AT_FILE_INJECTION_TRIGGER = "@{";

package/dist/src/services/prompt-processors/types.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * The placeholder string for shorthand argument injection in custom commands.
+ * When used outside of !{...}, arguments are injected raw.
+ * When used inside !{...}, arguments are shell-escaped.
+ */
+export const SHORTHAND_ARGS_PLACEHOLDER = '{{args}}';
+/**
+ * The trigger string for shell command injection in custom commands.
+ */
+export const SHELL_INJECTION_TRIGGER = '!{';
+/**
+ * The trigger string for at file injection in custom commands.
+ */
+export const AT_FILE_INJECTION_TRIGGER = '@{';
+//# sourceMappingURL=types.js.map

package/dist/src/services/prompt-processors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/prompt-processors/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC"}

package/dist/src/services/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SlashCommand } from '../ui/commands/types.js';
+/**
+ * Defines the contract for any class that can load and provide slash commands.
+ * This allows the CommandService to be extended with new command sources
+ * (e.g., file-based, remote APIs) without modification.
+ *
+ * Loaders should receive any necessary dependencies (like Config) via their
+ * constructor.
+ */
+export interface ICommandLoader {
+    /**
+     * Discovers and returns a list of slash commands from the loader's source.
+     * @param signal An AbortSignal to allow cancellation.
+     * @returns A promise that resolves to an array of SlashCommand objects.
+     */
+    loadCommands(signal: AbortSignal): Promise<SlashCommand[]>;
+}

package/dist/src/services/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/services/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}