@codebolt/agent 6.1.20 → 6.1.22

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;
@@ -213,7 +217,7 @@ class ContextCollapse {
         ];
     }
     async generateGranularSummary(messages) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b;
         const estimator = new types_1.TokenEstimator();
         // For small ranges, create a structural summary without LLM
         const tokenCount = estimator.estimateForMessages(messages);
@@ -238,13 +242,17 @@ 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 },
                 ],
-            });
-            const summary = ((_a = response === null || response === void 0 ? void 0 : response.completion) === null || _a === void 0 ? void 0 : _a.content) || ((_e = (_d = (_c = (_b = response === null || response === void 0 ? void 0 : response.completion) === null || _b === void 0 ? void 0 : _b.choices) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.message) === null || _e === void 0 ? void 0 : _e.content);
+                ...(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
@@ -235,7 +240,7 @@ class ReactiveCompact {
         ];
     }
     async forceCompact(messages) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b;
         try {
             // eslint-disable-next-line @typescript-eslint/no-require-imports
             const codebolt = require('@codebolt/codeboltjs');
@@ -266,21 +271,25 @@ 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.content) === 'string') {
-                summary = response.completion.content;
+            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;
             }
-            else if ((_e = (_d = (_c = (_b = response === null || response === void 0 ? void 0 : response.completion) === null || _b === void 0 ? void 0 : _b.choices) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.message) === null || _e === void 0 ? void 0 : _e.content) {
-                summary = response.completion.choices[0].message.content;
+            else if (typeof ((_b = response === null || response === void 0 ? void 0 : response.completion) === null || _b === void 0 ? void 0 : _b.content) === 'string') {
+                summary = response.completion.content;
             }
             if (!summary || summary.trim().length === 0) {
                 return null;

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

@@ -175,16 +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>;
+                }>;
+            };
+        }>;
+        /** 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>;
+                };
+            };
+        }>;
+        /** Execute a tool by runtime name */
+        execute(toolName: string, params?: unknown, options?: {
+            namespace?: string;
+            sourceId?: string;
+        }): Promise<{
+            data?: unknown;
+            result?: unknown;
         }>;
-        /** List available MCP tools */
-        listTools(): Promise<string[]>;
-        /** Get tool schema */
-        getToolSchema(toolName: string): Promise<OpenAITool>;
+    };
+    /** 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: {
@@ -200,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 */

package/dist/unified/utils/agentToolLoader.d.ts

@@ -5,6 +5,19 @@ type ToolResponse = {
         tools?: unknown;
     } | unknown;
 };
+export type ToolSourceType = 'built-in' | 'mcp' | 'plugin' | 'project-local' | 'agent-local' | 'unknown';
+export interface RuntimeToolDescriptor {
+    name: string;
+    toolName: string;
+    namespace: string;
+    sourceType: ToolSourceType;
+    sourceId?: string;
+    displayName?: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
 export declare class LocalToolConfigurationError extends Error {
     constructor(message: string);
 }
@@ -15,10 +28,13 @@ export interface AgentLocalToolRegistry {
 export declare function normalizeToolForModel(tool: Tool): Tool;
 export declare function resolveToolExecutionName(modelToolName: string): string;
 export declare function normalizeToolResponse(response: ToolResponse | undefined): Tool[];
+export declare function normalizeRuntimeToolResponse(response: ToolResponse | undefined): RuntimeToolDescriptor[];
 export declare function mergeTools(...toolGroups: Tool[][]): Tool[];
+export declare function mergeRuntimeTools(...toolGroups: RuntimeToolDescriptor[][]): RuntimeToolDescriptor[];
 export declare function createAgentLocalToolRegistry(localTools?: AgentLocalTool[]): AgentLocalToolRegistry;
 export declare function assertNoLocalToolSchemaCollisions(localSchemas: Tool[], externalSchemas: Tool[]): void;
 export declare function listProjectLocalTools(): Promise<Tool[]>;
-export declare function listAgentAvailableTools(mentionedMCPs?: unknown[]): Promise<Tool[]>;
+export declare function listAgentAvailableTools(mentionedNamespaces?: unknown[]): Promise<Tool[]>;
+export declare function listAgentRuntimeTools(localTools?: AgentLocalTool[]): Promise<RuntimeToolDescriptor[]>;
 export declare function appendUniqueTools(targetTools: Tool[], toolsToAppend: Tool[]): void;
 export {};