@oxygen-agent/cli 1.1011.626 → 1.1011.650

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.626
+Version: 1.1011.650

package/dist/help.js

@@ -149,7 +149,7 @@ export function applyOxygenHelp(program, binaryName) {
         `  3. ${binaryName} context resolve --json     load workspace context before operating primitives`,
         // Populated workspaces need the same first-win guidance as empty ones.
         `     Getting started or choosing what to do next? ${binaryName} skills get oxygen-onboarding --json`,
-        "     It maps your company, running campaigns and connected accounts, then suggests plays to build.",
+        "     It sharpens your offer and ICP, then ranks the warmest leads you can reach now.",
         `  4. ${binaryName} capabilities search "<goal>" --json   route the goal, then hydrate one exact command`,
         `     ${binaryName} commands search "<term>" --json         find a command by name or purpose instead of dumping the manifest`,
         `  5. ${binaryName} recipes list "<goal>" --view summary --json   choose a play from the Recipe catalog for your goal`,

package/dist/index.js

@@ -7108,7 +7108,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .description("List workspace tables in the current tenant database.")
         .option("--project <project>", "Project id or slug to filter by.")
         .option("--tag <tag>", "Only tables carrying this workspace tag (see `oxygen tags list`).")
-        .option("--include-archived", "Also list archived and delete-scheduled tables (the restorable trash; each carries a lifecycle with purge_scheduled_at).")
+        .option("--include-archived", "Also list archived, delete-scheduled and purging tables (the trash; each carries a lifecycle with purge_scheduled_at, and one with purgeStartedAt is being purged and can no longer be restored).")
         .option("--limit <n>", "Maximum tables to list. Defaults to 200; hard cap is 1000.")
         .option("--all", "List every table instead of the newest window.")
         .option("--json", "Print a JSON envelope.")
@@ -7324,7 +7324,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("restore")
-        .description("Restore an archived or delete-scheduled table: cancels the purge timer and reclaims its slug.")
+        .description("Restore an archived or delete-scheduled table: cancels the purge timer and reclaims its slug. A table whose purge has begun (lifecycle.purgeStartedAt) can no longer be restored.")
         .argument("[table]", "Table id or slug (the pre-delete slug works).")
         .option("--tables <refs>", "Restore a comma-separated batch; alternative to the table argument.")
         .option("--json", "Print a JSON envelope.")
@@ -11209,8 +11209,8 @@ 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; `--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")
+        .description("Plan-tier limits, spend-safety defaults, per-channel sending limits, and storage capacity posture. `limits show --section capacity` returns storage alone, including which Table is full.")
+        .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")
         .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/copilot-playbooks.d.ts

@@ -10,12 +10,16 @@ export type CopilotPlaybook = {
     title: string;
     /** The featured catalog recipe that carries this play: its kit, prerequisites and approval gates. */
     recipeSlug: string;
+    /** The play's request in the person's own words, the same text its card copies (2026-10-03). */
+    prompt: string;
 };
 export declare const COPILOT_PLAYBOOKS: readonly CopilotPlaybook[];
 /**
- * The sentence a Home card writes into the composer. It names the skill the way
- * a person would say it, and the Copilot's prompt maps that title back to the
- * slug — so the user reads and sends exactly what the card promised.
+ * What a chip writes into the composer: the play's own request, the same words
+ * its prompt card copies for the person's agent (plays as prompts, current
+ * chat, 2026-10-03), then the skill named the way a person says it. The
+ * Copilot's prompt maps that title back to the slug, so the user reads and
+ * sends exactly what the chip promised.
  */
-export declare function copilotPlaybookPrompt(playbook: Pick<CopilotPlaybook, "title">): string;
+export declare function copilotPlaybookPrompt(playbook: Pick<CopilotPlaybook, "title" | "prompt">): string;
 export declare function getCopilotPlaybook(slug: string): CopilotPlaybook | null;

package/node_modules/@oxygen/shared/dist/copilot-playbooks.generated.d.ts

@@ -2,16 +2,20 @@ export declare const COPILOT_PLAYBOOKS_GENERATED: readonly [{
     readonly slug: "tam-sourcing";
     readonly title: "TAM sourcing";
     readonly recipeSlug: "icp-to-account-map";
+    readonly prompt: "Turn our ICP into a scored list of target accounts, with the evidence behind each score, so I can see which segments fit best.";
 }, {
     readonly slug: "linkedin-content-strategy";
     readonly title: "LinkedIn content strategy";
     readonly recipeSlug: "founder-posting-system";
+    readonly prompt: "Help me post on LinkedIn consistently in my own voice: draft posts from our positioning and ICP, let me approve each one, and track how they perform.";
 }, {
     readonly slug: "inbound-led-outbound";
     readonly title: "Inbound-led outbound";
     readonly recipeSlug: "inbound-led-outbound";
+    readonly prompt: "Turn the people who react to and comment on LinkedIn posts I pick into pipeline: score them against our ICP and message only the good fits from a capped sequence.";
 }, {
     readonly slug: "signal-based-outbound";
     readonly title: "Signal-based outbound";
     readonly recipeSlug: "daily-warm-lead-queue";
+    readonly prompt: "Give me one ranked list every morning of the warmest people to contact, from website visitors, profile viewers, post engagers and new followers.";
 }];

package/node_modules/@oxygen/shared/dist/copilot-playbooks.generated.js

@@ -1,5 +1,5 @@
 // GENERATED by apps/web/scripts/generate-copilot-playbooks.ts from the recipe
-// catalog (featured recipes: `featured_order`, `label`, `playbook` in
+// catalog (featured recipes: `featured_order`, `label`, `playbook`, `prompt` in
 // apps/web/src/agent-skills/oxygen-recipes/recipes).
 // Do not edit by hand — run `npm run skills:metadata -w @oxygen/web`.
 export const COPILOT_PLAYBOOKS_GENERATED = [
@@ -7,20 +7,24 @@ export const COPILOT_PLAYBOOKS_GENERATED = [
         slug: "tam-sourcing",
         title: "TAM sourcing",
         recipeSlug: "icp-to-account-map",
+        prompt: "Turn our ICP into a scored list of target accounts, with the evidence behind each score, so I can see which segments fit best.",
     },
     {
         slug: "linkedin-content-strategy",
         title: "LinkedIn content strategy",
         recipeSlug: "founder-posting-system",
+        prompt: "Help me post on LinkedIn consistently in my own voice: draft posts from our positioning and ICP, let me approve each one, and track how they perform.",
     },
     {
         slug: "inbound-led-outbound",
         title: "Inbound-led outbound",
         recipeSlug: "inbound-led-outbound",
+        prompt: "Turn the people who react to and comment on LinkedIn posts I pick into pipeline: score them against our ICP and message only the good fits from a capped sequence.",
     },
     {
         slug: "signal-based-outbound",
         title: "Signal-based outbound",
         recipeSlug: "daily-warm-lead-queue",
+        prompt: "Give me one ranked list every morning of the warmest people to contact, from website visitors, profile viewers, post engagers and new followers.",
     },
 ];

package/node_modules/@oxygen/shared/dist/copilot-playbooks.js

@@ -1,12 +1,14 @@
 import { COPILOT_PLAYBOOKS_GENERATED } from "./copilot-playbooks.generated.js";
 export const COPILOT_PLAYBOOKS = COPILOT_PLAYBOOKS_GENERATED;
 /**
- * The sentence a Home card writes into the composer. It names the skill the way
- * a person would say it, and the Copilot's prompt maps that title back to the
- * slug — so the user reads and sends exactly what the card promised.
+ * What a chip writes into the composer: the play's own request, the same words
+ * its prompt card copies for the person's agent (plays as prompts, current
+ * chat, 2026-10-03), then the skill named the way a person says it. The
+ * Copilot's prompt maps that title back to the slug, so the user reads and
+ * sends exactly what the chip promised.
  */
 export function copilotPlaybookPrompt(playbook) {
-    return `Use the ${playbook.title} skill to get started.`;
+    return `${playbook.prompt} Use the ${playbook.title} skill.`;
 }
 export function getCopilotPlaybook(slug) {
     return COPILOT_PLAYBOOKS.find((playbook) => playbook.slug === slug) ?? null;

package/node_modules/@oxygen/shared/dist/knowledge-bootstrap.d.ts

@@ -153,6 +153,12 @@ export type KnowledgeBootstrapMarker = {
     run_id: string | null;
     /** Managed credits actually spent, across every phase. Never exceeds the cap. */
     credits_used: number;
+    /**
+     * `unknown` when the pass stopped with no record of which provider calls it made: a
+     * legacy attempt closed as `interrupted_without_checkpoint`. `credits_used` is then
+     * not a measurement, and nothing about what was read or spent may be claimed.
+     */
+    effect_outcome?: "unknown";
     /**
      * The workspace domain researched (from organizations.iconDomain). Null (stored
      * as "", the key the execution and onboarding checks compare on) for a company

package/node_modules/@oxygen/shared/dist/provider-balance-signal.d.ts

@@ -83,13 +83,18 @@ export declare function managedBalanceFloorEnvVar(provider: string): string;
 /**
  * The floor in force for one provider. `null` means "do not judge this balance".
  *
+ * A wallet reported in a currency with no floor of its own gets `0`, not the credit
+ * default: an empty account is still `exhausted`, and how soon it empties is the
+ * runway monitor's question (`provider_balance.runway`, 14 days at measured burn).
+ * Give it a measured entry in MANAGED_BALANCE_FLOORS to warn earlier.
+ *
  * The env override is the operator's escape hatch between deploys: a top-up that
  * changes the plan size, or a provider that turns out to be noisy at the default,
  * is one Doppler value away from being right. `off`/`none`/`disabled` switches the
  * provider off the monitor entirely; an unparseable or negative value is IGNORED
  * rather than obeyed, because a typo must not silently disarm an alert.
  */
-export declare function managedBalanceFloor(provider: string, env?: Record<string, string | undefined>): number | null;
+export declare function managedBalanceFloor(provider: string, env?: Record<string, string | undefined>, balanceUnit?: string | null): number | null;
 export type ProviderBalanceVerdict = {
     status: ProviderBalanceStatus;
     /** The single boolean the monitor's description tells a responder to read. */
@@ -109,5 +114,7 @@ export declare function classifyManagedBalance(input: {
     /** The balance fetcher's own status. Anything but "ok" means we are blind. */
     fetchStatus: "ok" | "auth_error" | "rate_limited" | "error";
     balanceRemaining: number | null;
+    /** The unit the fetcher reported. Decides whether the credit default may apply. */
+    balanceUnit?: string | null;
     env?: Record<string, string | undefined>;
 }): ProviderBalanceVerdict;

package/node_modules/@oxygen/shared/dist/provider-balance-signal.js

@@ -71,6 +71,20 @@ export const DEFAULT_MANAGED_BALANCE_FLOOR = 1_000;
  * inherits DEFAULT_MANAGED_BALANCE_FLOOR.
  */
 export const MANAGED_BALANCE_FLOORS = {
+    // R21, 2026-10-02. The two USD wallets below used to inherit the 1,000-CREDIT default
+    // (see CURRENCY_BALANCE_UNITS). Each floor applies that default's own intent — roughly
+    // three to eight days of measured burn, in the wallet's unit — to the largest 24-hour
+    // burn in prod `provider_balance.snapshot` from 2026-09-10 to 2026-10-02.
+    //
+    // Bright Data: largest 24h burn $0.17 (total $0.30 in 21.8 days), so the band is
+    // $0.51-$1.36. $1 is ~6 peak days.
+    brightdata: 1,
+    // InboxKit: one reseller wallet behind every tenant's managed mailbox orders, so it moves
+    // in purchase-sized steps; the largest 24h burn was one $28.75 step on 2026-09-28, and an
+    // order on 2026-08-17 was $22.25. Only 5.6 days of snapshots exist, so treat the maximum
+    // as thin. $90 is ~3 peak days; the runway P1 (<14 days at measured burn) is the earlier
+    // warning, and its line read 8.6 days (warn) for this wallet at 02:45 on 2026-10-02.
+    inboxkit: 90,
     // A 1,000-credit/month plan. The default floor would mark it low on the first day
     // of every billing period, forever — the classic alert nobody reads. Measured
     // 2026-09-07: it has ranged 1,002 -> 670 over 30 days, so 150 is ~15% of the plan
@@ -96,16 +110,31 @@ export const MANAGED_BALANCE_FLOORS = {
 export function managedBalanceFloorEnvVar(provider) {
     return `OXYGEN_MANAGED_BALANCE_FLOOR_${provider.toUpperCase().replace(/[^A-Z0-9]+/g, "_")}`;
 }
+/**
+ * Units that are money rather than provider credits. DEFAULT_MANAGED_BALANCE_FLOOR is a
+ * credit count, so it must never judge one of these: on 2026-10-02 it held Bright Data
+ * ($8.68 against a largest 24h burn of $0.17) and InboxKit ($144.07) "low" against a
+ * floor of 1,000, a number in a different unit from the wallet it judged.
+ */
+const CURRENCY_BALANCE_UNITS = new Set(["usd", "eur", "gbp"]);
+function isCurrencyBalanceUnit(unit) {
+    return typeof unit === "string" && CURRENCY_BALANCE_UNITS.has(unit.trim().toLowerCase());
+}
 /**
  * The floor in force for one provider. `null` means "do not judge this balance".
  *
+ * A wallet reported in a currency with no floor of its own gets `0`, not the credit
+ * default: an empty account is still `exhausted`, and how soon it empties is the
+ * runway monitor's question (`provider_balance.runway`, 14 days at measured burn).
+ * Give it a measured entry in MANAGED_BALANCE_FLOORS to warn earlier.
+ *
  * The env override is the operator's escape hatch between deploys: a top-up that
  * changes the plan size, or a provider that turns out to be noisy at the default,
  * is one Doppler value away from being right. `off`/`none`/`disabled` switches the
  * provider off the monitor entirely; an unparseable or negative value is IGNORED
  * rather than obeyed, because a typo must not silently disarm an alert.
  */
-export function managedBalanceFloor(provider, env = process.env) {
+export function managedBalanceFloor(provider, env = process.env, balanceUnit) {
     const raw = env[managedBalanceFloorEnvVar(provider)]?.trim();
     if (raw) {
         const lowered = raw.toLowerCase();
@@ -118,7 +147,9 @@ export function managedBalanceFloor(provider, env = process.env) {
     const configured = MANAGED_BALANCE_FLOORS[provider];
     if (configured === null)
         return null;
-    return configured ?? DEFAULT_MANAGED_BALANCE_FLOOR;
+    if (configured !== undefined)
+        return configured;
+    return isCurrencyBalanceUnit(balanceUnit) ? 0 : DEFAULT_MANAGED_BALANCE_FLOOR;
 }
 /**
  * Turn one balance reading into the verdict both producers log.
@@ -127,7 +158,7 @@ export function managedBalanceFloor(provider, env = process.env) {
  * without a provider, a cron, or a network.
  */
 export function classifyManagedBalance(input) {
-    const floor = managedBalanceFloor(input.provider, input.env ?? process.env);
+    const floor = managedBalanceFloor(input.provider, input.env ?? process.env, input.balanceUnit);
     if (input.fetchStatus !== "ok") {
         // We could not read the balance. That is a monitoring outage, not a funding
         // outage, so it must NOT enter the balance monitor: a rotated key would

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

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

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

package/package.json

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