@oxygen-agent/cli 1.1033.19 → 1.1034.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -34,4 +34,4 @@ oxygen update
34
34
 
35
35
  For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
36
36
 
37
- Version: 1.1033.19
37
+ Version: 1.1034.14
@@ -83,6 +83,7 @@ function buildPublishingPostCreateBody(options) {
83
83
  const provider = readOption(options.provider);
84
84
  const channel = readOption(options.channel);
85
85
  const providerConnection = readOption(options.providerConnection);
86
+ const name = readOption(options.name);
86
87
  const title = readOption(options.title);
87
88
  const timezone = readOption(options.timezone);
88
89
  const ugcParticipationId = readOption(options.ugcParticipationId);
@@ -96,6 +97,8 @@ function buildPublishingPostCreateBody(options) {
96
97
  body.sender_account_id = sender;
97
98
  if (providerConnection)
98
99
  body.provider_connection_id = providerConnection;
100
+ if (name)
101
+ body.name = name;
99
102
  if (title)
100
103
  body.title = title;
101
104
  if (timezone)
@@ -212,6 +215,14 @@ function parsePollDurationMinutes(value) {
212
215
  }
213
216
  function buildPublishingPostUpdateBody(options) {
214
217
  const body = {};
218
+ const name = readOption(options.name);
219
+ if (name && options.clearName) {
220
+ throw new OxygenError("invalid_request", "Choose --name or --clear-name, not both.", { exitCode: 2 });
221
+ }
222
+ if (name)
223
+ body.name = name;
224
+ if (options.clearName)
225
+ body.name = null;
215
226
  const sender = readOption(options.sender);
216
227
  const provider = readOption(options.provider);
217
228
  const channel = readOption(options.channel);
@@ -297,7 +308,7 @@ async function withPublishingMediaOption(body, options, mode) {
297
308
  return { ...body, content_merge: { ...merge, media_asset_ids: mediaAssetIds } };
298
309
  }
299
310
  /**
300
- * The video cover flags (LinkedIn videos, Instagram Reels): a media id, a local file uploaded first, or
311
+ * The video cover flags (LinkedIn videos, Instagram Reels, YouTube videos): a media id, a local file uploaded first, or
301
312
  * (update only) a clear. Sent as the top-level `video_thumbnail_media_asset_id`,
302
313
  * which the server merges into content, so the post's attachments are untouched.
303
314
  */
@@ -808,7 +819,7 @@ export function registerPublishingFamily(program, handleAsyncAction) {
808
819
  .addCommand(new Command("posts")
809
820
  .description("Manage scheduled Publishing posts.")
810
821
  .addCommand(new Command("list")
811
- .description("List scheduled posts by publish time, oldest first; pass --order newest for the latest first. Follow next_cursor for more than one page.")
822
+ .description("List scheduled posts by publish time, oldest first (--order newest reverses it); follow next_cursor for more. Each carries its post's name; a multi-channel post's channels are under group.")
812
823
  .option("--status <status>", "Filter by draft, scheduled, queued, publishing, published, failed, or canceled.")
813
824
  .option("--approval-status <status>", "Filter by draft, needs_approval, approved, or rejected.")
814
825
  .option("--tag <tag>", "Only posts carrying this workspace tag.")
@@ -828,8 +839,9 @@ export function registerPublishingFamily(program, handleAsyncAction) {
828
839
  .option("--provider <provider>", "Publishing provider: linkedin, x, instagram, tiktok, facebook, or youtube. Defaults to linkedin. LinkedIn publishes through --sender; every other provider publishes through a connected account (--provider-connection), which the worker needs before it can deliver.")
829
840
  .option("--channel <channel>", "Publishing channel override. Defaults to provider.")
830
841
  .option("--sender <sender_account_id>", "LinkedIn sender account id. Required for LinkedIn before the worker can publish.")
831
- .option("--provider-connection <connection_id>", "Oxygen integration connection id for Composio-backed providers. Find it with `integrations list` (each integration's connection); create one with `integrations connect <provider>` (an OAuth redirect URL, or Settings > Connections on the web).")
832
- .option("--title <title>", "Title. YouTube and TikTok publish it as the video title; on other channels it only labels the post in the queue.")
842
+ .option("--provider-connection <connection_id>", "Oxygen integration connection id of the account for every provider but LinkedIn. Find it with `integrations list` (each integration's connection); create one with `integrations connect <provider>` (an OAuth redirect URL, or Settings > Connections on the web).")
843
+ .option("--name <name>", "The post's name in the Posts list, board and calendar, shared by all its channels; never published. With --group-with, a new name renames the whole post.")
844
+ .option("--title <title>", "Title. YouTube and TikTok publish it as the video title; elsewhere it only labels a post without --name.")
833
845
  .option("--text <text>", "Post text. On LinkedIn, tag a person with @<public-identifier> and a company page with @<handle> from its linkedin.com/company/<handle> URL.")
834
846
  .option("--text-file <path>", "Read post text from a local file.")
835
847
  .option("--content-json <json>", "Structured content. Use media_asset_ids for Oxygen uploads. LinkedIn attachments require [{content:<base64>,content_type:<MIME>,filename:<name>}]; content.mentions is rejected, so put verified @<public-identifier> values in --text. X options have their own flags (--thread-post, --poll-option, --reply-settings, --alt-text, --photo-tag); raw X API keys can still ride in composio.arguments.")
@@ -849,8 +861,8 @@ export function registerPublishingFamily(program, handleAsyncAction) {
849
861
  .option("--reply-settings <who>", "X: who can reply: everyone, following, mentioned, or subscribers.")
850
862
  .option("--alt-text <media_id=text>", "X: image or GIF description for screen readers (up to 1,000 characters). Repeatable.", collectRepeatable, [])
851
863
  .option("--photo-tag <username>", "X: tag an account in the first post's images (up to 10). Repeatable.", collectRepeatable, [])
852
- .option("--video-thumbnail <media_id>", "Video cover for a LinkedIn video or Instagram Reel: an uploaded media id (`publishing media upload`); JPEG or PNG on LinkedIn, a JPEG up to 8 MB on Instagram. Needs a video in media_asset_ids (first on Instagram).")
853
- .option("--video-thumbnail-file <path>", "Upload a local image and use it as the video cover (JPEG or PNG on LinkedIn, JPEG on Instagram).")
864
+ .option("--video-thumbnail <media_id>", "Video cover for a LinkedIn video, Instagram Reel or YouTube video: an uploaded media id (`publishing media upload`); JPEG or PNG on LinkedIn, a JPEG up to 8 MB on Instagram, a JPEG or PNG up to 2 MB on YouTube. Needs a video in media_asset_ids (first on Instagram and YouTube).")
865
+ .option("--video-thumbnail-file <path>", "Upload a local image and use it as the video cover (JPEG or PNG on LinkedIn, JPEG on Instagram, JPEG or PNG up to 2 MB on YouTube).")
854
866
  .option("--media <media_id>", "Attach an uploaded media id (`publishing media upload`) to this channel's post, in order. Repeatable. Each channel of a post has its own media: pass other ids with --group-with to give a channel different files, or the same ids to share one upload.", collectRepeatable, [])
855
867
  .option("--media-file <path>", "Upload a local image, video or PDF and attach it to this channel's post, after any --media. Repeatable.", collectRepeatable, [])
856
868
  .option("--json", "Print a JSON envelope.")
@@ -861,7 +873,7 @@ export function registerPublishingFamily(program, handleAsyncAction) {
861
873
  }));
862
874
  }))
863
875
  .addCommand(new Command("get")
864
- .description("Get one scheduled post with the sender account it publishes from (id, name, profile URL), resolved media previews, its video cover, and attempt history. For an X post, publish_plan lists every post that will be sent, in order, with media, alt text, poll and reply settings (free); for a LinkedIn post that tags a company page, it shows the text sent, each company tag as its page id, once `publishing posts approve` has resolved the tags (before approval it is absent). For a post that goes out on several channels, group lists every channel with its post id, account, copy, time and status. Open web_url to preview the post as it will look on LinkedIn or X.")
876
+ .description("Get one scheduled post with the sender account it publishes from (id, name, profile URL), resolved media previews, its video cover, and attempt history. For an X post, publish_plan lists every post that will be sent, in order, with media, alt text, poll and reply settings (free); for a LinkedIn post that tags a company page, it shows the text sent, each company tag as its page id, once `publishing posts approve` has resolved the tags (before approval it is absent). For a post that goes out on several channels, group gives its name and lists every channel with its post id, account, copy, time and status. Open web_url to preview the post as it will look on LinkedIn or X.")
865
877
  .argument("<post_id>", "Scheduled post id.")
866
878
  .option("--json", "Print a JSON envelope.")
867
879
  .action(async (postId, options) => {
@@ -873,8 +885,10 @@ export function registerPublishingFamily(program, handleAsyncAction) {
873
885
  .option("--provider <provider>", "Publishing provider: linkedin, x, instagram, tiktok, facebook, or youtube.")
874
886
  .option("--channel <channel>", "Publishing channel override.")
875
887
  .option("--sender <sender_account_id>", "LinkedIn sender account id.")
876
- .option("--provider-connection <connection_id>", "Oxygen integration connection id for Composio-backed providers.")
877
- .option("--title <title>", "Title. YouTube and TikTok publish it as the video title; on other channels it only labels the post in the queue.")
888
+ .option("--provider-connection <connection_id>", "Oxygen integration connection id of the account for every provider but LinkedIn.")
889
+ .option("--name <name>", "Rename the post, every channel of it. Works on any status and keeps approval.")
890
+ .option("--clear-name", "Remove the post's name; the views show its first line again.")
891
+ .option("--title <title>", "Title. YouTube and TikTok publish it as the video title; elsewhere it only labels a post without --name.")
878
892
  .option("--text <text>", "Post text. On LinkedIn, tag a person with @<public-identifier> and a company page with @<handle> from its linkedin.com/company/<handle> URL.")
879
893
  .option("--text-file <path>", "Read post text from a local file.")
880
894
  .option("--content-json <json>", "Structured content. Use media_asset_ids for Oxygen uploads. LinkedIn attachments require [{content:<base64>,content_type:<MIME>,filename:<name>}]; content.mentions is rejected, so put verified @<public-identifier> values in --text. This replaces the existing content object; use --content-merge-json or the X flags to change single keys.")
@@ -892,8 +906,8 @@ export function registerPublishingFamily(program, handleAsyncAction) {
892
906
  .option("--alt-text <media_id=text>", "X: image or GIF description for screen readers (up to 1,000 characters). Repeatable.", collectRepeatable, [])
893
907
  .option("--photo-tag <username>", "X: tag an account in the first post's images (up to 10). Repeatable.", collectRepeatable, [])
894
908
  .option("--content-merge-json <json>", "Merge content keys; null removes a key, e.g. '{\"poll\":null}'. Arrays, including mention_previews, are replaced whole: carry every entry you want to keep.")
895
- .option("--video-thumbnail <media_id>", "Set the video cover of a LinkedIn video or Instagram Reel to an uploaded media id (`publishing media upload`); JPEG or PNG on LinkedIn, a JPEG up to 8 MB on Instagram. The post needs a video attached (first on Instagram).")
896
- .option("--video-thumbnail-file <path>", "Upload a local image and set it as the video cover (JPEG or PNG on LinkedIn, JPEG on Instagram). To pick a frame from the video instead, open the post's web_url and use Cover.")
909
+ .option("--video-thumbnail <media_id>", "Set the video cover of a LinkedIn video, Instagram Reel or YouTube video to an uploaded media id (`publishing media upload`); JPEG or PNG on LinkedIn, a JPEG up to 8 MB on Instagram, a JPEG or PNG up to 2 MB on YouTube. The post needs a video attached (first on Instagram and YouTube).")
910
+ .option("--video-thumbnail-file <path>", "Upload a local image and set it as the video cover (JPEG or PNG on LinkedIn, JPEG on Instagram, JPEG or PNG up to 2 MB on YouTube). To pick a frame from the video instead, open the post's web_url and use Cover.")
897
911
  .option("--clear-video-thumbnail", "Remove the video cover.")
898
912
  .option("--media <media_id>", "Replace this channel's attachments with uploaded media ids, in order; the post's other channels keep theirs. Repeatable. Revokes approval on an approved post.", collectRepeatable, [])
899
913
  .option("--media-file <path>", "Upload a local image, video or PDF and attach it, after any --media; together they replace this channel's attachments. Repeatable.", collectRepeatable, [])
@@ -1077,7 +1091,7 @@ export function registerPublishingFamily(program, handleAsyncAction) {
1077
1091
  .option("--publish-at <iso>", "ISO date-time to schedule the post for; without an offset it is wall-clock time in --timezone. Defaults to now (still needs approval).")
1078
1092
  .option("--channel <channel>", "Channel override. Defaults to the draft's first target channel.")
1079
1093
  .option("--sender <sender_account_id>", "LinkedIn sender account id.")
1080
- .option("--provider-connection <connection_id>", "Oxygen integration connection id for Composio-backed providers.")
1094
+ .option("--provider-connection <connection_id>", "Oxygen integration connection id of the account for every provider but LinkedIn.")
1081
1095
  .option("--timezone <tz>", "IANA zone the post is shown in and a --publish-at without an offset is read in. Defaults to UTC.")
1082
1096
  .option("--json", "Print a JSON envelope.")
1083
1097
  .action(async (draftId, options) => {
@@ -1116,7 +1130,7 @@ export function registerPublishingFamily(program, handleAsyncAction) {
1116
1130
  .addCommand(new Command("media")
1117
1131
  .description("Manage Publishing media uploads.")
1118
1132
  .addCommand(new Command("upload")
1119
- .description("Upload a local image, video, or PDF in one step and print its media id. Attach it with --content-json '{\"media_asset_ids\":[...]}', or use an image as a video cover (LinkedIn, Instagram Reels) with `publishing posts update --video-thumbnail`.")
1133
+ .description("Upload a local image, video, or PDF in one step and print its media id. Attach it with --content-json '{\"media_asset_ids\":[...]}', or use an image as a video cover (LinkedIn, Instagram Reels, YouTube) with `publishing posts update --video-thumbnail`.")
1120
1134
  .argument("<path>", "Local file path.")
1121
1135
  .option("--content-type <type>", "MIME type when the file extension does not say it, such as video/mp4.")
1122
1136
  .option("--scheduled-post <post_id>", "Optional provenance association; it does not attach the file to the post.")
@@ -22,6 +22,12 @@ export declare const X_PREMIUM_MAX_CHARS = 25000;
22
22
  * specific error instead of a generic schema rejection.
23
23
  */
24
24
  export declare const PUBLISHING_CONTENT_MAX_CHARS = 25000;
25
+ /**
26
+ * A post's name: OXYGEN's label for the whole post, shared by its channels and
27
+ * never sent to one. The store refuses a longer one; the web crumb holds to it so
28
+ * a first save never fails on the name.
29
+ */
30
+ export declare const PUBLISHING_POST_NAME_MAX_CHARS = 200;
25
31
  /**
26
32
  * Meta fetches an Instagram Reel's `cover_url` itself and takes a JPEG of at most
27
33
  * 8 MB (decimal, the conservative reading). The post write, the editor's picker
@@ -29,3 +35,15 @@ export declare const PUBLISHING_CONTENT_MAX_CHARS = 25000;
29
35
  * reaches a publish.
30
36
  */
31
37
  export declare const INSTAGRAM_REEL_COVER_MAX_BYTES = 8000000;
38
+ /**
39
+ * YouTube takes a custom thumbnail as a JPEG or PNG of at most 2 MB (decimal,
40
+ * the conservative reading). The post write, the editor's picker and the worker
41
+ * hold a YouTube cover to it (Plain T-414, OXP-1.19.27).
42
+ */
43
+ export declare const YOUTUBE_COVER_MAX_BYTES = 2000000;
44
+ /**
45
+ * A covered public YouTube upload starts private with YouTube publishing it on
46
+ * its own this long after the upload began, in case the switch to public fails.
47
+ * The worker sets it; the post page drops its "not public yet" notice after it.
48
+ */
49
+ export declare const YOUTUBE_COVER_PUBLISH_FALLBACK_MS: number;
@@ -22,6 +22,12 @@ export const X_PREMIUM_MAX_CHARS = 25_000;
22
22
  * specific error instead of a generic schema rejection.
23
23
  */
24
24
  export const PUBLISHING_CONTENT_MAX_CHARS = X_PREMIUM_MAX_CHARS;
25
+ /**
26
+ * A post's name: OXYGEN's label for the whole post, shared by its channels and
27
+ * never sent to one. The store refuses a longer one; the web crumb holds to it so
28
+ * a first save never fails on the name.
29
+ */
30
+ export const PUBLISHING_POST_NAME_MAX_CHARS = 200;
25
31
  /**
26
32
  * Meta fetches an Instagram Reel's `cover_url` itself and takes a JPEG of at most
27
33
  * 8 MB (decimal, the conservative reading). The post write, the editor's picker
@@ -29,3 +35,15 @@ export const PUBLISHING_CONTENT_MAX_CHARS = X_PREMIUM_MAX_CHARS;
29
35
  * reaches a publish.
30
36
  */
31
37
  export const INSTAGRAM_REEL_COVER_MAX_BYTES = 8_000_000;
38
+ /**
39
+ * YouTube takes a custom thumbnail as a JPEG or PNG of at most 2 MB (decimal,
40
+ * the conservative reading). The post write, the editor's picker and the worker
41
+ * hold a YouTube cover to it (Plain T-414, OXP-1.19.27).
42
+ */
43
+ export const YOUTUBE_COVER_MAX_BYTES = 2_000_000;
44
+ /**
45
+ * A covered public YouTube upload starts private with YouTube publishing it on
46
+ * its own this long after the upload began, in case the switch to public fails.
47
+ * The worker sets it; the post page drops its "not public yet" notice after it.
48
+ */
49
+ export const YOUTUBE_COVER_PUBLISH_FALLBACK_MS = 30 * 60 * 1000;
@@ -1,3 +1,3 @@
1
1
  export declare const OXYGEN_VERSION: string;
2
- export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.974";
2
+ export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.1091";
3
3
  export declare const GEO_EXPORT_MINIMUM_CLI_VERSION = "1.1013.0";
@@ -1 +1 @@
1
- export declare const OXYGEN_BUILD_VERSION = "1.1033.19";
1
+ export declare const OXYGEN_BUILD_VERSION = "1.1034.14";
@@ -1,2 +1,2 @@
1
1
  // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
2
- export const OXYGEN_BUILD_VERSION = "1.1033.19";
2
+ export const OXYGEN_BUILD_VERSION = "1.1034.14";
@@ -49,7 +49,7 @@ export const OXYGEN_VERSION = OXYGEN_BUILD_VERSION;
49
49
  // Since 2026-09-28 the release-preparation step advances this literal to the
50
50
  // highest CLI version published on npm for at least 30 days. It never lowers
51
51
  // the floor. The source change lands on dev before the next production release.
52
- export const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.974";
52
+ export const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.1091";
53
53
  // The internal GEO export first gains required pagination in this dev version.
54
54
  // Earlier pilot clients would save a partial file without its continuation.
55
55
  export const GEO_EXPORT_MINIMUM_CLI_VERSION = "1.1013.0";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oxygen-agent/cli",
3
- "version": "1.1033.19",
3
+ "version": "1.1034.14",
4
4
  "private": false,
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",