@oxygen-agent/cli 1.1011.487 → 1.1011.493

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.487
+Version: 1.1011.493

package/dist/index.js

@@ -4880,7 +4880,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--composio-action <slug>", "Override the Composio action slug for this scheduled post.")
         .option("--publish-at <iso>", "When the post publishes. With Z or an offset it is that exact instant; without one it is wall-clock time in --timezone, else the post's own timezone.")
         .option("--timezone <tz>", "IANA zone the post is shown in and a --publish-at without an offset is read in. Unchanged when omitted.")
-        .option("--status <status>", "draft or scheduled.")
+        .option("--status <status>", "draft or scheduled. Setting scheduled does not itself approve the post.")
         .option("--thread-post <text>", "X: text of the next post in a thread (posts 2, 3, ... in order). Repeatable.", collectRepeatable, [])
         .option("--thread-media <position=media_id>", "X: attach an uploaded media id to thread post N (2 or later), e.g. 2=<media_id>. Repeatable.", collectRepeatable, [])
         .option("--poll-option <text>", "X: a poll option on the first post (2-4 options, 25 characters each). Repeatable.", collectRepeatable, [])
@@ -4901,8 +4901,8 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         }));
     }))
         .addCommand(new Command("approve")
-        .description("Approve a scheduled post so the worker can publish it when due. LinkedIn approval resolves every inline @<public-identifier> and blocks with inspectable details if any mention cannot be verified.")
-        .argument("<post_id>", "Scheduled post id.")
+        .description("Approve a draft or scheduled post; drafts become scheduled for their saved publish time. Costs 0 credits. LinkedIn tags require numeric company IDs and matching resolved person handles; reuses current verified previews or performs free sender lookups. queued_at records first arming; publish_at controls publication. Program drafts require UGC approval.")
+        .argument("<post_id>", "Draft or scheduled post id.")
         .option("--json", "Print a JSON envelope.")
         .action(async (postId, options) => {
         await handleAsyncAction("publishing posts approve", options, () => requestOxygen(`/api/cli/publishing/posts/${encodeURIComponent(postId)}/approve`, {

package/node_modules/@oxygen/cli-ugc/dist/commands.js

@@ -471,7 +471,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         {
             action: "invite_create",
             command: "creators invite",
-            description: "Preview an invitation email (0 credits) for one creator (--email) or up to 50 at once (--emails); send with --approved --preview-token from that preview and the same recipients. Use --link-only to create links without email. Placeholder addresses (example.com, .test, .invalid) are refused on every path, --link-only included, and nothing is created. The default email names the program and carries the join link, not the brief or posting target; add those with --email-message. A refused email ends ugc_invitation_email_not_sent; the created invitation and its link are in error.details.",
+            description: "Preview an invitation email (0 credits) for one creator (--email) or up to 50 at once (--emails); send with --approved --preview-token from that preview and the same recipients. Use --link-only to create links without email. Add --sponsor to sponsor each creator's LinkedIn account when they accept: the preview shows the monthly credit reservation, approving the invitation approves it, and it needs a signed-in administrator (not an org API key). Placeholder addresses (example.com, .test, .invalid) are refused on every path, --link-only included, and nothing is created. The default email names the program and carries the join link, not the brief or posting target; add those with --email-message. A refused email ends ugc_invitation_email_not_sent; the created invitation and its link are in error.details.",
             fields: [
                 {
                     name: "program_id",
@@ -509,16 +509,22 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                     description: "Your own message (up to 3,000 characters); the Accept button and join link are always added below it. Omit for the default.",
                     required: false,
                 },
+                {
+                    name: "sponsor",
+                    kind: "boolean",
+                    description: "Sponsor each creator's LinkedIn account when they accept: your workspace pays its monthly credit reservation (shown in the preview), from when they connect LinkedIn. With --link-only, preview first, then create the links with --approved --preview-token.",
+                    required: false,
+                },
                 {
                     name: "approved",
                     kind: "boolean",
-                    description: "Authorize sending the exact previewed invitation email.",
+                    description: "Authorize sending the exact previewed invitation email, or creating the previewed sponsored links.",
                     required: false,
                 },
                 {
                     name: "preview_token",
                     kind: "string",
-                    description: "Exact token from the invitation email preview.",
+                    description: "Exact token from the invitation preview.",
                     required: false,
                 },
             ],
@@ -1245,14 +1251,14 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         if (spec.help)
             command.addHelpText("after", spec.help);
         for (const field of spec.fields) {
-            const flag = `--${(field.flag ?? field.name).replaceAll("_", "-")}${field.name === "approved" || field.name === "risk_acknowledged" ? "" : ` <${field.kind === "array" || field.kind === "object" ? "json" : field.kind === "boolean" ? "true|false" : field.kind === "posting_target" ? "n/month|n/week|n/total|none" : field.kind === "email_list" ? "emails" : field.kind === "text_list" ? "a, b" : "value"}>`}`;
+            const flag = `--${(field.flag ?? field.name).replaceAll("_", "-")}${field.name === "approved" || field.name === "risk_acknowledged" || field.name === "sponsor" ? "" : ` <${field.kind === "array" || field.kind === "object" ? "json" : field.kind === "boolean" ? "true|false" : field.kind === "posting_target" ? "n/month|n/week|n/total|none" : field.kind === "email_list" ? "emails" : field.kind === "text_list" ? "a, b" : "value"}>`}`;
             if (field.required)
                 command.requiredOption(flag, field.description);
             else
                 command.option(flag, field.description);
         }
         if (spec.action === "invite_create")
-            command.option("--link-only", "Create the invitation now and return its shareable link: no preview or approval token, no email, 0 credits.");
+            command.option("--link-only", "Create the invitation now and return its shareable link: no email, 0 credits. No preview or approval token, unless you add --sponsor.");
         command
             .option("--json", "Print a JSON envelope.")
             .action((options) => handle(`ugc ${spec.command}`, options, () => {
@@ -1269,8 +1275,8 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 if ((body.email === undefined) === (body.emails === undefined))
                     throw new UgcUsageError("Pass exactly one of --email or --emails.");
                 body.send_email = options.linkOnly !== true;
-                if (options.linkOnly && (body.approved || body.preview_token))
-                    throw new UgcUsageError("--link-only cannot be combined with --approved or --preview-token.");
+                if (options.linkOnly && !body.sponsor && (body.approved || body.preview_token))
+                    throw new UgcUsageError("--link-only cannot be combined with --approved or --preview-token, unless you add --sponsor.");
             }
             return requestOxygen("/api/cli/ugc", {
                 method: "POST",

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1011.487";
+export declare const OXYGEN_BUILD_VERSION = "1.1011.493";

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

package/package.json

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