@moxxy/plugin-computer-control 0.26.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { type Plugin, type ToolDef } from '@moxxy/sdk';
+import { IS_DARWIN } from './shell.js';
+import { applescriptTool } from './tools/applescript.js';
+import { clickTool } from './tools/click.js';
+import { clipboardTool } from './tools/clipboard.js';
+import { keyTool } from './tools/key.js';
+import { openTool } from './tools/open.js';
+import { screenshotTool } from './tools/screenshot.js';
+import { typeTool } from './tools/type.js';
+export { applescriptTool, clickTool, clipboardTool, keyTool, openTool, screenshotTool, typeTool, };
+export declare const computerControlTools: ReadonlyArray<ToolDef>;
+/**
+ * `@moxxy/plugin-computer-control` — programmatic control of the host
+ * computer (mouse, keyboard, screenshot, clipboard, app launching,
+ * AppleScript escape hatch).
+ *
+ * Currently macOS-only: every tool shells out to built-in binaries
+ * (`screencapture`, `osascript`, `open`, `pbpaste`, `pbcopy`). On any
+ * other platform the plugin still registers — the tools' handlers
+ * throw a clear "macOS only" error — so the model's tool list stays
+ * stable across hosts (avoids "tool disappeared on Linux" confusion).
+ *
+ * Every tool is `permission: 'prompt'`. There is intentionally no
+ * "allow always" shortcut for these — granting blanket permission to
+ * drive the user's screen + keyboard is exactly the wrong default.
+ */
+export declare const computerControlPlugin: Plugin;
+export default computerControlPlugin;
+export { IS_DARWIN };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,eAAe,EACf,SAAS,EACT,aAAa,EACb,OAAO,EACP,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,OAAO,CAQvD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAIlC,CAAC;AAEH,eAAe,qBAAqB,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+import { definePlugin } from '@moxxy/sdk';
+import { IS_DARWIN } from './shell.js';
+import { applescriptTool } from './tools/applescript.js';
+import { clickTool } from './tools/click.js';
+import { clipboardTool } from './tools/clipboard.js';
+import { keyTool } from './tools/key.js';
+import { openTool } from './tools/open.js';
+import { screenshotTool } from './tools/screenshot.js';
+import { typeTool } from './tools/type.js';
+export { applescriptTool, clickTool, clipboardTool, keyTool, openTool, screenshotTool, typeTool, };
+export const computerControlTools = [
+    screenshotTool,
+    clickTool,
+    typeTool,
+    keyTool,
+    openTool,
+    clipboardTool,
+    applescriptTool,
+];
+/**
+ * `@moxxy/plugin-computer-control` — programmatic control of the host
+ * computer (mouse, keyboard, screenshot, clipboard, app launching,
+ * AppleScript escape hatch).
+ *
+ * Currently macOS-only: every tool shells out to built-in binaries
+ * (`screencapture`, `osascript`, `open`, `pbpaste`, `pbcopy`). On any
+ * other platform the plugin still registers — the tools' handlers
+ * throw a clear "macOS only" error — so the model's tool list stays
+ * stable across hosts (avoids "tool disappeared on Linux" confusion).
+ *
+ * Every tool is `permission: 'prompt'`. There is intentionally no
+ * "allow always" shortcut for these — granting blanket permission to
+ * drive the user's screen + keyboard is exactly the wrong default.
+ */
+export const computerControlPlugin = definePlugin({
+    name: '@moxxy/plugin-computer-control',
+    version: '0.0.0',
+    tools: [...computerControlTools],
+});
+export default computerControlPlugin;
+// Re-export for callers that want a runtime gate.
+export { IS_DARWIN };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6B,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,eAAe,EACf,SAAS,EACT,aAAa,EACb,OAAO,EACP,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,cAAc;IACd,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,aAAa;IACb,eAAe;CAChB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAW,YAAY,CAAC;IACxD,IAAI,EAAE,gCAAgC;IACtC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,CAAC,GAAG,oBAAoB,CAAC;CACjC,CAAC,CAAC;AAEH,eAAe,qBAAqB,CAAC;AAErC,kDAAkD;AAClD,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/shell.d.ts

@@ -0,0 +1,56 @@
+export declare const IS_DARWIN: boolean;
+/**
+ * Hard ceiling on combined stdout+stderr a child may emit before it is
+ * force-killed. The wall-clock timeout caps duration but not throughput —
+ * a runaway or hostile child (e.g. `pbpaste` on a gigabyte clipboard, or an
+ * `osascript` snippet that streams unbounded output) can accumulate hundreds
+ * of MB well inside the timeout and OOM the host. 16 MB is far above any
+ * legitimate tool output here (the screenshot path caps its own encoded file
+ * separately) while still bounding worst-case memory.
+ */
+export declare const MAX_OUTPUT_BYTES: number;
+export interface ProcResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    /**
+     * True when the child was force-killed because it exceeded `timeoutMs`.
+     * A timed-out child still resolves (via 'close') with `exitCode: -1`, so
+     * this flag is the only reliable way for callers to distinguish a timeout
+     * from a genuine non-zero exit and surface an actionable message.
+     */
+    readonly timedOut: boolean;
+    /** True when the child was force-killed because `opts.signal` aborted. */
+    readonly aborted: boolean;
+    /**
+     * True when the child was force-killed because its combined stdout+stderr
+     * exceeded `MAX_OUTPUT_BYTES`. The captured output is whatever had been
+     * read up to the cap.
+     */
+    readonly tooLarge: boolean;
+}
+/**
+ * Build a uniform failure suffix that names a timeout/abort when the process
+ * was force-killed, so a stuck `osascript` (etc.) is reported as a clear
+ * cause rather than a bare `exit -1`. Returns '' for a normal exit.
+ */
+export declare function procFailureCause(proc: ProcResult, timeoutMs?: number): string;
+/**
+ * Spawn a process with array-form args (no shell). Returns stdout +
+ * stderr + exit code. Optional `input` is written to stdin. Optional
+ * `signal` propagates aborts from the tool ctx so a stuck `osascript`
+ * dies with the turn instead of hanging the parent.
+ *
+ * Never use this with string interpolation into a single command —
+ * each argument MUST be a separate array entry. The `bash -c` shape
+ * would re-introduce the shell-injection risk this helper exists to
+ * eliminate.
+ */
+export declare function runProcess(cmd: string, args: ReadonlyArray<string>, opts?: {
+    readonly input?: string | Buffer;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}): Promise<ProcResult>;
+/** Throw a clear error when a tool is invoked on a non-darwin host. */
+export declare function ensureDarwin(toolName: string): void;
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,SAAgC,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAKjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,IAAI,GAAE;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CACxB,GACL,OAAO,CAAC,UAAU,CAAC,CAgIrB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQnD"}

package/dist/shell.js

@@ -0,0 +1,189 @@
+import { spawn } from 'node:child_process';
+import { MoxxyError } from '@moxxy/sdk';
+export const IS_DARWIN = process.platform === 'darwin';
+/**
+ * Hard ceiling on combined stdout+stderr a child may emit before it is
+ * force-killed. The wall-clock timeout caps duration but not throughput —
+ * a runaway or hostile child (e.g. `pbpaste` on a gigabyte clipboard, or an
+ * `osascript` snippet that streams unbounded output) can accumulate hundreds
+ * of MB well inside the timeout and OOM the host. 16 MB is far above any
+ * legitimate tool output here (the screenshot path caps its own encoded file
+ * separately) while still bounding worst-case memory.
+ */
+export const MAX_OUTPUT_BYTES = 16 * 1024 * 1024;
+/** Grace period after SIGTERM before escalating to SIGKILL. */
+const SIGKILL_GRACE_MS = 2_500;
+/**
+ * Build a uniform failure suffix that names a timeout/abort when the process
+ * was force-killed, so a stuck `osascript` (etc.) is reported as a clear
+ * cause rather than a bare `exit -1`. Returns '' for a normal exit.
+ */
+export function procFailureCause(proc, timeoutMs) {
+    if (proc.tooLarge)
+        return `output exceeded ${MAX_OUTPUT_BYTES} bytes (killed)`;
+    if (proc.timedOut) {
+        return timeoutMs ? `timed out after ${timeoutMs}ms` : 'timed out';
+    }
+    if (proc.aborted)
+        return 'aborted (turn cancelled)';
+    return '';
+}
+/**
+ * Spawn a process with array-form args (no shell). Returns stdout +
+ * stderr + exit code. Optional `input` is written to stdin. Optional
+ * `signal` propagates aborts from the tool ctx so a stuck `osascript`
+ * dies with the turn instead of hanging the parent.
+ *
+ * Never use this with string interpolation into a single command —
+ * each argument MUST be a separate array entry. The `bash -c` shape
+ * would re-introduce the shell-injection risk this helper exists to
+ * eliminate.
+ */
+export function runProcess(cmd, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        // An ALREADY-aborted signal never emits 'abort' to a listener added after
+        // the fact (DOM semantics), so without this short-circuit a cancelled turn
+        // would still spawn the child and run it to completion — defeating the
+        // abort contract. Resolve immediately as an aborted no-op without spawning.
+        if (opts.signal?.aborted) {
+            resolve({
+                exitCode: -1,
+                stdout: '',
+                stderr: '',
+                timedOut: false,
+                aborted: true,
+                tooLarge: false,
+            });
+            return;
+        }
+        const child = spawn(cmd, [...args], { stdio: ['pipe', 'pipe', 'pipe'] });
+        // Collect BOTH stdout and stderr as chunks and concat ONCE at close.
+        // Re-concatenating the whole accumulated buffer on every 'data' event is
+        // O(n^2) and churns the GC; decoding each chunk with `.toString('utf8')`
+        // in isolation also corrupts any multibyte sequence (e.g. an osascript
+        // error containing a non-ASCII app name) that straddles a chunk boundary.
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let outputBytes = 0;
+        let settled = false;
+        let timedOut = false;
+        let aborted = false;
+        let tooLarge = false;
+        let killTimer = null;
+        // Force the child to die: SIGTERM first, then escalate to SIGKILL after a
+        // grace period for a child that traps/ignores SIGTERM (a wedged GUI helper
+        // or an osascript stuck behind an Accessibility prompt). Without the
+        // escalation the tool's timeout/abort isn't actually enforced — the parent
+        // hangs until the child closes on its own, which may be never.
+        const forceKill = () => {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch {
+                /* ignore */
+            }
+            if (killTimer)
+                return;
+            killTimer = setTimeout(() => {
+                if (settled)
+                    return;
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* ignore */
+                }
+            }, SIGKILL_GRACE_MS);
+            killTimer.unref?.();
+        };
+        const onAbort = () => {
+            if (settled)
+                return;
+            aborted = true;
+            forceKill();
+        };
+        opts.signal?.addEventListener('abort', onAbort, { once: true });
+        const timer = opts.timeoutMs
+            ? setTimeout(() => {
+                if (settled)
+                    return;
+                timedOut = true;
+                forceKill();
+            }, opts.timeoutMs)
+            : null;
+        child.stdout.on('data', (chunk) => {
+            outputBytes += chunk.length;
+            // Once over the cap we stop retaining further chunks (the child is being
+            // killed) so a flood between the cap-trip and SIGTERM landing can't keep
+            // growing memory; we still account the bytes to keep `outputBytes` honest.
+            if (!tooLarge)
+                stdoutChunks.push(chunk);
+            if (!tooLarge && outputBytes > MAX_OUTPUT_BYTES) {
+                tooLarge = true;
+                forceKill();
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            outputBytes += chunk.length;
+            if (!tooLarge)
+                stderrChunks.push(chunk);
+            if (!tooLarge && outputBytes > MAX_OUTPUT_BYTES) {
+                tooLarge = true;
+                forceKill();
+            }
+        });
+        // A child that exits/closes stdin before our write completes makes the
+        // stdin Writable emit 'error' (EPIPE/ECONNRESET). With no listener that
+        // throws and surfaces as an unhandled rejection that can take down the
+        // parent — swallow it; the child 'error'/'close' path reports the real
+        // failure. Same defensiveness on stdout/stderr for symmetry.
+        child.stdin.on('error', () => { });
+        child.stdout.on('error', () => { });
+        child.stderr.on('error', () => { });
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            opts.signal?.removeEventListener('abort', onAbort);
+        };
+        child.once('error', (err) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(err);
+        });
+        child.once('close', (code) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve({
+                exitCode: code ?? -1,
+                stdout: Buffer.concat(stdoutChunks).toString('utf8'),
+                stderr: Buffer.concat(stderrChunks).toString('utf8'),
+                timedOut,
+                aborted,
+                tooLarge,
+            });
+        });
+        if (opts.input !== undefined) {
+            child.stdin.end(opts.input);
+        }
+        else {
+            child.stdin.end();
+        }
+    });
+}
+/** Throw a clear error when a tool is invoked on a non-darwin host. */
+export function ensureDarwin(toolName) {
+    if (!IS_DARWIN) {
+        throw new MoxxyError({
+            code: 'TOOL_ERROR',
+            message: `${toolName}: @moxxy/plugin-computer-control currently only supports macOS (process.platform = ${process.platform})`,
+            context: { tool: toolName, platform: process.platform },
+        });
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

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

package/dist/tools/applescript.d.ts

@@ -0,0 +1,2 @@
+export declare const applescriptTool: import("@moxxy/sdk").ToolDef;
+//# sourceMappingURL=applescript.d.ts.map

package/dist/tools/applescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../src/tools/applescript.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,8BAqC1B,CAAC"}

package/dist/tools/applescript.js

@@ -0,0 +1,38 @@
+import { defineTool, MoxxyError, z } from '@moxxy/sdk';
+import { ensureDarwin, procFailureCause, runProcess } from '../shell.js';
+export const applescriptTool = defineTool({
+    name: 'computer_applescript',
+    description: 'Escape hatch: run an arbitrary AppleScript snippet via `osascript`. Use ' +
+        'for anything the dedicated tools can\'t cover (frontmost app name, list ' +
+        'open Safari tabs, drive a specific app via its scripting dictionary, etc.). ' +
+        'Returns the script\'s stdout. The user approves every invocation — keep ' +
+        'scripts focused and reversible.',
+    inputSchema: z.object({
+        script: z
+            .string()
+            .min(1)
+            .max(8000)
+            .describe('AppleScript source. Multi-line is fine — pass `\\n` between statements. ' +
+            'For JavaScript for Automation, prefix with `#!/usr/bin/osascript -l JavaScript`'),
+    }),
+    permission: { action: 'prompt' },
+    async handler({ script }, ctx) {
+        ensureDarwin('computer_applescript');
+        const proc = await runProcess('osascript', ['-e', script], {
+            ...(ctx.signal ? { signal: ctx.signal } : {}),
+            timeoutMs: 30_000,
+        });
+        if (proc.exitCode !== 0) {
+            const cause = procFailureCause(proc, 30_000);
+            throw new MoxxyError({
+                code: 'TOOL_ERROR',
+                message: cause
+                    ? `osascript ${cause}`
+                    : `osascript failed (exit ${proc.exitCode}): ${proc.stderr.trim() || '(no error message)'}`,
+                context: { tool: 'computer_applescript', exitCode: proc.exitCode, timedOut: proc.timedOut ? 1 : 0 },
+            });
+        }
+        return { ok: true, output: proc.stdout.trim() };
+    },
+});
+//# sourceMappingURL=applescript.js.map

package/dist/tools/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../src/tools/applescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,0EAA0E;QAC1E,0EAA0E;QAC1E,8EAA8E;QAC9E,0EAA0E;QAC1E,iCAAiC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,CACP,0EAA0E;YACxE,iFAAiF,CACpF;KACJ,CAAC;IACF,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAChC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG;QAC3B,YAAY,CAAC,sBAAsB,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACzD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,KAAK;oBACZ,CAAC,CAAC,aAAa,KAAK,EAAE;oBACtB,CAAC,CAAC,0BAA0B,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,oBAAoB,EAAE;gBAC7F,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;aACpG,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAClD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/click.d.ts

@@ -0,0 +1,2 @@
+export declare const clickTool: import("@moxxy/sdk").ToolDef;
+//# sourceMappingURL=click.d.ts.map

package/dist/tools/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,8BAgDpB,CAAC"}

package/dist/tools/click.js

@@ -0,0 +1,50 @@
+import { defineTool, MoxxyError, z } from '@moxxy/sdk';
+import { ensureDarwin, procFailureCause, runProcess } from '../shell.js';
+export const clickTool = defineTool({
+    name: 'computer_click',
+    description: 'Click the mouse at screen-pixel coordinates (top-left origin). Uses macOS ' +
+        'System Events; requires Accessibility permission on first use. Pass count=2 ' +
+        'for a double-click. Right/middle buttons are not supported via this tool — ' +
+        'use computer_applescript for those (rare).',
+    inputSchema: z.object({
+        x: z.number().int().min(0).describe('X pixel from the top-left of the display.'),
+        y: z.number().int().min(0).describe('Y pixel from the top-left of the display.'),
+        count: z
+            .number()
+            .int()
+            .min(1)
+            .max(3)
+            .optional()
+            .describe('Number of consecutive clicks. 1 = single, 2 = double, 3 = triple. Default 1.'),
+    }),
+    permission: { action: 'prompt' },
+    async handler({ x, y, count }, ctx) {
+        ensureDarwin('computer_click');
+        const n = count ?? 1;
+        // `click at {x, y}` repeats N times via a repeat block. Use a
+        // bare AppleScript string with numeric interpolation — no
+        // user-supplied text reaches the script, so injection isn't a
+        // risk here.
+        const script = `tell application "System Events"\n` +
+            `  repeat ${n} times\n` +
+            `    click at {${Math.round(x)}, ${Math.round(y)}}\n` +
+            `  end repeat\n` +
+            `end tell`;
+        const proc = await runProcess('osascript', ['-e', script], {
+            ...(ctx.signal ? { signal: ctx.signal } : {}),
+            timeoutMs: 10_000,
+        });
+        if (proc.exitCode !== 0) {
+            const cause = procFailureCause(proc, 10_000);
+            throw new MoxxyError({
+                code: 'TOOL_ERROR',
+                message: cause
+                    ? `click ${cause}`
+                    : `click failed (exit ${proc.exitCode}): ${proc.stderr.trim() || '(check Accessibility permission in System Settings → Privacy & Security → Accessibility)'}`,
+                context: { tool: 'computer_click', exitCode: proc.exitCode, timedOut: proc.timedOut ? 1 : 0 },
+            });
+        }
+        return { ok: true, x, y, count: n };
+    },
+});
+//# sourceMappingURL=click.js.map

package/dist/tools/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,4EAA4E;QAC5E,8EAA8E;QAC9E,6EAA6E;QAC7E,4CAA4C;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAChF,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAChF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,8EAA8E,CAAC;KAC5F,CAAC;IACF,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAChC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG;QAChC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QACrB,8DAA8D;QAC9D,0DAA0D;QAC1D,8DAA8D;QAC9D,aAAa;QACb,MAAM,MAAM,GACV,oCAAoC;YACpC,YAAY,CAAC,UAAU;YACvB,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;YACrD,gBAAgB;YAChB,UAAU,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACzD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,KAAK;oBACZ,CAAC,CAAC,SAAS,KAAK,EAAE;oBAClB,CAAC,CAAC,sBAAsB,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,0FAA0F,EAAE;gBAC/J,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;aAC9F,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/clipboard.d.ts

@@ -0,0 +1,2 @@
+export declare const clipboardTool: import("@moxxy/sdk").ToolDef;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/tools/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/tools/clipboard.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,8BA2DxB,CAAC"}

package/dist/tools/clipboard.js

@@ -0,0 +1,62 @@
+import { defineTool, MoxxyError, z } from '@moxxy/sdk';
+import { ensureDarwin, procFailureCause, runProcess } from '../shell.js';
+export const clipboardTool = defineTool({
+    name: 'computer_clipboard',
+    description: 'Read from or write to the macOS clipboard. Use `read` to fetch what the ' +
+        'user just copied; use `write` to stage text the user can then paste with ' +
+        '⌘V. Writing the clipboard does NOT trigger a paste — call computer_key ' +
+        'with cmd+v after if you need to paste.',
+    inputSchema: z.object({
+        action: z.enum(['read', 'write']),
+        text: z
+            .string()
+            .max(64_000)
+            .optional()
+            .describe('Text to put on the clipboard. Required when action="write".'),
+    }),
+    permission: { action: 'prompt' },
+    async handler({ action, text }, ctx) {
+        ensureDarwin('computer_clipboard');
+        if (action === 'read') {
+            const proc = await runProcess('pbpaste', [], {
+                ...(ctx.signal ? { signal: ctx.signal } : {}),
+                timeoutMs: 5_000,
+            });
+            if (proc.exitCode !== 0) {
+                const cause = procFailureCause(proc, 5_000);
+                throw new MoxxyError({
+                    code: 'TOOL_ERROR',
+                    message: cause
+                        ? `pbpaste ${cause}`
+                        : `pbpaste failed (exit ${proc.exitCode}): ${proc.stderr.trim()}`,
+                    context: { tool: 'computer_clipboard', exitCode: proc.exitCode, timedOut: proc.timedOut ? 1 : 0 },
+                });
+            }
+            return { ok: true, text: proc.stdout };
+        }
+        if (text === undefined) {
+            throw new MoxxyError({
+                code: 'TOOL_ERROR',
+                message: 'computer_clipboard: `text` is required when action="write"',
+                context: { tool: 'computer_clipboard' },
+            });
+        }
+        const proc = await runProcess('pbcopy', [], {
+            ...(ctx.signal ? { signal: ctx.signal } : {}),
+            input: text,
+            timeoutMs: 5_000,
+        });
+        if (proc.exitCode !== 0) {
+            const cause = procFailureCause(proc, 5_000);
+            throw new MoxxyError({
+                code: 'TOOL_ERROR',
+                message: cause
+                    ? `pbcopy ${cause}`
+                    : `pbcopy failed (exit ${proc.exitCode}): ${proc.stderr.trim()}`,
+                context: { tool: 'computer_clipboard', exitCode: proc.exitCode, timedOut: proc.timedOut ? 1 : 0 },
+            });
+        }
+        return { ok: true, length: text.length };
+    },
+});
+//# sourceMappingURL=clipboard.js.map

package/dist/tools/clipboard.js.map

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

package/dist/tools/key.d.ts

@@ -0,0 +1,11 @@
+declare const MODIFIER_NAMES: readonly ["cmd", "shift", "option", "control"];
+type Modifier = (typeof MODIFIER_NAMES)[number];
+export declare const keyTool: import("@moxxy/sdk").ToolDef;
+/**
+ * Build the `osascript -e` body for a single key chord. Named keys go
+ * through `key code N`, single characters through `keystroke "x"`, and a
+ * multi-char unknown key throws. Pure (no I/O) so it can be unit-tested.
+ */
+export declare function buildKeyScript(key: string, modifiers: ReadonlyArray<Modifier>): string;
+export {};
+//# sourceMappingURL=key.d.ts.map

package/dist/tools/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/tools/key.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,cAAc,gDAAiD,CAAC;AACtE,KAAK,QAAQ,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAoDhD,eAAO,MAAM,OAAO,8BA2ClB,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,CAyBtF"}