codehere 0.1.1

package/dist/tools/edit.js

@@ -0,0 +1,235 @@
+/**
+ * Edit Tool
+ * String replacement-based file editing (like Claude Code)
+ * Requires exact matches for safety
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+// Undo stack (simple in-memory, could be persisted later)
+const undoStack = new Map();
+/**
+ * View file content
+ */
+export function viewFile(filepath, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    if (!existsSync(absPath)) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'view',
+            error: `File not found: ${absPath}`,
+        };
+    }
+    try {
+        const content = readFileSync(absPath, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'view',
+            content,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'view',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Create a new file
+ */
+export function createFile(filepath, content, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    // Check if file exists
+    if (existsSync(absPath) && !options.createIfNotExists) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'create',
+            error: `File already exists: ${absPath}`,
+        };
+    }
+    try {
+        // Ensure directory exists
+        const dir = dirname(absPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Save to undo stack
+        if (existsSync(absPath)) {
+            const oldContent = readFileSync(absPath, 'utf-8');
+            if (!undoStack.has(absPath)) {
+                undoStack.set(absPath, []);
+            }
+            undoStack.get(absPath).push(oldContent);
+        }
+        // Write file
+        writeFileSync(absPath, content, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'create',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'create',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * String replacement (exact match required)
+ * CRITICAL: Must match exactly, or error if multiple matches
+ */
+export function strReplace(filepath, oldString, newString, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    if (!existsSync(absPath)) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'str_replace',
+            error: `File not found: ${absPath}`,
+        };
+    }
+    try {
+        // Read file
+        const content = readFileSync(absPath, 'utf-8');
+        // Save to undo stack
+        if (!undoStack.has(absPath)) {
+            undoStack.set(absPath, []);
+        }
+        undoStack.get(absPath).push(content);
+        // Count matches
+        const matches = content.split(oldString).length - 1;
+        if (matches === 0) {
+            return {
+                success: false,
+                filepath: absPath,
+                operation: 'str_replace',
+                error: `String not found in file. Exact match required.`,
+            };
+        }
+        if (matches > 1) {
+            return {
+                success: false,
+                filepath: absPath,
+                operation: 'str_replace',
+                error: `Multiple matches found (${matches}). Provide more context to make the match unique.`,
+            };
+        }
+        // Perform replacement
+        const newContent = content.replace(oldString, newString);
+        // Write file
+        writeFileSync(absPath, newContent, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'str_replace',
+            replacements: 1,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'str_replace',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Undo last edit
+ */
+export function undoEdit(filepath, options = {}) {
+    const absPath = resolve(options.cwd || process.cwd(), filepath);
+    const stack = undoStack.get(absPath);
+    if (!stack || stack.length === 0) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'undo',
+            error: 'No undo history available',
+        };
+    }
+    try {
+        const previousContent = stack.pop();
+        writeFileSync(absPath, previousContent, 'utf-8');
+        return {
+            success: true,
+            filepath: absPath,
+            operation: 'undo',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            filepath: absPath,
+            operation: 'undo',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Tool description for the model
+ * This is critical - the model needs to understand how to use this tool
+ */
+export const EDIT_TOOL_DESCRIPTION = `
+Edit Tool - String replacement-based file editing
+
+DESCRIPTION:
+Edit files using string replacement. Requires exact matches for safety.
+
+AVAILABLE OPERATIONS:
+1. **view(filepath)**: View file content
+2. **create(filepath, content)**: Create new file
+3. **str_replace(filepath, oldString, newString)**: Replace string in file
+4. **undo(filepath)**: Undo last edit
+
+CRITICAL RULES:
+1. **Exact Match Required**: oldString must match EXACTLY in the file
+2. **Unique Match Required**: If multiple matches found, provide more context
+3. **Absolute Paths**: All paths are resolved to absolute paths automatically
+4. **Context for Uniqueness**: Include surrounding lines if needed to make match unique
+
+STRING REPLACEMENT:
+- oldString must appear EXACTLY ONCE in the file
+- If 0 matches: Error - string not found
+- If 2+ matches: Error - provide more context
+- Include surrounding code/whitespace to ensure uniqueness
+
+EXAMPLES:
+- str_replace('/path/to/file.ts', 'function old()', 'function new()')
+- str_replace('/path/to/file.ts', 'const x = 1;\\n', 'const x = 2;\\n')
+- Include context: str_replace('/path/to/file.ts', '  // Comment\\n  function old()', '  // Comment\\n  function new()')
+
+PATH HANDLING:
+- All paths are resolved to absolute paths
+- Use absolute paths or paths relative to cwd
+- Example: '/Users/username/project/file.ts' (absolute)
+- Example: './file.ts' (relative to cwd)
+
+UNDO:
+- undo() restores file to previous state
+- Only one level of undo (last edit)
+- Undo stack is in-memory (lost on restart)
+
+ERROR HANDLING:
+- Check success field in result
+- Check error field for error message
+- Common errors:
+  - File not found
+  - String not found (0 matches)
+  - Multiple matches (need more context)
+
+SECURITY:
+- All paths are validated
+- No file system traversal beyond project directory
+- Exact match requirement prevents accidental replacements
+`;
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool Executor
+ * Execute tools with error handling and result formatting
+ */
+import type { ToolCall } from './parser.js';
+export interface ToolExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Tool name */
+    tool: string;
+    /** Execution result */
+    result?: any;
+    /** Error message if failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    duration?: number;
+}
+export declare class ToolExecutor {
+    /**
+     * Execute a single tool call
+     */
+    execute(call: ToolCall): Promise<ToolExecutionResult>;
+    /**
+     * Execute multiple tool calls in sequence
+     * Stops on first error
+     */
+    executeAll(calls: ToolCall[]): Promise<ToolExecutionResult[]>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwG3D;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAcpE"}

package/dist/tools/executor.js

@@ -0,0 +1,153 @@
+/**
+ * Tool Executor
+ * Execute tools with error handling and result formatting
+ */
+import { getToolRegistry } from './registry.js';
+export class ToolExecutor {
+    /**
+     * Execute a single tool call
+     */
+    async execute(call) {
+        const startTime = Date.now();
+        const registry = getToolRegistry();
+        const tool = registry.get(call.tool);
+        // Import execution tracer dynamically to avoid circular dependencies
+        const { executionTracer } = await import('../infrastructure/observability/execution-tracer.js');
+        // Trace tool invocation
+        const traceId = executionTracer.trace({
+            operationType: 'tool_invocation',
+            operationName: call.tool,
+            input: { parameters: call.parameters },
+            metadata: {
+                toolId: call.id,
+            },
+        });
+        if (!tool) {
+            const duration = Date.now() - startTime;
+            executionTracer.trace({
+                operationType: 'tool_invocation',
+                operationName: call.tool,
+                error: new Error(`Tool not found: ${call.tool}`),
+                duration,
+                metadata: { toolId: call.id },
+            });
+            return {
+                success: false,
+                tool: call.tool,
+                error: `Tool not found: ${call.tool}`,
+                duration,
+            };
+        }
+        try {
+            // Validate parameters
+            const validation = validateParameters(call.parameters, tool.parameters);
+            if (!validation.valid) {
+                const duration = Date.now() - startTime;
+                const error = new Error(`Invalid parameters: ${validation.errors.join(', ')}`);
+                executionTracer.trace({
+                    operationType: 'tool_invocation',
+                    operationName: call.tool,
+                    error,
+                    duration,
+                    metadata: { toolId: call.id },
+                });
+                return {
+                    success: false,
+                    tool: call.tool,
+                    error: error.message,
+                    duration,
+                };
+            }
+            // Execute tool
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = await tool.execute(...Object.values(call.parameters));
+            const duration = Date.now() - startTime;
+            // Trace successful execution
+            executionTracer.trace({
+                operationType: 'tool_invocation',
+                operationName: call.tool,
+                output: {
+                    success: true,
+                    resultType: typeof result,
+                    resultSize: JSON.stringify(result).length,
+                },
+                duration,
+                metadata: { toolId: call.id },
+            });
+            return {
+                success: true,
+                tool: call.tool,
+                result,
+                duration,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorObj = error instanceof Error ? error : new Error(String(error));
+            executionTracer.trace({
+                operationType: 'tool_invocation',
+                operationName: call.tool,
+                error: errorObj,
+                duration,
+                metadata: { toolId: call.id },
+            });
+            return {
+                success: false,
+                tool: call.tool,
+                error: errorObj.message,
+                duration,
+            };
+        }
+    }
+    /**
+     * Execute multiple tool calls in sequence
+     * Stops on first error
+     */
+    async executeAll(calls) {
+        const results = [];
+        for (const call of calls) {
+            const result = await this.execute(call);
+            results.push(result);
+            if (!result.success) {
+                break;
+            }
+        }
+        return results;
+    }
+}
+/**
+ * Validate parameters against schema
+ */
+function validateParameters(params, schema) {
+    if (!schema) {
+        return { valid: true, errors: [] };
+    }
+    const errors = [];
+    // Check required parameters
+    for (const [key, def] of Object.entries(schema)) {
+        if (def.required && !(key in params)) {
+            errors.push(`Missing required parameter: ${key}`);
+        }
+    }
+    // Check parameter types
+    for (const [key, value] of Object.entries(params)) {
+        const def = schema[key];
+        if (def) {
+            const expectedType = def.type;
+            const actualType = typeof value;
+            if (expectedType === 'array') {
+                if (!Array.isArray(value)) {
+                    errors.push(`Parameter ${key} must be an array`);
+                }
+            }
+            else if (expectedType !== actualType && expectedType !== 'any') {
+                errors.push(`Parameter ${key} must be of type ${expectedType}, got ${actualType}`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

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

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

@@ -0,0 +1,87 @@
+/**
+ * Tool: Git Operations
+ * Provides Git-Context-Controller functionality
+ * Integrates COMMIT, BRANCH, MERGE operations into reasoning loop
+ *
+ * Based on enterprise architecture: Git semantics in LLM reasoning
+ */
+export interface GitResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export interface GitDiff {
+    filepath: string;
+    additions: number;
+    deletions: number;
+    diff: string;
+}
+export interface GitCommit {
+    hash: string;
+    message: string;
+    author: string;
+    date: Date;
+    files: string[];
+}
+export interface GitBranch {
+    name: string;
+    current: boolean;
+    lastCommit: string;
+}
+/**
+ * Git Tool - Version Control Operations
+ *
+ * Available operations:
+ * - COMMIT: Create checkpoint of changes
+ * - BRANCH: Create/switch branches for exploration
+ * - MERGE: Combine branches
+ * - DIFF: Get changes between commits/branches
+ * - LOG: Query commit history
+ * - STATUS: Get current repository state
+ */
+export declare class GitTool {
+    private cwd;
+    constructor(cwd?: string);
+    /**
+     * COMMIT: Create checkpoint of current changes
+     */
+    commit(message: string, files?: string[]): Promise<GitResult>;
+    /**
+     * BRANCH: Create or switch to branch
+     */
+    branch(name: string, create?: boolean, switchTo?: boolean): Promise<GitResult>;
+    /**
+     * MERGE: Combine branches
+     */
+    merge(branch: string, strategy?: 'merge' | 'rebase' | 'squash'): Promise<GitResult>;
+    /**
+     * DIFF: Get changes between commits/branches/files
+     */
+    diff(source?: string, target?: string, filepath?: string): Promise<GitDiff[]>;
+    /**
+     * LOG: Query commit history
+     */
+    log(limit?: number, filepath?: string): Promise<GitCommit[]>;
+    /**
+     * STATUS: Get current repository state
+     */
+    status(): Promise<{
+        branch: string;
+        modified: string[];
+        staged: string[];
+        untracked: string[];
+    }>;
+    /**
+     * Check if directory is a Git repository
+     */
+    isRepository(): Promise<boolean>;
+    /**
+     * Parse diff output into structured format
+     */
+    private parseDiff;
+}
+/**
+ * Tool description for the model
+ */
+export declare const GIT_TOOL_DESCRIPTION = "\nGit Tool - Version Control Operations (Git-Context-Controller)\n\nDESCRIPTION:\nProvides Git operations integrated into the reasoning loop. Enables the agent to\ncreate checkpoints (COMMIT), explore alternatives (BRANCH), combine changes (MERGE),\nand query history (LOG, DIFF) for structural reasoning about codebase changes.\n\nAVAILABLE OPERATIONS:\n- commit(message, files?): Create checkpoint of changes\n- branch(name, create?, switchTo?): Create or switch branches\n- merge(branch, strategy?): Combine branches (merge/rebase/squash)\n- diff(source?, target?, filepath?): Get changes between commits/branches\n- log(limit?, filepath?): Query commit history\n- status(): Get current repository state\n\nUSE CASES:\n- Before major refactoring: Create branch for exploration\n- After successful changes: COMMIT to create checkpoint\n- When exploring alternatives: Use BRANCH to try different approaches\n- When debugging: Use DIFF to see what changed\n- When planning: Use LOG to understand project history\n\nINTEGRATION:\nThese operations are integrated into the ReAct reasoning loop, allowing the agent\nto reason about codebase state over time and manage long-horizon tasks with\nversion control semantics.\n";
+//# sourceMappingURL=git-tool.d.ts.map

package/dist/tools/git-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tool.d.ts","sourceRoot":"","sources":["../../src/tools/git-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAsB;IAIvC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IA6BnE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAmClG;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,QAAQ,GAAG,QAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BlG;;OAEG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC;IAuBrB;;OAEG;IACG,GAAG,CAAC,KAAK,GAAE,MAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0BtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAmCF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAStC;;OAEG;IACH,OAAO,CAAC,SAAS;CAyClB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,ssCA2BhC,CAAC"}