@mseep/clawdcursor 1.5.5

package/dist/tools/agent.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Agent-control tools — drive the autonomous Agent from outside the daemon.
+ *
+ * These are the MCP equivalents of the legacy REST routes that lived in
+ * src/server.ts (POST /task, POST /abort, GET /status, GET /screenshot,
+ * GET /task-logs, GET /task-logs/current). Each tool reaches into
+ * `ctx.agent` — populated by the daemon when it constructs the MCP server,
+ * and undefined when running through stdio MCP without a live agent.
+ *
+ * Tools that require an agent return an `isError` result with a clear
+ * message rather than throwing — clients shouldn't crash because they
+ * called submit_task on a stdio MCP that has no Pipeline wired.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentTools = getAgentTools;
+const fs = __importStar(require("fs"));
+function needAgent(tool) {
+    return {
+        text: `${tool}: no autonomous agent is attached to this MCP context. ` +
+            `This tool needs \`clawdcursor agent\` running WITH an LLM configured. ` +
+            `Tools-only contexts (stdio \`clawdcursor mcp\`, or \`agent --no-llm\`) cannot use it — ` +
+            `drive the desktop yourself with the other tools instead: the compound ` +
+            `computer/accessibility/window/system/browser tools (compact surface), ` +
+            `or the granular mouse_click/type_text/… tools.`,
+        isError: true,
+    };
+}
+function getAgentTools() {
+    return [
+        {
+            name: 'submit_task',
+            description: 'Submit a natural-language task to the autonomous agent. The agent ' +
+                'classifies, decomposes, and executes the task through the unified ' +
+                'pipeline (a11y → text-agent → vision fallback). Returns immediately ' +
+                'with `accepted: true`; poll agent_status to track progress. ' +
+                'Runs locally on a cheap model — prefer this over driving the ' +
+                'mouse_*/screenshot tools yourself to save tokens.',
+            parameters: {
+                task: { type: 'string', description: 'Natural-language task', required: true },
+            },
+            category: 'orchestration',
+            compactGroup: 'task',
+            safetyTier: 1,
+            handler: async ({ task }, ctx) => {
+                if (!ctx.agent)
+                    return needAgent('submit_task');
+                const trimmed = String(task ?? '').trim();
+                if (!trimmed) {
+                    return { text: 'submit_task: task must be a non-empty string', isError: true };
+                }
+                if (trimmed.length > 2000) {
+                    return { text: 'submit_task: task is too long (max 2000 chars)', isError: true };
+                }
+                const state = ctx.agent.getState();
+                if (state.status !== 'idle') {
+                    return {
+                        text: `Agent is busy (status=${state.status}). Wait or call abort_task first.`,
+                        isError: true,
+                    };
+                }
+                // Fire-and-poll: kick off the task, return acceptance immediately.
+                // The agent updates its own state; clients use agent_status to track.
+                ctx.agent.executeTask(trimmed).catch((err) => {
+                    // Errors are surfaced via agent state + the daemon's log buffer.
+                    // Don't re-throw here — submit_task already returned.
+                    console.error('submit_task: pipeline error', err?.message ?? err);
+                });
+                return { text: JSON.stringify({ accepted: true, task: trimmed }) };
+            },
+        },
+        {
+            name: 'abort_task',
+            description: 'Signal the running task to abort. The pipeline checks `isAborted()` ' +
+                'between steps; long-running LLM calls may take a few seconds to ' +
+                'wind down. agent_status will return `idle` once the abort has settled.',
+            parameters: {},
+            category: 'orchestration',
+            compactGroup: 'task',
+            safetyTier: 1,
+            handler: async (_params, ctx) => {
+                if (!ctx.agent)
+                    return needAgent('abort_task');
+                ctx.agent.abort();
+                return { text: JSON.stringify({ aborted: true }) };
+            },
+        },
+        {
+            name: 'agent_status',
+            description: 'Return the autonomous agent\'s current state: status (idle | thinking | ' +
+                'acting | waiting_confirm), currentTask, currentStep, stepsCompleted, ' +
+                'stepsTotal. Cheap (synchronous read) — safe to poll at 1–2 Hz.',
+            parameters: {},
+            category: 'orchestration',
+            compactGroup: 'system',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                if (!ctx.agent) {
+                    // Stdio MCP — there's no daemon. Surface a sentinel state so
+                    // clients can degrade gracefully instead of crashing.
+                    return {
+                        text: JSON.stringify({
+                            status: 'no_agent',
+                            stepsCompleted: 0,
+                            stepsTotal: 0,
+                        }),
+                    };
+                }
+                return { text: JSON.stringify(ctx.agent.getState()) };
+            },
+        },
+        {
+            name: 'screenshot_full',
+            description: 'Capture the full primary display. Returns base64 image bytes plus a ' +
+                '`format` field (`jpeg` by default, `png` if configured); the MCP ' +
+                '`image.mimeType` is set to match. Equivalent to desktop_screenshot ' +
+                'but returns the full frame unconditionally (no region cropping). ' +
+                'Useful for the dashboard\'s /screenshot REST replacement.',
+            parameters: {},
+            category: 'perception',
+            compactGroup: 'computer',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                try {
+                    await ctx.ensureInitialized();
+                    const frame = await ctx.desktop.captureForLLM();
+                    // captureForLLM returns { buffer, scaleFactor, llmWidth, llmHeight,
+                    // format }. Format is configured per-capture (`'jpeg'` by default,
+                    // sometimes `'png'`); use it to set the correct mimeType instead
+                    // of the previous hardcoded 'image/png' which lied for the JPEG path.
+                    const b64 = Buffer.isBuffer(frame.buffer)
+                        ? frame.buffer.toString('base64')
+                        : Buffer.from(frame.buffer).toString('base64');
+                    const mimeType = frame.format === 'png' ? 'image/png' : 'image/jpeg';
+                    return {
+                        text: JSON.stringify({
+                            scaleFactor: frame.scaleFactor,
+                            llmWidth: frame.llmWidth,
+                            llmHeight: frame.llmHeight,
+                            format: frame.format,
+                        }),
+                        image: { data: b64, mimeType },
+                    };
+                }
+                catch (err) {
+                    return { text: `Screenshot failed: ${err.message}`, isError: true };
+                }
+            },
+        },
+        {
+            name: 'task_logs_list',
+            description: 'List the last 50 task summaries from the daemon\'s structured log. ' +
+                'Each summary contains task text, correlation ID, start/end timestamps, ' +
+                'and final status. Returns [] when no logger is attached.',
+            parameters: {},
+            category: 'orchestration',
+            compactGroup: 'system',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                if (!ctx.agent)
+                    return { text: '[]' };
+                try {
+                    const logger = ctx.agent.logger;
+                    if (!logger || typeof logger.getRecentSummaries !== 'function') {
+                        return { text: '[]' };
+                    }
+                    return { text: JSON.stringify(logger.getRecentSummaries(50)) };
+                }
+                catch {
+                    return { text: '[]' };
+                }
+            },
+        },
+        {
+            name: 'task_logs_current',
+            description: 'Return the structured log entries for the currently-executing task ' +
+                '(or the most recent if no task is running). Each entry is a JSONL ' +
+                'event from the pipeline trace.',
+            parameters: {},
+            category: 'orchestration',
+            compactGroup: 'system',
+            safetyTier: 0,
+            handler: async (_params, ctx) => {
+                if (!ctx.agent) {
+                    return { text: 'task_logs_current: no agent attached', isError: true };
+                }
+                try {
+                    const logger = ctx.agent.logger;
+                    const logPath = logger?.getCurrentLogPath?.();
+                    if (!logPath || !fs.existsSync(logPath)) {
+                        return { text: 'task_logs_current: no current log file', isError: true };
+                    }
+                    const content = fs.readFileSync(logPath, 'utf-8');
+                    const entries = content
+                        .trim()
+                        .split('\n')
+                        .map((l) => {
+                        try {
+                            return JSON.parse(l);
+                        }
+                        catch {
+                            return null;
+                        }
+                    })
+                        .filter(Boolean);
+                    return { text: JSON.stringify(entries) };
+                }
+                catch (err) {
+                    return { text: `task_logs_current: ${err.message}`, isError: true };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=agent.js.map

package/dist/tools/agent.js.map

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

package/dist/tools/batch.d.ts

@@ -0,0 +1,46 @@
+import type { ToolContext, ToolDefinition } from './types';
+/** A lightweight, declarative precondition checked (by re-perceiving) before a step runs. */
+export interface BatchGuard {
+    /** An a11y element with this name must be present in the current UI. */
+    element?: string;
+    /** The foreground/active window's title or processName must contain this (case-insensitive). */
+    window?: string;
+}
+export interface BatchStep {
+    /** Tool name — a compound (`computer`/`window`/…) with `arguments.action`, or a granular tool. */
+    name: string;
+    arguments?: Record<string, unknown>;
+    /** Optional precondition; if it fails the batch halts here and reports back. */
+    expect?: BatchGuard;
+    /** Canonical alias for `expect` (matches the agent-loop batch). An `expect`
+     *  ASSERTION ARRAY belongs inside `arguments` instead — the projected tool
+     *  handlers verify it post-action. */
+    precheck?: BatchGuard;
+    /** Optional human label for the trace. */
+    label?: string;
+}
+type StepStatus = 'ok' | 'guard_failed' | 'blocked' | 'needs_confirm' | 'error' | 'unknown_tool' | 'skipped';
+export interface StepOutcome {
+    i: number;
+    label: string;
+    status: StepStatus;
+    text: string;
+}
+export interface BatchResult {
+    total: number;
+    completed: number;
+    allDone: boolean;
+    stoppedAt?: number;
+    stopReason?: string;
+    steps: StepOutcome[];
+}
+/**
+ * Run an ordered list of guarded tool calls, halting on the first guard miss,
+ * safety stop, or step error. Reuses the real safety gate + tool handlers.
+ */
+export declare function executeBatch(steps: BatchStep[], ctx: ToolContext, opts?: {
+    allowConfirm?: boolean;
+    maxSteps?: number;
+}): Promise<BatchResult>;
+export declare function getBatchTools(): ToolDefinition[];
+export {};

package/dist/tools/batch.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeBatch = executeBatch;
+exports.getBatchTools = getBatchTools;
+/**
+ * Guarded action-sequence executor + the `batch` tool.
+ *
+ * Lets an AI driving clawdcursor (over MCP, or the autonomous loop) submit an
+ * ORDERED LIST of tool calls that run in one shot — collapsing N round-trips
+ * into one — WITHOUT a code sandbox. It is DECLARATIVE on purpose:
+ *
+ *   - Each step is `{ name, arguments, expect? }` — a normal tool call plus an
+ *     optional precondition guard. No arbitrary code → no injection-as-control-
+ *     flow, no element-handle staleness (every step re-queries by name), no
+ *     opaque partial-execution blob.
+ *   - Every step routes through the SAME `evaluateToolCall` safety gate and the
+ *     SAME `getTool().handler` execution path the MCP server uses per call.
+ *   - Between steps the executor RE-PERCEIVES to check each step's `expect`
+ *     guard; on any guard miss / safety stop / step error it HALTS and returns
+ *     a structured trace so the caller re-plans from real state (the morph
+ *     ladder's recovery, just coarser).
+ *
+ * This is the "batched planning" middle path: most of Code Mode's efficiency,
+ * none of the sandbox's hard problems (see the architecture review).
+ */
+const registry_1 = require("./registry");
+const safety_gate_1 = require("./safety-gate");
+const window_text_1 = require("./window-text");
+/** Resolve a step's tool by name from EITHER surface — a granular tool
+ *  (`mouse_click`, `open_app`, …) or a compound tool (`computer`, `window`, …)
+ *  — so a batch works whether the caller drives the 97-tool or 6-compound API. */
+function resolveAnyTool(name) {
+    return (0, registry_1.getTool)(name) ?? (0, registry_1.getCompactTools)().find(t => t.name === name);
+}
+const DEFAULT_MAX_STEPS = 12;
+function labelFor(step) {
+    if (step.label)
+        return step.label;
+    const action = step.arguments?.action;
+    return action ? `${step.name}.${String(action)}` : step.name;
+}
+/** Re-perceive and evaluate a step's precondition guard. Returns ok=false with a reason on miss. */
+async function checkGuard(guard, ctx) {
+    if (guard.window) {
+        const t = (0, registry_1.getTool)('get_active_window');
+        if (t) {
+            const r = await t.handler({}, ctx).catch((e) => ({ text: String(e), isError: true }));
+            // Window-aware normalization: real titles carry invisible Unicode (Edge's
+            // NBSP in "Microsoft Edge") that defeats a plain substring compare (#bug
+            // 2026-06-11).
+            if (!(0, window_text_1.windowTextIncludes)(r.text, guard.window)) {
+                return { ok: false, detail: `foreground window is not "${guard.window}" (got: ${(r.text || '').slice(0, 90)})` };
+            }
+        }
+    }
+    if (guard.element) {
+        const t = (0, registry_1.getTool)('find_element');
+        if (t) {
+            const r = await t.handler({ name: guard.element }, ctx).catch((e) => ({ text: String(e), isError: true }));
+            // Element presence is decided by find_element's own absence markers, not
+            // by title matching — leave this ASCII-literal (the window guard above is
+            // where the invisible-Unicode normalization matters).
+            const txt = (r.text || '').toLowerCase();
+            const missing = r.isError || txt.includes('not found') || txt.includes('no match') || txt.includes('no element') || /\b0 (match|element)/.test(txt);
+            if (missing)
+                return { ok: false, detail: `element "${guard.element}" not present` };
+        }
+    }
+    return { ok: true, detail: '' };
+}
+/**
+ * Run an ordered list of guarded tool calls, halting on the first guard miss,
+ * safety stop, or step error. Reuses the real safety gate + tool handlers.
+ */
+async function executeBatch(steps, ctx, opts = {}) {
+    const cap = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+    const outcomes = [];
+    let completed = 0;
+    const halt = (i, reason) => ({ total: steps.length, completed, allDone: false, stoppedAt: i, stopReason: reason, steps: outcomes });
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const label = labelFor(step);
+        if (i >= cap) {
+            outcomes.push({ i, label, status: 'skipped', text: `not run — batch capped at ${cap} steps` });
+            return halt(i, `batch capped at ${cap} steps; submit the remainder as a new batch`);
+        }
+        const tool = resolveAnyTool(step.name);
+        if (!tool) {
+            outcomes.push({ i, label, status: 'unknown_tool', text: `tool "${step.name}" is not registered` });
+            return halt(i, `unknown tool "${step.name}"`);
+        }
+        // Precondition: re-perceive and verify the step's expectation.
+        // `precheck` is the canonical name (parity with the agent-loop batch);
+        // `expect` remains the documented MCP alias for back-compat.
+        const guard = step.precheck ?? step.expect;
+        if (guard) {
+            const g = await checkGuard(guard, ctx);
+            if (!g.ok) {
+                outcomes.push({ i, label, status: 'guard_failed', text: `precondition failed: ${g.detail}` });
+                return halt(i, `precondition failed at step ${i} — re-plan from current state`);
+            }
+        }
+        const args = step.arguments ?? {};
+        // Safety — identical gate to a normal tools/call (incl. el_NN → label
+        // resolution via the shared holder, same as the direct MCP path).
+        const safetyErr = (0, safety_gate_1.evaluateToolCall)(tool, args, { uiMaps: ctx.uiMaps });
+        if (safetyErr) {
+            const isConfirm = (safetyErr.text || '').includes('safety confirm');
+            if (!(isConfirm && opts.allowConfirm)) {
+                outcomes.push({ i, label, status: isConfirm ? 'needs_confirm' : 'blocked', text: safetyErr.text });
+                return halt(i, isConfirm ? `step ${i} needs confirmation (re-submit with allowConfirm:true if intended)` : `step ${i} blocked by safety`);
+            }
+        }
+        // Execute via the real handler.
+        let res;
+        try {
+            res = await tool.handler(args, ctx);
+        }
+        catch (e) {
+            res = { text: `threw: ${e instanceof Error ? e.message : String(e)}`, isError: true };
+        }
+        if (res.isError) {
+            outcomes.push({ i, label, status: 'error', text: (res.text || '').slice(0, 200) });
+            return halt(i, `step ${i} (${label}) errored`);
+        }
+        outcomes.push({ i, label, status: 'ok', text: (res.text || '').slice(0, 160) });
+        completed++;
+    }
+    return { total: steps.length, completed, allDone: completed === steps.length, steps: outcomes };
+}
+/** Pre-flight: scan each step's safety tier WITHOUT executing. */
+function dryRunScan(steps) {
+    return steps.map((step, i) => {
+        const label = labelFor(step);
+        const tool = resolveAnyTool(step.name);
+        if (!tool)
+            return { i, label, gate: 'unknown-tool' };
+        const err = (0, safety_gate_1.evaluateToolCall)(tool, step.arguments ?? {});
+        const gate = !err ? 'allow' : (err.text.includes('safety confirm') ? 'confirm' : 'block');
+        return { i, label, gate };
+    });
+}
+function renderResult(r) {
+    const lines = r.steps.map(s => `  ${s.i}. [${s.status}] ${s.label} — ${s.text}`);
+    const head = r.allDone
+        ? `batch: all ${r.total} steps completed.`
+        : `batch: ${r.completed}/${r.total} completed, halted at step ${r.stoppedAt} — ${r.stopReason}`;
+    return `${head}\n${lines.join('\n')}`;
+}
+function getBatchTools() {
+    return [
+        {
+            name: 'batch',
+            description: 'Run an ORDERED LIST of tool calls in one shot (collapses many round-trips into one). Each step is ' +
+                '{ name, arguments, expect? }. `name`+`arguments` is a normal tool call (compound like ' +
+                '{"name":"computer","arguments":{"action":"type","text":"hi"}} or a granular tool). Optional `expect` ' +
+                'is a precondition checked by RE-PERCEIVING before the step runs: {"window":"notepad"} (foreground ' +
+                'window must match) or {"element":"Send"} (a11y element must be present). The batch HALTS on the first ' +
+                'failed precondition, safety stop, or step error and returns a per-step trace so you re-plan from real ' +
+                'state. Every step goes through the same safety gate as a direct call. Use `expect` to guarantee you ' +
+                'act on the right window/element instead of guessing. Set dryRun:true to pre-scan safety tiers without ' +
+                'executing; allowConfirm:true to let confirm-tier steps proceed.',
+            parameters: {
+                steps: {
+                    type: 'array',
+                    required: true,
+                    description: 'Ordered steps to run. Each step is a normal tool call: { "name": "<tool>", "arguments": {...}, "expect"?: {"window"?,"element"?} }. (A JSON-encoded string of the same array is also accepted.)',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'Tool to call — a compound ("computer"/"window"/...) or a granular tool.' },
+                            arguments: { type: 'object', description: 'Arguments for that tool, e.g. {"action":"type","text":"hi"}. May include an `expect` ASSERTION ARRAY (post-condition) — verified after the step by the tool itself.' },
+                            expect: { type: 'object', description: 'Optional precondition re-checked by perceiving before the step: {"window":"..."} or {"element":"..."}. (`precheck` is an accepted alias.)' },
+                        },
+                        required: ['name'],
+                    },
+                },
+                allowConfirm: { type: 'boolean', description: 'Allow confirm-tier steps to run (default false → halt at them).', required: false },
+                dryRun: { type: 'boolean', description: 'Only report each step\'s safety tier; do not execute.', required: false },
+                maxSteps: { type: 'number', description: `Hard cap on executed steps (default ${DEFAULT_MAX_STEPS}).`, required: false },
+            },
+            category: 'orchestration',
+            compactGroup: 'system',
+            safetyTier: 0, // the batch itself is inert; each STEP is gated individually at runtime.
+            handler: async (params, ctx) => {
+                // `steps` arrives as a JSON string (constrained schema) or, from clients
+                // that pass rich JSON, a real array. Accept both.
+                let steps;
+                const raw = params.steps;
+                if (typeof raw === 'string') {
+                    try {
+                        steps = JSON.parse(raw);
+                    }
+                    catch {
+                        return { text: 'batch: `steps` must be a valid JSON array.', isError: true };
+                    }
+                }
+                else if (Array.isArray(raw)) {
+                    steps = raw;
+                }
+                else {
+                    return { text: 'batch: `steps` must be a JSON array of { name, arguments, expect? }.', isError: true };
+                }
+                if (!Array.isArray(steps) || steps.length === 0) {
+                    return { text: 'batch: `steps` must be a non-empty array of { name, arguments, expect? }.', isError: true };
+                }
+                for (const s of steps) {
+                    if (!s || typeof s.name !== 'string') {
+                        return { text: 'batch: every step needs a string `name` (the tool to call).', isError: true };
+                    }
+                }
+                if (params.dryRun) {
+                    const scan = dryRunScan(steps);
+                    const willStop = scan.find(s => s.gate === 'confirm' || s.gate === 'block' || s.gate === 'unknown-tool');
+                    return {
+                        text: `batch (dry run): ${steps.length} steps.\n` +
+                            scan.map(s => `  ${s.i}. [${s.gate}] ${s.label}`).join('\n') +
+                            (willStop ? `\nNote: without allowConfirm, the batch would halt at step ${willStop.i} ([${willStop.gate}]).` : '\nAll steps would be allowed.'),
+                    };
+                }
+                const result = await executeBatch(steps, ctx, {
+                    allowConfirm: params.allowConfirm === true,
+                    maxSteps: typeof params.maxSteps === 'number' ? params.maxSteps : undefined,
+                });
+                return { text: renderResult(result), isError: !result.allDone };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=batch.js.map

package/dist/tools/batch.js.map

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

package/dist/tools/cdp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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
+ */
+import type { ToolDefinition } from './types';
+export declare function getCdpTools(): ToolDefinition[];