@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/tools/registry/misc-tools.js

@@ -4,10 +4,11 @@
  * ITool-compliant adapters for BrowserTool (accessibility-based),
  * ComputerControlTool, ScreenshotTool, and ReasoningTool.
  *
- * BrowserExecuteTool is wired to src/browser-automation/ (OpenClaw-inspired
+ * BrowserExecuteTool is wired to src/browser-automation/ (Enterprise-grade
  * accessibility tree + ref numbering) instead of the old CSS-selector-only
  * src/tools/browser-tool.ts.
  */
+import { recordCompanionPercept } from '../../companion/percepts.js';
 import { ReasoningTool } from '../index.js';
 import { SkillDiscoveryTool } from '../skill-discovery-tool.js';
 import { DeviceTool } from '../device-tool.js';
@@ -16,6 +17,7 @@ import { DeviceTool } from '../device-tool.js';
 // ============================================================================
 let browserInstance = null;
 let reasoningInstance = null;
+let deployInstance = null;
 let computerControlInstance = null;
 let screenshotInstance = null;
 async function getBrowserAutomation() {
@@ -45,6 +47,13 @@ async function getScreenshot() {
     }
     return screenshotInstance;
 }
+async function getDeployInstance() {
+    if (!deployInstance) {
+        const { getDeployTool } = await import('../deploy-tool.js');
+        deployInstance = getDeployTool();
+    }
+    return deployInstance;
+}
 /**
  * Reset the shared instances (for testing)
  */
@@ -53,6 +62,7 @@ export function resetMiscInstances() {
     reasoningInstance = null;
     computerControlInstance = null;
     screenshotInstance = null;
+    deployInstance = null;
 }
 // ============================================================================
 // BrowserExecuteTool (rewired to browser-automation module)
@@ -60,13 +70,13 @@ export function resetMiscInstances() {
 const BROWSER_ACTIONS = [
     'launch', 'connect', 'close',
     'tabs', 'new_tab', 'focus_tab', 'close_tab',
-    'snapshot', 'get_element', 'find_elements',
+    'snapshot', 'observe', 'get_element', 'find_elements',
     'navigate', 'go_back', 'go_forward', 'reload',
     'click', 'double_click', 'right_click', 'type', 'fill', 'select', 'press', 'hover', 'scroll',
     'screenshot', 'pdf',
     'get_cookies', 'set_cookie', 'clear_cookies', 'set_headers', 'set_offline',
     'emulate_device', 'set_geolocation',
-    'evaluate', 'get_content', 'get_url', 'get_title',
+    'evaluate', 'get_content', 'extract', 'assert_text', 'get_images', 'console', 'dialog', 'get_url', 'get_title',
 ];
 /**
  * BrowserExecuteTool - ITool adapter for browser automation
@@ -101,6 +111,10 @@ export class BrowserExecuteTool {
                     ref: { type: 'number', description: 'Element reference number from snapshot' },
                     role: { type: 'string', description: 'Element role to search for' },
                     name: { type: 'string', description: 'Element name/text to search for' },
+                    query: { type: 'string', description: 'Natural-language extraction focus or assertion query' },
+                    expectedText: { type: 'string', description: 'Text expected to appear on the page for assert_text' },
+                    proofGoal: { type: 'string', description: 'Optional proof-loop goal used when persistWhenProven returns memory/lesson suggestions' },
+                    persistWhenProven: { type: 'boolean', description: 'For extract/assert_text, return remember and lessons_add payload suggestions only after durable evidence is proven' },
                     text: { type: 'string', description: 'Text to type' },
                     key: { type: 'string', description: 'Key to press (Enter, Tab, Escape, etc.)' },
                     modifiers: { type: 'array', items: { type: 'string' }, description: 'Modifier keys' },
@@ -119,6 +133,13 @@ export class BrowserExecuteTool {
                     format: { type: 'string', enum: ['png', 'jpeg', 'webp'], description: 'Image format' },
                     quality: { type: 'number', description: 'Image quality (0-100)' },
                     expression: { type: 'string', description: 'JavaScript code to evaluate in page' },
+                    limit: { type: 'number', description: 'Maximum number of images to return for action=get_images' },
+                    visibleOnly: { type: 'boolean', description: 'Only return visible images for action=get_images' },
+                    consoleAction: { type: 'string', enum: ['list', 'clear'], description: 'Browser console operation for action=console' },
+                    consoleType: { type: 'string', description: 'Optional console type filter: log, warn, error, info, debug, pageerror' },
+                    dialogAction: { type: 'string', enum: ['list', 'accept', 'dismiss'], description: 'Browser dialog operation for action=dialog' },
+                    dialogId: { type: 'string', description: 'Pending browser dialog id from browser_dialog list or browser snapshot' },
+                    promptText: { type: 'string', description: 'Text to enter when accepting a prompt dialog' },
                     timeout: { type: 'number', description: 'Timeout in milliseconds' },
                 },
                 required: ['action'],
@@ -143,7 +164,7 @@ export class BrowserExecuteTool {
             name: this.name,
             description: this.description,
             category: 'web',
-            keywords: ['browser', 'web', 'automation', 'playwright', 'screenshot', 'scrape', 'accessibility'],
+            keywords: ['browser', 'web', 'automation', 'playwright', 'screenshot', 'scrape', 'accessibility', 'observe', 'extract', 'assert', 'stagehand', 'ui test'],
             priority: 5,
             requiresConfirmation: true,
             modifiesFiles: false,
@@ -162,13 +183,282 @@ export class BrowserExecuteTool {
     }
 }
 // ============================================================================
+// BrowserSnapshotExecuteTool (Hermes browser_snapshot parity)
+// ============================================================================
+export class BrowserSnapshotExecuteTool {
+    name = 'browser_snapshot';
+    description = 'Take an accessibility-oriented snapshot of the active Playwright page and return element refs for follow-up browser actions.';
+    async execute(input) {
+        const browser = await getBrowserAutomation();
+        return await browser.execute({
+            action: 'snapshot',
+            interactiveOnly: input.interactiveOnly,
+            maxElements: input.maxElements,
+            includeHidden: input.includeHidden,
+        });
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    interactiveOnly: {
+                        type: 'boolean',
+                        description: 'Only include interactive elements. Defaults to true.',
+                    },
+                    maxElements: {
+                        type: 'number',
+                        description: 'Maximum number of elements to include.',
+                    },
+                    includeHidden: {
+                        type: 'boolean',
+                        description: 'Include hidden elements when the browser engine supports it.',
+                    },
+                },
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (data.maxElements !== undefined && (typeof data.maxElements !== 'number' || data.maxElements < 1)) {
+            return { valid: false, errors: ['maxElements must be a positive number'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'web',
+            keywords: ['browser', 'snapshot', 'accessibility', 'refs', 'observe', 'playwright', 'hermes'],
+            priority: 8,
+            requiresConfirmation: true,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// BrowserConsoleExecuteTool (Hermes browser_console parity)
+// ============================================================================
+export class BrowserConsoleExecuteTool {
+    name = 'browser_console';
+    description = 'List or clear browser console messages and page runtime errors captured from the active Playwright session.';
+    async execute(input) {
+        const browser = await getBrowserAutomation();
+        return await browser.execute({
+            action: 'console',
+            consoleAction: input.action ?? 'list',
+            consoleType: input.type,
+            limit: input.limit,
+        });
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['list', 'clear'],
+                        description: 'Console operation. Defaults to list.',
+                    },
+                    type: {
+                        type: 'string',
+                        description: 'Optional console type filter: log, warn, error, info, debug, pageerror.',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of most recent entries to return.',
+                    },
+                },
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (data.action !== undefined && !['list', 'clear'].includes(data.action)) {
+            return { valid: false, errors: ['action must be one of list, clear'] };
+        }
+        if (data.limit !== undefined && (typeof data.limit !== 'number' || data.limit < 1)) {
+            return { valid: false, errors: ['limit must be a positive number'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'web',
+            keywords: ['browser', 'console', 'logs', 'javascript', 'pageerror', 'debug', 'playwright', 'hermes'],
+            priority: 7,
+            requiresConfirmation: true,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// BrowserGetImagesExecuteTool (Hermes browser_get_images parity)
+// ============================================================================
+export class BrowserGetImagesExecuteTool {
+    name = 'browser_get_images';
+    description = 'List image elements on the active Playwright page with resolved source URLs, alt text, dimensions, and visibility.';
+    async execute(input) {
+        const browser = await getBrowserAutomation();
+        return await browser.execute({
+            action: 'get_images',
+            limit: input.limit,
+            visibleOnly: input.visibleOnly,
+        });
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of images to return. Defaults to 50; capped at 200.',
+                    },
+                    visibleOnly: {
+                        type: 'boolean',
+                        description: 'Only return images that have visible layout boxes.',
+                    },
+                },
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (data.limit !== undefined && (typeof data.limit !== 'number' || data.limit < 1)) {
+            return { valid: false, errors: ['limit must be a positive number'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'web',
+            keywords: ['browser', 'image', 'images', 'img', 'media', 'alt', 'playwright', 'hermes'],
+            priority: 7,
+            requiresConfirmation: true,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// BrowserDialogExecuteTool (Hermes browser_dialog parity)
+// ============================================================================
+export class BrowserDialogExecuteTool {
+    name = 'browser_dialog';
+    description = 'List, accept, or dismiss native browser dialogs (alert, confirm, prompt) on the active Playwright page.';
+    async execute(input) {
+        const browser = await getBrowserAutomation();
+        return await browser.execute({
+            action: 'dialog',
+            dialogAction: input.action ?? 'list',
+            dialogId: input.dialogId,
+            promptText: input.promptText,
+        });
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['list', 'accept', 'dismiss'],
+                        description: 'Dialog operation. Defaults to list.',
+                    },
+                    dialogId: {
+                        type: 'string',
+                        description: 'Specific pending dialog id. Defaults to the active tab dialog.',
+                    },
+                    promptText: {
+                        type: 'string',
+                        description: 'Text to enter when accepting a prompt dialog.',
+                    },
+                },
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (data.action !== undefined && !['list', 'accept', 'dismiss'].includes(data.action)) {
+            return { valid: false, errors: ['action must be one of list, accept, dismiss'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'web',
+            keywords: ['browser', 'dialog', 'alert', 'confirm', 'prompt', 'modal', 'playwright', 'hermes'],
+            priority: 7,
+            requiresConfirmation: true,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
 // ComputerControlExecuteTool
 // ============================================================================
 const COMPUTER_CONTROL_ACTIONS = [
     'snapshot', 'snapshot_with_screenshot', 'get_element', 'find_elements',
-    'click', 'double_click', 'right_click', 'move_mouse', 'drag', 'scroll',
-    'type', 'key', 'hotkey',
-    'get_windows', 'focus_window', 'close_window',
+    'click_element_by_name', 'click_button', 'click_link',
+    'fill_text_field', 'clear_and_type', 'select_dropdown_option',
+    'select_radio', 'activate_tab', 'select_list_item', 'open_menu_item',
+    'toggle_checkbox', 'set_slider_value', 'select_tree_item', 'expand_tree_item', 'collapse_tree_item',
+    'assert_text_visible', 'assert_element_visible', 'use_app_workflow',
+    'inspect_dialog', 'click_dialog_button', 'handle_dialog',
+    'list_app_profiles', 'get_app_profile', 'open_app', 'focus_app', 'read_app_text', 'save_app_document',
+    'excel_open_workbook', 'excel_set_cell', 'excel_get_cell', 'excel_save_workbook',
+    'macro', 'click_text', 'save_macro', 'play_macro', 'list_macros', 'delete_macro', 'wait_for_text', 'speak',
+    'click', 'left_click', 'middle_click', 'double_click', 'right_click', 'move_mouse', 'drag', 'scroll',
+    'cursor_position', 'wait',
+    'type', 'key', 'key_down', 'key_up', 'hotkey',
+    'get_windows', 'get_window', 'list_window_matches', 'wait_for_window', 'focus_window', 'close_window',
+    'get_active_window', 'minimize_window', 'maximize_window', 'restore_window', 'move_window', 'resize_window',
+    'set_window', 'act_on_best_window', 'get_audit_log', 'clear_audit_log', 'export_audit_log',
+    'set_pilot_mode', 'get_pilot_mode',
     'get_volume', 'set_volume', 'get_brightness', 'set_brightness',
     'notify', 'lock', 'sleep',
     'start_recording', 'stop_recording', 'recording_status',
@@ -196,20 +486,105 @@ export class ComputerControlExecuteTool {
                         enum: [...COMPUTER_CONTROL_ACTIONS],
                         description: 'The action to perform',
                     },
+                    pilotMode: {
+                        type: 'string',
+                        enum: ['cautious', 'normal', 'fast'],
+                        description: 'High-level piloting preset for default safety + matching behavior',
+                    },
+                    safetyProfile: {
+                        type: 'string',
+                        enum: ['balanced', 'strict'],
+                        description: 'Safety profile for action gating (strict blocks dangerous actions unless confirmed)',
+                    },
+                    confirmDangerous: {
+                        type: 'boolean',
+                        description: 'Required in strict profile for dangerous actions',
+                    },
+                    simulateOnly: {
+                        type: 'boolean',
+                        description: 'If true, do a dry-run for mutating actions without applying changes',
+                    },
+                    auditLimit: {
+                        type: 'number',
+                        description: 'Number of audit entries to return for get_audit_log (1-500)',
+                    },
+                    exportAuditPath: {
+                        type: 'string',
+                        description: 'Optional output path for export_audit_log JSON file',
+                    },
+                    policyOverrides: {
+                        type: 'object',
+                        description: 'Per-action safety overrides: { "close_window": "confirm|allow|block", ... }',
+                    },
                     ref: { type: 'number', description: 'Element reference number from snapshot' },
+                    appName: { type: 'string', description: 'Application profile id/name, e.g. excel, notepad, calculator, browser, vscode' },
+                    filePath: { type: 'string', description: 'File/folder path for app launch or Excel workbook path' },
+                    saveAsPath: { type: 'string', description: 'Save-as path for Excel workbook' },
+                    sheetName: { type: 'string', description: 'Excel worksheet name' },
+                    cell: { type: 'string', description: 'Excel cell/range address, e.g. A1' },
+                    value: { type: 'string', description: 'Value for app-specific and range actions such as excel_set_cell or set_slider_value' },
                     x: { type: 'number', description: 'X coordinate for mouse actions' },
                     y: { type: 'number', description: 'Y coordinate for mouse actions' },
+                    width: { type: 'number', description: 'Window width (for resize_window)' },
+                    height: { type: 'number', description: 'Window height (for resize_window)' },
                     text: { type: 'string', description: 'Text to type' },
                     key: { type: 'string', description: 'Key to press' },
+                    clearFirst: { type: 'boolean', description: 'Clear existing focused/target text before typing' },
+                    option: { type: 'string', description: 'Option label for select_dropdown_option' },
+                    checked: { type: 'boolean', description: 'Desired state for toggle_checkbox' },
+                    expanded: { type: 'boolean', description: 'Desired expanded state for tree item actions' },
+                    exactName: { type: 'boolean', description: 'Prefer exact accessible-name matching for semantic actions' },
+                    visualContext: { type: 'boolean', description: 'For targeted keyboard/text actions, capture snapshot + screenshot OCR evidence after focus is verified' },
+                    dialogIntent: {
+                        type: 'string',
+                        enum: ['accept', 'cancel', 'save', 'dont_save', 'discard', 'retry', 'continue', 'close', 'yes', 'no', 'ok', 'custom'],
+                        description: 'Desired dialog decision for handle_dialog/click_dialog_button',
+                    },
+                    dialogText: { type: 'string', description: 'Expected text/title inside a dialog before clicking a dialog button' },
+                    seconds: { type: 'number', description: 'Wait duration in seconds (for wait action)' },
                     modifiers: { type: 'array', items: { type: 'string' }, description: 'Modifier keys (ctrl, alt, shift, meta)' },
                     button: { type: 'string', enum: ['left', 'right', 'middle'], description: 'Mouse button' },
                     deltaX: { type: 'number', description: 'Horizontal scroll amount' },
                     deltaY: { type: 'number', description: 'Vertical scroll amount' },
                     windowTitle: { type: 'string', description: 'Window title to find/focus' },
+                    windowTitleRegex: { type: 'string', description: 'Case-insensitive regex pattern for window title matching' },
+                    windowTitleMatch: { type: 'string', enum: ['contains', 'equals'], description: 'Window title matching mode' },
+                    processName: { type: 'string', description: 'Process name to find/focus (e.g. Discord, chrome, msedge)' },
+                    processNameMatch: { type: 'string', enum: ['equals', 'contains'], description: 'Process name matching mode' },
+                    windowHandle: { type: 'string', description: 'Window handle to focus/close directly' },
+                    windowMatchStrategy: {
+                        type: 'string',
+                        enum: ['first', 'focused', 'largest', 'newest'],
+                        description: 'When multiple windows match, choose first, focused, largest, or newest',
+                    },
+                    requireUniqueWindowMatch: {
+                        type: 'boolean',
+                        description: 'If true, fail when multiple windows match instead of auto-selecting one',
+                    },
+                    focus: { type: 'boolean', description: 'Whether to focus window (for set_window)' },
+                    windowState: {
+                        type: 'string',
+                        enum: ['normal', 'minimized', 'maximized'],
+                        description: 'Target state for set_window',
+                    },
+                    bestWindowAction: {
+                        type: 'string',
+                        enum: ['focus', 'close', 'minimize', 'maximize', 'restore', 'move', 'resize', 'set'],
+                        description: 'Action used by act_on_best_window',
+                    },
+                    timeoutMs: { type: 'number', description: 'Timeout in milliseconds for wait_for_window' },
+                    pollIntervalMs: { type: 'number', description: 'Polling interval in milliseconds for wait_for_window' },
                     level: { type: 'number', description: 'Volume or brightness level (0-100)' },
                     role: { type: 'string', description: 'Element role to find' },
                     name: { type: 'string', description: 'Element name to search for' },
                     interactiveOnly: { type: 'boolean', description: 'Only include interactive elements in snapshot' },
+                    steps: {
+                        type: 'array',
+                        items: { type: 'object' },
+                        description: 'Workflow/macro steps for macro or use_app_workflow',
+                    },
+                    macroName: { type: 'string', description: 'Saved macro name for save_macro/play_macro/delete_macro' },
+                    macroDescription: { type: 'string', description: 'Saved macro description for save_macro' },
                 },
                 required: ['action'],
             },
@@ -233,7 +608,7 @@ export class ComputerControlExecuteTool {
             name: this.name,
             description: this.description,
             category: 'utility',
-            keywords: ['computer', 'control', 'mouse', 'keyboard', 'desktop', 'automation', 'snapshot', 'click'],
+            keywords: ['computer', 'control', 'mouse', 'keyboard', 'desktop', 'automation', 'snapshot', 'click', 'dialog', 'modal', 'button', 'slider', 'tree'],
             priority: 5,
             requiresConfirmation: true,
             modifiesFiles: false,
@@ -253,9 +628,9 @@ export class ComputerControlExecuteTool {
 export class ScreenshotExecuteTool {
     name = 'screenshot';
     description = 'Capture screenshots of the screen, a window, or a region. Supports LLM-optimized output.';
-    async execute(input) {
+    async execute(input, context) {
         const tool = await getScreenshot();
-        return await tool.capture({
+        const result = await tool.capture({
             fullscreen: input.fullscreen,
             region: input.region,
             window: input.window,
@@ -265,6 +640,32 @@ export class ScreenshotExecuteTool {
             outputPath: input.outputPath,
             forLLM: input.forLLM,
         });
+        if (result.success) {
+            const data = result.data;
+            try {
+                await recordCompanionPercept({
+                    modality: 'screen',
+                    source: 'screenshot_tool',
+                    summary: `Captured screen screenshot${data?.path ? ` to ${data.path}` : ''}`,
+                    confidence: 1,
+                    payload: {
+                        path: data?.path,
+                        width: data?.width,
+                        height: data?.height,
+                        size: data?.size,
+                        fullscreen: input.fullscreen,
+                        region: input.region,
+                        window: input.window,
+                        forLLM: input.forLLM,
+                    },
+                    tags: ['screen', 'screenshot', 'vision'],
+                }, { cwd: context?.cwd });
+            }
+            catch {
+                // Screen capture succeeded; percept journaling is best-effort.
+            }
+        }
+        return result;
     }
     getSchema() {
         return {
@@ -545,19 +946,342 @@ export class DeviceExecuteTool {
     }
 }
 // ============================================================================
+// DeployExecuteTool
+// ============================================================================
+const DEPLOY_ACTIONS = ['generate_config', 'deploy', 'status', 'logs'];
+const DEPLOY_PLATFORMS = ['fly', 'railway', 'render', 'hetzner', 'northflank', 'gcp'];
+/**
+ * DeployExecuteTool - ITool adapter for cloud deployment
+ */
+export class DeployExecuteTool {
+    name = 'deploy';
+    description = 'Deploy applications to cloud platforms (Fly.io, Railway, Render, GCP, Hetzner, Northflank). Generate configs, deploy, check status, view logs.';
+    async execute(input) {
+        const tool = await getDeployInstance();
+        return await tool.execute({
+            action: input.action,
+            platform: input.platform,
+            appName: input.appName,
+            region: input.region,
+            port: input.port,
+            env: input.env,
+            memory: input.memory,
+            cpus: input.cpus,
+            outputDir: input.outputDir,
+            tailLines: input.tailLines,
+        });
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: [...DEPLOY_ACTIONS],
+                        description: 'Deployment action: generate_config, deploy, status, or logs',
+                    },
+                    platform: {
+                        type: 'string',
+                        enum: [...DEPLOY_PLATFORMS],
+                        description: 'Target cloud platform',
+                    },
+                    appName: {
+                        type: 'string',
+                        description: 'Application name (used in config generation)',
+                    },
+                    region: {
+                        type: 'string',
+                        description: 'Deployment region (e.g. iad, us-central1)',
+                    },
+                    port: {
+                        type: 'number',
+                        description: 'Application port (default: 3000)',
+                    },
+                    env: {
+                        type: 'object',
+                        description: 'Environment variables as key-value pairs',
+                    },
+                    memory: {
+                        type: 'string',
+                        description: 'Memory allocation (e.g. 512mb, 1gb)',
+                    },
+                    cpus: {
+                        type: 'number',
+                        description: 'Number of CPU cores',
+                    },
+                    outputDir: {
+                        type: 'string',
+                        description: 'Directory to write generated config files (for generate_config action)',
+                    },
+                    tailLines: {
+                        type: 'number',
+                        description: 'Number of log lines to retrieve (default: 50, for logs action)',
+                    },
+                },
+                required: ['action', 'platform'],
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.action !== 'string' || data.action.trim() === '') {
+            return { valid: false, errors: ['action must be a non-empty string'] };
+        }
+        if (!DEPLOY_ACTIONS.includes(data.action)) {
+            return { valid: false, errors: [`Unknown action: ${data.action}. Must be one of: ${DEPLOY_ACTIONS.join(', ')}`] };
+        }
+        if (typeof data.platform !== 'string' || data.platform.trim() === '') {
+            return { valid: false, errors: ['platform must be a non-empty string'] };
+        }
+        if (!DEPLOY_PLATFORMS.includes(data.platform)) {
+            return { valid: false, errors: [`Unknown platform: ${data.platform}. Must be one of: ${DEPLOY_PLATFORMS.join(', ')}`] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['deploy', 'cloud', 'fly', 'railway', 'render', 'gcp', 'hosting', 'production'],
+            priority: 6,
+            requiresConfirmation: true,
+            modifiesFiles: true,
+            makesNetworkRequests: true,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// KnowledgeGraphQueryTool
+// ============================================================================
+const KG_ACTIONS = ['query', 'add', 'subgraph', 'path', 'stats'];
+/**
+ * KnowledgeGraphQueryTool - ITool adapter for the in-memory code knowledge graph
+ */
+export class KnowledgeGraphQueryTool {
+    name = 'knowledge_graph';
+    description = 'Query the code knowledge graph for entity relationships (imports, calls, extends, exports). Add triples or query patterns.';
+    async execute(input) {
+        const { KnowledgeGraph } = await import('../../knowledge/knowledge-graph.js');
+        const graph = KnowledgeGraph.getInstance();
+        const action = input.action;
+        switch (action) {
+            case 'query': {
+                const pattern = {};
+                if (input.subject)
+                    pattern.subject = input.subject;
+                if (input.predicate)
+                    pattern.predicate = input.predicate;
+                if (input.object)
+                    pattern.object = input.object;
+                const results = graph.query(pattern);
+                if (results.length === 0) {
+                    return { success: true, output: 'No matching triples found.' };
+                }
+                const lines = results.map(t => `${t.subject} --${t.predicate}--> ${t.object}`);
+                return { success: true, output: `Found ${results.length} triple(s):\n${lines.join('\n')}` };
+            }
+            case 'add': {
+                const subject = input.subject;
+                const predicate = input.predicate;
+                const object = input.object;
+                if (!subject || !predicate || !object) {
+                    return { success: false, error: 'add requires subject, predicate, and object' };
+                }
+                const metadata = input.metadata;
+                graph.add(subject, predicate, object, metadata);
+                return { success: true, output: `Added: ${subject} --${predicate}--> ${object}` };
+            }
+            case 'subgraph': {
+                const entity = input.entity;
+                if (!entity) {
+                    return { success: false, error: 'subgraph requires entity' };
+                }
+                const depth = input.depth ?? 2;
+                const sg = graph.subgraph(entity, depth);
+                if (sg.triples.length === 0) {
+                    return { success: true, output: `No relationships found for "${entity}".` };
+                }
+                const lines = sg.triples.map(t => `${t.subject} --${t.predicate}--> ${t.object}`);
+                return {
+                    success: true,
+                    output: `Subgraph for "${entity}" (depth ${depth}, ${sg.entities.size} entities, ${sg.triples.length} triples):\n${lines.join('\n')}`,
+                };
+            }
+            case 'path': {
+                const from = input.from;
+                const to = input.to;
+                if (!from || !to) {
+                    return { success: false, error: 'path requires from and to' };
+                }
+                const maxDepth = input.maxDepth ?? 5;
+                const paths = graph.findPath(from, to, maxDepth);
+                if (paths.length === 0) {
+                    return { success: true, output: `No path found from "${from}" to "${to}".` };
+                }
+                const formatted = paths.map((p, i) => {
+                    const steps = p.map(t => `${t.subject} --${t.predicate}--> ${t.object}`);
+                    return `Path ${i + 1} (${p.length} hops):\n  ${steps.join('\n  ')}`;
+                });
+                return { success: true, output: `Found ${paths.length} path(s):\n${formatted.join('\n')}` };
+            }
+            case 'stats': {
+                const stats = graph.getStats();
+                return {
+                    success: true,
+                    output: `Knowledge Graph Stats:\n  Triples: ${stats.tripleCount}\n  Subjects: ${stats.subjectCount}\n  Predicates: ${stats.predicateCount}\n  Objects: ${stats.objectCount}`,
+                };
+            }
+            default:
+                return { success: false, error: `Unknown action: ${action}. Valid actions: ${KG_ACTIONS.join(', ')}` };
+        }
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: [...KG_ACTIONS],
+                        description: 'Action to perform on the knowledge graph',
+                    },
+                    subject: {
+                        type: 'string',
+                        description: 'Triple subject (entity name, e.g. "src/index.ts", "MyClass"). Used by query and add.',
+                    },
+                    predicate: {
+                        type: 'string',
+                        description: 'Triple predicate (relationship type: imports, exports, calls, extends, implements, dependsOn, contains, definedIn, usedBy, typeof). Used by query and add.',
+                    },
+                    object: {
+                        type: 'string',
+                        description: 'Triple object (target entity). Used by query and add.',
+                    },
+                    metadata: {
+                        type: 'object',
+                        description: 'Optional metadata key-value pairs for add action.',
+                    },
+                    entity: {
+                        type: 'string',
+                        description: 'Entity name for subgraph exploration.',
+                    },
+                    depth: {
+                        type: 'number',
+                        description: 'Max traversal depth for subgraph (default: 2).',
+                    },
+                    from: {
+                        type: 'string',
+                        description: 'Starting entity for path finding.',
+                    },
+                    to: {
+                        type: 'string',
+                        description: 'Target entity for path finding.',
+                    },
+                    maxDepth: {
+                        type: 'number',
+                        description: 'Max path length for path finding (default: 5).',
+                    },
+                },
+                required: ['action'],
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.action !== 'string' || data.action.trim() === '') {
+            return { valid: false, errors: ['action must be a non-empty string'] };
+        }
+        if (!KG_ACTIONS.includes(data.action)) {
+            return { valid: false, errors: [`Unknown action: ${data.action}. Valid: ${KG_ACTIONS.join(', ')}`] };
+        }
+        if (data.action === 'add') {
+            if (!data.subject || !data.predicate || !data.object) {
+                return { valid: false, errors: ['add action requires subject, predicate, and object'] };
+            }
+        }
+        if (data.action === 'subgraph' && !data.entity) {
+            return { valid: false, errors: ['subgraph action requires entity'] };
+        }
+        if (data.action === 'path' && (!data.from || !data.to)) {
+            return { valid: false, errors: ['path action requires from and to'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['knowledge', 'graph', 'relationships', 'imports', 'calls', 'extends', 'dependencies', 'code', 'architecture'],
+            priority: 6,
+            requiresConfirmation: false,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
 // Factory Function
 // ============================================================================
 /**
  * Create all miscellaneous tool instances
  */
+export class DocsSearchExecuteTool {
+    name = 'docs_search';
+    description = 'Search project documentation for architecture, API, security, and configuration information';
+    async execute(input) {
+        const { DocsSearchTool } = await import('../docs-search-tool.js');
+        const tool = new DocsSearchTool();
+        return tool.execute(input);
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Search query (e.g., "security model", "authentication flow")' },
+                    scope: { type: 'string', enum: ['all', 'architecture', 'api', 'security', 'config', 'testing'], description: 'Limit to a category (default: all)' },
+                },
+                required: ['query'],
+            },
+        };
+    }
+}
 export function createMiscTools() {
     return [
         new BrowserExecuteTool(),
+        new BrowserSnapshotExecuteTool(),
+        new BrowserConsoleExecuteTool(),
+        new BrowserGetImagesExecuteTool(),
+        new BrowserDialogExecuteTool(),
         new ComputerControlExecuteTool(),
         new ScreenshotExecuteTool(),
         new ReasoningExecuteTool(),
         new SkillDiscoveryExecuteTool(),
         new DeviceExecuteTool(),
+        new DeployExecuteTool(),
+        new KnowledgeGraphQueryTool(),
+        new DocsSearchExecuteTool(),
     ];
 }
 //# sourceMappingURL=misc-tools.js.map