@codebolt/codeboltjs 5.0.9 → 5.1.12

package/dist/tools/index.js

@@ -20,9 +20,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowserNavigateTool = exports.gitTools = exports.GitCloneTool = exports.GitDiffTool = exports.GitLogsTool = exports.GitBranchTool = exports.GitCheckoutTool = exports.GitPullTool = exports.GitPushTool = exports.GitCommitTool = exports.GitAddTool = exports.GitStatusTool = exports.GitInitTool = exports.terminalTools = exports.ExecuteCommandTool = exports.searchTools = exports.ListCodeDefinitionNamesTool = exports.SearchMcpToolTool = exports.CodebaseSearchTool = exports.SearchFilesTool = exports.GrepTool = exports.GlobTool = exports.EventQueueAcknowledgeTool = exports.EventQueueWaitNextTool = exports.EventQueueGetPendingTool = exports.EventQueueGetStatsTool = exports.EventQueueSendMessageTool = exports.EventQueueAddEventTool = exports.agentEventQueueTools = exports.dbmemoryTools = exports.webSearchTools = exports.ragTools = exports.memoryIngestionTools = exports.reviewMergeRequestTools = exports.roadmapTools = exports.kvStoreTools = exports.actionPlanTools = exports.actionBlockTools = exports.fileTools = exports.ReadManyFilesTool = exports.ListDirectoryTool = exports.EditTool = exports.WriteFileTool = exports.ReadFileTool = exports.defaultRegistry = exports.ToolRegistry = exports.Kind = exports.BaseDeclarativeTool = exports.DeclarativeTool = exports.BaseToolInvocation = void 0;
-exports.todoTools = exports.memoryTools = exports.llmTools = exports.projectTools = exports.stateTools = exports.orchestratorTools = exports.OrchestratorUpdateStatusTool = exports.OrchestratorDeleteTool = exports.OrchestratorUpdateSettingsTool = exports.OrchestratorUpdateTool = exports.OrchestratorCreateTool = exports.OrchestratorGetSettingsTool = exports.OrchestratorGetTool = exports.OrchestratorListTool = exports.taskTools = exports.TaskExecuteTool = exports.TaskAssignTool = exports.TaskGetTool = exports.TaskListTool = exports.TaskDeleteTool = exports.TaskUpdateTool = exports.TaskCreateTool = exports.threadTools = exports.ThreadUpdateStatusTool = exports.ThreadGetMessagesTool = exports.ThreadDeleteTool = exports.ThreadUpdateTool = exports.ThreadStartTool = exports.ThreadGetTool = exports.ThreadListTool = exports.ThreadCreateBackgroundTool = exports.ThreadCreateStartTool = exports.ThreadCreateTool = exports.agentTools = exports.AgentDetailsTool = exports.AgentListTool = exports.AgentStartTool = exports.AgentFindTool = exports.browserTools = exports.BrowserSearchTool = exports.BrowserEnterTool = exports.BrowserCloseTool = exports.BrowserGetUrlTool = exports.BrowserGetMarkdownTool = exports.BrowserGetHtmlTool = exports.BrowserGetContentTool = exports.BrowserScrollTool = exports.BrowserTypeTool = exports.BrowserClickTool = exports.BrowserScreenshotTool = void 0;
-exports.allTools = exports.completionTools = exports.utilsTools = exports.userMessageUtilitiesTools = exports.userMessageManagerTools = exports.requirementPlanTools = exports.projectStructureUpdateRequestTools = exports.persistentMemoryTools = exports.outputParsersTools = exports.knowledgeGraphTools = exports.hookTools = exports.fsTools = exports.eventLogTools = exports.episodicMemoryTools = exports.autoTestingTools = exports.groupFeedbackTools = exports.contextRuleEngineTools = exports.contextAssemblyTools = exports.backgroundChildThreadsTools = exports.codemapTools = exports.codebaseSearchTools = exports.agentPortfolioTools = exports.agentDeliberationTools = exports.historyTools = exports.codeutilsTools = exports.debugTools = exports.vectordbTools = exports.tokenizerTools = exports.contextTools = exports.adminTools = exports.reviewTools = exports.collaborationTools = exports.testingTools = exports.calendarTools = exports.jobTools = exports.planningTools = exports.knowledgeTools = exports.mcpTools = exports.capabilityTools = exports.chatTools = void 0;
+exports.SearchMcpToolTool = exports.CodebaseSearchTool = exports.SearchFilesTool = exports.GrepTool = exports.GlobTool = exports.EventQueueAcknowledgeTool = exports.EventQueueWaitNextTool = exports.EventQueueGetPendingTool = exports.EventQueueGetStatsTool = exports.EventQueueSendMessageTool = exports.EventQueueAddEventTool = exports.agentEventQueueTools = exports.EnvironmentSendMessageTool = exports.EnvironmentStatisticsTool = exports.EnvironmentGetRunningProvidersTool = exports.EnvironmentGetLocalProvidersTool = exports.EnvironmentStatusTool = exports.EnvironmentRestartTool = exports.EnvironmentStopTool = exports.EnvironmentStartTool = exports.EnvironmentDeleteTool = exports.EnvironmentUpdateTool = exports.EnvironmentCreateTool = exports.EnvironmentGetTool = exports.EnvironmentListTool = exports.environmentTools = exports.dbmemoryTools = exports.webSearchTools = exports.ragTools = exports.memoryIngestionTools = exports.reviewMergeRequestTools = exports.roadmapTools = exports.kvStoreTools = exports.actionPlanTools = exports.actionBlockTools = exports.fileTools = exports.ReadManyFilesTool = exports.ListDirectoryTool = exports.EditTool = exports.WriteFileTool = exports.ReadFileTool = exports.ToolSearchTool = exports.toolSearchTools = exports.ToolSearchEngine = exports.defaultRegistry = exports.ToolRegistry = exports.Kind = exports.BaseDeclarativeTool = exports.DeclarativeTool = exports.BaseToolInvocation = void 0;
+exports.TaskGetTool = exports.TaskListTool = exports.TaskDeleteTool = exports.TaskUpdateTool = exports.TaskCreateTool = exports.threadTools = exports.ThreadUpdateStatusTool = exports.ThreadGetMessagesTool = exports.ThreadDeleteTool = exports.ThreadUpdateTool = exports.ThreadStartTool = exports.ThreadGetTool = exports.ThreadListTool = exports.ThreadCreateBackgroundTool = exports.ThreadCreateStartTool = exports.ThreadCreateTool = exports.agentTools = exports.AgentDetailsTool = exports.AgentListTool = exports.AgentStartTool = exports.AgentFindTool = exports.browserTools = exports.BrowserSearchTool = exports.BrowserEnterTool = exports.BrowserCloseTool = exports.BrowserGetUrlTool = exports.BrowserGetMarkdownTool = exports.BrowserGetHtmlTool = exports.BrowserGetContentTool = exports.BrowserScrollTool = exports.BrowserTypeTool = exports.BrowserClickTool = exports.BrowserScreenshotTool = exports.BrowserNavigateTool = exports.gitTools = exports.GitCloneTool = exports.GitDiffTool = exports.GitLogsTool = exports.GitBranchTool = exports.GitCheckoutTool = exports.GitPullTool = exports.GitPushTool = exports.GitCommitTool = exports.GitAddTool = exports.GitStatusTool = exports.GitInitTool = exports.terminalTools = exports.ExecuteCommandTool = exports.searchTools = exports.ListCodeDefinitionNamesTool = void 0;
+exports.persistentMemoryTools = exports.outputParsersTools = exports.knowledgeGraphTools = exports.hookTools = exports.fsTools = exports.eventLogTools = exports.episodicMemoryTools = exports.autoTestingTools = exports.groupFeedbackTools = exports.contextRuleEngineTools = exports.contextAssemblyTools = exports.backgroundChildThreadsTools = exports.codemapTools = exports.codebaseSearchTools = exports.agentPortfolioTools = exports.agentDeliberationTools = exports.historyTools = exports.codeutilsTools = exports.debugTools = exports.vectordbTools = exports.tokenizerTools = exports.contextTools = exports.adminTools = exports.reviewTools = exports.collaborationTools = exports.testingTools = exports.calendarTools = exports.jobTools = exports.planningTools = exports.knowledgeTools = exports.mcpTools = exports.capabilityTools = exports.chatTools = exports.todoTools = exports.memoryTools = exports.llmTools = exports.projectTools = exports.stateTools = exports.orchestratorTools = exports.OrchestratorUpdateStatusTool = exports.OrchestratorDeleteTool = exports.OrchestratorUpdateSettingsTool = exports.OrchestratorUpdateTool = exports.OrchestratorCreateTool = exports.OrchestratorGetSettingsTool = exports.OrchestratorGetTool = exports.OrchestratorListTool = exports.taskTools = exports.TaskExecuteTool = exports.TaskAssignTool = void 0;
+exports.allTools = exports.completionTools = exports.utilsTools = exports.userMessageUtilitiesTools = exports.userMessageManagerTools = exports.requirementPlanTools = exports.projectStructureUpdateRequestTools = void 0;
 // Export types
 __exportStar(require("./types"), exports);
 // Export base classes
@@ -35,6 +36,13 @@ Object.defineProperty(exports, "Kind", { enumerable: true, get: function () { re
 var registry_1 = require("./registry");
 Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
 Object.defineProperty(exports, "defaultRegistry", { enumerable: true, get: function () { return registry_1.defaultRegistry; } });
+// Export tool search engine
+var tool_search_1 = require("./tool-search");
+Object.defineProperty(exports, "ToolSearchEngine", { enumerable: true, get: function () { return tool_search_1.ToolSearchEngine; } });
+// Export toolSearch tools
+var toolSearch_1 = require("./toolSearch");
+Object.defineProperty(exports, "toolSearchTools", { enumerable: true, get: function () { return toolSearch_1.toolSearchTools; } });
+Object.defineProperty(exports, "ToolSearchTool", { enumerable: true, get: function () { return toolSearch_1.ToolSearchTool; } });
 // Export utilities
 __exportStar(require("./utils"), exports);
 // Export file tools
@@ -72,6 +80,22 @@ Object.defineProperty(exports, "webSearchTools", { enumerable: true, get: functi
 // Export dbmemory tools
 var dbmemory_1 = require("./dbmemory");
 Object.defineProperty(exports, "dbmemoryTools", { enumerable: true, get: function () { return dbmemory_1.dbmemoryTools; } });
+// Export environment tools
+var environment_1 = require("./environment");
+Object.defineProperty(exports, "environmentTools", { enumerable: true, get: function () { return environment_1.environmentTools; } });
+Object.defineProperty(exports, "EnvironmentListTool", { enumerable: true, get: function () { return environment_1.EnvironmentListTool; } });
+Object.defineProperty(exports, "EnvironmentGetTool", { enumerable: true, get: function () { return environment_1.EnvironmentGetTool; } });
+Object.defineProperty(exports, "EnvironmentCreateTool", { enumerable: true, get: function () { return environment_1.EnvironmentCreateTool; } });
+Object.defineProperty(exports, "EnvironmentUpdateTool", { enumerable: true, get: function () { return environment_1.EnvironmentUpdateTool; } });
+Object.defineProperty(exports, "EnvironmentDeleteTool", { enumerable: true, get: function () { return environment_1.EnvironmentDeleteTool; } });
+Object.defineProperty(exports, "EnvironmentStartTool", { enumerable: true, get: function () { return environment_1.EnvironmentStartTool; } });
+Object.defineProperty(exports, "EnvironmentStopTool", { enumerable: true, get: function () { return environment_1.EnvironmentStopTool; } });
+Object.defineProperty(exports, "EnvironmentRestartTool", { enumerable: true, get: function () { return environment_1.EnvironmentRestartTool; } });
+Object.defineProperty(exports, "EnvironmentStatusTool", { enumerable: true, get: function () { return environment_1.EnvironmentStatusTool; } });
+Object.defineProperty(exports, "EnvironmentGetLocalProvidersTool", { enumerable: true, get: function () { return environment_1.EnvironmentGetLocalProvidersTool; } });
+Object.defineProperty(exports, "EnvironmentGetRunningProvidersTool", { enumerable: true, get: function () { return environment_1.EnvironmentGetRunningProvidersTool; } });
+Object.defineProperty(exports, "EnvironmentStatisticsTool", { enumerable: true, get: function () { return environment_1.EnvironmentStatisticsTool; } });
+Object.defineProperty(exports, "EnvironmentSendMessageTool", { enumerable: true, get: function () { return environment_1.EnvironmentSendMessageTool; } });
 // Export agentEventQueue tools
 var agentEventQueue_1 = require("./agentEventQueue");
 Object.defineProperty(exports, "agentEventQueueTools", { enumerable: true, get: function () { return agentEventQueue_1.agentEventQueueTools; } });
@@ -385,6 +409,7 @@ const codebaseSearch_2 = require("./codebaseSearch");
 const codemap_2 = require("./codemap");
 const backgroundChildThreads_2 = require("./backgroundChildThreads");
 const agentEventQueue_2 = require("./agentEventQueue");
+const environment_2 = require("./environment");
 const contextAssembly_2 = require("./contextAssembly");
 const contextRuleEngine_2 = require("./contextRuleEngine");
 const groupFeedback_2 = require("./groupFeedback");
@@ -401,6 +426,7 @@ const requirementPlan_2 = require("./requirementPlan");
 const userMessageManager_2 = require("./userMessageManager");
 const userMessageUtilities_2 = require("./userMessageUtilities");
 const utils_2 = require("./utils");
+const toolSearch_2 = require("./toolSearch");
 /**
  * All available tools combined
  */
@@ -457,7 +483,7 @@ exports.allTools = [
     // ...episodicMemoryTools,
     // ...eventLogTools,
     // ...fsTools,
-    // ...hookTools,
+    // ...hookTools,x
     // ...knowledgeGraphTools,
     // ...outputParsersTools,
     // ...persistentMemoryTools,
@@ -465,14 +491,18 @@ exports.allTools = [
     ...requirementPlan_2.requirementPlanTools,
     // ...userMessageUtilitiesTools,
     // ...utilsTools,
-    // ...agentEventQueueTools,
+    ...agentEventQueue_2.agentEventQueueTools,
     ...completion_2.completionTools,
+    ...environment_2.environmentTools,
+    ...toolSearch_2.toolSearchTools,
 ];
 /**
  * Create and populate the default tools registry
  */
 const toolsRegistry = new registry_2.ToolRegistry();
 toolsRegistry.registerTools(exports.allTools);
+// Initialize the ToolSearchTool with all registered tools so it can search them
+toolSearch_2.ToolSearchTool.setTools(exports.allTools);
 /**
  * Tools module providing LLM-ready tool definitions
  */
@@ -509,6 +539,14 @@ const tools = {
      * Get tool names
      */
     getToolNames: () => toolsRegistry.getToolNames(),
+    /**
+     * Search for tools matching a query using full-text search (powered by MiniSearch)
+     */
+    searchTools: (query, options) => toolsRegistry.searchTools(query, options),
+    /**
+     * Get auto-complete suggestions for a partial tool query
+     */
+    suggestTools: (query, options) => toolsRegistry.suggestTools(query, options),
     // Tool categories for convenience
     file: file_2.fileTools,
     search: search_2.searchTools,
@@ -568,5 +606,7 @@ const tools = {
     utils: utils_2.utilsTools,
     agentEventQueue: agentEventQueue_2.agentEventQueueTools,
     completion: completion_2.completionTools,
+    environment: environment_2.environmentTools,
+    toolSearch: toolSearch_2.toolSearchTools,
 };
 exports.default = tools;

package/dist/tools/registry.d.ts

@@ -2,11 +2,14 @@
  * Tool Registry for managing and executing tools
  */
 import type { AnyDeclarativeTool, ToolResult, OpenAIToolSchema, OpenAIFunctionCall } from './types';
+import { type ToolSearchResult, type ToolSearchOptions } from './tool-search';
 /**
  * Registry for managing tools
  */
 export declare class ToolRegistry {
     private tools;
+    private searchEngine;
+    private searchIndexDirty;
     /**
      * Register a tool with the registry
      * @param tool - The tool to register
@@ -83,6 +86,24 @@ export declare class ToolRegistry {
      * Clear all registered tools
      */
     clear(): void;
+    /**
+     * Ensure the search index is up to date
+     */
+    private ensureSearchIndex;
+    /**
+     * Search for tools matching a query using full-text search
+     * @param query - The search query (e.g. "create environment", "file read", "git commit")
+     * @param options - Search options (limit, fuzzy, prefix, kind filter, boost)
+     * @returns Array of matching tools sorted by relevance
+     */
+    searchTools(query: string, options?: ToolSearchOptions): ToolSearchResult[];
+    /**
+     * Get auto-complete suggestions for a partial query
+     * @param query - The partial query to get suggestions for
+     * @param options - Search options (limit, fuzzy, kind filter)
+     * @returns Array of suggested tool matches
+     */
+    suggestTools(query: string, options?: ToolSearchOptions): ToolSearchResult[];
 }
 /**
  * Default global registry instance

package/dist/tools/registry.js

@@ -5,12 +5,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultRegistry = exports.ToolRegistry = void 0;
 const types_1 = require("./types");
+const tool_search_1 = require("./tool-search");
 /**
  * Registry for managing tools
  */
 class ToolRegistry {
     constructor() {
         this.tools = new Map();
+        this.searchEngine = new tool_search_1.ToolSearchEngine();
+        this.searchIndexDirty = true;
     }
     /**
      * Register a tool with the registry
@@ -21,6 +24,7 @@ class ToolRegistry {
             console.warn(`Tool "${tool.name}" is already registered. Overwriting.`);
         }
         this.tools.set(tool.name, tool);
+        this.searchIndexDirty = true;
     }
     /**
      * Register multiple tools at once
@@ -37,7 +41,10 @@ class ToolRegistry {
      * @returns true if the tool was found and removed
      */
     unregisterTool(name) {
-        return this.tools.delete(name);
+        const result = this.tools.delete(name);
+        if (result)
+            this.searchIndexDirty = true;
+        return result;
     }
     /**
      * Get a tool by name
@@ -189,6 +196,36 @@ class ToolRegistry {
      */
     clear() {
         this.tools.clear();
+        this.searchIndexDirty = true;
+    }
+    /**
+     * Ensure the search index is up to date
+     */
+    ensureSearchIndex() {
+        if (this.searchIndexDirty) {
+            this.searchEngine.buildIndex(this.tools);
+            this.searchIndexDirty = false;
+        }
+    }
+    /**
+     * Search for tools matching a query using full-text search
+     * @param query - The search query (e.g. "create environment", "file read", "git commit")
+     * @param options - Search options (limit, fuzzy, prefix, kind filter, boost)
+     * @returns Array of matching tools sorted by relevance
+     */
+    searchTools(query, options) {
+        this.ensureSearchIndex();
+        return this.searchEngine.search(query, options);
+    }
+    /**
+     * Get auto-complete suggestions for a partial query
+     * @param query - The partial query to get suggestions for
+     * @param options - Search options (limit, fuzzy, kind filter)
+     * @returns Array of suggested tool matches
+     */
+    suggestTools(query, options) {
+        this.ensureSearchIndex();
+        return this.searchEngine.suggest(query, options);
     }
 }
 exports.ToolRegistry = ToolRegistry;

package/dist/tools/tool-search.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool Search Engine - Full-text search over registered tools using MiniSearch
+ */
+import type { AnyDeclarativeTool } from './types';
+export interface ToolSearchResult {
+    /** Tool name (internal identifier) */
+    name: string;
+    /** User-friendly display name */
+    displayName: string;
+    /** Tool description */
+    description: string;
+    /** Tool kind/category */
+    kind: string;
+    /** Search relevance score */
+    score: number;
+}
+export interface ToolSearchOptions {
+    /** Maximum number of results to return (default: 10) */
+    limit?: number;
+    /** Enable fuzzy matching (default: 0.2) */
+    fuzzy?: number | boolean;
+    /** Enable prefix matching (default: true) */
+    prefix?: boolean;
+    /** Filter by tool kind */
+    kind?: string;
+    /** Field-specific boost weights */
+    boost?: Record<string, number>;
+}
+export declare class ToolSearchEngine {
+    private miniSearch;
+    private indexed;
+    constructor();
+    /**
+     * Build the search index from a map of tools
+     */
+    buildIndex(tools: Map<string, AnyDeclarativeTool>): void;
+    /**
+     * Search for tools matching a query
+     */
+    search(query: string, options?: ToolSearchOptions): ToolSearchResult[];
+    /**
+     * Get auto-complete suggestions for a partial query
+     */
+    suggest(query: string, options?: ToolSearchOptions): ToolSearchResult[];
+    /**
+     * Get the number of indexed tools
+     */
+    get size(): number;
+}

package/dist/tools/tool-search.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Tool Search Engine - Full-text search over registered tools using MiniSearch
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolSearchEngine = void 0;
+const minisearch_1 = __importDefault(require("minisearch"));
+class ToolSearchEngine {
+    constructor() {
+        this.indexed = false;
+        this.miniSearch = new minisearch_1.default({
+            fields: ['name', 'displayName', 'description', 'kind', 'parameterNames'],
+            storeFields: ['name', 'displayName', 'description', 'kind'],
+            searchOptions: {
+                boost: { displayName: 3, description: 2, name: 1.5, kind: 1, parameterNames: 0.5 },
+                fuzzy: 0.2,
+                prefix: true,
+            },
+            tokenize: (text) => {
+                // Split on spaces, underscores, hyphens, and camelCase boundaries
+                return text
+                    .replace(/([a-z])([A-Z])/g, '$1 $2')
+                    .replace(/[_\-]/g, ' ')
+                    .toLowerCase()
+                    .split(/\s+/)
+                    .filter(t => t.length > 0);
+            },
+        });
+    }
+    /**
+     * Build the search index from a map of tools
+     */
+    buildIndex(tools) {
+        var _a, _b;
+        // Clear existing index
+        if (this.indexed) {
+            this.miniSearch.removeAll();
+        }
+        const documents = [];
+        for (const [name, tool] of tools) {
+            const params = (_b = (_a = tool.schema) === null || _a === void 0 ? void 0 : _a.function) === null || _b === void 0 ? void 0 : _b.parameters;
+            const paramNames = (params === null || params === void 0 ? void 0 : params.properties)
+                ? Object.keys(params.properties).filter(p => p !== 'explanation').join(' ')
+                : '';
+            documents.push({
+                id: name,
+                name: tool.name,
+                displayName: tool.displayName,
+                description: tool.description,
+                kind: tool.kind,
+                parameterNames: paramNames,
+            });
+        }
+        this.miniSearch.addAll(documents);
+        this.indexed = true;
+    }
+    /**
+     * Search for tools matching a query
+     */
+    search(query, options) {
+        var _a;
+        if (!this.indexed) {
+            return [];
+        }
+        const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : 10;
+        const searchOpts = {};
+        if ((options === null || options === void 0 ? void 0 : options.fuzzy) !== undefined) {
+            searchOpts.fuzzy = options.fuzzy;
+        }
+        if ((options === null || options === void 0 ? void 0 : options.prefix) !== undefined) {
+            searchOpts.prefix = options.prefix;
+        }
+        if (options === null || options === void 0 ? void 0 : options.boost) {
+            searchOpts.boost = options.boost;
+        }
+        if (options === null || options === void 0 ? void 0 : options.kind) {
+            const kindFilter = options.kind;
+            searchOpts.filter = (result) => result.kind === kindFilter;
+        }
+        const results = this.miniSearch.search(query, searchOpts);
+        return results.slice(0, limit).map(r => ({
+            name: r.name,
+            displayName: r.displayName,
+            description: r.description,
+            kind: r.kind,
+            score: r.score,
+        }));
+    }
+    /**
+     * Get auto-complete suggestions for a partial query
+     */
+    suggest(query, options) {
+        var _a;
+        if (!this.indexed) {
+            return [];
+        }
+        const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : 5;
+        const suggestOpts = {};
+        if ((options === null || options === void 0 ? void 0 : options.fuzzy) !== undefined) {
+            suggestOpts.fuzzy = options.fuzzy;
+        }
+        if (options === null || options === void 0 ? void 0 : options.kind) {
+            const kindFilter = options.kind;
+            suggestOpts.filter = (result) => result.kind === kindFilter;
+        }
+        const suggestions = this.miniSearch.autoSuggest(query, suggestOpts);
+        // autoSuggest returns grouped suggestions; map them to tool results
+        const toolNames = new Set();
+        const results = [];
+        for (const suggestion of suggestions) {
+            // Search for this suggestion to get actual tool matches
+            const searchResults = this.miniSearch.search(suggestion.suggestion, { prefix: true });
+            for (const r of searchResults) {
+                if (!toolNames.has(r.name) && results.length < limit) {
+                    toolNames.add(r.name);
+                    results.push({
+                        name: r.name,
+                        displayName: r.displayName,
+                        description: r.description,
+                        kind: r.kind,
+                        score: r.score * suggestion.score,
+                    });
+                }
+            }
+            if (results.length >= limit)
+                break;
+        }
+        return results;
+    }
+    /**
+     * Get the number of indexed tools
+     */
+    get size() {
+        return this.miniSearch.documentCount;
+    }
+}
+exports.ToolSearchEngine = ToolSearchEngine;

package/dist/tools/toolSearch/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tool Search Tool - Searches for available tools using full-text search (MiniSearch)
+ */
+export { ToolSearchTool, type ToolSearchToolParams } from './tool-search-tool';
+import { ToolSearchTool } from './tool-search-tool';
+/**
+ * All tool search tools
+ */
+export declare const toolSearchTools: ToolSearchTool[];

package/dist/tools/toolSearch/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Tool Search Tool - Searches for available tools using full-text search (MiniSearch)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolSearchTools = exports.ToolSearchTool = void 0;
+var tool_search_tool_1 = require("./tool-search-tool");
+Object.defineProperty(exports, "ToolSearchTool", { enumerable: true, get: function () { return tool_search_tool_1.ToolSearchTool; } });
+const tool_search_tool_2 = require("./tool-search-tool");
+/**
+ * All tool search tools
+ */
+exports.toolSearchTools = [
+    new tool_search_tool_2.ToolSearchTool(),
+];

package/dist/tools/toolSearch/tool-search-tool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tool Search Tool - An LLM-callable tool that searches for available tools
+ * Uses MiniSearch for full-text fuzzy search over all registered tools
+ */
+import type { ToolInvocation, ToolResult } from '../types';
+import { BaseDeclarativeTool } from '../base-tool';
+import type { AnyDeclarativeTool } from '../types';
+export interface ToolSearchToolParams {
+    /** One sentence explanation of why this tool is being used */
+    explanation?: string;
+    /** The search query to find relevant tools (e.g. "create environment", "read file", "git commit") */
+    query: string;
+    /** Maximum number of results to return (default: 10) */
+    limit?: number;
+    /** Filter results by tool kind (e.g. "read", "edit", "execute", "delete") */
+    kind?: string;
+}
+export declare class ToolSearchTool extends BaseDeclarativeTool<ToolSearchToolParams, ToolResult> {
+    static readonly Name: string;
+    constructor();
+    /**
+     * Initialize the search index with a set of tools.
+     * Call this before using the tool so the search engine knows what tools are available.
+     * @param tools - Array of tools to index
+     */
+    static setTools(tools: AnyDeclarativeTool[]): void;
+    /**
+     * Get the currently indexed tools
+     */
+    static getIndexedTools(): AnyDeclarativeTool[];
+    protected createInvocation(params: ToolSearchToolParams): ToolInvocation<ToolSearchToolParams, ToolResult>;
+}

package/dist/tools/toolSearch/tool-search-tool.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Tool Search Tool - An LLM-callable tool that searches for available tools
+ * Uses MiniSearch for full-text fuzzy search over all registered tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolSearchTool = void 0;
+const types_1 = require("../types");
+const base_tool_1 = require("../base-tool");
+const tool_search_1 = require("../tool-search");
+// Singleton search engine instance shared across invocations
+let searchEngine = null;
+let indexedTools = [];
+class ToolSearchInvocation extends base_tool_1.BaseToolInvocation {
+    constructor(params) {
+        super(params);
+    }
+    async execute() {
+        var _a;
+        try {
+            if (!searchEngine) {
+                return {
+                    llmContent: 'Tool search index not initialized. Call ToolSearchTool.setTools() first.',
+                    returnDisplay: 'Error: search index not initialized',
+                    error: {
+                        message: 'Tool search index not initialized',
+                        type: types_1.ToolErrorType.EXECUTION_FAILED,
+                    },
+                };
+            }
+            const results = searchEngine.search(this.params.query, {
+                limit: (_a = this.params.limit) !== null && _a !== void 0 ? _a : 10,
+                kind: this.params.kind,
+            });
+            if (results.length === 0) {
+                return {
+                    llmContent: `No tools found matching "${this.params.query}".`,
+                    returnDisplay: `No tools found for: ${this.params.query}`,
+                };
+            }
+            let output = `Found ${results.length} tool(s) matching "${this.params.query}":\n\n`;
+            for (const r of results) {
+                output += `- **${r.name}** (${r.kind}): ${r.description} [score: ${r.score.toFixed(2)}]\n`;
+            }
+            return {
+                llmContent: output,
+                returnDisplay: `Found ${results.length} tool(s)`,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                llmContent: `Error searching tools: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: { message: errorMessage, type: types_1.ToolErrorType.EXECUTION_FAILED },
+            };
+        }
+    }
+}
+class ToolSearchTool extends base_tool_1.BaseDeclarativeTool {
+    constructor() {
+        super(ToolSearchTool.Name, 'ToolSearch', 'Searches for available tools by name, description, or functionality using full-text search. Use this to discover which tools are available for a given task.', types_1.Kind.Search, {
+            properties: {
+                explanation: {
+                    description: "One sentence explanation as to why this tool is being used, and how it contributes to the goal.",
+                    type: 'string',
+                },
+                query: {
+                    description: 'The search query to find relevant tools (e.g. "create environment", "read file", "git commit").',
+                    type: 'string',
+                },
+                limit: {
+                    description: 'Maximum number of results to return (default: 10).',
+                    type: 'number',
+                },
+                kind: {
+                    description: 'Filter results by tool kind: "read", "edit", "delete", "execute", "search", "fetch", "other".',
+                    type: 'string',
+                },
+            },
+            required: ['query'],
+            type: 'object',
+        });
+    }
+    /**
+     * Initialize the search index with a set of tools.
+     * Call this before using the tool so the search engine knows what tools are available.
+     * @param tools - Array of tools to index
+     */
+    static setTools(tools) {
+        indexedTools = tools;
+        searchEngine = new tool_search_1.ToolSearchEngine();
+        const toolMap = new Map();
+        for (const tool of tools) {
+            toolMap.set(tool.name, tool);
+        }
+        searchEngine.buildIndex(toolMap);
+    }
+    /**
+     * Get the currently indexed tools
+     */
+    static getIndexedTools() {
+        return indexedTools;
+    }
+    createInvocation(params) {
+        return new ToolSearchInvocation(params);
+    }
+}
+exports.ToolSearchTool = ToolSearchTool;
+ToolSearchTool.Name = 'tool_search';

package/dist/types/agentDeliberation.d.ts

@@ -5,6 +5,7 @@ export declare enum AgentDeliberationAction {
     UPDATE = "agentdeliberation.update",
     RESPOND = "agentdeliberation.respond",
     VOTE = "agentdeliberation.vote",
+    VOTE_OPTION = "agentdeliberation.vote-option",
     WINNER = "agentdeliberation.winner",
     SUMMARY = "agentdeliberation.summary"
 }
@@ -15,10 +16,17 @@ export declare enum AgentDeliberationResponseType {
     UPDATE_RESPONSE = "agentdeliberation.update.response",
     RESPOND_RESPONSE = "agentdeliberation.respond.response",
     VOTE_RESPONSE = "agentdeliberation.vote.response",
+    VOTE_OPTION_RESPONSE = "agentdeliberation.vote-option.response",
     WINNER_RESPONSE = "agentdeliberation.winner.response",
     SUMMARY_RESPONSE = "agentdeliberation.summary.response"
 }
 export type DeliberationStatus = 'draft' | 'collecting-responses' | 'voting' | 'completed' | 'closed';
+export interface DeliberationOption {
+    id: string;
+    text: string;
+    proposedBy: string;
+    voteCount: number;
+}
 export interface Deliberation {
     id: string;
     type: DeliberationType;
@@ -36,6 +44,7 @@ export interface Deliberation {
     summary?: string;
     summaryAuthorId?: string;
     summaryAuthorName?: string;
+    options?: DeliberationOption[];
     createdAt: string;
     updatedAt: string;
     deletedAt?: string;
@@ -65,6 +74,10 @@ export interface ICreateDeliberationParams {
     creatorName: string;
     participants?: string[];
     status?: DeliberationStatus;
+    options?: {
+        text: string;
+        proposedBy: string;
+    }[];
 }
 export interface IGetDeliberationParams {
     id: string;
@@ -92,7 +105,8 @@ export interface IRespondParams {
 }
 export interface IVoteParams {
     deliberationId: string;
-    responseId: string;
+    responseId?: string;
+    optionId?: string;
     voterId: string;
     voterName: string;
 }