@vitalops/opendesk-sdk 0.1.0

package/README.md

@@ -0,0 +1,176 @@
+# @vitalops/opendesk-sdk — JavaScript/TypeScript SDK
+
+Give any JavaScript or TypeScript AI agent eyes and hands on your desktop.
+
+No Python required. All desktop automation runs natively in Node.js — screenshot capture, mouse/keyboard control, accessibility APIs, OCR, clipboard, and audit logging.
+
+---
+
+## Requirements
+
+- Node.js 18+
+
+---
+
+## Install
+
+```bash
+npm install @vitalops/opendesk-sdk
+```
+
+### Claude Code / Claude Desktop
+
+```bash
+npx opendesk-js install
+```
+
+This registers the native MCP server with Claude Code. The tools (`screenshot`, `mouse`, `keyboard`, `ui`, etc.) are then available in every Claude Code conversation.
+
+To remove:
+
+```bash
+npx opendesk-js uninstall
+```
+
+### Claude Desktop
+
+Add to your config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "opendesk": {
+      "command": "node",
+      "args": ["/path/to/node_modules/@vitalops/opendesk-sdk/bin/opendesk-mcp.js"]
+    }
+  }
+}
+```
+
+---
+
+## Usage
+
+### Programmatic (agent loop)
+
+```typescript
+import { OpenDeskClient } from "@vitalops/opendesk-sdk";
+
+const client = new OpenDeskClient();
+
+// Take a screenshot with Set-of-Marks
+const shot = await client.screenshot({ marks: true });
+console.log(shot.output);
+
+// Click a button by name — no coordinates needed
+await client.ui({ action: "click", app: "Safari", title: "Go" });
+
+// Type text
+await client.keyboard({ action: "type", text: "Hello from JS" });
+
+// Open an app
+await client.app({ action: "open", name: "Spotify" });
+
+// Read clipboard
+const clip = await client.clipboard({ action: "read" });
+console.log(clip.output);
+
+// OCR a region
+const text = await client.ocr({ region: [0, 0, 800, 400] });
+
+// Show audit log
+const log = await client.audit({ format: "summary" });
+```
+
+### With Vercel AI SDK
+
+```typescript
+import { OpenDeskClient } from "@vitalops/opendesk-sdk";
+import { generateText } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+
+const client = new OpenDeskClient();
+
+const shot = await client.screenshot({ marks: true });
+const response = await generateText({
+  model: anthropic("claude-opus-4-6"),
+  messages: [
+    {
+      role: "user",
+      content: [
+        { type: "text", text: "What do you see on screen? Click the most prominent button." },
+        { type: "image", image: shot.attachments[0].content },
+      ],
+    },
+  ],
+});
+```
+
+### Expose as MCP server
+
+```typescript
+import { createMcpServer } from "@vitalops/opendesk-sdk";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const server = createMcpServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+### Custom session ID or permission handler
+
+```typescript
+import { OpenDeskClient } from "@vitalops/opendesk-sdk";
+
+const client = new OpenDeskClient({
+  sessionId: "my-agent-session",
+  permissionHandler: async (tool, action, description) => {
+    console.log(`Allow ${description}? [y/n]`);
+    // return true to allow, false to deny
+    return true;
+  },
+});
+```
+
+---
+
+## Tools
+
+Full reference: [docs/tools.md](../docs/tools.md)
+
+| Tool | Method | Description |
+|------|--------|-------------|
+| `screenshot` | `client.screenshot(params?)` | Capture screen, optional SoM marks |
+| `ui` | `client.ui(params)` | Click/type by element name — no coordinates |
+| `mouse` | `client.mouse(params)` | Pixel-level mouse control |
+| `keyboard` | `client.keyboard(params)` | Type, press keys, hotkeys |
+| `app` | `client.app(params)` | Open, close, focus applications |
+| `clipboard` | `client.clipboard(params)` | Read/write system clipboard |
+| `ocr` | `client.ocr(params?)` | Extract text from screen |
+| `audit` | `client.audit(params?)` | Show session audit log |
+
+---
+
+## How it works
+
+```
+Your JS/TS code
+      │
+      ▼
+@vitalops/opendesk-sdk (Node.js)
+      │
+      ├── screenshot  (screenshot-desktop)
+      ├── mouse/keyboard  (@nut-tree-fork/nut-js)
+      ├── ui  (osascript / PowerShell UI Automation / xdotool)
+      ├── ocr  (tesseract.js)
+      ├── clipboard  (clipboardy)
+      └── audit  (in-process session log)
+```
+
+All platform-specific automation runs directly in Node.js. No external process is required.
+
+---
+
+## License
+
+MIT

package/bin/opendesk-mcp.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * opendesk native MCP server — run over stdio.
+ * Used by Claude Code / Claude Desktop as the MCP command.
+ *
+ * Registered automatically by: npx opendesk-js install
+ */
+
+import { runMcpStdio } from "../dist/mcp.js";
+
+runMcpStdio().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/bin/opendesk.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * opendesk-js CLI
+ *
+ * Commands:
+ *   install [--scope=user|project]  — register native MCP server with Claude Code
+ *   uninstall                        — remove MCP server from Claude Code
+ *   mcp                              — run the native MCP server over stdio
+ */
+
+import { install, uninstall } from "../dist/install.js";
+import { runMcpStdio } from "../dist/mcp.js";
+
+const [, , command, ...rest] = process.argv;
+
+switch (command) {
+  case "install": {
+    const scopeArg = rest.find((a) => a.startsWith("--scope="));
+    const scope = scopeArg ? scopeArg.split("=")[1] : "user";
+    install(scope);
+    break;
+  }
+  case "uninstall":
+    uninstall();
+    break;
+  case "mcp":
+    runMcpStdio().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
+  default:
+    console.log(`opendesk-js — JavaScript SDK for opendesk
+
+Usage:
+  opendesk-js install [--scope=user|project]   Register native MCP server with Claude Code
+  opendesk-js uninstall                         Remove MCP server from Claude Code
+  opendesk-js mcp                               Run native MCP server over stdio
+`);
+}

package/dist/client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * OpenDeskClient — programmatic interface to all native opendesk tools.
+ * No Python required. All desktop automation runs in Node.js.
+ *
+ * Usage:
+ *
+ *   import { OpenDeskClient } from "@opendesk/sdk";
+ *
+ *   const client = new OpenDeskClient();
+ *   const result = await client.screenshot({ marks: true });
+ *   console.log(result.output);
+ */
+import { ToolRegistry } from "./registry.js";
+import { ToolResult, PermissionHandler } from "./tools/base.js";
+export interface OpenDeskClientOptions {
+    sessionId?: string;
+    permissionHandler?: PermissionHandler;
+    registry?: ToolRegistry;
+}
+export declare class OpenDeskClient {
+    private registry;
+    private ctx;
+    constructor(options?: OpenDeskClientOptions);
+    private call;
+    screenshot(params?: {
+        marks?: boolean;
+        savePath?: string;
+        region?: number[];
+    }): Promise<ToolResult>;
+    mouse(params: {
+        action: string;
+        x?: number;
+        y?: number;
+        endX?: number;
+        endY?: number;
+        direction?: string;
+        amount?: number;
+    }): Promise<ToolResult>;
+    keyboard(params: {
+        action: string;
+        text?: string;
+        key?: string;
+        keys?: string[];
+        holdDuration?: number;
+    }): Promise<ToolResult>;
+    app(params: {
+        action: string;
+        name?: string;
+    }): Promise<ToolResult>;
+    ui(params: {
+        action: string;
+        app: string;
+        title?: string;
+        role?: string;
+        menu?: string;
+        menuItem?: string;
+        text?: string;
+        key?: string;
+        modifiers?: string[];
+    }): Promise<ToolResult>;
+    clipboard(params: {
+        action: string;
+        text?: string;
+    }): Promise<ToolResult>;
+    ocr(params?: {
+        region?: number[];
+    }): Promise<ToolResult>;
+    audit(params?: {
+        format?: "summary" | "full";
+        sessionId?: string;
+    }): Promise<ToolResult>;
+    listTools(): string[];
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAgC,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,GAAG,CAAc;gBAEb,OAAO,GAAE,qBAA0B;IAQ/C,OAAO,CAAC,IAAI;IAIZ,UAAU,CAAC,MAAM,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAIvG,KAAK,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjJ,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9H,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpL,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzE,GAAG,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5D,KAAK,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5F,SAAS,IAAI,MAAM,EAAE;CAGtB"}

package/dist/client.js

@@ -0,0 +1,55 @@
+/**
+ * OpenDeskClient — programmatic interface to all native opendesk tools.
+ * No Python required. All desktop automation runs in Node.js.
+ *
+ * Usage:
+ *
+ *   import { OpenDeskClient } from "@opendesk/sdk";
+ *
+ *   const client = new OpenDeskClient();
+ *   const result = await client.screenshot({ marks: true });
+ *   console.log(result.output);
+ */
+import { createRegistry } from "./registry.js";
+export class OpenDeskClient {
+    registry;
+    ctx;
+    constructor(options = {}) {
+        this.registry = options.registry ?? createRegistry();
+        this.ctx = {
+            sessionId: options.sessionId ?? "default",
+            permissionHandler: options.permissionHandler,
+        };
+    }
+    call(name, params = {}) {
+        return this.registry.get(name).execute(this.ctx, params);
+    }
+    screenshot(params = {}) {
+        return this.call("screenshot", params);
+    }
+    mouse(params) {
+        return this.call("mouse", params);
+    }
+    keyboard(params) {
+        return this.call("keyboard", params);
+    }
+    app(params) {
+        return this.call("app", params);
+    }
+    ui(params) {
+        return this.call("ui", params);
+    }
+    clipboard(params) {
+        return this.call("clipboard", params);
+    }
+    ocr(params = {}) {
+        return this.call("ocr", params);
+    }
+    audit(params = {}) {
+        return this.call("audit", params);
+    }
+    listTools() {
+        return this.registry.all().map((t) => t.name);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAS7D,MAAM,OAAO,cAAc;IACjB,QAAQ,CAAe;IACvB,GAAG,CAAc;IAEzB,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;QACrD,IAAI,CAAC,GAAG,GAAG;YACT,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;YACzC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC;IACJ,CAAC;IAEO,IAAI,CAAC,IAAY,EAAE,SAAkC,EAAE;QAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,UAAU,CAAC,SAAoE,EAAE;QAC/E,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAiC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAqH;QACzH,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAiC,CAAC,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,MAA+F;QACtG,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAiC,CAAC,CAAC;IAClE,CAAC;IAED,GAAG,CAAC,MAAyC;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAiC,CAAC,CAAC;IAC7D,CAAC;IAED,EAAE,CAAC,MAA2J;QAC5J,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAiC,CAAC,CAAC;IAC5D,CAAC;IAED,SAAS,CAAC,MAAyC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAiC,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,SAAgC,EAAE;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAiC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,SAA8D,EAAE;QACpE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAiC,CAAC,CAAC;IAC/D,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/computer/sandbox.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-session audit sandbox — mirrors Python's computer/sandbox.py.
+ */
+export interface AuditEntry {
+    id: string;
+    timestamp: number;
+    action: string;
+    params: Record<string, unknown>;
+    sessionId: string;
+    result?: string;
+    error?: string;
+}
+export declare class ComputerSandbox {
+    readonly sessionId: string;
+    allowedApps: string[];
+    screenRegion?: [number, number, number, number];
+    lastScreenshot?: Buffer;
+    private log;
+    constructor(sessionId: string);
+    isAppAllowed(appName: string): boolean;
+    isCoordinateAllowed(x: number, y: number): boolean;
+    recordAction(action: string, params: Record<string, unknown>, result?: string, error?: string): AuditEntry;
+    exportAuditLog(): AuditEntry[];
+    summary(): string;
+}
+export declare function getSandbox(sessionId: string): ComputerSandbox;
+export declare function configureSandbox(sessionId: string, opts: {
+    allowedApps?: string[];
+    screenRegion?: [number, number, number, number];
+}): ComputerSandbox;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/computer/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/computer/sandbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAM;IAC3B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,GAAG,CAAoB;gBAEnB,SAAS,EAAE,MAAM;IAI7B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKtC,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAMlD,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,UAAU;IAcb,cAAc,IAAI,UAAU,EAAE;IAI9B,OAAO,IAAI,MAAM;CASlB;AAID,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAG7D;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChF,eAAe,CAKjB"}

package/dist/computer/sandbox.js

@@ -0,0 +1,65 @@
+/**
+ * Per-session audit sandbox — mirrors Python's computer/sandbox.py.
+ */
+export class ComputerSandbox {
+    sessionId;
+    allowedApps = [];
+    screenRegion;
+    lastScreenshot;
+    log = [];
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    isAppAllowed(appName) {
+        if (this.allowedApps.length === 0)
+            return true;
+        return this.allowedApps.some((a) => appName.toLowerCase().includes(a.toLowerCase()));
+    }
+    isCoordinateAllowed(x, y) {
+        if (!this.screenRegion)
+            return true;
+        const [rx, ry, rw, rh] = this.screenRegion;
+        return x >= rx && x <= rx + rw && y >= ry && y <= ry + rh;
+    }
+    recordAction(action, params, result, error) {
+        const entry = {
+            id: crypto.randomUUID(),
+            timestamp: Date.now() / 1000,
+            action,
+            params,
+            sessionId: this.sessionId,
+            result,
+            error,
+        };
+        this.log.push(entry);
+        return entry;
+    }
+    exportAuditLog() {
+        return [...this.log];
+    }
+    summary() {
+        const counts = {};
+        for (const e of this.log)
+            counts[e.action] = (counts[e.action] ?? 0) + 1;
+        const parts = Object.entries(counts)
+            .sort()
+            .map(([k, v]) => `${v}x ${k}`)
+            .join(", ");
+        return `session=${this.sessionId.slice(0, 12)}… | ${this.log.length} actions: ${parts || "none"}`;
+    }
+}
+const sandboxes = new Map();
+export function getSandbox(sessionId) {
+    if (!sandboxes.has(sessionId))
+        sandboxes.set(sessionId, new ComputerSandbox(sessionId));
+    return sandboxes.get(sessionId);
+}
+export function configureSandbox(sessionId, opts) {
+    const sandbox = getSandbox(sessionId);
+    if (opts.allowedApps)
+        sandbox.allowedApps = opts.allowedApps;
+    if (opts.screenRegion)
+        sandbox.screenRegion = opts.screenRegion;
+    return sandbox;
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/computer/sandbox.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @opendesk/sdk — public API surface
+ */
+export { OpenDeskClient, type OpenDeskClientOptions } from "./client.js";
+export { createMcpServer, runMcpStdio } from "./mcp.js";
+export { ToolRegistry, createRegistry } from "./registry.js";
+export { Tool, type ToolResult, type ToolContext, type PermissionHandler, type Attachment, allowAllContext, checkPermission, PermissionDeniedError, } from "./tools/base.js";
+//# 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;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @opendesk/sdk — public API surface
+ */
+export { OpenDeskClient } from "./client.js";
+export { createMcpServer, runMcpStdio } from "./mcp.js";
+export { ToolRegistry, createRegistry } from "./registry.js";
+export { Tool, allowAllContext, checkPermission, PermissionDeniedError, } from "./tools/base.js";
+//# 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;;GAEG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,IAAI,EAKJ,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI install/uninstall commands — register the JS MCP bridge with Claude Code.
+ *
+ * Usage:
+ *   npx opendesk-js install
+ *   npx opendesk-js uninstall
+ */
+export declare function install(scope?: "user" | "project"): void;
+export declare function uninstall(): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,wBAAgB,OAAO,CAAC,KAAK,GAAE,MAAM,GAAG,SAAkB,GAAG,IAAI,CAoBhE;AAED,wBAAgB,SAAS,IAAI,IAAI,CAIhC"}

package/dist/install.js

@@ -0,0 +1,49 @@
+/**
+ * CLI install/uninstall commands — register the JS MCP bridge with Claude Code.
+ *
+ * Usage:
+ *   npx opendesk-js install
+ *   npx opendesk-js uninstall
+ */
+import { execFileSync, execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+function findClaude() {
+    try {
+        const cmd = process.platform === "win32" ? "where claude" : "which claude";
+        const result = execSync(cmd, { encoding: "utf-8" }).trim().split("\n")[0].replace(/\r/g, "");
+        if (result)
+            return result;
+    }
+    catch {
+        // fall through
+    }
+    throw new Error("claude command not found.\n" +
+        "Install Claude Code first: https://claude.ai/code");
+}
+function findMcpBin() {
+    const thisFile = fileURLToPath(import.meta.url);
+    const pkgRoot = path.resolve(path.dirname(thisFile), "..");
+    return path.join(pkgRoot, "bin", "opendesk-mcp.js");
+}
+export function install(scope = "user") {
+    const claude = findClaude();
+    const mcpBin = findMcpBin();
+    // Remove existing entry if any
+    try {
+        execFileSync(claude, ["mcp", "remove", "opendesk-js"], { stdio: "pipe" });
+    }
+    catch {
+        // Not registered yet — fine
+    }
+    execFileSync(claude, ["mcp", "add", "opendesk-js", `--scope=${scope}`, "--", "node", mcpBin], { stdio: "inherit", shell: process.platform === "win32" });
+    console.log(`opendesk JS MCP server registered (${scope}).`);
+    console.log(`  Server: ${mcpBin}`);
+    console.log("Start a Claude Code conversation and say 'take a screenshot' to verify.");
+}
+export function uninstall() {
+    const claude = findClaude();
+    execFileSync(claude, ["mcp", "remove", "opendesk-js"], { stdio: "inherit", shell: process.platform === "win32" });
+    console.log("opendesk JS MCP server removed from Claude Code.");
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC3E,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7F,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6BAA6B;QAC7B,mDAAmD,CACpD,CAAC;AACJ,CAAC;AACD,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAA4B,MAAM;IACxD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,+BAA+B;IAC/B,IAAI,CAAC;QACH,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;IAED,YAAY,CACV,MAAM,EACN,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EACvE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAC1D,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,sCAAsC,KAAK,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAClH,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;AAClE,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Standalone MCP server — exposes all native opendesk tools over the
+ * Model Context Protocol. No Python required.
+ *
+ * Usage:
+ *   npx opendesk-js mcp          — run over stdio (for Claude Code / Claude Desktop)
+ *
+ * Or programmatically:
+ *   import { createMcpServer, runMcpStdio } from "@opendesk/sdk";
+ *   const server = createMcpServer();
+ *   // connect your own transport
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ToolRegistry } from "./registry.js";
+import { ToolContext } from "./tools/base.js";
+export declare function createMcpServer(registry?: ToolRegistry, ctx?: ToolContext): Server;
+export declare function runMcpStdio(registry?: ToolRegistry, ctx?: ToolContext): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAmB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/D,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CA0ClF;AAED,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F"}

package/dist/mcp.js

@@ -0,0 +1,56 @@
+/**
+ * Standalone MCP server — exposes all native opendesk tools over the
+ * Model Context Protocol. No Python required.
+ *
+ * Usage:
+ *   npx opendesk-js mcp          — run over stdio (for Claude Code / Claude Desktop)
+ *
+ * Or programmatically:
+ *   import { createMcpServer, runMcpStdio } from "@opendesk/sdk";
+ *   const server = createMcpServer();
+ *   // connect your own transport
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createRegistry } from "./registry.js";
+import { allowAllContext } from "./tools/base.js";
+export function createMcpServer(registry, ctx) {
+    const reg = registry ?? createRegistry();
+    const context = ctx ?? allowAllContext();
+    const server = new Server({ name: "opendesk", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: reg.all().map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.schema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const tool = reg.get(name);
+        const result = await tool.execute(context, args);
+        const contents = [];
+        if (result.output) {
+            contents.push({ type: "text", text: result.output });
+        }
+        for (const att of result.attachments) {
+            if (att.mediaType.startsWith("image/")) {
+                contents.push({ type: "image", data: att.content.toString("base64"), mimeType: att.mediaType });
+            }
+            else {
+                contents.push({ type: "text", text: `[Attachment: ${att.filename}]\ndata:${att.mediaType};base64,${att.content.toString("base64")}` });
+            }
+        }
+        if (!contents.length)
+            contents.push({ type: "text", text: "(no output)" });
+        return { content: contents };
+    });
+    return server;
+}
+export async function runMcpStdio(registry, ctx) {
+    const server = createMcpServer(registry, ctx);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAe,MAAM,iBAAiB,CAAC;AAE/D,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE,GAAiB;IACxE,MAAM,GAAG,GAAG,QAAQ,IAAI,cAAc,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM;SACtB,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACtD,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAA+B,CAAC,CAAC;QAE5E,MAAM,QAAQ,GAA6E,EAAE,CAAC;QAE9F,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;YAClG,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,CAAC,QAAQ,WAAW,GAAG,CAAC,SAAS,WAAW,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACzI,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAE3E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAuB,EAAE,GAAiB;IAC1E,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}