@oxygen-agent/cli 1.1014.619 → 1.1014.771

package/dist/http-client.js

@@ -2,7 +2,7 @@ import { readGeoExportPagination } from "@oxygen/shared/geo";
 import { OXYGEN_VERSION, OxygenError, isCliResult, isVersionGreater, parseSemver, readEnvelopeCompatibility, vercelProtectionBypassHeaders, withRetryAfterDetails, } from "@oxygen/shared";
 import { randomUUID } from "node:crypto";
 import { cliDiagnosticHeaders, cliDiagnosticInvocation, recordCliDiagnosticRequest } from "./diagnostics.js";
-import { open, unlink } from "node:fs/promises";
+import { readBoundedBinaryResponse, streamBinaryResponse } from "./refactor-internals/binary-download.js";
 import { recordMutatingRequestAnswered, recoverFromCliFloorRejection } from "./auto-update.js";
 import { defaultApiUrl, loadCredentialsWithEndpoint } from "./credentials.js";
 import { assertResolvedApiUrl, cliEndpointDetails, describeCliEndpoint, isProdApiUrl, resolveCliUpdateGuidance, } from "./runtime.js";
@@ -200,75 +200,6 @@ path, options = {}) {
         recordMutatingRequestAnswered();
     return envelope.data;
 }
-async function readBoundedBinaryResponse(response, maxBytes) {
-    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > 50 * 1024 * 1024)
-        throw new OxygenError("invalid_request", "Invalid file download limit.");
-    const length = response.headers.get("content-length");
-    if (length && Number(length) > maxBytes)
-        throw new OxygenError("file_too_large", "The file exceeds its download limit.");
-    const reader = response.body?.getReader();
-    if (!reader)
-        throw new OxygenError("invalid_response", "The download had no body.");
-    const chunks = [];
-    let size = 0;
-    try {
-        for (;;) {
-            const { value, done } = await reader.read();
-            if (done)
-                break;
-            size += value.byteLength;
-            if (size > maxBytes)
-                throw new OxygenError("file_too_large", "The file exceeds its download limit.");
-            chunks.push(value);
-        }
-    }
-    finally {
-        await reader.cancel();
-    }
-    const bytes = new Uint8Array(size);
-    let offset = 0;
-    for (const chunk of chunks) {
-        bytes.set(chunk, offset);
-        offset += chunk.byteLength;
-    }
-    return bytes;
-}
-async function streamBinaryResponse(response, output) {
-    let file;
-    try {
-        file = await open(output, "wx");
-    }
-    catch (error) {
-        await response.body?.cancel();
-        if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
-            throw new OxygenError("output_exists", "The output file already exists. Choose another --output path.", { exitCode: 2 });
-        }
-        throw error;
-    }
-    const reader = response.body?.getReader();
-    let bytes = 0;
-    try {
-        if (!reader)
-            throw new OxygenError("invalid_response", "The download had no body.");
-        for (;;) {
-            const chunk = await reader.read();
-            if (chunk.done)
-                break;
-            await file.writeFile(chunk.value);
-            bytes += chunk.value.byteLength;
-        }
-        await file.close();
-        return { path: output, bytes };
-    }
-    catch (error) {
-        await file.close().catch(() => { });
-        await unlink(output).catch(() => { });
-        throw error;
-    }
-    finally {
-        await reader?.cancel().catch(() => { });
-    }
-}
 export async function ensureFreshCliForApiUrl(apiUrl, options = {}) {
     const checkKey = `${apiUrl}|${OXYGEN_VERSION}`;
     if (cliCompatibilityCheckKeys.has(checkKey))

package/dist/index.js

@@ -214,7 +214,7 @@ export function createProgram() {
     const billingDocsUrl = oxygenDocsUrl(defaultApiUrl(), "/safety/billing");
     program
         .name(binaryName)
-        .description("Revenue infrastructure for B2B startups — agent-operated GTM: tables, enrichment, sequences, workflows, CRM, knowledge. Everything here also runs in the web app and over MCP; every state-changing action returns a web_url deep-link.")
+        .description("The agentic GTM platform for B2B GTM teams: tables, enrichment, sequences, workflows, CRM, knowledge. Everything here also runs in the web app and over MCP; every state-changing action returns a web_url deep-link.")
         .version(OXYGEN_VERSION)
         .option("--pretty", "Indent JSON for human reading; omit for compact agent output.")
         .option("--profile <name>", "Use a stored CLI profile for this command.")

package/dist/refactor-internals/binary-download.d.ts

@@ -0,0 +1,5 @@
+export declare function readBoundedBinaryResponse(response: Response, maxBytes: number): Promise<Uint8Array>;
+export declare function streamBinaryResponse(response: Response, output: string): Promise<{
+    path: string;
+    bytes: number;
+}>;

package/dist/refactor-internals/binary-download.js

@@ -0,0 +1,71 @@
+import { OxygenError } from "@oxygen/shared/cli-result";
+import { open, unlink } from "node:fs/promises";
+export async function readBoundedBinaryResponse(response, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > 50 * 1024 * 1024)
+        throw new OxygenError("invalid_request", "Invalid file download limit.");
+    const length = response.headers.get("content-length");
+    if (length && Number(length) > maxBytes)
+        throw new OxygenError("file_too_large", "The file exceeds its download limit.");
+    const reader = response.body?.getReader();
+    if (!reader)
+        throw new OxygenError("invalid_response", "The download had no body.");
+    const chunks = [];
+    let size = 0;
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            size += value.byteLength;
+            if (size > maxBytes)
+                throw new OxygenError("file_too_large", "The file exceeds its download limit.");
+            chunks.push(value);
+        }
+    }
+    finally {
+        await reader.cancel();
+    }
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}
+export async function streamBinaryResponse(response, output) {
+    let file;
+    try {
+        file = await open(output, "wx");
+    }
+    catch (error) {
+        await response.body?.cancel();
+        if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
+            throw new OxygenError("output_exists", "The output file already exists. Choose another --output path.", { exitCode: 2 });
+        }
+        throw error;
+    }
+    const reader = response.body?.getReader();
+    let bytes = 0;
+    try {
+        if (!reader)
+            throw new OxygenError("invalid_response", "The download had no body.");
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            await file.writeFile(chunk.value);
+            bytes += chunk.value.byteLength;
+        }
+        await file.close();
+        return { path: output, bytes };
+    }
+    catch (error) {
+        await file.close().catch(() => { });
+        await unlink(output).catch(() => { });
+        throw error;
+    }
+    finally {
+        await reader?.cancel().catch(() => { });
+    }
+}

package/node_modules/@oxygen/formula/dist/evaluate.js

@@ -1,5 +1,5 @@
 import { OxygenError } from "@oxygen/shared/cli-result";
-import { isRecord } from "./coerce.js";
+import { evaluateNoveltyScore } from "./refactor-internals/novelty-score.js";
 import { CROSS_ROW_FUNCTIONS, parseFormulaExpression, } from "./expression.js";
 import { FORMULA_FUNCTION_REGISTRY, checkFormulaFunctionArity, compareFormulaValues, formulaExpressionError, formulaValuesEqual, readFormulaNumber, toFormulaBoolean, } from "./formula-functions.js";
 export function evaluateFormulaInScope(expression, scope, options = {}) {
@@ -86,11 +86,7 @@ function evaluateCrossRowFunction(input) {
             exitCode: 1,
         });
     }
-    const cellValue = stringifyNoveltyValue(readOptionalValue(input.scope, targetColumnKey));
-    if (!cellValue)
-        return null;
-    const noveltyScore = computeNoveltyScore(cellValue, corpus);
-    return Math.round(noveltyScore * 10_000) / 10_000;
+    return evaluateNoveltyScore(readOptionalValue(input.scope, targetColumnKey), corpus);
 }
 /**
  * Cross-row functions take a column key, not an in-scope identifier: a column
@@ -117,82 +113,6 @@ function readCrossRowColumnArg(node, functionName) {
         function: functionName,
     });
 }
-function stringifyNoveltyValue(value) {
-    if (value === null || value === undefined)
-        return "";
-    if (typeof value === "string")
-        return value.trim();
-    if (typeof value === "number" || typeof value === "boolean")
-        return String(value).trim();
-    if (Array.isArray(value)) {
-        return value
-            .map((entry) => stringifyNoveltyValue(entry))
-            .filter((entry) => entry.length > 0)
-            .join(" ")
-            .trim();
-    }
-    if (isRecord(value)) {
-        const preferred = value.body ?? value.text ?? value.email ?? value.message;
-        if (typeof preferred === "string")
-            return preferred.trim();
-        return JSON.stringify(value);
-    }
-    return "";
-}
-const NOVELTY_SHINGLE_SIZE = 5;
-function computeNoveltyScore(cellValue, corpus) {
-    const cellShingles = buildShingleSet(cellValue);
-    if (cellShingles.size === 0)
-        return 1;
-    let maxOverlap = 0;
-    let skippedSelfMatch = false;
-    for (const other of corpus) {
-        if (other === cellValue && !skippedSelfMatch) {
-            skippedSelfMatch = true;
-            continue;
-        }
-        const otherShingles = buildShingleSet(other);
-        if (otherShingles.size === 0)
-            continue;
-        const overlap = jaccardSimilarity(cellShingles, otherShingles);
-        if (overlap > maxOverlap)
-            maxOverlap = overlap;
-    }
-    const novelty = 1 - maxOverlap;
-    if (novelty < 0)
-        return 0;
-    if (novelty > 1)
-        return 1;
-    return novelty;
-}
-function buildShingleSet(value) {
-    const normalized = value
-        .toLowerCase()
-        .replace(/[^a-z0-9\s]/g, " ")
-        .replace(/\s+/g, " ")
-        .trim();
-    const tokens = normalized ? normalized.split(" ") : [];
-    const shingles = new Set();
-    if (tokens.length < NOVELTY_SHINGLE_SIZE) {
-        if (tokens.length > 0)
-            shingles.add(tokens.join(" "));
-        return shingles;
-    }
-    for (let i = 0; i <= tokens.length - NOVELTY_SHINGLE_SIZE; i += 1) {
-        shingles.add(tokens.slice(i, i + NOVELTY_SHINGLE_SIZE).join(" "));
-    }
-    return shingles;
-}
-function jaccardSimilarity(left, right) {
-    let intersection = 0;
-    const [smaller, larger] = left.size <= right.size ? [left, right] : [right, left];
-    for (const entry of smaller) {
-        if (larger.has(entry))
-            intersection += 1;
-    }
-    const union = left.size + right.size - intersection;
-    return union === 0 ? 0 : intersection / union;
-}
 function evaluateUnary(operator, value) {
     switch (operator) {
         case "+":

package/node_modules/@oxygen/formula/dist/refactor-internals/novelty-score.d.ts

@@ -0,0 +1,2 @@
+/** Score a value against a supplied column corpus, excluding one exact self row. */
+export declare function evaluateNoveltyScore(value: unknown, corpus: readonly string[]): number | null;

package/node_modules/@oxygen/formula/dist/refactor-internals/novelty-score.js

@@ -0,0 +1,87 @@
+// Corpus scoring is independent of scope resolution, expression dispatch and
+// corpus availability errors. The evaluator owns those host-facing contracts.
+import { isRecord } from "../coerce.js";
+/** Score a value against a supplied column corpus, excluding one exact self row. */
+export function evaluateNoveltyScore(value, corpus) {
+    const cellValue = stringifyNoveltyValue(value);
+    if (!cellValue)
+        return null;
+    const noveltyScore = computeNoveltyScore(cellValue, corpus);
+    return Math.round(noveltyScore * 10_000) / 10_000;
+}
+function stringifyNoveltyValue(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value.trim();
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value).trim();
+    if (Array.isArray(value)) {
+        return value
+            .map((entry) => stringifyNoveltyValue(entry))
+            .filter((entry) => entry.length > 0)
+            .join(" ")
+            .trim();
+    }
+    if (isRecord(value)) {
+        const preferred = value.body ?? value.text ?? value.email ?? value.message;
+        if (typeof preferred === "string")
+            return preferred.trim();
+        return JSON.stringify(value);
+    }
+    return "";
+}
+const NOVELTY_SHINGLE_SIZE = 5;
+function computeNoveltyScore(cellValue, corpus) {
+    const cellShingles = buildShingleSet(cellValue);
+    if (cellShingles.size === 0)
+        return 1;
+    let maxOverlap = 0;
+    let skippedSelfMatch = false;
+    for (const other of corpus) {
+        if (other === cellValue && !skippedSelfMatch) {
+            skippedSelfMatch = true;
+            continue;
+        }
+        const otherShingles = buildShingleSet(other);
+        if (otherShingles.size === 0)
+            continue;
+        const overlap = jaccardSimilarity(cellShingles, otherShingles);
+        if (overlap > maxOverlap)
+            maxOverlap = overlap;
+    }
+    const novelty = 1 - maxOverlap;
+    if (novelty < 0)
+        return 0;
+    if (novelty > 1)
+        return 1;
+    return novelty;
+}
+function buildShingleSet(value) {
+    const normalized = value
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const tokens = normalized ? normalized.split(" ") : [];
+    const shingles = new Set();
+    if (tokens.length < NOVELTY_SHINGLE_SIZE) {
+        if (tokens.length > 0)
+            shingles.add(tokens.join(" "));
+        return shingles;
+    }
+    for (let i = 0; i <= tokens.length - NOVELTY_SHINGLE_SIZE; i += 1) {
+        shingles.add(tokens.slice(i, i + NOVELTY_SHINGLE_SIZE).join(" "));
+    }
+    return shingles;
+}
+function jaccardSimilarity(left, right) {
+    let intersection = 0;
+    const [smaller, larger] = left.size <= right.size ? [left, right] : [right, left];
+    for (const entry of smaller) {
+        if (larger.has(entry))
+            intersection += 1;
+    }
+    const union = left.size + right.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}

package/node_modules/@oxygen/shared/dist/billing.d.ts

@@ -532,12 +532,12 @@ export declare const ANNUAL_BILLING_MONTHS_CHARGED = 10;
 export declare function annualPlanPriceCents(monthlyPriceCents: number): number;
 /** How often a plan Price bills. Credits are granted monthly on both. */
 export type PlanBillingInterval = "month" | "year";
-/** Commitment and payment frequency are separate: annual commitments bill monthly. */
+/** Commitment and payment frequency are separate for legacy annual installments. */
 export type PlanCommitmentTerm = "month" | "year";
 export declare const ANNUAL_MONTHLY_TERMS_VERSION = "2026-10-02";
 export declare function annualMonthlyPriceCents(monthlyPriceCents: number): number;
-/** Read-only comparison; annual totals reflect twelve rounded monthly payments. */
-export declare function purchasablePlanComparison(annualMonthlyAvailable: boolean): {
+/** Read-only comparison of monthly payments and the full prepaid annual charge. */
+export declare function purchasablePlanComparison(annualAvailable: boolean): {
     plan_key: "oxygen_199" | "oxygen_1999" | "oxygen_49" | "oxygen_499" | "oxygen_99" | "oxygen_999";
     currency: string;
     monthly_credits: number;
@@ -552,10 +552,22 @@ export declare function purchasablePlanComparison(annualMonthlyAvailable: boolea
         billing_interval: string;
         commitment_months: number;
         total_payment_cents: number;
+        monthly_equivalent_cents: number;
         saving_cents: number;
         prices_before_tax: boolean;
     } | null;
 }[];
+export declare const ANNUAL_PLAN_TERMS: {
+    readonly billing_interval: "year";
+    readonly commitment_months: 12;
+    readonly payment: "Full discounted year charged upfront, then annually.";
+    readonly credits_granted: "monthly_during_paid_year";
+    readonly credit_schedule: "The first monthly slice starts with the paid annual period once payment is confirmed. Later slice windows start on that period's UTC day and time each month, clamped to the month's last day. These are scheduled boundaries, not guaranteed processing times.";
+    readonly cancellation: "Stops annual renewal; access and monthly credits continue through the paid year.";
+    readonly switch_from_monthly: "Starts at the next paid-period boundary.";
+    readonly downgrades_or_switch_to_monthly: "Take effect at the paid year end.";
+};
+/** Historical terms retained for existing installment subscriptions only. */
 export declare const ANNUAL_MONTHLY_PLAN_TERMS: {
     readonly terms_version: "2026-10-02";
     readonly commitment_months: 12;

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

@@ -1063,29 +1063,41 @@ export const ANNUAL_MONTHLY_TERMS_VERSION = "2026-10-02";
 export function annualMonthlyPriceCents(monthlyPriceCents) {
     return Math.round(annualPlanPriceCents(monthlyPriceCents) / 12);
 }
-/** Read-only comparison; annual totals reflect twelve rounded monthly payments. */
-export function purchasablePlanComparison(annualMonthlyAvailable) {
+/** Read-only comparison of monthly payments and the full prepaid annual charge. */
+export function purchasablePlanComparison(annualAvailable) {
     return PURCHASABLE_PLAN_KEYS.map((key) => {
         const plan = resolveBasePricingPlan(key);
         const monthly = plan.monthlyPriceCents;
-        const annualPayment = annualMonthlyPriceCents(monthly);
+        const annualPayment = annualPlanPriceCents(monthly);
         return {
             plan_key: key,
             currency: "usd",
             monthly_credits: plan.monthlyCredits,
             volume_bonus_percent: planVolumeBonusPercent(key),
             monthly: { payment_cents: monthly, billing_interval: "month", commitment_months: 1 },
-            yearly: annualMonthlyAvailable ? {
+            yearly: annualAvailable ? {
                 payment_cents: annualPayment,
-                billing_interval: "month",
+                billing_interval: "year",
                 commitment_months: 12,
-                total_payment_cents: annualPayment * 12,
-                saving_cents: monthly * 12 - annualPayment * 12,
+                total_payment_cents: annualPayment,
+                monthly_equivalent_cents: planMonthlyEquivalentCents(annualPayment, "year"),
+                saving_cents: monthly * 12 - annualPayment,
                 prices_before_tax: true,
             } : null,
         };
     });
 }
+export const ANNUAL_PLAN_TERMS = {
+    billing_interval: "year",
+    commitment_months: 12,
+    payment: "Full discounted year charged upfront, then annually.",
+    credits_granted: "monthly_during_paid_year",
+    credit_schedule: "The first monthly slice starts with the paid annual period once payment is confirmed. Later slice windows start on that period's UTC day and time each month, clamped to the month's last day. These are scheduled boundaries, not guaranteed processing times.",
+    cancellation: "Stops annual renewal; access and monthly credits continue through the paid year.",
+    switch_from_monthly: "Starts at the next paid-period boundary.",
+    downgrades_or_switch_to_monthly: "Take effect at the paid year end.",
+};
+/** Historical terms retained for existing installment subscriptions only. */
 export const ANNUAL_MONTHLY_PLAN_TERMS = {
     terms_version: ANNUAL_MONTHLY_TERMS_VERSION,
     commitment_months: 12,

package/node_modules/@oxygen/shared/dist/cancellation-reasons.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Why a customer cancels their plan (Tim, 2026-10-14): one choice, counted on the KPI board.
+ *
+ * The values are Stripe's own `cancellation_details.feedback` vocabulary, so a reason chosen
+ * in OXYGEN and one picked in the Stripe Billing Portal's survey land in the same field and
+ * group together. The labels are what the customer reads; the order is the order they see.
+ */
+export declare const CANCELLATION_REASONS: readonly [{
+    readonly value: "too_expensive";
+    readonly label: "Too expensive";
+}, {
+    readonly value: "missing_features";
+    readonly label: "Missing a feature I need";
+}, {
+    readonly value: "switched_service";
+    readonly label: "Switched to another tool";
+}, {
+    readonly value: "unused";
+    readonly label: "Not using it enough";
+}, {
+    readonly value: "too_complex";
+    readonly label: "Too hard to use";
+}, {
+    readonly value: "low_quality";
+    readonly label: "Results weren't good enough";
+}, {
+    readonly value: "customer_service";
+    readonly label: "Support didn't help";
+}, {
+    readonly value: "other";
+    readonly label: "Something else";
+}];
+export type CancellationReason = (typeof CANCELLATION_REASONS)[number]["value"];
+export declare const CANCELLATION_REASON_VALUES: readonly CancellationReason[];
+export declare function isCancellationReason(value: unknown): value is CancellationReason;

package/node_modules/@oxygen/shared/dist/cancellation-reasons.js

@@ -0,0 +1,21 @@
+/**
+ * Why a customer cancels their plan (Tim, 2026-10-14): one choice, counted on the KPI board.
+ *
+ * The values are Stripe's own `cancellation_details.feedback` vocabulary, so a reason chosen
+ * in OXYGEN and one picked in the Stripe Billing Portal's survey land in the same field and
+ * group together. The labels are what the customer reads; the order is the order they see.
+ */
+export const CANCELLATION_REASONS = [
+    { value: "too_expensive", label: "Too expensive" },
+    { value: "missing_features", label: "Missing a feature I need" },
+    { value: "switched_service", label: "Switched to another tool" },
+    { value: "unused", label: "Not using it enough" },
+    { value: "too_complex", label: "Too hard to use" },
+    { value: "low_quality", label: "Results weren't good enough" },
+    { value: "customer_service", label: "Support didn't help" },
+    { value: "other", label: "Something else" },
+];
+export const CANCELLATION_REASON_VALUES = CANCELLATION_REASONS.map((reason) => reason.value);
+export function isCancellationReason(value) {
+    return typeof value === "string" && CANCELLATION_REASON_VALUES.includes(value);
+}

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

@@ -423,7 +423,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         primitive: "agents",
         owns: "Adaptive governed worker definitions, versions, authorization, context, triggers, threads, checkpoints, inference, and first-class runs.",
         notFor: "A known deterministic graph that belongs in Workflows or an opaque uploaded runtime.",
-        execution: "Publish and run a governed Agent with explicit tool authority and bounded spend. Staff on dev can create ongoing sessions: draft, exact resource scope, per-run and rolling 24-hour caps, preview/activate, continuing conversation and bounded self-scheduling. Inspect agent session templates; pause/resume preserves history. Staff on dev also talk to Oxygents (AI teammates): the workspace's first one (New Bot until named) and any others added, one ongoing private chat each.",
+        execution: "Publish and run a governed Agent with explicit tool authority and bounded spend. Staff on dev can create ongoing sessions: draft, exact resource scope, per-run and rolling 24-hour caps, preview/activate, continuing conversation and bounded self-scheduling. Inspect agent session templates; pause/resume preserves history. Staff on dev also talk to Oxygents (AI teammates): the workspace's first one (New Bot until named) and any others added, one ongoing private chat each. A new one is its owner's until shared with everyone in the workspace or named people, as collaborators (a chat of their own) or managers (also its profile and who has access). Group chats hold up to six Oxygents and, if you like, teammates: their admins change who is in them, and each message goes to the Oxygents it @mentions or is for.",
         posture: "mixed",
         gatewayTools: ["oxygen_agent_list", "oxygen_agent_create", "oxygen_agent_run"],
         gatewayCommands: ["agent list", "agent create", "agent run"],
@@ -1052,6 +1052,17 @@ function readInspectionRecommendation(query) {
     if (action)
         return null;
     const stored = positive.replace(/\bwithout\s+(?:changing|approving|rejecting|publishing|running|executing|refreshing)\b(?:\s+(?:widget\s+)?data\b)?/g, "");
+    // A trigger diagnosis needs the live definition, not run tailing or a call.
+    // Keep execution, authoring and run-history requests with their own owners.
+    if (/\bworkflows?\b/.test(stored)
+        && /\b(?:get|read|inspect|show|diagnose|details)\b/.test(stored)
+        && !/\b(?:runs?|tail|logs?|templates?|blueprints?|recipes?|schemas?|knowledge|wiki|messages?|inbox|dashboards?|functions?|create|build|author|design|write|edit|update|change|delete|remove|archive|save|approve|reject|publish|running|execute|call|cancel|retry|resume|pause|restore|reset|duplicate|copy|materialize|send|refresh|launch|enable|disable|apply|import|sync|schedule|enroll|add|set)\b/.test(stored))
+        return {
+            capabilityId: "workflows",
+            tools: ["oxygen_workflows_get", "oxygen_workflows_revisions", "oxygen_workflows_runs"],
+            commands: ["workflows get", "workflows revisions", "workflows runs"],
+            execution: "Read the named Workflow's live trigger status and scheduler_last_error_code with oxygen_workflows_get; revisions show authored definitions and runs show execution history. A stored refusal explains the current block, not when platform policy changed. External MCP uses oxygen_capabilities_read. Inspect before separately approving enable or execution; discovery grants no standing authority or credit spend.",
+        };
     const storedOnly = !isHostedWorkflowIntent(stored) && !isSecondPartyDecisionIntent(stored)
         && !/\b(?:create|write|edit|update|change|delete|remove|archive|save|approve|reject|publish|run|running|execute|send|refresh|launch|enable|disable|apply|materialize|import|sync|schedule|enroll|add|set)\b/.test(stored);
     // The connector BEFORE's explicit Knowledge requests were claimed by the
@@ -1192,6 +1203,11 @@ function routeCardFor(card, query) {
             ...card, posture: "read_only",
             execution: "Read partner_bonus eligibility, amount, conditions and timing with billing summary (oxygen_billing_summary), without grants or expiry. Captured coupon evidence is conditional and dated; a future bonus still requires a fresh Stripe check. Balance and usage can reconcile credits. Publication and plan changes need separate approval.",
         };
+    if (card.id === "billing-and-budgets" && isSeatTransitionReadIntent(query))
+        card = {
+            ...card, posture: "read_only",
+            execution: "Read sending_seats with billing summary (oxygen_billing_summary), using the saved wallet without grants or expiry. It reports retired status, held-seat period-end meaning, channel capacity, current reservation prices and snapshot eligibility. Coverage of a specific account and its first future debit may remain unknown. A connection rechecks eligibility; this read reserves nothing.",
+        };
     const blockRead = card.primitive === "sequences" ? sendingBlockReadRecommendation(query) : null;
     if (blockRead)
         card = { ...card, posture: "read_only", execution: blockRead.execution };
@@ -2039,6 +2055,8 @@ function explicitCapabilityIntent(query) {
         return ROUTE_BY_ID.get("geo") ?? null;
     if (isSubscriptionRetentionIntent(query))
         return ROUTE_BY_ID.get("billing-and-budgets") ?? null;
+    if (isSeatTransitionReadIntent(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))
@@ -2380,6 +2398,9 @@ function recommendationsFor(card, query) {
     if (card.id === "billing-and-budgets" && isPartnerBonusReadIntent(query)) {
         return { tools: ["oxygen_billing_summary"], commands: ["billing summary"] };
     }
+    if (card.id === "billing-and-budgets" && isSeatTransitionReadIntent(query)) {
+        return { tools: ["oxygen_billing_summary"], commands: ["billing summary"] };
+    }
     const readOnly = readInspectionRecommendation(query);
     if (readOnly?.capabilityId === card.id)
         return readOnly;
@@ -3230,6 +3251,11 @@ function isSenderCopyVariableIntent(query) {
         || /\bsign off (?:variable|with|per sender)\b|\bper sender sign off\b/.test(query)
         || /\bsign (?:every|each|all) (?:emails?|messages?|dms?|notes?) with\b/.test(query);
 }
+/** Retired sending-seat questions need a stored read before any financial maintenance. */
+function isSeatTransitionReadIntent(query) {
+    return /\b(sending seats?|seat subscriptions?|retired seats?|held seats?)\b/.test(query)
+        && !/\b(buy|purchase|set|increase|decrease|lower|reduce|cancel|connect|disconnect)\b/.test(query);
+}
 /** OXP-43.36: inspect recurring account prices before creating authorization. */
 function isConnectionPriceIntent(query) {
     if (!/\b(costs?|prices?|credits?|reser(?:ve[sd]?|vations?)|charges?|charged|fees?|pay|quote)\b/.test(query))

package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js

@@ -49,7 +49,7 @@ export const BROWSER_OPERATIONS = [
     operation("billing.allowance.view", "/api/cli/billing/allowance/view", "GET", "billing allowance view", "oxygen_billing_allowance_view", "billing", "Inspect the current-cycle allowance, billing owner and partner-bonus eligibility; due plan grants or credit expiry may apply. 0 credits; reserves nothing.", {}, [], { mutates: true }),
     operation("billing.commitments.view", "/api/cli/billing/commitments/view", "GET", "billing commitments view", "oxygen_billing_commitments_view", "billing", "Read the complete fixed-credit commitment view and linked billing-owner display, without enumerating a child's sibling resources."),
     operation("billing.invoices.view", "/api/cli/billing/invoices/view", "GET", "billing invoices view", "oxygen_billing_invoices_view", "billing", "Read the browser invoice-history projection, including exact native timestamps, amounts and signed Stripe invoice links."),
-    operation("billing.summary", "/api/cli/billing/summary", "GET", "billing summary", "oxygen_billing_summary", "billing", "Read the saved wallet balance, plan and billing owner; trialCreditGrant is the trial budget. Grant records establish actual signup credits. Includes partner-bonus eligibility/timing; applies no grants or expiry."),
+    operation("billing.summary", "/api/cli/billing/summary", "GET", "billing summary", "oxygen_billing_summary", "billing", "Read saved wallet/plan, partner bonus and sending_seats status, period-end meaning, channel capacity, prices and snapshot eligibility. No grants or expiry. Connection actions recheck eligibility; first debit may remain unknown. trialCreditGrant is a budget, not a recorded grant."),
     operation("billing.usage.view", "/api/cli/billing/usage/view", "GET", "billing usage view", "oxygen_billing_usage_view", "billing", "Credit spend over 7, 30 or 90 days by category and provider, each with its share, plus permitted linked-workspace rollups. totalSpent is reserved minus released; billing usage managed_credits_used counts captured credits only. Other windows or groupings: billing audit.", { days: enumOf(["7", "30", "90"]), workspace: text() }),
     operation("integrations.managed_endpoints", "/api/cli/integrations/composio/endpoints", "GET", "integrations managed-endpoints", "oxygen_integration_managed_endpoints", "integrations", "Read a managed integration's full action catalog and parameter schemas.", { integration_id: text() }, ["integration_id"]),
     operation("integrations.openrouter_models", "/api/cli/integrations/openrouter/models", "GET", "integrations openrouter-models", "oxygen_openrouter_models", "integrations", "Read model and pricing metadata using this workspace's connected OpenRouter account; credentials are never returned."),
@@ -105,11 +105,11 @@ export const BROWSER_OPERATIONS = [
     operation("tables.resource.ingestions.retry", `${table}/ingestions/{ingestion_run}/retry-failed`, "POST", "tables ingestion retry", "oxygen_table_resource_ingestion_retry", "runs", "Retry failed items in this Table's hosted ingestion run."),
     operation("tables.resource.import", "/api/cli/tables/import", "POST", "tables upload", "oxygen_table_resource_upload", "tables", "Preview or import small uploaded CSV, JSON or XLSX bytes through the exact browser import contract. Preview writes no rows.", upload, ["content_base64", "file_name"], { multipart }),
     operation("billing.activate", "/api/cli/billing/activate", "POST", "billing activate", "oxygen_billing_activate", "billing", "Activate a trial subscription now and charge its saved payment method; administrator approval is required. An optional tier reprices the active trial in the same call.", { approved: bool(), tier: text() }, ["approved"], { spends: true }),
-    operation("billing.checkout", "/api/cli/billing/checkout", "POST", "billing checkout", "oxygen_billing_checkout", "billing", "Open browser Checkout; payment approves purchase. First purchase: admin/owner. New yearly plans use interval month, term year and the current terms_version.", {
+    operation("billing.checkout", "/api/cli/billing/checkout", "POST", "billing checkout", "oxygen_billing_checkout", "billing", "Checkout approval link; admin/owner for first purchase. Yearly plans charge the full discounted year upfront: use interval year, term year. Credits arrive monthly.", {
         plan: text("Plan key from billing balance available_plans, for example oxygen_49."),
-        interval: enumOf(["month", "year"], { description: "New purchases use month. year is legacy prepaid cadence, refused for new purchases." }),
-        term: enumOf(["month", "year"], { description: "year commits to twelve discounted monthly payments; month is the default." }),
-        terms_version: text("Required for term year: annual_monthly_terms.terms_version from billing balance."),
+        interval: enumOf(["month", "year"], { description: "month bills monthly; year charges the full discounted year upfront." }),
+        term: enumOf(["month", "year"], { description: "year pays the full discounted year upfront; month is the default." }),
+        terms_version: text("Historical installment terms version; new yearly purchases use interval year."),
         currency: text("Billing currency: usd (default)."),
         trial: bool({ description: "Retired compatibility option; omit for a new paid subscription." }),
         return_to: text("Same-origin path to return to after Checkout, for example /home."),
@@ -133,6 +133,6 @@ export const BROWSER_OPERATIONS = [
     operation("notetaker.calendar.schedule", "/api/cli/notetaker/calendar", "POST", "notetaker calendar schedule", "oxygen_notetaker_calendar_schedule", "crm", "Schedule recording for an existing calendar event after approval; an external CLI or MCP caller must supply an explicit max_credits ceiling.", { event_id: text(), approved: bool(), max_credits: num({ minimum: 0 }) }, ["event_id", "approved"], { defaults: { action: "schedule" }, spends: true }),
     operation("notetaker.note.edit", "/api/cli/notetaker/sessions/{session}/note", "PATCH", "notetaker notes edit", "oxygen_notetaker_note_edit", "crm", "Save the markdown note for one meeting session and return the committed note.", { markdown: text() }, ["markdown"]),
     operation("orgs.create", "/api/cli/orgs/create", "POST", "orgs create", "oxygen_workspace_create", "workspace", "Create a workspace for the authenticated person's account and begin native company setup. Workspace API keys cannot create personal workspaces.", { name: text(), company_domain: text("Company website or domain, or its LinkedIn company page URL when it has no website."), linkedin_profile_url: text("Creator's LinkedIn profile URL, separate from the company's page.") }, ["name", "company_domain"]),
-    operation("onboarding.complete", "/api/cli/onboarding/complete", "POST", "onboarding complete", "oxygen_onboarding_complete", "workspace", "Complete the active workspace's onboarding step and record its discovery-source choices. The other choice requires source_other.", { sources: arr(enumOf(["linkedin_content", "linkedin_dm", "linkedin_ads", "x", "youtube", "google", "email", "word_of_mouth", "referral", "event", "other"])), source_other: text(), redirect_url: text() }, ["sources"]),
+    operation("onboarding.complete", "/api/cli/onboarding/complete", "POST", "onboarding complete", "oxygen_onboarding_complete", "workspace", "Complete the active workspace's onboarding step and record its discovery-source choices. The other choice requires source_other.", { sources: arr(enumOf(["linkedin_content", "linkedin_dm", "linkedin_ads", "x", "youtube", "google", "ai_assistant", "email", "word_of_mouth", "referral", "event", "other"])), source_other: text(), redirect_url: text() }, ["sources"]),
     operation("onboarding.start", "/api/cli/onboarding/start", "POST", "onboarding start", "oxygen_onboarding_start", "workspace", "Answer onboarding's choice card. own_agent continues to connecting your own agent. copilot opens the Workspace Copilot with the onboarding conversation already started, billed in credits like any Copilot turn; choosing again reopens that conversation.", { path: enumOf(["own_agent", "copilot"]), play: text("A play slug carried to the install step.") }, ["path"], { spends: true }),
 ];