@matterailab/orbcode 0.1.3

package/dist/tools/schemas/list_code_definition_names.js

@@ -0,0 +1,19 @@
+export default {
+    type: "function",
+    function: {
+        name: "list_code_definition_names",
+        description: "List definition names (classes, functions, methods, etc.) from source files to understand code structure. Works on a single file or across all top-level files in a directory.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Path to the file or directory to analyze, relative to the workspace",
+                },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/list_files.js

@@ -0,0 +1,23 @@
+export default {
+    type: "function",
+    function: {
+        name: "list_files",
+        description: "List files and directories within a given directory. Optionally recurse into subdirectories. Do not use this tool to confirm file creation; rely on user confirmation instead.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Directory path to inspect, relative to the workspace",
+                },
+                recursive: {
+                    type: ["boolean", "null"],
+                    description: "Set true to list contents recursively; omit or false to show only the top level",
+                },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/lsp.js

@@ -0,0 +1,46 @@
+export default {
+    type: "function",
+    function: {
+        name: "lsp",
+        description: `Interact with Language Server Protocol (LSP) servers to get code intelligence features like go-to-definition, find-references, hover information, and symbol search.
+
+Supported operations:
+- go_to_definition: Find where a symbol is defined
+- find_references: Find all references to a symbol across the codebase
+- hover: Get hover information (documentation, type info) for a symbol
+- document_symbol: Get all symbols (functions, classes, variables) in a document
+- workspace_symbol: Search for symbols across the entire workspace
+
+All operations require:
+- file_path: The absolute path to the file to operate on
+- line: The line number (1-based, as shown in editors)
+- character: The character offset (1-based, as shown in editors)
+
+Note: LSP servers must be configured for the file type. If no server is available, an error will be returned.`,
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                operation: {
+                    type: "string",
+                    description: "The LSP operation to perform",
+                    enum: ["go_to_definition", "find_references", "hover", "document_symbol", "workspace_symbol"],
+                },
+                file_path: {
+                    type: "string",
+                    description: "The absolute path to the file to operate on",
+                },
+                line: {
+                    type: "number",
+                    description: "The line number (1-based, as shown in editors)",
+                },
+                character: {
+                    type: "number",
+                    description: "The character offset (1-based, as shown in editors)",
+                },
+            },
+            required: ["operation", "file_path", "line", "character"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/multi_file_edit.js

@@ -0,0 +1,42 @@
+export default {
+    type: "function",
+    function: {
+        name: "multi_file_edit",
+        description: "Make multiple text replacements across one or more files in a single call. Use this tool whenever you have 2 or more edits to make, even if they are all in the same file. Each edit specifies its own file_path, old_string, and new_string. Edits within the same file are applied bottom-to-top to preserve line offsets. Returns per-edit success/failure results.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                edits: {
+                    type: "array",
+                    description: "Array of edit operations. Each edit must have file_path, old_string, new_string. Optionally include replace_all (boolean).",
+                    items: {
+                        type: "object",
+                        properties: {
+                            file_path: {
+                                type: "string",
+                                description: "Absolute path to the file to modify (e.g., /Users/username/project/src/file.ts)",
+                            },
+                            old_string: {
+                                type: "string",
+                                description: "Exact text to replace. Provide enough context for a unique match. Use an empty string to replace the entire file.",
+                            },
+                            new_string: {
+                                type: "string",
+                                description: "Replacement text. This will be inserted in place of the matched section. Can be an empty string to delete the match.",
+                            },
+                            replace_all: {
+                                type: "boolean",
+                                description: "Set to true to replace every occurrence of the matched text. Defaults to false (replace a single uniquely identified occurrence).",
+                            },
+                        },
+                        required: ["file_path", "old_string", "new_string"],
+                        additionalProperties: false,
+                    },
+                },
+            },
+            required: ["edits"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/new_task.js

@@ -0,0 +1,27 @@
+export default {
+    type: "function",
+    function: {
+        name: "new_task",
+        description: "Create a new task instance in a specified mode, supplying the initial instructions and optionally a starting todo list when required by settings.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                mode: {
+                    type: "string",
+                    description: "Slug of the mode to begin the new task in (e.g., code, debug, architect)",
+                },
+                message: {
+                    type: "string",
+                    description: "Initial user instructions or context for the new task",
+                },
+                todos: {
+                    type: ["string", "null"],
+                    description: "Optional initial todo list written as a markdown checklist; required when the workspace mandates todos",
+                },
+            },
+            required: ["mode", "message"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/read_file.js

@@ -0,0 +1,27 @@
+export const read_file_single = {
+    type: "function",
+    function: {
+        name: "read_file",
+        description: "Read a file and return its contents with line numbers. Use offset and limit to read specific portions efficiently. Default and maximum limit is 1000 lines to prevent context overflow.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Absolute path to the file to read (e.g., /Users/username/project/src/file.ts)",
+                },
+                offset: {
+                    type: ["number", "null"],
+                    description: "Starting line number (1-indexed). Defaults to 1 if not specified.",
+                },
+                limit: {
+                    type: ["number", "null"],
+                    description: "Maximum number of lines to read from offset. Default and maximum limit is 1000 lines.",
+                },
+            },
+            required: ["file_path"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/run_slash_command.js

@@ -0,0 +1,23 @@
+export default {
+    type: "function",
+    function: {
+        name: "run_slash_command",
+        description: "Execute a predefined slash command to receive detailed instructions or content for a common task.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                command: {
+                    type: "string",
+                    description: "Name of the slash command to run (e.g., init, test, deploy)",
+                },
+                args: {
+                    type: ["string", "null"],
+                    description: "Optional additional context or arguments for the command",
+                },
+            },
+            required: ["command"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/search_files.js

@@ -0,0 +1,27 @@
+export default {
+    type: "function",
+    function: {
+        name: "search_files",
+        description: "Run a regex search across files under a directory, returning matches with surrounding context.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Directory to search recursively, relative to the workspace",
+                },
+                regex: {
+                    type: "string",
+                    description: "Rust-compatible regular expression pattern to match",
+                },
+                file_pattern: {
+                    type: ["string"],
+                    description: "String glob to limit which files are searched (e.g., '*.ts')",
+                },
+            },
+            required: ["path", "regex", "file_pattern"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/switch_mode.js

@@ -0,0 +1,23 @@
+export default {
+    type: "function",
+    function: {
+        name: "switch_mode",
+        description: "Request a switch to a different assistant mode. The user must approve the change before it takes effect.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                mode_slug: {
+                    type: "string",
+                    description: "Slug of the mode to switch to (e.g., code, ask, architect)",
+                },
+                reason: {
+                    type: ["string", "null"],
+                    description: "Optional explanation for why the mode switch is needed",
+                },
+            },
+            required: ["mode_slug"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/update_todo_list.js

@@ -0,0 +1,19 @@
+export default {
+    type: "function",
+    function: {
+        name: "update_todo_list",
+        description: "Replace the entire todo list with an updated single-level markdown checklist that reflects the current plan and status. Always confirm completed work, keep unfinished items, add new actionable tasks, and follow the [ ], [x], [-] status rules.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                todos: {
+                    type: "string",
+                    description: "Full markdown checklist in execution order, using [ ] for pending, [x] for completed, and [-] for in progress",
+                },
+            },
+            required: ["todos"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/use_skill.js

@@ -0,0 +1,19 @@
+export default {
+    type: "function",
+    function: {
+        name: "use_skill",
+        description: "Use a specific skill to guide the task execution. This tool allows you to apply predefined skills stored in the workspace's .agent/skills directory. Each skill contains specialized instructions for performing specific tasks or following particular patterns.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                skill_name: {
+                    type: "string",
+                    description: "The name of the skill to use. Must match one of the available skills listed in the tool description.",
+                },
+            },
+            required: ["skill_name"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/web_fetch.js

@@ -0,0 +1,19 @@
+export default {
+    type: "function",
+    function: {
+        name: "web_fetch",
+        description: "Fetch content from a URL using curl. Use this when you need to scrape or retrieve content from a web page. Returns the raw HTML/text content from the URL.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The URL to fetch content from",
+                },
+            },
+            required: ["url"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/schemas/web_search.js

@@ -0,0 +1,19 @@
+export default {
+    type: "function",
+    function: {
+        name: "web_search",
+        description: "Search the web for information using a query. Returns a list of relevant results with URLs, titles, publish dates, and excerpts. Use this when you need to find specific information on the web.",
+        strict: true,
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The search query to find information on the web",
+                },
+            },
+            required: ["query"],
+            additionalProperties: false,
+        },
+    },
+};

package/dist/tools/types.js

@@ -0,0 +1,7 @@
+import * as path from "node:path";
+/** Resolve a possibly-relative path against the workspace. */
+export function resolveWorkspacePath(cwd, p) {
+    if (!p)
+        return cwd;
+    return path.isAbsolute(p) ? p : path.resolve(cwd, p);
+}