@react-grab/cursor 0.0.55 → 0.0.56

package/README.md

@@ -0,0 +1,78 @@
+# @react-grab/cursor
+
+Cursor agent provider for React Grab. Requires running a local server that interfaces with the Cursor Agent CLI.
+
+## Installation
+
+```bash
+npm install @react-grab/cursor
+# or
+pnpm add @react-grab/cursor
+# or
+bun add @react-grab/cursor
+# or
+yarn add @react-grab/cursor
+```
+
+## Server Setup
+
+The server runs on port `5567` by default.
+
+### Vite
+
+```ts
+// vite.config.ts
+import "@react-grab/cursor/server";
+```
+
+### Next.js
+
+```ts
+// next.config.ts
+import "@react-grab/cursor/server";
+```
+
+## Client Usage
+
+```tsx
+import { init } from "react-grab/core";
+import { createCursorAgentProvider } from "@react-grab/cursor/client";
+
+const agentProvider = createCursorAgentProvider();
+
+init({
+  agent: {
+    provider: agentProvider,
+  },
+});
+```
+
+## Configuration
+
+You can customize the server URL and default options:
+
+```tsx
+const agentProvider = createCursorAgentProvider({
+  getOptions: () => ({
+    model: "composer-1",
+    workspace: "/path/to/workspace",
+  }),
+});
+```
+
+## How It Works
+
+```
+┌─────────────────┐      HTTP       ┌─────────────────┐     stdin      ┌─────────────────┐
+│                 │  localhost:5567 │                 │                │                 │
+│   React Grab    │ ──────────────► │     Server      │ ─────────────► │  cursor-agent   │
+│    (Browser)    │ ◄────────────── │   (Node.js)     │ ◄───────────── │      (CLI)      │
+│                 │       SSE       │                 │     stdout     │                 │
+└─────────────────┘                 └─────────────────┘                └─────────────────┘
+      Client                              Server                            Agent
+```
+
+1. **React Grab** sends the selected element context to the server via HTTP POST
+2. **Server** receives the request and spawns the `cursor-agent` CLI process
+3. **cursor-agent** processes the request and streams JSON responses to stdout
+4. **Server** relays status updates to the client via Server-Sent Events (SSE)

package/dist/server.cjs

@@ -2301,7 +2301,7 @@ ${content}`;
         cursorAgentArgs.push("--workspace", process.cwd());
       }
       try {
-        await stream2.writeSSE({ data: "Starting Cursor Agent...", event: "status" });
+        await stream2.writeSSE({ data: "Planning next moves", event: "status" });
         const cursorProcess = child_process.spawn("cursor-agent", cursorAgentArgs, {
           stdio: ["pipe", "pipe", "pipe"],
           env: { ...process.env }
@@ -2313,29 +2313,43 @@ ${content}`;
           switch (event.type) {
             case "system":
               if (event.subtype === "init") {
-                await stream2.writeSSE({ data: "Connected to Cursor Agent", event: "status" });
+                await stream2.writeSSE({
+                  data: "Planning next moves",
+                  event: "status"
+                });
               }
               break;
             case "thinking":
               if (event.subtype === "completed") {
-                await stream2.writeSSE({ data: "Processing...", event: "status" });
+                await stream2.writeSSE({
+                  data: "Thinking\u2026",
+                  event: "status"
+                });
               }
               break;
             case "assistant": {
-              const text = extractTextFromMessage(event.message);
-              if (text) {
-                const statusUpdate = text.length > 150 ? `${text.slice(0, 150)}...` : text;
-                await stream2.writeSSE({ data: statusUpdate, event: "status" });
+              const textContent = extractTextFromMessage(event.message);
+              if (textContent) {
+                await stream2.writeSSE({ data: textContent, event: "status" });
               }
               break;
             }
             case "result":
               if (event.subtype === "success") {
-                await stream2.writeSSE({ data: "Completed successfully", event: "status" });
+                await stream2.writeSSE({
+                  data: "Completed successfully",
+                  event: "status"
+                });
               } else if (event.subtype === "error" || event.is_error) {
-                await stream2.writeSSE({ data: `Error: ${event.result || "Unknown error"}`, event: "error" });
+                await stream2.writeSSE({
+                  data: `Error: ${event.result || "Unknown error"}`,
+                  event: "error"
+                });
               } else {
-                await stream2.writeSSE({ data: "Task finished", event: "status" });
+                await stream2.writeSSE({
+                  data: "Task finished",
+                  event: "status"
+                });
               }
               break;
           }
@@ -2372,7 +2386,10 @@ ${content}`;
         await stream2.writeSSE({ data: "", event: "done" });
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        await stream2.writeSSE({ data: `Error: ${errorMessage}`, event: "error" });
+        await stream2.writeSSE({
+          data: `Error: ${errorMessage}`,
+          event: "error"
+        });
         await stream2.writeSSE({ data: "", event: "done" });
       }
     });

package/dist/server.js

@@ -2295,7 +2295,7 @@ ${content}`;
         cursorAgentArgs.push("--workspace", process.cwd());
       }
       try {
-        await stream2.writeSSE({ data: "Starting Cursor Agent...", event: "status" });
+        await stream2.writeSSE({ data: "Planning next moves", event: "status" });
         const cursorProcess = spawn("cursor-agent", cursorAgentArgs, {
           stdio: ["pipe", "pipe", "pipe"],
           env: { ...process.env }
@@ -2307,29 +2307,43 @@ ${content}`;
           switch (event.type) {
             case "system":
               if (event.subtype === "init") {
-                await stream2.writeSSE({ data: "Connected to Cursor Agent", event: "status" });
+                await stream2.writeSSE({
+                  data: "Planning next moves",
+                  event: "status"
+                });
               }
               break;
             case "thinking":
               if (event.subtype === "completed") {
-                await stream2.writeSSE({ data: "Processing...", event: "status" });
+                await stream2.writeSSE({
+                  data: "Thinking\u2026",
+                  event: "status"
+                });
               }
               break;
             case "assistant": {
-              const text = extractTextFromMessage(event.message);
-              if (text) {
-                const statusUpdate = text.length > 150 ? `${text.slice(0, 150)}...` : text;
-                await stream2.writeSSE({ data: statusUpdate, event: "status" });
+              const textContent = extractTextFromMessage(event.message);
+              if (textContent) {
+                await stream2.writeSSE({ data: textContent, event: "status" });
               }
               break;
             }
             case "result":
               if (event.subtype === "success") {
-                await stream2.writeSSE({ data: "Completed successfully", event: "status" });
+                await stream2.writeSSE({
+                  data: "Completed successfully",
+                  event: "status"
+                });
               } else if (event.subtype === "error" || event.is_error) {
-                await stream2.writeSSE({ data: `Error: ${event.result || "Unknown error"}`, event: "error" });
+                await stream2.writeSSE({
+                  data: `Error: ${event.result || "Unknown error"}`,
+                  event: "error"
+                });
               } else {
-                await stream2.writeSSE({ data: "Task finished", event: "status" });
+                await stream2.writeSSE({
+                  data: "Task finished",
+                  event: "status"
+                });
               }
               break;
           }
@@ -2366,7 +2380,10 @@ ${content}`;
         await stream2.writeSSE({ data: "", event: "done" });
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        await stream2.writeSSE({ data: `Error: ${errorMessage}`, event: "error" });
+        await stream2.writeSSE({
+          data: `Error: ${errorMessage}`,
+          event: "error"
+        });
         await stream2.writeSSE({ data: "", event: "done" });
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-grab/cursor",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "type": "module",
   "exports": {
     "./client": {
@@ -23,7 +23,7 @@
   "dependencies": {
     "@hono/node-server": "^1.19.6",
     "hono": "^4.0.0",
-    "react-grab": "0.0.55"
+    "react-grab": "0.0.56"
   },
   "scripts": {
     "dev": "tsup --watch",