rentline-sandbox 0.1.2 → 0.1.4

package/README.md

@@ -20,6 +20,32 @@ Requires Node.js ≥ 18.
 
 ---
 
+## Setup
+
+Run once after install. Saves your credentials and automatically configures your AI client:
+
+```bash
+sandbox setup
+```
+
+The wizard will:
+1. Ask for your API key (get one at **sandbox.rentline.xyz/cli-auth**)
+2. Verify connectivity to the API
+3. Save credentials to `~/.rentline-sandbox/credentials.json`
+4. Detect your AI client (Claude Code, Cursor, Windsurf, OpenCode) and patch its MCP config
+5. Install `SKILL.md` so your agent understands the game
+
+**Non-interactive:**
+```bash
+sandbox setup --key sb_xxx --client opencode --yes
+```
+
+Supported clients: `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `opencode`, `zed`, `cline`
+
+After setup, **restart your AI client** to load the MCP server.
+
+---
+
 ## Authentication
 
 ### Browser login (recommended)

package/dist/index.js

@@ -9,7 +9,7 @@ var _require = createRequire(import.meta.url);
 var { version } = _require("../package.json");
 var args = process.argv.slice(2);
 if (args[0] === "setup" || args[0] === "--setup") {
-  const { runSetup, parseSetupArgs } = await import("./setup-JPLRGUPW.js");
+  const { runSetup, parseSetupArgs } = await import("./setup-MMARJIKJ.js");
   const opts = parseSetupArgs(args.filter((a) => a !== "setup" && a !== "--setup"));
   await runSetup(opts);
   process.exit(0);
@@ -31,7 +31,7 @@ if (args.length === 0 || args[0] === "server" || args[0] === "--server") {
   registerMortgage(program);
   registerAdmin(program);
   program.command("mcp-setup", { hidden: true }).allowUnknownOption().action(async () => {
-    const { runSetup, parseSetupArgs } = await import("./setup-JPLRGUPW.js");
+    const { runSetup, parseSetupArgs } = await import("./setup-MMARJIKJ.js");
     const opts = parseSetupArgs(process.argv.slice(3));
     await runSetup(opts);
   });

package/dist/{setup-JPLRGUPW.js → setup-MMARJIKJ.js}

@@ -13,6 +13,7 @@ import { createInterface } from "readline";
 import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync } from "fs";
 import { homedir, platform } from "os";
 import { join, dirname } from "path";
+import { execSync } from "child_process";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -51,7 +52,7 @@ async function runSetup(opts) {
     }
   }
   if (!apiKey) {
-    console.error("API key is required. Get one from your sandbox-api admin.");
+    console.error("API key is required. Get one at: https://sandbox.rentline.xyz/cli-auth");
     process.exit(1);
   }
   const existing = loadConfig();
@@ -90,7 +91,7 @@ async function runSetup(opts) {
     const idx = parseInt(choice);
     clientName = isNaN(idx) ? choice : clients[idx - 1] ?? "other";
   }
-  await installForClient(clientName, opts.scope ?? "user", apiKey, apiUrl, displayName);
+  await installForClient(clientName, opts.scope ?? "user", apiKey, apiUrl);
   rl?.close();
   console.log("\nSetup complete. Restart your AI client to load the Rentline Sandbox MCP server.\n");
 }
@@ -102,84 +103,66 @@ function detectClient() {
   if (env.OPENCODE_PROJECT || env.OPENCODE_SESSION) return "opencode";
   return void 0;
 }
-var MCP_SERVER_ENTRY = {
-  command: "npx",
-  args: ["-y", "rentline-sandbox"],
-  env: {}
-};
-function mcpEntry(apiKey, apiUrl) {
-  return {
-    ...MCP_SERVER_ENTRY,
-    env: {
-      SANDBOX_API_KEY: apiKey,
-      SANDBOX_API_URL: apiUrl
-    }
-  };
-}
-async function installForClient(clientName, scope, apiKey, apiUrl, displayName) {
-  const entry = mcpEntry(apiKey, apiUrl);
+var NPX_CMD = ["npx", "-y", "rentline-sandbox"];
+async function installForClient(clientName, scope, apiKey, apiUrl) {
+  const env = { SANDBOX_API_KEY: apiKey, SANDBOX_API_URL: apiUrl };
   switch (clientName) {
     case "claude-code": {
-      const { execSync } = await import("child_process");
-      const envFlags = Object.entries(entry.env ?? {}).map(([k, v]) => `-e ${k}=${v}`).join(" ");
-      const cmd = `claude mcp add rentline-sandbox --scope ${scope} ${envFlags} -- npx -y rentline-sandbox`;
+      const envFlags = Object.entries(env).map(([k, v]) => `-e ${k}="${v}"`).join(" ");
+      const cmd = `claude mcp add rentline-sandbox --scope ${scope} ${envFlags} -- ${NPX_CMD.join(" ")}`;
       try {
         execSync(cmd, { stdio: "pipe" });
         console.log(`Installed via claude CLI (scope=${scope})`);
       } catch {
         const file = join(homedir(), ".claude.json");
-        patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
+        patchMcpJson(file, "rentline-sandbox", { command: NPX_CMD[0], args: NPX_CMD.slice(1), env }, "mcpServers");
         console.log(`Patched ${file}`);
       }
-      const skillSrc = join(__dirname, "../SKILL.md");
-      if (existsSync(skillSrc)) {
-        const targets = [
-          join(homedir(), ".claude", "skills", "rentline-sandbox"),
-          join(homedir(), ".agents", "skills", "rentline-sandbox")
-        ];
-        for (const dir of targets) {
-          mkdirSync(dir, { recursive: true });
-          copyFileSync(skillSrc, join(dir, "SKILL.md"));
-          console.log(`SKILL.md \u2192 ${dir}`);
-        }
-      }
+      installSkill([
+        join(homedir(), ".claude", "skills", "rentline-sandbox"),
+        join(homedir(), ".agents", "skills", "rentline-sandbox")
+      ]);
       break;
     }
     case "claude-desktop": {
-      const file = platform() === "win32" ? join(process.env.APPDATA ?? homedir(), "Claude", "claude_desktop_config.json") : join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
-      patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
+      let file;
+      if (platform() === "win32") {
+        file = join(process.env.APPDATA ?? homedir(), "Claude", "claude_desktop_config.json");
+      } else if (platform() === "darwin") {
+        file = join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+      } else {
+        file = join(homedir(), ".config", "Claude", "claude_desktop_config.json");
+      }
+      patchMcpJson(file, "rentline-sandbox", { command: NPX_CMD[0], args: NPX_CMD.slice(1), env }, "mcpServers");
       console.log(`Patched ${file}`);
       break;
     }
     case "cursor": {
       const file = scope === "project" ? join(process.cwd(), ".cursor", "mcp.json") : join(homedir(), ".cursor", "mcp.json");
-      patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
+      patchMcpJson(file, "rentline-sandbox", { command: NPX_CMD[0], args: NPX_CMD.slice(1), env }, "mcpServers");
       console.log(`Patched ${file}`);
       break;
     }
     case "windsurf": {
-      const file = join(process.cwd(), ".windsurf", "mcp.json");
-      patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
+      const file = platform() === "win32" ? join(process.env.APPDATA ?? homedir(), ".codeium", "windsurf", "mcp_config.json") : join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+      patchMcpJson(file, "rentline-sandbox", { command: NPX_CMD[0], args: NPX_CMD.slice(1), env }, "mcpServers");
       console.log(`Patched ${file}`);
       break;
     }
     case "opencode": {
-      const file = scope === "project" ? join(process.cwd(), "opencode.json") : join(homedir(), ".config", "opencode", "config.json");
-      patchMcpJson(file, "rentline-sandbox", entry, "mcp");
+      const file = scope === "project" ? join(process.cwd(), "opencode.json") : join(homedir(), ".config", "opencode", "opencode.json");
+      patchMcpJson(file, "rentline-sandbox", {
+        type: "local",
+        command: NPX_CMD,
+        enabled: true,
+        environment: env
+      }, "mcp");
       console.log(`Patched ${file}`);
-      const skillSrc = join(__dirname, "../SKILL.md");
-      if (existsSync(skillSrc)) {
-        const targets = [
-          join(homedir(), ".config", "opencode", "skills", "rentline-sandbox"),
-          join(homedir(), ".claude", "skills", "rentline-sandbox"),
-          join(homedir(), ".agents", "skills", "rentline-sandbox")
-        ];
-        for (const dir of targets) {
-          mkdirSync(dir, { recursive: true });
-          copyFileSync(skillSrc, join(dir, "SKILL.md"));
-          console.log(`SKILL.md \u2192 ${dir}`);
-        }
-      }
+      installSkill([
+        join(homedir(), ".config", "opencode", "skills", "rentline-sandbox"),
+        join(homedir(), ".claude", "skills", "rentline-sandbox"),
+        join(homedir(), ".agents", "skills", "rentline-sandbox")
+      ]);
       break;
     }
     case "zed":
@@ -190,11 +173,22 @@ async function installForClient(clientName, scope, apiKey, apiUrl, displayName)
       console.log(`
 Add the following to your MCP client config:
 `);
-      console.log(JSON.stringify({ "rentline-sandbox": entry }, null, 2));
+      console.log(JSON.stringify({
+        "rentline-sandbox": { command: NPX_CMD[0], args: NPX_CMD.slice(1), env }
+      }, null, 2));
       break;
     }
   }
 }
+function installSkill(dirs) {
+  const skillSrc = join(__dirname, "../SKILL.md");
+  if (!existsSync(skillSrc)) return;
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true });
+    copyFileSync(skillSrc, join(dir, "SKILL.md"));
+    console.log(`SKILL.md \u2192 ${dir}`);
+  }
+}
 function patchMcpJson(filePath, serverName, entry, key) {
   mkdirSync(dirname(filePath), { recursive: true });
   let config = {};
@@ -204,6 +198,9 @@ function patchMcpJson(filePath, serverName, entry, key) {
     } catch {
     }
   }
+  if (key === "mcp" && !config["$schema"]) {
+    config["$schema"] = "https://opencode.ai/config.json";
+  }
   const servers = config[key] ?? {};
   servers[serverName] = entry;
   config[key] = servers;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "rentline-sandbox",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI and MCP server for the Rentline Sandbox real estate investment simulation game",
   "type": "module",
   "bin": {
     "sandbox": "dist/index.js",
-    "sandbox-mcp": "dist/server.js"
+    "sandbox-mcp": "dist/server.js",
+    "rentline-sandbox": "dist/server.js"
   },
   "main": "./dist/index.js",
   "exports": {