@phuetz/code-buddy 1.1.0 → 1.3.0

package/dist/codebuddy/providers/provider-chatgpt-responses.d.ts

@@ -161,6 +161,11 @@ interface BuildRequestBodyOpts {
     input: ResponsesInputItem[];
     tools: CodeBuddyTool[];
     reasoningEffort?: string;
+    /**
+     * Accepted for Provider interface parity, but deliberately not serialized:
+     * the ChatGPT Codex backend rejects `max_output_tokens` with 400.
+     */
+    maxTokens?: number;
     promptCacheKey?: string;
     /** When true, ask the backend to emit encrypted reasoning blobs so we
      *  can re-inject them next turn (preserves chain-of-thought across

package/dist/codebuddy/providers/provider-chatgpt-responses.js

@@ -164,6 +164,7 @@ export class ChatGptResponsesProvider {
             input,
             tools,
             reasoningEffort,
+            maxTokens: opts.maxTokens,
             promptCacheKey: this.promptCacheKey,
             // Only ask for encrypted reasoning when reasoning effort is set —
             // saves bandwidth on plain Q&A turns.
@@ -458,6 +459,11 @@ export async function* parseSseStream(body, model, onReasoningItem, idleTimeoutM
     const decoder = new TextDecoder();
     let buffer = '';
     let chunkIndex = 0;
+    // Monotonic index per function_call so the downstream message-reducer keeps
+    // parallel tool calls in separate slots. Hardcoding 0 made every parallel
+    // call merge into one — names/call_ids/arguments concatenated — producing a
+    // 100+ char call_id the Responses backend rejects (max 64) on the next turn.
+    let functionCallIndex = 0;
     const makeChunk = (delta, finishReason) => ({
         id: `chatcmpl-codex-${chunkIndex++}`,
         object: 'chat.completion.chunk',
@@ -546,7 +552,7 @@ export async function* parseSseStream(body, model, onReasoningItem, idleTimeoutM
                     if (item.name && item.call_id) {
                         yield makeChunk({
                             tool_calls: [{
-                                    index: 0,
+                                    index: functionCallIndex++,
                                     id: item.call_id,
                                     type: 'function',
                                     function: {

package/dist/codebuddy/providers/provider-gemini-native.js

@@ -218,7 +218,7 @@ export class GeminiNativeProvider {
         // Build generationConfig with optional thinkingConfig for Gemini 3.x
         const generationConfig = {
             temperature: opts?.temperature ?? 0.7,
-            maxOutputTokens: this.defaultMaxTokens,
+            maxOutputTokens: opts?.maxTokens ?? this.defaultMaxTokens,
         };
         // Add thinkingLevel for Gemini 3.x models (never mix with budget_tokens)
         // Use explicitly passed level, or fall back to the default from settings

package/dist/codebuddy/providers/provider-openai-compat.d.ts

@@ -57,6 +57,10 @@ export declare class OpenAICompatProvider implements Provider {
      * Derive a human-readable provider name from the base URL.
      */
     getProviderName(): string;
+    private getOpenRouterProviderRouting;
+    private setListProviderOption;
+    private readBooleanEnv;
+    private readEnv;
     /**
      * Get prompt cache statistics
      */
@@ -84,6 +88,7 @@ export declare class OpenAICompatProvider implements Provider {
     private isXaiProvider;
     /** Gate legacy search_parameters by provider compatibility. */
     private shouldIncludeSearchParameters;
+    private getOllamaReasoningEffort;
     private isAsyncIterableStream;
     private isNonStreamingChatResponse;
     private nonStreamingResponseToChunks;

package/dist/codebuddy/providers/provider-openai-compat.js

@@ -104,6 +104,61 @@ export class OpenAICompatProvider {
             return 'Local';
         return 'API';
     }
+    getOpenRouterProviderRouting() {
+        if (!this.baseURL.toLowerCase().includes('openrouter.ai'))
+            return undefined;
+        const provider = {};
+        this.setListProviderOption(provider, 'only', 'OPENROUTER_PROVIDER_ONLY', 'CODEBUDDY_OPENROUTER_PROVIDER_ONLY');
+        this.setListProviderOption(provider, 'ignore', 'OPENROUTER_PROVIDER_IGNORE', 'CODEBUDDY_OPENROUTER_PROVIDER_IGNORE');
+        this.setListProviderOption(provider, 'order', 'OPENROUTER_PROVIDER_ORDER', 'CODEBUDDY_OPENROUTER_PROVIDER_ORDER');
+        const sort = this.readEnv('OPENROUTER_PROVIDER_SORT', 'CODEBUDDY_OPENROUTER_PROVIDER_SORT')?.toLowerCase();
+        if (sort && ['price', 'throughput', 'latency'].includes(sort)) {
+            provider.sort = sort;
+        }
+        const dataCollection = this.readEnv('OPENROUTER_PROVIDER_DATA_COLLECTION', 'CODEBUDDY_OPENROUTER_PROVIDER_DATA_COLLECTION')?.toLowerCase();
+        if (dataCollection && ['allow', 'deny'].includes(dataCollection)) {
+            provider.data_collection = dataCollection;
+        }
+        const requireParameters = this.readBooleanEnv('OPENROUTER_PROVIDER_REQUIRE_PARAMETERS', 'CODEBUDDY_OPENROUTER_PROVIDER_REQUIRE_PARAMETERS');
+        if (requireParameters !== undefined) {
+            provider.require_parameters = requireParameters;
+        }
+        const allowFallbacks = this.readBooleanEnv('OPENROUTER_PROVIDER_ALLOW_FALLBACKS', 'CODEBUDDY_OPENROUTER_PROVIDER_ALLOW_FALLBACKS');
+        if (allowFallbacks !== undefined) {
+            provider.allow_fallbacks = allowFallbacks;
+        }
+        return Object.keys(provider).length > 0 ? provider : undefined;
+    }
+    setListProviderOption(provider, field, ...keys) {
+        const value = this.readEnv(...keys);
+        if (!value)
+            return;
+        const items = value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+        if (items.length > 0) {
+            provider[field] = items;
+        }
+    }
+    readBooleanEnv(...keys) {
+        const value = this.readEnv(...keys)?.toLowerCase();
+        if (!value)
+            return undefined;
+        if (['1', 'true', 'yes', 'on'].includes(value))
+            return true;
+        if (['0', 'false', 'no', 'off'].includes(value))
+            return false;
+        return undefined;
+    }
+    readEnv(...keys) {
+        for (const key of keys) {
+            const value = process.env[key]?.trim();
+            if (value)
+                return value;
+        }
+        return undefined;
+    }
     /**
      * Get prompt cache statistics
      */
@@ -270,6 +325,15 @@ export class OpenAICompatProvider {
         }
         return true;
     }
+    getOllamaReasoningEffort(model) {
+        const modelInfo = getModelInfo(model);
+        const isOllama = modelInfo.provider === 'ollama' ||
+            this.baseURL.includes('localhost:11434') ||
+            this.baseURL.includes('127.0.0.1:11434');
+        if (!isOllama)
+            return undefined;
+        return process.env.CODEBUDDY_OLLAMA_REASONING_EFFORT?.trim() || 'none';
+    }
     isAsyncIterableStream(value) {
         return !!value
             && typeof value === 'object'
@@ -416,8 +480,16 @@ export class OpenAICompatProvider {
                 tools: useTools ? tools : [],
                 tool_choice: useTools ? 'auto' : undefined,
                 temperature: opts.temperature ?? 0.7,
-                max_tokens: this.defaultMaxTokens,
+                max_tokens: opts.maxTokens ?? this.defaultMaxTokens,
             };
+            const openRouterProviderRouting = this.getOpenRouterProviderRouting();
+            if (openRouterProviderRouting) {
+                requestPayload.provider = openRouterProviderRouting;
+            }
+            const ollamaReasoningEffort = this.getOllamaReasoningEffort(requestPayload.model);
+            if (ollamaReasoningEffort) {
+                requestPayload.reasoning_effort = ollamaReasoningEffort;
+            }
             const searchOpts = opts.searchOptions || searchOptions;
             const searchParameters = searchOpts?.search_parameters;
             if (this.shouldIncludeSearchParameters(searchParameters)) {
@@ -539,8 +611,16 @@ export class OpenAICompatProvider {
                 tools: useTools ? tools : [],
                 tool_choice: useTools ? 'auto' : undefined,
                 temperature: opts.temperature ?? 0.7,
-                max_tokens: this.defaultMaxTokens,
+                max_tokens: opts.maxTokens ?? this.defaultMaxTokens,
             };
+            const openRouterProviderRouting = this.getOpenRouterProviderRouting();
+            if (openRouterProviderRouting) {
+                requestPayload.provider = openRouterProviderRouting;
+            }
+            const ollamaReasoningEffort = this.getOllamaReasoningEffort(requestPayload.model);
+            if (ollamaReasoningEffort) {
+                requestPayload.reasoning_effort = ollamaReasoningEffort;
+            }
             const searchOpts = opts.searchOptions || searchOptions;
             const searchParameters = searchOpts?.search_parameters;
             const searchParams = this.shouldIncludeSearchParameters(searchParameters)

package/dist/codebuddy/tool-definitions/computer-control-tools.js

@@ -58,6 +58,13 @@ ACTIONS:
 - excel_set_cell: Set an Excel cell value via Windows COM
 - excel_get_cell: Read an Excel cell value via Windows COM
 - excel_save_workbook: Save or Save As an Excel workbook via Windows COM
+- powerpoint_open_presentation: Open or create a PowerPoint presentation via Windows COM
+- powerpoint_add_slide: Add a slide (layoutIndex optional) via Windows COM
+- powerpoint_set_text: Set text of a shape (slideIndex + shapeIndex) via Windows COM
+- powerpoint_save_presentation: Save or Save As a PowerPoint presentation via Windows COM
+- word_open_document: Open or create a Word document via Windows COM
+- word_type_text: Append text (value) to a Word document via Windows COM
+- word_save_document: Save or Save As a Word document via Windows COM
 - use_app_workflow: Execute a short sequence of computer_control steps
 - click_text: Click visible text using OCR fallback
 - click: Click at position or element ref
@@ -146,6 +153,13 @@ ACTIONS:
                         'excel_set_cell',
                         'excel_get_cell',
                         'excel_save_workbook',
+                        'powerpoint_open_presentation',
+                        'powerpoint_add_slide',
+                        'powerpoint_set_text',
+                        'powerpoint_save_presentation',
+                        'word_open_document',
+                        'word_type_text',
+                        'word_save_document',
                         'use_app_workflow',
                         'macro',
                         'click_text',
@@ -246,11 +260,23 @@ ACTIONS:
                 },
                 filePath: {
                     type: 'string',
-                    description: 'File/folder path for app launch or Excel workbook path',
+                    description: 'File/folder path for app launch or Office document path (Excel workbook, PowerPoint presentation, Word document)',
                 },
                 saveAsPath: {
                     type: 'string',
-                    description: 'Save-as path for Excel workbook',
+                    description: 'Save-as path for an Office document (Excel/PowerPoint/Word)',
+                },
+                slideIndex: {
+                    type: 'number',
+                    description: 'PowerPoint 1-based slide index for powerpoint_set_text',
+                },
+                shapeIndex: {
+                    type: 'number',
+                    description: 'PowerPoint 1-based shape index on the slide for powerpoint_set_text',
+                },
+                layoutIndex: {
+                    type: 'number',
+                    description: 'PowerPoint slide layout index for powerpoint_add_slide (e.g. 1=title, 2=text); defaults to 1',
                 },
                 sheetName: {
                     type: 'string',
@@ -428,6 +454,10 @@ ACTIONS:
                     type: 'boolean',
                     description: 'Only include interactive elements in snapshot',
                 },
+                useOmniParser: {
+                    type: 'boolean',
+                    description: 'For snapshot_with_screenshot: route the screenshot through a self-hosted OmniParser v2 server (set OMNIPARSER_API_URL) to overlay numbered bounding boxes and append parsed elements with clickable center coordinates. No-op (original snapshot) when the server is unavailable.',
+                },
                 steps: {
                     type: 'array',
                     items: { type: 'object' },

package/dist/codebuddy/tool-definitions/core-tools.js

@@ -12,7 +12,7 @@ export const VIEW_FILE_TOOL = {
     type: "function",
     function: {
         name: "view_file",
-        description: "View contents of a file or list directory contents",
+        description: "View contents of a file or list directory contents. Read/inspect a file before editing it — never guess its contents.",
         parameters: {
             type: "object",
             properties: {
@@ -94,7 +94,7 @@ export const STR_REPLACE_EDITOR_TOOL = {
     type: "function",
     function: {
         name: "str_replace_editor",
-        description: "Replace specific text in a file. Use this for single line edits only",
+        description: "Replace specific text in a file. Use this for single line edits only. After editing, verify the change with view_file.",
         parameters: {
             type: "object",
             properties: {
@@ -192,7 +192,7 @@ export const BASH_TOOL = {
     type: "function",
     function: {
         name: "bash",
-        description: "Execute a bash command",
+        description: "Execute a bash command. Prefer it to check facts and state you can verify (git status, test output, file existence, exit codes) rather than assuming.",
         parameters: {
             type: "object",
             properties: {

package/dist/codebuddy/tool-definitions/index.d.ts

@@ -19,7 +19,7 @@ export { FEISHU_DOC_READ_TOOL, FEISHU_DRIVE_LIST_COMMENTS_TOOL, FEISHU_DRIVE_LIS
 export { CRONJOB_TOOL, CRON_TOOLS, } from './cron-tools.js';
 export { WEB_SEARCH_TOOL, WEB_FETCH_TOOL, WEB_EXTRACT_TOOL, WEB_TOOLS, } from './web-tools.js';
 export { MULTI_EDIT_TOOL, GIT_TOOL, CODEBASE_MAP_TOOL, CODE_GRAPH_TOOL, SUBAGENT_TOOL, DOCKER_TOOL, KUBERNETES_TOOL, PROCESS_TOOL, JS_REPL_TOOL, REASON_TOOL, PLAN_TOOL, EXECUTE_CODE_TOOL, RUN_SCRIPT_TOOL, ADVANCED_TOOLS, } from './advanced-tools.js';
-export { PDF_TOOL, AUDIO_TOOL, TEXT_TO_SPEECH_TOOL, IMAGE_GENERATE_TOOL, VIDEO_TOOL, VIDEO_ANALYZE_TOOL, VIDEO_GENERATE_TOOL, SCREENSHOT_TOOL, CAMERA_SNAPSHOT_TOOL, CLIPBOARD_TOOL, DOCUMENT_TOOL, OCR_TOOL, VISION_ANALYZE_TOOL, DIAGRAM_TOOL, EXPORT_TOOL, QR_TOOL, ARCHIVE_TOOL, MULTIMODAL_TOOLS, } from './multimodal-tools.js';
+export { PDF_TOOL, AUDIO_TOOL, TEXT_TO_SPEECH_TOOL, IMAGE_GENERATE_TOOL, VIDEO_TOOL, VIDEO_ANALYZE_TOOL, VIDEO_GENERATE_TOOL, SCREENSHOT_TOOL, CAMERA_SNAPSHOT_TOOL, CAMERA_ANALYZE_TOOL, CLIPBOARD_TOOL, DOCUMENT_TOOL, OCR_TOOL, VISION_ANALYZE_TOOL, DIAGRAM_TOOL, EXPORT_TOOL, QR_TOOL, ARCHIVE_TOOL, MULTIMODAL_TOOLS, } from './multimodal-tools.js';
 export { COMPUTER_CONTROL_TOOL, COMPUTER_CONTROL_TOOLS, } from './computer-control-tools.js';
 export { INTERNET_SCOUT_RUN_TOOL, INTERNET_SCOUT_PLAN_TOOL, BROWSER_NAVIGATE_TOOL, BROWSER_CLICK_TOOL, BROWSER_TYPE_TOOL, BROWSER_SCROLL_TOOL, BROWSER_BACK_TOOL, BROWSER_PRESS_TOOL, BROWSER_VISION_TOOL, BROWSER_TOOL, BROWSER_TOOLS, } from './browser-tools.js';
 export { A2UI_TOOL, VISUAL_CANVAS_TOOL, CANVAS_TOOLS, } from './canvas-tools.js';
@@ -39,3 +39,4 @@ export { GENERATE_DOCUMENT_TOOL, DOCUMENT_GENERATOR_TOOLS, } from './document-to
 export { SESSION_TOOLS } from './session-tools.js';
 export { GITNEXUS_ASK_TOOL, GITNEXUS_TOOLS, } from './gitnexus-tools.js';
 export type { CodeBuddyTool as Tool } from './types.js';
+export * from "./windows-tools.js";

package/dist/codebuddy/tool-definitions/index.js

@@ -33,7 +33,7 @@ export { WEB_SEARCH_TOOL, WEB_FETCH_TOOL, WEB_EXTRACT_TOOL, WEB_TOOLS, } from '.
 // Advanced tools
 export { MULTI_EDIT_TOOL, GIT_TOOL, CODEBASE_MAP_TOOL, CODE_GRAPH_TOOL, SUBAGENT_TOOL, DOCKER_TOOL, KUBERNETES_TOOL, PROCESS_TOOL, JS_REPL_TOOL, REASON_TOOL, PLAN_TOOL, EXECUTE_CODE_TOOL, RUN_SCRIPT_TOOL, ADVANCED_TOOLS, } from './advanced-tools.js';
 // Multimodal tools
-export { PDF_TOOL, AUDIO_TOOL, TEXT_TO_SPEECH_TOOL, IMAGE_GENERATE_TOOL, VIDEO_TOOL, VIDEO_ANALYZE_TOOL, VIDEO_GENERATE_TOOL, SCREENSHOT_TOOL, CAMERA_SNAPSHOT_TOOL, CLIPBOARD_TOOL, DOCUMENT_TOOL, OCR_TOOL, VISION_ANALYZE_TOOL, DIAGRAM_TOOL, EXPORT_TOOL, QR_TOOL, ARCHIVE_TOOL, MULTIMODAL_TOOLS, } from './multimodal-tools.js';
+export { PDF_TOOL, AUDIO_TOOL, TEXT_TO_SPEECH_TOOL, IMAGE_GENERATE_TOOL, VIDEO_TOOL, VIDEO_ANALYZE_TOOL, VIDEO_GENERATE_TOOL, SCREENSHOT_TOOL, CAMERA_SNAPSHOT_TOOL, CAMERA_ANALYZE_TOOL, CLIPBOARD_TOOL, DOCUMENT_TOOL, OCR_TOOL, VISION_ANALYZE_TOOL, DIAGRAM_TOOL, EXPORT_TOOL, QR_TOOL, ARCHIVE_TOOL, MULTIMODAL_TOOLS, } from './multimodal-tools.js';
 // Computer Control tools (Enterprise-grade)
 export { COMPUTER_CONTROL_TOOL, COMPUTER_CONTROL_TOOLS, } from './computer-control-tools.js';
 // Browser tools (Enterprise-grade CDP automation)
@@ -70,4 +70,5 @@ export { GENERATE_DOCUMENT_TOOL, DOCUMENT_GENERATOR_TOOLS, } from './document-to
 export { SESSION_TOOLS } from './session-tools.js';
 // GitNexus tools
 export { GITNEXUS_ASK_TOOL, GITNEXUS_TOOLS, } from './gitnexus-tools.js';
+export * from "./windows-tools.js";
 //# sourceMappingURL=index.js.map

package/dist/codebuddy/tool-definitions/multimodal-tools.d.ts

@@ -24,6 +24,7 @@ export declare const VIDEO_ANALYZE_TOOL: CodeBuddyTool;
 export declare const VIDEO_GENERATE_TOOL: CodeBuddyTool;
 export declare const SCREENSHOT_TOOL: CodeBuddyTool;
 export declare const CAMERA_SNAPSHOT_TOOL: CodeBuddyTool;
+export declare const CAMERA_ANALYZE_TOOL: CodeBuddyTool;
 export declare const CLIPBOARD_TOOL: CodeBuddyTool;
 export declare const DOCUMENT_TOOL: CodeBuddyTool;
 export declare const OCR_TOOL: CodeBuddyTool;

package/dist/codebuddy/tool-definitions/multimodal-tools.js

@@ -96,7 +96,7 @@ export const TEXT_TO_SPEECH_TOOL = {
                 },
                 provider: {
                     type: "string",
-                    enum: ["auto", "system", "edge-tts", "espeak", "say", "kokoro", "audioreader"],
+                    enum: ["auto", "system", "edge-tts", "espeak", "say", "audioreader"],
                     description: "TTS provider. auto detects a local provider; system uses Windows SAPI"
                 },
                 voice: {
@@ -351,6 +351,48 @@ export const CAMERA_SNAPSHOT_TOOL = {
         }
     }
 };
+// Camera Analyze Tool - Capture a webcam frame AND describe it with a vision model
+export const CAMERA_ANALYZE_TOOL = {
+    type: "function",
+    function: {
+        name: "camera_analyze",
+        description: "Capture one local webcam frame and return a natural-language description from a local multimodal vision model (default Ollama gemma4:12b). Use this to actually SEE what the camera shows, not just save a PNG. Requires ffmpeg, OS camera permission, and a reachable local vision model.",
+        parameters: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "What to ask the vision model about the frame. Default \"Describe what you see.\""
+                },
+                device: {
+                    type: "string",
+                    description: "Optional ffmpeg camera device. Linux example: /dev/video0; Windows: video=Integrated Camera; macOS: 0."
+                },
+                model: {
+                    type: "string",
+                    description: "Local multimodal model id served by Ollama. Default gemma4:12b."
+                },
+                include_ocr: {
+                    type: "boolean",
+                    description: "Also attach local OCR text evidence from the captured frame (default: false)."
+                },
+                ocr_language: {
+                    type: "string",
+                    description: "OCR language code when include_ocr is true (default: eng)."
+                },
+                output_path: {
+                    type: "string",
+                    description: "Optional output image path. Defaults to .codebuddy/camera/camera-<timestamp>.png in the active workspace."
+                },
+                timeout_ms: {
+                    type: "number",
+                    description: "Capture timeout in milliseconds (default: 10000)."
+                }
+            },
+            required: []
+        }
+    }
+};
 // Clipboard Tool - System clipboard operations
 export const CLIPBOARD_TOOL = {
     type: "function",
@@ -799,6 +841,7 @@ export const MULTIMODAL_TOOLS = [
     VIDEO_GENERATE_TOOL,
     SCREENSHOT_TOOL,
     CAMERA_SNAPSHOT_TOOL,
+    CAMERA_ANALYZE_TOOL,
     CLIPBOARD_TOOL,
     DOCUMENT_TOOL,
     OCR_TOOL,

package/dist/codebuddy/tool-definitions/windows-tools.d.ts

@@ -0,0 +1,2 @@
+import { CodeBuddyTool } from "./types.js";
+export declare const WINDOWS_TOOLS: CodeBuddyTool[];

package/dist/codebuddy/tool-definitions/windows-tools.js

@@ -0,0 +1,34 @@
+export const WINDOWS_TOOLS = [
+    {
+        type: "function",
+        function: {
+            name: "office_macro_execute",
+            description: "Executes VBA or PowerShell macros directly in Windows Microsoft Office applications (Excel, Word, PowerPoint). This tool is only available on Windows.",
+            parameters: {
+                type: "object",
+                properties: {
+                    application: {
+                        type: "string",
+                        description: "The Microsoft Office application to target",
+                        enum: ["Excel", "Word", "PowerPoint"],
+                    },
+                    macroCode: {
+                        type: "string",
+                        description: "The VBA code or PowerShell code to execute",
+                    },
+                    type: {
+                        type: "string",
+                        description: "The type of macro code being provided",
+                        enum: ["vba", "powershell"],
+                    },
+                    runHeadless: {
+                        type: "boolean",
+                        description: "If true, the application will run invisibly in the background and will be closed after execution.",
+                    },
+                },
+                required: ["application", "macroCode", "type"],
+            },
+        },
+    },
+];
+//# sourceMappingURL=windows-tools.js.map

package/dist/codebuddy/tools.d.ts

@@ -19,13 +19,20 @@ export interface PluginToolDefinition {
     };
 }
 export type { CodeBuddyTool, JsonSchemaProperty };
-export { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, REASON_TOOL, EXECUTE_CODE_TOOL, } from "./tool-definitions/index.js";
+export { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, REASON_TOOL, EXECUTE_CODE_TOOL, WINDOWS_TOOLS, } from "./tool-definitions/index.js";
 export declare function getBuiltinToolNames(): string[];
 /**
  * Initialize the tool registry with all built-in tools
  */
 export declare function initializeToolRegistry(): void;
 export declare function getMCPManager(): MCPManager;
+/**
+ * True when the Code Explorer (gitnexus) MCP tools are connected — i.e. at least
+ * one `mcp__gitnexus__*` tool is registered. Used to conditionally steer the
+ * agent toward Code Explorer for relationship/impact questions. Returns false
+ * (no behavior change) whenever Code Explorer is not installed.
+ */
+export declare function isCodeExplorerAvailable(): boolean;
 export declare function initializeMCPServers(): Promise<void>;
 export declare function convertMCPToolToCodeBuddyTool(mcpTool: MCPTool): CodeBuddyTool;
 /**

package/dist/codebuddy/tools.js

@@ -9,14 +9,16 @@ import { loadMCPConfig } from "../mcp/config.js";
 import { getToolSelector, selectRelevantTools } from "../tools/tool-selector.js";
 import { logger } from "../utils/logger.js";
 import { getToolRegistry } from "../tools/registry.js";
+import { createRegisterToolTool } from "../tools/register-tool-handler.js";
+import { loadAuthoredTools } from "../agent/self-improvement/tool-skill-mutator.js";
 import { applyToolFilter } from "../utils/tool-filter.js";
 import { TOOL_METADATA } from "../tools/metadata.js";
 import { getPluginMarketplace } from "../plugins/marketplace.js";
 // Import modular tool definitions
-import { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, AGENT_TOOLS, FIRECRAWL_TOOLS, LSP_TOOLS, SECRETS_TOOLS, ADVISOR_TOOLS, ASK_USER_QUESTION_TOOLS, EXIT_PLAN_MODE_TOOLS, CODEBASE_REPLACE_TOOLS, SESSION_TOOLS, GITNEXUS_TOOLS, } from "./tool-definitions/index.js";
+import { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, AGENT_TOOLS, FIRECRAWL_TOOLS, LSP_TOOLS, SECRETS_TOOLS, ADVISOR_TOOLS, ASK_USER_QUESTION_TOOLS, EXIT_PLAN_MODE_TOOLS, CODEBASE_REPLACE_TOOLS, SESSION_TOOLS, GITNEXUS_TOOLS, WINDOWS_TOOLS, } from "./tool-definitions/index.js";
 import { FLEET_TOOLS } from "./fleet-tool-defs.js";
 // Explicit re-exports from tool-definitions (no blanket export *)
-export { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, REASON_TOOL, EXECUTE_CODE_TOOL, } from "./tool-definitions/index.js";
+export { CORE_TOOLS, MORPH_EDIT_TOOL, isMorphEnabled, SEARCH_TOOLS, TODO_TOOLS, KANBAN_TOOLS, MESSAGING_TOOLS, YUANBAO_TOOLS, HOMEASSISTANT_TOOLS, MOA_TOOLS, SPOTIFY_TOOLS, X_SEARCH_TOOLS, FEISHU_TOOLS, CRON_TOOLS, WEB_TOOLS, ADVANCED_TOOLS, MULTIMODAL_TOOLS, COMPUTER_CONTROL_TOOLS, BROWSER_TOOLS, CANVAS_TOOLS, REASON_TOOL, EXECUTE_CODE_TOOL, WINDOWS_TOOLS, } from "./tool-definitions/index.js";
 export function getBuiltinToolNames() {
     const groups = [
         CORE_TOOLS,
@@ -49,6 +51,7 @@ export function getBuiltinToolNames() {
         SESSION_TOOLS,
         FLEET_TOOLS,
         GITNEXUS_TOOLS,
+        WINDOWS_TOOLS,
     ];
     return Array.from(new Set(groups.flatMap((tools) => tools.map((tool) => tool.function.name))));
 }
@@ -88,6 +91,18 @@ export function initializeToolRegistry() {
         description: 'High-speed file editing with Morph'
     };
     registry.registerTool(MORPH_EDIT_TOOL, morphMetadata, isMorphEnabled);
+    // Self-improvement: expose `register_tool` + reload persisted authored tools,
+    // only when opted in.
+    if (process.env.CODEBUDDY_SELF_IMPROVE === 'true') {
+        const schema = createRegisterToolTool().getSchema();
+        registry.registerTool({ type: 'function', function: { name: schema.name, description: schema.description, parameters: schema.parameters } }, { name: schema.name, category: 'system', keywords: ['authored', 'self-extension', 'register', 'tool'], priority: 6, description: schema.description });
+        try {
+            const loaded = loadAuthoredTools();
+            if (loaded.length > 0)
+                logger.info(`[self-improve] reloaded ${loaded.length} authored tool(s): ${loaded.join(', ')}`);
+        }
+        catch { /* persisted store optional */ }
+    }
     registerGroup(SEARCH_TOOLS);
     registerGroup(TODO_TOOLS);
     registerGroup(KANBAN_TOOLS);
@@ -118,6 +133,8 @@ export function initializeToolRegistry() {
     registerGroup(ASK_USER_QUESTION_TOOLS);
     // ExitPlanMode tool (request approval to leave plan mode)
     registerGroup(EXIT_PLAN_MODE_TOOLS);
+    // Windows OS-specific tools (Office VBA, etc.)
+    registerGroup(WINDOWS_TOOLS, () => process.platform === 'win32');
     // Codebase replace tools
     registerGroup(CODEBASE_REPLACE_TOOLS);
     // Session tools — multi-agent coordination (Phase E wake of SessionToolExecutor).
@@ -144,6 +161,20 @@ export function getMCPManager() {
     }
     return mcpManager;
 }
+/**
+ * True when the Code Explorer (gitnexus) MCP tools are connected — i.e. at least
+ * one `mcp__gitnexus__*` tool is registered. Used to conditionally steer the
+ * agent toward Code Explorer for relationship/impact questions. Returns false
+ * (no behavior change) whenever Code Explorer is not installed.
+ */
+export function isCodeExplorerAvailable() {
+    try {
+        return getMCPManager().getTools().some((t) => t.name.startsWith('mcp__gitnexus__'));
+    }
+    catch {
+        return false;
+    }
+}
 export async function initializeMCPServers() {
     const manager = getMCPManager();
     const config = loadMCPConfig();
@@ -319,29 +350,29 @@ export async function getAllCodeBuddyTools() {
     // Ensure registry is initialized with built-in tools
     initializeToolRegistry();
     const manager = getMCPManager();
-    // Initialize MCP servers if not already done.
-    //
-    // In interactive mode this stays fire-and-forget: a hung/slow MCP server must
-    // never block a turn, and the agent self-heals across turns (a missed server
-    // simply shows up on the next round).
-    //
-    // In headless / one-shot mode (`buddy --print`) there is no "next round" to
-    // recover in, and RAG tool selection is cached after the first round — so if
-    // the lazy connection loses the race against the first selection, the MCP
-    // tools are cached out for the entire run and the model never sees them. We
-    // therefore await initialization here so MCP tools are present before the
-    // first tool-selection pass. Note: this is the *lazy* init path and is
-    // intentionally NOT gated by CODEBUDDY_DISABLE_MCP — that flag only skips the
-    // *eager* constructor init for startup speed; the await below is what makes
-    // the lazy init win the race when the tools are actually needed.
-    const initPromise = manager.ensureServersInitialized().catch((err) => {
-        // Log but don't fail - MCP servers are optional
-        if (process.env.DEBUG) {
-            logger.warn(`MCP initialization warning: ${err.message || String(err)}`);
+    const mcpDisabled = process.env.CODEBUDDY_DISABLE_MCP === 'true' ||
+        process.env.CODEBUDDY_DISABLE_MCP === '1';
+    if (!mcpDisabled) {
+        // Initialize MCP servers if not already done.
+        //
+        // In interactive mode this stays fire-and-forget: a hung/slow MCP server
+        // must never block a turn, and the agent self-heals across turns (a missed
+        // server simply shows up on the next round).
+        //
+        // In headless / one-shot mode (`buddy --print`) there is no "next round" to
+        // recover in, and RAG tool selection is cached after the first round — so if
+        // the lazy connection loses the race against the first selection, MCP tools
+        // are cached out for the entire run. We therefore await initialization here
+        // unless MCP has explicitly been disabled for the process.
+        const initPromise = manager.ensureServersInitialized().catch((err) => {
+            // Log but don't fail - MCP servers are optional
+            if (process.env.DEBUG) {
+                logger.warn(`MCP initialization warning: ${err.message || String(err)}`);
+            }
+        });
+        if (process.env.CODEBUDDY_HEADLESS === 'true') {
+            await initPromise;
         }
-    });
-    if (process.env.CODEBUDDY_HEADLESS === 'true') {
-        await initPromise;
     }
     const registry = getToolRegistry();
     const builtInTools = registry.getEnabledTools();
@@ -356,6 +387,18 @@ export async function getAllCodeBuddyTools() {
     }
     // Apply CLI tool filter (--enabled-tools, --disabled-tools, --allowed-tools)
     allTools = applyToolFilter(allTools);
+    // When Code Explorer (gitnexus) is connected, make the built-in graph tools
+    // defer to it at the decision point — its graph is broader / more complete.
+    // Conditional & non-mutating: returns fresh objects only for code_graph /
+    // codebase_map, and only when a gitnexus tool is present (no change otherwise).
+    if (allTools.some((t) => t.function.name.startsWith('mcp__gitnexus__'))) {
+        const DEFER = ' NOTE: Code Explorer (gitnexus) is available — for code-relationship, blast-radius/impact, ' +
+            'dead-code and cycle questions PREFER its MCP tools (`mcp__gitnexus__impact` / `context` / ' +
+            '`query` / `find_cycles`); use this built-in only as a fallback if a gitnexus tool errors.';
+        allTools = allTools.map((t) => t.function.name === 'code_graph' || t.function.name === 'codebase_map'
+            ? { ...t, function: { ...t.function, description: (t.function.description ?? '') + DEFER } }
+            : t);
+    }
     return allTools;
 }
 // ============================================================================