@oxygen-agent/cli 1.224.5 → 1.226.15

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.224.5
+Version: 1.226.15

package/dist/index.js

@@ -2189,6 +2189,7 @@ export function createProgram() {
         .option("--status <status>", "Filter by draft, active, or archived.")
         .option("--tags <csv>", "Comma-separated tags that must be present.")
         .option("--include-archived", "Include archived assets when no status filter is set.")
+        .option("--limit <n>", "Maximum assets to return. Defaults to 100; hard cap is 500.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("context assets list", options, () => requestOxygen(`/api/cli/context/assets${contextAssetsQuery(options)}`));
@@ -4551,9 +4552,12 @@ export function createProgram() {
     program.addCommand(new Command("engagement")
         .description("Harvest a LinkedIn post's engagers (reactors + commenters) into an enrollable CRM static list. The harvest runs as a slow, durable background drip under a dedicated conservative read budget — it never bursts and never starves the sequencer's own reads.")
         .addCommand(new Command("harvest")
-        .description("Start (or re-arm) a harvest of a post's engagers into a CRM static list you can enroll into a sequence. Engagers drip into the list over many ticks; poll `engagement status` to watch it fill. No messages are sent and no Oxygen credits are charged.")
-        .requiredOption("--post <social_id>", "Composite post social_id from `oxygen posts get` (NOT the activity URN).")
+        .description("Start (or re-arm) a harvest of a post's engagers into a CRM static list you can enroll into a sequence. Engagers drip into the list over many ticks; poll `engagement status` to watch it fill. No messages are sent. Cookieless harvests spend Oxygen credits per scraper page and require --max-credits.")
+        .requiredOption("--post <social_id_or_url>", "Composite post social_id from `oxygen posts get` (NOT the activity URN), or the public LinkedIn post URL for cookieless.")
         .requiredOption("--list <slug>", "CRM static list slug to fill (created or reused over the people object).")
+        .option("--source <source>", "cookieless|unipile. Defaults to cookieless when a public post URL is supplied.")
+        .option("--post-url <url>", "Public LinkedIn post URL for cookieless harvesting when --post is a social id.")
+        .option("--max-credits <credits>", "Required for cookieless harvesting; caps managed scraper spend for this armed run.")
         .option("--recurring", "Keep re-polling the newest pages for new engagers (default: one walk).")
         .option("--account <ref>", "Sender account that reads (sender id, connection id, or Unipile account id). Omit for the org default.")
         .option("--no-reactions", "Skip reactors.")
@@ -4564,11 +4568,17 @@ export function createProgram() {
             const post = readOption(options.post);
             const list = readOption(options.list);
             const account = readOption(options.account);
+            const source = readOption(options.source);
+            const postUrl = readOption(options.postUrl);
+            const maxCredits = readPositiveNumber(options.maxCredits);
             return requestOxygen("/api/cli/linkedin/engagement/harvest", {
                 method: "POST",
                 body: {
                     ...(post ? { post } : {}),
                     ...(list ? { list } : {}),
+                    ...(source ? { source } : {}),
+                    ...(postUrl ? { post_url: postUrl } : {}),
+                    ...(maxCredits !== undefined ? { max_credits: maxCredits } : {}),
                     ...(options.recurring ? { recurring: true } : {}),
                     ...(account ? { account } : {}),
                     // commander sets reactions/comments=false for --no-* flags.
@@ -4742,13 +4752,15 @@ export function createProgram() {
         .option("--responses-only", "Email only: only conversations with an inbound reply (never sent-only threads).")
         .option("--bucket <bucket>", "Email only: primary or others (superseded by --segment).")
         .option("--segment <segment>", "Email only: top-tab folder — primary, others, sent, warmup, or dmarc.")
-        .option("--status <keys>", "Email only: comma-separated status keys (e.g. interested,meeting_booked).")
+        .option("--status <keys>", "Comma-separated status keys (e.g. interested,meeting_booked). Cross-channel — filters email + LinkedIn + WhatsApp by the shared taxonomy.")
+        .option("--since <iso>", "Only conversations whose last message is on/after this ISO date/timestamp. Cross-channel.")
+        .option("--until <iso>", "Only conversations whose last message is on/before this ISO date/timestamp. Cross-channel.")
         .option("--sequence-id <ids>", "Email only: comma-separated campaign (sequence) ids.")
         .option("--provider <providers>", "Email only: comma-separated providers (google,microsoft).")
         .option("--domain <domains>", "Email only: comma-separated counterpart domains to include.")
         .option("--exclude-domain <domains>", "Email only: comma-separated counterpart domains to exclude.")
         .option("--mailbox-id <ids>", "Email only: comma-separated mailbox ids.")
-        .option("--search <text>", "Filter by attendee name or last-message text.")
+        .option("--search <text>", "Filter by attendee name or last-message text. Cross-channel.")
         .option("--include-archived", "Include archived conversations.")
         .option("--limit <n>", "Maximum conversations to return (1-200). Defaults to 50.")
         .option("--json", "Print a JSON envelope.")
@@ -4770,6 +4782,8 @@ export function createProgram() {
                 ["segment", "segment"],
                 ["channels", "channels"],
                 ["status", "status"],
+                ["since", "since"],
+                ["until", "until"],
                 ["sequenceId", "sequence_id"],
                 ["provider", "provider"],
                 ["domain", "domain"],
@@ -4863,15 +4877,19 @@ export function createProgram() {
         });
     }))
         .addCommand(new Command("archive")
-        .description("Archive an email conversation (triage it out of the inbox). --unarchive restores it.")
-        .argument("<conversation>", "Conversation id or Zapbox thread id.")
+        .description("Archive a conversation (triage it out of the inbox). --unarchive restores it. --channel linkedin/whatsapp archives a DM.")
+        .argument("<conversation>", "Conversation id, Unipile chat id, or (email) Zapbox thread id.")
+        .option("--channel <channel>", "Inbox channel: email (default), linkedin, or whatsapp.")
         .option("--unarchive", "Restore the conversation instead of archiving it.")
         .option("--json", "Print a JSON envelope.")
         .action(async (conversation, options) => {
-        await handleAsyncAction("inbox archive", options, () => requestOxygen(`/api/cli/inbox/${encodeURIComponent(conversation)}/archive`, {
-            method: "POST",
-            body: { channel: "email", archived: !options.unarchive },
-        }));
+        await handleAsyncAction("inbox archive", options, () => {
+            const channel = readOption(options.channel) ?? "email";
+            return requestOxygen(`/api/cli/inbox/${encodeURIComponent(conversation)}/archive`, {
+                method: "POST",
+                body: { channel, archived: !options.unarchive },
+            });
+        });
     }))
         .addCommand(new Command("sync")
         .description("Force a backstop inbox sync from Unipile for all active sender accounts (pulls recent chats + messages into the unibox).")
@@ -4940,6 +4958,36 @@ export function createProgram() {
                 body: { channel, confirm: Boolean(options.yes) },
             });
         });
+    }))
+        .addCommand(new Command("bulk")
+        .description("Bulk-apply one triage action — set-status / archive / unarchive — across up to 100 hand-picked conversations (the ids `inbox list` returns) in one call. Without --yes, previews the matched/would-change counts (no mutation). With --yes, applies it. --channel scopes the ids (email default; run once per channel).")
+        .requiredOption("--action <action>", "set-status, archive, or unarchive.")
+        .requiredOption("--ids <ids>", "Comma-separated conversation ids (the uuids `inbox list` returns). Max 100.")
+        .option("--status <key>", "Required for --action set-status: the status label key to set (e.g. interested).")
+        .option("--channel <channel>", "Inbox channel the ids belong to: email (default), linkedin, or whatsapp.")
+        .option("--yes", "Apply the action. Without this flag, returns a preview of the counts only.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("inbox bulk", options, () => {
+            // CLI uses hyphenated `set-status` for ergonomics; the API wants `set_status`.
+            const action = (readOption(options.action) ?? "").replace(/-/g, "_");
+            const channel = readOption(options.channel) ?? "email";
+            const status = readOption(options.status);
+            const ids = (readOption(options.ids) ?? "")
+                .split(",")
+                .map((id) => id.trim())
+                .filter(Boolean);
+            return requestOxygen("/api/cli/inbox/bulk", {
+                method: "POST",
+                body: {
+                    action,
+                    channel,
+                    conversation_ids: ids,
+                    ...(status ? { status } : {}),
+                    ...(options.yes ? { approved: true } : {}),
+                },
+            });
+        });
     }))
         .addCommand(new Command("labels")
         .description("Manage inbox status labels (the Instantly-style system set + custom labels).")
@@ -9893,6 +9941,9 @@ function contextAssetsQuery(options) {
         query.append("tag", tag);
     if (options.includeArchived)
         query.set("include_archived", "true");
+    const limit = readPositiveInt(options.limit);
+    if (limit !== undefined)
+        query.set("limit", String(limit));
     const value = query.toString();
     return value ? `?${value}` : "";
 }

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

@@ -7,6 +7,7 @@ export * from "./cli-envelope.js";
 export * from "./cli-result.js";
 export * from "./column-types.js";
 export * from "./credit-guidance.js";
+export * from "./linkedin-post-url.js";
 export * from "./linkedin-sequences.js";
 export * from "./networks.js";
 export * from "./sequences.js";

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

@@ -7,6 +7,7 @@ export * from "./cli-envelope.js";
 export * from "./cli-result.js";
 export * from "./column-types.js";
 export * from "./credit-guidance.js";
+export * from "./linkedin-post-url.js";
 export * from "./linkedin-sequences.js";
 export * from "./networks.js";
 export * from "./sequences.js";

package/node_modules/@oxygen/shared/dist/linkedin-post-url.d.ts

@@ -0,0 +1,2 @@
+export declare function isLinkedInPostUrlLike(value: string): boolean;
+export declare function normalizeLinkedInPostUrl(value: string): string | null;

package/node_modules/@oxygen/shared/dist/linkedin-post-url.js

@@ -0,0 +1,51 @@
+const LINKEDIN_HOST = "linkedin.com";
+const URL_LIKE_PATTERN = /^[a-z][a-z\d+.-]*:\/\//i;
+function normalizeHostname(hostname) {
+    return hostname.toLowerCase().replace(/\.+$/, "");
+}
+function isLinkedInHostname(hostname) {
+    const normalized = normalizeHostname(hostname);
+    return normalized === LINKEDIN_HOST || normalized.endsWith(`.${LINKEDIN_HOST}`);
+}
+function safelyDecodePath(pathname) {
+    try {
+        return decodeURIComponent(pathname);
+    }
+    catch {
+        return pathname;
+    }
+}
+function isLinkedInPostPath(pathname) {
+    const path = safelyDecodePath(pathname).toLowerCase();
+    return /^\/posts\/[^/]+\/?$/.test(path) || /^\/feed\/update\/urn:li:activity:[^/]+\/?$/.test(path);
+}
+export function isLinkedInPostUrlLike(value) {
+    const trimmed = value.trim();
+    return URL_LIKE_PATTERN.test(trimmed) || trimmed.toLowerCase().includes("linkedin.com");
+}
+export function normalizeLinkedInPostUrl(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+        return null;
+    const hostname = normalizeHostname(url.hostname);
+    if (!isLinkedInHostname(hostname))
+        return null;
+    if (!isLinkedInPostPath(url.pathname))
+        return null;
+    url.protocol = "https:";
+    url.hostname = hostname;
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+}

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

@@ -1,2 +1,2 @@
-export declare const OXYGEN_VERSION = "1.224.5";
+export declare const OXYGEN_VERSION = "1.226.15";
 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.224.5";
+export const OXYGEN_VERSION = "1.226.15";
 // 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.224.5",
+  "version": "1.226.15",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",