@phuetz/code-buddy 1.0.0 → 1.2.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.

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,7 +19,7 @@ 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

package/dist/codebuddy/tools.js

@@ -13,10 +13,10 @@ 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 +49,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))));
 }
@@ -118,6 +119,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).
@@ -319,29 +322,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();

package/dist/commands/cli/hermes-commands.js

@@ -22,6 +22,7 @@ import { buildHermesToolsetCatalog, } from '../../agent/hermes-toolset-catalog.j
 import { buildHermesHookLifecycleManifest, renderHermesHookLifecycleManifest, } from '../../hooks/hermes-lifecycle-hooks.js';
 import { buildHermesPortalStatus, renderHermesPortalStatus, } from '../../agent/hermes-portal-status.js';
 import { buildHermesRuntimeBackendsReadiness, renderHermesRuntimeBackendsReadiness, runHermesRuntimeBackendSmoke, } from '../../agent/hermes-runtime-backends.js';
+import { buildBackendLifecycleStatusReport, executeBackendLifecycleAction, renderBackendLifecycleAction, renderBackendLifecycleStatusReport, } from '../../agent/hermes-runtime-lifecycle.js';
 import { buildHermesBrowserBackendsReadiness, renderHermesBrowserBackendsReadiness, renderHermesBrowserSmoke, runHermesBrowserBackendSmoke, } from '../../agent/hermes-browser-backends.js';
 import { buildHermesMemoryProvidersReadiness, renderHermesMemoryProvidersReadiness, probeMemoryProvider, renderHermesMemoryProbe, } from '../../agent/hermes-memory-providers.js';
 import { buildHermesLearningLoopStatus, renderHermesLearningLoopStatus, } from '../../agent/hermes-learning-loop-status.js';
@@ -2455,6 +2456,47 @@ export function registerHermesCommands(program) {
         console.log(`Command: ${command}`);
         console.log(renderHermesMessagingGatewayStatus(status));
     });
+    messaging
+        .command('gateway-status')
+        .description('Print gateway lifecycle status and per-platform slash-command parity')
+        .option('--json', 'output JSON')
+        .action(async (options) => {
+        const { getGatewayLifecycle, buildSlashParityManifest, renderSlashParityManifest } = await import('../../channels/index.js');
+        const lifecycle = getGatewayLifecycle();
+        const gatewayStatus = lifecycle.status();
+        const slashParity = buildSlashParityManifest(lifecycle.getManager());
+        const command = 'buddy hermes messaging gateway-status --json';
+        const payload = {
+            command,
+            kind: 'hermes_messaging_gateway_lifecycle_status',
+            schemaVersion: 1,
+            gateway: gatewayStatus,
+            slashParity,
+        };
+        if (options.json) {
+            console.log(stableJson(payload));
+            return;
+        }
+        const lines = [
+            `Command: ${command}`,
+            '',
+            'Gateway lifecycle status:',
+            `  Status: ${gatewayStatus.ok ? 'ok' : 'needs attention'}`,
+            `  Channels: ${gatewayStatus.totalChannels} total, ${gatewayStatus.connectedCount} connected, ${gatewayStatus.disconnectedCount} disconnected, ${gatewayStatus.errorCount} errors`,
+        ];
+        if (gatewayStatus.channels.length > 0) {
+            lines.push('');
+            lines.push('Per-channel readiness:');
+            for (const ch of gatewayStatus.channels) {
+                lines.push(`  - ${ch.channelId}: ${ch.readiness}` +
+                    `${ch.authenticated ? ', authenticated' : ''}` +
+                    `${ch.error ? `, error: ${ch.error}` : ''}`);
+            }
+        }
+        lines.push('');
+        lines.push(renderSlashParityManifest(slashParity));
+        console.log(lines.join('\n'));
+    });
     const mobile = hermes
         .command('mobile')
         .description('Inspect Hermes mobile supervision gateway readiness');
@@ -2863,6 +2905,72 @@ export function registerHermesCommands(program) {
         console.log(`Command: ${command}`);
         console.log(renderHermesRuntimeBackendsReadiness(readiness));
     });
+    runtime
+        .command('hibernate')
+        .description('Hibernate (suspend) a managed runtime backend')
+        .argument('<backendId>', 'backend id to hibernate (e.g. docker, ssh, modal, daytona)')
+        .option('--container-id <id>', 'Docker container id or name')
+        .option('--ssh-host <host>', 'SSH host for ssh backend')
+        .option('--modal-app <app>', 'Modal app name')
+        .option('--daytona-workspace <ws>', 'Daytona workspace id')
+        .option('--json', 'output JSON')
+        .action((backendId, options) => {
+        const result = executeBackendLifecycleAction(backendId, 'hibernate', {
+            containerId: options.containerId,
+            sshHost: options.sshHost,
+            modalApp: options.modalApp,
+            daytonaWorkspace: options.daytonaWorkspace,
+        });
+        const payload = {
+            kind: 'hermes_runtime_lifecycle_action',
+            schemaVersion: 1,
+            result,
+        };
+        if (options.json) {
+            console.log(stableJson(payload));
+            return;
+        }
+        console.log(renderBackendLifecycleAction(result));
+    });
+    runtime
+        .command('wake')
+        .description('Wake (resume) a managed runtime backend')
+        .argument('<backendId>', 'backend id to wake (e.g. docker, ssh, modal, daytona)')
+        .option('--container-id <id>', 'Docker container id or name')
+        .option('--ssh-host <host>', 'SSH host for ssh backend')
+        .option('--modal-app <app>', 'Modal app name')
+        .option('--daytona-workspace <ws>', 'Daytona workspace id')
+        .option('--json', 'output JSON')
+        .action((backendId, options) => {
+        const result = executeBackendLifecycleAction(backendId, 'wake', {
+            containerId: options.containerId,
+            sshHost: options.sshHost,
+            modalApp: options.modalApp,
+            daytonaWorkspace: options.daytonaWorkspace,
+        });
+        const payload = {
+            kind: 'hermes_runtime_lifecycle_action',
+            schemaVersion: 1,
+            result,
+        };
+        if (options.json) {
+            console.log(stableJson(payload));
+            return;
+        }
+        console.log(renderBackendLifecycleAction(result));
+    });
+    runtime
+        .command('lifecycle-status')
+        .description('Show lifecycle state for all runtime backends')
+        .option('--json', 'output JSON')
+        .action((options) => {
+        const report = buildBackendLifecycleStatusReport();
+        if (options.json) {
+            console.log(stableJson(report));
+            return;
+        }
+        console.log(renderBackendLifecycleStatusReport(report));
+    });
     hermes
         .command('runtime-smoke')
         .description('Run an opt-in live smoke for one Hermes runtime backend')