rentline-sandbox 0.1.2

package/dist/auth-M7RU2YB3.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_API_URL,
+  deleteConfig,
+  loadConfig,
+  saveConfig
+} from "./chunk-Q5AKRRZ2.js";
+import {
+  createClient
+} from "./chunk-X3OZHOPM.js";
+
+// src/commands/auth.ts
+import { createInterface } from "readline";
+var CLI_AUTH_URL = "https://sandbox.rentline.xyz/cli-auth";
+async function openBrowser(url) {
+  const { platform } = process;
+  const { spawn } = await import("child_process");
+  const cmd = platform === "win32" ? "cmd" : platform === "darwin" ? "open" : "xdg-open";
+  const args = platform === "win32" ? ["/c", "start", "", url] : [url];
+  spawn(cmd, args, { detached: true, stdio: "ignore" }).unref();
+}
+function prompt(question) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+function registerAuth(program) {
+  const auth = program.command("auth").description("Manage sandbox API credentials");
+  auth.command("login").description("Authenticate with sandbox-api (browser OAuth or direct API key)").option("--key <key>", "API key for direct login (skips browser)").option("--url <url>", "Sandbox API base URL", DEFAULT_API_URL).option("--name <name>", "Your default display name in games", "Player").action(async (opts) => {
+    if (opts.key) {
+      const client2 = createClient({ apiUrl: opts.url, apiKey: opts.key });
+      process.stdout.write("Verifying credentials\u2026 ");
+      try {
+        const health = await client2.health();
+        console.log(`OK (${health.service})`);
+      } catch (e) {
+        console.log(`FAILED`);
+        console.error(`Could not reach ${opts.url}: ${e}`);
+        console.error("Check that sandbox-api is running and the URL is correct.");
+        process.exit(1);
+      }
+      saveConfig({
+        api_key: opts.key,
+        api_url: opts.url,
+        display_name: opts.name,
+        created_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      console.log(`
+Credentials saved to ~/.rentline-sandbox/credentials.json`);
+      console.log(`API URL:      ${opts.url}`);
+      console.log(`Display name: ${opts.name}`);
+      return;
+    }
+    console.log("\nOpening browser to sign in with Clerk\u2026");
+    console.log(`
+  ${CLI_AUTH_URL}
+`);
+    console.log("If the browser does not open automatically, visit the URL above.\n");
+    try {
+      await openBrowser(CLI_AUTH_URL);
+    } catch {
+    }
+    const rawKey = await prompt("Paste the key shown in the browser and press Enter: ");
+    if (!rawKey || rawKey.length < 8) {
+      console.error("No key provided. Login cancelled.");
+      process.exit(1);
+    }
+    const client = createClient({ apiUrl: opts.url, apiKey: rawKey });
+    process.stdout.write("Verifying key\u2026 ");
+    try {
+      const health = await client.health();
+      console.log(`OK (${health.service})`);
+    } catch (e) {
+      console.log(`FAILED`);
+      console.error(`Could not reach ${opts.url}: ${e}`);
+      console.error("Check that sandbox-api is running and the URL is correct.");
+      process.exit(1);
+    }
+    saveConfig({
+      api_key: rawKey,
+      api_url: opts.url,
+      display_name: opts.name,
+      created_at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    console.log(`
+Logged in. Credentials saved to ~/.rentline-sandbox/credentials.json`);
+    console.log(`API URL:      ${opts.url}`);
+    console.log(`Display name: ${opts.name}`);
+  });
+  auth.command("logout").description("Remove saved credentials").action(() => {
+    deleteConfig();
+    console.log("Logged out. Credentials removed.");
+  });
+  auth.command("whoami").description("Show current credentials and API connectivity").action(async () => {
+    const cfg = loadConfig();
+    if (!cfg) {
+      console.log("Not logged in. Run: sandbox auth login");
+      return;
+    }
+    console.log(`API URL:      ${cfg.api_url}`);
+    console.log(`Display name: ${cfg.display_name ?? "(not set)"}`);
+    console.log(`Key prefix:   ${cfg.api_key.slice(0, 8)}\u2026`);
+    const client = createClient({ apiUrl: cfg.api_url, apiKey: cfg.api_key });
+    process.stdout.write("Connectivity: ");
+    try {
+      const h = await client.health();
+      console.log(`\u2713 ${h.service} is reachable`);
+    } catch {
+      console.log(`\u2717 Cannot reach ${cfg.api_url}`);
+    }
+  });
+}
+export {
+  registerAuth
+};

package/dist/chunk-Q5AKRRZ2.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_DIR = join(homedir(), ".rentline-sandbox");
+var CONFIG_FILE = join(CONFIG_DIR, "credentials.json");
+var DEFAULT_API_URL = "https://sandbox-api.rentline.xyz";
+function loadConfig() {
+  try {
+    const raw = readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function requireConfig() {
+  const cfg = loadConfig();
+  if (!cfg) {
+    console.error(
+      "Not authenticated. Run:\n\n  sandbox auth login --key <your-api-key>\n"
+    );
+    process.exit(1);
+  }
+  return cfg;
+}
+function saveConfig(cfg) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2), { mode: 384 });
+  try {
+    chmodSync(CONFIG_FILE, 384);
+  } catch {
+  }
+}
+function deleteConfig() {
+  try {
+    unlinkSync(CONFIG_FILE);
+  } catch {
+  }
+}
+function getApiUrl(override) {
+  const cfg = loadConfig();
+  return override || process.env.SANDBOX_API_URL || cfg?.api_url || DEFAULT_API_URL;
+}
+function getApiKey(override) {
+  const cfg = loadConfig();
+  return override || process.env.SANDBOX_API_KEY || cfg?.api_key;
+}
+
+export {
+  DEFAULT_API_URL,
+  loadConfig,
+  requireConfig,
+  saveConfig,
+  deleteConfig,
+  getApiUrl,
+  getApiKey
+};

package/dist/chunk-X3OZHOPM.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+// src/client.ts
+async function request(opts, method, path, body) {
+  const url = `${opts.apiUrl.replace(/\/$/, "")}${path}`;
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (opts.apiKey) {
+    headers["X-API-Key"] = opts.apiKey;
+  }
+  const res = await fetch(url, {
+    method,
+    headers,
+    body: body !== void 0 ? JSON.stringify(body) : void 0
+  });
+  if (!res.ok) {
+    let detail = res.statusText;
+    try {
+      const j = await res.json();
+      detail = j.detail ?? JSON.stringify(j);
+    } catch {
+    }
+    throw new Error(`[${res.status}] ${detail}`);
+  }
+  if (res.status === 204) return void 0;
+  return res.json();
+}
+function createClient(opts) {
+  const r = (method, path, body) => request(opts, method, path, body);
+  return {
+    // ── Health ───────────────────────────────────────────────────────────────
+    health: () => r("GET", "/health"),
+    // ── Games ────────────────────────────────────────────────────────────────
+    listGames: () => r("GET", "/api/sandbox/games"),
+    getGame: (id) => r("GET", `/api/sandbox/games/${id}`),
+    createGame: (body) => r("POST", "/api/sandbox/games", body),
+    joinGame: (id, body) => r("POST", `/api/sandbox/games/${id}/join`, body),
+    leaveGame: (id) => r("DELETE", `/api/sandbox/games/${id}/leave`),
+    markReady: (id) => r("POST", `/api/sandbox/games/${id}/ready`),
+    advanceTurn: (id) => r("POST", `/api/sandbox/games/${id}/advance-turn`),
+    getFeed: (id, params) => {
+      const q = new URLSearchParams();
+      if (params?.turn !== void 0) q.set("turn", String(params.turn));
+      if (params?.limit !== void 0) q.set("limit", String(params.limit));
+      const qs = q.toString() ? `?${q.toString()}` : "";
+      return r("GET", `/api/sandbox/games/${id}/feed${qs}`);
+    },
+    getLeaderboard: (id) => r("GET", `/api/sandbox/games/${id}/leaderboard`),
+    getGlobalLeaderboard: (limit = 50) => r("GET", `/api/sandbox/leaderboard?limit=${limit}`),
+    // ── Portfolio / debt ─────────────────────────────────────────────────────
+    getPortfolio: (gameId, playerId) => r("GET", `/api/sandbox/games/${gameId}/portfolio/${playerId}`),
+    getDebt: (gameId, playerId) => r("GET", `/api/sandbox/games/${gameId}/debt/${playerId}`),
+    // ── Trading ──────────────────────────────────────────────────────────────
+    trade: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/trade`, body),
+    // ── Mortgage ─────────────────────────────────────────────────────────────
+    originateMortgage: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/mortgage`, body),
+    refi: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/refi`, body),
+    helocDraw: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/heloc/draw`, body),
+    helocRepay: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/heloc/repay`, body),
+    prepayPrincipal: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/prepay-principal`, body),
+    improveProperty: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/improve-property`, body),
+    originatePaceLien: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/pace-lien`, body),
+    // ── Fed ──────────────────────────────────────────────────────────────────
+    getFedHistory: (gameId) => r("GET", `/api/sandbox/games/${gameId}/fed`),
+    // ── Property pool (admin) ────────────────────────────────────────────────
+    listProperties: (activeOnly = true) => r("GET", `/api/sandbox/properties?active_only=${activeOnly}`),
+    syncProperties: () => r("POST", "/api/sandbox/properties/sync"),
+    mintTusdc: (gameId, playerId, amount) => r("POST", `/api/sandbox/games/${gameId}/mint-tusdc`, { player_id: playerId, amount }),
+    // ── Bots ─────────────────────────────────────────────────────────────────
+    addBot: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/bots`, body),
+    removeBot: (gameId, botPlayerId) => r("DELETE", `/api/sandbox/games/${gameId}/bots/${botPlayerId}`),
+    // ── Autonomous mode ───────────────────────────────────────────────────────
+    startAutonomous: (gameId, delaySeconds) => r("POST", `/api/sandbox/games/${gameId}/autonomous`, { delay_seconds: delaySeconds ?? 30 }),
+    stopAutonomous: (gameId) => r("DELETE", `/api/sandbox/games/${gameId}/autonomous`),
+    // ── Agent delegation ──────────────────────────────────────────────────────
+    setDelegate: (gameId, body) => r("POST", `/api/sandbox/games/${gameId}/delegate`, body),
+    // ── API keys ──────────────────────────────────────────────────────────────
+    createApiKey: (name = "CLI key") => r("POST", "/api/sandbox/api-keys", { name }),
+    // ── Market & Intel ────────────────────────────────────────────────────────
+    getMarketSummary: (gameId) => r("GET", `/api/sandbox/games/${gameId}/market-summary`),
+    getPlayerActions: (gameId, playerId, limit, turn) => r("GET", `/api/sandbox/games/${gameId}/players/${playerId}/actions${limit || turn ? `?${new URLSearchParams({ ...limit ? { limit: String(limit) } : {}, ...turn !== void 0 ? { turn: String(turn) } : {} })}` : ""}`),
+    spectate: (gameId) => r("GET", `/api/sandbox/games/${gameId}/spectate`),
+    createGameFromPreset: (body) => r("POST", "/api/sandbox/games/from-preset", body)
+  };
+}
+
+export {
+  createClient
+};

package/dist/game-KCQW5KOZ.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import {
+  getApiKey,
+  getApiUrl,
+  requireConfig
+} from "./chunk-Q5AKRRZ2.js";
+import {
+  createClient
+} from "./chunk-X3OZHOPM.js";
+
+// src/commands/game.ts
+function client(cmd) {
+  const opts = cmd.optsWithGlobals();
+  const cfg = requireConfig();
+  return createClient({ apiUrl: getApiUrl(opts.url), apiKey: getApiKey(opts.apiKey) ?? cfg.api_key });
+}
+function fmt(obj) {
+  console.log(JSON.stringify(obj, null, 2));
+}
+function registerGame(program) {
+  const game = program.command("game").description("Manage sandbox game rooms");
+  game.command("list").description("List open game rooms (lobby, trading, advancing)").action(async (_, cmd) => {
+    fmt(await client(cmd).listGames());
+  });
+  game.command("create").description("Create a new game room").requiredOption("--name <name>", "Game name").option("--display-name <n>", "Your display name in this game").option("--turns <n>", "Max turns (default 12)", "12").option("--balance <n>", "Starting tUSDC per player", "100000").option("--ltv <n>", "LTV limit 0.0-0.95 (default 0.70)", "0.70").option("--rate-type <t>", "Default mortgage rate type: fixed|arm", "fixed").option("--amortizing", "Enable amortizing mortgages (default: interest-only)").option("--fed-interval <n>", "Fed meeting every N turns (0=disabled)", "6").option("--properties <ids...>", "Specific property IDs to include (default: all active)").option("--auto-advance", "Start autonomous mode immediately after creation").option("--auto-advance-delay <n>", "Seconds between auto-advance turns (5-3600, default 30)", "30").action(async (opts, cmd) => {
+    const cfg = requireConfig();
+    const body = {
+      name: opts.name,
+      display_name: opts.displayName ?? cfg.display_name ?? "Host",
+      max_turns: parseInt(opts.turns),
+      starting_balance_usdc: parseFloat(opts.balance),
+      ltv_limit: parseFloat(opts.ltv),
+      default_rate_type: opts.rateType,
+      amortizing: !!opts.amortizing,
+      fed_meeting_interval: parseInt(opts.fedInterval),
+      property_ids: opts.properties,
+      auto_advance: !!opts.autoAdvance,
+      auto_advance_delay_seconds: parseInt(opts.autoAdvanceDelay)
+    };
+    const g = await client(cmd).createGame(body);
+    console.log(`
+Game created: ${g.id}`);
+    console.log(`Invite code:  ${g.invite_code}`);
+    console.log(`Share link:   sandbox.rentline.xyz/join/${g.invite_code}
+`);
+    fmt(g);
+  });
+  game.command("get <id>").description("Get full game state (players, properties, status)").action(async (id, _, cmd) => {
+    fmt(await client(cmd).getGame(id));
+  });
+  game.command("join <id>").description("Join a game via invite code").requiredOption("--invite <code>", "Invite code").option("--name <n>", "Your display name").action(async (id, opts, cmd) => {
+    const cfg = requireConfig();
+    const res = await client(cmd).joinGame(id, {
+      invite_code: opts.invite,
+      display_name: opts.name ?? cfg.display_name ?? "Player"
+    });
+    console.log(`Joined game ${res.game_id} as player ${res.player_id}`);
+  });
+  game.command("leave <id>").description("Leave a game (only before it starts)").action(async (id, _, cmd) => {
+    await client(cmd).leaveGame(id);
+    console.log(`Left game ${id}`);
+  });
+  game.command("ready <id>").description("Toggle your ready state for the next turn").action(async (id, _, cmd) => {
+    const res = await client(cmd).markReady(id);
+    console.log(`Ready: ${res.is_ready}`);
+  });
+  game.command("advance <id>").description("Advance the game by one turn (host only \u2014 runs all engine phases)").action(async (id, _, cmd) => {
+    const res = await client(cmd).advanceTurn(id);
+    console.log(`Turn ${res.current_turn}/${res.max_turns} \u2014 status: ${res.status}`);
+  });
+  game.command("feed <id>").description("Show the turn event feed (macro events, rent, price moves, debt service)").option("--turn <n>", "Filter by turn number").option("--limit <n>", "Max events to show", "30").action(async (id, opts, cmd) => {
+    const events = await client(cmd).getFeed(id, {
+      turn: opts.turn !== void 0 ? parseInt(opts.turn) : void 0,
+      limit: parseInt(opts.limit)
+    });
+    if (!events.length) {
+      console.log("No events yet.");
+      return;
+    }
+    for (const e of events) {
+      const sign = e.delta_usdc > 0 ? "+" : "";
+      const money = e.delta_usdc !== 0 ? ` [${sign}$${Math.abs(e.delta_usdc).toFixed(2)}]` : "";
+      console.log(`T${e.turn} ${e.event_type.padEnd(18)} ${e.description}${money}`);
+    }
+  });
+  game.command("leaderboard [id]").description("Show leaderboard for a game (or global all-time if no game ID given)").option("--limit <n>", "Number of entries (global only)", "50").action(async (id, opts, cmd) => {
+    const rows = id ? await client(cmd).getLeaderboard(id) : await client(cmd).getGlobalLeaderboard(parseInt(opts.limit));
+    console.log(`
+${"#".padEnd(4)}${"Player".padEnd(22)}${"NAV".padStart(14)}${"Cash".padStart(14)}`);
+    console.log("\u2500".repeat(54));
+    for (const r of rows) {
+      console.log(
+        `${String(r.rank).padEnd(4)}${r.display_name.padEnd(22)}$${r.nav.toLocaleString("en-US", { maximumFractionDigits: 2 }).padStart(13)}$${r.usdc_balance.toLocaleString("en-US", { maximumFractionDigits: 2 }).padStart(13)}`
+      );
+    }
+  });
+  game.command("fed <id>").description("Show FOMC decision history for a game").action(async (id, _, cmd) => {
+    const history = await client(cmd).getFedHistory(id);
+    if (!history.length) {
+      console.log("No Fed decisions yet.");
+      return;
+    }
+    for (const d of history) {
+      const arrow = d.outcome === "hike" ? "\u2191" : d.outcome === "cut" ? "\u2193" : "\u2192";
+      console.log(
+        `T${d.turn} ${arrow} ${d.outcome.toUpperCase().padEnd(5)} ${d.move_bps > 0 ? "+" : ""}${d.move_bps}bps  Fed: ${(d.rate_after * 100).toFixed(2)}%  Mortgage: ${(d.mortgage_rate_after * 100).toFixed(2)}%`
+      );
+      console.log(`   ${d.statement}`);
+    }
+  });
+  game.command("autonomous <id>").description("Enable autonomous mode \u2014 game advances turns automatically (host only)").option("--delay <n>", "Seconds between turns (5\u20133600, default 30)", "30").action(async (id, opts, cmd) => {
+    const res = await client(cmd).startAutonomous(id, parseInt(opts.delay));
+    console.log(`Autonomous mode enabled for game ${id}`);
+    console.log(`Delay: ${res.auto_advance_delay_seconds}s between turns`);
+    console.log(res.message);
+  });
+  game.command("stop-autonomous <id>").description("Disable autonomous mode \u2014 game waits for manual advance-turn (host only)").action(async (id, _, cmd) => {
+    const res = await client(cmd).stopAutonomous(id);
+    console.log(`Autonomous mode disabled for game ${id}`);
+    console.log(res.message);
+  });
+  game.command("delegate <id>").description("Opt in to agent delegation \u2014 an LLM acts for you if you don't move in time").option("--strategy <s>", "Bot strategy to use: aggressive|conservative|balanced|momentum|income", "balanced").option("--off", "Opt out of delegation").action(async (id, opts, cmd) => {
+    const res = await client(cmd).setDelegate(id, {
+      agent_delegate: !opts.off,
+      delegate_strategy: opts.strategy
+    });
+    console.log(res.message);
+    console.log(`Strategy: ${res.delegate_strategy}`);
+  });
+}
+export {
+  registerGame
+};

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { createRequire } from "module";
+dotenv.config();
+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 opts = parseSetupArgs(args.filter((a) => a !== "setup" && a !== "--setup"));
+  await runSetup(opts);
+  process.exit(0);
+}
+if (args.length === 0 || args[0] === "server" || args[0] === "--server") {
+  const { startServer } = await import("./server-NRWOBJJN.js");
+  await startServer();
+} else {
+  const program = new Command();
+  program.name("sandbox").description("Rentline Sandbox \u2014 CLI and MCP server for the real estate simulation game").version(version).option("--url <url>", "Sandbox API base URL (overrides saved config)").option("--api-key <key>", "API key (overrides saved config)");
+  const { registerAuth } = await import("./auth-M7RU2YB3.js");
+  const { registerGame } = await import("./game-KCQW5KOZ.js");
+  const { registerTrade } = await import("./trade-5BAZ6QFQ.js");
+  const { registerMortgage } = await import("./mortgage-7UCDSSUV.js");
+  const { registerAdmin } = await import("./admin-YB2G7ZYZ.js");
+  registerAuth(program);
+  registerGame(program);
+  registerTrade(program);
+  registerMortgage(program);
+  registerAdmin(program);
+  program.command("mcp-setup", { hidden: true }).allowUnknownOption().action(async () => {
+    const { runSetup, parseSetupArgs } = await import("./setup-JPLRGUPW.js");
+    const opts = parseSetupArgs(process.argv.slice(3));
+    await runSetup(opts);
+  });
+  await program.parseAsync(process.argv);
+}

package/dist/mortgage-7UCDSSUV.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import {
+  getApiKey,
+  getApiUrl,
+  requireConfig
+} from "./chunk-Q5AKRRZ2.js";
+import {
+  createClient
+} from "./chunk-X3OZHOPM.js";
+
+// src/commands/mortgage.ts
+function client(cmd) {
+  const opts = cmd.optsWithGlobals();
+  const cfg = requireConfig();
+  return createClient({ apiUrl: getApiUrl(opts.url), apiKey: getApiKey(opts.apiKey) ?? cfg.api_key });
+}
+function printMortgage(m) {
+  console.log(`
+Mortgage: ${m.id}`);
+  console.log(`  Type:        ${m.mortgage_type}`);
+  console.log(`  Status:      ${m.status}`);
+  console.log(`  Balance:     $${m.current_balance.toLocaleString("en-US", { maximumFractionDigits: 2 })}`);
+  console.log(`  Rate:        ${(m.current_rate * 100).toFixed(3)}% ${m.rate_type.toUpperCase()} ${m.amortizing ? "(amortizing)" : "(interest-only)"}`);
+  console.log(`  Monthly pmt: $${m.monthly_payment.toFixed(2)}`);
+  if (m.credit_limit !== null) {
+    console.log(`  HELOC limit: $${m.credit_limit.toFixed(2)}  drawn: $${(m.drawn_balance ?? 0).toFixed(2)}`);
+  }
+  if (m.turns_in_arrears > 0) {
+    console.log(`  \u26A0 IN ARREARS: ${m.turns_in_arrears} turn(s)`);
+  }
+  console.log(`  Interest paid: $${m.total_interest_paid.toFixed(2)}  Principal paid: $${m.total_principal_paid.toFixed(2)}`);
+}
+function registerMortgage(program) {
+  const mtg = program.command("mortgage").alias("mtg").description("Leveraged buying, refinancing, and HELOC operations");
+  mtg.command("buy <game-id>").description("Buy tokens using an acquisition mortgage (down payment + financing)").requiredOption("--property <id>", "Property ID from the game pool").requiredOption("--tokens <n>", "Tokens to purchase (LTV limit applies to purchase price)").option("--rate-type <t>", "fixed or arm", "fixed").action(async (gameId, opts, cmd) => {
+    const res = await client(cmd).originateMortgage(gameId, {
+      property_id: opts.property,
+      tokens_to_buy: parseFloat(opts.tokens),
+      rate_type: opts.rateType
+    });
+    console.log(`Acquisition mortgage originated`);
+    printMortgage(res);
+  });
+  mtg.command("refi <game-id>").description("Refinance existing first lien (rate-and-term or cash-out)").requiredOption("--property <id>", "Property ID").option("--cash-out <n>", "Cash-out amount in USD (0 = rate-and-term refi)", "0").option("--rate-type <t>", "New rate type: fixed or arm").action(async (gameId, opts, cmd) => {
+    const res = await client(cmd).refi(gameId, {
+      property_id: opts.property,
+      cash_out_amount: parseFloat(opts.cashOut),
+      new_rate_type: opts.rateType
+    });
+    const type = parseFloat(opts.cashOut) > 0 ? "Cash-out refi" : "Rate-and-term refi";
+    console.log(`${type} completed`);
+    printMortgage(res);
+  });
+  mtg.command("heloc <game-id>").description("Draw from a HELOC (opens one if none exists)").requiredOption("--property <id>", "Property ID").requiredOption("--draw <n>", "Amount to draw in USD").action(async (gameId, opts, cmd) => {
+    const res = await client(cmd).helocDraw(gameId, {
+      property_id: opts.property,
+      draw_amount: parseFloat(opts.draw)
+    });
+    console.log(`HELOC draw of $${parseFloat(opts.draw).toFixed(2)} complete`);
+    printMortgage(res);
+  });
+  mtg.command("repay <game-id>").description("Repay drawn HELOC balance (reduces interest cost)").requiredOption("--property <id>", "Property ID").requiredOption("--amount <n>", "Amount to repay in USD").action(async (gameId, opts, cmd) => {
+    const res = await client(cmd).helocRepay(gameId, {
+      property_id: opts.property,
+      repay_amount: parseFloat(opts.amount)
+    });
+    console.log(`HELOC repayment of $${parseFloat(opts.amount).toFixed(2)} applied`);
+    printMortgage(res);
+  });
+  mtg.command("list <game-id> <player-id>").description("List all mortgages (active and historical) for a player").action(async (gameId, playerId, cmd) => {
+    const mortgages = await client(cmd).getDebt(gameId, playerId);
+    if (!mortgages.length) {
+      console.log("No mortgages on record.");
+      return;
+    }
+    const active = mortgages.filter((m) => m.status === "active");
+    const inactive = mortgages.filter((m) => m.status !== "active");
+    console.log(`
+Active (${active.length}):`);
+    for (const m of active) printMortgage(m);
+    if (inactive.length) {
+      console.log(`
+Inactive (${inactive.length}):`);
+      for (const m of inactive) {
+        console.log(`  ${m.id.slice(0, 8)} ${m.mortgage_type} ${m.status} balance=$${m.current_balance.toFixed(2)}`);
+      }
+    }
+  });
+}
+export {
+  registerMortgage
+};