fss-link 1.2.6 → 1.2.7

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

@@ -1,162 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ApprovalMode, checkCommandPermissions, escapeShellArg, getShellConfiguration, ShellExecutionService, } from 'fss-link-core';
-import { SHELL_INJECTION_TRIGGER, SHORTHAND_ARGS_PLACEHOLDER, } from './types.js';
-export class ConfirmationRequiredError extends Error {
-    commandsToConfirm;
-    constructor(message, commandsToConfirm) {
-        super(message);
-        this.commandsToConfirm = commandsToConfirm;
-        this.name = 'ConfirmationRequiredError';
-    }
-}
-/**
- * Handles prompt interpolation, including shell command execution (`!{...}`)
- * and context-aware argument injection (`{{args}}`).
- *
- * This processor ensures that:
- * 1. `{{args}}` outside `!{...}` are replaced with raw input.
- * 2. `{{args}}` inside `!{...}` are replaced with shell-escaped input.
- * 3. Shell commands are executed securely after argument substitution.
- * 4. Parsing correctly handles nested braces.
- */
-export class ShellProcessor {
-    commandName;
-    constructor(commandName) {
-        this.commandName = commandName;
-    }
-    async process(prompt, context) {
-        const userArgsRaw = context.invocation?.args || '';
-        if (!prompt.includes(SHELL_INJECTION_TRIGGER)) {
-            return prompt.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
-        }
-        const config = context.services.config;
-        if (!config) {
-            throw new Error(`Security configuration not loaded. Cannot verify shell command permissions for '${this.commandName}'. Aborting.`);
-        }
-        const { sessionShellAllowlist } = context.session;
-        const injections = this.extractInjections(prompt);
-        // If extractInjections found no closed blocks (and didn't throw), treat as raw.
-        if (injections.length === 0) {
-            return prompt.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
-        }
-        const { shell } = getShellConfiguration();
-        const userArgsEscaped = escapeShellArg(userArgsRaw, shell);
-        const resolvedInjections = injections.map((injection) => {
-            if (injection.command === '') {
-                return injection;
-            }
-            // Replace {{args}} inside the command string with the escaped version.
-            const resolvedCommand = injection.command.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsEscaped);
-            return { ...injection, resolvedCommand };
-        });
-        const commandsToConfirm = new Set();
-        for (const injection of resolvedInjections) {
-            const command = injection.resolvedCommand;
-            if (!command)
-                continue;
-            // Security check on the final, escaped command string.
-            const { allAllowed, disallowedCommands, blockReason, isHardDenial } = checkCommandPermissions(command, config, sessionShellAllowlist);
-            if (!allAllowed) {
-                if (isHardDenial) {
-                    throw new Error(`${this.commandName} cannot be run. Blocked command: "${command}". Reason: ${blockReason || 'Blocked by configuration.'}`);
-                }
-                // If not a hard denial, respect YOLO mode and auto-approve.
-                if (config.getApprovalMode() !== ApprovalMode.YOLO) {
-                    disallowedCommands.forEach((uc) => commandsToConfirm.add(uc));
-                }
-            }
-        }
-        // Handle confirmation requirements.
-        if (commandsToConfirm.size > 0) {
-            throw new ConfirmationRequiredError('Shell command confirmation required', Array.from(commandsToConfirm));
-        }
-        let processedPrompt = '';
-        let lastIndex = 0;
-        for (const injection of resolvedInjections) {
-            // Append the text segment BEFORE the injection, substituting {{args}} with RAW input.
-            const segment = prompt.substring(lastIndex, injection.startIndex);
-            processedPrompt += segment.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
-            // Execute the resolved command (which already has ESCAPED input).
-            if (injection.resolvedCommand) {
-                const { result } = await ShellExecutionService.execute(injection.resolvedCommand, config.getTargetDir(), () => { }, new AbortController().signal, config.getShouldUseNodePtyShell());
-                const executionResult = await result;
-                // Handle Spawn Errors
-                if (executionResult.error && !executionResult.aborted) {
-                    throw new Error(`Failed to start shell command in '${this.commandName}': ${executionResult.error.message}. Command: ${injection.resolvedCommand}`);
-                }
-                // Append the output, making stderr explicit for the model.
-                processedPrompt += executionResult.output;
-                // Append a status message if the command did not succeed.
-                if (executionResult.aborted) {
-                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' aborted]`;
-                }
-                else if (executionResult.exitCode !== 0 &&
-                    executionResult.exitCode !== null) {
-                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' exited with code ${executionResult.exitCode}]`;
-                }
-                else if (executionResult.signal !== null) {
-                    processedPrompt += `\n[Shell command '${injection.resolvedCommand}' terminated by signal ${executionResult.signal}]`;
-                }
-            }
-            lastIndex = injection.endIndex;
-        }
-        // Append the remaining text AFTER the last injection, substituting {{args}} with RAW input.
-        const finalSegment = prompt.substring(lastIndex);
-        processedPrompt += finalSegment.replaceAll(SHORTHAND_ARGS_PLACEHOLDER, userArgsRaw);
-        return processedPrompt;
-    }
-    /**
-     * Iteratively parses the prompt string to extract shell injections (!{...}),
-     * correctly handling nested braces within the command.
-     *
-     * @param prompt The prompt string to parse.
-     * @returns An array of extracted ShellInjection objects.
-     * @throws Error if an unclosed injection (`!{`) is found.
-     */
-    extractInjections(prompt) {
-        const injections = [];
-        let index = 0;
-        while (index < prompt.length) {
-            const startIndex = prompt.indexOf(SHELL_INJECTION_TRIGGER, index);
-            if (startIndex === -1) {
-                break;
-            }
-            let currentIndex = startIndex + SHELL_INJECTION_TRIGGER.length;
-            let braceCount = 1;
-            let foundEnd = false;
-            while (currentIndex < prompt.length) {
-                const char = prompt[currentIndex];
-                // We count literal braces. This parser does not interpret shell quoting/escaping.
-                if (char === '{') {
-                    braceCount++;
-                }
-                else if (char === '}') {
-                    braceCount--;
-                    if (braceCount === 0) {
-                        const commandContent = prompt.substring(startIndex + SHELL_INJECTION_TRIGGER.length, currentIndex);
-                        const endIndex = currentIndex + 1;
-                        injections.push({
-                            command: commandContent.trim(),
-                            startIndex,
-                            endIndex,
-                        });
-                        index = endIndex;
-                        foundEnd = true;
-                        break;
-                    }
-                }
-                currentIndex++;
-            }
-            // Check if the inner loop finished without finding the closing brace.
-            if (!foundEnd) {
-                throw new Error(`Invalid syntax in command '${this.commandName}': Unclosed shell injection starting at index ${startIndex} ('!{'). Ensure braces are balanced.`);
-            }
-        }
-        return injections;
-    }
-}
-//# sourceMappingURL=shellProcessor.js.map

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

@@ -1 +0,0 @@
-{"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/types.d.ts

@@ -1,40 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CommandContext } from '../../ui/commands/types.js';
-/**
- * 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 string, applying a specific transformation as part of a pipeline.
-     *
-     * Each processor in a command's pipeline receives the output of the previous
-     * processor. This method provides the full command context, allowing for
-     * complex transformations that may require access to invocation details,
-     * application services, or UI state.
-     *
-     * @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: string, context: CommandContext): Promise<string>;
-}
-/**
- * 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 = "!{";

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

@@ -1,16 +0,0 @@
-/**
- * @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 = '!{';
-//# sourceMappingURL=types.js.map

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

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

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

@@ -1,22 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { 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

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

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

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

package/dist/src/test-utils/customMatchers.d.ts

@@ -1,14 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-declare module 'vitest' {
-    interface Assertion<T> {
-        toHaveOnlyValidCharacters(): T;
-    }
-    interface AsymmetricMatchersContaining {
-        toHaveOnlyValidCharacters(): void;
-    }
-}
-export {};

package/dist/src/test-utils/customMatchers.js

@@ -1,46 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/// <reference types="vitest/globals" />
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { expect } from 'vitest';
-// RegExp to detect invalid characters: backspace, and ANSI escape codes
-// eslint-disable-next-line no-control-regex
-const invalidCharsRegex = /[\b\x1b]/;
-function toHaveOnlyValidCharacters(buffer) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const { isNot } = this;
-    let pass = true;
-    const invalidLines = [];
-    for (let i = 0; i < buffer.lines.length; i++) {
-        const line = buffer.lines[i];
-        if (line.includes('\n')) {
-            pass = false;
-            invalidLines.push({ line: i, content: line });
-            break; // Fail fast on newlines
-        }
-        if (invalidCharsRegex.test(line)) {
-            pass = false;
-            invalidLines.push({ line: i, content: line });
-        }
-    }
-    return {
-        pass,
-        message: () => `Expected buffer ${isNot ? 'not ' : ''}to have only valid characters, but found invalid characters in lines:\n${invalidLines
-            .map((l) => `  [${l.line}]: "${l.content}"`) /* This line was changed */
-            .join('\n')}`,
-        actual: buffer.lines,
-        expected: 'Lines with no line breaks, backspaces, or escape codes.',
-    };
-}
-expect.extend({
-    toHaveOnlyValidCharacters,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-});
-//# sourceMappingURL=customMatchers.js.map

package/dist/src/test-utils/customMatchers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"customMatchers.js","sourceRoot":"","sources":["../../../src/test-utils/customMatchers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AAExC;;;;GAIG;AAEH,OAAO,EAAa,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG3C,wEAAwE;AACxE,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAErC,SAAS,yBAAyB,CAAkB,MAAkB;IACpE,8DAA8D;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAW,CAAC;IAC9B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,MAAM,YAAY,GAA6C,EAAE,CAAC;IAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,GAAG,KAAK,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,wBAAwB;QACjC,CAAC;QACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,GAAG,KAAK,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,GAAG,EAAE,CACZ,mBAAmB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0EAA0E,YAAY;aACzH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,2BAA2B;aACvE,IAAI,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,QAAQ,EAAE,yDAAyD;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,CAAC;IACZ,yBAAyB;IACzB,8DAA8D;CACxD,CAAC,CAAC"}

package/dist/src/test-utils/mockCommandContext.d.ts

@@ -1,18 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CommandContext } from '../ui/commands/types.js';
-type DeepPartial<T> = T extends object ? {
-    [P in keyof T]?: DeepPartial<T[P]>;
-} : T;
-/**
- * Creates a deep, fully-typed mock of the CommandContext for use in tests.
- * All functions are pre-mocked with `vi.fn()`.
- *
- * @param overrides - A deep partial object to override any default mock values.
- * @returns A complete, mocked CommandContext object.
- */
-export declare const createMockCommandContext: (overrides?: DeepPartial<CommandContext>) => CommandContext;
-export {};

package/dist/src/test-utils/mockCommandContext.js

@@ -1,87 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { vi } from 'vitest';
-/**
- * Creates a deep, fully-typed mock of the CommandContext for use in tests.
- * All functions are pre-mocked with `vi.fn()`.
- *
- * @param overrides - A deep partial object to override any default mock values.
- * @returns A complete, mocked CommandContext object.
- */
-export const createMockCommandContext = (overrides = {}) => {
-    const defaultMocks = {
-        invocation: {
-            raw: '',
-            name: '',
-            args: '',
-        },
-        services: {
-            config: null,
-            settings: { merged: {} },
-            git: undefined,
-            logger: {
-                log: vi.fn(),
-                logMessage: vi.fn(),
-                saveCheckpoint: vi.fn(),
-                loadCheckpoint: vi.fn().mockResolvedValue([]),
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            }, // Cast because Logger is a class.
-        },
-        ui: {
-            addItem: vi.fn(),
-            clear: vi.fn(),
-            setDebugMessage: vi.fn(),
-            pendingItem: null,
-            setPendingItem: vi.fn(),
-            loadHistory: vi.fn(),
-            toggleCorgiMode: vi.fn(),
-            toggleVimEnabled: vi.fn(),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        },
-        session: {
-            sessionShellAllowlist: new Set(),
-            stats: {
-                sessionStartTime: new Date(),
-                lastPromptTokenCount: 0,
-                metrics: {
-                    models: {},
-                    tools: {
-                        totalCalls: 0,
-                        totalSuccess: 0,
-                        totalFail: 0,
-                        totalDurationMs: 0,
-                        totalDecisions: { accept: 0, reject: 0, modify: 0 },
-                        byName: {},
-                    },
-                },
-                promptCount: 0,
-            },
-        },
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const merge = (target, source) => {
-        const output = { ...target };
-        for (const key in source) {
-            if (Object.prototype.hasOwnProperty.call(source, key)) {
-                const sourceValue = source[key];
-                const targetValue = output[key];
-                if (
-                // We only want to recursivlty merge plain objects
-                Object.prototype.toString.call(sourceValue) === '[object Object]' &&
-                    Object.prototype.toString.call(targetValue) === '[object Object]') {
-                    output[key] = merge(targetValue, sourceValue);
-                }
-                else {
-                    // If not, we do a direct assignment. This preserves Date objects and others.
-                    output[key] = sourceValue;
-                }
-            }
-        }
-        return output;
-    };
-    return merge(defaultMocks, overrides);
-};
-//# sourceMappingURL=mockCommandContext.js.map

package/dist/src/test-utils/mockCommandContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mockCommandContext.js","sourceRoot":"","sources":["../../../src/test-utils/mockCommandContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAa5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,YAAyC,EAAE,EAC3B,EAAE;IAClB,MAAM,YAAY,GAAmB;QACnC,UAAU,EAAE;YACV,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,EAAE;SACT;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAoB;YAC1C,GAAG,EAAE,SAAmC;YACxC,MAAM,EAAE;gBACN,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;gBACnB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;gBACvB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC7C,8DAA8D;aACxD,EAAE,kCAAkC;SAC7C;QACD,EAAE,EAAE;YACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;YAChB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;YACd,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;YACxB,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;YACvB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;YACpB,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;YACxB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;YACzB,8DAA8D;SACxD;QACR,OAAO,EAAE;YACP,qBAAqB,EAAE,IAAI,GAAG,EAAU;YACxC,KAAK,EAAE;gBACL,gBAAgB,EAAE,IAAI,IAAI,EAAE;gBAC5B,oBAAoB,EAAE,CAAC;gBACvB,OAAO,EAAE;oBACP,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE;wBACL,UAAU,EAAE,CAAC;wBACb,YAAY,EAAE,CAAC;wBACf,SAAS,EAAE,CAAC;wBACZ,eAAe,EAAE,CAAC;wBAClB,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;wBACnD,MAAM,EAAE,EAAE;qBACX;iBACF;gBACD,WAAW,EAAE,CAAC;aACM;SACvB;KACF,CAAC;IAEF,8DAA8D;IAC9D,MAAM,KAAK,GAAG,CAAC,MAAW,EAAE,MAAW,EAAO,EAAE;QAC9C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEhC;gBACE,kDAAkD;gBAClD,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,iBAAiB;oBACjE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,iBAAiB,EACjE,CAAC;oBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;gBAChD,CAAC;qBAAM,CAAC;oBACN,6EAA6E;oBAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC,CAAC"}

package/dist/src/test-utils/mockCommandContext.test.d.ts

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

package/dist/src/test-utils/mockCommandContext.test.js

@@ -1,51 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { vi, describe, it, expect } from 'vitest';
-import { createMockCommandContext } from './mockCommandContext.js';
-describe('createMockCommandContext', () => {
-    it('should return a valid CommandContext object with default mocks', () => {
-        const context = createMockCommandContext();
-        // Just a few spot checks to ensure the structure is correct
-        // and functions are mocks.
-        expect(context).toBeDefined();
-        expect(context.ui.addItem).toBeInstanceOf(Function);
-        expect(vi.isMockFunction(context.ui.addItem)).toBe(true);
-    });
-    it('should apply top-level overrides correctly', () => {
-        const mockClear = vi.fn();
-        const overrides = {
-            ui: {
-                clear: mockClear,
-            },
-        };
-        const context = createMockCommandContext(overrides);
-        // Call the function to see if the override was used
-        context.ui.clear();
-        // Assert that our specific mock was called, not the default
-        expect(mockClear).toHaveBeenCalled();
-        // And that other defaults are still in place
-        expect(vi.isMockFunction(context.ui.addItem)).toBe(true);
-    });
-    it('should apply deeply nested overrides correctly', () => {
-        // This is the most important test for factory's logic.
-        const mockConfig = {
-            getProjectRoot: () => '/test/project',
-            getModel: () => 'gemini-pro',
-        };
-        const overrides = {
-            services: {
-                config: mockConfig,
-            },
-        };
-        const context = createMockCommandContext(overrides);
-        expect(context.services.config).toBeDefined();
-        expect(context.services.config?.getModel()).toBe('gemini-pro');
-        expect(context.services.config?.getProjectRoot()).toBe('/test/project');
-        // Verify a default property on the same nested object is still there
-        expect(context.services.logger).toBeDefined();
-    });
-});
-//# sourceMappingURL=mockCommandContext.test.js.map

package/dist/src/test-utils/mockCommandContext.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mockCommandContext.test.js","sourceRoot":"","sources":["../../../src/test-utils/mockCommandContext.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;QAE3C,4DAA4D;QAC5D,2BAA2B;QAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG;YAChB,EAAE,EAAE;gBACF,KAAK,EAAE,SAAS;aACjB;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEpD,oDAAoD;QACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAEnB,4DAA4D;QAC5D,MAAM,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACrC,6CAA6C;QAC7C,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,uDAAuD;QACvD,MAAM,UAAU,GAAG;YACjB,cAAc,EAAE,GAAG,EAAE,CAAC,eAAe;YACrC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;SAC7B,CAAC;QAEF,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE;gBACR,MAAM,EAAE,UAAU;aACnB;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/D,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAExE,qEAAqE;QACrE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/test-utils/render.d.ts

@@ -1,8 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { render } from 'ink-testing-library';
-import React from 'react';
-export declare const renderWithProviders: (component: React.ReactElement) => ReturnType<typeof render>;

package/dist/src/test-utils/render.js

@@ -1,10 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { render } from 'ink-testing-library';
-import { KeypressProvider } from '../ui/contexts/KeypressContext.js';
-export const renderWithProviders = (component) => render(_jsx(KeypressProvider, { kittyProtocolEnabled: true, children: component }));
-//# sourceMappingURL=render.js.map

package/dist/src/test-utils/render.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/test-utils/render.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,SAA6B,EACF,EAAE,CAC7B,MAAM,CACJ,KAAC,gBAAgB,IAAC,oBAAoB,EAAE,IAAI,YACzC,SAAS,GACO,CACpB,CAAC"}

package/dist/src/ui/App.d.ts

@@ -1,15 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { LoadedSettings } from '../config/settings.js';
-import { type Config } from 'fss-link-core';
-interface AppProps {
-    config: Config;
-    settings: LoadedSettings;
-    startupWarnings?: string[];
-    version: string;
-}
-export declare const AppWrapper: (props: AppProps) => import("react/jsx-runtime").JSX.Element;
-export {};