@codebolt/agent 6.1.19 → 6.1.21

package/dist/unified/agent/agent.js

@@ -1,45 +1,160 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agent = void 0;
+exports.createAgent = createAgent;
+const codeboltjs_1 = __importDefault(require("@codebolt/codeboltjs"));
+const crypto_1 = require("crypto");
 const base_1 = require("../base");
 const agentStep_1 = require("../base/agentStep");
 const responseExecutor_1 = require("../base/responseExecutor");
 const promptContext_1 = require("../base/promptContext");
 const compactionOrchestrator_1 = require("../services/compaction/compactionOrchestrator");
 const agentToolLoader_1 = require("../utils/agentToolLoader");
+const processor_pieces_1 = require("../../processor-pieces");
+const DEFAULT_SYSTEM_PROMPT = 'Based on User Message send reply';
+function getProcessorKey(processor) {
+    var _a;
+    const candidate = processor;
+    if (typeof candidate.id === 'string' && candidate.id.length > 0) {
+        return candidate.id;
+    }
+    if (typeof candidate.name === 'string' && candidate.name.length > 0) {
+        return candidate.name;
+    }
+    if ((_a = candidate.constructor) === null || _a === void 0 ? void 0 : _a.name) {
+        return candidate.constructor.name;
+    }
+    return String(processor);
+}
+function mergeProcessors(defaults, custom) {
+    const merged = new Map();
+    for (const processor of defaults) {
+        merged.set(getProcessorKey(processor), processor);
+    }
+    for (const processor of custom) {
+        merged.set(getProcessorKey(processor), processor);
+    }
+    return Array.from(merged.values());
+}
+function createDefaultMessageModifiers(systemPrompt, allowedTools) {
+    return [
+        new processor_pieces_1.ChatHistoryMessageModifier({
+            enableChatHistory: true,
+            includeSystemMessages: false,
+        }),
+        new processor_pieces_1.EnvironmentContextModifier({ enableFullContext: true }),
+        new processor_pieces_1.DirectoryContextModifier(),
+        new processor_pieces_1.IdeContextModifier({
+            includeActiveFile: true,
+            includeOpenFiles: true,
+            includeCursorPosition: true,
+            includeSelectedText: true
+        }),
+        new processor_pieces_1.CoreSystemPromptModifier({ customSystemPrompt: systemPrompt }),
+        new processor_pieces_1.ToolInjectionModifier({
+            includeToolDescriptions: true,
+            ...(allowedTools ? { allowedTools } : {})
+        }),
+        new processor_pieces_1.AtFileProcessorModifier({ enableRecursiveSearch: true })
+    ];
+}
+function createDefaultPreInferenceProcessors() {
+    return [];
+}
+function createDefaultPostInferenceProcessors() {
+    return [];
+}
+function createDefaultPreToolCallProcessors() {
+    return [];
+}
+function createDefaultPostToolCallProcessors() {
+    return [];
+}
+function createDefaultUserMessage(message) {
+    const timestamp = Date.now();
+    return {
+        userMessage: message,
+        selectedAgent: {
+            id: 'codebolt-agent',
+            name: 'Codebolt Agent'
+        },
+        mentionedFiles: [],
+        mentionedFullPaths: [],
+        mentionedFolders: [],
+        mentionedMCPs: [],
+        uploadedImages: [],
+        mentionedAgents: [],
+        mentionedEnvironments: [],
+        messageId: `msg-${timestamp}`,
+        threadId: `thread-${timestamp}`
+    };
+}
+function collectProcessors(fromNested, fromTopLevel) {
+    return [
+        ...(fromNested !== null && fromNested !== void 0 ? fromNested : []),
+        ...(fromTopLevel !== null && fromTopLevel !== void 0 ? fromTopLevel : []),
+    ];
+}
 class Agent {
     constructor(config) {
-        var _a, _b, _c, _d, _e, _f;
-        const runtimeConfig = config;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const localToolRegistry = (0, agentToolLoader_1.createAgentLocalToolRegistry)(config.tools || []);
+        const includeDefaultModifiers = (_b = (_a = config.includeDefaultModifiers) !== null && _a !== void 0 ? _a : config.defaultProcessors) !== null && _b !== void 0 ? _b : true;
+        const includeDefaultProcessors = (_d = (_c = config.includeDefaultProcessors) !== null && _c !== void 0 ? _c : config.defaultProcessors) !== null && _d !== void 0 ? _d : true;
+        const customMessageModifiers = collectProcessors((_e = config.processors) === null || _e === void 0 ? void 0 : _e.messageModifiers, config.messageModifiers);
+        const defaultMessageModifiers = includeDefaultModifiers
+            ? createDefaultMessageModifiers(config.instructions || DEFAULT_SYSTEM_PROMPT, config.allowedTools)
+            : [];
         this.config = { ...config };
-        this.messageModifiers = ((_a = config.processors) === null || _a === void 0 ? void 0 : _a.messageModifiers) || [];
-        this.preInferenceProcessors = ((_b = config.processors) === null || _b === void 0 ? void 0 : _b.preInferenceProcessors) || [];
-        this.postInferenceProcessors = ((_c = config.processors) === null || _c === void 0 ? void 0 : _c.postInferenceProcessors) || [];
-        this.preToolCallProcessors = ((_d = config.processors) === null || _d === void 0 ? void 0 : _d.preToolCallProcessors) || [];
-        this.postToolCallProcessors = ((_e = config.processors) === null || _e === void 0 ? void 0 : _e.postToolCallProcessors) || [];
         this.enableLogging = config.enableLogging !== false;
-        this.compactionOrchestrator = new compactionOrchestrator_1.CompactionOrchestrator(runtimeConfig.compaction || {});
-        this.loopDetectionService = runtimeConfig.loopDetectionService;
-        this.maxTurns = (_f = runtimeConfig.maxTurns) !== null && _f !== void 0 ? _f : 25;
+        this.baseSystemPrompt = config.instructions || DEFAULT_SYSTEM_PROMPT;
+        this.context = config.context;
+        this.allowedTools = config.allowedTools;
+        this.messageModifiers = mergeProcessors(defaultMessageModifiers, customMessageModifiers);
+        this.preInferenceProcessors = mergeProcessors(includeDefaultProcessors ? createDefaultPreInferenceProcessors() : [], collectProcessors((_f = config.processors) === null || _f === void 0 ? void 0 : _f.preInferenceProcessors, config.preInferenceProcessors));
+        this.postInferenceProcessors = mergeProcessors(includeDefaultProcessors ? createDefaultPostInferenceProcessors() : [], collectProcessors((_g = config.processors) === null || _g === void 0 ? void 0 : _g.postInferenceProcessors, config.postInferenceProcessors));
+        this.preToolCallProcessors = mergeProcessors(includeDefaultProcessors ? createDefaultPreToolCallProcessors() : [], collectProcessors((_h = config.processors) === null || _h === void 0 ? void 0 : _h.preToolCallProcessors, config.preToolCallProcessors));
+        this.postToolCallProcessors = mergeProcessors(includeDefaultProcessors ? createDefaultPostToolCallProcessors() : [], collectProcessors((_j = config.processors) === null || _j === void 0 ? void 0 : _j.postToolCallProcessors, config.postToolCallProcessors));
+        this.compactionOrchestrator = new compactionOrchestrator_1.CompactionOrchestrator(config.compaction);
+        this.loopDetectionService = config.loopDetectionService;
+        this.maxTurns = (_l = (_k = config.maxTurns) !== null && _k !== void 0 ? _k : config.maxIterations) !== null && _l !== void 0 ? _l : 25;
+        this.localToolSchemas = localToolRegistry.schemas;
+        this.localToolsByExecutionName = localToolRegistry.byExecutionName;
+        this.runtimeToolSetId = `agent-${(0, crypto_1.randomUUID)()}`;
     }
-    async execute(reqMessage) {
-        var _a;
-        if (!reqMessage) {
-            return {
-                success: false,
-                result: null,
-                error: 'Request message is required'
-            };
-        }
+    async run(message, options) {
+        var _a, _b;
         try {
-            const promptGenerator = new base_1.InitialPromptGenerator({
-                processors: this.messageModifiers,
-                baseSystemPrompt: this.config.instructions || 'Based on User Message send reply',
-                enableLogging: this.enableLogging
-            });
-            let prompt = await promptGenerator.processMessage(reqMessage);
+            await this.registerRuntimeToolsForSearch();
+            const reqMessage = typeof message === 'string'
+                ? createDefaultUserMessage(message)
+                : message;
+            let prompt;
+            const contextToUse = this.resolveRunContext(options);
+            if (contextToUse) {
+                const promptGenerator = new base_1.InitialPromptGenerator({
+                    processors: this.getResumeMessageModifiers(),
+                    initialPrompt: contextToUse,
+                    enableLogging: this.enableLogging
+                });
+                prompt = await promptGenerator.processMessage(reqMessage);
+            }
+            else {
+                const promptGenerator = new base_1.InitialPromptGenerator({
+                    processors: this.messageModifiers,
+                    baseSystemPrompt: this.baseSystemPrompt,
+                    enableLogging: this.enableLogging
+                });
+                prompt = await promptGenerator.processMessage(reqMessage);
+            }
+            prompt = await this.hydratePromptFromServerCompaction(reqMessage, prompt);
             let completed = false;
             let turnNumber = 0;
+            let finalMessage;
+            const toolResults = [];
             while (!completed) {
                 turnNumber += 1;
                 if (turnNumber > this.maxTurns) {
@@ -82,6 +197,7 @@ class Agent {
                 const responseExecutor = new responseExecutor_1.ResponseExecutor({
                     preToolCallProcessors: this.preToolCallProcessors,
                     postToolCallProcessors: this.postToolCallProcessors,
+                    localToolsByExecutionName: this.localToolsByExecutionName,
                     ...(this.loopDetectionService
                         ? { loopDetectionService: this.loopDetectionService }
                         : {}),
@@ -94,10 +210,17 @@ class Agent {
                 });
                 completed = executionResult.completed;
                 prompt = executionResult.nextMessage;
+                finalMessage = executionResult.finalMessage;
+                toolResults.push(...((_b = executionResult.toolResults) !== null && _b !== void 0 ? _b : []));
             }
+            const state = { prompt };
             return {
                 success: true,
-                result: prompt
+                state,
+                toolResults,
+                ...(finalMessage !== undefined ? { finalMessage } : {}),
+                result: prompt,
+                context: prompt,
             };
         }
         catch (error) {
@@ -107,10 +230,84 @@ class Agent {
             }
             return {
                 success: false,
+                state: null,
+                toolResults: [],
                 result: null,
+                context: null,
                 error: errorMessage
             };
         }
+        finally {
+            await this.unregisterRuntimeToolsForSearch();
+        }
+    }
+    async registerRuntimeToolsForSearch() {
+        var _a, _b;
+        if (this.localToolSchemas.length === 0) {
+            return;
+        }
+        try {
+            await ((_b = (_a = codeboltjs_1.default.searchableAssets) === null || _a === void 0 ? void 0 : _a.registerRuntimeTools) === null || _b === void 0 ? void 0 : _b.call(_a, this.runtimeToolSetId, this.localToolSchemas));
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to register runtime tools for search:', error);
+            }
+        }
+    }
+    async unregisterRuntimeToolsForSearch() {
+        var _a, _b;
+        if (this.localToolSchemas.length === 0) {
+            return;
+        }
+        try {
+            await ((_b = (_a = codeboltjs_1.default.searchableAssets) === null || _a === void 0 ? void 0 : _a.unregisterRuntimeTools) === null || _b === void 0 ? void 0 : _b.call(_a, this.runtimeToolSetId));
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to unregister runtime tools for search:', error);
+            }
+        }
+    }
+    async processMessage(message, options) {
+        return this.run(message, options);
+    }
+    async execute(reqMessage) {
+        return this.run(reqMessage);
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getMessageModifiers() {
+        return [...this.messageModifiers];
+    }
+    getPreInferenceProcessors() {
+        return [...this.preInferenceProcessors];
+    }
+    getPostInferenceProcessors() {
+        return [...this.postInferenceProcessors];
+    }
+    getPreToolCallProcessors() {
+        return [...this.preToolCallProcessors];
+    }
+    getPostToolCallProcessors() {
+        return [...this.postToolCallProcessors];
+    }
+    resolveRunContext(options) {
+        var _a, _b, _c;
+        if (!options) {
+            return this.context;
+        }
+        if (this.isProcessedMessage(options)) {
+            return options;
+        }
+        return (_c = (_b = (_a = options.state) === null || _a === void 0 ? void 0 : _a.prompt) !== null && _b !== void 0 ? _b : options.context) !== null && _c !== void 0 ? _c : this.context;
+    }
+    getResumeMessageModifiers() {
+        return this.messageModifiers.filter((modifier) => { var _a; return ((_a = modifier.constructor) === null || _a === void 0 ? void 0 : _a.name) !== 'ChatHistoryMessageModifier'; });
+    }
+    isProcessedMessage(value) {
+        return 'message' in value && 'metadata' in value;
     }
     async applyCompaction(prompt) {
         const result = await this.compactionOrchestrator.compact((0, promptContext_1.getTranscriptMessages)(prompt));
@@ -130,6 +327,111 @@ class Agent {
             },
         };
     }
+    async hydratePromptFromServerCompaction(requestMessage, prompt) {
+        if (!requestMessage.threadId) {
+            return prompt;
+        }
+        try {
+            const response = await codeboltjs_1.default.thread.getThreadContextCompacted({
+                threadId: requestMessage.threadId,
+            });
+            if (!this.isServerCompactionCurrent(response === null || response === void 0 ? void 0 : response.context)) {
+                return prompt;
+            }
+            const compactedMessages = this.extractServerCompactedMessages(response === null || response === void 0 ? void 0 : response.compactedContext);
+            if (compactedMessages.length === 0) {
+                return prompt;
+            }
+            const currentRunMessages = this.extractCurrentRunMessages(requestMessage, prompt);
+            return {
+                ...(0, promptContext_1.replaceTranscriptMessages)(prompt, [
+                    ...compactedMessages,
+                    ...currentRunMessages,
+                ]),
+                metadata: {
+                    ...prompt.metadata,
+                    serverCompaction: {
+                        threadId: requestMessage.threadId,
+                        timestamp: new Date().toISOString(),
+                        messageCount: compactedMessages.length,
+                        currentRunMessageCount: currentRunMessages.length,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            if (this.enableLogging) {
+                console.error('[Agent] Failed to hydrate prompt from server compaction:', error);
+            }
+            return prompt;
+        }
+    }
+    isServerCompactionCurrent(context) {
+        if (!context || typeof context !== 'object') {
+            return true;
+        }
+        const metadata = context.metadata;
+        if (!metadata || typeof metadata !== 'object') {
+            return true;
+        }
+        const messageCount = Number(metadata.messageCount);
+        const lastCompactionMessageCount = Number(metadata.lastCompactionMessageCount);
+        if (!Number.isFinite(messageCount) || !Number.isFinite(lastCompactionMessageCount)) {
+            return true;
+        }
+        return messageCount <= lastCompactionMessageCount;
+    }
+    extractCurrentRunMessages(requestMessage, prompt) {
+        const transcriptMessages = (0, promptContext_1.getTranscriptMessages)(prompt);
+        const lastMessage = transcriptMessages[transcriptMessages.length - 1];
+        if (!lastMessage || lastMessage.role !== 'user') {
+            return [];
+        }
+        const requestedContent = requestMessage.userMessage || '';
+        if (!this.isCurrentRunUserMessage(lastMessage, requestedContent)) {
+            return [];
+        }
+        return [{ ...lastMessage }];
+    }
+    isCurrentRunUserMessage(message, requestedContent) {
+        if (typeof message.content === 'string') {
+            return message.content === requestedContent ||
+                message.content.startsWith(`${requestedContent}\n\n`);
+        }
+        if (!Array.isArray(message.content)) {
+            return false;
+        }
+        const firstTextPart = message.content.find((part) => !!part &&
+            typeof part === 'object' &&
+            !Array.isArray(part) &&
+            part.type === 'text' &&
+            typeof part.text === 'string');
+        return (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text) === requestedContent ||
+            (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text.startsWith(`${requestedContent}\n\n`)) ||
+            (requestedContent.length === 0 && (firstTextPart === null || firstTextPart === void 0 ? void 0 : firstTextPart.text) === 'Please use the attached image.');
+    }
+    extractServerCompactedMessages(compactedContext) {
+        var _a;
+        const data = typeof compactedContext === 'object' && compactedContext !== null
+            ? compactedContext.data
+            : undefined;
+        const messages = typeof data === 'object' && data !== null
+            ? ((_a = data.input) !== null && _a !== void 0 ? _a : data.messages)
+            : undefined;
+        if (!Array.isArray(messages)) {
+            return [];
+        }
+        return messages
+            .filter((message) => this.isServerCompactedMessage(message))
+            .map((message) => ({ ...message }));
+    }
+    isServerCompactedMessage(value) {
+        if (!value || typeof value !== 'object') {
+            return false;
+        }
+        const message = value;
+        return typeof message.role === 'string' && message.content !== undefined;
+    }
     async tryRecoverPrompt(prompt, error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         if (!this.compactionOrchestrator.getReactiveLayer().isRecoverableError(errorMessage)) {
@@ -155,8 +457,9 @@ class Agent {
     }
     async refreshAvailableTools(originalRequest, prompt) {
         var _a, _b, _c;
-        if (((_a = prompt.metadata) === null || _a === void 0 ? void 0 : _a['toolsInjected']) !== true ||
-            ((_b = prompt.metadata) === null || _b === void 0 ? void 0 : _b['toolsLocation']) !== 'Tool') {
+        const shouldRefreshDiscoveredTools = ((_a = prompt.metadata) === null || _a === void 0 ? void 0 : _a['toolsInjected']) === true &&
+            ((_b = prompt.metadata) === null || _b === void 0 ? void 0 : _b['toolsLocation']) === 'Tool';
+        if (!shouldRefreshDiscoveredTools && this.localToolSchemas.length === 0) {
             return prompt;
         }
         const existingTools = Array.isArray(prompt.message.tools)
@@ -166,13 +469,21 @@ class Agent {
             const mentionedMCPs = Array.isArray(originalRequest.mentionedMCPs)
                 ? originalRequest.mentionedMCPs
                 : [];
-            let refreshedTools = await (0, agentToolLoader_1.listAgentAvailableTools)(mentionedMCPs);
+            let refreshedTools = shouldRefreshDiscoveredTools
+                ? await (0, agentToolLoader_1.listAgentAvailableTools)(mentionedMCPs)
+                : [];
+            (0, agentToolLoader_1.assertNoLocalToolSchemaCollisions)(this.localToolSchemas, refreshedTools);
             const allowedToolNames = this.getAllowedToolNames(prompt);
             if (allowedToolNames && allowedToolNames.length > 0) {
                 const allowed = new Set(allowedToolNames);
                 refreshedTools = refreshedTools.filter((tool) => { var _a; return !!((_a = tool.function) === null || _a === void 0 ? void 0 : _a.name) && allowed.has(tool.function.name); });
             }
-            const mergedTools = (0, agentToolLoader_1.mergeTools)(refreshedTools, existingTools);
+            let localToolSchemas = this.localToolSchemas;
+            if (allowedToolNames && allowedToolNames.length > 0) {
+                const allowed = new Set(allowedToolNames);
+                localToolSchemas = localToolSchemas.filter((tool) => { var _a; return !!((_a = tool.function) === null || _a === void 0 ? void 0 : _a.name) && allowed.has(tool.function.name); });
+            }
+            const mergedTools = (0, agentToolLoader_1.mergeTools)(localToolSchemas, refreshedTools, existingTools);
             return {
                 ...prompt,
                 message: {
@@ -190,6 +501,9 @@ class Agent {
             };
         }
         catch (error) {
+            if (error instanceof agentToolLoader_1.LocalToolConfigurationError) {
+                throw error;
+            }
             if (this.enableLogging) {
                 console.error('[Agent] Failed to refresh tools:', error);
             }
@@ -199,45 +513,53 @@ class Agent {
     getAllowedToolNames(prompt) {
         var _a;
         const metadataAllowedTools = (_a = prompt.metadata) === null || _a === void 0 ? void 0 : _a['allowedTools'];
-        if (!Array.isArray(metadataAllowedTools)) {
-            return undefined;
+        if (Array.isArray(metadataAllowedTools)) {
+            const allowedToolNames = metadataAllowedTools.filter((toolName) => typeof toolName === 'string' && toolName.length > 0);
+            if (allowedToolNames.length > 0) {
+                return allowedToolNames;
+            }
         }
-        const allowedToolNames = metadataAllowedTools.filter((toolName) => typeof toolName === 'string' && toolName.length > 0);
-        return allowedToolNames.length > 0 ? allowedToolNames : undefined;
+        return this.allowedTools;
     }
     getRecoverableResponseError(response) {
-        var _a, _b, _c, _d;
+        var _a;
         const reactiveLayer = this.compactionOrchestrator.getReactiveLayer();
         const candidateMessages = this.collectResponseMessages(response);
         const recoverableMessage = candidateMessages.find((message) => reactiveLayer.isRecoverableError(message));
         if (recoverableMessage) {
             return recoverableMessage;
         }
-        const finishReasons = [
-            response.finish_reason,
-            ...((_a = response.choices) !== null && _a !== void 0 ? _a : []).map((choice) => choice.finish_reason),
-        ].filter((reason) => typeof reason === 'string');
+        const finishReasons = [response.finish_reason].filter((reason) => typeof reason === 'string');
         const hasLengthFinishReason = finishReasons.some((reason) => reason.toLowerCase() === 'length');
-        const hasToolCalls = ((_c = (_b = response.tool_calls) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0 ||
-            ((_d = response.choices) !== null && _d !== void 0 ? _d : []).some((choice) => { var _a, _b, _c; return ((_c = (_b = (_a = choice.message) === null || _a === void 0 ? void 0 : _a.tool_calls) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0; });
+        const hasToolCalls = ((_a = response.items) !== null && _a !== void 0 ? _a : []).some((item) => (item === null || item === void 0 ? void 0 : item.type) === 'function_call');
         if (hasLengthFinishReason && candidateMessages.length === 0 && !hasToolCalls) {
             return 'Too many tokens or token limit reached before producing usable output.';
         }
         return null;
     }
     collectResponseMessages(response) {
-        var _a, _b;
+        var _a;
         const messages = [];
-        if (typeof response.content === 'string' && response.content.trim().length > 0) {
-            messages.push(response.content.trim());
+        const outputText = response.output_text || response.content;
+        if (typeof outputText === 'string' && outputText.trim().length > 0) {
+            messages.push(outputText.trim());
         }
-        for (const choice of (_a = response.choices) !== null && _a !== void 0 ? _a : []) {
-            if (typeof ((_b = choice.message) === null || _b === void 0 ? void 0 : _b.content) === 'string' &&
-                choice.message.content.trim().length > 0) {
-                messages.push(choice.message.content.trim());
+        for (const item of (_a = response.items) !== null && _a !== void 0 ? _a : []) {
+            if ((item === null || item === void 0 ? void 0 : item.type) === 'message' && item.role === 'assistant') {
+                const content = item.content;
+                if (typeof content === 'string' && content.trim().length > 0) {
+                    messages.push(content.trim());
+                }
             }
         }
         return messages;
     }
 }
 exports.Agent = Agent;
+function createAgent(options) {
+    const normalizedOptions = { ...options };
+    if (normalizedOptions.instructions === undefined && options.systemPrompt !== undefined) {
+        normalizedOptions.instructions = options.systemPrompt;
+    }
+    return new Agent(normalizedOptions);
+}

package/dist/unified/agent/tools.d.ts

@@ -2,14 +2,14 @@
  * Tool creation utilities for the Unified Agent Framework
  */
 import { z, ZodType } from 'zod';
-import type { OpenAITool } from '../types/libTypes';
-import { ToolConfig, ToolInterface } from '@codebolt/types/agent';
+import type { Tool as OpenAITool } from '@codebolt/types/sdk';
+import { AgentLocalToolExecutionContext, ToolConfig, ToolInterface } from '@codebolt/types/agent';
 export declare class Tool implements ToolInterface {
     id: string;
     description: string;
     inputSchema: ZodType;
     outputSchema?: ZodType | undefined;
-    executionFunction: (context: unknown) => unknown;
+    executionFunction: (context: AgentLocalToolExecutionContext) => unknown;
     constructor(config: ToolConfig);
     execute(input: unknown, context: unknown): Promise<{
         success: boolean;
@@ -31,6 +31,20 @@ export declare class Tool implements ToolInterface {
      * @returns OpenAI function specification
      */
     toOpenAITool(): OpenAITool;
+    private getZodDef;
+    private getZodTypeName;
+    private getZodDescription;
+    private applyDescription;
+    private withDescriptionFrom;
+    private getObjectShape;
+    /**
+     * Converts a Zod schema to JSON Schema format for OpenAI functions.
+     *
+     * The converter intentionally checks Zod's schema metadata instead of
+     * relying only on instanceof. Local tools are often created in another
+     * workspace package with its own zod module instance, which makes
+     * instanceof checks fail even though the schema is valid.
+     */
     private zodSchemaToJsonSchema;
     /**
      * Converts individual Zod types to JSON Schema