deepline 0.3.294 → 0.3.296

package/dist/cli/billing-YBK3J4WP.js

@@ -0,0 +1,1749 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunk2C3AVPTYjs = require('./chunk-2C3AVPTY.js');
+require('./chunk-LA46MMTL.js');
+
+
+
+
+
+
+var _chunk7D6QG5KFjs = require('./chunk-7D6QG5KF.js');
+
+
+
+var _chunk6HPEDBSJjs = require('./chunk-6HPEDBSJ.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-LIKFCE7Z.js');
+require('./chunk-6A3TJUWC.js');
+
+
+var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+// src/cli/commands/billing.ts
+var _commander = require('commander');
+var _crypto = require('crypto');
+var _promises = require('fs/promises');
+var _path = require('path');
+var _sync = require('csv-stringify/sync');
+var SUBSCRIPTION_STATUS_NEXT_COMMAND = "deepline billing subscription status --json";
+var SUBSCRIPTION_CANCEL_PATH = "/api/v2/billing/subscription/cancel";
+var BILLING_TOP_UP_PATH = "/api/v2/billing/top-up";
+var DEFAULT_BALANCE_RECOVERY_CREDITS = 100;
+function billingFailureFromError(error, options) {
+  if (error instanceof _chunk6HPEDBSJjs.AuthError) {
+    return {
+      exitCode: 3,
+      code: "AUTH_ERROR",
+      message: error.message,
+      next: "deepline auth status --json"
+    };
+  }
+  if (!(error instanceof _chunk7P5AA3SNjs.DeeplineError) || typeof error.statusCode !== "number") {
+    return null;
+  }
+  if (error.statusCode === 404 || error.statusCode === 409) {
+    return {
+      exitCode: 4,
+      code: options.notFoundCode,
+      message: error.message,
+      next: SUBSCRIPTION_STATUS_NEXT_COMMAND
+    };
+  }
+  if (error.statusCode >= 500) {
+    return {
+      exitCode: 5,
+      code: "BILLING_SERVER_ERROR",
+      message: error.message,
+      next: SUBSCRIPTION_STATUS_NEXT_COMMAND
+    };
+  }
+  return null;
+}
+function reportBillingFailure(failure, options) {
+  const textLines = [failure.message];
+  if (failure.next) {
+    textLines.push(`Next: ${failure.next}`);
+  }
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ok: false,
+      exitCode: failure.exitCode,
+      code: failure.code,
+      message: failure.message,
+      ...failure.next ? { next: failure.next } : {}
+    },
+    { json: options.json, text: `${textLines.join("\n")}
+` }
+  );
+  process.exitCode = failure.exitCode;
+}
+function parseTopUpCredits(raw) {
+  const trimmed = String(_nullishCoalesce(raw, () => ( ""))).trim();
+  if (!/^\d+$/.test(trimmed)) return null;
+  const parsed = Number(trimmed);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) return null;
+  return parsed;
+}
+function topUpIdempotencyKey(raw) {
+  if (typeof raw === "string") {
+    const trimmed = raw.trim();
+    if (trimmed) return trimmed.slice(0, 120);
+  }
+  return `cli_topup:${Date.now()}:${_crypto.randomUUID.call(void 0, )}`;
+}
+function targetBillingIdempotencyKey(raw) {
+  return typeof raw === "string" ? raw : `cli_target_billing:${Date.now()}:${_crypto.randomUUID.call(void 0, )}`;
+}
+function checkoutCommandForCredits(credits) {
+  return `deepline billing checkout --credits ${credits} --no-open --json`;
+}
+function approvedTopUpCommandForCredits(credits) {
+  return `deepline billing top-up ${credits} --json`;
+}
+function balanceRecoveryForCredits(credits = DEFAULT_BALANCE_RECOVERY_CREDITS) {
+  return {
+    recommended_credits: credits,
+    requires_user_approval: true,
+    message: "Ask the user whether they want to add Deepline credits before taking payment-related action.",
+    top_up_command: approvedTopUpCommandForCredits(credits),
+    checkout_command: checkoutCommandForCredits(credits)
+  };
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function topUpRetryCommand(credits, idempotencyKey) {
+  return `deepline billing top-up ${credits} --idempotency-key ${shellQuote(idempotencyKey)} --json`;
+}
+function apiErrorCode(error) {
+  const response = _optionalChain([error, 'access', _ => _.details, 'optionalAccess', _2 => _2.response]);
+  if (response && typeof response === "object" && !Array.isArray(response)) {
+    const code = response.code;
+    if (typeof code === "string" && code.trim()) {
+      return code.trim();
+    }
+  }
+  return _nullishCoalesce(error.code, () => ( "BILLING_API_ERROR"));
+}
+function billingTopUpFailureFromError(error, input) {
+  if (error instanceof _chunk6HPEDBSJjs.AuthError || error instanceof _chunk6HPEDBSJjs.ConfigError) {
+    return {
+      exitCode: 3,
+      code: "AUTH_ERROR",
+      message: error.message,
+      next: "deepline auth status --json"
+    };
+  }
+  if (!(error instanceof _chunk7P5AA3SNjs.DeeplineError) || typeof error.statusCode !== "number") {
+    if (error instanceof _chunk7P5AA3SNjs.DeeplineError) {
+      return {
+        exitCode: 5,
+        code: "TOP_UP_STATUS_UNKNOWN",
+        message: `${error.message} The top-up may have reached Deepline. Retry only with the same idempotency key to avoid a duplicate charge.`,
+        next: topUpRetryCommand(input.credits, input.idempotencyKey)
+      };
+    }
+    return null;
+  }
+  const code = apiErrorCode(error);
+  if (error.statusCode === 400) {
+    return {
+      exitCode: 2,
+      code: "INVALID_CREDITS",
+      message: error.message,
+      next: "deepline billing plans --json"
+    };
+  }
+  if (error.statusCode === 409) {
+    const checkoutNext = checkoutCommandForCredits(input.credits);
+    return {
+      exitCode: 4,
+      code: code === "requires_action" ? "PAYMENT_REQUIRES_ACTION" : "MISSING_PAYMENT_METHOD",
+      message: error.message,
+      next: checkoutNext
+    };
+  }
+  if (error.statusCode === 402) {
+    return {
+      exitCode: 5,
+      code: "PAYMENT_FAILED",
+      message: error.message,
+      next: checkoutCommandForCredits(input.credits)
+    };
+  }
+  if (error.statusCode >= 500) {
+    return {
+      exitCode: 5,
+      code: "BILLING_SERVER_ERROR",
+      message: `${error.message} Retry only with the same idempotency key to avoid a duplicate charge.`,
+      next: topUpRetryCommand(input.credits, input.idempotencyKey)
+    };
+  }
+  return null;
+}
+function normalizeUnixMilliseconds(value) {
+  const timestamp = Math.floor(value);
+  return Number.isFinite(timestamp) && timestamp >= 0 && Number.isFinite(new Date(timestamp).getTime()) ? timestamp : null;
+}
+function parseSince(raw) {
+  if (!_optionalChain([raw, 'optionalAccess', _3 => _3.trim, 'call', _4 => _4()])) return null;
+  const numeric = Number(raw);
+  const normalizedNumeric = normalizeUnixMilliseconds(numeric);
+  if (normalizedNumeric !== null) return normalizedNumeric;
+  const parsed = Date.parse(raw);
+  return normalizeUnixMilliseconds(parsed);
+}
+function humanize(value) {
+  return String(value || "").split("_").filter(Boolean).map((token) => _optionalChain([token, 'access', _5 => _5[0], 'optionalAccess', _6 => _6.toUpperCase, 'call', _7 => _7()]) + token.slice(1)).join(" ") || "Unknown";
+}
+function recentUsageLines(entries) {
+  if (entries.length === 0) {
+    return ["Recent activity: none yet"];
+  }
+  const lines = ["Recent activity:"];
+  for (const entry of entries) {
+    const op = `${humanize(entry.provider)} ${humanize(entry.operation)}`.trim();
+    const roughUsd = Number(entry.rough_usd_cost);
+    const credits = entry.credits !== null && entry.credits !== void 0 && String(entry.credits).trim().length > 0 && Number.isFinite(Number(entry.credits)) ? Number(entry.credits) : null;
+    const temporaryHold = entry.charge_state === "temporary_hold";
+    const pending = entry.charge_state === "pending" || entry.charge_finality === "pending";
+    const unknown = entry.charge_finality === "unknown" || credits === null;
+    const usdText = !pending && !unknown && entry.rough_usd_cost !== null && entry.rough_usd_cost !== void 0 && Number.isFinite(roughUsd) ? ` (\u2248$${roughUsd.toFixed(2)})` : "";
+    const charge = temporaryHold ? `${credits === null ? "unknown amount" : `${credits} cr`} held${usdText}, not final` : pending ? "final Deepline charge pending" : unknown ? "charge unknown" : entry.billing_mode === "no_bill" ? "free" : credits === 0 && (entry.charge_finality === "final" || entry.charge_state === "hold_release") ? "0 cr, final" : `${credits} cr${usdText}`;
+    const state = temporaryHold ? "temporary hold, final charge pending" : pending ? "no final charge recorded yet" : entry.status || "unknown";
+    const auditBits = [
+      entry.outcome ? `outcome=${entry.outcome}` : null,
+      entry.pricing_basis ? `priced_by=${entry.pricing_basis}` : null,
+      entry.run_id ? `run=${entry.run_id}` : null,
+      entry.play_run_id || entry.execution_run_id ? `play_run=${_nullishCoalesce(entry.play_run_id, () => ( entry.execution_run_id))}` : null,
+      entry.billing_run_id ? `billing_run=${entry.billing_run_id}` : null,
+      entry.workflow_id ? `workflow=${entry.workflow_id}` : null,
+      entry.step_alias ? `step=${entry.step_alias}` : null,
+      entry.request_id ? `request=${entry.request_id}` : null
+    ].filter(Boolean);
+    lines.push(
+      `${op} | ${charge} | ${state}${auditBits.length > 0 ? ` | ${auditBits.join(" | ")}` : ""} | ${entry.created_at || "unknown"}`
+    );
+  }
+  return lines;
+}
+function summarizeLedgerRows(summary, rows) {
+  const netDelta = rows.reduce((sum, row) => {
+    const value = Number.parseFloat(String(_nullishCoalesce(row.delta_credits, () => ( ""))).trim());
+    return Number.isFinite(value) ? sum + value : sum;
+  }, summary.net_delta_credits);
+  return {
+    row_count: summary.row_count + rows.length,
+    net_delta_credits: Math.round((netDelta + Number.EPSILON) * 100) / 100
+  };
+}
+function ledgerApiEntryToRow(entry) {
+  const metadata = typeof entry.metadata === "object" && entry.metadata !== null ? entry.metadata : {};
+  const audit = typeof entry.billing_audit === "object" && entry.billing_audit !== null ? entry.billing_audit : {};
+  return {
+    created_at: _nullishCoalesce(entry.created_at, () => ( "")),
+    delta_credits: _nullishCoalesce(entry.delta, () => ( "")),
+    reason: _nullishCoalesce(entry.reason, () => ( "")),
+    provider: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.provider, () => ( audit.provider)), () => ( metadata.provider)), () => ( "")),
+    operation: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.operation, () => ( audit.operation)), () => ( metadata.operation)), () => ( "")),
+    request_id: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.request_id, () => ( audit.request_id)), () => ( metadata.requestId)), () => ( metadata.request_id)), () => ( "")),
+    run_id: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.run_id, () => ( audit.run_id)), () => ( metadata.runId)), () => ( metadata.run_id)), () => ( "")),
+    billing_stage: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.billing_stage, () => ( audit.billing_stage)), () => ( metadata.billingStage)), () => ( "")),
+    charge_state: _nullishCoalesce(_nullishCoalesce(entry.charge_state, () => ( audit.charge_state)), () => ( "")),
+    billing_mode: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.billing_mode, () => ( audit.billing_mode)), () => ( metadata.billingMode)), () => ( metadata.chargeMode)), () => ( "")),
+    pricing_model: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(entry.pricing_model, () => ( audit.pricing_model)), () => ( metadata.pricingModel)), () => ( "")),
+    pricing_basis: _nullishCoalesce(_nullishCoalesce(entry.pricing_basis, () => ( audit.pricing_basis)), () => ( "")),
+    charge_credits: _nullishCoalesce(_nullishCoalesce(entry.charge_credits, () => ( audit.charge_credits)), () => ( "")),
+    outcome: _nullishCoalesce(_nullishCoalesce(entry.outcome, () => ( audit.outcome)), () => ( "")),
+    result_count: _nullishCoalesce(_nullishCoalesce(entry.result_count, () => ( audit.result_count)), () => ( "")),
+    deepline_rough_usd: _nullishCoalesce(entry.deepline_rough_usd, () => ( "")),
+    api_key_id: _nullishCoalesce(entry.api_key_id, () => ( "")),
+    stripe_session_id: _nullishCoalesce(entry.stripe_session_id, () => ( ""))
+  };
+}
+function ledgerRowsToCsv(rows, header) {
+  return _sync.stringify.call(void 0, rows, {
+    header,
+    columns: [
+      "created_at",
+      "delta_credits",
+      "reason",
+      "provider",
+      "operation",
+      "request_id",
+      "run_id",
+      "billing_stage",
+      "charge_state",
+      "billing_mode",
+      "pricing_model",
+      "pricing_basis",
+      "charge_credits",
+      "outcome",
+      "result_count",
+      "deepline_rough_usd",
+      "api_key_id",
+      "stripe_session_id"
+    ]
+  });
+}
+function defaultLedgerExportPath() {
+  return _path.resolve.call(void 0, 
+    process.cwd(),
+    "deepline",
+    "data",
+    `billing-ledger-all-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.csv`
+  );
+}
+async function handleBalance(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.get(
+    "/api/v2/billing/balance"
+  );
+  const status = String(payload.balance_status || "");
+  const needsCredits = status === "no_billing" || status === "zero_balance" || status === "payment_method_only";
+  const recovery = needsCredits ? balanceRecoveryForCredits() : null;
+  const lines = [`Balance: ${_nullishCoalesce(payload.balance, () => ( "(unknown)"))} credits`];
+  const temporaryHolds = payload.temporary_hold_credits;
+  if (typeof temporaryHolds === "number" && temporaryHolds > 0) {
+    lines.push(`Open reservation exposure: ${temporaryHolds} credits.`);
+  } else if (temporaryHolds === null) {
+    lines.push("Temporary reservation status is temporarily unavailable.");
+  }
+  if (payload.temporary_hold_credits_truncated === true) {
+    lines.push("Temporary reservation total may be incomplete.");
+  }
+  if (typeof payload.estimated_hold_credits === "number") {
+    lines.push(
+      `Estimated holds: ${payload.estimated_hold_credits} credits \u2014 final usage is not recorded yet.`
+    );
+  }
+  if (typeof payload.incurred_unsettled_credits === "number") {
+    lines.push(
+      `Incurred, awaiting settlement: ${payload.incurred_unsettled_credits} credits.`
+    );
+  }
+  if (typeof payload.pending_wallet_debit_credits === "number") {
+    lines.push(
+      `Pending wallet debit: ${payload.pending_wallet_debit_credits} credits \u2014 excludes amounts already debited for funded holds.`
+    );
+  }
+  if (typeof payload.pending_wallet_refund_credits === "number" && payload.pending_wallet_refund_credits > 0) {
+    lines.push(
+      `Pending wallet refund: ${payload.pending_wallet_refund_credits} credits.`
+    );
+  }
+  if (payload.exposure_status === "partial") {
+    lines.push(
+      "Exposure amounts are lower bounds: some reservations are unpriced or the scan is incomplete."
+    );
+  } else if (payload.exposure_status !== "complete") {
+    lines.push(
+      "The estimated and incurred usage breakdown is temporarily unavailable."
+    );
+  }
+  if (status === "no_billing") {
+    lines.push(
+      "Billing: No billing account or payment method set up for this workspace."
+    );
+  } else if (status === "zero_balance") {
+    lines.push("Billing: This workspace has no Deepline credits available.");
+  } else if (status === "payment_method_only") {
+    lines.push(
+      "Billing: A payment method is saved, but this workspace has no Deepline credits available."
+    );
+  }
+  if (recovery) {
+    lines.push(recovery.message);
+    lines.push(`If the user approves, run: ${recovery.top_up_command}`);
+    lines.push(`If checkout is required, run: ${recovery.checkout_command}`);
+  }
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      ...recovery ? { recovery } : {},
+      render: { sections: [{ title: "billing balance", lines }] }
+    },
+    { json: options.json }
+  );
+  return;
+}
+function quoteShellArgument(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function handleUsage(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const params = new URLSearchParams();
+  if (options.requestId !== void 0) {
+    const requestId = options.requestId.trim();
+    if (requestId.length === 0 || requestId.length > 200 || requestId !== options.requestId) {
+      reportBillingFailure(
+        {
+          exitCode: 2,
+          code: "INVALID_REQUEST_ID",
+          message: "--request-id must contain 1\u2013200 characters with no leading or trailing whitespace."
+        },
+        options
+      );
+      return;
+    }
+    if (options.offset || options.cursor || options.runId) {
+      reportBillingFailure(
+        {
+          exitCode: 2,
+          code: "CONFLICTING_USAGE_FILTERS",
+          message: "--request-id cannot be combined with --offset, --cursor, or --run-id."
+        },
+        options
+      );
+      return;
+    }
+    params.set("request_id", requestId);
+  } else {
+    if (options.limit) params.set("recent_limit", options.limit);
+    if (options.offset) params.set("recent_offset", options.offset);
+    if (options.cursor) params.set("recent_cursor", options.cursor);
+    if (options.runId) params.set("run_id", options.runId);
+  }
+  const suffix = Array.from(params).length > 0 ? `?${params.toString()}` : "";
+  let payload;
+  try {
+    payload = await http.get(
+      `/api/v2/billing/usage${suffix}`
+    );
+  } catch (error) {
+    if (options.requestId && error instanceof _chunk7P5AA3SNjs.DeeplineError && error.statusCode === 404) {
+      reportBillingFailure(
+        {
+          exitCode: 4,
+          code: "USAGE_REQUEST_NOT_FOUND",
+          message: `No billing record for request_id ${options.requestId} in the active workspace.`,
+          next: "deepline billing usage --json"
+        },
+        options
+      );
+      return;
+    }
+    throw error;
+  }
+  const usage = _nullishCoalesce(payload.usage, () => ( {}));
+  const quota = _nullishCoalesce(payload.quota, () => ( {}));
+  const recent = _nullishCoalesce(payload.recent, () => ( {}));
+  const last30Usage = _nullishCoalesce(usage.last_30_days_usage_credits, () => ( usage.month_spent_credits));
+  const temporaryHolds = Number(_nullishCoalesce(usage.temporary_hold_credits, () => ( 0)));
+  const nextPage = typeof recent.next_cursor === "string" && recent.next_cursor.length > 0 ? `deepline billing usage --cursor ${quoteShellArgument(recent.next_cursor)}${options.limit ? ` --limit ${options.limit}` : ""}${options.runId ? ` --run-id ${quoteShellArgument(options.runId)}` : ""} --json` : null;
+  const recentLines = recentUsageLines(
+    Array.isArray(recent.entries) ? recent.entries : []
+  );
+  const matchingActivity = typeof recent.total === "number" && Number.isFinite(recent.total) && recent.total >= 0 && typeof recent.total_is_exact === "boolean" ? recent.total_is_exact ? `Matching activity: ${recent.total}` : typeof recent.total_lower_bound === "number" && Number.isFinite(recent.total_lower_bound) && recent.total_lower_bound >= 0 ? `Matching activity: at least ${recent.total_lower_bound}` : `Matching activity: count not exact (reported ${recent.total})` : null;
+  const lines = options.requestId ? [`Charge lookup: ${options.requestId}`, ...recentLines] : [
+    `Balance: ${_nullishCoalesce(payload.balance, () => ( "(unknown)"))}`,
+    `Last 30 days usage: ${_nullishCoalesce(last30Usage, () => ( "(unknown)"))}`,
+    ...Number.isFinite(temporaryHolds) && temporaryHolds > 0 ? [`Temporary holds: ${temporaryHolds}`] : [],
+    `Monthly usage cap: ${quota.enabled ? _nullishCoalesce(quota.monthly_credits_limit, () => ( "(unknown)")) : "off"}`,
+    ...options.runId && recent.run_id ? [
+      `Run spend: ${_nullishCoalesce((_nullishCoalesce(payload.run, () => ( {}))).spent_credits, () => ( "(unknown)"))} Deepline Credits`
+    ] : [],
+    ...matchingActivity ? [matchingActivity] : [],
+    ...recentLines,
+    ...recent.has_more === true ? ["More activity pages are available."] : [],
+    ...recent.incomplete === true ? ["Recent activity is incomplete; the matching count may be higher."] : [],
+    ...nextPage ? [`Next page: ${nextPage}`] : [],
+    ...!nextPage && (recent.has_more === true || recent.incomplete === true) ? [
+      "No continuation is available for this view. Use deepline billing ledger export all --json for the full ledger."
+    ] : []
+  ];
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      recent: {
+        ...recent,
+        is_truncated: recent.has_more === true || recent.incomplete === true
+      },
+      next: { page: nextPage },
+      render: { sections: [{ title: "billing usage", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleLimit(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.get(
+    "/api/v2/billing/limit"
+  );
+  const lines = payload.enabled ? [
+    `Monthly usage cap: ${_nullishCoalesce(payload.monthly_credits_limit, () => ( "(unknown)"))}`,
+    "Enforcement: checked before new calls; in-flight work can exceed the cap."
+  ] : ["Monthly usage cap: off"];
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: { sections: [{ title: "billing limit", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleSetLimit(credits, options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.request("/api/v2/billing/limit", {
+    method: "PUT",
+    body: { monthly_credits_limit: Number.parseInt(credits, 10) }
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing limit",
+            lines: [`Monthly usage cap set to ${credits} credits.`]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleLimitOff(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.request("/api/v2/billing/limit", {
+    method: "DELETE"
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing limit",
+            lines: ["Monthly usage cap is now off."]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function exportLedger(http, outputPath, options) {
+  let summary = { row_count: 0, net_delta_credits: 0 };
+  let initialized = false;
+  let pageNumber = 0;
+  console.error(`Exporting billing ledger to ${outputPath}`);
+  for await (const entries of _chunk2C3AVPTYjs.iterateCursorPages.call(void 0, async (cursor) => {
+    pageNumber += 1;
+    console.error(
+      `Fetching page ${pageNumber}; ${summary.row_count} rows written.`
+    );
+    const params = new URLSearchParams({ limit: "5000" });
+    if (cursor) params.set("cursor", cursor);
+    if (options.sinceAt !== null)
+      params.set("since_at", String(options.sinceAt));
+    if (options.runId) params.set("run_id", options.runId);
+    if (options.operation) params.set("operation", options.operation);
+    const payload = await http.get(
+      `/api/v2/billing/ledger?${params.toString()}`
+    );
+    if (!Array.isArray(payload.entries) || typeof payload.has_more !== "boolean") {
+      throw new Error("Billing ledger response is missing entries");
+    }
+    return {
+      items: payload.entries,
+      hasMore: payload.has_more === true,
+      cursor: typeof payload.next_cursor === "string" ? payload.next_cursor : null
+    };
+  })) {
+    if (!initialized) {
+      await _promises.mkdir.call(void 0, _path.dirname.call(void 0, outputPath), { recursive: true });
+      await _promises.writeFile.call(void 0, outputPath, ledgerRowsToCsv([], true), "utf-8");
+      initialized = true;
+    }
+    const rows = entries.map(ledgerApiEntryToRow);
+    await _promises.appendFile.call(void 0, outputPath, ledgerRowsToCsv(rows, false), "utf-8");
+    summary = summarizeLedgerRows(summary, rows);
+    console.error(
+      `Wrote page ${pageNumber}; ${summary.row_count} rows written.`
+    );
+  }
+  console.error(`Export complete: ${summary.row_count} rows written.`);
+  return summary;
+}
+async function handleHistory(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const windows = {
+    "1d": 86400,
+    "1w": 604800,
+    "1m": 2592e3,
+    "1y": 31536e3
+  };
+  const sinceAt = Math.max(0, Math.floor(Date.now() / 1e3) - windows[options.time]) * 1e3;
+  const outputPath = _path.resolve.call(void 0, 
+    process.cwd(),
+    "deepline",
+    "data",
+    _chunk7D6QG5KFjs.createTimestampedName.call(void 0, `billing-history-${options.time}`, "csv")
+  );
+  const summary = await exportLedger(http, outputPath, { sinceAt });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      output_path: outputPath,
+      row_count: summary.row_count,
+      has_more: false,
+      is_truncated: false,
+      next_cursor: null,
+      time_window: options.time,
+      render: {
+        sections: [
+          {
+            title: "billing history",
+            lines: [
+              `Billing history written to ${outputPath}`,
+              `${summary.row_count} row(s) exported.`
+            ]
+          }
+        ]
+      },
+      local: { output_path: outputPath }
+    },
+    { json: options.json }
+  );
+}
+async function handleLedgerExportAll(options) {
+  const sinceAt = parseSince(options.since);
+  if (options.since && sinceAt === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_SINCE",
+        message: "--since must be an ISO-8601 timestamp or Unix milliseconds."
+      },
+      options
+    );
+    return;
+  }
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const outputPath = options.output ? _path.resolve.call(void 0, String(options.output)) : defaultLedgerExportPath();
+  const summary = await exportLedger(http, outputPath, {
+    sinceAt,
+    runId: options.runId,
+    operation: options.operation
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      output_path: outputPath,
+      row_count: summary.row_count,
+      has_more: false,
+      is_truncated: false,
+      next_cursor: null,
+      net_delta_credits: summary.net_delta_credits,
+      scope: "workspace",
+      ...options.runId ? { run_id: options.runId } : {},
+      ...options.operation ? { operation: options.operation } : {},
+      ...sinceAt !== null ? { since_at: sinceAt } : {},
+      render: {
+        sections: [
+          {
+            title: "billing ledger",
+            lines: [
+              `Billing ledger written to ${outputPath}`,
+              `${summary.row_count} row(s) exported for the active workspace${options.runId ? ` and run ${options.runId}` : ""}${options.operation ? ` and operation ${options.operation}` : ""}${sinceAt !== null ? ` since ${new Date(sinceAt).toISOString()}` : ""}.`,
+              `Net ledger delta: ${summary.net_delta_credits} Deepline Credits`
+            ]
+          }
+        ]
+      },
+      local: { output_path: outputPath }
+    },
+    { json: options.json }
+  );
+}
+function planPriceText(priceUsd, priceInterval) {
+  if (priceUsd === null || priceUsd === void 0) {
+    return "no list price";
+  }
+  return `$${priceUsd}${priceInterval ? `/${priceInterval}` : ""}`;
+}
+function targetPlanLine(plan) {
+  return `${plan.name} (${plan.sku}) | ${planPriceText(plan.recurring_price_usd, plan.interval)} | ${plan.included_credits} included credits/month | $${plan.purchased_credit_price_usd}/purchased credit | ${plan.acquisition_enabled ? "available" : "unavailable"}`;
+}
+async function handlePlans(options) {
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  const payload = await client.billing.targetPlans();
+  const listedCurrentPlan = payload.plans.find(
+    (plan) => plan.sku === payload.current_plan_sku
+  );
+  const currentPlan = await _asyncNullishCoalesce(listedCurrentPlan, async () => ( (await client.billing.targetStatus()).plan));
+  const lines = [
+    `Current plan: ${currentPlan.name} (${currentPlan.sku}) | ${planPriceText(currentPlan.recurring_price_usd, currentPlan.interval)} | ${_nullishCoalesce(currentPlan.included_credits, () => ( "(unknown)"))} included credits/month`,
+    `Pending plan: ${_nullishCoalesce(payload.pending_plan_sku, () => ( "none"))}`,
+    `Plan changes: ${payload.acquisition_enabled ? "enabled" : "disabled"}`,
+    ...payload.plans.length === 0 ? ["Plans: none available"] : ["Plans:", ...payload.plans.map(targetPlanLine)],
+    "Change plan: deepline billing change-plan <plan_sku> --json"
+  ];
+  const legacyPayload = _chunk7D6QG5KFjs.shouldEmitJson.call(void 0, options.json) ? await client.billing.plans() : null;
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ..._nullishCoalesce(legacyPayload, () => ( payload)),
+      ...legacyPayload ? { target_billing: payload } : {},
+      render: { sections: [{ title: "billing plans", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleSubscribe(planVersionId, options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.request(
+    "/api/v2/billing/subscription/checkout",
+    {
+      method: "POST",
+      body: { plan_version_id: planVersionId }
+    }
+  );
+  const url = String(payload.checkout_url || "");
+  if (!options.json && options.open !== false && url) _chunk7D6QG5KFjs.openInBrowser.call(void 0, url);
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing subscribe",
+            lines: [url || "Subscription checkout session created."]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleSubscriptionStatus(options) {
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  const payload = await client.billing.subscription.status();
+  const pools = _nullishCoalesce(payload.credit_pools, () => ( []));
+  const lines = [
+    `Plan: ${_nullishCoalesce(payload.plan_name, () => ( "(unknown)"))} (${_nullishCoalesce(payload.plan_version_id, () => ( "(unknown)"))})`,
+    `Subscribed: ${payload.subscribed ? "yes" : "no"}`,
+    ...payload.cancel_at_period_end ? [
+      `Cancellation scheduled: ends ${_nullishCoalesce(payload.current_period_end, () => ( "(unknown)"))} at period end (credits are kept)`
+    ] : [],
+    `Price: ${planPriceText(payload.price_usd, payload.price_interval)}`,
+    `Monthly grant: ${_nullishCoalesce(payload.monthly_grant_credits, () => ( 0))} credits`,
+    `Pooled credits remaining: ${_nullishCoalesce(payload.pooled_credits_remaining, () => ( 0))}`,
+    ...pools.length === 0 ? ["Credit pools: none"] : [
+      "Credit pools:",
+      ...pools.map(
+        (pool) => `${_nullishCoalesce(pool.pool, () => ( "(unknown)"))} | ${_nullishCoalesce(pool.credits_remaining, () => ( 0))}/${_nullishCoalesce(pool.credits_granted, () => ( 0))} credits remaining | ${_nullishCoalesce(pool.source, () => ( "(unknown)"))}`
+      )
+    ],
+    `Assigned by: ${_nullishCoalesce(payload.assigned_by, () => ( "default"))}`
+  ];
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: { sections: [{ title: "billing subscription", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleSubscriptionCancel(options) {
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  const action = options.undo ? "undo_cancel" : "cancel";
+  if (options.dryRun) {
+    const status = await client.billing.subscription.status();
+    if (!status.subscribed) {
+      reportBillingFailure(
+        {
+          exitCode: 4,
+          code: "NO_ACTIVE_SUBSCRIPTION",
+          message: "This workspace has no active subscription to cancel.",
+          next: SUBSCRIPTION_STATUS_NEXT_COMMAND
+        },
+        options
+      );
+      return;
+    }
+    const consequence = action === "cancel" ? `Would schedule cancellation at period end${status.current_period_end ? ` (${status.current_period_end})` : ""}. The subscription stays active until then and remaining credits are kept.` : "Would reverse the pending cancellation; the subscription would renew normally.";
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        dry_run: true,
+        action,
+        plan_version_id: status.plan_version_id,
+        plan_name: status.plan_name,
+        cancel_at_period_end: status.cancel_at_period_end,
+        current_period_end: status.current_period_end,
+        consequence,
+        planned_request: {
+          method: "POST",
+          path: SUBSCRIPTION_CANCEL_PATH,
+          body: { action }
+        },
+        render: {
+          sections: [
+            {
+              title: "billing subscription cancel (dry run)",
+              lines: [
+                `Plan: ${status.plan_name} (${status.plan_version_id})`,
+                `Planned request: POST ${SUBSCRIPTION_CANCEL_PATH} {"action":"${action}"}`,
+                consequence,
+                "No request was sent. Re-run without --dry-run to apply."
+              ]
+            }
+          ]
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  let result;
+  try {
+    result = await client.billing.subscription.cancel({
+      undo: Boolean(options.undo)
+    });
+  } catch (error) {
+    const failure = billingFailureFromError(error, {
+      notFoundCode: "NO_ACTIVE_SUBSCRIPTION"
+    });
+    if (!failure) throw error;
+    reportBillingFailure(failure, options);
+    return;
+  }
+  const lines = options.undo ? [
+    "Pending cancellation reversed; the subscription will renew normally.",
+    `Subscription: ${result.subscription_id}`
+  ] : [
+    `Cancellation scheduled for subscription ${result.subscription_id}.`,
+    `The subscription stays active until ${_nullishCoalesce(result.current_period_end, () => ( "the end of the current billing period"))}, then cancels at period end.`,
+    "Remaining credits are yours to keep \u2014 cancellation never removes credits.",
+    "Undo with: deepline billing subscription cancel --undo"
+  ];
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ok: true,
+      ...result,
+      render: {
+        sections: [{ title: "billing subscription cancel", lines }]
+      }
+    },
+    { json: options.json }
+  );
+}
+function invoiceAmountText(amountCents, currency) {
+  const value = (Number(_nullishCoalesce(amountCents, () => ( 0))) / 100).toFixed(2);
+  return String(_nullishCoalesce(currency, () => ( "usd"))).toLowerCase() === "usd" ? `$${value}` : `${value} ${String(currency).toUpperCase()}`;
+}
+function invoiceDateText(createdAt) {
+  return String(_nullishCoalesce(createdAt, () => ( ""))).slice(0, 10);
+}
+function invoiceLine(entry, compact) {
+  const amount = invoiceAmountText(entry.amount_cents, entry.currency);
+  const link = _nullishCoalesce(entry.url, () => ( "(no link)"));
+  if (compact) {
+    return [
+      entry.id,
+      invoiceDateText(entry.created_at),
+      amount,
+      entry.status,
+      link
+    ].join(" | ");
+  }
+  return [
+    invoiceDateText(entry.created_at),
+    entry.description,
+    amount,
+    entry.status,
+    link
+  ].join(" | ");
+}
+async function handleInvoices(options) {
+  let limit;
+  if (options.limit !== void 0) {
+    limit = Number.parseInt(options.limit, 10);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+      reportBillingFailure(
+        {
+          exitCode: 2,
+          code: "INVALID_LIMIT",
+          message: "--limit must be an integer between 1 and 100."
+        },
+        options
+      );
+      return;
+    }
+  }
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  let payload;
+  try {
+    payload = await client.billing.invoices.list(
+      limit === void 0 ? void 0 : { limit }
+    );
+  } catch (error) {
+    const failure = billingFailureFromError(error, {
+      notFoundCode: "NOT_FOUND"
+    });
+    if (!failure) throw error;
+    reportBillingFailure(failure, options);
+    return;
+  }
+  const entries = Array.isArray(payload.entries) ? payload.entries : [];
+  const compact = Boolean(options.compact);
+  const header = compact ? "id | date | amount | status | link" : "date | description | amount | status | link";
+  const lines = entries.length === 0 ? ["No invoices or receipts yet."] : [header, ...entries.map((entry) => invoiceLine(entry, compact))];
+  const envelope = compact ? {
+    org_id: payload.org_id,
+    count: entries.length,
+    entries: entries.map((entry) => ({
+      id: entry.id,
+      date: invoiceDateText(entry.created_at),
+      amount: invoiceAmountText(entry.amount_cents, entry.currency),
+      status: entry.status,
+      url: entry.url
+    }))
+  } : { ...payload, count: entries.length };
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...envelope,
+      render: { sections: [{ title: "billing invoices", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleCheckout(options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.post(
+    "/api/v2/billing/checkout",
+    {
+      ...options.tier ? { tierId: options.tier } : {},
+      ...options.credits ? { credits: Number.parseInt(options.credits, 10) } : {},
+      ...options.discountCode ? { discountCode: options.discountCode } : {}
+    }
+  );
+  const url = String(payload.url || payload.checkout_url || "");
+  if (!options.json && !options.noOpen && url) _chunk7D6QG5KFjs.openInBrowser.call(void 0, url);
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing checkout",
+            lines: [url || "Checkout session created."]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleTopUp(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer Deepline credit amount.",
+        next: "deepline billing plans --json"
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = topUpIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        dry_run: true,
+        credits,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "POST",
+          path: BILLING_TOP_UP_PATH,
+          body: { credits, idempotency_key: idempotencyKey }
+        },
+        render: {
+          sections: [
+            {
+              title: "billing top-up (dry run)",
+              lines: [
+                `Credits: ${credits}`,
+                `Idempotency key: ${idempotencyKey}`,
+                `Planned request: POST ${BILLING_TOP_UP_PATH}`,
+                "No payment request was sent. Re-run without --dry-run to apply."
+              ]
+            }
+          ]
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  let payload;
+  try {
+    payload = await client.billing.topUpWithReceipt({
+      credits,
+      idempotencyKey
+    });
+  } catch (error) {
+    const failure = billingTopUpFailureFromError(error, {
+      credits,
+      idempotencyKey
+    });
+    if (!failure) throw error;
+    reportBillingFailure(failure, options);
+    return;
+  }
+  if (payload.status === "pending") {
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        ...payload,
+        idempotency_key: idempotencyKey,
+        next: topUpRetryCommand(credits, idempotencyKey),
+        render: {
+          sections: [
+            {
+              title: "billing top-up pending",
+              lines: [
+                `Requested: ${payload.requested_credits} Deepline Credits`,
+                "Payment is still being confirmed. Credits have not been reported as added.",
+                `Operation: ${payload.operation_id}`,
+                `Retry with the same key: ${topUpRetryCommand(credits, idempotencyKey)}`
+              ]
+            }
+          ]
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const amountText = invoiceAmountText(payload.amount_cents, payload.currency);
+  const appliedCredits = "applied_credits" in payload ? payload.applied_credits : payload.credits;
+  const paymentMethod = "payment_method" in payload ? payload.payment_method : void 0;
+  const paymentLabel = _nullishCoalesce(_optionalChain([paymentMethod, 'optionalAccess', _8 => _8.label]), () => ( [
+    _optionalChain([paymentMethod, 'optionalAccess', _9 => _9.brand]) ? humanize(paymentMethod.brand) : null,
+    _optionalChain([paymentMethod, 'optionalAccess', _10 => _10.last4]) ? `ending in ${paymentMethod.last4}` : null
+  ].filter(Boolean).join(" ")));
+  const compactEnvelope = {
+    ok: true,
+    credits: appliedCredits,
+    amount_cents: payload.amount_cents,
+    currency: payload.currency,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
+    ..."operation_id" in payload ? {
+      status: payload.status,
+      operation_id: payload.operation_id,
+      operation_state: payload.operation_state
+    } : {},
+    idempotency_key: idempotencyKey
+  };
+  const fullEnvelope = {
+    ...payload,
+    ok: true,
+    credits: appliedCredits,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
+    idempotency_key: idempotencyKey,
+    render: {
+      sections: [
+        {
+          title: "billing top-up",
+          lines: [
+            `Added: ${appliedCredits} Deepline Credits`,
+            `Charged: ${amountText}`,
+            ...typeof payload.balance === "number" ? [`Balance: ${payload.balance} Deepline Credits`] : ["Balance: unavailable; check deepline billing balance."],
+            ...paymentLabel ? [`Payment method: ${paymentLabel}`] : []
+          ]
+        }
+      ]
+    }
+  };
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, options.compact ? compactEnvelope : fullEnvelope, {
+    json: options.json
+  });
+}
+async function handleTargetStatus(options) {
+  const client = new (0, _chunk2C3AVPTYjs.DeeplineClient)();
+  const payload = await client.billing.targetStatus();
+  const balanceCommand = "deepline billing balance --json";
+  const recentChargesCommand = "deepline billing usage --limit 5 --json";
+  const exactChargeCommand = "deepline billing usage --request-id <job_id> --json";
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ok: true,
+      ...payload,
+      next: {
+        balance: balanceCommand,
+        recentCharges: recentChargesCommand,
+        chargeByJobId: exactChargeCommand
+      },
+      render: {
+        sections: [
+          {
+            title: "billing status",
+            lines: [
+              `Plan: ${payload.plan.name} (${payload.plan.sku})`,
+              `State: ${payload.state}`,
+              `Payment: ${payload.payment_state}`,
+              `Automatic recharge: ${payload.recharge_state}`,
+              `Balance: ${balanceCommand}`,
+              `Recent charges: ${recentChargesCommand}`,
+              `Charge for a tool job: ${exactChargeCommand}`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeStatus(options) {
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.autoRecharge.get();
+  const state = payload.available ? payload.enabled ? "on" : "off" : "unavailable";
+  const lines = [
+    `State: ${state}`,
+    ...payload.threshold_credits !== null ? [`Threshold: ${payload.threshold_credits} credits`] : [],
+    ...payload.refill_to_credits !== null ? [`Refill balance to: ${payload.refill_to_credits} credits`] : [],
+    ...payload.purchase_limit_credits != null ? [
+      `Automatic credit purchase cap: ${payload.purchase_limit_credits} credits per rolling 30 days`
+    ] : []
+  ];
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ok: true,
+      ...payload,
+      render: { sections: [{ title: "automatic recharge", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeSet(options) {
+  const thresholdCredits = parseTopUpCredits(options.thresholdCredits);
+  const refillToCredits = parseTopUpCredits(options.refillToCredits);
+  const rollingLimitCents = options.purchaseLimitCents === void 0 ? void 0 : options.purchaseLimitCents === "none" ? null : Number(options.purchaseLimitCents);
+  const rollingLimitCredits = options.purchaseLimitCredits === void 0 ? void 0 : options.purchaseLimitCredits === "none" ? null : Number(options.purchaseLimitCredits);
+  if (rollingLimitCredits != null && (!Number.isSafeInteger(rollingLimitCredits) || rollingLimitCredits < 0)) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_AUTO_RECHARGE_CONFIGURATION",
+        message: "--purchase-limit-credits must be a nonnegative whole number of credits or none."
+      },
+      options
+    );
+    return;
+  }
+  if (rollingLimitCents !== void 0 && rollingLimitCents !== null && (!Number.isSafeInteger(rollingLimitCents) || rollingLimitCents <= 0)) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_AUTO_RECHARGE_CONFIGURATION",
+        message: "--purchase-limit-cents must be a positive whole number of USD cents or none."
+      },
+      options
+    );
+    return;
+  }
+  if (thresholdCredits === null || refillToCredits === null || refillToCredits <= thresholdCredits) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_AUTO_RECHARGE_CONFIGURATION",
+        message: "--threshold-credits and --refill-to-credits must be positive whole credits, and refill-to must be greater."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: {
+            enabled: true,
+            threshold_credits: thresholdCredits,
+            refill_to_credits: refillToCredits,
+            ...rollingLimitCents !== void 0 ? { purchase_limit_cents: rollingLimitCents } : {},
+            ...rollingLimitCredits !== void 0 ? { purchase_limit_credits: rollingLimitCredits } : {}
+          }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.autoRecharge.update({
+    enabled: true,
+    thresholdCredits,
+    refillToCredits,
+    ...rollingLimitCents !== void 0 ? { purchaseLimitCents: rollingLimitCents } : {},
+    ...rollingLimitCredits !== void 0 ? { purchaseLimitCredits: rollingLimitCredits } : {},
+    idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeOff(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: { enabled: false }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.autoRecharge.update({
+    enabled: false,
+    idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleBuyCredits(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.purchaseCredits({
+    credits,
+    idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTopUpRecover(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer."
+      },
+      options
+    );
+    return;
+  }
+  const failure = !_optionalChain([options, 'access', _11 => _11.orgId, 'optionalAccess', _12 => _12.trim, 'call', _13 => _13()]) || options.orgId !== options.orgId.trim() ? {
+    code: "INVALID_ORG_ID",
+    message: "--org-id must be the original workspace ID without surrounding whitespace."
+  } : !options.idempotencyKey || options.idempotencyKey.length > 200 || options.idempotencyKey !== options.idempotencyKey.trim() ? {
+    code: "INVALID_BILLING_IDEMPOTENCY_KEY",
+    message: "--idempotency-key must be the original key (1\u2013200 characters without surrounding whitespace)."
+  } : null;
+  if (failure) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        ...failure
+      },
+      options
+    );
+    return;
+  }
+  if (options.dryRun) {
+    _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+      {
+        ok: true,
+        dry_run: true,
+        method: "POST",
+        path: "/api/v2/billing/credit-purchases/recover",
+        idempotency_key: options.idempotencyKey,
+        body: { credits, org_id: options.orgId }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.recoverCreditPurchase({
+    credits,
+    orgId: options.orgId,
+    idempotencyKey: options.idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: options.idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlan(planSku, options) {
+  if (planSku !== "payg-v1" && planSku !== "builder-v1" && planSku !== "growth-v1" && // Retained Canary requests may replay their original operation. The API
+  // rejects new acquisition even when a caller supplies an idempotency key.
+  !(planSku === "growth-canary-v1" && options.idempotencyKey) && planSku !== "team-v1") {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_PLAN",
+        message: "Plan must be payg-v1, builder-v1, growth-v1, or team-v1."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.transitionPlan({
+    action: "start_or_change",
+    targetPlanSku: planSku,
+    ...options.billingEmail ? { billingEmail: options.billingEmail } : {},
+    idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlanCancellation(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.transitionPlan({
+    action: options.undo ? "undo_cancel" : "cancel",
+    idempotencyKey
+  });
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPortal(options) {
+  const payload = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.portalSession(
+    options.billingAddress ? { flow: "customer_update" } : void 0
+  );
+  if (!options.json && !options.noOpen) _chunk7D6QG5KFjs.openInBrowser.call(void 0, payload.url);
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, { ok: true, ...payload }, { json: options.json });
+}
+async function handleRedeemCode(code, options) {
+  const { http } = _chunk7D6QG5KFjs.getAuthedHttpClient.call(void 0, );
+  const payload = await http.post(
+    "/api/v2/billing/checkout",
+    {
+      discountCode: code
+    }
+  );
+  const url = String(payload.url || payload.checkout_url || "");
+  if (!options.json && !options.noOpen && url) _chunk7D6QG5KFjs.openInBrowser.call(void 0, url);
+  _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      render: {
+        sections: [{ title: "billing code", lines: [url || "Code redeemed."] }]
+      }
+    },
+    { json: options.json }
+  );
+}
+function registerBillingCommands(program) {
+  const billing = program.command("billing").description("See your plan and credits, buy more, and manage billing.").addHelpText(
+    "after",
+    `
+Concepts:
+  Billing commands show Deepline credits, not raw provider spend.
+  Balance is shared by the workspace; concurrent work changes it. Use a job_id
+  charge lookup to attribute one tool command instead of comparing balances.
+  checkout/subscribe/redeem-code can open a browser unless --no-open is set.
+
+Examples:
+  # See where you stand
+  deepline billing balance --json
+  deepline billing usage --limit 20 --json
+  deepline billing plans --json
+  deepline billing subscription status --json
+
+  # Price a tool before execution; look up its exact charge afterward
+  deepline tools describe <tool-id> --pricing-only
+  deepline billing usage --request-id <job_id> --json
+
+  # Buy credits or a plan
+  deepline billing top-up 1000 --json
+  deepline billing checkout --credits 1000 --no-open --json
+  deepline billing subscribe runtime-395-2026-07-v1 --no-open --json
+  deepline billing redeem-code --code ABC123 --no-open --json
+
+  # Manage
+  deepline billing subscription cancel --dry-run --json
+  deepline billing set-limit 500 --json
+
+  # Records
+  deepline billing invoices --limit 12 --json
+  deepline billing history --time 1m --json
+  deepline billing ledger export all --json
+`
+  );
+  billing.command("balance").description("Show current billing balance.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Shows the current Deepline credit balance for the active workspace.
+  The balance includes concurrent workspace activity, so a before/after difference
+  cannot isolate one command. Use billing usage --request-id <job_id> --json.
+
+Examples:
+  deepline billing balance
+  deepline billing balance --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleBalance);
+  billing.command("usage").description("Show current usage plus recent calls.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Shows last-30-day Deepline credit usage plus a bounded recent-call
+  page. Use --limit/--cursor to paginate the recent-call section.
+  For one tool command, use the job_id returned by tools execute, or its next.billing
+  command. Pending charges and temporary holds are not final spend; unknown means
+  final charge evidence is unavailable. Workspace balance changes include other work.
+
+Examples:
+  deepline billing usage
+  deepline billing usage --limit 50 --cursor <next_cursor> --json
+  deepline billing usage --run-id play/example/run/20260630t120000-000-abcdef --json
+  deepline billing usage --request-id <job_id> --json
+`
+  ).option("--limit <n>", "Recent-call page size").option("--offset <n>", "Recent-call offset").option(
+    "--cursor <cursor>",
+    "Recent-call cursor from the previous response"
+  ).option("--run-id <run_id>", "Show recent usage for one play run").option(
+    "--request-id <job_id>",
+    "Show the exact Deepline charge for one execution job_id"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleUsage);
+  billing.command("limit").description("Show configured monthly usage cap.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Shows whether monthly workspace usage cap is enabled.
+  New calls are checked against this usage cap, separately from wallet funding.
+
+Examples:
+  deepline billing limit
+  deepline billing limit --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleLimit);
+  billing.command("set-limit").description("Set monthly usage cap.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace billing settings. The argument is a Deepline credit amount,
+  not dollars and not provider credits. New calls are checked against the cap;
+  in-flight work can still finish and exceed it. Buying credits does not reset it.
+
+Examples:
+  deepline billing set-limit 500
+  deepline billing set-limit 500 --json
+`
+  ).argument("<credits>", "Monthly credits limit").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSetLimit);
+  billing.command("off").description("Disable monthly usage cap.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace billing settings by removing monthly Deepline usage cap.
+
+Examples:
+  deepline billing off
+  deepline billing off --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleLimitOff);
+  billing.command("ledger").description("Inspect and export billing ledger rows.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Exports every ledger row for the active workspace, including rows
+  created without an API key.
+
+Examples:
+  deepline billing ledger export all
+  deepline billing ledger export all --output ./ledger.csv
+  deepline billing ledger export all --run-id play/demo/run/abc123
+  deepline billing ledger export all --operation limadata_find_audience_identifiers --since 2026-09-01T00:00:00Z
+  deepline billing ledger export all --json
+`
+  ).addCommand(
+    new (0, _commander.Command)("export").description("Export billing ledger rows.").addHelpText(
+      "after",
+      `
+Examples:
+  deepline billing ledger export all
+`
+    ).addCommand(
+      new (0, _commander.Command)("all").description("Export all available billing ledger rows to CSV.").addHelpText(
+        "after",
+        `
+Notes:
+  Pages through the workspace ledger, writes CSV locally,
+  then reports the row count and the net delta computed from delta_credits.
+
+Examples:
+  deepline billing ledger export all
+  deepline billing ledger export all --json
+`
+      ).option("--output <path>", "Write CSV to an explicit path").option("--run-id <run_id>", "Export ledger rows for one play run.").option("--operation <id>", "Export rows for one tool operation.").option(
+        "--since <timestamp>",
+        "Only export rows since ISO-8601 time or Unix milliseconds."
+      ).option(
+        "--json",
+        "Emit JSON output. Also automatic when stdout is piped"
+      ).action(handleLedgerExportAll)
+    )
+  );
+  billing.command("history").description("Export billing ledger history to CSV.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only server query that writes a local CSV file. With --json, stdout is a
+  summary containing the output path, row count, and completeness metadata.
+  Exports the complete window using bounded pages. For an exact start timestamp:
+  deepline billing ledger export all --since <ISO-8601> --json
+
+Examples:
+  deepline billing history --time 1m
+  deepline billing history --time 1y --json
+`
+  ).requiredOption("--time <window>", "Rolling time window: 1d, 1w, 1m, or 1y").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleHistory);
+  billing.command("checkout").description(
+    "Create a checkout session and optionally open it in your browser."
+  ).addHelpText(
+    "after",
+    `
+Notes:
+  Creates a payment checkout session. Opens the checkout URL in a browser unless
+  --no-open is set. Use --json for automation.
+
+Examples:
+  deepline billing checkout --tier pro
+  deepline billing checkout --credits 1000 --no-open --json
+  deepline billing checkout --credits 1000 --discount-code LAUNCH --no-open
+`
+  ).option("--tier <tierId>", "Named pricing tier").option("--credits <credits>", "Custom credit amount").option("--discount-code <code>", "Apply a discount code").option("--no-open", "Print the checkout URL without opening a browser").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleCheckout);
+  billing.command("top-up").description("Charge the saved payment method and add Deepline credits.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace billing by charging the saved payment method for the active
+  workspace, then adding purchased Deepline credits. If no saved payment method
+  is available, use the checkout command printed in the error response.
+  --dry-run prints the planned request and idempotency key without charging.
+
+Examples:
+  deepline billing top-up 1000
+  deepline billing top-up 1000 --json
+  deepline billing top-up 1000 --dry-run --json
+  deepline billing top-up 1000 --idempotency-key refill-2026-07-08 --json
+`
+  ).argument("<credits>", "Positive integer Deepline credit amount").option(
+    "--idempotency-key <key>",
+    "Stable retry key for the same intended top-up"
+  ).option("--dry-run", "Print the planned top-up without charging").option("--compact", "Keep only high-signal fields in JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleTopUp);
+  billing.command("buy").description("Buy credits through the target billing contract.").argument("<credits>", "Positive integer Deepline credit amount").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleBuyCredits);
+  billing.command("top-up-recover").description(
+    "Inspect or retire an original top-up intent without starting a payment."
+  ).argument("<credits>", "Original positive integer Deepline credit amount").requiredOption(
+    "--org-id <original-org>",
+    "Original workspace ID (must match the authenticated workspace)"
+  ).requiredOption(
+    "--idempotency-key <original-key>",
+    "Original purchase key; never generates a new key"
+  ).option("--dry-run", "Print the recovery request without changing state").option("--json", "Emit JSON output. Also automatic when stdout is piped").addHelpText(
+    "after",
+    "\nAn absent intent is durably retired; an existing operation is returned unchanged.\nThis command never starts a payment. Use the original amount, workspace, and key.\nExample:\n  deepline billing top-up-recover 1000 --org-id org_original --idempotency-key original-purchase-key --json\n"
+  ).action(handleTopUpRecover);
+  billing.command("status").description(
+    "Show plan, payment, and recharge state; use usage for charges."
+  ).option("--json", "Emit JSON output").action(handleTargetStatus);
+  billing.command("auto-recharge").description("Inspect and manage automatic Deepline credit recharge.").addHelpText(
+    "after",
+    `
+Examples:
+  deepline billing auto-recharge status --json
+  deepline billing auto-recharge set --threshold-credits 1000 --refill-to-credits 3500 --dry-run --json
+  deepline billing auto-recharge off --dry-run --json
+`
+  ).addCommand(
+    new (0, _commander.Command)("status").description("Show the canonical automatic recharge configuration.").option("--json", "Emit JSON output").action(handleAutoRechargeStatus)
+  ).addCommand(
+    new (0, _commander.Command)("set").description(
+      "Enable automatic recharge with a threshold and refill target."
+    ).requiredOption(
+      "--threshold-credits <credits>",
+      "Recharge when the balance reaches this amount"
+    ).requiredOption(
+      "--refill-to-credits <credits>",
+      "Recharge the balance to this amount"
+    ).addOption(
+      new (0, _commander.Option)(
+        "--purchase-limit-cents <cents>",
+        "Deprecated: converted to credits"
+      ).hideHelp()
+    ).option(
+      "--purchase-limit-credits <credits>",
+      "Limit automatic credit purchases over rolling 30 days (or none to remove)"
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeSet)
+  ).addCommand(
+    new (0, _commander.Command)("off").description(
+      "Disable automatic recharge without clearing saved amounts."
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeOff)
+  ).addCommand(
+    new (0, _commander.Command)("trigger").description(
+      "Evaluate capped automatic recharge and resume any pending purchase."
+    ).option("--json", "Emit JSON output").action(async (options) => {
+      const result = await new (0, _chunk2C3AVPTYjs.DeeplineClient)().billing.autoRecharge.trigger();
+      _chunk7D6QG5KFjs.printCommandEnvelope.call(void 0, { ok: true, ...result }, { json: options.json });
+    })
+  );
+  billing.command("change-plan").description("Start or change the target billing plan.").argument("<plan_sku>", "payg-v1, builder-v1, growth-v1, or team-v1").option(
+    "--billing-email <email>",
+    "Invoice recipient when the account has no billing email"
+  ).option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlan);
+  billing.command("cancel-plan").description("Cancel a target subscription at period end, or undo it.").option("--undo", "Undo a pending period-end cancellation").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlanCancellation);
+  billing.command("portal").description("Open the Stripe-hosted billing recovery portal.").option("--billing-address", "Open the billing address editor directly").option("--no-open", "Print the URL without opening a browser").option("--json", "Emit JSON output").action(handleTargetPortal);
+  billing.command("plans").description("Show published plans and the plan you are on.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Shows the current target billing plan, pending plan, and every
+  visible plan's recurring price, included credits, purchased-credit price,
+  and current acquisition availability. All amounts are Deepline credits and
+  Deepline-facing USD, never raw provider spend. Change to an available plan
+  with: deepline billing change-plan <plan_sku>
+
+Examples:
+  deepline billing plans
+  deepline billing plans --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handlePlans);
+  billing.command("subscribe").description(
+    "Start a subscription checkout for a plan and optionally open it in your browser."
+  ).addHelpText(
+    "after",
+    `
+Notes:
+  Creates a Stripe subscription checkout session for the given plan version.
+  Opens the checkout URL in a browser unless --no-open is set. Fails loudly
+  with the server error when subscription checkout is not enabled or the plan
+  is not open for subscription.
+
+Examples:
+  deepline billing subscribe runtime-395-2026-07-v1
+  deepline billing subscribe runtime-395-2026-07-v1 --no-open --json
+`
+  ).argument("<plan_version_id>", "Legacy billing plan version id").option("--no-open", "Print the checkout URL without opening a browser").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSubscribe);
+  billing.command("subscription").description("Inspect and manage subscription state for the workspace.").addHelpText(
+    "after",
+    `
+Examples:
+  deepline billing subscription status
+  deepline billing subscription status --json
+  deepline billing subscription cancel --dry-run
+  deepline billing subscription cancel --json
+  deepline billing subscription cancel --undo --json
+`
+  ).addCommand(
+    new (0, _commander.Command)("status").description("Show active plan, subscription state, and credit pools.").addHelpText(
+      "after",
+      `
+Notes:
+  Read-only. Shows the active plan, whether a Stripe subscription backs it,
+  scheduled cancellation state, and remaining Deepline credits per grant pool.
+
+Examples:
+  deepline billing subscription status
+  deepline billing subscription status --json
+`
+    ).option(
+      "--json",
+      "Emit JSON output. Also automatic when stdout is piped"
+    ).action(handleSubscriptionStatus)
+  ).addCommand(
+    new (0, _commander.Command)("cancel").description("Cancel the subscription at period end. Credits are kept.").addHelpText(
+      "after",
+      `
+Notes:
+  Mutates subscription state. Cancellation is always AT PERIOD END: the
+  subscription stays active until the end of the paid cycle and remaining
+  Deepline credits are kept \u2014 cancellation never removes credits. --undo
+  reverses a pending cancellation before the period ends. --dry-run reads
+  subscription status and prints the planned mutation without calling the
+  cancel endpoint.
+
+Exit codes:
+  0  cancellation scheduled (or reversed with --undo)
+  3  auth error
+  4  no active subscription to cancel
+  5  Stripe/server failure (the server message is preserved)
+
+Examples:
+  deepline billing subscription cancel --dry-run
+  deepline billing subscription cancel
+  deepline billing subscription cancel --undo
+  deepline billing subscription cancel --json
+`
+    ).option("--undo", "Reverse a pending cancellation before period end").option(
+      "--dry-run",
+      "Print the planned cancellation without calling the cancel endpoint"
+    ).option(
+      "--json",
+      "Emit JSON output. Also automatic when stdout is piped"
+    ).action(handleSubscriptionCancel)
+  );
+  billing.command("invoices").description("List subscription invoices and credit purchase receipts.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Shows customer-facing billing history from Stripe, newest first:
+  subscription invoices plus one-time Deepline credit purchase receipts, with
+  Stripe-hosted links. Amounts are what you paid \u2014 never provider spend.
+  --compact keeps id/date/amount/status/url only.
+
+Examples:
+  deepline billing invoices
+  deepline billing invoices --limit 12 --json
+  deepline billing invoices --compact --json
+`
+  ).option("--limit <n>", "Maximum entries to return (1-100, default 24)").option("--compact", "Keep only id, date, amount, status, and url").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleInvoices);
+  billing.command("redeem-code").description("Redeem a billing code.").addHelpText(
+    "after",
+    `
+Notes:
+  Redeems a workspace billing code and may open a browser for completion unless
+  --no-open is set.
+
+Examples:
+  deepline billing redeem-code --code ABC123
+  deepline billing redeem-code --code ABC123 --no-open --json
+`
+  ).requiredOption("--code <code>", "Code to redeem").option("--no-open", "Do not open a browser").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(({ code, ...options }) => handleRedeemCode(code, options));
+}
+
+
+
+exports.registerBillingCommands = registerBillingCommands; exports.targetBillingIdempotencyKey = targetBillingIdempotencyKey;