@oxygen-agent/cli 1.1011.493 → 1.1011.607

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.493
+Version: 1.1011.607

package/dist/command-manifest.js

@@ -147,6 +147,10 @@ const ZERO_CREDIT_APPROVAL_COMMANDS = new Set([
     // Both previews without --approved; approval cancels or archives, never charges.
     "domains delete",
     "mailboxes delete",
+    // Consent setup creates links without an execution debit; sync controls and
+    // progress are covered by the existing monthly mailbox commitment.
+    "mailboxes connect-oauth",
+    "mailboxes sync",
     // Previews without --approved; with it, removes a program no creator ever
     // joined. No provider call, no credits.
     "ugc programs delete",
@@ -201,6 +205,9 @@ const PREVIEW_BY_DEFAULT_COMMANDS = new Set([
     "mailboxes emailguard auto-enroll",
     "domains delete",
     "mailboxes delete",
+    "mailboxes connect-oauth",
+    // No action reads progress; an action previews until --approved.
+    "mailboxes sync",
     "sequences recover-capacity",
     "support admin done",
     "support admin reply",

package/dist/crm-file-read-commands.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+type Handle = (command: string, options: {
+    json?: boolean;
+}, action: () => Promise<unknown>) => Promise<void>;
+export declare function registerCrmFileReadCommands(program: Command, handle: Handle): void;
+export {};

package/dist/crm-file-read-commands.js

@@ -0,0 +1,16 @@
+import { CRM_FILE_BYTES_MAX, CRM_FILE_BYTES_QUERY_CONTRACT } from "@oxygen/shared/contracts/crm-file-bytes";
+import { addContractFlags, readContractFlags } from "./contract-flags.js";
+import { requestOxygen } from "./http-client.js";
+export function registerCrmFileReadCommands(program, handle) {
+    const files = program.commands.find(command => command.name() === "crm")?.commands.find(command => command.name() === "files");
+    if (!files)
+        throw new Error("CRM files must be registered first.");
+    const read = files.command("read <attachment-id>").description("Read a bounded chunk of original file bytes, separate from extracted text. Follow next_offset with the same sha256. No credits.").option("--json", "Print a JSON envelope.");
+    addContractFlags(read, CRM_FILE_BYTES_QUERY_CONTRACT);
+    read.action((attachmentId, options) => handle("crm files read", options, () => {
+        const params = new URLSearchParams({ format: "json", limit: String(CRM_FILE_BYTES_MAX), max_chars: "10000" });
+        for (const [key, value] of Object.entries(readContractFlags(options, CRM_FILE_BYTES_QUERY_CONTRACT)))
+            params.set(key, String(value));
+        return requestOxygen(`/api/cli/crm/files/${encodeURIComponent(attachmentId)}/download?${params}`);
+    }));
+}

package/dist/feed-read-flags.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function addFeedReadFlags(command: Command, detail?: boolean): Command;
+export declare function feedReadWindowParams(options: Record<string, unknown>, detail?: boolean): URLSearchParams;

package/dist/feed-read-flags.js

@@ -0,0 +1,9 @@
+import { TABLE_FEED_GET_WINDOW_CONTRACT, TABLE_FEED_LIST_WINDOW_CONTRACT } from "@oxygen/shared/contracts/table-feed-read";
+import { addContractFlags, readContractFlags } from "./contract-flags.js";
+export function addFeedReadFlags(command, detail = false) {
+    return addContractFlags(command, detail ? TABLE_FEED_GET_WINDOW_CONTRACT : TABLE_FEED_LIST_WINDOW_CONTRACT);
+}
+export function feedReadWindowParams(options, detail = false) {
+    const fields = readContractFlags(options, detail ? TABLE_FEED_GET_WINDOW_CONTRACT : TABLE_FEED_LIST_WINDOW_CONTRACT);
+    return new URLSearchParams(Object.entries(fields).map(([key, value]) => [key, String(value)]));
+}

package/dist/functions-commands.js

@@ -1,4 +1,5 @@
 import { OxygenError } from "@oxygen/shared";
+import { FUNCTION_LIBRARY_FILTER } from "@oxygen/shared/contracts/function-library-read";
 import { parseJsonObject } from "./cli-values.js";
 import { requestOxygen } from "./http-client.js";
 export function registerFunctionsCommands(program, handle) {
@@ -12,7 +13,7 @@ export function registerFunctionsCommands(program, handle) {
         .action((options) => handle("functions list", options, () => {
         if (options.managed && options.favorites)
             throw new OxygenError("invalid_request", "Pass --managed or --favorites, not both.", { exitCode: 1 });
-        const filter = options.managed ? "managed" : options.favorites ? "favorites" : null;
+        const filter = options.managed ? FUNCTION_LIBRARY_FILTER.managed : options.favorites ? FUNCTION_LIBRARY_FILTER.favorites : null;
         return requestOxygen(filter ? `/api/cli/functions?${new URLSearchParams({ filter })}` : "/api/cli/functions");
     }));
     for (const [command, label] of [["favorite", "Favourite a Function so it appears under `functions list --favorites` and the Favorites tab; per user, per workspace."], ["unfavorite", "Remove a Function from your favourites."]]) {

package/dist/help.js

@@ -147,19 +147,19 @@ export function applyOxygenHelp(program, binaryName) {
         `  2. ${binaryName} skills install --json      load the skills that teach the GTM loops (automatic after login)`,
         "     Add --project to keep the skills inside the current project, including confined agent sessions.",
         `  3. ${binaryName} context resolve --json     load workspace context before operating primitives`,
-        // A new workspace's first sessions are onboarding, and the consultant guide is
-        // a served skill an agent has to be TOLD about: nothing else on a first-touch
-        // surface named it (blind eval, 2026-09-16).
-        `     New or thin workspace? load the onboarding consultant first: ${binaryName} skills get oxygen-onboarding --json`,
+        // 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.",
         `  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 --json       choose a play from the Recipe catalog for your goal`,
+        `  5. ${binaryName} recipes list "<goal>" --view summary --json   choose a play from the Recipe catalog for your goal`,
         `  Provider inventory: ${binaryName} tools search <brand> --json, then ${binaryName} tools search --provider <provider-id> --all --json (Blitz uses blitzapi).`,
         `  Installable systems and recurring monitors: ${binaryName} blueprints list --json.`,
         "  Docs: https://oxygen-agent.com/docs",
         "",
         "Conventions:",
         "  --json prints a stable envelope {ok, data|error, meta}; errors always print it.",
+        "  Free Sequence launch previews omit --approved and --max-credits.",
         "  Credit-spending commands require --approved --max-credits <n>; zero-credit",
         "  external writes require --approved plus the command's preview-bound plan token.",
         "  State-changing responses include a web_url deep-link to inspect the result.",
@@ -248,6 +248,19 @@ const COMMAND_SYNONYMS = {
     // guess was `oxygen campaigns` (Plain T-220 baseline, 2026-09-30).
     campaign: ["sequences"],
     campaigns: ["sequences"],
+    // Hiding sidebar pages lives under `settings pages`; the blind agent's first
+    // guess was `oxygen sidebar` (personal-sidebar baseline, 2026-10-02).
+    sidebar: ["settings"],
+    // Creator programs live under `ugc`; a blind agent's first guess was
+    // `oxygen creator` (invite-sponsorship acceptance, 2026-10-02).
+    creator: ["ugc"],
+    creators: ["ugc"],
+    influencer: ["ugc"],
+    influencers: ["ugc"],
+    navigation: ["settings"],
+    nav: ["settings"],
+    customise: ["settings"],
+    customize: ["settings"],
 };
 /**
  * The extra line printed after `error: unknown command '<x>'`.