codehere 0.1.1

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

package/dist/tools/parser.js

@@ -0,0 +1,158 @@
+/**
+ * Tool Call Parser
+ * Parse tool calls from LLM responses
+ * Handles JSON extraction and validation
+ */
+/**
+ * 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 function parseToolCalls(response) {
+    const calls = [];
+    // 1. Try to parse the entire response as JSON (Handles Test 1 & 2)
+    try {
+        const parsed = JSON.parse(response.trim());
+        if (Array.isArray(parsed)) {
+            parsed.forEach(item => {
+                const validated = validateToolCall(item);
+                if (validated)
+                    calls.push(validated);
+            });
+        }
+        else {
+            const validated = validateToolCall(parsed);
+            if (validated)
+                calls.push(validated);
+        }
+        if (calls.length > 0)
+            return calls;
+    }
+    catch {
+        // Not valid JSON, continue to other methods
+    }
+    // 2. Try to extract JSON from markdown code blocks (Handles Test 3)
+    const codeBlockMatch = response.match(/```(?:json)?\s*(\[[\s\S]*?\]|{[\s\S]*?})\s*```/);
+    if (codeBlockMatch) {
+        try {
+            const parsed = JSON.parse(codeBlockMatch[1]);
+            if (Array.isArray(parsed)) {
+                parsed.forEach(item => {
+                    const validated = validateToolCall(item);
+                    if (validated)
+                        calls.push(validated);
+                });
+            }
+            else {
+                const validated = validateToolCall(parsed);
+                if (validated)
+                    calls.push(validated);
+            }
+            return calls;
+        }
+        catch {
+            // Fall through to other parsing methods
+        }
+    }
+    // 3. Try to find JSON object/array in response (Fallback)
+    const jsonMatch = response.match(/(\[[\s\S]*?\]|{[\s\S]*?})/);
+    if (jsonMatch) {
+        try {
+            const parsed = JSON.parse(jsonMatch[1]);
+            if (Array.isArray(parsed)) {
+                parsed.forEach(item => {
+                    const validated = validateToolCall(item);
+                    if (validated)
+                        calls.push(validated);
+                });
+            }
+            else {
+                const validated = validateToolCall(parsed);
+                if (validated)
+                    calls.push(validated);
+            }
+            // Only return if we actually found valid tool calls
+            if (calls.length > 0)
+                return calls;
+        }
+        catch {
+            // Fall through to other parsing methods
+        }
+    }
+    // 4. Try to parse structured text format (Handles Test 5 - Error Recovery)
+    // Format: tool: name, parameters: {...}
+    const textMatch = response.match(/tool:\s*(\w+)[\s\S]*?parameters?:\s*({[\s\S]*?})/i);
+    if (textMatch) {
+        try {
+            const toolName = textMatch[1];
+            const paramsStr = textMatch[2];
+            const parameters = JSON.parse(paramsStr);
+            const call = validateToolCall({ tool: toolName, parameters });
+            if (call) {
+                calls.push(call);
+            }
+        }
+        catch {
+            // Ignore parsing errors
+        }
+    }
+    return calls;
+}
+/**
+ * Validate and normalize a tool call
+ */
+function validateToolCall(call) {
+    if (!call || typeof call !== 'object') {
+        return null;
+    }
+    // Check required fields
+    if (!call.tool || typeof call.tool !== 'string') {
+        return null;
+    }
+    // Normalize parameters
+    const parameters = call.parameters || call.params || call.args || {};
+    if (typeof parameters !== 'object') {
+        return null;
+    }
+    return {
+        tool: call.tool.trim().toLowerCase(),
+        parameters,
+        id: call.id || call.callId || undefined,
+    };
+}
+/**
+ * Handle partial/malformed responses
+ * Attempts to fix common issues
+ */
+export function fixToolCall(response) {
+    let fixed = response;
+    // Fix common JSON issues
+    // 1. Missing quotes around keys
+    fixed = fixed.replace(/([{,]\s*)(\w+)(\s*:)/g, '$1"$2"$3');
+    // 2. Single quotes instead of double quotes
+    fixed = fixed.replace(/'/g, '"');
+    // 3. Trailing commas
+    fixed = fixed.replace(/,(\s*[}\]])/g, '$1');
+    // 4. Comments in JSON
+    fixed = fixed.replace(/\/\/.*$/gm, '');
+    fixed = fixed.replace(/\/\*[\s\S]*?\*\//g, '');
+    return fixed;
+}
+/**
+ * Extract tool calls with error recovery
+ * Tries multiple parsing strategies
+ */
+export function extractToolCalls(response) {
+    // Try normal parsing first
+    let calls = parseToolCalls(response);
+    // If no calls found, try fixing common issues
+    if (calls.length === 0) {
+        const fixed = fixToolCall(response);
+        calls = parseToolCalls(fixed);
+    }
+    return calls;
+}
+//# sourceMappingURL=parser.js.map

package/dist/tools/parser.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Tool Registry
+ * Central registry for all available tools
+ * Provides tool lookup and description access
+ */
+export interface Tool {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Detailed description for the model */
+    modelDescription: string;
+    /** Function to execute the tool */
+    execute: (...args: any[]) => Promise<any>;
+    /** Parameter schema (for validation) */
+    parameters?: {
+        [key: string]: {
+            type: string;
+            required?: boolean;
+            description?: string;
+        };
+    };
+}
+/**
+ * Tool Registry
+ * Singleton registry for all tools
+ */
+export declare class ToolRegistry {
+    private tools;
+    constructor();
+    /**
+     * Register all available tools
+     */
+    private registerAllTools;
+    /**
+     * Register a tool
+     */
+    register(tool: Tool): void;
+    /**
+     * Get a tool by name
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Get all tools
+     */
+    getAll(): Tool[];
+    /**
+     * Get all tool names
+     */
+    getNames(): string[];
+    /**
+     * Check if a tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get tool descriptions for the model
+     * Returns formatted string with all tool descriptions
+     */
+    getModelDescriptions(): string;
+    /**
+     * Get tool list summary for the model
+     * Returns compact list of available tools
+     */
+    getToolList(): string;
+}
+/**
+ * Get the global tool registry instance
+ */
+export declare function getToolRegistry(): ToolRegistry;
+/**
+ * Reset the registry (for testing)
+ */
+export declare function resetToolRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,IAAI;IACnB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,wCAAwC;IACxC,UAAU,CAAC,EAAE;QACX,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;;IAM7C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmOxB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC;;OAEG;IACH,MAAM,IAAI,IAAI,EAAE;IAIhB;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;OAGG;IACH,oBAAoB,IAAI,MAAM;IAO9B;;;OAGG;IACH,WAAW,IAAI,MAAM;CAMtB;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}