codehere 0.1.0 → 0.2.0

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

package/dist/tools/registry.js

@@ -0,0 +1,302 @@
+/**
+ * Tool Registry
+ * Central registry for all available tools
+ * Provides tool lookup and description access
+ */
+import { executeBash, BASH_TOOL_DESCRIPTION } from './bash.js';
+import { viewFile, createFile, strReplace, undoEdit, EDIT_TOOL_DESCRIPTION } from './edit.js';
+import { searchCodebase, SEARCH_TOOL_DESCRIPTION } from './search.js';
+import { GitTool, GIT_TOOL_DESCRIPTION } from './git-tool.js';
+/**
+ * Tool Registry
+ * Singleton registry for all tools
+ */
+export class ToolRegistry {
+    tools = new Map();
+    constructor() {
+        this.registerAllTools();
+    }
+    /**
+     * Register all available tools
+     */
+    registerAllTools() {
+        // Bash Tool
+        this.register({
+            name: 'bash',
+            description: 'Execute shell commands safely',
+            modelDescription: BASH_TOOL_DESCRIPTION,
+            execute: async (command, options) => {
+                return await executeBash(command, options);
+            },
+            parameters: {
+                command: {
+                    type: 'string',
+                    required: true,
+                    description: 'Shell command to execute',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Bash options (cwd, timeout, maxOutputSize, env)',
+                },
+            },
+        });
+        // Edit Tool - view
+        this.register({
+            name: 'edit_view',
+            description: 'View file content',
+            modelDescription: EDIT_TOOL_DESCRIPTION,
+            execute: async (filepath, options) => {
+                return viewFile(filepath, options);
+            },
+            parameters: {
+                filepath: {
+                    type: 'string',
+                    required: true,
+                    description: 'File path to view',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Edit options (cwd, createIfNotExists)',
+                },
+            },
+        });
+        // Edit Tool - create
+        this.register({
+            name: 'edit_create',
+            description: 'Create a new file',
+            modelDescription: EDIT_TOOL_DESCRIPTION,
+            execute: async (filepath, content, options) => {
+                return createFile(filepath, content, options);
+            },
+            parameters: {
+                filepath: {
+                    type: 'string',
+                    required: true,
+                    description: 'File path to create',
+                },
+                content: {
+                    type: 'string',
+                    required: true,
+                    description: 'File content',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Edit options (cwd, createIfNotExists)',
+                },
+            },
+        });
+        // Edit Tool - str_replace
+        this.register({
+            name: 'edit_replace',
+            description: 'Replace string in file (exact match required)',
+            modelDescription: EDIT_TOOL_DESCRIPTION,
+            execute: async (filepath, oldString, newString, options) => {
+                return strReplace(filepath, oldString, newString, options);
+            },
+            parameters: {
+                filepath: {
+                    type: 'string',
+                    required: true,
+                    description: 'File path to edit',
+                },
+                oldString: {
+                    type: 'string',
+                    required: true,
+                    description: 'String to replace (must match exactly)',
+                },
+                newString: {
+                    type: 'string',
+                    required: true,
+                    description: 'Replacement string',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Edit options (cwd)',
+                },
+            },
+        });
+        // Edit Tool - undo
+        this.register({
+            name: 'edit_undo',
+            description: 'Undo last edit',
+            modelDescription: EDIT_TOOL_DESCRIPTION,
+            execute: async (filepath, options) => {
+                return undoEdit(filepath, options);
+            },
+            parameters: {
+                filepath: {
+                    type: 'string',
+                    required: true,
+                    description: 'File path to undo',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Edit options (cwd)',
+                },
+            },
+        });
+        // Search Tool
+        this.register({
+            name: 'search',
+            description: 'Search codebase using intelligent retrieval',
+            modelDescription: SEARCH_TOOL_DESCRIPTION,
+            execute: async (query, options) => {
+                return await searchCodebase(query, options);
+            },
+            parameters: {
+                query: {
+                    type: 'string',
+                    required: true,
+                    description: 'Search query',
+                },
+                options: {
+                    type: 'object',
+                    required: false,
+                    description: 'Search options (baseDir, maxResults, fileTypes, minScore)',
+                },
+            },
+        });
+        // Git Tool
+        this.register({
+            name: 'git',
+            description: 'Git version control operations (COMMIT, BRANCH, MERGE, DIFF, LOG)',
+            modelDescription: GIT_TOOL_DESCRIPTION,
+            execute: async (operation, params) => {
+                const gitTool = new GitTool();
+                switch (operation.toLowerCase()) {
+                    case 'commit':
+                        return await gitTool.commit(params?.message || 'Codehere commit', params?.files);
+                    case 'branch':
+                        return await gitTool.branch(params?.branch || 'main', params?.create || false, params?.switchTo || false);
+                    case 'merge':
+                        return await gitTool.merge(params?.branch || 'main', params?.strategy || 'merge');
+                    case 'diff':
+                        return await gitTool.diff(params?.source, params?.target, params?.filepath);
+                    case 'log':
+                        return await gitTool.log(params?.limit || 10, params?.filepath);
+                    case 'status':
+                        return await gitTool.status();
+                    default:
+                        return {
+                            success: false,
+                            output: '',
+                            error: `Unknown git operation: ${operation}`,
+                        };
+                }
+            },
+            parameters: {
+                operation: {
+                    type: 'string',
+                    required: true,
+                    description: 'Git operation: commit, branch, merge, diff, log, status',
+                },
+                message: {
+                    type: 'string',
+                    required: false,
+                    description: 'Commit message (for commit operation)',
+                },
+                branch: {
+                    type: 'string',
+                    required: false,
+                    description: 'Branch name (for branch/merge operations)',
+                },
+                files: {
+                    type: 'array',
+                    required: false,
+                    description: 'File paths (for commit operation)',
+                },
+                source: {
+                    type: 'string',
+                    required: false,
+                    description: 'Source commit/branch (for diff operation)',
+                },
+                target: {
+                    type: 'string',
+                    required: false,
+                    description: 'Target commit/branch (for diff operation)',
+                },
+                limit: {
+                    type: 'number',
+                    required: false,
+                    description: 'Number of commits to return (for log operation)',
+                },
+            },
+        });
+    }
+    /**
+     * Register a tool
+     */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Get a tool by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Get all tools
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get all tool names
+     */
+    getNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Check if a tool exists
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get tool descriptions for the model
+     * Returns formatted string with all tool descriptions
+     */
+    getModelDescriptions() {
+        const tools = this.getAll();
+        return tools.map(tool => {
+            return `## ${tool.name}\n${tool.modelDescription}`;
+        }).join('\n\n---\n\n');
+    }
+    /**
+     * Get tool list summary for the model
+     * Returns compact list of available tools
+     */
+    getToolList() {
+        const tools = this.getAll();
+        return tools.map(tool => {
+            return `- ${tool.name}: ${tool.description}`;
+        }).join('\n');
+    }
+}
+// Singleton instance
+let registryInstance = null;
+/**
+ * Get the global tool registry instance
+ */
+export function getToolRegistry() {
+    if (!registryInstance) {
+        registryInstance = new ToolRegistry();
+    }
+    return registryInstance;
+}
+/**
+ * Reset the registry (for testing)
+ */
+export function resetToolRegistry() {
+    registryInstance = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAqC,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,qBAAqB,EAAqC,MAAM,WAAW,CAAC;AACjI,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAA6C,MAAM,aAAa,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAgD,MAAM,eAAe,CAAC;AAqB5G;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C;QACE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,YAAY;QACZ,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,+BAA+B;YAC5C,gBAAgB,EAAE,qBAAqB;YACvC,OAAO,EAAE,KAAK,EAAE,OAAe,EAAE,OAAqB,EAAuB,EAAE;gBAC7E,OAAO,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC;YACD,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,iDAAiD;iBAC/D;aACF;SACF,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,mBAAmB;YAChC,gBAAgB,EAAE,qBAAqB;YACvC,OAAO,EAAE,KAAK,EAAE,QAAgB,EAAE,OAAqB,EAAuB,EAAE;gBAC9E,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,uCAAuC;iBACrD;aACF;SACF,CAAC,CAAC;QAEH,qBAAqB;QACrB,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,mBAAmB;YAChC,gBAAgB,EAAE,qBAAqB;YACvC,OAAO,EAAE,KAAK,EAAE,QAAgB,EAAE,OAAe,EAAE,OAAqB,EAAuB,EAAE;gBAC/F,OAAO,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,qBAAqB;iBACnC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,cAAc;iBAC5B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,uCAAuC;iBACrD;aACF;SACF,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,+CAA+C;YAC5D,gBAAgB,EAAE,qBAAqB;YACvC,OAAO,EAAE,KAAK,EAAE,QAAgB,EAAE,SAAiB,EAAE,SAAiB,EAAE,OAAqB,EAAuB,EAAE;gBACpH,OAAO,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,wCAAwC;iBACtD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,oBAAoB;iBAClC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,oBAAoB;iBAClC;aACF;SACF,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,gBAAgB;YAC7B,gBAAgB,EAAE,qBAAqB;YACvC,OAAO,EAAE,KAAK,EAAE,QAAgB,EAAE,OAAqB,EAAuB,EAAE;gBAC9E,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,oBAAoB;iBAClC;aACF;SACF,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6CAA6C;YAC1D,gBAAgB,EAAE,uBAAuB;YACzC,OAAO,EAAE,KAAK,EAAE,KAAa,EAAE,OAAuB,EAA6B,EAAE;gBACnF,OAAO,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;YACD,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,cAAc;iBAC5B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,2DAA2D;iBACzE;aACF;SACF,CAAC,CAAC;QAEH,WAAW;QACX,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,mEAAmE;YAChF,gBAAgB,EAAE,oBAAoB;YACtC,OAAO,EAAE,KAAK,EAAE,SAAiB,EAAE,MAAY,EAAsD,EAAE;gBACrG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;gBAE9B,QAAQ,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;oBAChC,KAAK,QAAQ;wBACX,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBAEnF,KAAK,QAAQ;wBACX,OAAO,MAAM,OAAO,CAAC,MAAM,CACzB,MAAM,EAAE,MAAM,IAAI,MAAM,EACxB,MAAM,EAAE,MAAM,IAAI,KAAK,EACvB,MAAM,EAAE,QAAQ,IAAI,KAAK,CAC1B,CAAC;oBAEJ,KAAK,OAAO;wBACV,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC,CAAC;oBAEpF,KAAK,MAAM;wBACT,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAE9E,KAAK,KAAK;wBACR,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAElE,KAAK,QAAQ;wBACX,OAAO,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;oBAEhC;wBACE,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,MAAM,EAAE,EAAE;4BACV,KAAK,EAAE,0BAA0B,SAAS,EAAE;yBAC7C,CAAC;gBACN,CAAC;YACH,CAAC;YACD,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,yDAAyD;iBACvE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,uCAAuC;iBACrD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,2CAA2C;iBACzD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,mCAAmC;iBACjD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,2CAA2C;iBACzD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,2CAA2C;iBACzD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,iDAAiD;iBAC/D;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACtB,OAAO,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACtB,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,gBAAgB,GAAwB,IAAI,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Search Tool
+ * Leverages our intelligent retrieval (competitive advantage)
+ * Provides semantic codebase search with AST-based context
+ */
+import type { SearchResult } from '../types.js';
+export interface SearchOptions {
+    /** Base directory for search (default: current working directory) */
+    baseDir?: string;
+    /** Maximum number of results (default: 15) */
+    maxResults?: number;
+    /** File type filters (e.g., ['ts', 'tsx', 'js']) */
+    fileTypes?: string[];
+    /** Minimum relevance score (0-1, default: 0.3) */
+    minScore?: number;
+}
+export interface SearchToolResult {
+    /** Whether search succeeded */
+    success: boolean;
+    /** Search results (code chunks) */
+    results: SearchResult[];
+    /** Total chunks found */
+    totalChunks: number;
+    /** Token reduction percentage */
+    reductionPercent: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Search codebase using intelligent retrieval
+ *
+ * This is our competitive advantage - uses AST-based context retrieval
+ * instead of naive cosine similarity
+ */
+export declare function searchCodebase(query: string, options?: SearchOptions): Promise<SearchToolResult>;
+/**
+ * Tool description for the model
+ * This highlights our competitive advantage
+ */
+export declare const SEARCH_TOOL_DESCRIPTION = "\nSearch Tool - Intelligent codebase search (Our Competitive Advantage)\n\nDESCRIPTION:\nSearch codebase using intelligent retrieval with AST-based context understanding.\nThis is more powerful than naive cosine similarity - understands code structure.\n\nAVAILABLE OPERATIONS:\n- searchCodebase(query, options): Search codebase with intelligent retrieval\n\nFEATURES (Our Competitive Advantage):\n1. **AST-Based Context**: Understands code structure, not just text similarity\n2. **Caller/Callee Analysis**: Finds related functions automatically\n3. **Type-Aware Search**: Understands TypeScript/JavaScript types\n4. **Token Optimization**: Reduces context size by 80-90% while maintaining relevance\n5. **Intelligent Chunking**: Chunks code semantically, not just by size\n\nSEARCH OPTIONS:\n- baseDir: Base directory (default: current directory)\n- maxResults: Maximum results (default: 15)\n- fileTypes: Filter by file types (e.g., ['ts', 'tsx'])\n- minScore: Minimum relevance score 0-1 (default: 0.3)\n\nRETURNS:\n- results: Array of code chunks with metadata\n- Each chunk includes: filepath, content, score, metadata\n- reductionPercent: Token reduction achieved (typically 80-90%)\n\nEXAMPLES:\n- searchCodebase('How does authentication work?')\n- searchCodebase('Find all API endpoints', { fileTypes: ['ts'] })\n- searchCodebase('Where is user validation?', { maxResults: 10 })\n\nADVANTAGES OVER NAIVE SEARCH:\n1. **Semantic Understanding**: Understands code meaning, not just keywords\n2. **Context-Aware**: Includes related functions, types, imports\n3. **Efficient**: 80-90% token reduction while maintaining accuracy\n4. **Accurate**: AST-based matching is more precise than text similarity\n\nREQUIREMENTS:\n- Codebase must be indexed first (run 'codehere index')\n- Indexing creates embeddings and AST analysis\n- Search uses both embeddings and AST for best results\n";
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAyC3B;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,k2DA2CnC,CAAC"}