@oxygen-agent/cli 1.1013.27 → 1.1013.59

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.27
+Version: 1.1013.59

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.")

package/node_modules/@oxygen/cli-ugc/dist/commands.js

@@ -4,7 +4,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         .command("ugc")
         .description("Manage UGC programs and independent creator participations: voice, posts, approvals, sponsorship and bounded amplification. Requires UGC availability. Start with memberships list in a creator workspace. See the oxygen-ugc skill; JSON reads return web_url for inspection.");
     const groupDescriptions = {
-        programs: "Programs you operate or joined; discover public programs from other brands and apply to them. Lifecycle: create, update, duplicate (settings), archive (stops future work, keeps shared history, reversible with restore) and delete (permanent; only while no creator has ever joined).",
+        programs: "Programs you operate or joined; discover public programs from other brands and apply to or join them. Lifecycle: create, update, duplicate (settings), archive (stops future work, keeps shared history, reversible with restore) and delete (permanent; only while no creator has ever joined).",
         creators: "Creator participations: invite, set one creator's own posting deal, revoke an invite, accept in the creator workspace, connect a sender, change approval authority, or revoke.",
         memberships: "Active programs this creator workspace has joined, each with your deal (posting_target), this period's progress and your published posts. Your own numbers only. Read these before choosing a program for a personal post.",
         applications: "Applications to public programs: the ones you sent as a creator, or the ones your program received as a brand.",
@@ -83,9 +83,15 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         .action((options) => handle("ugc creators invitation", options, () => requestOxygen(`/api/cli/ugc?${new URLSearchParams({ view: "invitation", token: String(options.token) })}`)));
     group("programs")
         .command("discover")
-        .description("Public programs from every brand on Oxygen that you can apply to, with each brand's deal and brief excerpt, and whether you already joined or applied. Free, read-only.")
+        .description("Public programs from every brand on Oxygen that you can apply to, with each brand's deal, brief excerpt and join_policy (automatic: you join at once; approval: the brand decides), and whether you already joined or applied. Free, read-only.")
+        .option("--program-id <id>", "Only this program, e.g. the id in a join link (…/ugc?join=<id>).")
         .option("--json", "Print a JSON envelope.")
-        .action((options) => handle("ugc programs discover", options, () => requestOxygen("/api/cli/ugc?view=discover")));
+        .action((options) => handle("ugc programs discover", options, () => {
+        const query = new URLSearchParams({ view: "discover" });
+        if (options.programId)
+            query.set("program_id", String(options.programId));
+        return requestOxygen(`/api/cli/ugc?${query}`);
+    }));
     group("applications")
         .command("list")
         .description("Applications to public programs. Without --program-id: the ones this creator workspace sent, with status. With --program-id: the ones your program received (brand), pending first. Read-only.")
@@ -336,7 +342,13 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "visibility",
                     kind: "string",
-                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply and you approve).",
+                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply).",
+                    required: false,
+                },
+                {
+                    name: "join_policy",
+                    kind: "string",
+                    description: "Public programs only: approval (default: you approve each application) or automatic (creators join at once, from Discover or the program's join_url). automatic needs --visibility public.",
                     required: false,
                 },
             ],
@@ -397,7 +409,13 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "visibility",
                     kind: "string",
-                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply and you approve).",
+                    description: "private (invitation only; also turns automatic join off) or public (listed in every creator's Discover, where creators apply).",
+                    required: false,
+                },
+                {
+                    name: "join_policy",
+                    kind: "string",
+                    description: "approval (you approve each application) or automatic (creators join at once, from Discover or the program's join_url). automatic needs a public program. programs get shows join_policy and join_url.",
                     required: false,
                 },
                 {
@@ -544,10 +562,10 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         {
             action: "application_create",
             command: "programs apply",
-            description: "Apply to a public program from programs discover, with a short note to the brand. The brand approves or declines; approval makes you a creator in the program and emails you. Free: 0 credits.",
+            description: "Join or apply to a public program from programs discover or a join link: with join_policy automatic you join at once (joined: true, with your participation); otherwise the brand approves or declines (joined: false), and approval makes you a creator and emails you. Free: 0 credits.",
             fields: [
-                { name: "program_id", kind: "string", description: "Public program ID from programs discover.", required: true },
-                { name: "message", kind: "string", description: "Your note to the brand (up to 600 characters).", required: true },
+                { name: "program_id", kind: "string", description: "Public program ID from programs discover or a join link (…/ugc?join=<id>).", required: true },
+                { name: "message", kind: "string", description: "Your note to the brand (up to 600 characters). Required unless the program's join_policy is automatic.", required: false },
                 { name: "linkedin_url", kind: "string", description: "Your LinkedIn profile URL; passing it also saves it to your profile. Omit to use the one on your profile (ugc profile get); if neither exists, ask the person rather than guess.", required: false },
             ],
         },

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/ugc.d.ts

@@ -8,6 +8,13 @@ export type UgcPostingTarget = {
 };
 export declare const UGC_POSTING_TARGET_MAX = 100;
 export declare const UGC_POSTING_TARGET_PERIODS: readonly ["week", "month", "total"];
+/**
+ * How creators get into a public program (Tim, 2026-10-09): the brand approves
+ * each application, or an application joins at once. Private programs are
+ * joined by invitation only, so they are always `approval`.
+ */
+export declare const UGC_JOIN_POLICIES: readonly ["approval", "automatic"];
+export type UgcJoinPolicy = (typeof UGC_JOIN_POLICIES)[number];
 /**
  * The operator-written creator brief: one page, not a document (Philipp, 2026-09-23;
  * raised from 1,200 on 2026-09-29, when a natural founder brief ran 1,298 and blind
@@ -44,6 +51,8 @@ export type UgcProgram = {
     /** Posts each creator is expected to publish per period; both null when unset. */
     postingTargetCount?: number | null;
     postingTargetPeriod?: UgcPostingTargetPeriod | null;
+    /** How creators join while the program is public; older rows read as approval. */
+    joinPolicy?: UgcJoinPolicy;
     status: "active" | "archived";
     createdAt: Date;
     updatedAt: Date;

package/node_modules/@oxygen/shared/dist/ugc.js

@@ -1,5 +1,11 @@
 export const UGC_POSTING_TARGET_MAX = 100;
 export const UGC_POSTING_TARGET_PERIODS = ["week", "month", "total"];
+/**
+ * How creators get into a public program (Tim, 2026-10-09): the brand approves
+ * each application, or an application joins at once. Private programs are
+ * joined by invitation only, so they are always `approval`.
+ */
+export const UGC_JOIN_POLICIES = ["approval", "automatic"];
 /**
  * The operator-written creator brief: one page, not a document (Philipp, 2026-09-23;
  * raised from 1,200 on 2026-09-29, when a natural founder brief ran 1,298 and blind

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1013.27";
+export declare const OXYGEN_BUILD_VERSION = "1.1013.59";

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

package/package.json

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