@oxygen-agent/cli 1.1011.622 → 1.1011.626

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.1011.622
+Version: 1.1011.626

package/dist/http-client.js

@@ -135,7 +135,22 @@ path, options = {}) {
     finally {
         timeout.cancel();
     }
-    const envelope = await readEnvelope(response);
+    const envelope = await readEnvelope(response).catch((error) => {
+        // A gateway answered instead of OXYGEN: the request may still be running or
+        // may have finished. Say so, with what is needed to check, instead of
+        // calling the gateway's page an invalid envelope.
+        if (!(error instanceof OxygenError) || ![502, 503, 504].includes(response.status))
+            throw error;
+        throw new OxygenError("invalid_response", `Oxygen API did not answer in time (HTTP ${response.status}); the outcome is unknown.`, {
+            details: {
+                status: response.status,
+                trace_id: response.headers.get("x-oxygen-trace-id") ?? traceId,
+                ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {}),
+                ...(method === "GET" ? {} : { next_step: UNCONFIRMED_WRITE_NEXT_STEP }),
+            },
+            exitCode: 1,
+        });
+    });
     const compatibility = readEnvelopeCompatibility(envelope);
     const failed = !response.ok || !envelope.ok;
     try {

package/dist/index.js

@@ -7227,7 +7227,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .alias("get")
         .description("Describe a workspace table and its columns. Add --stats for row count and per-column fill rates (0 credits). Next: `tools search --for-table <table>` lists what these columns can be enriched with and what each costs per row (0 credits).")
         .argument("<table>", "Table id or slug.")
-        .option("--include-archived", "Include archived columns.")
+        .option("--include-archived", "Include archived columns, and read a table that is archived, scheduled for deletion or being purged.")
         .option("--stats", "Include stats.rowCount (also summary.rowCount) and per-column fill rates. Row count is exact; above 100 rows fill rates use a 100-row sample (stats.statsSampled). For whole-table fill rates on a bigger list use `tables preview <table> --summary-only` \u2014 exact up to 20,000 rows, 2,000-row sample above. 0 credits.")
         .option("--json", "Print a JSON envelope.")
         .action(async (table, options) => {
@@ -7295,9 +7295,9 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         }));
     }))
         .addCommand(new Command("delete")
-        .description("Delete workspace tables: archives now and schedules the physical purge (default 14 days; restorable via `tables restore` until then). --now purges immediately and permanently — it previews and refuses without --yes.")
+        .description("Delete workspace tables: archives now and schedules the physical purge (default 14 days; restorable via `tables restore` until then). --now purges immediately and permanently — it previews and refuses without --yes. A table with a large history answers `purging` and finishes in the background. Free — 0 Oxygen credits.")
         .argument("<tables...>", "Table ids or slugs.")
-        .option("--now", "Purge immediately instead of scheduling. Irreversible; single table only.")
+        .option("--now", "Purge immediately instead of scheduling. Irreversible; single table only. A large table finishes in the background.")
         .option("--yes", "Approve the immediate purge previewed by --now.")
         .option("--purge-after <days>", "Days until the scheduled purge runs. Defaults to 14; 0 purges on the next background sweep (sweeps visit each workspace every few minutes).")
         .option("--reason <text>", "Recorded with the delete for the audit trail.")
@@ -11210,7 +11210,7 @@ Examples:
     program
         .command("limits")
         .description("Plan-tier limits, spend-safety defaults, per-channel sending limits, and storage capacity posture.")
-        .addHelpText("after", "\nRun `oxygen limits show --json` to see your current plan's API and webhook rates, Table and workspace storage headroom, and the next scheduled change. The $999 and $1,999 rows-per-Table increases remain held until capacity testing passes.\n")
+        .addHelpText("after", "\nRun `oxygen limits show --json` to see your current plan's API and webhook rates, Table and workspace storage headroom, and the next scheduled change; `--section capacity` returns only storage, including which Table is full. The $999 and $1,999 rows-per-Table increases remain held until capacity testing passes.\n")
         .addCommand(addContractFlags(new Command("show")
         .description("Compare every plan size: price, monthly credits, volume bonus and price per 100 credits (`plan_bands`). Show your plan band and its limits beside every plan size's (API rate, webhook ingress, storage, import file size, columns per auto-run, signals feed, spend defaults incl. Agent and Copilot caps, fastest workflow schedule), the per-channel sending limits every plan shares (emails per mailbox, WhatsApp, LinkedIn, calls) and its workflow Code-step and run-attempt limits, plus Tables capacity usage naming the largest Table. Each plan size's storage says whether it is in force, scheduled to change on a date, or awaiting its rows-per-Table capacity test, with the values it moves to. `spend_safety_defaults.enterprise_agent_run_default` gives Enterprise the $1,999 band’s in-force Agent default with no contract override; `agent_run_approved_max_credits` is the maximum for an explicitly approved higher run. `spend_safety_defaults.applies_to` says what each spend default bounds: an unattended trigger delivery, a table auto-run batch, one Agent run, or the attended Copilot. `web_url` opens the same view in the web app (Settings → Plan limits), including any scheduled change. Read-only; spends no credits. Recovery: https://oxygen-agent.com/docs/safety/billing."), LIMITS_READ_QUERY_CONTRACT)
         .option("--json", "Print a JSON envelope.")

package/node_modules/@oxygen/shared/dist/version.generated.d.ts

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1011.622";
+export declare const OXYGEN_BUILD_VERSION = "1.1011.626";

package/node_modules/@oxygen/shared/dist/version.generated.js

@@ -1,2 +1,2 @@
 // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
-export const OXYGEN_BUILD_VERSION = "1.1011.622";
+export const OXYGEN_BUILD_VERSION = "1.1011.626";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.1011.622",
+  "version": "1.1011.626",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",