deepspace 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # deepspace
 
+## 0.6.2
+
+### Patch Changes
+
+- RecordRoom now gates its HTTP debug API (`/api/debug/*`) behind `ALLOW_DEBUG_ROUTES` at the Durable Object's own ingress, matching the app-worker proxy gate. Enforcement lives at the one place every caller funnels through, so it can no longer be bypassed by a caller that forgets to gate. The platform's shared-data rooms hard-disable the debug API entirely. No change for apps that already gate via the proxy.
+- Refresh the AI chat model lineup to the current generation. ChatPanel's default picker and the scaffolded starter's `ALLOWED_MODELS` now offer Claude Sonnet 5 (new default), Claude Opus 4.8, Claude Haiku 4.5, and the GPT-5.6 family (Sol / Terra / Luna) alongside GPT-OSS 120B; the retired-generation entries (Sonnet 4.6, Opus 4.7, the GPT-5.4 picker rows) are dropped from the picker, while their ids stay server-allowlisted. The scaffolded chat route now sends `reasoningEffort: 'none'` for OpenAI models — GPT-5.6 on /v1/chat/completions rejects function tools otherwise ("Function tools with reasoning_effort are not supported"). Apps scaffolded before this release that upgrade `deepspace` must add the new model ids to their `ALLOWED_MODELS` in `src/ai/chat-routes.ts` AND add the same `providerOptions: { openai: { reasoningEffort: 'none' } }` to their `streamText` call for OpenAI models (or pass their own `models` prop to `ChatPanel`) — otherwise the picker's new ids are rejected with a 400 by design, and GPT-5.6 turns with tools error.
+- Add `BaseRoom.disconnectAllSockets({ code?, reason? })` and a built-in internal
+  `POST /internal/disconnect-sockets` endpoint (every room type, `RecordRoom`
+  included). Use it after an out-of-band, server-side write (admin import,
+  migration script, cron, server action) to close every live WebSocket (default
+  close 1012 / `state-refresh`) so clients reconnect and fully resync — no more
+  stale editors autosaving over server-side writes. Internal-only: reachable via
+  DO stub fetch from the app worker, same trust model as `/api/tools/execute`.
+  The client already reconnects and re-subscribes on any close, so `useQuery`
+  consumers get fresh data automatically.
+- Add `deepspace usage` — credit balance, quota headroom (per-bucket breakdown with renewal/expiry dates), and per-integration spend for the last 30 days, from the platform's billing ledger. `--json` emits the raw summary for scripts and agents. Previously the only balance surface was the web dashboard, which agents driving `deepspace invoke` can't read.
+
 ## 0.6.1
 
 ### Patch Changes

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli/cli.ts
-import { defineCommand as defineCommand22, runMain } from "citty";
+import { defineCommand as defineCommand23, runMain } from "citty";
 import { spawnSync as spawnSync6 } from "child_process";
 import { readFileSync as readFileSync17, existsSync as existsSync15 } from "fs";
 import { dirname as dirname5, join as join16 } from "path";
@@ -3822,8 +3822,88 @@ var apps_default = defineCommand11({
   }
 });
 
-// src/cli/commands/add.ts
+// src/cli/commands/usage.ts
 import { defineCommand as defineCommand12 } from "citty";
+var API_URL3 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+function formatCredits(value) {
+  if (value > 0 && value < 1) return "<1";
+  if (value < 10) return value.toFixed(1).replace(/\.0$/, "");
+  return Math.round(value).toLocaleString("en-US");
+}
+function formatUsd(value) {
+  return `$${Math.abs(value) >= 0.01 || value === 0 ? value.toFixed(2) : value.toFixed(4)}`;
+}
+function formatDate(iso) {
+  return new Date(iso).toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+}
+function renderSummary(summary) {
+  const { credits, usageByIntegration } = summary;
+  const lines = [];
+  const renews = credits.subscription.renewsAt ? ` \xB7 renews ${formatDate(credits.subscription.renewsAt)}` : "";
+  lines.push(`Plan:     ${credits.subscription.tier}${renews}`);
+  lines.push(
+    `Credits:  ${formatCredits(credits.credits)} of ${formatCredits(credits.totalAllocation)} remaining (100 credits = $1)`
+  );
+  const bonusActive = credits.bonus.allocation > 0 || credits.bonus.expired;
+  const purchasedActive = credits.purchased.allocation > 0 || credits.purchased.used > 0;
+  if (bonusActive || purchasedActive) {
+    const bucket = (b) => `${formatCredits(b.remaining)} of ${formatCredits(b.allocation)} remaining`;
+    lines.push(`  Subscription:  ${bucket(credits.subscription)}`);
+    if (bonusActive) {
+      const expires = credits.bonus.expiresAt ? ` \xB7 expires ${formatDate(credits.bonus.expiresAt)}` : "";
+      lines.push(
+        `  Bonus:         ${credits.bonus.expired ? "expired" : bucket(credits.bonus) + expires}`
+      );
+    }
+    if (purchasedActive) {
+      lines.push(`  Purchased:     ${bucket(credits.purchased)}`);
+    }
+  }
+  lines.push("");
+  if (!usageByIntegration.length) {
+    lines.push("No integration usage in the last 30 days.");
+  } else {
+    lines.push("Usage by integration (last 30 days):");
+    const nameWidth = Math.max(11, ...usageByIntegration.map((u) => u.name.length));
+    lines.push(`${"INTEGRATION".padEnd(nameWidth)}  CALLS  COST`);
+    for (const u of usageByIntegration) {
+      lines.push(`${u.name.padEnd(nameWidth)}  ${String(u.count).padEnd(5)}  ${formatUsd(u.totalCost)}`);
+    }
+  }
+  lines.push("");
+  lines.push(`Dashboard: ${DASHBOARD_URL}`);
+  return lines.join("\n");
+}
+var usage_default = defineCommand12({
+  meta: {
+    name: "usage",
+    description: "Show credit balance, quota headroom, and per-integration spend"
+  },
+  args: {
+    json: {
+      type: "boolean",
+      description: "Emit the raw usage summary as JSON instead of human output",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const token = await ensureToken();
+    const summary = await apiFetch(API_URL3, token, "/api/usage/summary");
+    if (args.json) {
+      process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
+      return;
+    }
+    console.log(renderSummary(summary));
+  }
+});
+
+// src/cli/commands/add.ts
+import { defineCommand as defineCommand13 } from "citty";
 import { existsSync as existsSync12, readFileSync as readFileSync12 } from "fs";
 import { resolve as resolve8, join as join13, dirname as dirname3 } from "path";
 import { fileURLToPath } from "url";
@@ -3859,7 +3939,7 @@ function runInstaller(script, passArgs, cwd) {
   }
   process.exit(res.status ?? 1);
 }
-var add_default = defineCommand12({
+var add_default = defineCommand13({
   meta: {
     name: "add",
     description: "Add a feature to your DeepSpace app"
@@ -3932,9 +4012,9 @@ var add_default = defineCommand12({
 });
 
 // src/cli/commands/domain.ts
-import { defineCommand as defineCommand13 } from "citty";
-var API_URL3 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
-var api = (token, path, init) => apiFetch(API_URL3, token, path, init);
+import { defineCommand as defineCommand14 } from "citty";
+var API_URL4 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+var api = (token, path, init) => apiFetch(API_URL4, token, path, init);
 function scrubInternal(value) {
   if (Array.isArray(value)) return value.map(scrubInternal);
   if (value && typeof value === "object") {
@@ -3968,7 +4048,7 @@ async function confirm3(message) {
     });
   });
 }
-var search = defineCommand13({
+var search = defineCommand14({
   meta: { name: "search", description: "Search for available domains" },
   args: {
     query: { type: "positional", description: "Domain or keyword", required: true },
@@ -3998,7 +4078,7 @@ var search = defineCommand13({
     }
   }
 });
-var buy = defineCommand13({
+var buy = defineCommand14({
   meta: { name: "buy", description: "Buy a domain and attach it to an app" },
   args: {
     domain: { type: "positional", description: "Domain to buy", required: true },
@@ -4108,7 +4188,7 @@ var buy = defineCommand13({
     process.exit(1);
   }
 });
-var list2 = defineCommand13({
+var list2 = defineCommand14({
   meta: { name: "list", description: "List your domains" },
   args: {
     json: { type: "boolean", description: "Emit JSON" }
@@ -4134,7 +4214,7 @@ var list2 = defineCommand13({
     }
   }
 });
-var status = defineCommand13({
+var status = defineCommand14({
   meta: { name: "status", description: "Show details for one domain" },
   args: {
     domain: { type: "positional", description: "Domain", required: true },
@@ -4164,7 +4244,7 @@ var status = defineCommand13({
     console.log(`Charged:       ${fmtCents(found.chargedCents)}/yr`);
   }
 });
-var attach = defineCommand13({
+var attach = defineCommand14({
   meta: { name: "attach", description: "Re-point a domain at a different app" },
   args: {
     domain: { type: "positional", description: "Domain to re-point", required: true },
@@ -4195,7 +4275,7 @@ var attach = defineCommand13({
     console.log(`\u2713 ${args.domain} now points at ${targetApp}`);
   }
 });
-var detach = defineCommand13({
+var detach = defineCommand14({
   meta: {
     name: "detach",
     description: "Stop routing the domain (keeps the registration; auto-renew unchanged)"
@@ -4227,7 +4307,7 @@ var detach = defineCommand13({
     );
   }
 });
-var renew = defineCommand13({
+var renew = defineCommand14({
   meta: { name: "renew", description: "Toggle auto-renewal at the registrar" },
   args: {
     domain: { type: "positional", description: "Domain", required: true },
@@ -4253,13 +4333,13 @@ var renew = defineCommand13({
     console.log(`\u2713 ${args.domain} auto-renew ${enabled ? "enabled" : "disabled"}`);
   }
 });
-var domain_default = defineCommand13({
+var domain_default = defineCommand14({
   meta: { name: "domain", description: "Buy and manage custom domains" },
   subCommands: { search, buy, list: list2, status, attach, detach, renew }
 });
 
 // src/cli/commands/collaborators.ts
-import { defineCommand as defineCommand14 } from "citty";
+import { defineCommand as defineCommand15 } from "citty";
 
 // src/server/auth/testAccounts.ts
 var TEST_ACCOUNT_EMAIL_SUFFIX = "@deepspace.test";
@@ -4268,12 +4348,12 @@ function isTestAccountEmail(email) {
 }
 
 // src/cli/commands/collaborators.ts
-var API_URL4 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+var API_URL5 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
 var DEPLOY_URL6 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
 function api2(token, path, init) {
-  return apiFetch(API_URL4, token, path, init);
+  return apiFetch(API_URL5, token, path, init);
 }
-var list3 = defineCommand14({
+var list3 = defineCommand15({
   meta: { name: "list", description: "List collaborators on your app" },
   args: {
     app: { type: "string", alias: "a", description: "App id or name (defaults to ./wrangler.toml)" },
@@ -4305,7 +4385,7 @@ var list3 = defineCommand14({
     }
   }
 });
-var add = defineCommand14({
+var add = defineCommand15({
   meta: { name: "add", description: "Authorize someone to deploy your app" },
   args: {
     email: {
@@ -4350,7 +4430,7 @@ var add = defineCommand14({
     console.log(`\u2713 ${res.collaborator.emailDisplay} can now deploy ${app}`);
   }
 });
-var remove = defineCommand14({
+var remove = defineCommand15({
   meta: { name: "remove", description: "Remove a collaborator from your app" },
   args: {
     email: { type: "positional", description: "Collaborator email", required: true },
@@ -4382,7 +4462,7 @@ var remove = defineCommand14({
     console.log(`\u2713 ${found.emailDisplay} can no longer deploy ${app}`);
   }
 });
-var cancel4 = defineCommand14({
+var cancel4 = defineCommand15({
   meta: { name: "cancel", description: "Cancel a pending (un-accepted) email invite" },
   args: {
     email: { type: "positional", description: "Invited email", required: true },
@@ -4414,17 +4494,17 @@ var cancel4 = defineCommand14({
     console.log(`\u2713 Cancelled the pending invite to ${found.email} on ${app}`);
   }
 });
-var collaborators_default = defineCommand14({
+var collaborators_default = defineCommand15({
   meta: { name: "collaborators", description: "Manage who can deploy your app" },
   subCommands: { list: list3, add, remove, cancel: cancel4 }
 });
 
 // src/cli/commands/transfer.ts
-import { defineCommand as defineCommand15 } from "citty";
+import { defineCommand as defineCommand16 } from "citty";
 import * as p6 from "@clack/prompts";
-var API_URL5 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+var API_URL6 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
 var DEPLOY_URL7 = process.env.DEEPSPACE_DEPLOY_URL ?? PLATFORM_URLS.deploy;
-var offer = defineCommand15({
+var offer = defineCommand16({
   meta: { name: "offer", description: "Offer this app to another DeepSpace user" },
   args: {
     email: { type: "positional", description: "Recipient email", required: true },
@@ -4438,7 +4518,7 @@ var offer = defineCommand15({
     const token = await ensureToken();
     const app = await resolveAppTarget(DEPLOY_URL7, token, args.app);
     const pending = await apiFetch(
-      API_URL5,
+      API_URL6,
       token,
       `/api/app-transfers/${encodeURIComponent(app)}`
     );
@@ -4459,7 +4539,7 @@ var offer = defineCommand15({
       }
     }
     const { expiresAt } = await apiFetch(
-      API_URL5,
+      API_URL6,
       token,
       `/api/app-transfers/${encodeURIComponent(app)}`,
       { method: "POST", body: JSON.stringify({ email: args.email }) }
@@ -4473,7 +4553,7 @@ var offer = defineCommand15({
     );
   }
 });
-var status2 = defineCommand15({
+var status2 = defineCommand16({
   meta: { name: "status", description: "Show the pending transfer offer, if any" },
   args: {
     app: { type: "string", alias: "a", description: "App id or name (defaults to ./wrangler.toml)" }
@@ -4481,7 +4561,7 @@ var status2 = defineCommand15({
   async run({ args }) {
     const token = await ensureToken();
     const app = await resolveAppTarget(DEPLOY_URL7, token, args.app);
-    const { transfer } = await apiFetch(API_URL5, token, `/api/app-transfers/${encodeURIComponent(app)}`);
+    const { transfer } = await apiFetch(API_URL6, token, `/api/app-transfers/${encodeURIComponent(app)}`);
     if (!transfer) {
       console.log(`No pending transfer for ${app}.`);
       return;
@@ -4489,7 +4569,7 @@ var status2 = defineCommand15({
     console.log(`Pending: ${app} \u2192 ${transfer.toEmailDisplay} (expires ${transfer.expiresAt}).`);
   }
 });
-var accept = defineCommand15({
+var accept = defineCommand16({
   meta: { name: "accept", description: "Accept a transfer offered to you" },
   args: {
     app: { type: "string", alias: "a", description: "App id of the offered app", required: true }
@@ -4505,7 +4585,7 @@ var accept = defineCommand15({
     );
   }
 });
-var cancel5 = defineCommand15({
+var cancel5 = defineCommand16({
   meta: { name: "cancel", description: "Cancel/decline the pending offer (either party)" },
   args: {
     app: { type: "string", alias: "a", description: "App id or name (defaults to ./wrangler.toml)" }
@@ -4513,22 +4593,22 @@ var cancel5 = defineCommand15({
   async run({ args }) {
     const token = await ensureToken();
     const app = await resolveAppTarget(DEPLOY_URL7, token, args.app);
-    await apiFetch(API_URL5, token, `/api/app-transfers/${encodeURIComponent(app)}`, { method: "DELETE" });
+    await apiFetch(API_URL6, token, `/api/app-transfers/${encodeURIComponent(app)}`, { method: "DELETE" });
     console.log(`\u2713 Transfer offer for ${app} cancelled.`);
   }
 });
-var transfer_default = defineCommand15({
+var transfer_default = defineCommand16({
   meta: { name: "transfer", description: "Transfer app ownership to another user" },
   subCommands: { offer, status: status2, accept, cancel: cancel5 }
 });
 
 // src/cli/commands/integrations.ts
-import { defineCommand as defineCommand16 } from "citty";
+import { defineCommand as defineCommand17 } from "citty";
 
 // src/cli/commands/_invoke-impl.ts
 import { readFileSync as readFileSync13 } from "fs";
 import * as p7 from "@clack/prompts";
-var API_URL6 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+var API_URL7 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
 var DEFAULT_TIMEOUT_MS = 12e4;
 function parseTarget(target) {
   if (!target || typeof target !== "string") {
@@ -4570,7 +4650,7 @@ function flushAndExit(code) {
   });
 }
 async function fetchCatalog(opts = {}) {
-  const url = opts.summary ? `${API_URL6}/api/integrations?summary=1` : `${API_URL6}/api/integrations`;
+  const url = opts.summary ? `${API_URL7}/api/integrations?summary=1` : `${API_URL7}/api/integrations`;
   const res = await fetch(url);
   if (!res.ok) {
     throw new Error(`Failed to fetch integration catalog (${res.status})`);
@@ -4694,7 +4774,7 @@ async function runInvoke(args) {
   const startedAt = Date.now();
   let res;
   try {
-    res = await fetch(`${API_URL6}/api/integrations/${integration}/${endpoint}`, {
+    res = await fetch(`${API_URL7}/api/integrations/${integration}/${endpoint}`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -4745,7 +4825,7 @@ async function runInvoke(args) {
 }
 
 // src/cli/commands/integrations.ts
-var list4 = defineCommand16({
+var list4 = defineCommand17({
   meta: {
     name: "list",
     description: "List all available integrations"
@@ -4766,7 +4846,7 @@ var list4 = defineCommand16({
     }
   }
 });
-var info = defineCommand16({
+var info = defineCommand17({
   meta: {
     name: "info",
     description: "Print schema + example body for an integration endpoint"
@@ -4792,7 +4872,7 @@ var info = defineCommand16({
     }
   }
 });
-var invoke = defineCommand16({
+var invoke = defineCommand17({
   meta: {
     name: "invoke",
     description: "Invoke a platform integration as the logged-in user"
@@ -4852,7 +4932,7 @@ var invoke = defineCommand16({
     }
   }
 });
-var integrations_default = defineCommand16({
+var integrations_default = defineCommand17({
   meta: {
     name: "integrations",
     description: "List, inspect, and invoke platform integrations"
@@ -4865,8 +4945,8 @@ var integrations_default = defineCommand16({
 });
 
 // src/cli/commands/invoke.ts
-import { defineCommand as defineCommand17 } from "citty";
-var invoke_default = defineCommand17({
+import { defineCommand as defineCommand18 } from "citty";
+var invoke_default = defineCommand18({
   meta: {
     name: "invoke",
     description: "Invoke a platform integration as the logged-in user"
@@ -4946,13 +5026,13 @@ var invoke_default = defineCommand17({
 });
 
 // src/cli/commands/library.ts
-import { defineCommand as defineCommand18 } from "citty";
+import { defineCommand as defineCommand19 } from "citty";
 import { existsSync as existsSync13, readFileSync as readFileSync14 } from "fs";
 import { join as join14, resolve as resolve9 } from "path";
 import { parse as parseToml4 } from "smol-toml";
 import * as p8 from "@clack/prompts";
 var DEFAULT_LIBRARY_APP = "deepdotspace-site";
-var publish = defineCommand18({
+var publish = defineCommand19({
   meta: {
     name: "publish",
     description: "Publish the current app to the DeepSpace library"
@@ -5091,7 +5171,7 @@ var publish = defineCommand18({
     p8.outro("Done");
   }
 });
-var unpublish = defineCommand18({
+var unpublish = defineCommand19({
   meta: {
     name: "unpublish",
     description: "Remove a library entry (owner or admin only)"
@@ -5150,7 +5230,7 @@ var unpublish = defineCommand18({
     p8.outro("Done");
   }
 });
-var library_default = defineCommand18({
+var library_default = defineCommand19({
   meta: {
     name: "library",
     description: "Manage your DeepSpace library entries"
@@ -5162,13 +5242,13 @@ var library_default = defineCommand18({
 });
 
 // src/cli/commands/feedback.ts
-import { defineCommand as defineCommand19 } from "citty";
+import { defineCommand as defineCommand20 } from "citty";
 import * as p9 from "@clack/prompts";
 import { existsSync as existsSync14, readFileSync as readFileSync15 } from "fs";
 import { dirname as dirname4, join as join15 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { release } from "os";
-var API_URL7 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
+var API_URL8 = process.env.DEEPSPACE_API_URL ?? PLATFORM_URLS.api;
 var TYPES = ["bug", "feature", "other"];
 var TYPE_LABELS = {
   bug: "Bug report",
@@ -5178,7 +5258,7 @@ var TYPE_LABELS = {
 var MAX_TITLE_LEN = 200;
 var MAX_BODY_LEN = 1e4;
 var MAX_CONTEXT_LEN = 200;
-var api3 = (token, path, init) => apiFetch(API_URL7, token, path, init);
+var api3 = (token, path, init) => apiFetch(API_URL8, token, path, init);
 function normalizeType(raw) {
   const value = (raw ?? "bug").toLowerCase();
   if (TYPES.includes(value)) return value;
@@ -5240,7 +5320,7 @@ function buildFeedbackPayload(input) {
     ...input.context
   };
 }
-var feedback_default = defineCommand19({
+var feedback_default = defineCommand20({
   meta: {
     name: "feedback",
     description: "Submit a bug report, feature request, or feedback to DeepSpace"
@@ -5402,7 +5482,7 @@ Context: deepspace ${payload.cliVersion} \xB7 ${payload.nodeVersion} \xB7 ${payl
 });
 
 // src/cli/commands/secrets.ts
-import { defineCommand as defineCommand20 } from "citty";
+import { defineCommand as defineCommand21 } from "citty";
 import { readFileSync as readFileSync16 } from "fs";
 
 // src/cli/lib/citty-args.ts
@@ -5472,7 +5552,7 @@ function warnIfDebugRoutesEnabled(secrets) {
 }
 var APPLY_HINT = "Run `deepspace deploy` to apply \u2014 secrets take effect at deploy time.";
 var LOCAL_DEV_HINT = "Running `deepspace dev`? Restart it to load the change locally.";
-var list5 = defineCommand20({
+var list5 = defineCommand21({
   meta: { name: "list", description: "List masked secrets in a config" },
   args: {
     ...COMMON_ARGS,
@@ -5503,7 +5583,7 @@ var list5 = defineCommand20({
     }
   }
 });
-var set = defineCommand20({
+var set = defineCommand21({
   meta: { name: "set", description: "Set secrets from KEY=value pairs" },
   args: {
     ...COMMON_ARGS,
@@ -5545,7 +5625,7 @@ var set = defineCommand20({
     }
   }
 });
-var get = defineCommand20({
+var get = defineCommand21({
   meta: { name: "get", description: "Get a secret; pass --plain to print the value" },
   args: {
     ...COMMON_ARGS,
@@ -5570,7 +5650,7 @@ var get = defineCommand20({
     }
   }
 });
-var del2 = defineCommand20({
+var del2 = defineCommand21({
   meta: { name: "delete", description: "Delete one or more secrets" },
   args: {
     ...COMMON_ARGS,
@@ -5600,7 +5680,7 @@ var del2 = defineCommand20({
     }
   }
 });
-var upload = defineCommand20({
+var upload = defineCommand21({
   meta: { name: "upload", description: "Upload secrets from a dotenv or JSON file" },
   args: {
     ...COMMON_ARGS,
@@ -5625,7 +5705,7 @@ var upload = defineCommand20({
     }
   }
 });
-var download = defineCommand20({
+var download = defineCommand21({
   meta: { name: "download", description: "Download a config\u2019s secrets (dotenv/json/shell)" },
   args: {
     ...COMMON_ARGS,
@@ -5649,7 +5729,7 @@ var download = defineCommand20({
     }
   }
 });
-var pull = defineCommand20({
+var pull = defineCommand21({
   meta: { name: "pull", description: "Refresh the .dev.vars cache from the app store" },
   args: { ...COMMON_ARGS },
   async run({ args }) {
@@ -5677,7 +5757,7 @@ var pull = defineCommand20({
     }
   }
 });
-var configsList = defineCommand20({
+var configsList = defineCommand21({
   meta: { name: "list", description: "List the app\u2019s configs" },
   args: { ...COMMON_ARGS },
   async run({ args }) {
@@ -5696,7 +5776,7 @@ var configsList = defineCommand20({
     }
   }
 });
-var configsCreate = defineCommand20({
+var configsCreate = defineCommand21({
   meta: { name: "create", description: "Create a config (optionally copying another)" },
   args: {
     ...COMMON_ARGS,
@@ -5727,7 +5807,7 @@ var configsCreate = defineCommand20({
     }
   }
 });
-var configsDelete = defineCommand20({
+var configsDelete = defineCommand21({
   meta: { name: "delete", description: "Delete a config and all of its secrets" },
   args: {
     ...COMMON_ARGS,
@@ -5744,11 +5824,11 @@ var configsDelete = defineCommand20({
     }
   }
 });
-var configs = defineCommand20({
+var configs = defineCommand21({
   meta: { name: "configs", description: "Manage the app\u2019s secrets configs" },
   subCommands: { list: configsList, create: configsCreate, delete: configsDelete }
 });
-var secrets_default = defineCommand20({
+var secrets_default = defineCommand21({
   meta: { name: "secrets", description: "Manage the app\u2019s secrets store" },
   subCommands: {
     list: list5,
@@ -5763,8 +5843,8 @@ var secrets_default = defineCommand20({
 });
 
 // src/cli/commands/init.ts
-import { defineCommand as defineCommand21 } from "citty";
-var init_default = defineCommand21({
+import { defineCommand as defineCommand22 } from "citty";
+var init_default = defineCommand22({
   meta: {
     name: "init",
     description: "Mint this app\u2019s immutable DEEPSPACE_APP_ID into wrangler.toml"
@@ -5814,7 +5894,7 @@ var pkg = JSON.parse(readFileSync17(join16(__dirname, "..", "package.json"), "ut
 if (process.platform === "linux" && !process.env.SSL_CERT_FILE && existsSync15("/etc/ssl/certs/ca-certificates.crt")) {
   process.env.SSL_CERT_FILE = "/etc/ssl/certs/ca-certificates.crt";
 }
-var create2 = defineCommand22({
+var create2 = defineCommand23({
   meta: {
     name: "create",
     description: "Create a new DeepSpace app (runs create-deepspace; all flags are forwarded)"
@@ -5841,7 +5921,7 @@ var create2 = defineCommand22({
     process.exit(res.status ?? 1);
   }
 });
-var main = defineCommand22({
+var main = defineCommand23({
   meta: {
     name: "deepspace",
     version: pkg.version,
@@ -5854,6 +5934,7 @@ var main = defineCommand22({
     logout: logout_default,
     whoami: whoami_default,
     apps: apps_default,
+    usage: usage_default,
     dev: dev_default,
     kill: kill_default,
     test: test_default,