@mseep/clawdcursor 1.5.5

package/dist/tools/orchestration.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * Orchestration tools — delegate tasks, launch apps, navigate browser.
+ */
+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.__resetInflightDelegationForTests = __resetInflightDelegationForTests;
+exports.getOrchestrationTools = getOrchestrationTools;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const browser_config_1 = require("../llm/browser-config");
+const aliases_1 = require("../core/router/aliases");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+async function commandExists(cmd) {
+    try {
+        await execFileAsync('which', [cmd], { timeout: 2000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+let inflightDelegation = null;
+/** Test hook — clears the module-level in-flight holder. */
+function __resetInflightDelegationForTests() {
+    inflightDelegation = null;
+}
+const SYNC_WAIT_DEFAULT_MS = 45_000; // under common 60s MCP client timeouts
+const SYNC_WAIT_MIN_MS = 1_000;
+const SYNC_WAIT_MAX_MS = 50_000;
+const normTask = (s) => s.replace(/\s+/g, ' ').trim().toLowerCase();
+const sleepMs = (ms) => new Promise(r => setTimeout(r, ms));
+function startDelegation(agent, task) {
+    const entry = { task, startedAt: Date.now(), promise: Promise.resolve(), settled: false };
+    entry.promise = agent.executeTask(task).then(r => { entry.settled = true; entry.result = r; }, e => { entry.settled = true; entry.error = e; });
+    return entry;
+}
+function formatDelegationResult(entry) {
+    if (entry.error) {
+        const err = entry.error;
+        return { text: `delegate_to_agent: ${err?.message ?? String(entry.error)}`, isError: true };
+    }
+    const result = entry.result;
+    return {
+        text: JSON.stringify({
+            success: result?.success,
+            steps: result?.steps?.length ?? 0,
+            duration: `${((result?.duration ?? 0) / 1000).toFixed(1)}s`,
+            lastAction: result?.steps?.slice(-1)?.[0]?.description ?? '(unknown)',
+        }, null, 2),
+        isError: !result?.success,
+    };
+}
+function getOrchestrationTools() {
+    return [
+        {
+            name: 'delegate_to_agent',
+            description: "Hand a whole task to clawdcursor's built-in thin agent loop, which drives the toolbox with the model configured via `clawdcursor doctor` (perceive → act → iterate until done). " +
+                "For an expensive frontier model this is the delegation lever: hand grunt work to a cheaper configured model that takes the wheel. " +
+                "BOUNDED-SYNC: waits up to `timeout` seconds (default 45) for completion. A finished task returns its result directly; a longer task returns a {status:\"running\"} receipt with progress while the loop CONTINUES in the background — re-call with the SAME task text to keep waiting (re-attaches, never restarts), or poll agent_status / abort via abort_task. " +
+                "Requires `clawdcursor agent` running WITH a model configured; in tools-only / --no-llm mode there is no model to drive it.",
+            parameters: {
+                task: { type: 'string', description: 'Natural language task description', required: true },
+                timeout: { type: 'number', description: 'Max seconds to WAIT for completion before returning a running receipt (default 45, clamped 1–50; stays under MCP client call-timeouts). The task itself keeps running — this only bounds the wait.', required: false },
+            },
+            category: 'orchestration',
+            compactGroup: 'task',
+            safetyTier: 1,
+            handler: async ({ task, timeout }, ctx) => {
+                // Run the task IN-PROCESS on the daemon's configured-model agent.
+                // (This previously self-called the daemon's own /mcp via mcpCall, which
+                // the streamable-HTTP transport rejects with "Already connected to a
+                // transport" — a re-entrant MCP call. Calling ctx.agent directly avoids
+                // the self-call and returns a clean error when no model is configured.)
+                if (!ctx?.agent) {
+                    return { text: 'delegate_to_agent: no model-backed agent attached. This needs `clawdcursor agent` running WITH a model configured (run `clawdcursor doctor`). In tools-only / --no-llm mode there is no model to drive the task — drive the toolbox tools directly instead.', isError: true };
+                }
+                const text = String(task ?? '').trim();
+                if (!text) {
+                    return { text: 'delegate_to_agent: task must be a non-empty string', isError: true };
+                }
+                const timeoutSec = Number(timeout);
+                const boundMs = Math.min(SYNC_WAIT_MAX_MS, Math.max(SYNC_WAIT_MIN_MS, Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec * 1000 : SYNC_WAIT_DEFAULT_MS));
+                let entry = inflightDelegation;
+                if (entry && !entry.settled) {
+                    // A delegated task is still running. Same text → re-attach and keep
+                    // waiting; different text → tell the caller the truth instead of
+                    // queueing or double-running.
+                    if (normTask(entry.task) !== normTask(text)) {
+                        const runningFor = ((Date.now() - entry.startedAt) / 1000).toFixed(0);
+                        return {
+                            text: `delegate_to_agent: the agent is BUSY with a different task ("${entry.task.slice(0, 100)}", running ${runningFor}s). ` +
+                                `Poll agent_status (compact: task {action:"status"}), abort it first (abort_task / task {action:"abort"}), ` +
+                                `or re-call with the SAME task text to keep waiting on it.`,
+                            isError: true,
+                        };
+                    }
+                }
+                else if (entry && entry.settled && normTask(entry.task) === normTask(text)) {
+                    // Finished while the caller was away — hand over the stored result.
+                    inflightDelegation = null;
+                    return formatDelegationResult(entry);
+                }
+                else {
+                    // Start fresh. Guard against a run started through another route
+                    // (submit_task / scheduler) that this holder doesn't know about.
+                    const state = ctx.agent.getState?.();
+                    if (state?.status && state.status !== 'idle') {
+                        return {
+                            text: `delegate_to_agent: agent is busy (status=${state.status}) with a task started elsewhere (submit_task/scheduler). Poll agent_status or call abort_task first.`,
+                            isError: true,
+                        };
+                    }
+                    entry = startDelegation(ctx.agent, text);
+                    inflightDelegation = entry;
+                }
+                await Promise.race([entry.promise, sleepMs(boundMs)]);
+                if (entry.settled) {
+                    if (inflightDelegation === entry)
+                        inflightDelegation = null;
+                    return formatDelegationResult(entry);
+                }
+                // Still running — return a receipt instead of blowing the caller's
+                // MCP timeout. NOT an error: the task is alive and progressing.
+                const st = ctx.agent.getState?.() ?? {};
+                return {
+                    text: JSON.stringify({
+                        status: 'running',
+                        task: entry.task,
+                        elapsed: `${((Date.now() - entry.startedAt) / 1000).toFixed(0)}s`,
+                        progress: {
+                            status: st.status,
+                            currentStep: st.currentStep,
+                            stepsCompleted: st.stepsCompleted,
+                            stepsTotal: st.stepsTotal,
+                        },
+                        next: 'Task continues in the background. Re-call this tool with the SAME task text to keep waiting (re-attaches — it will NOT restart the task). Or poll agent_status (compact: task {action:"status"}) / abort with abort_task (task {action:"abort"}).',
+                    }, null, 2),
+                };
+            },
+        },
+        {
+            name: 'open_app',
+            description: 'Open an application by name. Uses the cross-OS app alias table + the PlatformAdapter\'s launchApp (UWP-aware on Windows, `open -a` on macOS, gtk-launch / xdg-open on Linux).',
+            parameters: {
+                name: { type: 'string', description: 'Application name (e.g. "notepad", "calc", "mspaint", "Outlook", "Chrome")', required: true },
+            },
+            category: 'orchestration',
+            compactGroup: 'window',
+            safetyTier: 1,
+            handler: async ({ name }, ctx) => {
+                await ctx.ensureInitialized();
+                const rawName = String(name ?? '');
+                if (!rawName) {
+                    return { text: 'open_app: `name` is required', isError: true };
+                }
+                // Resolve through the canonical alias table so "Notepad" / "notepad" /
+                // "Calculator" / "calc" all map to the right launch hints. The MCP
+                // open_app used to call `Start-Process <name>` directly, which fails
+                // for UWP apps (Calculator, Win11 Notepad) and is case-sensitive on
+                // PowerShell's Start-Process arg. The alias table + platform adapter
+                // is the same path the autonomous agent-loop uses.
+                const alias = (0, aliases_1.resolveAlias)(rawName);
+                // If we have a PlatformAdapter (we always do post-v0.9 init), use it.
+                // Falls back to the old execFile path only when the adapter isn't
+                // available (shouldn't happen in normal operation).
+                if (ctx.platform && typeof ctx.platform.launchApp === 'function') {
+                    let launchName = rawName;
+                    if (alias) {
+                        if (process.platform === 'darwin') {
+                            launchName = alias.macOSAppName ?? rawName;
+                        }
+                        else if (process.platform === 'win32') {
+                            launchName = alias.executable ?? rawName;
+                        }
+                        else {
+                            launchName = alias.executable?.replace(/\.exe$/i, '') ?? rawName;
+                        }
+                    }
+                    try {
+                        const res = await ctx.platform.launchApp(launchName, {
+                            alwaysNewInstance: alias?.alwaysNewInstance,
+                            uwpAppId: alias?.uwpAppId,
+                            searchTerm: alias?.searchTerm
+                                ?? (process.platform === 'darwin' ? alias?.macOSAppName : undefined),
+                        });
+                        ctx.a11y.invalidateCache();
+                        return {
+                            text: res?.title
+                                ? `Opened "${rawName}" (pid=${res.pid}, window="${res.title}")`
+                                : `Launched "${rawName}" (no window surfaced yet)`,
+                        };
+                    }
+                    catch (err) {
+                        return { text: `Failed to launch "${rawName}": ${err?.message ?? err}`, isError: true };
+                    }
+                }
+                // Fallback: pre-adapter path (kept for safety, should be unreachable).
+                try {
+                    if (process.platform === 'win32') {
+                        const exe = alias?.executable ?? rawName;
+                        const uwpId = alias?.uwpAppId;
+                        if (uwpId) {
+                            await execFileAsync('explorer.exe', [`shell:AppsFolder\\${uwpId}`], { timeout: 10000 });
+                        }
+                        else {
+                            // Defense-in-depth: `exe` (a caller-supplied app name) is interpolated
+                            // into a PowerShell -Command string. Inside a double-quoted PS string,
+                            // `"`, backtick, and `$(...)` can break out and run arbitrary code.
+                            // Reject those metacharacters — real executable names/paths never
+                            // contain them (spaces and parens, e.g. "Program Files (x86)", are fine).
+                            if (/["`$\r\n]/.test(exe)) {
+                                return { text: `Refusing to launch "${rawName}": unsafe characters in target name`, isError: true };
+                            }
+                            await execFileAsync('powershell.exe', ['-NoProfile', '-Command', `Start-Process "${exe}"`], { timeout: 10000 });
+                        }
+                    }
+                    else if (process.platform === 'darwin') {
+                        await execFileAsync('open', ['-a', alias?.macOSAppName ?? rawName], { timeout: 10000 });
+                    }
+                    else {
+                        const linuxName = alias?.executable?.replace(/\.exe$/i, '') ?? rawName;
+                        if (await commandExists('gtk-launch')) {
+                            await execFileAsync('gtk-launch', [linuxName], { timeout: 10000 });
+                        }
+                        else if (await commandExists('xdg-open')) {
+                            await execFileAsync('xdg-open', [linuxName], { timeout: 10000 });
+                        }
+                        else {
+                            await execFileAsync(linuxName, [], { timeout: 10000 });
+                        }
+                    }
+                    await new Promise(r => setTimeout(r, 2000));
+                    ctx.a11y.invalidateCache();
+                    return { text: `Launched: ${rawName}` };
+                }
+                catch (err) {
+                    return { text: `Failed to launch "${rawName}": ${err.message}`, isError: true };
+                }
+            },
+        },
+        {
+            name: 'navigate_browser',
+            description: `Open a URL in the browser. Launches with CDP enabled (port ${browser_config_1.DEFAULT_CDP_PORT}) for DOM interaction. Call cdp_connect after. Tier 2 (mutation): triggers network egress to an arbitrary destination + spawns/attaches to a browser process.`,
+            parameters: {
+                url: { type: 'string', description: 'URL to navigate to', required: true },
+            },
+            category: 'orchestration',
+            compactGroup: 'window',
+            safetyTier: 2,
+            handler: async ({ url }, ctx) => {
+                await ctx.ensureInitialized();
+                if (await ctx.cdp.isConnected()) {
+                    try {
+                        const page = ctx.cdp.getPage();
+                        if (page) {
+                            await page.goto(url, { timeout: 30000, waitUntil: 'domcontentloaded' });
+                            const title = await page.title().catch(() => '(loading)');
+                            return { text: `Navigated to: "${title}" at ${url}` };
+                        }
+                    }
+                    catch { /* fall through */ }
+                }
+                try {
+                    const userDataDir = path.join(os.tmpdir(), 'clawdcursor-edge');
+                    if (process.platform === 'win32') {
+                        // Direct exec instead of `powershell -Command "Start-Process …"`:
+                        // the previous form interpolated `url` into a PowerShell string,
+                        // letting a crafted URL (`")` / `$()` / backtick) escape the
+                        // quoting and run arbitrary code. execFile with argv is safe.
+                        // Edge installs in well-known locations; fall back to the one
+                        // that exists. `where.exe msedge` would also work but adds an
+                        // extra spawn for the common case.
+                        const edgeCandidates = [
+                            path.join(process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)', 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+                            path.join(process.env['ProgramFiles'] || 'C:\\Program Files', 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+                        ];
+                        const edgeExe = edgeCandidates.find(p => { try {
+                            return fs.existsSync(p);
+                        }
+                        catch {
+                            return false;
+                        } });
+                        if (!edgeExe) {
+                            throw new Error('msedge.exe not found in standard install locations');
+                        }
+                        await execFileAsync(edgeExe, [
+                            `--remote-debugging-port=${browser_config_1.DEFAULT_CDP_PORT}`,
+                            `--user-data-dir=${userDataDir}`,
+                            '--no-first-run',
+                            '--disable-default-apps',
+                            url,
+                        ], { timeout: 10000 });
+                    }
+                    else if (process.platform === 'darwin') {
+                        await execFileAsync('open', ['-a', 'Google Chrome', '--args',
+                            `--remote-debugging-port=${browser_config_1.DEFAULT_CDP_PORT}`, `--user-data-dir=${userDataDir}`, '--no-first-run', url
+                        ], { timeout: 10000 });
+                    }
+                    else {
+                        // Linux: try common browser binaries in order.
+                        const browserCandidates = ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser', 'microsoft-edge'];
+                        let launched = false;
+                        for (const browserCmd of browserCandidates) {
+                            if (!(await commandExists(browserCmd)))
+                                continue;
+                            await execFileAsync(browserCmd, [
+                                `--remote-debugging-port=${browser_config_1.DEFAULT_CDP_PORT}`, `--user-data-dir=${userDataDir}`, '--no-first-run', url,
+                            ], { timeout: 10000 });
+                            launched = true;
+                            break;
+                        }
+                        if (!launched) {
+                            throw new Error('No supported browser binary found (tried: google-chrome, chromium, microsoft-edge)');
+                        }
+                    }
+                    await new Promise(r => setTimeout(r, 3000));
+                    ctx.a11y.invalidateCache();
+                    return { text: `Opened: ${url} (CDP port ${browser_config_1.DEFAULT_CDP_PORT} enabled)` };
+                }
+                catch (err) {
+                    return { text: `Navigation failed: ${err.message}`, isError: true };
+                }
+            },
+        },
+        {
+            name: 'wait',
+            description: 'Wait for a specified duration. Useful after animations or page loads.',
+            parameters: {
+                seconds: { type: 'number', description: 'Duration to wait (0.1 to 30)', required: true, minimum: 0.1, maximum: 30 },
+            },
+            category: 'orchestration',
+            compactGroup: 'computer',
+            safetyTier: 0,
+            handler: async ({ seconds }) => {
+                await new Promise(r => setTimeout(r, seconds * 1000));
+                return { text: `Waited ${seconds}s` };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=orchestration.js.map

package/dist/tools/orchestration.js.map

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

package/dist/tools/playbooks/extract-compose.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Deterministic field extraction for compose-send tasks.
+ *
+ * Pulls recipient / subject / body out of natural-language task text
+ * like: "send an email to bob@example.com with the subject 'Hi'
+ * introducing yourself". Pure (no LLM). Returns whatever it can find;
+ * callers decide whether to proceed with missing fields.
+ *
+ * The match patterns are intentionally conservative: false negatives
+ * are fine (caller falls through to the agent ladder), false positives
+ * would mean sending mail to the wrong address, which is worse.
+ */
+export interface ComposeFields {
+    recipient: string;
+    subject: string;
+    body: string;
+}
+/**
+ * Extract compose fields from a task string. Always returns an object;
+ * any unrecognized field comes back as the empty string.
+ */
+export declare function extractComposeFields(task: string): ComposeFields;

package/dist/tools/playbooks/extract-compose.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Deterministic field extraction for compose-send tasks.
+ *
+ * Pulls recipient / subject / body out of natural-language task text
+ * like: "send an email to bob@example.com with the subject 'Hi'
+ * introducing yourself". Pure (no LLM). Returns whatever it can find;
+ * callers decide whether to proceed with missing fields.
+ *
+ * The match patterns are intentionally conservative: false negatives
+ * are fine (caller falls through to the agent ladder), false positives
+ * would mean sending mail to the wrong address, which is worse.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractComposeFields = extractComposeFields;
+/**
+ * Extract compose fields from a task string. Always returns an object;
+ * any unrecognized field comes back as the empty string.
+ */
+function extractComposeFields(task) {
+    return {
+        recipient: extractRecipient(task),
+        subject: extractSubject(task),
+        body: extractBody(task),
+    };
+}
+/**
+ * First well-formed email address in the task. Strict-enough RFC 5322
+ * shape (we won't accept "foo @ bar"). If none, return empty string \u2014
+ * the caller will refuse to dispatch.
+ */
+function extractRecipient(task) {
+    const m = task.match(/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/);
+    return m ? m[0] : '';
+}
+/**
+ * Quoted subject wins. Otherwise look for "with (the )?subject X" or
+ * "subject: X" or "subject \"X\"". Stops at the next clause keyword
+ * (introducing/saying/about/that/and the body...) so we don't grab the
+ * whole rest of the task as the subject.
+ */
+function extractSubject(task) {
+    // 1) Quoted: subject 'Hi', subject "Hi", subject \u201cHi\u201d.
+    const quoted = task.match(/subject\s*[:=]?\s*(?:["'\u201c\u2018])([^"'\u201d\u2019\n]{1,200})(?:["'\u201d\u2019])/i);
+    if (quoted)
+        return quoted[1].trim();
+    // 2) Unquoted "subject ... " up to a stop word.
+    const stopWords = /(?=\s+(?:introducing|saying|about|that|and|with body|with the body|body[:\s]|telling|asking|explaining|describing|requesting|inviting))/i;
+    const unquoted = task.match(/subject\s*[:=]?\s+([^\n]+)/i);
+    if (unquoted) {
+        const tail = unquoted[1];
+        const stopMatch = tail.match(stopWords);
+        const cut = stopMatch ? tail.slice(0, stopMatch.index).trim() : tail.trim();
+        if (cut.length >= 1 && cut.length <= 200)
+            return cut.replace(/[.,;]$/, '');
+    }
+    return '';
+}
+/**
+ * Body extraction. Patterns we recognize:
+ *   - "introducing yourself"               \u2192 "Hello, I am an AI assistant introducing myself."
+ *   - "body: <text>" / "body \"<text>\""    \u2192 verbatim
+ *   - "saying <text>"                       \u2192 verbatim
+ *   - "with (the )?message <text>"          \u2192 verbatim
+ * Anything else: empty (caller can leave the body blank).
+ */
+function extractBody(task) {
+    // Quoted body wins.
+    const quoted = task.match(/(?:body|message|saying|content)\s*[:=]?\s*(?:["'\u201c\u2018])([^"'\u201d\u2019]{1,2000})(?:["'\u201d\u2019])/i);
+    if (quoted)
+        return quoted[1].trim();
+    // Unquoted "body: X" / "saying X" / "with the message X" \u2014 take the rest.
+    const unquoted = task.match(/(?:^|\s)(?:body|saying|message|content)\s*[:=]?\s+([^\n]{1,2000})/i);
+    if (unquoted)
+        return unquoted[1].trim().replace(/[.,;]$/, '');
+    // Semantic shortcuts. "introducing yourself" is the example the user
+    // ran into; expand it to a polite one-liner. Keep these intentionally
+    // conservative \u2014 if we can't recognize the intent we leave body
+    // empty and let the agent type something.
+    if (/\bintroduc(?:e|ing)\s+yourself\b/i.test(task)) {
+        return 'Hello,\n\nI am an AI assistant reaching out to introduce myself. Please let me know if there is anything I can help with.\n\nBest regards.';
+    }
+    return '';
+}
+//# sourceMappingURL=extract-compose.js.map

package/dist/tools/playbooks/extract-compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-compose.js","sourceRoot":"","sources":["../../../src/tools/playbooks/extract-compose.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAYH,oDAMC;AAVD;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAO;QACL,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC;QACjC,OAAO,EAAI,cAAc,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAO,WAAW,CAAC,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,iEAAiE;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,yFAAyF,CAAC,CAAC;IACrH,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpC,gDAAgD;IAChD,MAAM,SAAS,GAAG,0IAA0I,CAAC;IAC7J,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5E,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,gHAAgH,CAAC,CAAC;IAC5I,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpC,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAClG,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE9D,qEAAqE;IACrE,sEAAsE;IACtE,qEAAqE;IACrE,0CAA0C;IAC1C,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,4IAA4I,CAAC;IACtJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/playbooks/find-replace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Find & Replace playbook.
+ *
+ * Ported from src/deterministic-flows.ts. The choreography:
+ *   mod+h → type find → Tab → type replace → alt+a (replace all) → Escape.
+ *
+ * Most text editors (Word, VSCode, Notepad++ on Windows; mac equivalents)
+ * expose this same shape. The `mod+h` shortcut is the cross-platform primary.
+ */
+import type { PlaybookArgs, PlaybookResult } from './index';
+export declare function findReplace(args: PlaybookArgs): Promise<PlaybookResult>;

package/dist/tools/playbooks/find-replace.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Find & Replace playbook.
+ *
+ * Ported from src/deterministic-flows.ts. The choreography:
+ *   mod+h → type find → Tab → type replace → alt+a (replace all) → Escape.
+ *
+ * Most text editors (Word, VSCode, Notepad++ on Windows; mac equivalents)
+ * expose this same shape. The `mod+h` shortcut is the cross-platform primary.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findReplace = findReplace;
+async function findReplace(args) {
+    const { adapter, input } = args;
+    const findText = input.find ?? input.findText ?? '';
+    const replaceText = input.replace ?? input.replaceText ?? '';
+    const steps = [];
+    if (!findText) {
+        return {
+            success: false,
+            text: 'find-replace: no `find` text provided',
+            steps,
+        };
+    }
+    // 1) Open the Find & Replace panel.
+    await adapter.keyPress('mod+h');
+    steps.push({ type: 'key', key: 'mod+h', description: 'open find & replace' });
+    await sleep(300);
+    // 2) Type the find term (panel focuses its Find field by default).
+    await adapter.typeText(findText);
+    steps.push({ type: 'type', description: `typed find: ${findText}` });
+    // 3) Tab to the Replace field, type replacement.
+    await adapter.keyPress('Tab');
+    steps.push({ type: 'key', key: 'Tab', description: 'advance to Replace' });
+    if (replaceText) {
+        await adapter.typeText(replaceText);
+        steps.push({ type: 'type', description: `typed replace: ${replaceText}` });
+    }
+    // 4) Alt+A (Replace All on most editors). Some editors use Enter or a button;
+    // the verifier will catch if this missed.
+    await adapter.keyPress('alt+a');
+    steps.push({ type: 'key', key: 'alt+a', description: 'replace all' });
+    await sleep(300);
+    // 5) Dismiss the panel.
+    await adapter.keyPress('Escape');
+    steps.push({ type: 'key', key: 'Escape', description: 'close panel' });
+    return {
+        success: true,
+        text: `find-replace: "${findText}" → "${replaceText}"`,
+        steps,
+    };
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+//# sourceMappingURL=find-replace.js.map

package/dist/tools/playbooks/find-replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-replace.js","sourceRoot":"","sources":["../../../src/tools/playbooks/find-replace.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAIH,kCA8CC;AA9CM,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,QAAQ,GAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7D,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,uCAAuC;YAC7C,KAAK;SACN,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjB,mEAAmE;IACnE,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,QAAQ,EAAE,EAAE,CAAC,CAAC;IAErE,iDAAiD;IACjD,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,8EAA8E;IAC9E,0CAA0C;IAC1C,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;IACtE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjB,wBAAwB;IACxB,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;IAEvE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,kBAAkB,QAAQ,QAAQ,WAAW,GAAG;QACtD,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC"}