@codebolt/agent 6.1.21 → 6.1.23

package/dist/unified/base/responseExecutor.js

@@ -56,6 +56,26 @@ function extractDiscoveredToolSchemas(content) {
         .map(normalizeDiscoveredToolSchema)
         .filter((schema) => !!schema);
 }
+function isToolSearchOutput(content) {
+    return !!content &&
+        typeof content === 'object' &&
+        !Array.isArray(content) &&
+        content.type === 'tool_search_output';
+}
+function normalizeToolSearchOutput(content, toolCallId) {
+    const contentCallId = content['call_id'];
+    const contentStatus = content['status'];
+    return {
+        ...content,
+        type: 'tool_search_output',
+        call_id: typeof contentCallId === 'string' && contentCallId.length > 0
+            ? contentCallId
+            : toolCallId,
+        status: typeof contentStatus === 'string' && contentStatus.length > 0
+            ? contentStatus
+            : 'completed',
+    };
+}
 class ResponseExecutor {
     constructor(options) {
         this.preToolCallProcessors = [];
@@ -253,16 +273,8 @@ class ResponseExecutor {
         return [
             ...toolExecution.toolResults.map((toolResult) => {
                 const content = toolResult.content;
-                if (content &&
-                    typeof content === 'object' &&
-                    !Array.isArray(content) &&
-                    content.type === 'tool_search_output') {
-                    return {
-                        ...content,
-                        type: 'tool_search_output',
-                        call_id: content.call_id || toolResult.tool_call_id,
-                        status: content.status || 'completed',
-                    };
+                if (isToolSearchOutput(content)) {
+                    return normalizeToolSearchOutput(content, toolResult.tool_call_id);
                 }
                 return {
                     type: 'function_call_output',
@@ -467,6 +479,9 @@ class ResponseExecutor {
                         userMessage: String(toolCall.toolInput['task'] || toolCall.toolInput['userMessage'] || ''),
                         selectedAgent: toolCall.toolInput['selectedAgent'],
                         isGrouped: Boolean(toolCall.toolInput['isGrouped']),
+                        ...(toolCall.toolInput['llm'] && typeof toolCall.toolInput['llm'] === 'object'
+                            ? { llm: toolCall.toolInput['llm'] }
+                            : {}),
                         ...(typeof toolCall.toolInput['groupId'] === 'string'
                             ? { groupId: toolCall.toolInput['groupId'] }
                             : {}),
@@ -475,7 +490,9 @@ class ResponseExecutor {
             }
             else if (toolCall.toolName.startsWith('subagent--')) {
                 const task = toolCall.toolInput['task'];
-                await codeboltjs_1.default.agent.startAgent(toolCall.toolName.replace('subagent--', ''), typeof task === 'string' ? task : JSON.stringify(task));
+                await codeboltjs_1.default.agent.startAgent(toolCall.toolName.replace('subagent--', ''), typeof task === 'string' ? task : JSON.stringify(task), toolCall.toolInput['llm'] && typeof toolCall.toolInput['llm'] === 'object'
+                    ? { llm: toolCall.toolInput['llm'] }
+                    : undefined);
                 resultTuple = [false, 'tool result is successful'];
             }
             else {
@@ -505,7 +522,7 @@ class ResponseExecutor {
         }
     }
     async executeTool(toolName, toolInput, input) {
-        var _a, _b, _c, _d;
+        var _a, _b;
         const executionToolName = (0, agentToolLoader_1.resolveToolExecutionName)(toolName);
         const localTool = this.localToolsByExecutionName.get(executionToolName);
         if (localTool) {
@@ -521,15 +538,17 @@ class ResponseExecutor {
             }
             return [false, (_a = localResult.result) !== null && _a !== void 0 ? _a : ''];
         }
-        const parts = executionToolName.split('--');
-        const toolboxName = parts.length > 1 ? ((_b = parts[0]) !== null && _b !== void 0 ? _b : '') : 'codebolt';
-        const actualToolName = parts.length > 1 ? ((_c = parts[1]) !== null && _c !== void 0 ? _c : '') : ((_d = parts[0]) !== null && _d !== void 0 ? _d : '');
-        const { data } = await codeboltjs_1.default.mcp.executeTool(toolboxName, actualToolName, toolInput);
-        if (Array.isArray(data) && data.length >= 2) {
-            const [didUserReject, content] = data;
-            return [Boolean(didUserReject), content];
+        const toolGateway = codeboltjs_1.default.tools;
+        if (typeof (toolGateway === null || toolGateway === void 0 ? void 0 : toolGateway.execute) === 'function') {
+            const response = await toolGateway.execute(executionToolName, toolInput);
+            const data = (_b = response.data) !== null && _b !== void 0 ? _b : response.result;
+            if (Array.isArray(data) && data.length >= 2) {
+                const [didUserReject, content] = data;
+                return [Boolean(didUserReject), content];
+            }
+            return [false, data];
         }
-        return [false, data];
+        throw new Error('codebolt.tools.execute is required for runtime tool execution.');
     }
     parseToolResult(tool_call_id, content) {
         let parsedStructuredContent = content;
@@ -556,11 +575,8 @@ class ResponseExecutor {
         catch {
             // Preserve the raw tool result when it is not JSON.
         }
-        const contentForModel = (parsedStructuredContent &&
-            typeof parsedStructuredContent === 'object' &&
-            !Array.isArray(parsedStructuredContent) &&
-            parsedStructuredContent.type === 'tool_search_output')
-            ? parsedStructuredContent
+        const contentForModel = isToolSearchOutput(parsedStructuredContent)
+            ? normalizeToolSearchOutput(parsedStructuredContent, tool_call_id)
             : serializedContent;
         return {
             role: 'tool',
@@ -594,6 +610,9 @@ class ResponseExecutor {
                 const isToolSearch = toolName === 'tool_search' ||
                     toolName === 'codebolt--tool_search' ||
                     toolName.endsWith('--tool_search') ||
+                    toolName === 'get_available_tools_manifest' ||
+                    toolName === 'codebolt--get_available_tools_manifest' ||
+                    toolName.endsWith('--get_available_tools_manifest') ||
                     toolName === 'search_mcp_tool' ||
                     toolName === 'codebolt--search_mcp_tool' ||
                     toolName.endsWith('--search_mcp_tool') ||
@@ -616,7 +635,11 @@ class ResponseExecutor {
                     const rawName = schemaFunction === null || schemaFunction === void 0 ? void 0 : schemaFunction.name;
                     if (!rawName)
                         continue;
-                    const prefixedName = rawName.includes('--') ? rawName : `codebolt--${rawName}`;
+                    const isLocalToolName = this.localToolsByExecutionName.has(rawName) ||
+                        this.localToolsByExecutionName.has((0, agentToolLoader_1.resolveToolExecutionName)(rawName));
+                    const prefixedName = rawName.includes('--') || isLocalToolName || existingToolNames.has(rawName)
+                        ? rawName
+                        : `codebolt--${rawName}`;
                     if (existingToolNames.has(prefixedName))
                         continue;
                     const prefixedSchema = {

package/dist/unified/index.d.ts

@@ -19,6 +19,7 @@ export { CompressionCoordinator, type CompressionCoordinatorOptions, type Compre
 export { Agent, createAgent, type AgentOptions, type AgentRunResult, type AgentRunOptions, type AgentRunState, type CreateAgentOptions } from './agent/agent';
 export { Tool, createTool } from './agent/tools';
 export { Workflow } from './agent/workflow';
+export { listAgentRuntimeTools, type ToolSourceType, type RuntimeToolDescriptor, } from './utils/agentToolLoader';
 export { type OpenAIMessage, type OpenAITool, type ToolResult, type CodeboltAPI, type AgentExecutionResult, type StreamChunk, type StreamCallback } from './types/libTypes';
 export { type LLMConfig } from './types/libTypes';
 export { CompactionOrchestrator, type CompactionPipelineResult, } from './services/compaction/compactionOrchestrator';

package/dist/unified/index.js

@@ -10,7 +10,7 @@
  * The framework is designed to be modular, extensible, and easy to use.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenEstimator = exports.PostCompactCleanup = exports.ReactiveCompact = exports.AutoCompact = exports.ContextCollapse = exports.MicroCompact = exports.SnipCompact = exports.CompactionOrchestrator = exports.Workflow = exports.createTool = exports.Tool = exports.createAgent = exports.Agent = exports.CompressionCoordinator = exports.LoopType = exports.LoopDetectionService = exports.ResponseExecutor = exports.AgentStep = exports.InitialPromptGenerator = exports.createDefaultMessageProcessor = exports.UnifiedToolExecutionError = exports.UnifiedResponseExecutionError = exports.UnifiedStepExecutionError = exports.UnifiedMessageProcessingError = exports.UnifiedAgentError = void 0;
+exports.TokenEstimator = exports.PostCompactCleanup = exports.ReactiveCompact = exports.AutoCompact = exports.ContextCollapse = exports.MicroCompact = exports.SnipCompact = exports.CompactionOrchestrator = exports.listAgentRuntimeTools = exports.Workflow = exports.createTool = exports.Tool = exports.createAgent = exports.Agent = exports.CompressionCoordinator = exports.LoopType = exports.LoopDetectionService = exports.ResponseExecutor = exports.AgentStep = exports.InitialPromptGenerator = exports.createDefaultMessageProcessor = exports.UnifiedToolExecutionError = exports.UnifiedResponseExecutionError = exports.UnifiedStepExecutionError = exports.UnifiedMessageProcessingError = exports.UnifiedAgentError = void 0;
 // Error types
 var types_1 = require("./types/types");
 Object.defineProperty(exports, "UnifiedAgentError", { enumerable: true, get: function () { return types_1.UnifiedAgentError; } });
@@ -41,6 +41,8 @@ Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { re
 Object.defineProperty(exports, "createTool", { enumerable: true, get: function () { return tools_1.createTool; } });
 var workflow_1 = require("./agent/workflow");
 Object.defineProperty(exports, "Workflow", { enumerable: true, get: function () { return workflow_1.Workflow; } });
+var agentToolLoader_1 = require("./utils/agentToolLoader");
+Object.defineProperty(exports, "listAgentRuntimeTools", { enumerable: true, get: function () { return agentToolLoader_1.listAgentRuntimeTools; } });
 // Workflow step factories
 // Multi-layer compaction system
 var compactionOrchestrator_1 = require("./services/compaction/compactionOrchestrator");

package/dist/unified/services/compaction/autoCompact.d.ts

@@ -23,7 +23,7 @@ export interface AutoCompactOptions {
     modelTokenLimit?: number;
     /** Fraction of recent history to preserve after compression (default: 0.3) */
     preserveThreshold?: number;
-    /** LLM role for summarization calls (default: 'summarizer') */
+    /** LLM role for summarization calls */
     llmRole?: string;
     /** Enable logging (default: false) */
     enableLogging?: boolean;
@@ -40,6 +40,7 @@ export declare class AutoCompact implements CompactionLayer {
     private consecutiveFailures;
     private tracking;
     constructor(options?: AutoCompactOptions);
+    private normalizeLLMRole;
     shouldApply(ctx: CompactionContext): boolean;
     apply(ctx: CompactionContext): Promise<CompactionContext>;
     reset(): void;

package/dist/unified/services/compaction/autoCompact.js

@@ -25,7 +25,7 @@ const DEFAULT_MAX_CONSECUTIVE_FAILURES = 3;
 const DEFAULT_MODEL_TOKEN_LIMIT = 128000;
 class AutoCompact {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e;
         this.name = 'auto';
         this.consecutiveFailures = 0;
         this.options = {
@@ -33,10 +33,14 @@ class AutoCompact {
             maxConsecutiveFailures: (_b = options === null || options === void 0 ? void 0 : options.maxConsecutiveFailures) !== null && _b !== void 0 ? _b : DEFAULT_MAX_CONSECUTIVE_FAILURES,
             modelTokenLimit: (_c = options === null || options === void 0 ? void 0 : options.modelTokenLimit) !== null && _c !== void 0 ? _c : DEFAULT_MODEL_TOKEN_LIMIT,
             preserveThreshold: (_d = options === null || options === void 0 ? void 0 : options.preserveThreshold) !== null && _d !== void 0 ? _d : 0.3,
-            llmRole: (_e = options === null || options === void 0 ? void 0 : options.llmRole) !== null && _e !== void 0 ? _e : 'summarizer',
-            enableLogging: (_f = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _f !== void 0 ? _f : false,
+            llmRole: this.normalizeLLMRole(options === null || options === void 0 ? void 0 : options.llmRole),
+            enableLogging: (_e = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _e !== void 0 ? _e : false,
         };
     }
+    normalizeLLMRole(llmRole) {
+        const normalized = llmRole === null || llmRole === void 0 ? void 0 : llmRole.trim();
+        return normalized ? normalized : undefined;
+    }
     shouldApply(ctx) {
         // Don't auto-compact if context collapse is handling it
         if (ctx.contextCollapseEnabled) {
@@ -255,15 +259,19 @@ CRITICAL RULES:
 - Include the FULL original user request, not a paraphrase
 - Do not summarize away technical details
 - Focus on facts and specifics`;
-            const response = await codebolt.llm.inference({
-                messages: [
+            const inferencePayload = {
+                formatVersion: 'codebolt.llm.v2',
+                input: [
                     {
                         role: 'system',
                         content: 'You are a precise conversation compression assistant. Be comprehensive but concise.',
                     },
                     { role: 'user', content: prompt },
                 ],
-            });
+                ...(this.options.llmRole ? { llmrole: this.options.llmRole } : {}),
+            };
+            console.log('[AutoCompact] llm.inference payload:', inferencePayload);
+            const response = await codebolt.llm.inference(inferencePayload);
             // Extract summary from response
             let summary;
             if (typeof ((_a = response === null || response === void 0 ? void 0 : response.completion) === null || _a === void 0 ? void 0 : _a.output_text) === 'string') {

package/dist/unified/services/compaction/compactionOrchestrator.d.ts

@@ -42,6 +42,7 @@ export declare class CompactionOrchestrator {
     private readonly layerOrder;
     private readonly layers;
     constructor(options?: CompactionOrchestratorOptions);
+    private normalizeLLMRole;
     /**
      * Run the full compaction pipeline.
      * Each layer is checked and applied in priority order.

package/dist/unified/services/compaction/compactionOrchestrator.js

@@ -35,6 +35,7 @@ class CompactionOrchestrator {
             modelTokenLimit: (_a = options === null || options === void 0 ? void 0 : options.modelTokenLimit) !== null && _a !== void 0 ? _a : DEFAULT_MODEL_TOKEN_LIMIT,
             autoCompactEnabled: (_b = options === null || options === void 0 ? void 0 : options.autoCompactEnabled) !== null && _b !== void 0 ? _b : true,
             contextCollapseEnabled: (_c = options === null || options === void 0 ? void 0 : options.contextCollapseEnabled) !== null && _c !== void 0 ? _c : false,
+            llmRole: this.normalizeLLMRole(options === null || options === void 0 ? void 0 : options.llmRole),
             enableLogging: (_d = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _d !== void 0 ? _d : false,
         };
         this.snip = new snipCompact_1.SnipCompact({ enableLogging: this.options.enableLogging });
@@ -42,14 +43,17 @@ class CompactionOrchestrator {
         this.collapse = new contextCollapse_1.ContextCollapse({
             modelTokenLimit: this.options.modelTokenLimit,
             enableLogging: this.options.enableLogging,
+            ...(this.options.llmRole ? { llmRole: this.options.llmRole } : {}),
         });
         this.auto = new autoCompact_1.AutoCompact({
             modelTokenLimit: this.options.modelTokenLimit,
             enableLogging: this.options.enableLogging,
+            ...(this.options.llmRole ? { llmRole: this.options.llmRole } : {}),
         });
         this.reactive = new reactiveCompact_1.ReactiveCompact({
             modelTokenLimit: this.options.modelTokenLimit,
             enableLogging: this.options.enableLogging,
+            ...(this.options.llmRole ? { llmRole: this.options.llmRole } : {}),
         });
         this.cleanup = new postCompactCleanup_1.PostCompactCleanup({
             enableLogging: this.options.enableLogging,
@@ -63,6 +67,10 @@ class CompactionOrchestrator {
         ];
         this.layers = new Map(layerEntries);
     }
+    normalizeLLMRole(llmRole) {
+        const normalized = llmRole === null || llmRole === void 0 ? void 0 : llmRole.trim();
+        return normalized ? normalized : undefined;
+    }
     /**
      * Run the full compaction pipeline.
      * Each layer is checked and applied in priority order.

package/dist/unified/services/compaction/contextCollapse.d.ts

@@ -22,7 +22,7 @@ export interface ContextCollapseOptions {
     blockingThreshold?: number;
     /** Model token limit (default: 128000) */
     modelTokenLimit?: number;
-    /** LLM role for granular summarization (default: 'summarizer') */
+    /** LLM role for granular summarization */
     llmRole?: string;
     /** Max summaries to keep in the collapse store (default: 20) */
     maxSummaries?: number;
@@ -37,6 +37,7 @@ export declare class ContextCollapse implements CompactionLayer {
     /** Staged collapses waiting for API confirmation */
     private staged;
     constructor(options?: ContextCollapseOptions);
+    private normalizeLLMRole;
     shouldApply(ctx: CompactionContext): boolean;
     apply(ctx: CompactionContext): Promise<CompactionContext>;
     /**

package/dist/unified/services/compaction/contextCollapse.js

@@ -25,7 +25,7 @@ const DEFAULT_BLOCKING_THRESHOLD = 0.95;
 const MIN_COLLAPSE_TOKENS = 2000;
 class ContextCollapse {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e;
         this.name = 'collapse';
         /** The collapse store: ordered list of collapsed ranges */
         this.store = [];
@@ -35,11 +35,15 @@ class ContextCollapse {
             commitThreshold: (_a = options === null || options === void 0 ? void 0 : options.commitThreshold) !== null && _a !== void 0 ? _a : DEFAULT_COMMIT_THRESHOLD,
             blockingThreshold: (_b = options === null || options === void 0 ? void 0 : options.blockingThreshold) !== null && _b !== void 0 ? _b : DEFAULT_BLOCKING_THRESHOLD,
             modelTokenLimit: (_c = options === null || options === void 0 ? void 0 : options.modelTokenLimit) !== null && _c !== void 0 ? _c : 128000,
-            llmRole: (_d = options === null || options === void 0 ? void 0 : options.llmRole) !== null && _d !== void 0 ? _d : 'summarizer',
-            maxSummaries: (_e = options === null || options === void 0 ? void 0 : options.maxSummaries) !== null && _e !== void 0 ? _e : 20,
-            enableLogging: (_f = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _f !== void 0 ? _f : false,
+            llmRole: this.normalizeLLMRole(options === null || options === void 0 ? void 0 : options.llmRole),
+            maxSummaries: (_d = options === null || options === void 0 ? void 0 : options.maxSummaries) !== null && _d !== void 0 ? _d : 20,
+            enableLogging: (_e = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _e !== void 0 ? _e : false,
         };
     }
+    normalizeLLMRole(llmRole) {
+        const normalized = llmRole === null || llmRole === void 0 ? void 0 : llmRole.trim();
+        return normalized ? normalized : undefined;
+    }
     shouldApply(ctx) {
         if (!ctx.contextCollapseEnabled)
             return false;
@@ -238,12 +242,16 @@ class ContextCollapse {
             const prompt = `Summarize this conversation segment concisely. Preserve: key decisions, file paths, code changes, errors encountered, current task state. Be factual and specific.
 
 ${historyText}`;
-            const response = await codebolt.llm.inference({
-                messages: [
+            const inferencePayload = {
+                formatVersion: 'codebolt.llm.v2',
+                input: [
                     { role: 'system', content: 'You are a precise conversation summarizer. Be concise but complete.' },
                     { role: 'user', content: prompt },
                 ],
-            });
+                ...(this.options.llmRole ? { llmrole: this.options.llmRole } : {}),
+            };
+            console.log('[ContextCollapse] llm.inference payload:', inferencePayload);
+            const response = await codebolt.llm.inference(inferencePayload);
             const summary = ((_a = response === null || response === void 0 ? void 0 : response.completion) === null || _a === void 0 ? void 0 : _a.output_text) || ((_b = response === null || response === void 0 ? void 0 : response.completion) === null || _b === void 0 ? void 0 : _b.content);
             if (summary && typeof summary === 'string' && summary.trim().length > 0) {
                 return summary.trim();

package/dist/unified/services/compaction/reactiveCompact.d.ts

@@ -18,6 +18,8 @@ export interface ReactiveCompactOptions {
     retryLimit?: number;
     /** Model token limit (default: 128000) */
     modelTokenLimit?: number;
+    /** LLM role for emergency summarization calls */
+    llmRole?: string;
     /** Enable logging (default: false) */
     enableLogging?: boolean;
 }
@@ -34,6 +36,7 @@ export declare class ReactiveCompact implements CompactionLayer {
     private hasAttemptedThisTurn;
     private retryCount;
     constructor(options?: ReactiveCompactOptions);
+    private normalizeLLMRole;
     shouldApply(_ctx: CompactionContext): boolean;
     apply(_ctx: CompactionContext): Promise<CompactionContext>;
     reset(): void;

package/dist/unified/services/compaction/reactiveCompact.js

@@ -39,9 +39,14 @@ class ReactiveCompact {
         this.options = {
             retryLimit: (_a = options === null || options === void 0 ? void 0 : options.retryLimit) !== null && _a !== void 0 ? _a : 1,
             modelTokenLimit: (_b = options === null || options === void 0 ? void 0 : options.modelTokenLimit) !== null && _b !== void 0 ? _b : 128000,
+            llmRole: this.normalizeLLMRole(options === null || options === void 0 ? void 0 : options.llmRole),
             enableLogging: (_c = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _c !== void 0 ? _c : false,
         };
     }
+    normalizeLLMRole(llmRole) {
+        const normalized = llmRole === null || llmRole === void 0 ? void 0 : llmRole.trim();
+        return normalized ? normalized : undefined;
+    }
     shouldApply(_ctx) {
         // Reactive only fires when explicitly triggered by an error
         // via tryRecoverFromError(), not proactively
@@ -266,15 +271,19 @@ class ReactiveCompact {
 
 Conversation:
 ${historyText}`;
-            const response = await codebolt.llm.inference({
-                messages: [
+            const inferencePayload = {
+                formatVersion: 'codebolt.llm.v2',
+                input: [
                     {
                         role: 'system',
                         content: 'Create an extremely concise summary. Focus on actionable facts only.',
                     },
                     { role: 'user', content: prompt },
                 ],
-            });
+                ...(this.options.llmRole ? { llmrole: this.options.llmRole } : {}),
+            };
+            console.log('[ReactiveCompact] llm.inference payload:', inferencePayload);
+            const response = await codebolt.llm.inference(inferencePayload);
             let summary;
             if (typeof ((_a = response === null || response === void 0 ? void 0 : response.completion) === null || _a === void 0 ? void 0 : _a.output_text) === 'string') {
                 summary = response.completion.output_text;

package/dist/unified/types/libTypes.d.ts

@@ -175,22 +175,193 @@ export interface CodeboltAPI {
         /** Stream LLM response */
         stream(params: LLMInferenceParams): AsyncIterable<LLMResponse>;
     };
-    /** MCP (Micro-Component Platform) operations */
-    mcp: {
-        /** Execute an MCP tool */
-        executeTool(toolName: string, params: unknown): Promise<{
-            data: unknown;
+    /** Generic tool operations */
+    tools?: {
+        /** List CodeBoltJS built-in tools */
+        listBuiltInTools(options?: {
+            namespace?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                tools: Array<{
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                }>;
+            };
+        }>;
+        /** List external tools: MCP, plugin, and project-local */
+        listExternalTools(options?: {
+            namespace?: string;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            sourceId?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                tools: Array<{
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                }>;
+            };
+        }>;
+        /** List all tools callable in the current runtime context */
+        listRuntimeTools(options?: {
+            includeBuiltIn?: boolean;
+            includeExternal?: boolean;
+            includeAgentLocal?: boolean;
+            namespace?: string;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            sourceId?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                tools: Array<{
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                }>;
+            };
+        }>;
+        /** List tool namespaces such as fs, terminal, browser, or an MCP server name */
+        listToolNamespaces(options?: {
+            includeBuiltIn?: boolean;
+            includeExternal?: boolean;
+            includeAgentLocal?: boolean;
+            namespace?: string;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            sourceId?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                namespaces: Array<{
+                    namespace: string;
+                    sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    toolCount?: number;
+                }>;
+            };
+        }>;
+        /** List tools in one namespace */
+        listToolsByNamespace(namespace: string, options?: {
+            includeBuiltIn?: boolean;
+            includeExternal?: boolean;
+            includeAgentLocal?: boolean;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            sourceId?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                tools: Array<{
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                }>;
+            };
+        }>;
+        /** List tool sources such as built-in, MCP, plugin, project-local, and agent-local identities */
+        listToolSources(options?: {
+            includeBuiltIn?: boolean;
+            includeExternal?: boolean;
+            includeAgentLocal?: boolean;
+            namespace?: string;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            sourceId?: string;
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                sources: Array<{
+                    sourceId: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    displayName?: string;
+                    namespaces?: string[];
+                    toolCount?: number;
+                }>;
+            };
+        }>;
+        /** List tools supplied by one source identity */
+        listToolsBySource(sourceId: string, options?: {
+            includeBuiltIn?: boolean;
+            includeExternal?: boolean;
+            includeAgentLocal?: boolean;
+            namespace?: string;
+            sourceType?: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+            grep?: string;
+            limit?: number;
+        }): Promise<{
+            data: {
+                tools: Array<{
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                }>;
+            };
         }>;
-        /** List registered project-local and plugin MCP tools */
-        getRegisteredTools(): Promise<{
-            data?: {
-                tools: OpenAITool[];
+        /** Get one runtime tool descriptor */
+        getRuntimeTool(name: string): Promise<{
+            data: {
+                tool?: {
+                    name: string;
+                    toolName: string;
+                    namespace: string;
+                    sourceType: 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+                    sourceId?: string;
+                    displayName?: string;
+                    description?: string;
+                    inputSchema: Record<string, unknown>;
+                };
             };
         }>;
-        /** List available MCP tools */
-        listTools(): Promise<string[]>;
-        /** Get tool schema */
-        getToolSchema(toolName: string): Promise<OpenAITool>;
+        /** Execute a tool by runtime name */
+        execute(toolName: string, params?: unknown, options?: {
+            namespace?: string;
+            sourceId?: string;
+        }): Promise<{
+            data?: unknown;
+            result?: unknown;
+        }>;
+    };
+    /** MCP server lifecycle/configuration operations */
+    mcp: {
+        getEnabledMCPServers(): Promise<unknown>;
+        getLocalMCPServers(): Promise<unknown>;
+        getMentionedMCPServers(userMessage: unknown): Promise<unknown>;
+        searchAvailableMCPServers(query: string): Promise<unknown>;
+        configureMCPServer(name: string, config: Record<string, unknown>): Promise<unknown>;
+        getMcpList(): Promise<unknown>;
+        getEnabledMcps(): Promise<unknown>;
     };
     /** File system operations */
     fs: {
@@ -206,7 +377,9 @@ export interface CodeboltAPI {
     /** Agent operations */
     agent?: {
         /** Start a sub-agent */
-        startAgent(agentName: string, params: unknown): Promise<{
+        startAgent(agentName: string, params: unknown, options?: {
+            llm?: unknown;
+        }): Promise<{
             data: unknown;
         }>;
         /** List available agents */