playclaw 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+# playclaw
+
+Connect your [OpenClaw](https://openclaw.dev) agent to [PlayClaw](https://playclaw.info) — the professional AI agent testing playground.
+
+## Usage
+
+```bash
+npx playclaw PC-XXXX-XXXX-XXXX
+```
+
+Replace `PC-XXXX-XXXX-XXXX` with your PlayClaw connection token from [playclaw.info/connect](https://playclaw.info/connect).
+
+## What it does
+
+1. Reads your OpenClaw gateway token (auto-detects from `~/.openclaw/openclaw.json`)
+2. Connects to your local OpenClaw gateway on `localhost:18789`
+3. Subscribes to a private Supabase Realtime channel using your PC token
+4. Relays messages between the PlayClaw playground and your agent in real time
+
+## Options
+
+```
+npx playclaw <PC-TOKEN> [options]
+
+Options:
+  --gateway-token, -g <token>   OpenClaw gateway bearer token
+  --port, -p <port>             OpenClaw gateway port (default: 18789)
+  --help, -h                    Show help
+```
+
+## Environment variables
+
+```bash
+OPENCLAW_GATEWAY_TOKEN=<token> npx playclaw PC-XXXX-XXXX-XXXX
+```
+
+## Privacy
+
+Only message payloads travel through the private Supabase Realtime channel. Your system prompts, API keys, and agent logic stay on your server.
+
+## License
+
+MIT — [playclaw.info](https://playclaw.info)

package/index.js

@@ -0,0 +1,438 @@
+#!/usr/bin/env node
+
+/**
+ * playclaw — CLI bridge for PlayClaw
+ *
+ * Usage:
+ *   npx playclaw PC-XXXX-XXXX-XXXX
+ *   npx playclaw PC-XXXX-XXXX-XXXX --gateway-token <token>
+ *   npx playclaw PC-XXXX-XXXX-XXXX --port 18789
+ *
+ * What it does:
+ *   1. Reads your OpenClaw gateway token (auto-detects or you provide it)
+ *   2. Connects to your local OpenClaw gateway (localhost:18789)
+ *   3. Subscribes to PlayClaw's Supabase Realtime channel (bridge:<token>)
+ *   4. Relays messages between the PlayClaw playground and your agent
+ *
+ * No separate bridge server needed — everything runs through Supabase.
+ */
+
+"use strict";
+
+const { createClient } = require("@supabase/supabase-js");
+const WebSocket = require("ws");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const http = require("http");
+
+// ─── Parse args ───────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+  printHelp();
+  process.exit(0);
+}
+
+const playclawToken = args[0];
+if (!playclawToken.startsWith("PC-")) {
+  console.error("❌ Invalid PlayClaw token. It should start with PC-");
+  console.error("   Get your token from: https://playclaw.info/connect");
+  process.exit(1);
+}
+
+// Optional flags
+const flagIndex = (flag) => args.findIndex((a) => a === flag);
+const flagValue = (flag) => {
+  const i = flagIndex(flag);
+  return i !== -1 ? args[i + 1] : null;
+};
+
+const gatewayPortArg = parseInt(flagValue("--port") || flagValue("-p")) || null;
+const gatewayTokenArg = flagValue("--gateway-token") || flagValue("-g");
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+// PlayClaw's Supabase public credentials — safe to embed (anon key is public)
+// These are overridable via env vars for local development / self-hosting.
+const SUPABASE_URL =
+  process.env.PLAYCLAW_SUPABASE_URL || "https://bbplxuprwmbkbslvwjfv.supabase.co";
+const SUPABASE_ANON_KEY =
+  process.env.PLAYCLAW_SUPABASE_ANON_KEY ||
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImJicGx4dXByd21ia2JzbHZ3amZ2Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzIzMjY2OTIsImV4cCI6MjA4NzkwMjY5Mn0.Y_R6ozJmyCiu_oCKJYJ7Bt17xbztRlZEk7eAI2D81fM";
+
+const OPENCLAW_PORT =
+  gatewayPortArg ||
+  parseInt(process.env.OPENCLAW_PORT || "") ||
+  18789;
+
+// ─── Auto-detect OpenClaw gateway token ─────────────────────────────────────
+
+function detectGatewayToken() {
+  // 1. CLI flag
+  if (gatewayTokenArg) return gatewayTokenArg;
+
+  // 2. Environment variable
+  if (process.env.OPENCLAW_GATEWAY_TOKEN) return process.env.OPENCLAW_GATEWAY_TOKEN;
+
+  // 3. Auto-detect from ~/.openclaw/openclaw.json
+  const configPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
+  try {
+    if (!fs.existsSync(configPath)) return null;
+    // openclaw.json supports JSON5 (comments + trailing commas) — strip them
+    const raw = fs.readFileSync(configPath, "utf-8");
+    const cleaned = raw
+      .replace(/\/\/[^\n]*/g, "")       // strip // comments
+      .replace(/\/\*[\s\S]*?\*\//g, "") // strip /* */ comments
+      .replace(/,\s*([}\]])/g, "$1");   // strip trailing commas
+    const config = JSON.parse(cleaned);
+    return config?.gateway?.auth?.token || null;
+  } catch {
+    return null;
+  }
+}
+
+const gatewayToken = detectGatewayToken();
+
+if (!gatewayToken) {
+  console.error("");
+  console.error("❌ Could not find your OpenClaw gateway token.");
+  console.error("");
+  console.error("   Option A — provide it directly:");
+  console.error(`     npx playclaw ${playclawToken} --gateway-token <your-token>`);
+  console.error("");
+  console.error("   Option B — set an env var:");
+  console.error(`     OPENCLAW_GATEWAY_TOKEN=<token> npx playclaw ${playclawToken}`);
+  console.error("");
+  console.error("   Option C — find it in your OpenClaw config:");
+  console.error("     openclaw config get gateway.auth.token");
+  console.error("     or look in: ~/.openclaw/openclaw.json → gateway.auth.token");
+  console.error("");
+  process.exit(1);
+}
+
+// ─── Logging ─────────────────────────────────────────────────────────────────
+
+const c = {
+  reset:   "\x1b[0m",
+  bold:    "\x1b[1m",
+  dim:     "\x1b[2m",
+  green:   "\x1b[32m",
+  yellow:  "\x1b[33m",
+  red:     "\x1b[31m",
+  cyan:    "\x1b[36m",
+  magenta: "\x1b[35m",
+};
+
+function log(icon, msg, color = c.reset) {
+  const time = new Date().toLocaleTimeString("en-US", { hour12: false });
+  console.log(`${c.dim}${time}${c.reset} ${icon} ${color}${msg}${c.reset}`);
+}
+
+// ─── State ────────────────────────────────────────────────────────────────────
+
+let openclawWs    = null;
+let bridgeChannel = null;
+let openclawReady = false;
+let pendingMessages = []; // queued while OpenClaw reconnects
+let reconnectTimer  = null;
+
+// ─── Supabase client ─────────────────────────────────────────────────────────
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, {
+  realtime: { params: { eventsPerSecond: 10 } },
+});
+
+// ─── OpenClaw Gateway connection ─────────────────────────────────────────────
+
+function connectToOpenClaw() {
+  openclawReady = false;
+
+  openclawWs = new WebSocket(`ws://localhost:${OPENCLAW_PORT}`, {
+    headers: { Authorization: `Bearer ${gatewayToken}` },
+  });
+
+  openclawWs.on("open", () => {
+    // Send OpenClaw handshake — identifies us as an "operator" client
+    openclawWs.send(
+      JSON.stringify({
+        type:   "req",
+        id:     `playclaw-${Date.now()}`,
+        method: "connect",
+        params: {
+          role:    "operator",
+          token:   gatewayToken,
+          client:  "playclaw",
+          version: "1.0.0",
+        },
+      })
+    );
+  });
+
+  openclawWs.on("message", (raw) => {
+    let msg;
+    try { msg = JSON.parse(raw.toString()); } catch { return; }
+
+    // Handshake accepted — we're in
+    if (msg.type === "res" && msg.ok && !openclawReady) {
+      openclawReady = true;
+      log("✅", `OpenClaw gateway connected (port ${OPENCLAW_PORT})`, c.green);
+
+      // Flush messages that arrived while we were reconnecting
+      while (pendingMessages.length > 0) {
+        const queued = pendingMessages.shift();
+        sendToOpenClaw(queued.content, queued.sessionId);
+      }
+
+      // Connect to PlayClaw via Supabase Realtime (only once)
+      if (!bridgeChannel) connectToBridge();
+      return;
+    }
+
+    // Auth failure — stop immediately
+    if (msg.type === "res" && !msg.ok) {
+      log("❌", `OpenClaw auth failed: ${msg.error?.message || "Unknown error"}`, c.red);
+      log("   ", "Check your gateway token and try again.", c.yellow);
+      process.exit(1);
+    }
+
+    // Agent response events
+    if (msg.type === "event") {
+      handleOpenClawEvent(msg);
+    }
+  });
+
+  openclawWs.on("error", (err) => {
+    if (err.code === "ECONNREFUSED") {
+      log("⚠️ ", `OpenClaw not found on port ${OPENCLAW_PORT}. Is it running?`, c.yellow);
+      log("   ", "Start it with: openclaw gateway run", c.dim);
+    } else {
+      log("❌", `OpenClaw error: ${err.message}`, c.red);
+    }
+  });
+
+  openclawWs.on("close", () => {
+    openclawReady = false;
+    log("⚠️ ", "OpenClaw disconnected. Reconnecting in 5s...", c.yellow);
+    clearTimeout(reconnectTimer);
+    reconnectTimer = setTimeout(connectToOpenClaw, 5000);
+  });
+}
+
+// ─── Handle events from OpenClaw ─────────────────────────────────────────────
+
+function handleOpenClawEvent(msg) {
+  const eventName = msg.event || "";
+
+  // We listen for several possible response event names.
+  // OpenClaw's exact event depends on version — DEBUG=1 logs all events.
+  const responseEvents = [
+    "agent.response",
+    "message.sent",
+    "turn.complete",
+    "reply.sent",
+    "assistant.message",
+    "output.complete",
+  ];
+
+  if (responseEvents.some((e) => eventName.includes(e))) {
+    const content =
+      msg.payload?.content ||
+      msg.payload?.text    ||
+      msg.payload?.message ||
+      msg.payload?.reply   ||
+      msg.payload?.output  ||
+      JSON.stringify(msg.payload);
+
+    if (content) {
+      log("📨", `Agent responded: "${String(content).substring(0, 80)}..."`, c.cyan);
+      forwardResponseToPlayClaw(String(content));
+    }
+  } else if (process.env.DEBUG) {
+    log("🔍", `[DEBUG] OpenClaw event: ${eventName}`, c.dim);
+    if (process.env.DEBUG === "2") {
+      console.log("        payload:", JSON.stringify(msg.payload, null, 2));
+    }
+  }
+}
+
+// ─── Send message to OpenClaw ─────────────────────────────────────────────────
+
+function sendToOpenClaw(content, sessionId) {
+  if (!openclawReady) {
+    pendingMessages.push({ content, sessionId });
+    return;
+  }
+
+  // POST to /hooks/agent — OpenClaw's async webhook endpoint (returns 202)
+  // The agent processes it and emits an event back on the WebSocket.
+  const body = JSON.stringify({
+    message:        content,
+    agentId:        "hooks",
+    wakeMode:       "now",
+    channel:        "last",
+    sessionKey:     sessionId || "playclaw",
+    timeoutSeconds: 60,
+  });
+
+  const req = http.request(
+    {
+      hostname: "localhost",
+      port:     OPENCLAW_PORT,
+      path:     "/hooks/agent",
+      method:   "POST",
+      headers:  {
+        "Content-Type":     "application/json",
+        "Authorization":    `Bearer ${gatewayToken}`,
+        "x-openclaw-token": gatewayToken,
+        "Content-Length":   Buffer.byteLength(body),
+      },
+    },
+    (res) => {
+      if (res.statusCode === 202) {
+        log("📤", `Message sent to agent (session: ${sessionId || "default"})`, c.magenta);
+      } else if (res.statusCode === 401) {
+        log("❌", "OpenClaw auth failed — check your gateway token", c.red);
+      } else {
+        log("⚠️ ", `Unexpected status from OpenClaw: ${res.statusCode}`, c.yellow);
+      }
+    }
+  );
+
+  req.on("error", (err) => {
+    log("❌", `Failed to reach OpenClaw: ${err.message}`, c.red);
+    forwardErrorToPlayClaw("Could not reach OpenClaw gateway. Is it running?");
+  });
+
+  req.write(body);
+  req.end();
+}
+
+// ─── PlayClaw Bridge via Supabase Realtime ────────────────────────────────────
+
+function connectToBridge() {
+  // Channel name = PC token → acts as a shared secret between CLI and playground
+  bridgeChannel = supabase.channel(`bridge:${playclawToken}`, {
+    config: {
+      broadcast: { ack: false },   // fire-and-forget is fine for low-latency relay
+      presence:  { key: "cli" },   // track CLI presence so playground knows we're live
+    },
+  });
+
+  bridgeChannel
+    // Listen for messages from the playground
+    .on("broadcast", { event: "playground:message" }, ({ payload }) => {
+      log("💬", `From playground: "${payload.content?.substring(0, 60)}"`, c.cyan);
+      sendToOpenClaw(payload.content, payload.session_id);
+    })
+    .subscribe(async (status) => {
+      if (status === "SUBSCRIBED") {
+        // Signal that the CLI is online (playground reads this via presence)
+        await bridgeChannel.track({
+          online_at: new Date().toISOString(),
+          token:     playclawToken,
+        });
+
+        log("✅", "PlayClaw Bridge connected (Supabase Realtime)", c.green);
+        log("🎮", "Agent is ready to be tested!", c.bold);
+        log("   ", "Open https://playclaw.info/playground to start.", c.dim);
+        console.log("");
+
+      } else if (status === "CHANNEL_ERROR") {
+        log("❌", "Bridge connection failed. Check your PC token.", c.red);
+
+      } else if (status === "TIMED_OUT") {
+        log("⚠️ ", "Bridge timed out. Reconnecting in 5s...", c.yellow);
+        supabase.removeChannel(bridgeChannel);
+        bridgeChannel = null;
+        setTimeout(connectToBridge, 5000);
+
+      } else if (status === "CLOSED") {
+        log("⚠️ ", "Bridge disconnected. Reconnecting in 5s...", c.yellow);
+        bridgeChannel = null;
+        setTimeout(connectToBridge, 5000);
+      }
+    });
+}
+
+function forwardResponseToPlayClaw(content, sessionId) {
+  if (!bridgeChannel) {
+    log("⚠️ ", "Bridge not ready — response dropped", c.yellow);
+    return;
+  }
+  bridgeChannel.send({
+    type:    "broadcast",
+    event:   "agent:response",
+    payload: { content, session_id: sessionId || null },
+  });
+}
+
+function forwardErrorToPlayClaw(message) {
+  if (!bridgeChannel) return;
+  bridgeChannel.send({
+    type:    "broadcast",
+    event:   "agent:error",
+    payload: { message },
+  });
+}
+
+// ─── Startup banner ───────────────────────────────────────────────────────────
+
+function printBanner() {
+  console.log("");
+  console.log(`${c.bold}${c.magenta}   🦞 PlayClaw Bridge${c.reset}`);
+  console.log(`${c.dim}   https://playclaw.info${c.reset}`);
+  console.log("");
+  console.log(`${c.dim}   PC Token:${c.reset}  ${playclawToken}`);
+  console.log(`${c.dim}   Gateway:${c.reset}   localhost:${OPENCLAW_PORT}`);
+  console.log(`${c.dim}   Relay:${c.reset}     Supabase Realtime`);
+  console.log("");
+}
+
+function printHelp() {
+  console.log("");
+  console.log("  Usage: npx playclaw <PC-TOKEN> [options]");
+  console.log("");
+  console.log("  Arguments:");
+  console.log("    PC-TOKEN       Your PlayClaw connection token (from playclaw.info/connect)");
+  console.log("");
+  console.log("  Options:");
+  console.log("    --gateway-token, -g <token>   OpenClaw gateway bearer token");
+  console.log("    --port, -p <port>              OpenClaw gateway port (default: 18789)");
+  console.log("    --help, -h                     Show this help");
+  console.log("");
+  console.log("  Examples:");
+  console.log("    npx playclaw PC-XXXX-XXXX-XXXX");
+  console.log("    npx playclaw PC-XXXX-XXXX-XXXX --gateway-token my-secret-token");
+  console.log("    OPENCLAW_GATEWAY_TOKEN=mytoken npx playclaw PC-XXXX-XXXX-XXXX");
+  console.log("");
+  console.log("  Auto-detection:");
+  console.log("    The gateway token is auto-read from ~/.openclaw/openclaw.json");
+  console.log("    if not provided. Run `openclaw config get gateway.auth.token`");
+  console.log("    to find yours.");
+  console.log("");
+}
+
+// ─── Graceful shutdown ────────────────────────────────────────────────────────
+
+async function shutdown() {
+  console.log("");
+  log("👋", "Shutting down PlayClaw bridge...", c.dim);
+
+  if (bridgeChannel) {
+    await bridgeChannel.untrack().catch(() => {});
+    await supabase.removeChannel(bridgeChannel).catch(() => {});
+  }
+
+  openclawWs?.close();
+  process.exit(0);
+}
+
+process.on("SIGINT",  shutdown);
+process.on("SIGTERM", shutdown);
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+printBanner();
+connectToOpenClaw();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "playclaw",
+  "version": "1.0.0",
+  "description": "Connect your OpenClaw agent to PlayClaw — the professional testing playground",
+  "main": "index.js",
+  "bin": {
+    "playclaw": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.49.1",
+    "ws": "^8.18.0"
+  },
+  "keywords": [
+    "openclaw",
+    "playclaw",
+    "ai-agent",
+    "bridge",
+    "testing",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "author": "PlayClaw <hello@playclaw.info>",
+  "homepage": "https://playclaw.info",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WonuSama/PLAYCLAW.git",
+    "directory": "packages/playclaw"
+  },
+  "bugs": {
+    "url": "https://github.com/WonuSama/PLAYCLAW/issues"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ]
+}