@oxygen-agent/cli 1.256.13 → 1.263.0

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.256.13
+Version: 1.263.0

package/dist/index.js

@@ -308,6 +308,7 @@ function normalizeDeleteRowIds(values) {
     }
     return rowIds;
 }
+const CUSTOM_HTTP_MANIFEST_DOCS_URL = "https://oxygen-agent.com/docs/providers/custom-http";
 function readCustomIntegrationManifest(options) {
     const manifestPath = readOption(options.manifest);
     const manifestJson = readOption(options.manifestJson);
@@ -321,21 +322,38 @@ function readCustomIntegrationManifest(options) {
             exitCode: 1,
         });
     }
-    return parseJsonObject(manifestJson ?? readFileSync(resolve(manifestPath ?? ""), "utf8"));
+    if (manifestJson)
+        return parseJsonObject(manifestJson);
+    const filePath = resolve(manifestPath ?? "");
+    let content;
+    try {
+        content = readFileSync(filePath, "utf8");
+    }
+    catch (error) {
+        const notFound = error?.code === "ENOENT";
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new OxygenError("invalid_request", notFound
+            ? `Manifest file not found: ${filePath}. Pass --manifest <path.json> or --manifest-json '<json>'. See ${CUSTOM_HTTP_MANIFEST_DOCS_URL}`
+            : `Could not read manifest file ${filePath}: ${reason}. See ${CUSTOM_HTTP_MANIFEST_DOCS_URL}`, { details: { path: filePath }, exitCode: 1 });
+    }
+    try {
+        return parseJsonObject(content);
+    }
+    catch (error) {
+        if (error instanceof OxygenError) {
+            throw new OxygenError(error.code, `Manifest file ${filePath} is invalid: ${error.message} See ${CUSTOM_HTTP_MANIFEST_DOCS_URL}`, {
+                details: { path: filePath, ...(isRecord(error.details) ? error.details : {}) },
+                exitCode: error.exitCode,
+            });
+        }
+        throw error;
+    }
 }
 const CUSTOM_INTEGRATION_SECRET_KEYS = ["API_KEY", "TOKEN", "PASSWORD", "SECRET"];
 function readCustomIntegrationSecret(options) {
-    const apiKey = readOption(options.apiKey);
     const secretsFile = readOption(options.secretsFile);
-    if (apiKey && secretsFile) {
-        throw new OxygenError("invalid_request", "Pass either --api-key or --secrets-file, not both.", {
-            exitCode: 1,
-        });
-    }
-    if (apiKey)
-        return apiKey;
     if (!secretsFile) {
-        throw new OxygenError("invalid_request", "Pass --api-key or --secrets-file.", {
+        throw new OxygenError("invalid_request", "Pass --secrets-file.", {
             exitCode: 1,
         });
     }
@@ -627,6 +645,7 @@ function buildCrmRelationshipUpsertBody(object, rowId, options) {
             ...(readOption(options.targetObject) ? { object: readOption(options.targetObject) } : {}),
             row_id: options.targetRowId,
         },
+        ...(readOption(options.role) ? { role: readOption(options.role) } : {}),
         mode: resolveCrmSetupMode(options),
     };
 }
@@ -1636,6 +1655,7 @@ export function createProgram() {
         .requiredOption("--relationship <slug>", "Relationship slug from the source object, such as team or company.")
         .option("--target-object <object>", "Target CRM object slug. Optional when the relationship has one target.")
         .requiredOption("--target-row-id <row_id>", "Target CRM record row id.")
+        .option("--role <role>", "Buying-committee role for a deals.stakeholders link: champion, economic_buyer, decision_maker, influencer, or end_user.")
         .option("--dry-run", "Preview the relationship write without changing edges.")
         .option("--live", "Apply the relationship write. Default is dry-run.")
         .option("--json", "Print a JSON envelope.")
@@ -3248,9 +3268,11 @@ export function createProgram() {
         .requiredOption("--table <table>", "Table id or slug.")
         .option("--status <status>", "Filter by active, queued, running, paused, completed, completed_with_errors, failed, canceling, or canceled. Defaults to active.")
         .option("--limit <n>", "Maximum runs to return. Defaults to 20.")
+        .option("--format <format>", "Format run history as json, jsonl, csv, or table (same serializer as `tables export`). Omit to keep the default envelope output.")
+        .option("--output <path>", "Write the formatted run history to a file instead of embedding it in the response.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
-        await handleAsyncAction("table-runs list", options, () => requestOxygen(tableRunsListPath(options)));
+        await handleAsyncAction("table-runs list", options, () => listTableRuns(options));
     }))
         .addCommand(new Command("get")
         .description("Get one durable table action run.")
@@ -4459,7 +4481,6 @@ export function createProgram() {
         .addCommand(new Command("connect")
         .description("Attach the credential (bearer token, API key, or basic password) for an applied custom HTTP integration.")
         .argument("<slug>", "Custom integration slug from the applied manifest.")
-        .option("--api-key <value>", "Credential value. Prefer --secrets-file to keep it out of shell history.")
         .option("--secrets-file <path>", "Path to a .env-style file holding the credential (a single entry, or one named API_KEY/TOKEN/PASSWORD/SECRET).")
         .option("--json", "Print a JSON envelope.")
         .action(async (slug, options) => {
@@ -7033,6 +7054,26 @@ export function createProgram() {
         .option("--json", "Print a JSON envelope.")
         .action(async (domain, options) => {
         await handleAsyncAction("domains tracking status", options, () => requestOxygen(`/api/cli/domains/${encodeURIComponent(domain)}/tracking`));
+    })))
+        .addCommand(new Command("postmaster")
+        .description("Google Postmaster Tools onboarding for a sending domain: register it with Postmaster, publish the DNS verification TXT via its Cloudflare zone, and check verification status. FREE — 0 Oxygen credits.")
+        .addCommand(new Command("onboard")
+        .description("Register the domain with Google Postmaster Tools and publish the DNS verification TXT automatically via the domain's Cloudflare zone (or return the record for manual DNS); verification then completes automatically in the background. Without --approve, returns a preview. FREE — 0 Oxygen credits.")
+        .argument("<domain>", "Sending domain, such as acme.com.")
+        .option("--approve", "Perform the onboarding. Without this flag, returns a preview only.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (domain, options) => {
+        await handleAsyncAction("domains postmaster onboard", options, () => requestOxygen(`/api/cli/domains/${encodeURIComponent(domain)}/postmaster`, {
+            method: "POST",
+            body: { ...(options.approve ? { approved: true } : {}) },
+        }));
+    }))
+        .addCommand(new Command("status")
+        .description("Show the Google Postmaster Tools onboarding status for a domain: registration, DNS verification state, and whether reputation data is available. Read-only — 0 Oxygen credits.")
+        .argument("<domain>", "Sending domain, such as acme.com.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (domain, options) => {
+        await handleAsyncAction("domains postmaster status", options, () => requestOxygen(`/api/cli/domains/${encodeURIComponent(domain)}/postmaster`));
     })))
         .addCommand(new Command("add")
         .description("Onboard a domain registered elsewhere by creating a Cloudflare zone for it, so its DNS can be managed here. Returns the nameservers to set at your registrar. Idempotent.")
@@ -9503,6 +9544,33 @@ async function exportRows(table, options) {
         ...(formatted.rescuedCount > 0 ? { rescuedNumericCells: formatted.rescuedCount } : {}),
     };
 }
+// `table-runs list --format` routes run history through the same serializer
+// `tables export` uses, so csv/jsonl/table run exports behave exactly like row
+// exports (header = union of run keys; nested objects like counts are
+// JSON-stringified by escapeCsvField). Without --format/--output the command
+// keeps its original envelope response untouched.
+async function listTableRuns(options) {
+    const rawFormat = readOption(options.format);
+    const outputPath = readOption(options.output);
+    if (!rawFormat && !outputPath)
+        return requestOxygen(tableRunsListPath(options));
+    // Validate the format before spending the API call.
+    const format = normalizeExportRowsFormat(rawFormat ?? undefined);
+    const result = await requestOxygen(tableRunsListPath(options));
+    const runs = Array.isArray(result.runs) ? result.runs.filter(isRecord) : [];
+    const formatted = formatRows(runs, format);
+    if (outputPath)
+        writeFileSync(outputPath, formatted.content);
+    return {
+        table: result.table ?? null,
+        status: result.status ?? null,
+        format,
+        runCount: runs.length,
+        output: outputPath ?? null,
+        ...(outputPath ? {} : { content: formatted.content }),
+        ...(typeof result.web_url === "string" ? { web_url: result.web_url } : {}),
+    };
+}
 const TABLE_BUNDLE_SCHEMA_VERSION = 1;
 const TABLE_BUNDLE_MAX_PAGE_SIZE = 1000;
 const TABLE_BUNDLE_DEFAULT_PAGE_SIZE = 500;

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

@@ -1,2 +1,2 @@
-export declare const OXYGEN_VERSION = "1.256.13";
+export declare const OXYGEN_VERSION = "1.263.0";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";

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

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.256.13";
+export const OXYGEN_VERSION = "1.263.0";
 // Bump this only when deployed CLI/API contracts require a newer CLI.
 // 1.181.0: paid table action runs and background columns run require
 // approved=true in addition to max_credits; older CLIs cannot send the flag.

package/package.json

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