codehere 0.1.0 → 0.2.0

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"}

package/dist/tools/git-tool.js

@@ -0,0 +1,292 @@
+/**
+ * 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
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * 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 class GitTool {
+    cwd;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+    }
+    /**
+     * COMMIT: Create checkpoint of current changes
+     */
+    async commit(message, files) {
+        try {
+            // Stage files if specified, otherwise stage all
+            if (files && files.length > 0) {
+                await execAsync(`git add ${files.join(' ')}`, { cwd: this.cwd });
+            }
+            else {
+                await execAsync('git add -A', { cwd: this.cwd });
+            }
+            // Create commit
+            const { stdout, stderr } = await execAsync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { cwd: this.cwd });
+            return {
+                success: true,
+                output: stdout,
+                error: stderr || undefined,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error.message || String(error),
+            };
+        }
+    }
+    /**
+     * BRANCH: Create or switch to branch
+     */
+    async branch(name, create = false, switchTo = false) {
+        try {
+            if (create) {
+                const { stdout, stderr } = await execAsync(`git branch ${name}`, { cwd: this.cwd });
+                return {
+                    success: true,
+                    output: stdout,
+                    error: stderr || undefined,
+                };
+            }
+            if (switchTo) {
+                const { stdout, stderr } = await execAsync(`git checkout ${name}`, { cwd: this.cwd });
+                return {
+                    success: true,
+                    output: stdout,
+                    error: stderr || undefined,
+                };
+            }
+            // List branches
+            const { stdout } = await execAsync('git branch', { cwd: this.cwd });
+            return {
+                success: true,
+                output: stdout,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error.message || String(error),
+            };
+        }
+    }
+    /**
+     * MERGE: Combine branches
+     */
+    async merge(branch, strategy = 'merge') {
+        try {
+            let command;
+            if (strategy === 'rebase') {
+                command = `git rebase ${branch}`;
+            }
+            else if (strategy === 'squash') {
+                command = `git merge --squash ${branch}`;
+            }
+            else {
+                command = `git merge ${branch}`;
+            }
+            const { stdout, stderr } = await execAsync(command, { cwd: this.cwd });
+            return {
+                success: true,
+                output: stdout,
+                error: stderr || undefined,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error.message || String(error),
+            };
+        }
+    }
+    /**
+     * DIFF: Get changes between commits/branches/files
+     */
+    async diff(source, target, filepath) {
+        try {
+            let command = 'git diff';
+            if (source && target) {
+                command += ` ${source}..${target}`;
+            }
+            else if (source) {
+                command += ` ${source}`;
+            }
+            if (filepath) {
+                command += ` -- ${filepath}`;
+            }
+            const { stdout } = await execAsync(command, { cwd: this.cwd });
+            // Parse diff output
+            return this.parseDiff(stdout);
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * LOG: Query commit history
+     */
+    async log(limit = 10, filepath) {
+        try {
+            let command = `git log -n ${limit} --pretty=format:"%H|%s|%an|%ad" --date=iso`;
+            if (filepath) {
+                command += ` -- ${filepath}`;
+            }
+            const { stdout } = await execAsync(command, { cwd: this.cwd });
+            const lines = stdout.split('\n').filter(l => l.trim());
+            return lines.map(line => {
+                const [hash, message, author, dateStr] = line.split('|');
+                return {
+                    hash: hash.substring(0, 8),
+                    message,
+                    author,
+                    date: new Date(dateStr),
+                    files: [], // Would need separate call to get files
+                };
+            });
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * STATUS: Get current repository state
+     */
+    async status() {
+        try {
+            const { stdout } = await execAsync('git status --porcelain', { cwd: this.cwd });
+            const branchOutput = await execAsync('git branch --show-current', { cwd: this.cwd });
+            const branch = branchOutput.stdout.trim();
+            const modified = [];
+            const staged = [];
+            const untracked = [];
+            stdout.split('\n').forEach(line => {
+                if (!line.trim())
+                    return;
+                const status = line.substring(0, 2);
+                const filepath = line.substring(3);
+                if (status.startsWith('??')) {
+                    untracked.push(filepath);
+                }
+                else if (status.startsWith(' ')) {
+                    modified.push(filepath);
+                }
+                else {
+                    staged.push(filepath);
+                }
+            });
+            return { branch, modified, staged, untracked };
+        }
+        catch (error) {
+            return {
+                branch: 'unknown',
+                modified: [],
+                staged: [],
+                untracked: [],
+            };
+        }
+    }
+    /**
+     * Check if directory is a Git repository
+     */
+    async isRepository() {
+        try {
+            await execAsync('git rev-parse --git-dir', { cwd: this.cwd });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Parse diff output into structured format
+     */
+    parseDiff(diffOutput) {
+        const diffs = [];
+        const filePattern = /^diff --git a\/(.+?) b\/(.+?)$/gm;
+        let currentFile = null;
+        let currentDiff = '';
+        const lines = diffOutput.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const fileMatch = line.match(/^diff --git a\/(.+?) b\/(.+?)$/);
+            if (fileMatch) {
+                if (currentFile) {
+                    currentFile.diff = currentDiff;
+                    diffs.push(currentFile);
+                }
+                currentFile = {
+                    filepath: fileMatch[1],
+                    additions: 0,
+                    deletions: 0,
+                    diff: '',
+                };
+                currentDiff = line + '\n';
+            }
+            else if (currentFile) {
+                currentDiff += line + '\n';
+                if (line.startsWith('+') && !line.startsWith('+++')) {
+                    currentFile.additions++;
+                }
+                else if (line.startsWith('-') && !line.startsWith('---')) {
+                    currentFile.deletions++;
+                }
+            }
+        }
+        if (currentFile) {
+            currentFile.diff = currentDiff;
+            diffs.push(currentFile);
+        }
+        return diffs;
+    }
+}
+/**
+ * Tool description for the model
+ */
+export const GIT_TOOL_DESCRIPTION = `
+Git Tool - Version Control Operations (Git-Context-Controller)
+
+DESCRIPTION:
+Provides Git operations integrated into the reasoning loop. Enables the agent to
+create checkpoints (COMMIT), explore alternatives (BRANCH), combine changes (MERGE),
+and query history (LOG, DIFF) for structural reasoning about codebase changes.
+
+AVAILABLE OPERATIONS:
+- commit(message, files?): Create checkpoint of changes
+- branch(name, create?, switchTo?): Create or switch branches
+- merge(branch, strategy?): Combine branches (merge/rebase/squash)
+- diff(source?, target?, filepath?): Get changes between commits/branches
+- log(limit?, filepath?): Query commit history
+- status(): Get current repository state
+
+USE CASES:
+- Before major refactoring: Create branch for exploration
+- After successful changes: COMMIT to create checkpoint
+- When exploring alternatives: Use BRANCH to try different approaches
+- When debugging: Use DIFF to see what changed
+- When planning: Use LOG to understand project history
+
+INTEGRATION:
+These operations are integrated into the ReAct reasoning loop, allowing the agent
+to reason about codebase state over time and manage long-horizon tasks with
+version control semantics.
+`;
+//# sourceMappingURL=git-tool.js.map

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

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

package/dist/tools/parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Call Parser
+ * Parse tool calls from LLM responses
+ * Handles JSON extraction and validation
+ */
+export interface ToolCall {
+    /** Tool name */
+    tool: string;
+    /** Tool parameters */
+    parameters: Record<string, any>;
+    /** Optional call ID for tracking */
+    id?: string;
+}
+/**
+ * Parse tool calls from LLM response
+ * Handles various formats:
+ * - JSON object: {"tool": "bash", "parameters": {...}}
+ * - JSON array: [{"tool": "bash", ...}, ...]
+ * - Markdown code blocks: ```json {...} ```
+ * - Inline JSON: tool: bash, params: {...}
+ */
+export declare function parseToolCalls(response: string): ToolCall[];
+/**
+ * Handle partial/malformed responses
+ * Attempts to fix common issues
+ */
+export declare function fixToolCall(response: string): string;
+/**
+ * Extract tool calls with error recovery
+ * Tries multiple parsing strategies
+ */
+export declare function extractToolCalls(response: string): ToolCall[];
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/tools/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,oCAAoC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CA+E3D;AA4BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAW7D"}