@mseep/clawdcursor 1.5.5

package/dist/tools/cdp.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Browser CDP tools — interact with web page DOM via Chrome DevTools Protocol.
+ *
+ * Structured access to browser page elements without screenshots.
+ * Requires: Edge/Chrome running with --remote-debugging-port
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCdpTools = getCdpTools;
+const browser_config_1 = require("../llm/browser-config");
+function getCdpTools() {
+    return [
+        {
+            name: 'cdp_connect',
+            description: `Connect to Edge/Chrome browser via Chrome DevTools Protocol (port ${browser_config_1.DEFAULT_CDP_PORT}). Must be called before other cdp_* tools. Use navigate_browser to launch Edge with CDP enabled.`,
+            parameters: {},
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async (_params, ctx) => {
+                try {
+                    await ctx.cdp.disconnect();
+                }
+                catch { /* ignore */ }
+                const ok = await ctx.cdp.connect();
+                if (ok) {
+                    const url = await ctx.cdp.getUrl();
+                    const title = await ctx.cdp.getTitle();
+                    // cdp_connect ATTACHES to whatever browser is already on the debug
+                    // port — which is typically the USER'S own session. Disclose it so
+                    // the agent knows navigation/tab actions affect the user's tabs, not
+                    // a private instance (gauntlet F2).
+                    return { text: `Attached to the EXISTING browser on port ${browser_config_1.DEFAULT_CDP_PORT}: "${title}" at ${url}. ⚠ This is likely the user's own session — reads see their current page; the first navigation automatically opens the agent's OWN tab so their tabs are never navigated away. Do not close their tabs/windows.` };
+                }
+                return { text: `Failed to connect to CDP on port ${browser_config_1.DEFAULT_CDP_PORT}. Use navigate_browser to launch Edge with CDP.`, isError: true };
+            },
+        },
+        {
+            name: 'cdp_page_context',
+            description: 'Get a structured list of interactive elements on the current browser page (inputs, buttons, links with selectors and positions).',
+            parameters: {},
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const context = await ctx.cdp.getPageContext();
+                return { text: context };
+            },
+        },
+        {
+            name: 'cdp_read_text',
+            description: 'Read text content from a DOM element. Useful for extracting information from web pages.',
+            parameters: {
+                selector: { type: 'string', description: 'CSS selector (default: "body" for full page text)', required: false },
+                maxLength: { type: 'number', description: 'Max characters to return (default: 3000)', required: false },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 0,
+            handler: async ({ selector, maxLength }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const text = await ctx.cdp.readText(selector ?? 'body', maxLength ?? 3000);
+                return { text };
+            },
+        },
+        {
+            name: 'cdp_click',
+            description: 'Click a DOM element by CSS selector or by visible text content.',
+            parameters: {
+                selector: { type: 'string', description: 'CSS selector to click (e.g. "#submit", "button.primary")', required: false },
+                text: { type: 'string', description: 'Visible text of the element to click (alternative to selector)', required: false },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async ({ selector, text }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                if (!selector && !text)
+                    return { text: 'Provide either selector or text parameter.', isError: true };
+                const result = text ? await ctx.cdp.clickByText(text) : await ctx.cdp.click(selector);
+                return {
+                    text: result.success ? `Clicked: ${selector || `"${text}"`} (method: ${result.method})` : `Click failed: ${result.error}`,
+                    isError: !result.success,
+                };
+            },
+        },
+        {
+            name: 'cdp_type',
+            description: 'Type text into a DOM input field by CSS selector or by associated label text.',
+            parameters: {
+                selector: { type: 'string', description: 'CSS selector for the input field', required: false },
+                label: { type: 'string', description: 'Label text associated with the input (alternative to selector)', required: false },
+                text: { type: 'string', description: 'Text to type into the field', required: true },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async ({ selector, label, text }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                if (!selector && !label)
+                    return { text: 'Provide either selector or label parameter.', isError: true };
+                const result = label ? await ctx.cdp.typeByLabel(label, text) : await ctx.cdp.typeInField(selector, text);
+                return {
+                    text: result.success ? `Typed "${text.substring(0, 60)}" into ${selector || `label="${label}"`}` : `Type failed: ${result.error}`,
+                    isError: !result.success,
+                };
+            },
+        },
+        {
+            name: 'cdp_select_option',
+            description: 'Select an option in a <select> dropdown by value or visible text.',
+            parameters: {
+                selector: { type: 'string', description: 'CSS selector for the <select> element', required: true },
+                value: { type: 'string', description: 'Option value or visible text to select', required: true },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async ({ selector, value }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const result = await ctx.cdp.selectOption(selector, value);
+                return { text: result.success ? `Selected "${value}" in ${selector}` : `Select failed: ${result.error}`, isError: !result.success };
+            },
+        },
+        {
+            name: 'cdp_evaluate',
+            description: 'Execute JavaScript in the browser page context. Returns the result.',
+            parameters: {
+                javascript: { type: 'string', description: 'JavaScript code to evaluate in the page', required: true },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 3,
+            handler: async ({ javascript }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                try {
+                    const result = await ctx.cdp.evaluate(javascript);
+                    const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                    return { text: text ?? '(undefined)' };
+                }
+                catch (e) {
+                    return { text: `JS error: ${e.message}`, isError: true };
+                }
+            },
+        },
+        {
+            name: 'cdp_wait_for_selector',
+            description: 'Wait for a DOM element matching a CSS selector to appear and become visible.',
+            parameters: {
+                selector: { type: 'string', description: 'CSS selector to wait for', required: true },
+                timeout: { type: 'number', description: 'Timeout in milliseconds (default: 10000)', required: false },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 0,
+            handler: async ({ selector, timeout }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const result = await ctx.cdp.waitForSelector(selector, timeout ?? 10000);
+                return { text: result.success ? `Element "${selector}" found` : `Wait failed: ${result.error}`, isError: !result.success };
+            },
+        },
+        {
+            name: 'cdp_list_tabs',
+            description: 'List all open browser tabs with their URLs and titles.',
+            parameters: {},
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 0,
+            handler: async () => {
+                try {
+                    const resp = await fetch(`http://127.0.0.1:${browser_config_1.DEFAULT_CDP_PORT}/json`);
+                    const tabs = await resp.json();
+                    const pages = tabs.filter((t) => t.type === 'page' && !t.url.startsWith('edge://') && !t.url.startsWith('chrome://'));
+                    if (!pages.length)
+                        return { text: '(no tabs found)' };
+                    const lines = pages.map((t, i) => `${i + 1}. "${t.title}" — ${t.url}`);
+                    return { text: lines.join('\n') };
+                }
+                catch {
+                    return { text: `Cannot list tabs. Use navigate_browser first to launch Edge with CDP on port ${browser_config_1.DEFAULT_CDP_PORT}.`, isError: true };
+                }
+            },
+        },
+        {
+            name: 'cdp_switch_tab',
+            description: 'Switch CDP connection to a different browser tab by URL or title substring.',
+            parameters: {
+                target: { type: 'string', description: 'URL or title substring to match', required: true },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async ({ target }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const ok = await ctx.cdp.switchTab(target);
+                if (ok) {
+                    const url = await ctx.cdp.getUrl();
+                    const title = await ctx.cdp.getTitle();
+                    return { text: `Switched to: "${title}" at ${url}` };
+                }
+                return { text: `No tab matching "${target}" found.`, isError: true };
+            },
+        },
+        {
+            name: 'cdp_scroll',
+            description: 'Scroll the browser page via DOM (window.scrollBy). Works regardless of mouse position — use for reliable page scrolling.',
+            parameters: {
+                direction: { type: 'string', description: 'Scroll direction', required: true, enum: ['up', 'down'] },
+                amount: { type: 'number', description: 'Pixels to scroll (default: 500)', required: false },
+            },
+            category: 'browser',
+            compactGroup: 'browser',
+            safetyTier: 1,
+            handler: async ({ direction, amount }, ctx) => {
+                if (!(await ctx.cdp.isConnected()))
+                    return { text: 'Not connected to CDP. Call cdp_connect first.', isError: true };
+                const pixels = (amount ?? 500) * (direction === 'down' ? 1 : -1);
+                await ctx.cdp.evaluate(`window.scrollBy(0, ${pixels})`);
+                return { text: `Scrolled ${direction} by ${Math.abs(pixels)} pixels` };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=cdp.js.map

package/dist/tools/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/tools/cdp.ts"],"names":[],"mappings":"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"}

package/dist/tools/compact.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Compact MCP surface — 6 compound tools covering every granular
+ * primitive, Anthropic-Computer-Use-style.
+ *
+ * Why this exists:
+ *   An agent driving clawdcursor via MCP otherwise sees 97 granular
+ *   tool schemas (~18,000 tokens of tool catalog). Most models
+ *   over-think the choice, pick near-duplicates, and burn context.
+ *   This file collapses the granular tools into 6 action-discriminated
+ *   compound tools — the same "1 tool with N sub-actions" shape that
+ *   Anthropic uses for computer_20250124.
+ *
+ *   Net effect: the LLM sees ~1,500 tokens of tool catalog, picks a
+ *   COMPOUND first (which primitive SPACE do I want?), then an
+ *   ACTION (which specific operation?), then fills in the args.
+ *   Decision trees shrink, accuracy rises.
+ *
+ * The 6 compounds cover EXACTLY the granular tool set — no new
+ * capability, no removed capability. Every compact action maps to
+ * exactly one granular tool via the delegation table. The granular
+ * surface stays available (same repo, same schemas); agents simply
+ * pick which shape to consume.
+ *
+ * Selection:
+ *   `clawdcursor mcp`             → 97 granular tools (back-compat)
+ *   `clawdcursor mcp --compact`   → 6 compound tools (this file)
+ *   GET /tools?mode=compact      → REST gets the same compact schemas
+ *
+ * Extending:
+ *   Add a new granular tool → map it in the `ACTION_MAP` below under
+ *   its owning compound. No other wiring needed; dispatcher picks it
+ *   up automatically.
+ */
+import type { ToolDefinition } from './types';
+/**
+ * One row per compact sub-action.
+ *
+ *   compound:   which compound tool the LLM calls (computer/accessibility/…)
+ *   action:     the enum value for that compound's `action` arg
+ *   delegate:   the granular tool name to dispatch to
+ *   argRemap:   optional — rename fields before handing off (e.g. the
+ *               compound's `combo` → granular `key_press`'s `key`).
+ */
+interface ActionRoute {
+    action: string;
+    delegate: string;
+    argRemap?: Record<string, string>;
+}
+/**
+ * Shared runtime: look up the granular tool for a compact (compound,
+ * action) pair, optionally remap args, then hand off. Surfacing the
+ * same ToolResult contract the granular tool returns.
+ */
+/**
+ * Index of every compound's action table — lets a misrouted action point the
+ * caller at the compound that actually owns it (e.g. `system open_app` →
+ * "that action is on `window`"), instead of a dead-end "unknown action".
+ */
+export declare const COMPOUND_ROUTE_INDEX: Record<string, ActionRoute[]>;
+export declare function getCompactTools(): ToolDefinition[];
+/** Names of all compact tools (for tier + doc lookups). */
+export declare const COMPACT_TOOL_NAMES: readonly ["computer", "accessibility", "window", "system", "browser", "task", "batch"];
+export {};