@oxygen-agent/cli 1.1013.38 → 1.1013.61

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.1013.38
+Version: 1.1013.61

package/dist/command-manifest.js

@@ -113,6 +113,7 @@ const MUTATING_COMMANDS = new Set([
     // Creates an approval or Checkout link; a first plan's Checkout can start the
     // first-month offer window. The plan changes only after an admin confirms.
     "billing change",
+    "billing retain",
     // --approved records a domain's renewal exit, or with --revoke resumes renewals.
     "managed-inboxes exit",
     // A default preview is free; approval restores provider seats and billing.

package/dist/index.js

@@ -11652,11 +11652,12 @@ Examples:
     }))
         .addCommand(new Command("cancel")
         .description("Turn off subscription renewal. For a yearly commitment paid monthly, remaining monthly payments continue through commitment_ends_at; the plan stays usable until then. Other plans end at their paid period or trial end with no further subscription renewal charge. This command costs no Oxygen credits. Separately funded external resources keep renewing; preview `workspace infrastructure-exit` to end those too. Prints the end date; undo before then with billing resume.")
+        .option("--comment <text>", "Written cancellation feedback (1–2,000 characters).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("billing cancel", options, () => requestOxygen("/api/cli/billing/cancel", {
             method: "POST",
-            body: { action: "cancel" },
+            body: { action: "cancel", ...(options.comment !== undefined ? { comment: options.comment } : {}) },
         }));
     }))
         .addCommand(new Command("resume")
@@ -11667,6 +11668,19 @@ Examples:
             method: "POST",
             body: { action: "resume" },
         }));
+    }))
+        .addCommand(new Command("retention-offer")
+        .description("Preview a one-month discount before cancelling your monthly subscription. Reports eligibility, the next invoice price and normal price. Reads only; no discount is applied.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("billing retention-offer", options, () => requestOxygen("/api/cli/billing/cancel", { method: "POST", body: { action: "offer" } }));
+    }))
+        .addCommand(new Command("retain")
+        .description("Stay subscribed with the one-month retention discount from billing retention-offer. Restores renewal if cancellation was scheduled. No charge today; the normal price returns afterwards.")
+        .requiredOption("--offer <id>", "The offer_id from the retention offer preview.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("billing retain", options, () => requestOxygen("/api/cli/billing/cancel", { method: "POST", body: { action: "retain", offer_id: options.offer } }));
     }))
         .addCommand(new Command("topup")
         .description("Buy a custom amount of on-demand credits. Run without an amount to see the current price per 100 credits (`usd_per_100_credits`), the allowed range and the packs; checkout happens in Stripe, the price is shown before you pay, and purchased credits never expire. Plan credits cost less. `usd_per_1k_credits` is a deprecated name for the same per-100 price, not a price per 1,000 credits.")
@@ -18402,7 +18416,7 @@ Examples:
         });
     })))
         .addCommand(new Command("update")
-        .description("Update a sending mailbox's rich-content profile: the From display name and/or the HTML signature appended to its sends. Pass an empty string ('') to clear a field. Consumes no Oxygen credits. <mailbox> accepts a mailbox id or email address.")
+        .description("Update a sending mailbox's rich-content profile: the From display name and/or the HTML signature appended to its sends. An email that already contains the signature gets no second copy. Pass an empty string ('') to clear a field. Consumes no Oxygen credits. <mailbox> accepts a mailbox id or email address.")
         .argument("<mailbox>", "Mailbox id or email address.")
         .option("--display-name <name>", "From display name (e.g. \"Ada from Acme\"). Pass '' to clear it.")
         .option("--signature-html <html>", "HTML signature appended to every send from this mailbox. Pass '' to clear it.")

package/node_modules/@oxygen/shared/dist/capability-discovery.js

@@ -102,7 +102,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         gatewayCommands: ["billing balance", "billing usage", "billing audit", "billing estimate", "budget list", "billing invoices", "pricing customer-credit-prices"],
         skills: ["oxygen-gtm", "oxygen-diagnostics"],
         endpointSections: ["billing", "budget", "limits", "pricing"],
-        intentTerms: ["billing", "credits", "credit balance", "customer credit prices", "credit price catalog", "usage", "spend", "cost", "cost estimate", "monthly cost", "budget", "subscription", "invoice", "vat", "vat number", "tax id", "cancel plan", "change plan", "upgrade", "downgrade", "subscription plans", "annual plan", "yearly commitment", "yearly saving", "annual discount"],
+        intentTerms: ["billing", "credits", "credit balance", "customer credit prices", "credit price catalog", "usage", "spend", "cost", "cost estimate", "monthly cost", "budget", "subscription", "invoice", "vat", "vat number", "tax id", "cancel plan", "change plan", "upgrade", "downgrade", "subscription plans", "annual plan", "yearly commitment", "yearly saving", "annual discount", "retention offer", "cancellation reason", "winback discount"],
     },
     {
         id: "support-and-feedback",
@@ -1043,7 +1043,7 @@ function routeCardFor(card, query) {
         card = { ...card, posture: "read_only", execution: providerRead.execution };
     const spendRead = card.id === "billing-and-budgets" && !providerRead ? spendBreakdownRecommendation(query) : null;
     if (spendRead)
-        card = { ...card, posture: "read_only", execution: spendRead.execution };
+        card = { ...card, posture: "mixed", execution: spendRead.execution };
     const blockRead = card.primitive === "sequences" ? sendingBlockReadRecommendation(query) : null;
     if (blockRead)
         card = { ...card, posture: "read_only", execution: blockRead.execution };
@@ -1512,10 +1512,24 @@ function tableRowRemovalRecommendation(query) {
 }
 /** Reads of grid values/state are separate from executing or resolving actions. */
 function tableReadRecommendation(query) {
-    if (!/\btables?\b/.test(query) || isFunctionIntent(query) || isSecondPartyDecisionIntent(query)
+    if (isFunctionIntent(query) || isSecondPartyDecisionIntent(query)
         || /\b(workflows?|agents?|actions?|items?|retry|resolve|effects?|imports?|webhooks?|feeds?|enrich\w*|create|add|insert|upsert|update|delete|remove|rename|hide|archive|columns? run)\b/.test(query)
         || /\b(run|execute|start|cancel)\s+(?:(?:the|my|these)\s+)?(?:columns?|table|enrichment)\b/.test(query))
         return null;
+    // An explicit order over existing labels reads rows; it does not classify
+    // them or create a rank column. The column-only wording also names Tables.
+    if (/\b(tables?|rows?|columns?)\b/.test(query)
+        && /\b(sort(?:s|ed|ing)?|order(?:s|ed|ing)?|rank(?:s|ed|ing)?)\b/.test(query)
+        && /\b(custom|explicit)\b/.test(query)
+        && /\b(labels?|values?|priority|select|options?)\b/.test(query)
+        && !/\b(classif\w*|categori[sz]\w*|tag(?:ging)?|assign|set|change|edit|reorder\w*|mov(?:e|es|ed|ing)|sav(?:e|es|ed|ing)|configur(?:e|es|ed|ing)|calculat(?:e|es|ed|ing)|scor(?:e|es|ed|ing)|enroll\w*|send\w*|sequences?|campaigns?)\b/.test(query)
+        && !/\b(do not|don't|avoid|without)\s+(sort|order|rank)\w*\b/.test(query))
+        return {
+            tools: ["oxygen_tables_query", "oxygen_tables_describe"], commands: ["tables query", "tables describe"],
+            execution: "Raw tables query supports sorts[].valueOrder (alias value_order) for an explicit label order. Inspect the Table's column keys and query schema first. Values are trimmed/lowercased and deduplicated; asc puts listed values first and unlisted/null last, desc reverses. An empty list uses ordinary sorting. Keep the same sorts when following its cursor. format=grid rejects sorts; rows-page and saved-view sort formats have separate schemas. This read does not classify rows or run columns.",
+        };
+    if (!/\btables?\b/.test(query))
+        return null;
     if (/\bcells?\b/.test(query) && /\b(history|changes?|provenance)\b/.test(query))
         return {
             tools: ["oxygen_tables_cell_history", "oxygen_tables_cell_inspect"], commands: ["cells history", "cells inspect"],
@@ -1763,7 +1777,7 @@ function spendBreakdownRecommendation(query) {
         return null;
     return {
         tools: ["oxygen_billing_audit", "oxygen_billing_usage"], commands: ["billing audit", "billing usage"],
-        execution: "Read where managed credits went with oxygen_billing_audit: spend_by_category ranks each area's credits and share of managed_credits_spent, largest first, over the whole window; group_by provider, tool, model, run or workspace narrows it. Spent is reserved minus released in the window; it differs from captured (oxygen_billing_usage's managed_credits_used) by holds still open and holds settling across the window edge, so do not attribute the whole gap to open holds. External MCP uses oxygen_capabilities_call; built-in agents invoke the native capability. Reads cost 0 credits.",
+        execution: "Read where managed credits went with oxygen_billing_audit: spend_by_category ranks each area's credits and share of managed_credits_spent, largest first, over the whole window; group_by provider, tool, model, run or workspace narrows it. Spent is reserved minus released in the window; it differs from captured (oxygen_billing_usage's managed_credits_used) by holds still open and holds settling across the window edge, so do not attribute the whole gap to open holds. External MCP uses oxygen_capabilities_call; built-in agents invoke the native capability. Reports cost 0 credits; billing audit may apply due plan grants or credit expiry.",
     };
 }
 function sendingBlockReadRecommendation(query) {
@@ -1789,10 +1803,16 @@ function isSpintaxIntent(query) {
     return /\b(wording|copy|message|draft|subject(?: line)?)\b.{0,45}\b(variations?|variants?|paraphrase|rewrite)\b/.test(query)
         || /\b(paraphrase|rewrite|variations?)\b.{0,45}\b(wording|copy|message|draft|subject(?: line)?)\b/.test(query);
 }
+function isSubscriptionRetentionIntent(query) {
+    return /\b(retention offer|win[ -]?back discount|cancellation (?:reason|feedback)|written cancellation)\b/.test(query)
+        || /\b(stay|cancel|cancelling)\b/.test(query) && /\b(discount|next month|subscription reason)\b/.test(query);
+}
 function explicitCapabilityIntent(query) {
     // Importing an AI answer is GEO evidence, rather than a Table file import.
     if (/\b(?:geo|aeo|ai (?:(?:search|answer) )?visibility|consumer ai answers?|answer engine optimization|generative engine optimization)\b/.test(query))
         return ROUTE_BY_ID.get("geo") ?? null;
+    if (isSubscriptionRetentionIntent(query))
+        return ROUTE_BY_ID.get("billing-and-budgets") ?? null;
     if (isConnectionPriceIntent(query))
         return ROUTE_BY_ID.get("billing-and-budgets") ?? null;
     if (sentLinkedInInvitationReadRecommendation(query))
@@ -2142,6 +2162,9 @@ function recommendationsFor(card, query) {
     const spendRead = card.id === "billing-and-budgets" ? spendBreakdownRecommendation(query) : null;
     if (spendRead)
         return spendRead;
+    if (card.id === "billing-and-budgets" && isSubscriptionRetentionIntent(query)) {
+        return { tools: ["oxygen_billing_cancel"], commands: ["billing retention-offer", "billing cancel", "billing retain"] };
+    }
     if (card.id === "billing-and-budgets" && isConnectionPriceIntent(query)) {
         return {
             tools: ["oxygen_billing_commitments"],

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1013.38";
+export declare const OXYGEN_BUILD_VERSION = "1.1013.61";

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.1013.38";
+export const OXYGEN_BUILD_VERSION = "1.1013.61";

package/package.json

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