@computesdk/cli 2.1.1 → 2.3.0

package/dist/index.js

@@ -835,15 +835,15 @@ function maxPriceFields(maxBid, maxBidPer) {
     throw new ActionsCliError("invalid_argument", "--max-bid-per requires --max-bid.");
   }
   if (maxBid === void 0) return void 0;
-  const usd = Number(maxBid);
-  if (!/^\d+(\.\d+)?([eE][+-]?\d+)?$/.test(maxBid) || !Number.isFinite(usd) || usd <= 0) {
+  const usd2 = Number(maxBid);
+  if (!/^\d+(\.\d+)?([eE][+-]?\d+)?$/.test(maxBid) || !Number.isFinite(usd2) || usd2 <= 0) {
     throw new ActionsCliError("invalid_argument", `Invalid --max-bid "${maxBid}". Expected a positive dollar amount (e.g. 0.12).`);
   }
   const per = maxBidPer ?? "second";
   if (per !== "second" && per !== "minute" && per !== "hour") {
     throw new ActionsCliError("invalid_argument", `--max-bid-per must be second, minute, or hour, got "${maxBidPer}".`);
   }
-  return { maxPriceUsd: usd, maxPricePer: per };
+  return { maxPriceUsd: usd2, maxPricePer: per };
 }
 function parseVaultKind(kind) {
   if (kind === void 0 || kind === "secret" || kind === "variable") return kind ?? "secret";
@@ -1373,25 +1373,55 @@ function registerActionsCommands(program2) {
 import pc2 from "picocolors";
 var USD_RE = /^\d+(\.\d+)?([eE][+-]?\d+)?$/;
 var RATE_UNITS = ["second", "minute", "hour"];
+var MARKET_LANES = ["actions", "sandbox"];
+function parseMarketLane(value) {
+  if (value === void 0) return "actions";
+  if (!MARKET_LANES.includes(value)) {
+    throw new ActionsCliError(
+      "invalid_argument",
+      `--use-case must be ${MARKET_LANES.join(" or ")}, got "${value}".`
+    );
+  }
+  return value;
+}
 function parseRate(price, per) {
   if (price === void 0) {
-    throw new ActionsCliError("invalid_argument", "A price is required \u2014 pass --price <usd>.");
+    throw new ActionsCliError("invalid_argument", "A price is required \u2014 pass --price <usd>/<unit>.");
+  }
+  let usdText = price;
+  let unit = per;
+  const slash = price.indexOf("/");
+  if (slash !== -1) {
+    usdText = price.slice(0, slash);
+    const inline = price.slice(slash + 1);
+    if (per !== void 0 && per !== inline) {
+      throw new ActionsCliError(
+        "invalid_argument",
+        `--price "${price}" conflicts with --per "${per}".`
+      );
+    }
+    unit = inline;
+  }
+  const usd2 = Number(usdText);
+  if (!USD_RE.test(usdText) || !Number.isFinite(usd2) || usd2 <= 0) {
+    throw new ActionsCliError(
+      "invalid_argument",
+      `Invalid --price "${price}". Expected a positive dollar amount (e.g. 0.12/hour).`
+    );
   }
-  const usd = Number(price);
-  if (!USD_RE.test(price) || !Number.isFinite(usd) || usd <= 0) {
+  if (unit === void 0) {
     throw new ActionsCliError(
       "invalid_argument",
-      `Invalid --price "${price}". Expected a positive dollar amount (e.g. 0.12).`
+      "--price needs a unit \u2014 write it as <usd>/<unit> (e.g. --price 0.12/hour) or pass --per hour."
     );
   }
-  const unit = per ?? "second";
   if (!RATE_UNITS.includes(unit)) {
     throw new ActionsCliError(
       "invalid_argument",
-      `--per must be second, minute, or hour, got "${per}".`
+      `The unit must be second, minute, or hour, got "${unit}".`
     );
   }
-  return { usd, per: unit };
+  return { usd: usd2, per: unit };
 }
 function parseCapacity(value) {
   if (value === void 0) return void 0;
@@ -1427,6 +1457,7 @@ function sellBody(opts) {
   }
   return {
     size: opts.size,
+    useCase: parseMarketLane(opts.useCase),
     ...opts.region !== void 0 && { region: opts.region },
     usd: rate.usd,
     per: rate.per,
@@ -1493,11 +1524,11 @@ function credentialBody(fields, values) {
   }
   return { fields: values };
 }
-function formatUsd(usd) {
-  return `$${usd.toFixed(6).replace(/\.?0+$/, "")}`;
+function formatUsd(usd2) {
+  return `$${usd2.toFixed(6).replace(/\.?0+$/, "")}`;
 }
-function formatRate(usd, per) {
-  return `${formatUsd(usd)}/${per}`;
+function formatRate(usd2, per) {
+  return `${formatUsd(usd2)}/${per}`;
 }
 function formatListingStatus(ask) {
   let label;
@@ -1515,6 +1546,7 @@ function formatListingRow(ask) {
   return [
     ask.id,
     formatListingStatus(ask),
+    pc2.dim(ask.useCase === "sandbox" ? "sandbox" : "actions"),
     safeTerm(ask.size),
     safeTerm(ask.region ?? "-"),
     formatRate(ask.usd, ask.per),
@@ -1530,6 +1562,9 @@ function formatProviderStatus(p2) {
     `credential:  ${p2.executorCredentialConnected ? pc2.green("connected") : pc2.yellow("not connected \u2014 your listings cannot fill until `compute market credential connect`")}`
   );
   if (p2.revokedAt) lines.push(pc2.red(`revoked:     ${p2.revokedAt}`));
+  lines.push(
+    `lanes:       ${(p2.useCases ?? ["actions"]).join(", ")}`
+  );
   lines.push(
     `sizes:       ${p2.sizes.map((s) => `${s.name} (${s.label})`).join(", ") || "-"}`
   );
@@ -1544,13 +1579,14 @@ function formatProviderStatus(p2) {
 }
 function formatBook(book) {
   const lines = [];
+  const lane = (useCase) => pc2.dim(useCase === "sandbox" ? "sandbox" : "actions");
   lines.push(pc2.bold("sellers' asking prices"));
   if (book.asks.length === 0) lines.push(pc2.dim("  no listings are live"));
   for (const ask of book.asks) {
     const where = ask.region ? safeTerm(ask.region) : "any region";
     const expiry = ask.expiresAt ? pc2.dim(ask.rollover ? `  renews ${ask.expiresAt}` : `  until ${ask.expiresAt}`) : "";
     lines.push(
-      `  ${formatRate(ask.usd, ask.per)}  ${safeTerm(ask.providerName)}  ${safeTerm(ask.size)}  ${where}  up to ${ask.maxConcurrent} at once${expiry}`
+      `  ${lane(ask.useCase)}  ${formatRate(ask.usd, ask.per)}  ${safeTerm(ask.providerName)}  ${safeTerm(ask.size)}  ${where}  up to ${ask.maxConcurrent} at once${expiry}`
     );
   }
   lines.push("");
@@ -1559,7 +1595,7 @@ function formatBook(book) {
   for (const bid of book.bids) {
     const where = bid.region ? safeTerm(bid.region) : "anywhere";
     lines.push(
-      `  pays up to ${formatRate(bid.maxUsd, bid.per)}  ${safeTerm(bid.size)}  ${where}  ${pc2.dim(`posted ${bid.createdAt}`)}`
+      `  ${lane(bid.useCase)}  pays up to ${formatRate(bid.maxUsd, bid.per)}  ${safeTerm(bid.size)}  ${where}  ${pc2.dim(`posted ${bid.createdAt}`)}`
     );
   }
   lines.push("");
@@ -1568,7 +1604,7 @@ function formatBook(book) {
   for (const fill of book.fills) {
     const statusNote = fill.status === "replaced" ? pc2.yellow("  replaced") : fill.status === "closed" ? pc2.gray("  closed") : "";
     lines.push(
-      `  ${pc2.dim(fill.id)}  ${formatRate(fill.usd, fill.per)}  ${safeTerm(fill.provider)}  ${safeTerm(fill.size)}  ${safeTerm(fill.region ?? "-")}  ${pc2.dim(fill.createdAt)}${statusNote}`
+      `  ${pc2.dim(fill.id)}  ${lane(fill.useCase)}  ${formatRate(fill.usd, fill.per)}  ${safeTerm(fill.provider)}  ${safeTerm(fill.size)}  ${safeTerm(fill.region ?? "-")}  ${pc2.dim(fill.createdAt)}${statusNote}`
     );
   }
   return lines.join("\n");
@@ -1629,10 +1665,11 @@ function registerMarketCommands(program2) {
     }
   });
   common(
-    market.command("sell").description("Post a listing: sell capacity at a price").requiredOption("--price <usd>", "price per unit of time (e.g. 0.12)").option("--per <unit>", "time unit the price is per: second, minute, or hour (default: second)").option("--size <tier>", "size tier to sell (default: medium, else the provider's first tier)").option("--region <region>", "region to sell in (default: anywhere the provider runs)").option("--capacity <n>", "max simultaneous fills (default: 1)").option("--expires-in <hours>", "delist after this many hours (default: standing)").option("--renew", "re-list for the same window each time it expires (requires --expires-in)")
+    market.command("sell").description("Post a listing: sell capacity at a price").requiredOption("--price <usd/unit>", "price per unit of time (e.g. 0.12/hour)").option("--per <unit>", "unit for a bare --price usd (second, minute, or hour)").option("--size <tier>", "size tier to sell (default: medium, else the provider's first tier)").option("--use-case <lane>", "lane to sell into: actions or sandbox (default: actions)").option("--region <region>", "region to sell in (default: anywhere the provider runs)").option("--capacity <n>", "max simultaneous fills (default: 1)").option("--expires-in <hours>", "delist after this many hours (default: standing)").option("--renew", "re-list for the same window each time it expires (requires --expires-in)")
   ).action(async (opts) => {
     try {
       const c = await client(opts);
+      const useCase = parseMarketLane(opts.useCase);
       let size = opts.size;
       if (size === void 0) {
         const { provider } = await c.get(
@@ -1650,7 +1687,7 @@ function registerMarketCommands(program2) {
       }
       const result = await c.post(
         "/api/v1/market/asks",
-        sellBody({ ...opts, size })
+        sellBody({ ...opts, size, useCase })
       );
       output(opts, result, (r) => {
         console.log(`listed  ${pc2.cyan(r.ask.id)}`);
@@ -1661,7 +1698,7 @@ function registerMarketCommands(program2) {
     }
   });
   common(
-    market.command("price").description("Reprice a listing").argument("<listing-id>", "listing ID").requiredOption("--price <usd>", "new price per unit of time (e.g. 0.08)").option("--per <unit>", "time unit the price is per: second, minute, or hour (default: second)")
+    market.command("price").description("Reprice a listing").argument("<listing-id>", "listing ID").requiredOption("--price <usd/unit>", "new price per unit of time (e.g. 0.08/hour)").option("--per <unit>", "unit for a bare --price usd (second, minute, or hour)")
   ).action(async (listingId, opts) => {
     try {
       const result = await (await client(opts)).post(
@@ -1742,11 +1779,12 @@ function registerMarketCommands(program2) {
     }
   );
   common(
-    market.command("book").description("Live prices: sellers' asking prices, buyer offers, recent sales")
+    market.command("book").description("Live prices: sellers' asking prices, buyer offers, recent sales").option("--use-case <lane>", "only this lane: actions or sandbox (default: both)")
   ).action(async (opts) => {
     try {
+      const lane = opts.useCase === void 0 ? void 0 : parseMarketLane(opts.useCase);
       const book = await (await client(opts)).get(
-        "/api/v1/market/book"
+        `/api/v1/market/book${lane ? `?useCase=${lane}` : ""}`
       );
       output(opts, book, (b) => console.log(formatBook(b)));
     } catch (e) {
@@ -1843,6 +1881,33 @@ ${hints}`
 
 // src/sandboxes.ts
 import pc3 from "picocolors";
+function parseMaxPrice(value, per) {
+  if (value === void 0) {
+    if (per !== void 0) throw new Error("--max-price-per requires --max-price.");
+    return void 0;
+  }
+  let usdText = value;
+  let unit = per;
+  const slash = value.indexOf("/");
+  if (slash !== -1) {
+    usdText = value.slice(0, slash);
+    const inline = value.slice(slash + 1);
+    if (per !== void 0 && per !== inline) {
+      throw new Error(`--max-price "${value}" conflicts with --max-price-per "${per}".`);
+    }
+    unit = inline;
+  }
+  const usd2 = Number(usdText);
+  if (!/^\d+(\.\d+)?([eE][+-]?\d+)?$/.test(usdText) || !Number.isFinite(usd2) || usd2 <= 0) {
+    throw new Error(`Invalid --max-price "${value}". Expected a positive dollar amount like 0.12/hour.`);
+  }
+  if (unit !== "second" && unit !== "minute" && unit !== "hour") {
+    throw new Error(
+      "--max-price needs a unit \u2014 write it as <usd>/<unit> (e.g. --max-price 0.12/hour) or pass --max-price-per hour."
+    );
+  }
+  return { usd: usd2, per: unit };
+}
 function shellQuote(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
@@ -1854,12 +1919,40 @@ function printSandbox(s) {
     console.log(`  image: ${s.image ?? "\u2014"}${s.requestedImage !== null && s.requestedImage !== s.image ? `  ${pc3.dim(`(requested: ${s.requestedImage})`)}` : ""}`);
   }
   if (s.destroyError) console.log(`  destroyError: ${pc3.red(s.destroyError)}`);
+  if (s.placement) {
+    const p2 = s.placement;
+    const box = p2.box ? ` / ${p2.box.sizeName ?? "custom"}${p2.box.resources ? ` (${p2.box.resources.cpus ?? "?"} vCPU / ${p2.box.resources.memoryMb ?? "?"} MB)` : ""}` : "";
+    console.log(
+      `  provider: ${p2.box?.provider ?? s.provider ?? "\u2014"}${box}   size: ${p2.size ?? "\u2014"}   order: ${p2.orderType ?? "\u2014"}   rate: $${p2.rate.usd}/${p2.rate.per}`
+    );
+  }
   if (attach !== void 0) {
     console.log(
       attach === null ? "  attach: none (market fill or ambient provider \u2014 platform drive only)" : `  attach: ${attach.provider} / ${attach.providerSandboxId}${attach.region ? ` (${attach.region})` : ""}`
     );
   }
 }
+var usd = (n, suffix = "") => n === void 0 ? "\u2014" : `$${n.toFixed(4).replace(/0+$/, "").replace(/\.$/, ".00")}${suffix}`;
+function printQuote(q, timeoutMs) {
+  console.log(`quote: ${q.ok ? pc3.green("ok") : pc3.red(q.reason ?? "unfillable")}`);
+  const box = q.placement?.box;
+  console.log(
+    `  size: ${q.placement?.size ?? "\u2014"}   provider: ${q.placement?.provider ?? "\u2014"}` + (box ? `   box: ${box.sizeName ?? "custom"} (${box.provider}${box.resources ? `, ${box.resources.cpus ?? "?"} vCPU / ${box.resources.memoryMb ?? "?"} MB` : ""})` : "")
+  );
+  console.log(`  order type: ${q.orderType}   order: ${q.providerOrder.join(", ")}`);
+  if (q.rateUsd) {
+    console.log(`  rate: ${usd(q.rateUsd.perHour, "/hour")}   cheapest live: ${usd(q.cheapestLiveUsdPerHour, "/hr")}   reference: ${usd(q.referenceUsdPerHour, "/hr")}`);
+  } else if (q.rate) {
+    console.log(`  rate: $${q.rate.usd}/${q.rate.per}`);
+  }
+  const timeout = timeoutMs !== void 0 ? ` for ${timeoutMs}ms` : "";
+  console.log(`  est. cost${timeout}: ${usd(q.estimatedCostUsd)}   required hold: ${usd(q.requiredHoldUsd)}`);
+  console.log(
+    `  cap: ${q.maxPrice ? `$${q.maxPrice.usd}/${q.maxPrice.per}` : usd(q.marketCapUsdPerHour, "/hr")}   protection limit: ${usd(q.protectionLimitUsdPerHour, "/hr")}   balance: ${usd(q.creditBalanceUsd)}`
+  );
+  if (!q.ok && q.topUpPath) console.log(`  ${pc3.dim(`\u2192 ${q.topUpPath}`)}`);
+  if (q.liveAskDepth !== void 0) console.log(`  ${pc3.dim(`live asks: ${q.liveAskDepth}`)}`);
+}
 function printProcess(p2) {
   const exit = p2.status === "exited" ? `exit=${p2.exitCode ?? "?"}${p2.signal ? ` (${p2.signal})` : ""}` : "";
   const stdin = p2.stdin && p2.status === "running" ? "  [stdin open]" : "";
@@ -1948,7 +2041,7 @@ function mergeLeadOpts(opts, inline) {
 }
 function registerSandboxesCommands(program2) {
   const cmd = program2.command("sandboxes").alias("sbx").description("Create and drive sandboxes through the platform").enablePositionalOptions().configureOutput({ outputError: usageErrorOutput });
-  cmd.command("create").description('Place a sandbox (provider order walks 1,2,3; "market" bids first)').option("--order <providers>", 'provider order, comma-separated (e.g. "market,blaxel,vercel")').option("--label <label>", "label for the sandbox").option("--image <image>", "container image to boot").option("--snapshot-id <id>", "provider snapshot to resume").option("--cpus <n>", "CPU cores").option("--memory-mb <n>", "memory in MB").option("--disk-mb <n>", "ephemeral disk in MB").option("--timeout-ms <ms>", "sandbox timeout in ms").option("--secret <name>", "vault secret name to inject (repeatable)", (v, a) => a.concat(v), []).option("--api-key <key>", "platform API key (or COMPUTE_API_KEY)").option("--base-url <url>", "platform base URL").option("--allow-untrusted-host", "allow non-computesdk.com base URLs").option("--json", "print the raw response").action(async (opts) => {
+  cmd.command("create").description('Place a sandbox (provider order walks 1,2,3; "market" bids first)').option("--order <providers>", 'provider order, comma-separated (e.g. "market,blaxel,vercel")').option("--size <size>", "platform size: small (1 vCPU/2 GB), medium, large, xlarge (8/16 GB); default medium").option("--label <label>", "label for the sandbox").option("--image <image>", "container image to boot").option("--snapshot-id <id>", "provider snapshot to resume").option("--cpus <n>", "CPU cores (raw resources \u2014 mutually exclusive with --size)").option("--memory-mb <n>", "memory in MB (raw resources)").option("--disk-mb <n>", "ephemeral disk in MB (raw resources)").option("--max-price <usd/unit>", "max price for a market fill (e.g. 0.12/hour); makes the create a limit order").option("--max-price-per <unit>", "unit for a bare --max-price usd (second, minute, or hour)").option("--market", 'place the create on the compute market (order type "market")').option("--order-type <type>", "explicit market order type: market or limit").option("--timeout-ms <ms>", "sandbox timeout in ms").option("--secret <name>", "vault secret name to inject (repeatable)", (v, a) => a.concat(v), []).option("--api-key <key>", "platform API key (or COMPUTE_API_KEY)").option("--base-url <url>", "platform base URL").option("--allow-untrusted-host", "allow non-computesdk.com base URLs").option("--json", "print the raw response").action(async (opts) => {
     try {
       const c = await client(opts);
       const resources = {};
@@ -1957,18 +2050,55 @@ function registerSandboxesCommands(program2) {
       if (opts.diskMb) resources.ephemeralDiskMb = Number(opts.diskMb);
       const body = {};
       if (opts.order) body.providerOrder = opts.order.split(",").map((s) => s.trim());
+      if (opts.size) body.size = opts.size;
       if (opts.label) body.label = opts.label;
       if (opts.image) body.image = opts.image;
       if (opts.snapshotId) body.snapshotId = opts.snapshotId;
       if (opts.timeoutMs) body.timeoutMs = Number(opts.timeoutMs);
       if (opts.secret && opts.secret.length > 0) body.secrets = opts.secret;
       if (Object.keys(resources).length > 0) body.resources = resources;
+      const maxPrice = parseMaxPrice(opts.maxPrice, opts.maxPricePer);
+      if (maxPrice) body.maxPrice = { usd: maxPrice.usd, per: maxPrice.per };
+      if (opts.orderType && opts.market) {
+        throw new Error("--market and --order-type are mutually exclusive.");
+      }
+      if (opts.orderType) body.orderType = opts.orderType;
+      if (opts.market) body.orderType = "market";
       const res = await c.post("/api/v1/sandboxes", body);
       output(opts, res.sandbox, printSandbox);
     } catch (e) {
       fail(e, opts);
     }
   });
+  cmd.command("quote").description("Quote a sandbox create: placement, rate, caps and credits \u2014 creates nothing").option("--size <size>", "platform size (or raw resource flags; default medium)").option("--cpus <n>", "CPU cores").option("--memory-mb <n>", "memory in MB").option("--disk-mb <n>", "ephemeral disk in MB").option("--region <region>", "pin the placement region").option("--timeout-ms <ms>", "sandbox timeout in ms").option("--order-type <type>", "market order type: market or limit").option("--market", "quote a market order (fills at the live price, protection-bounded)").option("--max-price <usd/unit>", "max price for a market fill (e.g. 0.12/hour)").option("--max-price-per <unit>", "unit for a bare --max-price usd (second, minute, or hour)").option("--api-key <key>").option("--base-url <url>").option("--allow-untrusted-host").option("--json", "print the raw response").action(async (opts) => {
+    try {
+      const c = await client(opts);
+      const params = {
+        size: opts.size,
+        cpus: opts.cpus,
+        memoryMb: opts.memoryMb,
+        ephemeralDiskMb: opts.diskMb,
+        region: opts.region,
+        timeoutMs: opts.timeoutMs,
+        orderType: opts.market ? "market" : opts.orderType
+      };
+      if (opts.orderType && opts.market) {
+        throw new Error("--market and --order-type are mutually exclusive.");
+      }
+      const maxPrice = parseMaxPrice(opts.maxPrice, opts.maxPricePer);
+      if (maxPrice) {
+        params.maxPriceUsd = String(maxPrice.usd);
+        params.maxPricePer = maxPrice.per;
+      }
+      const res = await c.get(
+        "/api/v1/sandboxes/quote",
+        params
+      );
+      output(opts, res.quote, (quote) => printQuote(quote, opts.timeoutMs));
+    } catch (e) {
+      fail(e, opts);
+    }
+  });
   cmd.command("list").description("List sandboxes").option("--status <status>", "creating | running | destroyed").option("--limit <n>", "page size").option("--cursor <cursor>", "page cursor from a previous response").option("--api-key <key>").option("--base-url <url>").option("--allow-untrusted-host").option("--json", "print the raw response").action(async (opts) => {
     try {
       const c = await client(opts);