@solarisdk/mcp 0.4.4 → 0.4.5

package/README.md

@@ -188,6 +188,7 @@ cookie count and origins it stored, so they can see what was persisted.
 | `solari_get_preview_url` | Public preview URL for an in-guest port |
 | `solari_screenshot` | Capture the desktop as a PNG (image content) |
 | `solari_click` / `solari_type` / `solari_key` | Desktop mouse/keyboard (`solari_click` takes optional `doubleClick` + `button: left\|right\|middle`) |
+| `solari_drag` / `solari_mouse_down` / `solari_mouse_move` / `solari_mouse_up` | Drag-and-drop: one-shot drag, or press-hold → move → release for stepwise drags |
 | `solari_open_app` | Launch an app on the desktop |
 
 (The desktop GUI tools require a `solari_desktop_create` session; they error on

package/dist/server.js

@@ -36,6 +36,11 @@ export function makeToolset(client, reg) {
     };
     // A paused session refuses the /control upgrade with 409, so resume it and
     // retry rather than surfacing an opaque websocket error.
+    //
+    // A PARKED session needs nothing here: park keeps the slot, the host and the
+    // routing, and the gateway unparks on the /control upgrade itself (wake-on-
+    // touch). The connect below just works, a few hundred milliseconds slower.
+    // Do not add an unpark call -- it would be a redundant round trip.
     const live = async (id) => {
         const e = need(id);
         if (e.handle.connected)
@@ -275,6 +280,62 @@ export function makeToolset(client, reg) {
                 return text({ ok: true });
             },
         },
+        solari_mouse_down: {
+            description: "Press and HOLD a mouse button at (x, y) — the start of a drag (e.g. grab a window " +
+                "title bar). Follow with solari_mouse_move to drag while held, then solari_mouse_up " +
+                "to release. For a simple one-shot drag prefer solari_drag.",
+            inputSchema: {
+                sessionId: z.string(),
+                x: z.number(),
+                y: z.number(),
+                button: z.enum(["left", "right", "middle"]).optional(),
+            },
+            handler: async (a) => {
+                const e = await desktop(a.sessionId);
+                await e.handle.mouse.down(a.x, a.y, a.button ?? "left");
+                return text({ ok: true });
+            },
+        },
+        solari_mouse_move: {
+            description: "Move the pointer to (x, y). While a button is held (solari_mouse_down) this drags.",
+            inputSchema: { sessionId: z.string(), x: z.number(), y: z.number() },
+            handler: async (a) => {
+                const e = await desktop(a.sessionId);
+                await e.handle.mouse.move(a.x, a.y);
+                return text({ ok: true });
+            },
+        },
+        solari_mouse_up: {
+            description: "Release the held mouse button at (x, y) — the end of a drag started with solari_mouse_down.",
+            inputSchema: {
+                sessionId: z.string(),
+                x: z.number(),
+                y: z.number(),
+                button: z.enum(["left", "right", "middle"]).optional(),
+            },
+            handler: async (a) => {
+                const e = await desktop(a.sessionId);
+                await e.handle.mouse.up(a.x, a.y, a.button ?? "left");
+                return text({ ok: true });
+            },
+        },
+        solari_drag: {
+            description: "Drag in one call: press at (fromX, fromY), move to (toX, toY), release. " +
+                "Good for moving windows, sliders, and drag-and-drop.",
+            inputSchema: {
+                sessionId: z.string(),
+                fromX: z.number(),
+                fromY: z.number(),
+                toX: z.number(),
+                toY: z.number(),
+                button: z.enum(["left", "right", "middle"]).optional(),
+            },
+            handler: async (a) => {
+                const e = await desktop(a.sessionId);
+                await e.handle.mouse.drag({ x: a.fromX, y: a.fromY }, { x: a.toX, y: a.toY }, a.button ?? "left");
+                return text({ ok: true });
+            },
+        },
         solari_type: {
             description: "Type text into the focused desktop element.",
             inputSchema: { sessionId: z.string(), text: z.string() },

package/dist/solari-mcp-http.bundle.cjs

@@ -112358,7 +112358,7 @@ var SolariClient = class {
 };
 
 // src/version.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.5";
 
 // ../../../pinetree-desktop/sdk/mcp/node_modules/puppeteer-core/lib/esm/puppeteer/index.js
 init_index_browser();
@@ -114597,6 +114597,63 @@ function makeToolset(client, reg) {
         return text2({ ok: true });
       }
     },
+    solari_mouse_down: {
+      description: "Press and HOLD a mouse button at (x, y) \u2014 the start of a drag (e.g. grab a window title bar). Follow with solari_mouse_move to drag while held, then solari_mouse_up to release. For a simple one-shot drag prefer solari_drag.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        x: external_exports.number(),
+        y: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.down(a2.x, a2.y, a2.button ?? "left");
+        return text2({ ok: true });
+      }
+    },
+    solari_mouse_move: {
+      description: "Move the pointer to (x, y). While a button is held (solari_mouse_down) this drags.",
+      inputSchema: { sessionId: external_exports.string(), x: external_exports.number(), y: external_exports.number() },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.move(a2.x, a2.y);
+        return text2({ ok: true });
+      }
+    },
+    solari_mouse_up: {
+      description: "Release the held mouse button at (x, y) \u2014 the end of a drag started with solari_mouse_down.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        x: external_exports.number(),
+        y: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.up(a2.x, a2.y, a2.button ?? "left");
+        return text2({ ok: true });
+      }
+    },
+    solari_drag: {
+      description: "Drag in one call: press at (fromX, fromY), move to (toX, toY), release. Good for moving windows, sliders, and drag-and-drop.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        fromX: external_exports.number(),
+        fromY: external_exports.number(),
+        toX: external_exports.number(),
+        toY: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.drag(
+          { x: a2.fromX, y: a2.fromY },
+          { x: a2.toX, y: a2.toY },
+          a2.button ?? "left"
+        );
+        return text2({ ok: true });
+      }
+    },
     solari_type: {
       description: "Type text into the focused desktop element.",
       inputSchema: { sessionId: external_exports.string(), text: external_exports.string() },

package/dist/solari-mcp.bundle.cjs

@@ -111027,7 +111027,7 @@ var SolariClient = class {
 };
 
 // src/version.ts
-var VERSION = "0.4.4";
+var VERSION = "0.4.5";
 
 // ../../../pinetree-desktop/sdk/mcp/node_modules/puppeteer-core/lib/esm/puppeteer/index.js
 init_index_browser();
@@ -113266,6 +113266,63 @@ function makeToolset(client, reg) {
         return text2({ ok: true });
       }
     },
+    solari_mouse_down: {
+      description: "Press and HOLD a mouse button at (x, y) \u2014 the start of a drag (e.g. grab a window title bar). Follow with solari_mouse_move to drag while held, then solari_mouse_up to release. For a simple one-shot drag prefer solari_drag.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        x: external_exports.number(),
+        y: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.down(a2.x, a2.y, a2.button ?? "left");
+        return text2({ ok: true });
+      }
+    },
+    solari_mouse_move: {
+      description: "Move the pointer to (x, y). While a button is held (solari_mouse_down) this drags.",
+      inputSchema: { sessionId: external_exports.string(), x: external_exports.number(), y: external_exports.number() },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.move(a2.x, a2.y);
+        return text2({ ok: true });
+      }
+    },
+    solari_mouse_up: {
+      description: "Release the held mouse button at (x, y) \u2014 the end of a drag started with solari_mouse_down.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        x: external_exports.number(),
+        y: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.up(a2.x, a2.y, a2.button ?? "left");
+        return text2({ ok: true });
+      }
+    },
+    solari_drag: {
+      description: "Drag in one call: press at (fromX, fromY), move to (toX, toY), release. Good for moving windows, sliders, and drag-and-drop.",
+      inputSchema: {
+        sessionId: external_exports.string(),
+        fromX: external_exports.number(),
+        fromY: external_exports.number(),
+        toX: external_exports.number(),
+        toY: external_exports.number(),
+        button: external_exports.enum(["left", "right", "middle"]).optional()
+      },
+      handler: async (a2) => {
+        const e = await desktop(a2.sessionId);
+        await e.handle.mouse.drag(
+          { x: a2.fromX, y: a2.fromY },
+          { x: a2.toX, y: a2.toY },
+          a2.button ?? "left"
+        );
+        return text2({ ok: true });
+      }
+    },
     solari_type: {
       description: "Type text into the focused desktop element.",
       inputSchema: { sessionId: external_exports.string(), text: external_exports.string() },

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.4.4";
+export declare const VERSION = "0.4.5";

package/dist/version.js

@@ -8,4 +8,4 @@
 // `test/version.test.mjs` FAILS the build if it ever drifts from package.json.
 //
 // KEEP IN SYNC WITH sdk/mcp/package.json "version".
-export const VERSION = "0.4.4";
+export const VERSION = "0.4.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solarisdk/mcp",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Model Context Protocol server for the Solari cloud browser, sandboxes + desktops \u2014 drive them from Claude Desktop/Cowork, Claude Code, Cursor, etc.",
   "type": "module",
   "bin": {