skimpyclaw 0.3.14 → 0.4.0

package/dist/subagent.js

@@ -1,407 +0,0 @@
-// Subagent system: background task dispatch with concurrency control
-import { homedir } from 'os';
-import { join } from 'path';
-import { existsSync, mkdirSync, writeFileSync, appendFileSync } from 'fs';
-import { runAgentTurn } from './agent.js';
-import { getCurrentModel } from './gateway.js';
-import { getAgentDir } from './config.js';
-import { releaseAllLocks } from './file-lock.js';
-import { resolveModel } from './providers/utils.js';
-const DEFAULT_MAX_CONCURRENT = 5;
-const DEFAULT_MAX_RETRIES = 2;
-const REGISTRY_PATH = join(homedir(), '.skimpyclaw', 'logs', 'subagent-runs.jsonl');
-const PRESETS = {
-    coding: {
-        agentId: 'coding',
-        defaultModel: 'claude-opus',
-        toolConfig: {
-            enabled: true,
-            allowedPaths: [join(homedir(), '.skimpyclaw')],
-            maxIterations: 50,
-            bashTimeout: 30000,
-            toolProfile: 'minimal',
-        },
-        description: 'Code tasks with broad file + bash access'
-    },
-    research: {
-        agentId: 'research',
-        defaultModel: 'claude-think',
-        toolConfig: {
-            enabled: true,
-            allowedPaths: [join(homedir(), '.skimpyclaw')],
-            maxIterations: 30,
-            bashTimeout: 15000,
-            toolProfile: 'minimal',
-        },
-        description: 'Research tasks with configurable file access'
-    },
-};
-// --- Starter Templates ---
-const STARTER_TEMPLATES = {
-    coding: {
-        identity: `# IDENTITY.md - Coding Subagent
-
-Name: Coding Agent
-Emoji: 🔧
-
-You are a coding subagent dispatched for a specific task. You have file and bash access
-within your allowed paths (provided at runtime).
-
-## Your Role
-- Execute coding tasks: write code, fix bugs, refactor, run commands
-- Act on instructions directly — don't narrate what you're going to do
-- Return concise results when done
-
-## Your Limitations
-- You are short-lived: complete the task and return the result
-- You have ONLY 4 tools: Read, Write, Glob, Bash
-- Do NOT invent or hallucinate tools that don't exist
-`,
-        tools: `# TOOLS.md - Coding Subagent Tools
-
-## CRITICAL: Act, Don't Narrate
-
-**NEVER say "let me write the code" or "now I'll update the file" — just call the tool.**
-You have a LIMITED number of tool iterations. Every message you spend talking about what
-you're going to do is one less chance to actually do it.
-
-## Tool Priority — Use Native Tools First
-
-**For file operations, always prefer native tools over bash scripts. They are faster, safer, and use fewer iterations.**
-
-| Task | Use this | NOT this |
-|------|----------|----------|
-| List files/dirs | \`Glob\` | \`ls\`, \`find\`, \`python3\` scripts |
-| Read a file | \`Read\` | \`cat\`, \`python3\` scripts |
-| Write a file | \`Write\` | \`echo >\`, \`tee\`, \`python3\` scripts |
-| Run builds/tests | \`Bash\` | — |
-| Git operations | \`Bash\` | — |
-| Install packages | \`Bash\` | — |
-
-**NEVER use \`python3 -\`, \`perl -e\`, \`ruby -e\`, or other inline interpreter scripts to explore the filesystem. Use Glob and Read instead.**
-
-## Your 4 Tools
-
-### Read
-Read the contents of a file. Parameter: \`file_path\` (string, required)
-
-### Write
-Write content to a file. Parameters: \`file_path\` (string, required), \`content\` (string, required)
-
-### Glob
-List files and directories at a path. Parameter: \`path\` (string, required)
-
-### Bash
-Execute a shell command. Parameters: \`command\` (string, required), \`cwd\` (string, optional)
-Reserved for: builds, tests, git, package managers, and commands that have no native tool equivalent.
-
-## Key Paths
-- Config: ~/.skimpyclaw/config.json
-- Agent templates: ~/.skimpyclaw/agents/
-`
-    },
-    research: {
-        identity: `# IDENTITY.md - Research Subagent
-
-Name: Research Agent
-Emoji: 🔍
-
-You are a research subagent dispatched for a specific task.
-
-## Your Role
-- Research questions using vault notes and files
-- Summarize findings concisely
-- Act on instructions directly — don't narrate what you're going to do
-
-## Your Limitations
-- You are short-lived: complete the task and return the result
-- You have ONLY 4 tools: Read, Write, Glob, Bash
-- Do NOT invent or hallucinate tools that don't exist
-`,
-        tools: `# TOOLS.md - Research Subagent Tools
-
-## CRITICAL: Act, Don't Narrate
-
-**NEVER say "let me check" or "I'll look into that" — just call the tool.**
-
-## Tool Priority — Use Native Tools First
-
-**For file operations, always prefer native tools over bash scripts.**
-
-| Task | Use this | NOT this |
-|------|----------|----------|
-| List files/dirs | \`Glob\` | \`ls\`, \`find\`, \`python3\` scripts |
-| Read a file | \`Read\` | \`cat\`, \`python3\` scripts |
-| Write a file | \`Write\` | \`echo >\`, \`tee\` |
-
-**NEVER use \`python3 -\`, \`perl -e\`, or other inline interpreter scripts to explore the filesystem.**
-
-## Your 4 Tools
-
-### Read
-Read the contents of a file. Parameter: \`file_path\` (string, required)
-
-### Write
-Write content to a file. Parameters: \`file_path\` (string, required), \`content\` (string, required)
-
-### Glob
-List files and directories at a path. Parameter: \`path\` (string, required)
-
-### Bash
-Execute a shell command. Parameters: \`command\` (string, required), \`cwd\` (string, optional)
-Reserved for: git, package managers, and commands with no native tool equivalent.
-
-## Key Paths
-- Config: ~/.skimpyclaw/config.json
-- Agent templates: ~/.skimpyclaw/agents/
-- Add your notes/vault paths to allowedPaths in config before using them
-`
-    },
-};
-// Agent identity metadata for in-memory registration
-const AGENT_IDENTITIES = {
-    coding: { name: 'Coding Agent', emoji: '🔧' },
-    research: { name: 'Research Agent', emoji: '🔍' }
-};
-/**
- * Ensure agent directory and templates exist for a subagent type.
- * Creates the dir + starter IDENTITY.md + TOOLS.md if missing.
- * Registers the agent in config.agents.list (in-memory only).
- */
-export function ensureAgentSetup(type, config) {
-    const preset = PRESETS[type];
-    const agentDir = getAgentDir(preset.agentId);
-    // Create dir + starter templates if missing
-    if (!existsSync(agentDir)) {
-        mkdirSync(agentDir, { recursive: true });
-        const templates = STARTER_TEMPLATES[type];
-        writeFileSync(join(agentDir, 'IDENTITY.md'), templates.identity, 'utf-8');
-        writeFileSync(join(agentDir, 'TOOLS.md'), templates.tools, 'utf-8');
-        console.log(`[subagent] Created agent dir with templates: ${agentDir}`);
-    }
-    // Register in config.agents.list if not already there (in-memory only)
-    if (!config.agents.list[preset.agentId]) {
-        const identity = AGENT_IDENTITIES[type];
-        config.agents.list[preset.agentId] = {
-            identity,
-            model: resolveModel(preset.defaultModel || 'anthropic/claude-sonnet-4-5', config),
-            thinking: 'medium'
-        };
-        console.log(`[subagent] Registered agent in config: ${preset.agentId}`);
-    }
-}
-// Task tracking
-let taskCounter = 0;
-const tasks = new Map();
-let deliverMessage = null;
-export function initSubagentSystem(deliverFn) {
-    deliverMessage = deliverFn;
-    console.log('[subagent] System initialized');
-}
-export function getPresetDescriptions() {
-    return Object.entries(PRESETS)
-        .map(([type, preset]) => `  ${type} — ${preset.description} (default: ${preset.defaultModel || 'current model'})`)
-        .join('\n');
-}
-// --- Disk Registry ---
-function ensureRegistryDir() {
-    const dir = join(homedir(), '.skimpyclaw', 'logs');
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-}
-function appendRegistryEvent(event) {
-    try {
-        ensureRegistryDir();
-        const line = JSON.stringify({ ...event, timestamp: new Date().toISOString() }) + '\n';
-        appendFileSync(REGISTRY_PATH, line, 'utf-8');
-    }
-    catch (err) {
-        console.warn('[subagent] Failed to write registry event:', err instanceof Error ? err.message : err);
-    }
-}
-// --- Dispatch ---
-export function dispatchSubagent(type, prompt, chatId, config, modelOverride, history, options) {
-    const maxConcurrent = config.subagents?.maxConcurrent ?? DEFAULT_MAX_CONCURRENT;
-    const active = [...tasks.values()].filter((t) => t.status === 'running' || t.status === 'pending');
-    if (active.length >= maxConcurrent) {
-        throw new Error(`Max concurrent agents reached (${maxConcurrent}). Use /tasks to see running agents or /cancel to stop one.`);
-    }
-    const preset = PRESETS[type];
-    if (!preset) {
-        throw new Error(`Unknown agent type: ${type}. Use: ${Object.keys(PRESETS).join(', ')}`);
-    }
-    taskCounter++;
-    const id = `t${taskCounter}`;
-    const model = resolveModel(modelOverride || preset.defaultModel || getCurrentModel(), config);
-    const maxRetries = options?.maxRetries ?? config.subagents?.maxRetries ?? DEFAULT_MAX_RETRIES;
-    const task = {
-        id,
-        type,
-        prompt,
-        status: 'pending',
-        chatId,
-        model,
-        label: options?.label,
-        createdAt: new Date(),
-        retryCount: 0,
-        maxRetries,
-        abortController: new AbortController()
-    };
-    tasks.set(id, task);
-    // Log to disk registry
-    appendRegistryEvent({
-        type: 'task_created',
-        taskId: id,
-        agentType: type,
-        model,
-        label: options?.label,
-        prompt: prompt.slice(0, 500),
-    });
-    // Build tool config with merged paths
-    const toolConfig = {
-        ...preset.toolConfig,
-        allowedPaths: [
-            ...preset.toolConfig.allowedPaths,
-            ...(options?.allowedPaths || []),
-        ],
-    };
-    // Fire and forget — don't await
-    executeTask(task, config, toolConfig, history).catch((err) => {
-        console.error(`[subagent] Unhandled error in task ${id}:`, err);
-    });
-    return task;
-}
-async function executeTask(task, config, toolConfig, history) {
-    task.status = 'running';
-    task.startedAt = new Date();
-    const label = task.label ? ` "${task.label}"` : '';
-    console.log(`[subagent] Starting ${task.id}${label} (${task.type}, model: ${task.model})`);
-    try {
-        // Check cancellation before starting
-        if (task.abortController.signal.aborted) {
-            task.status = 'cancelled';
-            task.completedAt = new Date();
-            appendRegistryEvent({ type: 'task_cancelled', taskId: task.id });
-            return;
-        }
-        // Ensure agent dir + templates exist, register in config
-        ensureAgentSetup(task.type, config);
-        const response = await runAgentTurn(task.type, // agentId = preset.agentId = type name
-        task.prompt, config, task.model, toolConfig, history, {
-            channel: 'subagent',
-            sessionId: task.id,
-            metadata: {
-                type: task.type,
-                chatId: task.chatId,
-                label: task.label,
-            },
-            abortSignal: task.abortController.signal,
-        });
-        // Check cancellation after completion
-        if (task.abortController.signal.aborted) {
-            task.status = 'cancelled';
-            task.completedAt = new Date();
-            releaseAllLocks(task.id);
-            appendRegistryEvent({ type: 'task_cancelled', taskId: task.id });
-            return;
-        }
-        task.status = 'completed';
-        task.result = response;
-        task.completedAt = new Date();
-        // Release any file locks held by this task
-        releaseAllLocks(task.id);
-        const elapsed = Math.round((task.completedAt.getTime() - task.startedAt.getTime()) / 1000);
-        console.log(`[subagent] Completed ${task.id}${label} in ${elapsed}s`);
-        appendRegistryEvent({
-            type: 'task_completed',
-            taskId: task.id,
-            elapsed,
-            resultLength: response.length,
-        });
-        // Deliver result
-        if (deliverMessage) {
-            const labelStr = task.label ? ` (${task.label})` : '';
-            const header = `✅ Agent ${task.id}${labelStr} completed in ${elapsed}s:`;
-            await deliverMessage(task.chatId, `${header}\n\n${response}`);
-        }
-    }
-    catch (error) {
-        // Release any file locks on error
-        releaseAllLocks(task.id);
-        const errorMsg = error instanceof Error ? error.message : 'Unknown error';
-        const retryCount = task.retryCount ?? 0;
-        const maxRetries = task.maxRetries ?? DEFAULT_MAX_RETRIES;
-        // Retry if under limit and not cancelled
-        if (retryCount < maxRetries && !task.abortController.signal.aborted) {
-            task.retryCount = retryCount + 1;
-            const elapsed = Math.round((Date.now() - (task.startedAt?.getTime() || task.createdAt.getTime())) / 1000);
-            console.log(`[subagent] Task ${task.id} failed after ${elapsed}s (attempt ${retryCount + 1}/${maxRetries + 1}), retrying: ${errorMsg}`);
-            appendRegistryEvent({
-                type: 'task_retry',
-                taskId: task.id,
-                attempt: task.retryCount,
-                error: errorMsg,
-            });
-            if (deliverMessage) {
-                await deliverMessage(task.chatId, `⚠️ Agent ${task.id} failed (attempt ${retryCount + 1}/${maxRetries + 1}), retrying...\n\nError: ${errorMsg}`);
-            }
-            // Modify prompt to include error context for retry (compressed to save tokens)
-            const taskSummary = task.prompt.length > 500 ? task.prompt.slice(0, 500) + '...' : task.prompt;
-            const retryPrompt = `Retry task (attempt ${(task.retryCount ?? 0) + 1}).\n\nTask: ${taskSummary}\n\nPrevious error: ${errorMsg}\n\nTry a different approach.`;
-            task.prompt = retryPrompt;
-            task.startedAt = new Date();
-            // Retry
-            return executeTask(task, config, {
-                ...PRESETS[task.type].toolConfig,
-            }, history);
-        }
-        task.status = 'failed';
-        task.error = errorMsg;
-        task.completedAt = new Date();
-        const elapsed = Math.round((task.completedAt.getTime() -
-            (task.startedAt?.getTime() || task.createdAt.getTime())) /
-            1000);
-        console.error(`[subagent] Failed ${task.id} after ${elapsed}s (all retries exhausted):`, task.error);
-        appendRegistryEvent({
-            type: 'task_failed',
-            taskId: task.id,
-            elapsed,
-            error: task.error,
-        });
-        if (deliverMessage) {
-            await deliverMessage(task.chatId, `❌ Agent ${task.id} (${task.type}) failed after ${elapsed}s:\n\n${task.error}`);
-        }
-    }
-}
-export function cancelTask(id) {
-    const task = tasks.get(id);
-    if (!task)
-        return null;
-    if (task.status !== 'pending' && task.status !== 'running')
-        return task;
-    task.abortController.abort();
-    task.status = 'cancelled';
-    task.completedAt = new Date();
-    releaseAllLocks(task.id);
-    appendRegistryEvent({ type: 'task_cancelled', taskId: task.id });
-    console.log(`[subagent] Cancelled ${task.id}`);
-    return task;
-}
-export function getActiveTasks() {
-    return [...tasks.values()].filter((t) => t.status === 'pending' || t.status === 'running');
-}
-export function getRecentTasks(n = 10) {
-    return [...tasks.values()]
-        .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
-        .slice(0, n);
-}
-export function getTask(id) {
-    return tasks.get(id) || null;
-}
-// For testing
-export function resetForTesting() {
-    taskCounter = 0;
-    tasks.clear();
-    deliverMessage = null;
-}

package/dist/telegram.d.ts

@@ -1,2 +0,0 @@
-export { initTelegram, startTelegram, stopTelegram, getBot, setSilenceUntil, getSilenceUntil, isSilenced, sendProactiveMessage, sendProactiveVoice, getHistory, addToHistory, clearHistory, getRunContext, getDefaultTelegramToolConfig, buildHelpText, getTelegramDefaultChatId, startTypingIndicator, sendLongMessage, sendLongMessageHtml, escapeHtml, markdownToTelegramHtml, state, BOT_COMMANDS, LAUNCHD_LABEL, commandHandlers, subscribeToApprovalEvents, } from './channels/telegram/index.js';
-export type { MemoryFileInfo, TelegramContext } from './channels/telegram/types.js';

package/dist/telegram.js

@@ -1,11 +0,0 @@
-// Telegram bot - Re-export from new location for backward compatibility
-// @deprecated Import from './channels/telegram/index.js' instead
-export { 
-// Core functions
-initTelegram, startTelegram, stopTelegram, getBot, setSilenceUntil, getSilenceUntil, isSilenced, sendProactiveMessage, sendProactiveVoice, 
-// Utilities
-getHistory, addToHistory, clearHistory, getRunContext, getDefaultTelegramToolConfig, buildHelpText, getTelegramDefaultChatId, startTypingIndicator, sendLongMessage, sendLongMessageHtml, escapeHtml, markdownToTelegramHtml, 
-// Constants
-state, BOT_COMMANDS, LAUNCHD_LABEL, 
-// Handlers
-commandHandlers, subscribeToApprovalEvents, } from './channels/telegram/index.js';

package/dist/tools/browser-tool.d.ts

@@ -1,3 +0,0 @@
-import type { ToolConfig } from '../types.js';
-export declare function executeBrowser(input: Record<string, any>, config: ToolConfig): Promise<string>;
-export declare function cleanupBrowser(): Promise<void>;

package/dist/tools/browser-tool.js

@@ -1,266 +0,0 @@
-import { existsSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { homedir } from 'os';
-import { isPathAllowed } from './path-utils.js';
-import { toErrorMessage } from '../utils.js';
-let playwrightModule = null;
-let browserContext = null;
-let browserPage = null;
-let browserOptionsKey = null;
-async function getPlaywright() {
-    if (!playwrightModule) {
-        try {
-            playwrightModule = await import('playwright');
-        }
-        catch {
-            throw new Error('Playwright not installed. Run: npx playwright install');
-        }
-    }
-    return playwrightModule;
-}
-function resolveScreenshotPath(filePath, config) {
-    if (filePath) {
-        if (!isPathAllowed(filePath, config.allowedPaths)) {
-            throw new Error(`Path not allowed. Permitted: ${config.allowedPaths.join(', ')}`);
-        }
-        const dir = dirname(filePath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        return filePath;
-    }
-    const dir = join(homedir(), '.skimpyclaw', 'screenshots');
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
-    return join(dir, `shot-${stamp}.png`);
-}
-function isFileUrlAllowed(url, config) {
-    if (!url.startsWith('file://'))
-        return true;
-    if (!config.browser?.allowFile)
-        return false;
-    const filePath = new URL(url).pathname;
-    return isPathAllowed(filePath, config.allowedPaths);
-}
-/** Pick override only if it's a meaningful value (not empty string, not 0 for non-numeric fields). */
-function pick(override, configVal, fallback) {
-    if (override !== undefined && override !== null && override !== '')
-        return override;
-    if (configVal !== undefined && configVal !== null && configVal !== '')
-        return configVal;
-    return fallback;
-}
-function buildBrowserOptions(config, overrides) {
-    // Config values take priority for security/environment settings.
-    // Overrides (from model tool calls) only apply when config doesn't specify a value.
-    const type = pick(overrides?.type, config.browser?.type, 'chromium');
-    const headless = config.browser?.headless ?? overrides?.headless ?? true;
-    const slowMo = config.browser?.slowMoMs ?? ((typeof overrides?.slowMoMs === 'number' && overrides.slowMoMs > 0) ? overrides.slowMoMs : undefined);
-    const userAgent = pick(config.browser?.userAgent, overrides?.userAgent);
-    const viewport = config.browser?.viewport ?? (overrides?.viewport?.width ? overrides.viewport : undefined);
-    // Security: profileDir and executablePath are config-only — never allow model overrides
-    const profileDir = config.browser?.profileDir || join(homedir(), '.skimpyclaw', 'browser-profile');
-    const executablePath = config.browser?.executablePath;
-    return { type, headless, slowMo, userAgent, viewport, profileDir, executablePath };
-}
-async function ensureBrowser(config, overrides) {
-    const options = buildBrowserOptions(config, overrides);
-    const optionsKey = JSON.stringify(options);
-    if (browserContext && browserPage && browserOptionsKey === optionsKey)
-        return;
-    if (browserPage) {
-        await browserPage.close().catch(() => { });
-        browserPage = null;
-    }
-    if (browserContext) {
-        await browserContext.close().catch(() => { });
-        browserContext = null;
-    }
-    if (!isPathAllowed(options.profileDir, config.allowedPaths)) {
-        throw new Error(`Profile dir not allowed. Add to allowedPaths: ${options.profileDir}`);
-    }
-    if (!existsSync(options.profileDir)) {
-        mkdirSync(options.profileDir, { recursive: true });
-    }
-    const pw = await getPlaywright();
-    const browserLauncher = pw[options.type] || pw.chromium;
-    try {
-        browserContext = await browserLauncher.launchPersistentContext(options.profileDir, {
-            headless: options.headless,
-            slowMo: options.slowMo,
-            userAgent: options.userAgent,
-            viewport: options.viewport,
-            executablePath: options.executablePath,
-            args: [
-                '--disable-blink-features=AutomationControlled',
-                '--no-first-run',
-                '--no-default-browser-check',
-            ],
-            ignoreDefaultArgs: ['--enable-automation', '--no-sandbox'],
-        });
-    }
-    catch (err) {
-        const msg = toErrorMessage(err);
-        throw new Error(`Failed to launch browser (${options.type}): ${msg}. Ensure the browser is installed: npx playwright install ${options.type}`);
-    }
-    const pages = browserContext.pages();
-    browserPage = pages.length > 0 ? pages[0] : await browserContext.newPage();
-    // Remove navigator.webdriver flag that sites use to detect automation
-    await browserPage.addInitScript(`Object.defineProperty(navigator, 'webdriver', { get: () => false })`);
-    browserOptionsKey = optionsKey;
-}
-export async function executeBrowser(input, config) {
-    if (!config.browser?.enabled) {
-        return 'Error: Browser tool is disabled. Enable it in config (tools.browser.enabled).';
-    }
-    const action = String(input.action || '').toLowerCase();
-    const timeoutMs = typeof input.timeoutMs === 'number' ? input.timeoutMs : 30_000;
-    switch (action) {
-        case 'open': {
-            const url = input.url;
-            if (!url)
-                return 'Error: url is required for open.';
-            if (!isFileUrlAllowed(url, config)) {
-                return 'Error: file:// URLs are blocked. Enable tools.browser.allowFile to allow.';
-            }
-            await ensureBrowser(config, input);
-            await browserPage.goto(url, { timeout: timeoutMs, waitUntil: 'domcontentloaded' });
-            return `Opened: ${url}`;
-        }
-        case 'click': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            if (!selector)
-                return 'Error: selector is required for click.';
-            await browserPage.click(selector, { timeout: timeoutMs });
-            return `Clicked: ${selector}`;
-        }
-        case 'type': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            const text = input.text;
-            if (!selector || text === undefined)
-                return 'Error: selector and text are required for type.';
-            await browserPage.fill(selector, text, { timeout: timeoutMs });
-            return `Typed into: ${selector}`;
-        }
-        case 'waitfor': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            const text = input.text;
-            if (!selector && !text)
-                return 'Error: selector or text is required for waitFor.';
-            if (selector) {
-                await browserPage.waitForSelector(selector, { timeout: timeoutMs });
-                return `Waited for selector: ${selector}`;
-            }
-            await browserPage.waitForSelector(`text=${text}`, { timeout: timeoutMs });
-            return `Waited for text: ${text}`;
-        }
-        case 'select': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            const value = input.text;
-            if (!selector || value === undefined)
-                return 'Error: selector and text (value) are required for select.';
-            await browserPage.selectOption(selector, value, { timeout: timeoutMs });
-            return `Selected "${value}" in: ${selector}`;
-        }
-        case 'hover': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            if (!selector)
-                return 'Error: selector is required for hover.';
-            await browserPage.hover(selector, { timeout: timeoutMs });
-            return `Hovered: ${selector}`;
-        }
-        case 'scroll': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            if (selector) {
-                await browserPage.evaluate(`{
-          const el = document.querySelector(${JSON.stringify(selector)});
-          if (el) el.scrollIntoView({ behavior: 'smooth' });
-        }`);
-                return `Scrolled into view: ${selector}`;
-            }
-            const direction = (input.direction || 'down').toLowerCase();
-            const amount = typeof input.amount === 'number' ? input.amount : undefined;
-            const dir = direction === 'up' ? -1 : 1;
-            const scrollExpr = amount != null
-                ? `window.scrollBy(0, ${dir * amount})`
-                : `window.scrollBy(0, ${dir} * window.innerHeight)`;
-            await browserPage.evaluate(scrollExpr);
-            return `Scrolled ${direction}${amount ? ` ${amount}px` : ' one viewport'}`;
-        }
-        case 'evaluate': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const script = input.script;
-            if (!script)
-                return 'Error: script is required for evaluate.';
-            const result = await browserPage.evaluate(script);
-            return JSON.stringify(result);
-        }
-        case 'gettext': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const selector = input.selector;
-            if (selector) {
-                const text = await browserPage.textContent(selector, { timeout: timeoutMs });
-                return text ?? '(no text content)';
-            }
-            const bodyText = await browserPage.evaluate('document.body.innerText');
-            return bodyText || '(empty page)';
-        }
-        case 'screenshot': {
-            if (!browserPage)
-                return 'Error: Browser not open. Call open(url) first.';
-            const filePath = resolveScreenshotPath(input.file_path, config);
-            await browserPage.screenshot({ path: filePath, fullPage: true });
-            return `Saved screenshot: ${filePath}`;
-        }
-        case 'wait': {
-            const waitMs = typeof input.timeMs === 'number' ? input.timeMs : timeoutMs;
-            await new Promise((r) => setTimeout(r, waitMs));
-            return `Waited ${waitMs}ms`;
-        }
-        case 'close': {
-            await cleanupBrowser();
-            return 'Browser closed.';
-        }
-        default:
-            return `Error: Unknown browser action "${action}"`;
-    }
-}
-export async function cleanupBrowser() {
-    if (browserPage) {
-        await browserPage.close().catch(() => { });
-        browserPage = null;
-    }
-    if (browserContext) {
-        await browserContext.close().catch(() => { });
-        browserContext = null;
-    }
-    browserOptionsKey = null;
-}
-// Prevent orphaned browser processes on exit
-const handleExit = () => {
-    if (browserContext) {
-        browserContext.close().catch(() => { });
-        browserContext = null;
-        browserPage = null;
-        browserOptionsKey = null;
-    }
-};
-process.on('SIGTERM', handleExit);
-process.on('SIGINT', handleExit);
-process.on('exit', handleExit);