@phuetz/code-buddy 0.1.0

package/dist/tools/base-tool.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Base Tool Abstract Class
+ *
+ * Provides a foundation for implementing tools with:
+ * - ITool interface implementation
+ * - Schema generation helpers
+ * - Input validation
+ * - Lifecycle management
+ */
+import type { ToolResult } from '../types/index.js';
+import type { ITool, IToolMetadata, ToolSchema, IValidationResult, ToolCategoryType } from './registry/types.js';
+import { Disposable } from '../utils/disposable.js';
+/**
+ * Parameter definition for building schemas
+ */
+export interface ParameterDefinition {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+    enum?: string[];
+    default?: unknown;
+    items?: ParameterDefinition;
+    properties?: Record<string, ParameterDefinition>;
+}
+/**
+ * Abstract base class for tools.
+ *
+ * Subclasses must implement:
+ * - `name`: Unique tool identifier
+ * - `description`: Human-readable description
+ * - `execute`: Main execution logic
+ *
+ * Optional overrides:
+ * - `getParameters`: Define parameter schema
+ * - `validate`: Custom input validation
+ * - `getMetadata`: Additional metadata
+ * - `isAvailable`: Check if tool can be used
+ * - `dispose`: Cleanup resources
+ */
+export declare abstract class BaseTool implements ITool, Disposable {
+    /**
+     * Unique tool name (must be valid identifier)
+     */
+    abstract readonly name: string;
+    /**
+     * Human-readable description
+     */
+    abstract readonly description: string;
+    /**
+     * Tool category for classification
+     */
+    protected category: ToolCategoryType;
+    /**
+     * Keywords for search/filtering
+     */
+    protected keywords: string[];
+    /**
+     * Priority for tool selection (higher = more likely)
+     */
+    protected priority: number;
+    /**
+     * Whether tool requires user confirmation
+     */
+    protected requiresConfirmation: boolean;
+    /**
+     * Whether tool modifies files
+     */
+    protected modifiesFiles: boolean;
+    /**
+     * Whether tool makes network requests
+     */
+    protected makesNetworkRequests: boolean;
+    constructor();
+    /**
+     * Execute the tool with given input.
+     *
+     * @param input - Tool parameters as key-value pairs
+     * @returns Promise resolving to ToolResult
+     */
+    abstract execute(input: Record<string, unknown>): Promise<ToolResult>;
+    /**
+     * Get parameter definitions for schema generation.
+     *
+     * Override this method to define tool parameters.
+     *
+     * @example
+     * ```typescript
+     * protected getParameters(): Record<string, ParameterDefinition> {
+     *   return {
+     *     path: {
+     *       type: 'string',
+     *       description: 'File path to read',
+     *       required: true,
+     *     },
+     *     encoding: {
+     *       type: 'string',
+     *       description: 'File encoding',
+     *       default: 'utf-8',
+     *     },
+     *   };
+     * }
+     * ```
+     */
+    protected getParameters(): Record<string, ParameterDefinition>;
+    /**
+     * Get the tool schema for LLM function calling.
+     */
+    getSchema(): ToolSchema;
+    /**
+     * Build a JSON schema property from parameter definition
+     */
+    private buildSchemaProperty;
+    /**
+     * Validate input before execution.
+     *
+     * Default implementation checks required parameters.
+     * Override for custom validation.
+     */
+    validate(input: unknown): IValidationResult;
+    /**
+     * Validate a value's type
+     */
+    private validateType;
+    /**
+     * Get tool metadata.
+     */
+    getMetadata(): IToolMetadata;
+    /**
+     * Check if tool is currently available.
+     *
+     * Override to add custom availability checks (e.g., required binaries).
+     */
+    isAvailable(): boolean;
+    /**
+     * Dispose of tool resources.
+     *
+     * Override to clean up resources (e.g., connections, file handles).
+     */
+    dispose(): void;
+    /**
+     * Create a success result
+     */
+    protected success(output: string, data?: unknown): ToolResult;
+    /**
+     * Create an error result
+     */
+    protected error(message: string, data?: unknown): ToolResult;
+    /**
+     * Wrap execution with error handling
+     */
+    protected safeExecute(fn: () => Promise<ToolResult>): Promise<ToolResult>;
+}
+/**
+ * Decorator to mark a tool as requiring confirmation
+ */
+export declare function RequiresConfirmation(): <T extends BaseTool>(target: new (...args: unknown[]) => T) => new (...args: unknown[]) => T;
+/**
+ * Decorator to set tool category
+ */
+export declare function ToolCategory(category: ToolCategoryType): <T extends BaseTool>(target: new (...args: unknown[]) => T) => new (...args: unknown[]) => T;
+/**
+ * Decorator to add keywords
+ */
+export declare function Keywords(...keywords: string[]): <T extends BaseTool>(target: new (...args: unknown[]) => T) => new (...args: unknown[]) => T;

package/dist/tools/base-tool.js

@@ -0,0 +1,295 @@
+/**
+ * Base Tool Abstract Class
+ *
+ * Provides a foundation for implementing tools with:
+ * - ITool interface implementation
+ * - Schema generation helpers
+ * - Input validation
+ * - Lifecycle management
+ */
+import { registerDisposable } from '../utils/disposable.js';
+// ============================================================================
+// Base Tool Abstract Class
+// ============================================================================
+/**
+ * Abstract base class for tools.
+ *
+ * Subclasses must implement:
+ * - `name`: Unique tool identifier
+ * - `description`: Human-readable description
+ * - `execute`: Main execution logic
+ *
+ * Optional overrides:
+ * - `getParameters`: Define parameter schema
+ * - `validate`: Custom input validation
+ * - `getMetadata`: Additional metadata
+ * - `isAvailable`: Check if tool can be used
+ * - `dispose`: Cleanup resources
+ */
+export class BaseTool {
+    /**
+     * Tool category for classification
+     */
+    category = 'utility';
+    /**
+     * Keywords for search/filtering
+     */
+    keywords = [];
+    /**
+     * Priority for tool selection (higher = more likely)
+     */
+    priority = 1;
+    /**
+     * Whether tool requires user confirmation
+     */
+    requiresConfirmation = false;
+    /**
+     * Whether tool modifies files
+     */
+    modifiesFiles = false;
+    /**
+     * Whether tool makes network requests
+     */
+    makesNetworkRequests = false;
+    constructor() {
+        registerDisposable(this);
+    }
+    // ============================================================================
+    // Schema Generation
+    // ============================================================================
+    /**
+     * Get parameter definitions for schema generation.
+     *
+     * Override this method to define tool parameters.
+     *
+     * @example
+     * ```typescript
+     * protected getParameters(): Record<string, ParameterDefinition> {
+     *   return {
+     *     path: {
+     *       type: 'string',
+     *       description: 'File path to read',
+     *       required: true,
+     *     },
+     *     encoding: {
+     *       type: 'string',
+     *       description: 'File encoding',
+     *       default: 'utf-8',
+     *     },
+     *   };
+     * }
+     * ```
+     */
+    getParameters() {
+        return {};
+    }
+    /**
+     * Get the tool schema for LLM function calling.
+     */
+    getSchema() {
+        const parameters = this.getParameters();
+        const properties = {};
+        const required = [];
+        for (const [name, def] of Object.entries(parameters)) {
+            properties[name] = this.buildSchemaProperty(def);
+            if (def.required) {
+                required.push(name);
+            }
+        }
+        const jsonSchema = {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+            additionalProperties: false,
+        };
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: jsonSchema,
+        };
+    }
+    /**
+     * Build a JSON schema property from parameter definition
+     */
+    buildSchemaProperty(def) {
+        const prop = {
+            type: def.type,
+            description: def.description,
+        };
+        if (def.enum) {
+            prop.enum = def.enum;
+        }
+        if (def.default !== undefined) {
+            prop.default = def.default;
+        }
+        if (def.type === 'array' && def.items) {
+            prop.items = this.buildSchemaProperty(def.items);
+        }
+        return prop;
+    }
+    // ============================================================================
+    // Validation
+    // ============================================================================
+    /**
+     * Validate input before execution.
+     *
+     * Default implementation checks required parameters.
+     * Override for custom validation.
+     */
+    validate(input) {
+        if (!input || typeof input !== 'object') {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const params = this.getParameters();
+        const errors = [];
+        const inputObj = input;
+        // Check required parameters
+        for (const [name, def] of Object.entries(params)) {
+            if (def.required && !(name in inputObj)) {
+                errors.push(`Missing required parameter: ${name}`);
+            }
+        }
+        // Check types
+        for (const [name, value] of Object.entries(inputObj)) {
+            const def = params[name];
+            if (def && !this.validateType(value, def.type)) {
+                errors.push(`Invalid type for ${name}: expected ${def.type}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /**
+     * Validate a value's type
+     */
+    validateType(value, expectedType) {
+        if (value === null || value === undefined) {
+            return true; // Will be caught by required check
+        }
+        switch (expectedType) {
+            case 'string':
+                return typeof value === 'string';
+            case 'number':
+                return typeof value === 'number';
+            case 'boolean':
+                return typeof value === 'boolean';
+            case 'array':
+                return Array.isArray(value);
+            case 'object':
+                return typeof value === 'object' && !Array.isArray(value);
+            default:
+                return true;
+        }
+    }
+    // ============================================================================
+    // Metadata
+    // ============================================================================
+    /**
+     * Get tool metadata.
+     */
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: this.category,
+            keywords: this.keywords,
+            priority: this.priority,
+            requiresConfirmation: this.requiresConfirmation,
+            modifiesFiles: this.modifiesFiles,
+            makesNetworkRequests: this.makesNetworkRequests,
+        };
+    }
+    // ============================================================================
+    // Lifecycle
+    // ============================================================================
+    /**
+     * Check if tool is currently available.
+     *
+     * Override to add custom availability checks (e.g., required binaries).
+     */
+    isAvailable() {
+        return true;
+    }
+    /**
+     * Dispose of tool resources.
+     *
+     * Override to clean up resources (e.g., connections, file handles).
+     */
+    dispose() {
+        // Default: no-op
+    }
+    // ============================================================================
+    // Helpers
+    // ============================================================================
+    /**
+     * Create a success result
+     */
+    success(output, data) {
+        return { success: true, output, data };
+    }
+    /**
+     * Create an error result
+     */
+    error(message, data) {
+        return { success: false, error: message, data };
+    }
+    /**
+     * Wrap execution with error handling
+     */
+    async safeExecute(fn) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.error(message);
+        }
+    }
+}
+// ============================================================================
+// Decorators (for future use)
+// ============================================================================
+/**
+ * Decorator to mark a tool as requiring confirmation
+ */
+export function RequiresConfirmation() {
+    return function (target) {
+        const _original = target.prototype.requiresConfirmation;
+        Object.defineProperty(target.prototype, 'requiresConfirmation', {
+            get() {
+                return true;
+            },
+        });
+        return target;
+    };
+}
+/**
+ * Decorator to set tool category
+ */
+export function ToolCategory(category) {
+    return function (target) {
+        Object.defineProperty(target.prototype, 'category', {
+            get() {
+                return category;
+            },
+        });
+        return target;
+    };
+}
+/**
+ * Decorator to add keywords
+ */
+export function Keywords(...keywords) {
+    return function (target) {
+        const existing = target.prototype.keywords || [];
+        Object.defineProperty(target.prototype, 'keywords', {
+            get() {
+                return [...existing, ...keywords];
+            },
+        });
+        return target;
+    };
+}
+//# sourceMappingURL=base-tool.js.map

package/dist/tools/base-tool.js.map

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,128 @@
+import { ToolResult } from '../types/index.js';
+import { SelfHealingEngine } from '../utils/self-healing.js';
+import { Disposable } from '../utils/disposable.js';
+/**
+ * Bash Tool
+ *
+ * Executes shell commands with comprehensive security measures:
+ * - Blocked dangerous patterns (rm -rf /, fork bombs, etc.)
+ * - Protected paths (~/.ssh, ~/.aws, /etc/shadow, etc.)
+ * - User confirmation for commands (unless session-approved)
+ * - Self-healing: automatic error recovery for common failures
+ * - Process isolation via spawn with process group management
+ * - Graceful termination with SIGTERM before SIGKILL
+ *
+ * Security modes are controlled by SandboxManager configuration.
+ * Self-healing can be disabled via --no-self-heal flag.
+ */
+export declare class BashTool implements Disposable {
+    private currentDirectory;
+    private confirmationService;
+    private sandboxManager;
+    private selfHealingEngine;
+    private selfHealingEnabled;
+    private runningProcesses;
+    constructor();
+    /**
+     * Clean up resources - kill any running processes
+     */
+    dispose(): void;
+    /**
+     * Validate command for dangerous patterns
+     *
+     * Security checks performed (in order):
+     * 1. Control characters - blocks terminal manipulation
+     * 2. ANSI escape sequences - blocks display manipulation
+     * 3. Shell bypass features - blocks process substitution, here-strings, etc.
+     * 4. Base command blocklist - blocks known dangerous commands
+     * 5. Blocked command patterns - blocks known dangerous patterns
+     * 6. Protected paths - blocks access to sensitive directories
+     * 7. Sandbox manager validation - additional runtime checks
+     */
+    private validateCommand;
+    /**
+     * Filter environment variables to only include safe ones
+     * This prevents credential leakage to child processes
+     *
+     * Security measures:
+     * - Only allowlisted variable names are passed through
+     * - Values containing shell metacharacters are sanitized
+     * - Values that look like secrets are excluded
+     */
+    private getFilteredEnv;
+    /**
+     * Execute a command with streaming output.
+     * Yields each line of stdout/stderr as it arrives.
+     * Validates and confirms the command before execution.
+     */
+    executeStreaming(command: string, timeout?: number): AsyncGenerator<string, ToolResult, undefined>;
+    /**
+     * Execute a command using spawn with process group isolation (safer than exec)
+     * Inspired by mistral-vibe's robust process handling
+     */
+    private executeWithSpawn;
+    /**
+     * Execute a shell command
+     *
+     * Validates command safety, requests user confirmation, and executes
+     * via spawn with process isolation. Failed commands trigger self-healing
+     * attempts if enabled.
+     *
+     * Special handling for `cd` commands to update working directory state.
+     *
+     * @param command - Shell command to execute
+     * @param timeout - Maximum execution time in ms (default: 30000)
+     * @returns Command output or error message; test output is parsed and structured
+     *
+     * @example
+     * // Simple command
+     * await bash.execute('ls -la');
+     *
+     * // With custom timeout (2 minutes)
+     * await bash.execute('npm install', 120000);
+     */
+    execute(command: string, timeout?: number): Promise<ToolResult>;
+    /**
+     * Enable or disable self-healing
+     */
+    setSelfHealing(enabled: boolean): void;
+    /**
+     * Check if self-healing is enabled
+     */
+    isSelfHealingEnabled(): boolean;
+    /**
+     * Get self-healing engine for configuration
+     */
+    getSelfHealingEngine(): SelfHealingEngine;
+    getCurrentDirectory(): string;
+    /**
+     * Escape shell argument to prevent command injection
+     */
+    private escapeShellArg;
+    /**
+     * List files in a directory (wrapper for `ls -la`)
+     *
+     * @param directory - Directory path to list (default: current directory)
+     * @returns Formatted directory listing or error
+     */
+    listFiles(directory?: string): Promise<ToolResult>;
+    /**
+     * Find files matching a pattern (wrapper for `find -name -type f`)
+     *
+     * @param pattern - Glob pattern to match (e.g., "*.ts", "package.json")
+     * @param directory - Directory to search in (default: current directory)
+     * @returns List of matching file paths or error
+     */
+    findFiles(pattern: string, directory?: string): Promise<ToolResult>;
+    /**
+     * Search for a pattern in files using ripgrep
+     *
+     * Uses @vscode/ripgrep for ultra-fast searching. Results are limited
+     * to 100 matches for performance.
+     *
+     * @param pattern - Regex pattern to search for
+     * @param files - File or directory to search in (default: current directory)
+     * @returns Matching lines with file paths and line numbers, or error
+     */
+    grep(pattern: string, files?: string): Promise<ToolResult>;
+}