@gaunt-sloth/tools 0.0.1

package/dist/tools/GthCustomToolkit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module GthCustomToolkit
+ * Toolkit for user-defined custom shell commands.
+ * Provides secure execution of shell commands with parameter validation.
+ */
+import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import { CustomToolsConfig, CustomCommandParameter, ValidationCheck } from '@gaunt-sloth/core/config.js';
+export default class GthCustomToolkit extends BaseToolkit {
+    tools: StructuredToolInterface[];
+    private customTools;
+    constructor(customTools?: CustomToolsConfig);
+    /**
+     * Validate parameter value to prevent security issues.
+     * Checks can be selectively skipped via the `allow` list.
+     */
+    validateParameterValue(paramValue: string, paramName: string, allow?: ValidationCheck[]): string;
+    /**
+     * Build a custom command with parameter interpolation
+     */
+    buildCustomCommand(commandTemplate: string, parameters: Record<string, string>, parameterConfig?: Record<string, CustomCommandParameter>): string;
+    /**
+     * Prompt the user to confirm execution of a command that failed validation.
+     * Returns true if the user confirms, false otherwise.
+     */
+    promptUserForValidationOverride(command: string, toolName: string, validationError: string): Promise<boolean>;
+    private executeCommand;
+    /**
+     * Create a Zod schema for a custom command's parameters
+     */
+    private createCustomCommandSchema;
+    /**
+     * Build command without validation (for display in the user prompt).
+     * Simply interpolates parameters into the template without security checks.
+     */
+    private buildCommandForDisplay;
+    /**
+     * Create a tool for a custom command
+     */
+    private createCustomCommandTool;
+    private createTools;
+}

package/dist/tools/GthCustomToolkit.js

@@ -0,0 +1,280 @@
+/**
+ * @module GthCustomToolkit
+ * Toolkit for user-defined custom shell commands.
+ * Provides secure execution of shell commands with parameter validation.
+ */
+import { BaseToolkit, tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { spawn } from 'child_process';
+import path from 'node:path';
+import { displayInfo, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { createInterface, stdin, stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
+// Helper function to create a tool with execute type
+function createCustomTool(fn, config) {
+    const toolInstance = tool(fn, config);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    toolInstance.gthCustomType = 'execute';
+    return toolInstance;
+}
+export default class GthCustomToolkit extends BaseToolkit {
+    tools;
+    customTools;
+    constructor(customTools = {}) {
+        super();
+        this.customTools = customTools;
+        this.tools = this.createTools();
+    }
+    /**
+     * Validate parameter value to prevent security issues.
+     * Checks can be selectively skipped via the `allow` list.
+     */
+    validateParameterValue(paramValue, paramName, allow = []) {
+        const allowSet = new Set(allow);
+        // Check for absolute paths
+        if (!allowSet.has('absolute-paths') && path.isAbsolute(paramValue)) {
+            throw new Error(`Absolute paths are not allowed for parameter '${paramName}'`);
+        }
+        // Check for directory traversal attempts
+        if (!allowSet.has('directory-traversal') &&
+            (paramValue.includes('..') || paramValue.includes('\\..\\') || paramValue.includes('/../'))) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        // Check for pipe attempts and other shell injection
+        if (!allowSet.has('shell-injection') &&
+            (paramValue.includes('|') ||
+                paramValue.includes('&') ||
+                paramValue.includes(';') ||
+                paramValue.includes('`') ||
+                paramValue.includes("'") ||
+                paramValue.includes('$') ||
+                paramValue.includes('$(') ||
+                paramValue.includes('\n') ||
+                paramValue.includes('\r'))) {
+            throw new Error(`Shell injection attempts are not allowed in parameter '${paramName}'.` +
+                'Disallowed symbols pipe, ampersand, semicolon, backtick, single quote, dollar sign, command substitution, newline, carriage return');
+        }
+        // Check for null bytes
+        if (!allowSet.has('null-bytes') && paramValue.includes('\0')) {
+            throw new Error(`Null bytes are not allowed in parameter '${paramName}'`);
+        }
+        // Normalize the path to remove any redundant separators
+        // Skip normalization when absolute paths are allowed, since normalize
+        // would strip the leading separator context on some values
+        if (allowSet.has('absolute-paths')) {
+            // Still do the post-normalization traversal check when traversal is not allowed
+            if (!allowSet.has('directory-traversal')) {
+                const normalizedValue = path.normalize(paramValue);
+                if (normalizedValue.includes('..')) {
+                    throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+                }
+            }
+            return paramValue;
+        }
+        const normalizedValue = path.normalize(paramValue);
+        // Double-check after normalization
+        if (!allowSet.has('directory-traversal') && normalizedValue.includes('..')) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        return normalizedValue;
+    }
+    /**
+     * Build a custom command with parameter interpolation
+     */
+    buildCustomCommand(commandTemplate, parameters, parameterConfig) {
+        let command = commandTemplate;
+        const paramNames = Object.keys(parameters);
+        // Check if all provided parameters have placeholders or should be appended
+        const hasPlaceholders = paramNames.some((name) => command.includes(`\${${name}}`));
+        if (hasPlaceholders) {
+            // Replace all placeholders with validated parameter values
+            for (const [name, value] of Object.entries(parameters)) {
+                const allow = parameterConfig?.[name]?.allow || [];
+                const validatedValue = this.validateParameterValue(value, name, allow);
+                const placeholder = '${' + name + '}';
+                command = command.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), validatedValue);
+            }
+        }
+        else if (paramNames.length > 0 && parameterConfig) {
+            // Append parameters in the order defined in the config
+            const orderedParams = Object.keys(parameterConfig);
+            const appendValues = [];
+            for (const name of orderedParams) {
+                if (parameters[name] !== undefined) {
+                    const allow = parameterConfig[name]?.allow || [];
+                    const validatedValue = this.validateParameterValue(parameters[name], name, allow);
+                    appendValues.push(validatedValue);
+                }
+            }
+            if (appendValues.length > 0) {
+                command = `${command} ${appendValues.join(' ')}`;
+            }
+        }
+        return command;
+    }
+    /**
+     * Prompt the user to confirm execution of a command that failed validation.
+     * Returns true if the user confirms, false otherwise.
+     */
+    async promptUserForValidationOverride(command, toolName, validationError) {
+        displayWarning(`\n⚠️  Validation failed for tool '${toolName}': ${validationError}`);
+        displayWarning(`The agent is trying to execute: ${command}`);
+        displayWarning('You can add "allow" to this tool\'s configuration in .gsloth.config.json to skip this check (permanent). ' +
+            'Available values: "absolute-paths", "directory-traversal", "shell-injection", "null-bytes"');
+        // Write prompt manually to avoid double-echo when readline echoes input
+        stdout.write('Do you want to allow this execution (one-time)? (y/N): ');
+        const rl = createInterface({ input: stdin });
+        try {
+            const answer = await rl.question('');
+            return answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes';
+        }
+        finally {
+            rl.close();
+        }
+    }
+    async executeCommand(command, toolName, timeoutSeconds) {
+        displayInfo(`\n🔧 Executing ${toolName}: ${command}`);
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, {
+                shell: true,
+            });
+            let output = '';
+            let timedOut = false;
+            let timer;
+            if (timeoutSeconds !== undefined && timeoutSeconds > 0) {
+                timer = setTimeout(() => {
+                    timedOut = true;
+                    child.kill();
+                }, timeoutSeconds * 1000);
+            }
+            // Capture output if available (when stdio is not 'inherit')
+            if (child.stdout) {
+                child.stdout.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            child.on('close', (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                if (timedOut) {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' timed out after ${timeoutSeconds} seconds`);
+                }
+                else if (code === 0) {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' completed successfully`);
+                }
+                else {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' exited with code ${code}`);
+                }
+            });
+            child.on('error', (error) => {
+                if (timer)
+                    clearTimeout(timer);
+                const errorMsg = `Failed to execute command '${command}': ${error.message}`;
+                displayError(errorMsg);
+                reject(new Error(errorMsg));
+            });
+        });
+    }
+    /**
+     * Create a Zod schema for a custom command's parameters
+     */
+    createCustomCommandSchema(config
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        if (!config.parameters || Object.keys(config.parameters).length === 0) {
+            return z.object({});
+        }
+        const shape = {};
+        for (const [paramName, paramConfig] of Object.entries(config.parameters)) {
+            shape[paramName] = z.string().describe(paramConfig.description);
+        }
+        return z.object(shape);
+    }
+    /**
+     * Build command without validation (for display in the user prompt).
+     * Simply interpolates parameters into the template without security checks.
+     */
+    buildCommandForDisplay(commandTemplate, parameters, parameterConfig) {
+        let command = commandTemplate;
+        const paramNames = Object.keys(parameters);
+        const hasPlaceholders = paramNames.some((name) => command.includes(`\${${name}}`));
+        if (hasPlaceholders) {
+            for (const [name, value] of Object.entries(parameters)) {
+                const placeholder = '${' + name + '}';
+                command = command.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), value);
+            }
+        }
+        else if (paramNames.length > 0 && parameterConfig) {
+            const orderedParams = Object.keys(parameterConfig);
+            const appendValues = [];
+            for (const name of orderedParams) {
+                if (parameters[name] !== undefined) {
+                    appendValues.push(parameters[name]);
+                }
+            }
+            if (appendValues.length > 0) {
+                command = `${command} ${appendValues.join(' ')}`;
+            }
+        }
+        return command;
+    }
+    /**
+     * Create a tool for a custom command
+     */
+    createCustomCommandTool(name, config) {
+        const schema = this.createCustomCommandSchema(config);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const toolFn = async (args) => {
+            // All parameters are strings, safe to cast
+            const stringArgs = args;
+            try {
+                const command = this.buildCustomCommand(config.command, stringArgs, config.parameters);
+                return await this.executeCommand(command, name, config.timeout);
+            }
+            catch (validationError) {
+                // If validation fails, prompt the user for confirmation
+                const errorMessage = validationError instanceof Error ? validationError.message : String(validationError);
+                const displayCommand = this.buildCommandForDisplay(config.command, stringArgs, config.parameters);
+                const userConfirmed = await this.promptUserForValidationOverride(displayCommand, name, errorMessage);
+                if (userConfirmed) {
+                    return await this.executeCommand(displayCommand, name);
+                }
+                throw new Error(`Execution of '${name}' was rejected by user. Validation error: ${errorMessage}`);
+            }
+        };
+        return createCustomTool(toolFn, {
+            name,
+            description: config.description + `\nThe configured command is [${config.command}].`,
+            schema,
+        });
+    }
+    createTools() {
+        const tools = [];
+        // Create tools for custom commands
+        for (const [name, config] of Object.entries(this.customTools)) {
+            tools.push(this.createCustomCommandTool(name, config));
+        }
+        return tools;
+    }
+}
+//# sourceMappingURL=GthCustomToolkit.js.map

package/dist/tools/GthCustomToolkit.js.map

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

package/dist/tools/GthDevToolkit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module GthDevToolkit
+ */
+import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import { GthDevToolsConfig } from '@gaunt-sloth/core/config.js';
+export default class GthDevToolkit extends BaseToolkit {
+    tools: StructuredToolInterface[];
+    private commands;
+    constructor(commands?: GthDevToolsConfig);
+    /**
+     * Get tools filtered by operation type
+     */
+    getFilteredTools(allowedOperations: 'execute'[]): StructuredToolInterface[];
+    /**
+     * Validate parameter value to prevent security issues
+     */
+    validateParameterValue(paramValue: string, paramName: string): string;
+    /**
+     * Build the command for running a single test file
+     */
+    private buildSingleTestCommand;
+    private executeCommand;
+    private createTools;
+}

package/dist/tools/GthDevToolkit.js

@@ -0,0 +1,189 @@
+/**
+ * @module GthDevToolkit
+ */
+import { BaseToolkit, tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { spawn } from 'child_process';
+import path from 'node:path';
+import { displayInfo, displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
+// Helper function to create a tool with dev type
+function createGthTool(fn, config, gthDevType) {
+    const toolInstance = tool(fn, config);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    toolInstance.gthDevType = gthDevType;
+    return toolInstance;
+}
+// Schema definitions for built-in tools
+const RunTestsArgsSchema = z.object({});
+const RunLintArgsSchema = z.object({});
+const RunBuildArgsSchema = z.object({});
+const RunSingleTestArgsSchema = z.object({
+    testPath: z.string().describe('Relative path to the test file to run'),
+});
+const TEST_PATH_PLACEHOLDER = '${testPath}';
+export default class GthDevToolkit extends BaseToolkit {
+    tools;
+    commands;
+    constructor(commands = {}) {
+        super();
+        this.commands = commands;
+        this.tools = this.createTools();
+    }
+    /**
+     * Get tools filtered by operation type
+     */
+    getFilteredTools(allowedOperations) {
+        return this.tools.filter((tool) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const toolType = tool.gthDevType;
+            return allowedOperations.includes(toolType);
+        });
+    }
+    /**
+     * Validate parameter value to prevent security issues
+     */
+    validateParameterValue(paramValue, paramName) {
+        // Check for absolute paths
+        if (path.isAbsolute(paramValue)) {
+            throw new Error(`Absolute paths are not allowed for parameter '${paramName}'`);
+        }
+        // Check for directory traversal attempts
+        if (paramValue.includes('..') || paramValue.includes('\\..\\') || paramValue.includes('/../')) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        // Check for pipe attempts and other shell injection
+        if (paramValue.includes('|') ||
+            paramValue.includes('&') ||
+            paramValue.includes(';') ||
+            paramValue.includes('`') ||
+            paramValue.includes('$') ||
+            paramValue.includes('$(') ||
+            paramValue.includes('\n') ||
+            paramValue.includes('\r')) {
+            throw new Error(`Shell injection attempts are not allowed in parameter '${paramName}'`);
+        }
+        // Check for null bytes
+        if (paramValue.includes('\0')) {
+            throw new Error(`Null bytes are not allowed in parameter '${paramName}'`);
+        }
+        // Normalize the path to remove any redundant separators
+        const normalizedValue = path.normalize(paramValue);
+        // Double-check after normalization
+        if (normalizedValue.includes('..')) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        return normalizedValue;
+    }
+    /**
+     * Build the command for running a single test file
+     */
+    buildSingleTestCommand(testPath) {
+        if (this.commands.run_single_test) {
+            if (this.commands.run_single_test.includes(TEST_PATH_PLACEHOLDER)) {
+                // Interpolate if placeholder is available
+                return this.commands.run_single_test.replace(TEST_PATH_PLACEHOLDER, testPath);
+            }
+            else {
+                // Concatenate if no placeholder
+                return `${this.commands.run_single_test} ${testPath}`;
+            }
+        }
+        else {
+            throw new Error('No test command configured');
+        }
+    }
+    async executeCommand(command, toolName) {
+        displayInfo(`\n🔧 Executing ${toolName}: ${command}`);
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, {
+                shell: true,
+            });
+            let output = '';
+            // Capture output if available (when stdio is not 'inherit')
+            if (child.stdout) {
+                child.stdout.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            child.on('close', (code) => {
+                if (code === 0) {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' completed successfully`);
+                }
+                else {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' exited with code ${code}`);
+                }
+            });
+            child.on('error', (error) => {
+                const errorMsg = `Failed to execute command '${command}': ${error.message}`;
+                displayError(errorMsg);
+                reject(new Error(errorMsg));
+            });
+        });
+    }
+    createTools() {
+        const tools = [];
+        if (this.commands.run_tests) {
+            tools.push(createGthTool(async (_args) => {
+                return await this.executeCommand(this.commands.run_tests, 'run_tests');
+            }, {
+                name: 'run_tests',
+                description: 'Execute the test suite for this project. Runs the configured test command and returns the output.' +
+                    `\nThe configured command is [${this.commands.run_tests}].`,
+                schema: RunTestsArgsSchema,
+            }, 'execute'));
+        }
+        if (this.commands.run_single_test) {
+            tools.push(createGthTool(async (args) => {
+                const validatedPath = this.validateParameterValue(args.testPath, 'testPath');
+                const command = this.buildSingleTestCommand(validatedPath);
+                return await this.executeCommand(command, 'run_single_test');
+            }, {
+                name: 'run_single_test',
+                description: 'Execute a single test file. Runs the configured test command with the specified test file path. ' +
+                    'The test path must be relative and cannot contain directory traversal attempts or shell injection. ' +
+                    `\nThe base command is [${this.commands.run_single_test}].`,
+                schema: RunSingleTestArgsSchema,
+            }, 'execute'));
+        }
+        if (this.commands.run_lint) {
+            tools.push(createGthTool(async (_args) => {
+                return await this.executeCommand(this.commands.run_lint, 'run_lint');
+            }, {
+                name: 'run_lint',
+                description: 'Run the linter on the project code. Executes the configured lint command and returns any linting errors or warnings.' +
+                    `\nThe configured command is [${this.commands.run_lint}].`,
+                schema: RunLintArgsSchema,
+            }, 'execute'));
+        }
+        if (this.commands.run_build) {
+            tools.push(createGthTool(async (_args) => {
+                return await this.executeCommand(this.commands.run_build, 'run_build');
+            }, {
+                name: 'run_build',
+                description: 'Build the project. Executes the configured build command and returns the build output.' +
+                    `\nThe configured command is [${this.commands.run_build}].`,
+                schema: RunBuildArgsSchema,
+            }, 'execute'));
+        }
+        return tools;
+    }
+}
+//# sourceMappingURL=GthDevToolkit.js.map

package/dist/tools/GthDevToolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GthDevToolkit.js","sourceRoot":"","sources":["../../src/tools/GthDevToolkit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAA2B,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAEpF,OAAO,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;AAEhE,iDAAiD;AACjD,SAAS,aAAa,CACpB,EAAyC,EACzC,MAIC,EACD,UAAqB;IAErB,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,8DAA8D;IAC7D,YAAoB,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9C,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,wCAAwC;AACxC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACvC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,KAAK,CAA4B;IACzB,QAAQ,CAAoB;IAEpC,YAAY,WAA8B,EAAE;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,iBAA8B;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,8DAA8D;YAC9D,MAAM,QAAQ,GAAI,IAAY,CAAC,UAAU,CAAC;YAC1C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,UAAkB,EAAE,SAAiB;QAC1D,2BAA2B;QAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,SAAS,GAAG,CAAC,CAAC;QACjF,CAAC;QAED,yCAAyC;QACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,8DAA8D,SAAS,GAAG,CAAC,CAAC;QAC9F,CAAC;QAED,oDAAoD;QACpD,IACE,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EACzB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,SAAS,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,4CAA4C,SAAS,GAAG,CAAC,CAAC;QAC5E,CAAC;QAED,wDAAwD;QACxD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAEnD,mCAAmC;QACnC,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,8DAA8D,SAAS,GAAG,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,QAAgB;QAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAClE,0CAA0C;gBAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,QAAQ,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,QAAgB;QAC5D,WAAW,CAAC,kBAAkB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QAEtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;gBAC3B,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,4DAA4D;YAC5D,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,IAAI,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,IAAI,KAAK,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC;YAED,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CACL,cAAc,OAAO,UAAU;wBAC7B,oBAAoB;wBACpB,MAAM;wBACN,qBAAqB;wBACrB,gBAAgB,OAAO,0BAA0B,CACpD,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,CACL,cAAc,OAAO,UAAU;wBAC7B,oBAAoB;wBACpB,MAAM;wBACN,qBAAqB;wBACrB,gBAAgB,OAAO,sBAAsB,IAAI,EAAE,CACtD,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,MAAM,QAAQ,GAAG,8BAA8B,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC5E,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW;QACjB,MAAM,KAAK,GAA8B,EAAE,CAAC;QAE5C,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CACR,aAAa,CACX,KAAK,EAAE,KAAyC,EAAmB,EAAE;gBACnE,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAU,EAAE,WAAW,CAAC,CAAC;YAC1E,CAAC,EACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EACT,mGAAmG;oBACnG,gCAAgC,IAAI,CAAC,QAAQ,CAAC,SAAU,IAAI;gBAC9D,MAAM,EAAE,kBAAkB;aAC3B,EACD,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CACR,aAAa,CACX,KAAK,EAAE,IAA6C,EAAmB,EAAE;gBACvE,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;gBAC3D,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAC/D,CAAC,EACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,kGAAkG;oBAClG,qGAAqG;oBACrG,0BAA0B,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI;gBAC7D,MAAM,EAAE,uBAAuB;aAChC,EACD,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,aAAa,CACX,KAAK,EAAE,KAAwC,EAAmB,EAAE;gBAClE,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAS,EAAE,UAAU,CAAC,CAAC;YACxE,CAAC,EACD;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EACT,sHAAsH;oBACtH,gCAAgC,IAAI,CAAC,QAAQ,CAAC,QAAS,IAAI;gBAC7D,MAAM,EAAE,iBAAiB;aAC1B,EACD,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CACR,aAAa,CACX,KAAK,EAAE,KAAyC,EAAmB,EAAE;gBACnE,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAU,EAAE,WAAW,CAAC,CAAC;YAC1E,CAAC,EACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EACT,wFAAwF;oBACxF,gCAAgC,IAAI,CAAC,QAAQ,CAAC,SAAU,IAAI;gBAC9D,MAAM,EAAE,kBAAkB;aAC3B,EACD,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/tools/GthFileSystemToolkit.d.ts

@@ -0,0 +1,36 @@
+import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import type { BinaryFormatConfig } from '@gaunt-sloth/core/config.js';
+export interface GthFileSystemToolkitOptions {
+    allowedDirectories?: string[];
+    aiignoreConfig?: {
+        enabled?: boolean;
+        patterns?: string[];
+    };
+    binaryFormats?: false | BinaryFormatConfig[];
+}
+export default class GthFileSystemToolkit extends BaseToolkit {
+    tools: StructuredToolInterface[];
+    private allowedDirectories;
+    private aiignoreConfig?;
+    private binaryFormats?;
+    constructor(options?: GthFileSystemToolkitOptions);
+    /**
+     * Get tools filtered by operation type
+     */
+    getFilteredTools(allowedOperations: ('read' | 'write')[]): StructuredToolInterface[];
+    private normalizePath;
+    private isProtectedDirectory;
+    private expandHome;
+    private sanitizeRequestedPath;
+    private validatePath;
+    private getFileStats;
+    private searchFiles;
+    private normalizeLineEndings;
+    private createUnifiedDiff;
+    private applyFileEdits;
+    private formatSize;
+    private tailFile;
+    private headFile;
+    private createReadBinaryTool;
+    private createTools;
+}