@codebolt/codeboltjs 2.0.4 → 2.0.6

package/dist/modules/tools.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const websocket_1 = __importDefault(require("./websocket"));
+const websocket_1 = __importDefault(require("../core/websocket"));
 /**
  * Object containing methods for interacting with Codebolt MCP (Model Context Protocol) tools.
  * Provides functionality to discover, list, and execute tools.
@@ -15,26 +15,10 @@ const codeboltMCP = {
      * @returns Promise with the enabled toolboxes data
      */
     getEnabledToolBoxes: () => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "getEnabledToolBoxes"
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "getEnabledToolBoxesResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "getEnabledToolBoxes"
+        }, "getEnabledToolBoxesResponse");
     },
     /**
      * Gets the list of locally available toolboxes.
@@ -42,26 +26,10 @@ const codeboltMCP = {
      * @returns Promise with the local toolboxes data
      */
     getLocalToolBoxes: () => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "getLocalToolBoxes"
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "getLocalToolBoxesResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "getLocalToolBoxes"
+        }, "getLocalToolBoxesResponse");
     },
     /**
      * Gets toolboxes mentioned in a user message.
@@ -70,36 +38,10 @@ const codeboltMCP = {
      * @returns Promise with the mentioned toolboxes
      */
     getMentionedToolBoxes: (userMessage) => {
-        return new Promise((resolve, reject) => {
-            resolve(userMessage.mentionedMCPs);
-        });
-    },
-    /**
-     * Gets all available toolboxes.
-     *
-     * @returns Promise with all available toolboxes data
-     */
-    getAvailableToolBoxes: () => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "getAvailableToolBoxes"
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "getAvailableToolBoxesResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "getAvailableToolBoxes"
+        }, "getAvailableToolBoxesResponse");
     },
     /**
      * Searches for available toolboxes matching a query.
@@ -108,27 +50,11 @@ const codeboltMCP = {
      * @returns Promise with matching toolboxes data
      */
     searchAvailableToolBoxes: (query) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "searchAvailableToolBoxes",
-                "query": query
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "searchAvailableToolBoxesResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "searchAvailableToolBoxes",
+            "query": query
+        }, "searchAvailableToolBoxesResponse");
     },
     /**
      * Lists all tools from the specified toolboxes.
@@ -137,27 +63,11 @@ const codeboltMCP = {
      * @returns Promise with tools from the specified toolboxes
      */
     listToolsFromToolBoxes: (toolBoxes) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "listToolsFromToolBoxes",
-                "toolBoxes": toolBoxes
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "listToolsFromToolBoxesResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "listToolsFromToolBoxes",
+            "toolBoxes": toolBoxes
+        }, "listToolsFromToolBoxesResponse");
     },
     /**
      * Configures a specific toolbox with provided configuration.
@@ -167,28 +77,12 @@ const codeboltMCP = {
      * @returns Promise with the configuration result
      */
     configureToolBox: (name, config) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "configureToolBox",
-                "mcpName": name,
-                "config": config
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "configureToolBoxResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "configureToolBox",
+            "mcpName": name,
+            "config": config
+        }, "configureToolBoxResponse");
     },
     /**
      * Gets detailed information about specific tools.
@@ -197,27 +91,11 @@ const codeboltMCP = {
      * @returns Promise with detailed information about the tools
      */
     getTools: (tools) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "getTools",
-                "toolboxes": tools
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "getToolsResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "getTools",
+            "toolboxes": tools
+        }, "getToolsResponse");
     },
     /**
      * Executes a specific tool with provided parameters.
@@ -228,28 +106,12 @@ const codeboltMCP = {
      * @returns Promise with the execution result
      */
     executeTool: (toolbox, toolName, params) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "codebolttools",
-                "action": "executeTool",
-                "toolName": `${toolbox}--${toolName}`,
-                "params": params
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                try {
-                    const response = JSON.parse(data);
-                    if (response.type === "executeToolResponse") {
-                        resolve(response.data);
-                    }
-                }
-                catch (error) {
-                    reject(new Error("Failed to parse response"));
-                }
-            });
-            websocket_1.default.getWebsocket.on('error', (error) => {
-                reject(error);
-            });
-        });
-    },
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "codebolttools",
+            "action": "executeTool",
+            "toolName": `${toolbox}--${toolName}`,
+            "params": params
+        }, "executeToolResponse");
+    }
 };
 exports.default = codeboltMCP;

package/dist/modules/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const websocket_1 = __importDefault(require("../core/websocket"));
+const cbutils = {
+    editFileAndApplyDiff: (filePath, diff, diffIdentifier, prompt, applyModel) => {
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "fsEvent",
+            "action": "editFileAndApplyDiff",
+            message: {
+                filePath,
+                diff,
+                diffIdentifier,
+                prompt,
+                applyModel
+            }
+        }, "editFileAndApplyDiffResponse");
+    }
+};
+exports.default = cbutils;

package/dist/modules/vectordb.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const websocket_1 = __importDefault(require("./websocket"));
+const websocket_1 = __importDefault(require("../core/websocket"));
 const VectorDB = {
     /**
      * Retrieves a vector from the vector database based on the provided key.
@@ -12,21 +12,13 @@ const VectorDB = {
      * @returns {Promise<GetVectorResponse>} A promise that resolves with the retrieved vector.
      */
     getVector: async (key) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "vectordbEvent",
-                "action": "getVector",
-                "message": {
-                    item: key
-                },
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                const response = JSON.parse(data);
-                if (response.type === "getVectorResponse") {
-                    resolve(response);
-                }
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "vectordbEvent",
+            "action": "getVector",
+            "message": {
+                item: key
+            },
+        }, "getVectorResponse");
     },
     /**
      * Adds a new vector item to the vector database.
@@ -36,21 +28,13 @@ const VectorDB = {
      * @returns {Promise<AddVectorItemResponse>} A promise that resolves when the item is successfully added.
      */
     addVectorItem: async (item) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "vectordbEvent",
-                "action": "addVectorItem",
-                "message": {
-                    item: item
-                },
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                const response = JSON.parse(data);
-                if (response.type === "addVectorItemResponse") {
-                    resolve(response);
-                }
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "vectordbEvent",
+            "action": "addVectorItem",
+            "message": {
+                item: item
+            },
+        }, "addVectorItemResponse");
     },
     /**
      * Queries a vector item from the vector database based on the provided key.
@@ -59,21 +43,13 @@ const VectorDB = {
      * @returns {Promise<QueryVectorItemResponse>} A promise that resolves with the queried vector item.
      */
     queryVectorItem: async (key) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "vectordbEvent",
-                "action": "queryVectorItem",
-                "message": {
-                    item: key
-                },
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                const response = JSON.parse(data);
-                if (response.type === "qeryVectorItemResponse") {
-                    resolve(response);
-                }
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "vectordbEvent",
+            "action": "queryVectorItem",
+            "message": {
+                item: key
+            },
+        }, "qeryVectorItemResponse");
     },
     /**
      * Queries a vector item from the vector database based on the provided key.
@@ -82,22 +58,14 @@ const VectorDB = {
      * @returns {Promise<QueryVectorItemResponse>} A promise that resolves with the queried vector item.
      */
     queryVectorItems: async (items, dbPath) => {
-        return new Promise((resolve, reject) => {
-            websocket_1.default.getWebsocket.send(JSON.stringify({
-                "type": "vectordbEvent",
-                "action": "queryVectorItems",
-                "message": {
-                    items,
-                    dbPath
-                },
-            }));
-            websocket_1.default.getWebsocket.on('message', (data) => {
-                const response = JSON.parse(data);
-                if (response.type === "qeryVectorItemsResponse") {
-                    resolve(response);
-                }
-            });
-        });
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            "type": "vectordbEvent",
+            "action": "queryVectorItems",
+            "message": {
+                items,
+                dbPath
+            },
+        }, "qeryVectorItemsResponse");
     },
 };
 exports.default = VectorDB;

package/dist/utils/parse-source-code/index.d.ts

@@ -0,0 +1,9 @@
+export declare const LIST_FILES_LIMIT = 200;
+export declare function parseSourceCodeForDefinitionsTopLevel(dirPath: string): Promise<string>;
+export declare function listFiles(dirPath: string, recursive: boolean): Promise<string[]>;
+export declare function globbyLevelByLevel(options: any): Promise<string[]>;
+export declare function separateFiles(allFiles: string[]): {
+    filesToParse: string[];
+    remainingFiles: string[];
+};
+export declare function parseFile(filePath: string, languageParsers: any): Promise<string | undefined>;

package/dist/utils/parse-source-code/index.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFile = exports.separateFiles = exports.globbyLevelByLevel = exports.listFiles = exports.parseSourceCodeForDefinitionsTopLevel = exports.LIST_FILES_LIMIT = void 0;
+const fs = require("fs/promises");
+const os = require("os");
+const path = require("path");
+const { LanguageParser, loadRequiredLanguageParsers } = require("./languageParser");
+// const { globby } = await import("globby");
+const { globby } = require('@codebolt/globby');
+exports.LIST_FILES_LIMIT = 200;
+// TODO: implement caching behavior to avoid having to keep analyzing project for new tasks.
+async function parseSourceCodeForDefinitionsTopLevel(dirPath) {
+    // check if the path exists
+    const dirExists = await fs
+        .access(path.resolve(dirPath))
+        .then(() => true)
+        .catch(() => false);
+    if (!dirExists) {
+        return "This directory does not exist or you do not have permission to access it.";
+    }
+    // Get all files at top level (not gitignored)
+    const allFiles = await listFiles(dirPath, false);
+    let result = "";
+    // Separate files to parse and remaining files
+    const { filesToParse, remainingFiles } = separateFiles(allFiles);
+    const languageParsers = await loadRequiredLanguageParsers(filesToParse);
+    // Parse specific files we have language parsers for
+    // const filesWithoutDefinitions: string[] = []
+    for (const file of filesToParse) {
+        const definitions = await parseFile(file, languageParsers);
+        if (definitions) {
+            result += `${path.relative(dirPath, file)}\n${definitions}\n`;
+        }
+        // else {
+        // 	filesWithoutDefinitions.push(file)
+        // }
+    }
+    // List remaining files' paths
+    // let didFindUnparsedFiles = false
+    // filesWithoutDefinitions
+    // 	.concat(remainingFiles)
+    // 	.sort()
+    // 	.forEach((file) => {
+    // 		if (!didFindUnparsedFiles) {
+    // 			result += "# Unparsed Files\n\n"
+    // 			didFindUnparsedFiles = true
+    // 		}
+    // 		result += `${path.relative(dirPath, file)}\n`
+    // 	})
+    return result ? result : "No source code definitions found.";
+}
+exports.parseSourceCodeForDefinitionsTopLevel = parseSourceCodeForDefinitionsTopLevel;
+async function listFiles(dirPath, recursive) {
+    const absolutePath = path.resolve(dirPath);
+    // Do not allow listing files in root or home directory, which Claude tends to want to do when the user's prompt is vague.
+    const root = process.platform === "win32" ? path.parse(absolutePath).root : "/";
+    const isRoot = absolutePath === root;
+    if (isRoot) {
+        return [root];
+    }
+    const homeDir = os.homedir();
+    const isHomeDir = absolutePath === homeDir;
+    if (isHomeDir) {
+        return [homeDir];
+    }
+    const dirsToIgnore = [
+        "node_modules",
+        "__pycache__",
+        "env",
+        "venv",
+        "target/dependency",
+        "build/dependencies",
+        "dist",
+        "out",
+        "bundle",
+        "vendor",
+        "tmp",
+        "temp",
+        "deps",
+        "pkg",
+        "Pods",
+        ".*", // Ignore all hidden directories and files
+    ].map((dir) => `**/${dir}/**`);
+    const options = {
+        cwd: dirPath,
+        dot: false, // do not ignore hidden files/directories
+        absolute: true,
+        markDirectories: true, // Append a / on any directories matched
+        gitignore: recursive, // globby ignores any files that are gitignored
+        ignore: recursive ? dirsToIgnore : undefined, // just in case there is no gitignore, we ignore sensible defaults
+        onlyFiles: false, // true by default, false means it will list directories on their own too
+    };
+    // * globs all files in one dir, ** globs files in nested directories
+    const files = recursive
+        ? await globbyLevelByLevel(options)
+        : (await globby("*", options)).slice(0, exports.LIST_FILES_LIMIT);
+    return files;
+}
+exports.listFiles = listFiles;
+// globby doesnt natively support top down level by level globbing, so we implement it ourselves
+async function globbyLevelByLevel(options) {
+    let results = [];
+    const globbingProcess = async () => {
+        let currentLevel = 0;
+        // const { globby } = await import("globby");
+        while (results.length < exports.LIST_FILES_LIMIT) {
+            const pattern = currentLevel === 0 ? "*" : `${"*/".repeat(currentLevel)}*`;
+            const filesAtLevel = await globby(pattern, options);
+            if (filesAtLevel.length === 0) {
+                break;
+            }
+            results.push(...filesAtLevel);
+            if (results.length >= exports.LIST_FILES_LIMIT) {
+                results = results.slice(0, exports.LIST_FILES_LIMIT);
+                break;
+            }
+            currentLevel++;
+        }
+        return results;
+    };
+    // Timeout after 10 seconds and return partial results
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("Globbing timeout")), 10000);
+    });
+    try {
+        return await Promise.race([globbingProcess(), timeoutPromise]);
+    }
+    catch (error) {
+        console.log(error);
+        console.warn("Globbing timed out, returning partial results");
+        return results;
+    }
+}
+exports.globbyLevelByLevel = globbyLevelByLevel;
+function separateFiles(allFiles) {
+    const extensions = [
+        "js",
+        "jsx",
+        "ts",
+        "tsx",
+        "py",
+        // Rust
+        "rs",
+        "go",
+        // C
+        "c",
+        "h",
+        // C++
+        "cpp",
+        "hpp",
+        // C#
+        "cs",
+        // Ruby
+        "rb",
+        "java",
+        "php",
+        "swift",
+    ].map((e) => `.${e}`);
+    const filesToParse = allFiles.filter((file) => extensions.includes(path.extname(file))).slice(0, 50); // 50 files max
+    const remainingFiles = allFiles.filter((file) => !filesToParse.includes(file));
+    return { filesToParse, remainingFiles };
+}
+exports.separateFiles = separateFiles;
+/*
+Parsing files using tree-sitter
+
+1. Parse the file content into an AST (Abstract Syntax Tree) using the appropriate language grammar (set of rules that define how the components of a language like keywords, expressions, and statements can be combined to create valid programs).
+2. Create a query using a language-specific query string, and run it against the AST's root node to capture specific syntax elements.
+    - We use tag queries to identify named entities in a program, and then use a syntax capture to label the entity and its name. A notable example of this is GitHub's search-based code navigation.
+    - Our custom tag queries are based on tree-sitter's default tag queries, but modified to only capture definitions.
+3. Sort the captures by their position in the file, output the name of the definition, and format by i.e. adding "|----\n" for gaps between captured sections.
+
+This approach allows us to focus on the most relevant parts of the code (defined by our language-specific queries) and provides a concise yet informative view of the file's structure and key elements.
+
+- https://github.com/tree-sitter/node-tree-sitter/blob/master/test/query_test.js
+- https://github.com/tree-sitter/tree-sitter/blob/master/lib/binding_web/test/query-test.js
+- https://github.com/tree-sitter/tree-sitter/blob/master/lib/binding_web/test/helper.js
+- https://tree-sitter.github.io/tree-sitter/code-navigation-systems
+*/
+async function parseFile(filePath, languageParsers) {
+    const fileContent = await fs.readFile(filePath, "utf8");
+    const ext = path.extname(filePath).toLowerCase().slice(1);
+    const { parser, query } = languageParsers[ext] || {};
+    if (!parser || !query) {
+        return `Unsupported file type: ${filePath}`;
+    }
+    let formattedOutput = "";
+    try {
+        // Parse the file content into an Abstract Syntax Tree (AST), a tree-like representation of the code
+        const tree = parser.parse(fileContent);
+        // Apply the query to the AST and get the captures
+        // Captures are specific parts of the AST that match our query patterns, each capture represents a node in the AST that we're interested in.
+        const captures = query.captures(tree.rootNode);
+        // Sort captures by their start position
+        captures.sort((a, b) => a.node.startPosition.row - b.node.startPosition.row);
+        // Split the file content into individual lines
+        const lines = fileContent.split("\n");
+        // Keep track of the last line we've processed
+        let lastLine = -1;
+        captures.forEach((capture) => {
+            const { node, name } = capture;
+            // Get the start and end lines of the current AST node
+            const startLine = node.startPosition.row;
+            const endLine = node.endPosition.row;
+            // Once we've retrieved the nodes we care about through the language query, we filter for lines with definition names only.
+            // name.startsWith("name.reference.") > refs can be used for ranking purposes, but we don't need them for the output
+            // previously we did `name.startsWith("name.definition.")` but this was too strict and excluded some relevant definitions
+            // Add separator if there's a gap between captures
+            if (lastLine !== -1 && startLine > lastLine + 1) {
+                formattedOutput += "|----\n";
+            }
+            // Only add the first line of the definition
+            // query captures includes the definition name and the definition implementation, but we only want the name (I found discrepencies in the naming structure for various languages, i.e. javascript names would be 'name' and typescript names would be 'name.definition)
+            if (name.includes("name") && lines[startLine]) {
+                formattedOutput += `│${lines[startLine]}\n`;
+            }
+            // Adds all the captured lines
+            // for (let i = startLine; i <= endLine; i++) {
+            // 	formattedOutput += `│${lines[i]}\n`
+            // }
+            //}
+            lastLine = endLine;
+        });
+    }
+    catch (error) {
+        console.log(`Error parsing file: ${error}\n`);
+    }
+    if (formattedOutput.length > 0) {
+        return `|----\n${formattedOutput}|----\n`;
+    }
+    return undefined;
+}
+exports.parseFile = parseFile;