deepline 0.3.461 → 0.3.463

package/dist/cli/{billing-6P5HO6QG.js → billing-6TJPNJQD.js}

@@ -1,11 +1,13 @@
 "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 _chunkSKU6ECIYjs = require('./chunk-SKU6ECIY.js');
 
 
-var _chunkMDJPEGVNjs = require('./chunk-MDJPEGVN.js');
+
+var _chunkUC4SFYNUjs = require('./chunk-UC4SFYNU.js');
 require('./chunk-E4CABWXL.js');
 require('./chunk-JKVRBCZL.js');
-require('./chunk-KXMNM4AQ.js');
+require('./chunk-NMU3VR5U.js');
 require('./chunk-XDVT3GOM.js');
 
 
@@ -13,8 +15,9 @@ require('./chunk-XDVT3GOM.js');
 
 
 
-var _chunk5MDIZX7Mjs = require('./chunk-5MDIZX7M.js');
-require('./chunk-YQDUODZW.js');
+var _chunk5LHXOIPTjs = require('./chunk-5LHXOIPT.js');
+require('./chunk-BGNWI3KH.js');
+require('./chunk-YGGIZ3VT.js');
 
 
 
@@ -23,7 +26,7 @@ require('./chunk-XNYIZMNQ.js');
 
 
 var _chunkDIAWYWT5js = require('./chunk-DIAWYWT5.js');
-require('./chunk-5FDKJQZE.js');
+require('./chunk-3BOIOCNX.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -72,7 +75,7 @@ function reportBillingFailure(failure, options) {
   if (failure.next) {
     textLines.push(`Next: ${failure.next}`);
   }
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: false,
       exitCode: failure.exitCode,
@@ -93,7 +96,7 @@ function parseTopUpCredits(raw) {
   return parsed;
 }
 function topUpIdempotencyKey(raw) {
-  return raw === void 0 ? `cli_topup:${Date.now()}:${_crypto.randomUUID.call(void 0, )}` : _chunkMDJPEGVNjs.requireBillingIdempotencyKey.call(void 0, raw);
+  return raw === void 0 ? `cli_topup:${Date.now()}:${_crypto.randomUUID.call(void 0, )}` : _chunkUC4SFYNUjs.requireBillingIdempotencyKey.call(void 0, raw);
 }
 function targetBillingIdempotencyKey(raw) {
   return typeof raw === "string" ? raw : `cli_target_billing:${Date.now()}:${_crypto.randomUUID.call(void 0, )}`;
@@ -312,7 +315,7 @@ function defaultLedgerExportPath() {
   );
 }
 async function handleBalance(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     "/api/v2/billing/balance"
   );
@@ -396,7 +399,7 @@ async function handleBalance(options) {
     ...options.verbose ? detail : [],
     ...lines.slice(1)
   ];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       ...recovery ? { recovery } : {},
@@ -419,8 +422,62 @@ async function handleBalance(options) {
 function quoteShellArgument(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
+async function handleUsageEvents(options) {
+  if (options.offset !== void 0 || options.requestId !== void 0) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_USAGE_EVENTS_OPTIONS",
+        message: "--events cannot be combined with --offset or --request-id. Use --cursor for event pages; omit --events for an exact charge lookup.",
+        next: "deepline billing usage --help"
+      },
+      options
+    );
+    return;
+  }
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
+  let payload;
+  try {
+    payload = await client.billing.usageEvents({
+      ...options.limit === void 0 ? {} : { limit: Number(options.limit) },
+      ...options.cursor === void 0 ? {} : { cursor: options.cursor },
+      ...options.runId === void 0 ? {} : { runId: options.runId }
+    });
+  } catch (error) {
+    if (error instanceof _chunkDIAWYWT5js.DeeplineError && error.code === "INVALID_USAGE_EVENTS_OPTIONS") {
+      reportBillingFailure(
+        {
+          exitCode: 2,
+          code: error.code,
+          message: error.message,
+          next: "deepline billing usage --help"
+        },
+        options
+      );
+      return;
+    }
+    throw error;
+  }
+  const nextPage = payload.next_cursor === null ? null : `deepline billing usage --events --cursor ${quoteShellArgument(payload.next_cursor)}${options.limit ? ` --limit ${options.limit}` : ""}${options.runId ? ` --run-id ${quoteShellArgument(options.runId)}` : ""}`;
+  const lines = [
+    `Usage events: ${payload.entries.length} in this page. Recorded credits are not final settlement evidence.`,
+    ...payload.entries.map(
+      (event) => `${event.provider}/${event.operation} | ${event.status} | ${event.credits === null ? "credits unknown" : `${event.credits} credits recorded`} | request=${event.request_id} | id=${_nullishCoalesce(event.id, () => ( "(unavailable)"))}`
+    ),
+    ...nextPage ? [`Next page: ${nextPage}`] : []
+  ];
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
+    {
+      ...payload,
+      next: { page: nextPage },
+      render: { sections: [{ title: "billing usage events", lines }] }
+    },
+    { json: options.json }
+  );
+}
 async function handleUsage(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  if (options.events) return handleUsageEvents(options);
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const params = new URLSearchParams();
   if (options.requestId !== void 0) {
     const requestId = options.requestId.trim();
@@ -501,7 +558,7 @@ async function handleUsage(options) {
       "No continuation is available for this view. Use deepline billing ledger export all for the full ledger."
     ] : []
   ];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       recent: {
@@ -515,7 +572,7 @@ async function handleUsage(options) {
   );
 }
 async function handleLimit(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.get(
     "/api/v2/billing/limit"
   );
@@ -523,7 +580,7 @@ async function handleLimit(options) {
     `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"];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: { sections: [{ title: "billing limit", lines }] }
@@ -532,12 +589,12 @@ async function handleLimit(options) {
   );
 }
 async function handleSetLimit(credits, options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.request("/api/v2/billing/limit", {
     method: "PUT",
     body: { monthly_credits_limit: Number.parseInt(credits, 10) }
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: {
@@ -553,11 +610,11 @@ async function handleSetLimit(credits, options) {
   );
 }
 async function handleLimitOff(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.request("/api/v2/billing/limit", {
     method: "DELETE"
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: {
@@ -577,7 +634,7 @@ async function exportLedger(http, outputPath, options) {
   let initialized = false;
   let pageNumber = 0;
   console.error(`Exporting billing ledger to ${outputPath}`);
-  for await (const entries of _chunkMDJPEGVNjs.iterateCursorPages.call(void 0, async (cursor) => {
+  for await (const entries of _chunkUC4SFYNUjs.iterateCursorPages.call(void 0, async (cursor) => {
     pageNumber += 1;
     console.error(
       `Fetching page ${pageNumber}; ${summary.row_count} rows written.`
@@ -616,7 +673,7 @@ async function exportLedger(http, outputPath, options) {
   return summary;
 }
 async function handleHistory(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const windows = {
     "1d": 86400,
     "1w": 604800,
@@ -628,10 +685,10 @@ async function handleHistory(options) {
     process.cwd(),
     "deepline",
     "data",
-    _chunk5MDIZX7Mjs.createTimestampedName.call(void 0, `billing-history-${options.time}`, "csv")
+    _chunk5LHXOIPTjs.createTimestampedName.call(void 0, `billing-history-${options.time}`, "csv")
   );
   const summary = await exportLedger(http, outputPath, { sinceAt });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       output_path: outputPath,
       row_count: summary.row_count,
@@ -668,14 +725,14 @@ async function handleLedgerExportAll(options) {
     );
     return;
   }
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.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
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       output_path: outputPath,
       row_count: summary.row_count,
@@ -714,7 +771,7 @@ 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, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   const payload = await client.billing.targetPlans();
   const listedCurrentPlan = payload.plans.find(
     (plan) => plan.sku === payload.current_plan_sku
@@ -727,8 +784,8 @@ async function handlePlans(options) {
     ...payload.plans.length === 0 ? ["Plans: none available"] : ["Plans:", ...payload.plans.map(targetPlanLine)],
     "Change plan: deepline billing change-plan <plan_sku>"
   ];
-  const legacyPayload = _chunk5MDIZX7Mjs.shouldEmitJson.call(void 0, options.json) ? await client.billing.plans() : null;
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  const legacyPayload = _chunk5LHXOIPTjs.shouldEmitJson.call(void 0, options.json) ? await client.billing.plans() : null;
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ..._nullishCoalesce(legacyPayload, () => ( payload)),
       ...legacyPayload ? { target_billing: payload } : {},
@@ -738,7 +795,7 @@ async function handlePlans(options) {
   );
 }
 async function handleSubscribe(planVersionId, options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.request(
     "/api/v2/billing/subscription/checkout",
     {
@@ -747,8 +804,8 @@ async function handleSubscribe(planVersionId, options) {
     }
   );
   const url = String(payload.checkout_url || "");
-  if (!options.json && options.open !== false && url) _chunk5MDIZX7Mjs.openInBrowser.call(void 0, url);
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  if (!options.json && options.open !== false && url) _chunk5LHXOIPTjs.openInBrowser.call(void 0, url);
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: {
@@ -764,7 +821,7 @@ async function handleSubscribe(planVersionId, options) {
   );
 }
 async function handleSubscriptionStatus(options) {
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   const payload = await client.billing.subscription.status();
   const pools = _nullishCoalesce(payload.credit_pools, () => ( []));
   const lines = [
@@ -784,7 +841,7 @@ async function handleSubscriptionStatus(options) {
     ],
     `Assigned by: ${_nullishCoalesce(payload.assigned_by, () => ( "default"))}`
   ];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: { sections: [{ title: "billing subscription", lines }] }
@@ -793,7 +850,7 @@ async function handleSubscriptionStatus(options) {
   );
 }
 async function handleSubscriptionCancel(options) {
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   const action = options.undo ? "undo_cancel" : "cancel";
   if (options.dryRun) {
     const status = await client.billing.subscription.status();
@@ -810,7 +867,7 @@ async function handleSubscriptionCancel(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.";
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         dry_run: true,
@@ -865,7 +922,7 @@ async function handleSubscriptionCancel(options) {
     "Remaining credits are yours to keep \u2014 cancellation never removes credits.",
     "Undo with: deepline billing subscription cancel --undo"
   ];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       ...result,
@@ -919,7 +976,7 @@ async function handleInvoices(options) {
       return;
     }
   }
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   let payload;
   try {
     payload = await client.billing.invoices.list(
@@ -948,7 +1005,7 @@ async function handleInvoices(options) {
       url: entry.url
     }))
   } : { ...payload, count: entries.length };
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...envelope,
       render: { sections: [{ title: "billing invoices", lines }] }
@@ -957,7 +1014,7 @@ async function handleInvoices(options) {
   );
 }
 async function handleCheckout(options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(
     "/api/v2/billing/checkout",
     {
@@ -967,8 +1024,8 @@ async function handleCheckout(options) {
     }
   );
   const url = String(payload.url || payload.checkout_url || "");
-  if (!options.json && !options.noOpen && url) _chunk5MDIZX7Mjs.openInBrowser.call(void 0, url);
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  if (!options.json && !options.noOpen && url) _chunk5LHXOIPTjs.openInBrowser.call(void 0, url);
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: {
@@ -1013,7 +1070,7 @@ async function handleTopUp(creditsRaw, options) {
     return;
   }
   if (options.dryRun) {
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         dry_run: true,
@@ -1043,7 +1100,7 @@ async function handleTopUp(creditsRaw, options) {
     );
     return;
   }
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   let payload;
   try {
     payload = await client.billing.topUpWithReceipt({
@@ -1060,7 +1117,7 @@ async function handleTopUp(creditsRaw, options) {
     return;
   }
   if (payload.status === "pending") {
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         ...payload,
@@ -1124,17 +1181,17 @@ async function handleTopUp(creditsRaw, options) {
       ]
     }
   };
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, options.compact ? compactEnvelope : fullEnvelope, {
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, options.compact ? compactEnvelope : fullEnvelope, {
     json: options.json
   });
 }
 async function handleTargetStatus(options) {
-  const client = new (0, _chunkMDJPEGVNjs.DeeplineClient)();
+  const client = new (0, _chunkSKU6ECIYjs.DeeplineClient)();
   const payload = await client.billing.targetStatus();
   const balanceCommand = "deepline billing balance";
   const recentChargesCommand = "deepline billing usage --limit 5";
   const exactChargeCommand = "deepline billing usage --request-id <job_id>";
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       ...payload,
@@ -1163,9 +1220,12 @@ async function handleTargetStatus(options) {
     { json: options.json }
   );
 }
+function formatAllowanceAmount(value) {
+  return Number(value.toFixed(2)).toLocaleString("en-US");
+}
 async function handleEntitlements(options) {
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.entitlements();
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.entitlements();
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       ...payload,
@@ -1175,12 +1235,17 @@ async function handleEntitlements(options) {
             title: "billing entitlements",
             lines: [
               `Plan: ${_nullishCoalesce(_optionalChain([payload, 'access', _11 => _11.plan, 'optionalAccess', _12 => _12.name]), () => ( "Legacy billing"))}`,
-              ...Object.entries(payload.benefits).map(
-                ([key, grant]) => `${key}: ${grant.status}, ${JSON.stringify(grant.value)}${grant.expiresAt === void 0 ? "" : `, expires ${new Date(grant.expiresAt).toISOString()}`}`
+              ...Object.entries(payload.benefits).flatMap(
+                ([key, grant]) => "value" in grant ? [
+                  `${key}: ${grant.status}, ${JSON.stringify(grant.value)}${grant.expiresAt === void 0 ? "" : `, expires ${new Date(grant.expiresAt).toISOString()}`}`
+                ] : []
               ),
               ...payload.benefits.peopleSearch ? [
                 `People search: ${payload.benefits.peopleSearch.usage.remaining} profiles remaining${payload.benefits.peopleSearch.usage.resetsAt === void 0 ? ` in ${payload.benefits.peopleSearch.usage.month} (UTC)` : `; resets ${new Date(payload.benefits.peopleSearch.usage.resetsAt).toISOString()}`}`
               ] : [],
+              ...payload.benefits.includedStorage ? [
+                `Included storage: ${formatAllowanceAmount(payload.benefits.includedStorage.usage.consumed)} of ${formatAllowanceAmount(payload.benefits.includedStorage.usage.limit)} GB stored (${payload.benefits.includedStorage.usage.measuredDay} UTC)`
+              ] : [],
               ...Object.entries(payload.effective_limits).map(
                 ([key, limit]) => `${key} rate: ${limit.effective}/minute (${limit.source}; plan baseline ${limit.baseline})`
               )
@@ -1193,7 +1258,7 @@ async function handleEntitlements(options) {
   );
 }
 async function handleAutoRechargeStatus(options) {
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.autoRecharge.get();
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.autoRecharge.get();
   const state = payload.available ? payload.enabled ? "on" : "off" : "unavailable";
   const lines = [
     `State: ${state}`,
@@ -1203,7 +1268,7 @@ async function handleAutoRechargeStatus(options) {
       `Automatic credit purchase cap: ${payload.purchase_limit_credits} credits per rolling 30 days`
     ] : []
   ];
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       ...payload,
@@ -1252,7 +1317,7 @@ async function handleAutoRechargeSet(options) {
   }
   const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
   if (options.dryRun) {
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         dry_run: true,
@@ -1273,7 +1338,7 @@ async function handleAutoRechargeSet(options) {
     );
     return;
   }
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.autoRecharge.update({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.autoRecharge.update({
     enabled: true,
     thresholdCredits,
     refillToCredits,
@@ -1281,7 +1346,7 @@ async function handleAutoRechargeSet(options) {
     ...rollingLimitCredits !== void 0 ? { purchaseLimitCredits: rollingLimitCredits } : {},
     idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     { ok: true, idempotency_key: idempotencyKey, ...payload },
     { json: options.json }
   );
@@ -1289,7 +1354,7 @@ async function handleAutoRechargeSet(options) {
 async function handleAutoRechargeOff(options) {
   const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
   if (options.dryRun) {
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         dry_run: true,
@@ -1304,11 +1369,11 @@ async function handleAutoRechargeOff(options) {
     );
     return;
   }
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.autoRecharge.update({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.autoRecharge.update({
     enabled: false,
     idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     { ok: true, idempotency_key: idempotencyKey, ...payload },
     { json: options.json }
   );
@@ -1327,11 +1392,11 @@ async function handleBuyCredits(creditsRaw, options) {
     return;
   }
   const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.purchaseCredits({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.purchaseCredits({
     credits,
     idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     { ok: true, idempotency_key: idempotencyKey, ...payload },
     { json: options.json }
   );
@@ -1367,7 +1432,7 @@ async function handleTopUpRecover(creditsRaw, options) {
     return;
   }
   if (options.dryRun) {
-    _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+    _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         dry_run: true,
@@ -1380,12 +1445,12 @@ async function handleTopUpRecover(creditsRaw, options) {
     );
     return;
   }
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.recoverCreditPurchase({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.recoverCreditPurchase({
     credits,
     orgId: options.orgId,
     idempotencyKey: options.idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     { ok: true, idempotency_key: options.idempotencyKey, ...payload },
     { json: options.json }
   );
@@ -1405,37 +1470,37 @@ async function handleTargetPlan(planSku, options) {
     return;
   }
   const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.transitionPlan({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.transitionPlan({
     action: "start_or_change",
     targetPlanSku: planSku,
     ...options.billingEmail ? { billingEmail: options.billingEmail } : {},
     idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.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, _chunkMDJPEGVNjs.DeeplineClient)().billing.transitionPlan({
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.transitionPlan({
     action: options.undo ? "undo_cancel" : "cancel",
     idempotencyKey
   });
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     { ok: true, idempotency_key: idempotencyKey, ...payload },
     { json: options.json }
   );
 }
 async function handleTargetPortal(options) {
-  const payload = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.portalSession(
+  const payload = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.portalSession(
     options.billingAddress ? { flow: "customer_update" } : void 0
   );
-  if (!options.json && !options.noOpen) _chunk5MDIZX7Mjs.openInBrowser.call(void 0, payload.url);
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, { ok: true, ...payload }, { json: options.json });
+  if (!options.json && !options.noOpen) _chunk5LHXOIPTjs.openInBrowser.call(void 0, payload.url);
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, { ok: true, ...payload }, { json: options.json });
 }
 async function handleRedeemCode(code, options) {
-  const { http } = _chunk5MDIZX7Mjs.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk5LHXOIPTjs.getAuthedHttpClient.call(void 0, );
   const payload = await http.post(
     "/api/v2/billing/checkout",
     {
@@ -1443,8 +1508,8 @@ async function handleRedeemCode(code, options) {
     }
   );
   const url = String(payload.url || payload.checkout_url || "");
-  if (!options.json && !options.noOpen && url) _chunk5MDIZX7Mjs.openInBrowser.call(void 0, url);
-  _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, 
+  if (!options.json && !options.noOpen && url) _chunk5LHXOIPTjs.openInBrowser.call(void 0, url);
+  _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, 
     {
       ...payload,
       render: {
@@ -1502,14 +1567,14 @@ Examples:
       if (!Number.isSafeInteger(quantity) || quantity <= 0) {
         throw new Error("--quantity must be a positive safe integer.");
       }
-      const quote = await new (0, _chunkMDJPEGVNjs.DeeplineClient)().billing.quote({
+      const quote = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.quote({
         quantity,
         sandbox_runtime: {
           timeout: options.sandboxTimeout,
           size: "standard"
         }
       });
-      _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, quote, {
+      _chunk5LHXOIPTjs.printCommandEnvelope.call(void 0, quote, {
         json: options.json,
         text: `Sandbox session ceiling: ${quote.maximum_credits} Deepline credits (${quote.quantity} session${quote.quantity === 1 ? "" : "s"}).
 ${quote.explanation}
@@ -1541,7 +1606,7 @@ Examples:
 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
+  For one tool call, use the billing command in the receipt deepline run printed, 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.
 
@@ -1550,8 +1615,17 @@ Examples:
   deepline billing usage --limit 50 --cursor <next_cursor>
   deepline billing usage --run-id play/example/run/20260630t120000-000-abcdef
   deepline billing usage --request-id <job_id>
+  deepline billing usage --events --run-id <run_id> --limit 100 --json
+
+  --events reads raw event history with entries and next_cursor, without merging
+  charges or ledger activity. Follow next_cursor until null, including empty
+  pages. Recorded event credits are not final settlement evidence. --offset and
+  --request-id cannot be combined with --events.
 `
-  ).option("--limit <n>", "Recent-call page size").option("--offset <n>", "Recent-call offset").option(
+  ).option(
+    "--events",
+    "Read a raw usage-event page instead of the billing summary"
+  ).option("--limit <n>", "Page size (1\u2013500 with --events)").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(
@@ -1739,8 +1813,8 @@ Examples:
     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, _chunkMDJPEGVNjs.DeeplineClient)().billing.autoRecharge.trigger();
-      _chunk5MDIZX7Mjs.printCommandEnvelope.call(void 0, { ok: true, ...result }, { json: options.json });
+      const result = await new (0, _chunkSKU6ECIYjs.DeeplineClient)().billing.autoRecharge.trigger();
+      _chunk5LHXOIPTjs.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(