@oxygen-agent/cli 1.365.3 → 1.575.19

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.365.3
+Version: 1.575.19

package/dist/column-run-notices.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `columns run --dry-run` on an AI column renders the prompt the model would
+ * actually receive for one real row. The human (non `--json`) output is a JSON
+ * dump, where that prompt is one long \n-escaped string — unreadable exactly
+ * where it matters. Render it for a terminal with real line breaks, naming the
+ * row it used so the reader can judge whether that row is representative.
+ *
+ * Returns null when the envelope carries no prompt preview (non-AI column,
+ * live run, or a preview the server could not produce).
+ */
+export declare function formatAiPromptPreviewNotice(data: unknown): string | null;

package/dist/column-run-notices.js

@@ -0,0 +1,37 @@
+import { readRecordString } from "./cli-values.js";
+import { isRecord } from "./util.js";
+/**
+ * `columns run --dry-run` on an AI column renders the prompt the model would
+ * actually receive for one real row. The human (non `--json`) output is a JSON
+ * dump, where that prompt is one long \n-escaped string — unreadable exactly
+ * where it matters. Render it for a terminal with real line breaks, naming the
+ * row it used so the reader can judge whether that row is representative.
+ *
+ * Returns null when the envelope carries no prompt preview (non-AI column,
+ * live run, or a preview the server could not produce).
+ */
+export function formatAiPromptPreviewNotice(data) {
+    if (!isRecord(data) || data.dry_run !== true)
+        return null;
+    const ai = isRecord(data.ai) ? data.ai : null;
+    const preview = ai && isRecord(ai.prompt_preview) ? ai.prompt_preview : null;
+    if (!preview)
+        return null;
+    if (preview.status !== "rendered") {
+        const message = readRecordString(preview, "message") ?? "no sample row was available.";
+        return `prompt preview unavailable: ${message}`;
+    }
+    const rowId = readRecordString(preview, "row_id") ?? "unknown";
+    const source = preview.row_source === "requested_row"
+        ? "the row you asked for"
+        : "first row in scope";
+    const shown = readRecordString(preview, "prompt") ?? "";
+    const chars = typeof preview.prompt_chars === "number" ? preview.prompt_chars : shown.length;
+    const truncation = preview.truncated === true
+        ? ` — truncated to ${shown.length} of ${chars} chars`
+        : "";
+    return [
+        `prompt preview — row ${rowId} (${source}), before grounding${truncation}:`,
+        shown,
+    ].join("\n");
+}

package/dist/command-manifest.js

@@ -7,25 +7,30 @@ import { CLI_EXIT_CODE_TABLE, OXYGEN_VERSION } from "@oxygen/shared";
 // deliberately excluded so a read is never mislabeled — e.g. `repair`
 // (→ `db repair-preview`). Approval-gated commands count as mutating even
 // though their bare form previews (`rotate`, `request` — `egress dedicated
-// request --approve` places a real $400/mo order). Object nouns that front
+// request --approve` places a real $15/mo order). Object nouns that front
 // paid *reads* (`find company`, `find email`) stay out too: those are flagged
-// by spends_credits, not mutates. When you add a leaf command, verify its verb
-// here against the self-index before trusting the default.
+// by spends_credits, not mutates. Hyphenated writes are listed as the EXACT
+// leaf (`mark-read`, `mark-all-read`, `warm-send`) rather than as their prefix,
+// because the prefix would also claim every future leaf sharing it — a bare
+// `mark` entry would mislabel a read-only `mark …` command as a write. When you
+// add a leaf command, verify its verb here against the self-index before
+// trusting the default.
 const MUTATING_VERBS = new Set([
     "accept", "ack", "add", "adopt", "apply", "approve", "archive",
-    "assign", "attach", "backfill", "buy", "call", "cancel", "clear",
+    "assign", "attach", "backfill", "bind", "buy", "call", "cancel", "chat-action", "clear",
     "comment", "configure", "connect", "create", "delete", "delist", "disable",
     "disconnect", "dispatch", "draft", "duplicate", "edit", "emit", "enable", "enroll",
-    "file", "grant", "harvest", "import", "insert", "invite", "launch",
-    "log", "login", "logout", "mark-read", "materialize", "merge", "migrate",
-    "move", "note", "onboard", "order", "pause", "pin", "provision",
+    "file", "forward", "grant", "harvest", "history", "import", "insert", "interrupt", "invite",
+    "launch", "log", "login", "logout", "mark-all-read", "mark-read", "materialize", "merge",
+    "migrate",
+    "move", "note", "off", "onboard", "order", "pause", "pin", "provision",
     "publish", "purchase", "purge", "push", "react", "reconcile", "record", "recover-pending",
     "register", "reject", "relink", "remove", "rename", "reorder", "reply", "request",
     "rerun", "rescan", "resend", "reset", "resolve", "restore", "resume",
     "retry", "retype", "revoke", "rotate", "run", "save", "schedule",
     "seed", "select", "send", "set", "setup", "share", "solve",
     "start", "stop", "subscribe", "sync", "synthesize", "tag", "unarchive", "unpublish", "unshare",
-    "unsubscribe", "update", "upload", "upsert", "use", "warm-send", "warmup",
+    "unbind", "unsubscribe", "update", "upload", "upsert", "use", "warm-send", "warmup",
     "withdraw", "write",
 ]);
 export function buildCommandManifest(program, binaryName) {

package/dist/help.js

@@ -9,9 +9,20 @@ const HELP_GROUPS = [
     {
         heading: "Get started & account:",
         commands: [
-            "login", "auth", "profiles", "logout", "update", "api-keys", "whoami",
-            "onboarding", "status", "orgs", "commands", "skills", "session",
-            "support", "feedback",
+            "login",
+            "auth",
+            "profiles",
+            "logout",
+            "update",
+            "api-keys",
+            "whoami",
+            "status",
+            "orgs",
+            "commands",
+            "skills",
+            "session",
+            "support",
+            "feedback",
         ],
     },
     {
@@ -21,22 +32,62 @@ const HELP_GROUPS = [
     {
         heading: "Data (tables, CRM, dashboards):",
         commands: [
-            "tables", "rows", "cells", "columns", "action-column", "enrich-column",
-            "enrichment", "table-runs", "table-ingestions", "runs", "crm", "signals",
-            "dashboards", "projects", "signup-leads",
+            "tables",
+            // A feed is part of Tables (ADR 0016), not an eleventh primitive — it sits
+            // beside `tables` so the live half of a table is found next to the table.
+            "feeds",
+            "rows",
+            "cells",
+            "columns",
+            "action-column",
+            "enrich-column",
+            "enrichment",
+            "table-runs",
+            "table-ingestions",
+            "runs",
+            "crm",
+            "signals",
+            "dashboards",
+            "projects",
+            "signup-leads",
         ],
     },
     {
         heading: "Sourcing & search:",
-        commands: ["sourcing", "lead-sourcing", "search", "companies", "people", "find", "tools"],
+        commands: [
+            "sourcing",
+            "lead-sourcing",
+            "search",
+            "companies",
+            "people",
+            "find",
+            "tools",
+        ],
     },
     {
         heading: "Outbound & channels:",
         commands: [
-            "sequences", "senders", "inbox", "messages", "mailboxes",
-            "managed-inboxes", "deliverability", "domains", "email", "schedules",
-            "suppressions", "egress", "linkedin", "connections", "followers",
-            "viewers", "posts", "engagement", "whatsapp", "publishing", "notetaker",
+            "sequences",
+            "senders",
+            "inbox",
+            "messages",
+            "mailboxes",
+            "managed-inboxes",
+            "deliverability",
+            "domains",
+            "email",
+            "schedules",
+            "suppressions",
+            "egress",
+            "linkedin",
+            "connections",
+            "followers",
+            "viewers",
+            "posts",
+            "engagement",
+            "whatsapp",
+            "publishing",
+            "notetaker",
             "reviews",
         ],
     },
@@ -51,8 +102,16 @@ const HELP_GROUPS = [
     {
         heading: "Automation, billing & admin:",
         commands: [
-            "workflows", "integrations", "custom-integrations", "billing", "budget",
-            "observability", "worker", "db", "admin", "directory",
+            "workflows",
+            "integrations",
+            "custom-integrations",
+            "billing",
+            "budget",
+            "observability",
+            "worker",
+            "db",
+            "admin",
+            "directory",
         ],
     },
 ];
@@ -73,13 +132,16 @@ export function applyOxygenHelp(program, binaryName) {
         "",
         "Agent quickstart:",
         `  1. ${binaryName} login                      connect this terminal (or set OXYGEN_API_KEY)`,
-        `  2. ${binaryName} onboarding start --json    load workspace context + the skill that teaches the GTM loops`,
+        // `login` auto-installs the skills, but an agent authenticating with
+        // OXYGEN_API_KEY never runs it — without this step nothing on any
+        // first-touch surface names the skill that teaches the GTM loops.
+        `  2. ${binaryName} skills install --json      load the skills that teach the GTM loops (automatic after login)`,
         `  3. ${binaryName} commands --json            full machine-readable command grammar (this CLI's self-index)`,
         "",
         "Conventions:",
         "  --json prints a stable envelope {ok, data|error, meta}; errors always print it.",
-        "  Commands that spend credits or write to external platforms are gated: live runs",
-        "  require --approved --max-credits <n> and fail with a typed error until approved.",
+        "  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.",
         "",
         `Exit codes: ${exitCodeLine}`,