@phantomagent/adapter-paperclip-cursor 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# Cursor (Phantom Agent) — Paperclip facade adapter
+
+**Adapter type:** `phantom_cursor`  
+**UI label:** **Cursor (Phantom Agent)**  
+**Runtime:** fixed `cursor-agent` on Phantom workers (not local Cursor)
+
+## Install in Paperclip
+
+Use npm from **Settings → Plugins** / **Settings → Adapters**:
+
+| Step | Package |
+|------|---------|
+| 1. Plugin | `@phantomagent/plugin-paperclip` |
+| 2. Facade adapter | `@phantomagent/adapter-paperclip-cursor` |
+
+Configure credentials in the plugin settings, **Sync capabilities**, restart CP after adapter install, then pick **Cursor (Phantom Agent)** on agents.
+
+### Local path (development)
+
+```bash
+cd integrations
+npm install
+npm run build -w @phantomagent/plugin-paperclip
+paperclipai plugin install /path/to/integrations/packages/plugin-paperclip
+```
+
+Configure Phantom API URL + ApplicationClient credentials in **Settings → Plugins → Phantom Agent**, then **Sync capabilities**.
+
+### Facade adapter
+
+```bash
+npm run build -w @phantomagent/adapter-paperclip-cursor
+```
+
+Paperclip → **Settings → Adapters → Install External Adapter** — npm: `@phantomagent/adapter-paperclip-cursor` (or local path for dev).
+
+Adapter config (same ApplicationClient credentials as the plugin):
+
+| Field | Value |
+|-------|-------|
+| Phantom API URL | `https://api.phantomagent.io` |
+| Application client ID | e.g. `paperclip-staging` |
+| Application client secret | from Phantom Applications → Credentials |
+
+## Do not use
+
+| Adapter | Why |
+|---------|-----|
+| **Cursor** (built-in) | Local Cursor on Paperclip host — not Phantom |
+| **`phantom_runner`** (built-in) | Legacy smoke — being retired after RVA migration |
+| **`phantom_agent`** (deprecated) | Opaque slug field, no runtime picker — use facades |
+
+## Verify
+
+One wake → Phantom Executions shows new `run_id`, log contains:
+
+```text
+[phantom-agent] delegating heartbeat to Phantom (runtime=cursor-agent, auth=application_jwt, no local agent spawn)
+```
+
+See [TASK_PHANTOM_RUNTIME_FACADE_V1.md](../../paperclip/TASK_PHANTOM_RUNTIME_FACADE_V1.md).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const CURSOR_RUNTIME_SLUG = "cursor-agent";
+export declare const type: string, label: string, agentRuntimeSlug: string, models: import("@paperclipai/adapter-utils").AdapterModel[], agentConfigurationDoc: string, createServerAdapter: () => import("@paperclipai/adapter-utils").ServerAdapterModule;
+export { CURSOR_RUNTIME_SLUG };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { createPhantomFacadeExports } from "@phantomagent/adapter-core";
+const CURSOR_RUNTIME_SLUG = "cursor-agent";
+export const { type, label, agentRuntimeSlug, models, agentConfigurationDoc, createServerAdapter } = createPhantomFacadeExports({
+    type: "phantom_cursor",
+    label: "Cursor (Phantom Agent)",
+    agentRuntimeSlug: CURSOR_RUNTIME_SLUG,
+});
+export { CURSOR_RUNTIME_SLUG };

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { createServerAdapter, label, type, agentRuntimeSlug } from "./index.js";
+describe("@phantomagent/adapter-paperclip-cursor", () => {
+    it("exports phantom_cursor facade metadata", () => {
+        expect(type).toBe("phantom_cursor");
+        expect(label).toBe("Cursor (Phantom Agent)");
+        expect(agentRuntimeSlug).toBe("cursor-agent");
+    });
+    it("creates a valid server adapter module", async () => {
+        const adapter = createServerAdapter();
+        expect(adapter.type).toBe("phantom_cursor");
+        expect(typeof adapter.execute).toBe("function");
+        expect(typeof adapter.testEnvironment).toBe("function");
+        expect(typeof adapter.getConfigSchema).toBe("function");
+        const schema = await Promise.resolve(adapter.getConfigSchema?.());
+        expect(schema?.fields.some((field) => field.key === "agentRuntimeSlug")).toBe(false);
+    });
+});

package/dist/server/index.d.ts

@@ -0,0 +1 @@
+export { createServerAdapter } from "../index.js";

package/dist/server/index.js

@@ -0,0 +1 @@
+export { createServerAdapter } from "../index.js";

package/dist/ui-parser.d.ts

@@ -0,0 +1 @@
+export { parseStdoutLine } from "@phantomagent/adapter-core/ui-parser";

package/dist/ui-parser.js

@@ -0,0 +1 @@
+export { parseStdoutLine } from "@phantomagent/adapter-core/ui-parser";

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@phantomagent/adapter-paperclip-cursor",
+  "version": "0.1.0",
+  "description": "Paperclip facade adapter — Cursor (Phantom Agent) with fixed cursor-agent runtime",
+  "license": "MIT",
+  "author": "Phantom Organization",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PhantomOrganization/integrations",
+    "directory": "packages/adapter-paperclip-cursor"
+  },
+  "type": "module",
+  "paperclip": {
+    "adapterUiParser": "1.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./ui-parser": {
+      "types": "./dist/ui-parser.d.ts",
+      "import": "./dist/ui-parser.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@paperclipai/adapter-utils": "^2026.626.0",
+    "@phantomagent/adapter-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.21",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4"
+  }
+}