@rolino/cli 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @rolino/cli
 
+## 0.3.0
+
+### Minor Changes
+
+- 5267911: Add LinkedIn member publishing as a gated provider across public contracts, SDK, CLI, and MCP workflows.
+
+### Patch Changes
+
+- Updated dependencies [5267911]
+  - @rolino/contracts@0.3.0
+  - @rolino/sdk@0.3.0
+  - @rolino/local-auth@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 7d34580: Add account-specific TikTok delivery options, explicit settings review, safe partial draft updates, provider-keyed post settings, and streamed media uploads with server-verified metadata.
+
+### Patch Changes
+
+- Updated dependencies [7d34580]
+  - @rolino/contracts@0.2.0
+  - @rolino/sdk@0.2.0
+  - @rolino/local-auth@0.2.0
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -6,9 +6,9 @@ Network requests go through `@rolino/sdk`, which uses the Node.js native
 `fetch` implementation; the CLI does not depend on Axios or another HTTP
 client package.
 
-## Installation
-
-The supported installation keeps the CLI independent from MCP:
+## Installation
+
+The supported installation keeps the CLI independent from MCP:
 
 ```bash
 npm install --global @rolino/cli
@@ -36,19 +36,20 @@ rolino setup mcp --client claude-code [--scope user|project]
 rolino whoami
 rolino projects create --name NAME [--type PRODUCT|SERVICE|PERSONAL|COMPANY] [--website URL] [--description TEXT] [--idempotency-key KEY] --yes
 rolino projects list [--limit 50] [--cursor ID]
-rolino projects show PROJECT_ID
-rolino media list --project PROJECT_ID [--type IMAGE|VIDEO] [--query TEXT] [--limit 50] [--cursor ID]
-rolino media upload FILE_PATH --project PROJECT_ID --yes
-rolino posts create --project PROJECT_ID --caption TEXT [--platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY] [--media ASSET_ID] --yes
-rolino posts update POST_ID --project PROJECT_ID --expected-version VERSION --caption TEXT [--platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY] [--media ASSET_ID] --yes
+rolino projects show PROJECT_ID
+rolino media list --project PROJECT_ID [--type IMAGE|VIDEO] [--query TEXT] [--limit 50] [--cursor ID]
+rolino media upload FILE_PATH --project PROJECT_ID --yes
+rolino posts create --project PROJECT_ID --caption TEXT [--platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY|LINKEDIN] [--media ASSET_ID] --yes
+rolino posts update POST_ID --project PROJECT_ID --expected-version VERSION [--caption TEXT] [--platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY|LINKEDIN] [--media ASSET_ID] [--clear-platforms] [--clear-media] --yes
 rolino posts list --project PROJECT_ID [--limit 50] [--cursor ID] [--status STATUS]
 rolino posts show POST_ID --project PROJECT_ID
 rolino posts readiness POST_ID --project PROJECT_ID
 rolino posts schedule preview POST_ID --project PROJECT_ID --expected-version VERSION --at ISO_DATE --timezone IANA_TIMEZONE
 rolino posts schedule execute POST_ID --project PROJECT_ID --expected-version VERSION --at ISO_DATE --timezone IANA_TIMEZONE --confirmation-token TOKEN [--idempotency-key KEY]
-rolino posts publish preview POST_ID --project PROJECT_ID --expected-version VERSION --platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY
-rolino posts publish execute POST_ID --project PROJECT_ID --expected-version VERSION --platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY --confirmation-token TOKEN [--idempotency-key KEY]
+rolino posts publish preview POST_ID --project PROJECT_ID --expected-version VERSION --platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY|LINKEDIN
+rolino posts publish execute POST_ID --project PROJECT_ID --expected-version VERSION --platform INSTAGRAM|TIKTOK|YOUTUBE|BLUESKY|LINKEDIN --confirmation-token TOKEN [--idempotency-key KEY]
 rolino integrations health --project PROJECT_ID
+rolino integrations delivery-options --project PROJECT_ID --provider TIKTOK|LINKEDIN
 rolino calendar list --project PROJECT_ID [--from ISO_DATE --to ISO_DATE] [--limit 50] [--cursor CURSOR]
 rolino doctor
 ```
@@ -78,17 +79,21 @@ directory. Existing file-backed configuration is backed up with a
 `.rolino-backup` suffix. Use `--dry-run` to preview in scripts and `--yes` to
 provide explicit non-interactive consent; `--agent` never implies consent.
 
-Draft creation and update never schedule or publish. Both require interactive
+Draft creation and update never schedule or publish. Updates change only the
+fields supplied; omitted media, destinations, captions, and provider settings
+are preserved. Both require interactive
 confirmation or `--yes`; non-interactive and agent-mode calls fail before an
 HTTP request unless `--yes` is present. Retries use `--idempotency-key` (the
 request ID by default), and updates require the current `--expected-version`
-shown by `posts show` so stale automation cannot overwrite a newer edit.
-
-Media uploads use the deployment's existing local, S3-compatible, or
-Cloudflare R2 storage. The CLI validates the local file, requests a short-lived
-signed upload, sends bytes directly to storage, and registers the reusable
-asset only after the stored size and content type match. Uploading requires
-interactive confirmation or `--yes` and never creates or schedules a post.
+shown by `posts show` so stale automation cannot overwrite a newer edit.
+
+Media uploads use the deployment's existing local, S3-compatible, or
+Cloudflare R2 storage. The CLI validates the local file, requests a short-lived
+signed upload, streams the file directly to storage, and registers the reusable
+asset only after the stored size and content type match. Rolino derives image
+dimensions and video duration from bounded reads of the stored object rather
+than trusting caller metadata. Uploading requires
+interactive confirmation or `--yes` and never creates or schedules a post.
 
 YouTube drafts require exactly one stored video and explicit settings. Supply
 `--youtube-title`, `--youtube-category-id`, `--youtube-privacy`, and
@@ -101,19 +106,47 @@ description; otherwise Rolino uses the shared caption. For example:
 rolino posts create --project PROJECT_ID --caption "Launch description" --platform YOUTUBE --media VIDEO_ASSET_ID --youtube-title "Launch video" --youtube-category-id 22 --youtube-privacy PRIVATE --youtube-made-for-kids no --youtube-tag launch --yes
 ```
 
-Google may restrict uploads from unaudited API projects to Private. Rolino does
-not infer audit approval from configuration. A scheduled YouTube post must
-target Public; confirmed scheduling starts its private resumable upload
-immediately so processing can finish before the target time.
-
-Bluesky drafts can be text-only or include up to four stored JPEG, PNG, or WebP
-images. Use `--bluesky-caption` for a destination-specific override of up to
-300 graphemes:
-
-```text
-rolino posts create --project PROJECT_ID --caption "Shared launch" --platform BLUESKY --bluesky-caption "Launch day 🦋" --yes
-```
-
+Google may restrict uploads from unaudited API projects to Private. Rolino does
+not infer audit approval from configuration. A scheduled YouTube post must
+target Public; confirmed scheduling starts its private resumable upload
+immediately so processing can finish before the target time.
+
+TikTok drafts require account-specific choices. Refresh them immediately before
+preparing the draft:
+
+```text
+rolino integrations delivery-options --project PROJECT_ID --provider TIKTOK
+```
+
+For direct publishing, pass the exact returned visibility and explicit yes/no
+choices for comments, duet, stitch, commercial content, own-brand promotion,
+third-party promotion, and AI-generated content. Use `--tiktok-mode inbox` for
+a mobile inbox handoff. Add `--tiktok-settings-reviewed` only after reviewing
+those fresh choices; it is deliberately separate from `--yes`, which confirms
+the Rolino draft write. Editing TikTok caption, media, destinations, or its
+override clears the prior settings review.
+
+Bluesky drafts can be text-only or include up to four stored JPEG, PNG, or WebP
+images. Use `--bluesky-caption` for a destination-specific override of up to
+300 graphemes:
+
+```text
+rolino posts create --project PROJECT_ID --caption "Shared launch" --platform BLUESKY --bluesky-caption "Launch day 🦋" --yes
+```
+
+LinkedIn drafts can be text-only or include up to ten stored JPEG/PNG images.
+Refresh the connected member and server policy before preparing the draft, and
+use `--linkedin-caption` for a destination override:
+
+```text
+rolino integrations delivery-options --project PROJECT_ID --provider LINKEDIN
+rolino posts create --project PROJECT_ID --caption "Shared launch" --platform LINKEDIN --linkedin-caption "Launch day for our LinkedIn network" --media IMAGE_ASSET_ID --yes
+```
+
+The connected OAuth member is the author; the developer app's associated
+Company Page is not a publishing target. If final post creation has an unknown
+outcome, inspect that member's LinkedIn feed before retrying.
+
 Project creation also requires interactive confirmation or `--yes`. It
 atomically saves a project and its paired brand, but does not start research,
 connect accounts, schedule posts, or publish. A fresh CLI invocation generates
@@ -147,13 +180,14 @@ arguments. YouTube remains `PREPARING` while its resumable upload and provider
 processing are incomplete; only provider-confirmed visibility becomes
 published.
 
-The CLI cannot enable YouTube or Bluesky, or infer Google/YouTube approval.
-Those are server-side deployment controls. Self-hosted operators should
-complete the
-[YouTube operations guide](https://github.com/deifos/rolino/blob/main/docs/integrations/youtube.md)
-and
-[Bluesky operations guide](https://github.com/deifos/rolino/blob/main/docs/integrations/bluesky.md)
-before live testing.
+The CLI cannot enable YouTube, Bluesky, or LinkedIn, or infer provider approval.
+Those are server-side deployment controls. Self-hosted operators should
+complete the
+[YouTube operations guide](https://github.com/deifos/rolino/blob/main/docs/integrations/youtube.md)
+and
+[Bluesky operations guide](https://github.com/deifos/rolino/blob/main/docs/integrations/bluesky.md), and
+[LinkedIn operations guide](https://github.com/deifos/rolino/blob/main/docs/integrations/linkedin.md)
+before live testing.
 
 Configuration is read from `ROLINO_URL`, `ROLINO_TOKEN`, `ROLINO_CONFIG_DIR`,
 `ROLINO_OUTPUT`, `ROLINO_TIMEOUT`, and the short-lived
@@ -183,8 +217,8 @@ Stable exit codes:
 
 ## Support, security, and license
 
-Stable releases are published only after the maintainer approves the release
-gate. Report bugs through the
+Stable releases are published only after the maintainer approves the release
+gate. Report bugs through the
 [Rolino issue tracker](https://github.com/deifos/rolino/issues) and security
 issues through the repository's
 [security policy](https://github.com/deifos/rolino/security/policy).

package/dist/bin.cjs

@@ -25,6 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_node_crypto2 = require("crypto");
+var import_node_fs2 = require("fs");
 var import_promises2 = require("fs/promises");
 var import_node_path2 = require("path");
 var import_promises3 = require("readline/promises");
@@ -33,7 +34,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@rolino/cli",
-  version: "0.1.0",
+  version: "0.3.0",
   description: "Agent-friendly command-line interface for Rolino",
   type: "module",
   license: "MIT",
@@ -90,9 +91,9 @@ var package_default = {
     dev: "tsx src/bin.ts"
   },
   dependencies: {
-    "@rolino/contracts": "0.1.0",
-    "@rolino/local-auth": "0.1.0",
-    "@rolino/sdk": "0.1.0",
+    "@rolino/contracts": "0.3.0",
+    "@rolino/local-auth": "0.3.0",
+    "@rolino/sdk": "0.3.0",
     commander: "^15.0.0",
     open: "^11.0.0"
   },
@@ -476,7 +477,13 @@ function formatPost(post) {
     ] : [],
     ...post.publishedAt ? [`Published: ${post.publishedAt}`] : [],
     `Media: ${post.media.length}`,
-    `Destinations: ${post.destinations.map((destination) => `${destination.provider}:${queued && destination.status === "SCHEDULED" ? "QUEUED" : destination.status}`).join(", ") || "none"}`
+    `Destinations: ${post.destinations.map((destination) => `${destination.provider}:${queued && destination.status === "SCHEDULED" ? "QUEUED" : destination.status}`).join(", ") || "none"}`,
+    ...post.providerSettings?.TIKTOK ? [
+      `TikTok: ${post.providerSettings.TIKTOK.postMode}, ${post.providerSettings.TIKTOK.privacyLevel ?? "visibility not set"}, settings ${post.providerSettings.TIKTOK.consentedAt ? "reviewed" : "not reviewed"}`
+    ] : [],
+    ...post.providerSettings?.YOUTUBE ? [
+      `YouTube: ${post.providerSettings.YOUTUBE.privacyStatus}, ${post.providerSettings.YOUTUBE.title}`
+    ] : []
   ].join("\n");
 }
 function formatPostSchedulePending(pending) {
@@ -490,6 +497,28 @@ function formatIntegrationHealth(data) {
   const rows = data.items.map((item) => `${item.provider}	${item.connected ? "connected" : "disconnected"}	${item.health.status}	${item.health.isStale ? "stale" : "current"}	${item.health.message}`);
   return ["PROVIDER	CONNECTION	HEALTH	FRESHNESS	DETAIL", ...rows].join("\n");
 }
+function formatProviderDeliveryOptions(options) {
+  switch (options.provider) {
+    case "TIKTOK":
+      return [
+        `TikTok delivery options for ${options.account.displayName ?? options.account.username ?? "connected account"}`,
+        `Checked: ${options.checkedAt}`,
+        `Health: ${options.health.status} (${options.health.code}) ${options.health.message}`,
+        `Modes: ${options.allowedPostModes.join(", ") || "none"}`,
+        `Visibility: ${options.visibilityOptions.join(", ") || "none"}`,
+        `Interactions: comments ${options.interactions.comment.available ? "available" : "disabled"}, duet ${options.interactions.duet.available ? "available" : "disabled"}, stitch ${options.interactions.stitch.available ? "available" : "disabled"}`,
+        `Maximum video duration: ${options.maxVideoDurationMs === null ? "unknown" : `${options.maxVideoDurationMs} ms`}`
+      ].join("\n");
+    case "LINKEDIN":
+      return [
+        `LinkedIn delivery options for ${options.account.displayName ?? "connected member"}`,
+        `Checked: ${options.checkedAt}`,
+        `Health: ${options.health.status} (${options.health.code}) ${options.health.message}`,
+        `Post types: ${options.supportedPostTypes.join(", ")}`,
+        `Images: up to ${options.image.maxItems}; ${options.image.mimeTypes.join(", ")}; under ${options.image.maxPixelsExclusive.toLocaleString()} pixels`
+      ].join("\n");
+  }
+}
 function formatPostReadiness(readiness) {
   const attention = readiness.checks.filter((check) => check.status !== "pass");
   const summary = readiness.hasBlockingChecks ? "Post is not ready to publish." : readiness.requiresLiveRefresh.length ? "Local checks passed; live provider health must be refreshed." : "Post is ready to publish.";
@@ -834,7 +863,32 @@ function collectPublishingProvider(value, previous) {
   return [...previous ?? [], publishingProvider(value)];
 }
 function collectString(value, previous) {
-  return [...previous, value];
+  return [...previous ?? [], value];
+}
+function deliveryOptionsProvider(value) {
+  const normalized = value.toUpperCase();
+  const parsed = import_contracts2.ProviderDeliveryOptionsProviderSchema.safeParse(normalized);
+  if (parsed.success) return parsed.data;
+  throw new import_commander.InvalidArgumentError(
+    `Provider must be one of ${import_contracts2.ProviderDeliveryOptionsProviderSchema.options.join(", ")}.`
+  );
+}
+function tiktokPostMode(value) {
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "direct" || normalized === "direct_post") {
+    return "DIRECT_POST";
+  }
+  if (normalized === "inbox" || normalized === "media_upload") {
+    return "MEDIA_UPLOAD";
+  }
+  throw new import_commander.InvalidArgumentError("TikTok mode must be direct or inbox.");
+}
+function nonnegativeInteger(value) {
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed < 0) {
+    throw new import_commander.InvalidArgumentError("Expected a nonnegative integer.");
+  }
+  return parsed;
 }
 function youtubePrivacy(value) {
   const normalized = value.toUpperCase();
@@ -852,7 +906,7 @@ function yesOrNo(value) {
   throw new import_commander.InvalidArgumentError("Expected yes or no.");
 }
 function youtubeSettings(options) {
-  const hasYouTubeOptions = options.youtubeTitle !== void 0 || options.youtubeCategoryId !== void 0 || options.youtubePrivacy !== void 0 || options.youtubeMadeForKids !== void 0 || options.youtubeSyntheticMedia === true || options.youtubeNotifySubscribers === false || options.youtubeTag.length > 0;
+  const hasYouTubeOptions = options.youtubeTitle !== void 0 || options.youtubeCategoryId !== void 0 || options.youtubePrivacy !== void 0 || options.youtubeMadeForKids !== void 0 || options.youtubeSyntheticMedia === true || options.youtubeNotifySubscribers === false || (options.youtubeTag?.length ?? 0) > 0;
   if (!hasYouTubeOptions) return null;
   return import_contracts2.YouTubePostSettingsSchema.parse({
     title: options.youtubeTitle,
@@ -861,7 +915,7 @@ function youtubeSettings(options) {
     madeForKids: options.youtubeMadeForKids,
     containsSyntheticMedia: options.youtubeSyntheticMedia ?? false,
     notifySubscribers: options.youtubeNotifySubscribers ?? true,
-    tags: options.youtubeTag
+    tags: options.youtubeTag ?? []
   });
 }
 function positiveInteger(value) {
@@ -1007,6 +1061,23 @@ function errorForOutput(error) {
   }
   return { code: "CLI_ERROR", message: "The command failed unexpectedly." };
 }
+function tiktokSettings(options) {
+  const hasTikTokOptions = options.tiktokMode !== void 0 || options.tiktokVisibility !== void 0 || options.tiktokComments !== void 0 || options.tiktokDuet !== void 0 || options.tiktokStitch !== void 0 || options.tiktokCommercialContent !== void 0 || options.tiktokPromotesOwnBrand !== void 0 || options.tiktokPromotesThirdParty !== void 0 || options.tiktokAiGenerated !== void 0 || options.tiktokCoverTimestampMs !== void 0 || options.tiktokSettingsReviewed === true;
+  if (!hasTikTokOptions) return void 0;
+  return import_contracts2.TikTokDraftSettingsSchema.parse({
+    postMode: options.tiktokMode,
+    privacyLevel: options.tiktokVisibility,
+    allowComment: options.tiktokComments,
+    allowDuet: options.tiktokDuet,
+    allowStitch: options.tiktokStitch,
+    commercialContentEnabled: options.tiktokCommercialContent,
+    promotesOwnBrand: options.tiktokPromotesOwnBrand,
+    promotesThirdParty: options.tiktokPromotesThirdParty,
+    isAiGenerated: options.tiktokAiGenerated,
+    videoCoverTimestampMs: options.tiktokCoverTimestampMs,
+    reviewed: options.tiktokSettingsReviewed === true
+  });
+}
 function recoverySuggestions(code, command) {
   switch (code) {
     case "AUTH_REQUIRED":
@@ -1210,8 +1281,8 @@ async function runCli(argv = process.argv, overrides = {}) {
         const contentType = contentTypes[(0, import_node_path2.extname)(absolutePath).toLowerCase()];
         if (!contentType) throw new TypeError("Use a JPEG, PNG, WebP, MP4, or MOV file.");
         await requireWriteConsent({ yes: local.yes, global, runtime, subject: "media", preview: [`Upload ${(0, import_node_path2.basename)(absolutePath)} to Rolino?`, `Project: ${local.project}`, `Size: ${details.size} bytes`, "This adds a reusable media asset but does not create, schedule, or publish a post."].join("\n") });
-        const bytes = await (0, import_promises2.readFile)(absolutePath);
-        const asset = await client.media.upload(local.project, { fileName: (0, import_node_path2.basename)(absolutePath), contentType, fileSize: details.size, body: new Blob([bytes], { type: contentType }) }, { requestId: context.requestId });
+        const body = await (0, import_node_fs2.openAsBlob)(absolutePath, { type: contentType });
+        const asset = await client.media.upload(local.project, { fileName: (0, import_node_path2.basename)(absolutePath), contentType, fileSize: details.size, body }, { requestId: context.requestId });
         writeSuccess(context, asset, formatMediaAsset(asset), [`rolino posts create --project ${local.project} --caption <text> --media ${asset.id} --agent --yes`]);
       }
     });
@@ -1434,7 +1505,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const posts = program.command("posts").description("Read and prepare posts in a Rolino project");
-  posts.command("create").description("Create a draft post without scheduling or publishing it").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--caption <text>", "draft caption; use an empty string for media-only drafts").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "existing project media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm creation without an interactive prompt").action(async (local) => {
+  posts.command("create").description("Create a draft post without scheduling or publishing it").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--caption <text>", "draft caption; use an empty string for media-only drafts").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, BLUESKY, or LINKEDIN; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "existing project media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--tiktok-mode <mode>", "direct publishing or inbox draft delivery", tiktokPostMode).option("--tiktok-visibility <value>", "exact visibility returned by integrations delivery-options").option("--tiktok-comments <yes|no>", "allow TikTok comments", yesOrNo).option("--tiktok-duet <yes|no>", "allow TikTok duets", yesOrNo).option("--tiktok-stitch <yes|no>", "allow TikTok stitches", yesOrNo).option("--tiktok-commercial-content <yes|no>", "declare commercial TikTok content", yesOrNo).option("--tiktok-promotes-own-brand <yes|no>", "declare own-brand promotion", yesOrNo).option("--tiktok-promotes-third-party <yes|no>", "declare third-party promotion", yesOrNo).option("--tiktok-ai-generated <yes|no>", "declare AI-generated TikTok content", yesOrNo).option("--tiktok-cover-timestamp-ms <number>", "video cover timestamp in milliseconds", nonnegativeInteger).option("--tiktok-settings-reviewed", "confirm the TikTok account choices were reviewed; separate from --yes").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--linkedin-caption <text>", "LinkedIn-specific caption override; limited to 3,000 characters").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm creation without an interactive prompt").action(async (local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts create",
@@ -1460,9 +1531,10 @@ async function runCli(argv = process.argv, overrides = {}) {
             ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
             ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
             ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
-            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption }
+            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption },
+            ...local.linkedinCaption === void 0 ? {} : { LINKEDIN: local.linkedinCaption }
           },
-          tiktokSettings: null,
+          tiktokSettings: tiktokSettings(local) ?? null,
           youtubeSettings: youtubeSettings(local)
         };
         const post = await client.posts.create(local.project, input, {
@@ -1478,7 +1550,7 @@ async function runCli(argv = process.argv, overrides = {}) {
       }
     });
   });
-  posts.command("update").description("Replace an existing draft using optimistic concurrency").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--caption <text>", "replacement draft caption").option("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider, []).option("--media <asset-id>", "replacement media asset ID; repeat for multiple", collectString, []).option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "YouTube tag; repeat as needed", collectString, []).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm the update without an interactive prompt").action(async (postId, local) => {
+  posts.command("update").description("Update selected draft fields using optimistic concurrency").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).option("--caption <text>", "replacement draft caption; omitted fields are preserved").option("--platform <provider>", "replacement destinations; repeat as needed", collectPublishingProvider).option("--clear-platforms", "remove every draft destination").option("--media <asset-id>", "replacement media asset ID; repeat for multiple", collectString).option("--clear-media", "remove every media asset from the draft").option("--instagram-caption <text>", "Instagram-specific caption override").option("--tiktok-caption <text>", "TikTok-specific caption override").option("--tiktok-mode <mode>", "direct publishing or inbox draft delivery", tiktokPostMode).option("--tiktok-visibility <value>", "exact visibility returned by integrations delivery-options").option("--tiktok-comments <yes|no>", "allow TikTok comments", yesOrNo).option("--tiktok-duet <yes|no>", "allow TikTok duets", yesOrNo).option("--tiktok-stitch <yes|no>", "allow TikTok stitches", yesOrNo).option("--tiktok-commercial-content <yes|no>", "declare commercial TikTok content", yesOrNo).option("--tiktok-promotes-own-brand <yes|no>", "declare own-brand promotion", yesOrNo).option("--tiktok-promotes-third-party <yes|no>", "declare third-party promotion", yesOrNo).option("--tiktok-ai-generated <yes|no>", "declare AI-generated TikTok content", yesOrNo).option("--tiktok-cover-timestamp-ms <number>", "video cover timestamp in milliseconds", nonnegativeInteger).option("--tiktok-settings-reviewed", "confirm the TikTok account choices were reviewed; separate from --yes").option("--youtube-caption <text>", "YouTube description override; otherwise the shared caption is used").option("--bluesky-caption <text>", "Bluesky-specific caption override; limited to 300 graphemes").option("--linkedin-caption <text>", "LinkedIn-specific caption override; limited to 3,000 characters").option("--youtube-title <text>", "required YouTube video title").option("--youtube-category-id <id>", "required numeric YouTube video category ID").option("--youtube-privacy <status>", "required PUBLIC, UNLISTED, or PRIVATE visibility", youtubePrivacy).option("--youtube-made-for-kids <yes|no>", "required explicit YouTube audience declaration", yesOrNo).option("--youtube-synthetic-media", "declare realistic altered or synthetic media to YouTube").option("--no-youtube-notify-subscribers", "disable eligible YouTube subscriber notifications").option("--youtube-tag <tag>", "replacement YouTube tag; repeat as needed", collectString).option("--idempotency-key <key>", "stable retry key; defaults to the request ID").option("--yes", "confirm the update without an interactive prompt").action(async (postId, local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts update",
@@ -1490,24 +1562,34 @@ async function runCli(argv = process.argv, overrides = {}) {
           global,
           runtime,
           preview: [
-            `Replace draft ${postId}?`,
+            `Update draft ${postId}?`,
             `Project: ${local.project}`,
             `Expected version: ${local.expectedVersion}`,
             "This will not schedule or publish the post."
           ].join("\n")
         });
+        if (local.clearPlatforms && local.platform !== void 0) {
+          throw new TypeError("Use either --platform or --clear-platforms, not both.");
+        }
+        if (local.clearMedia && local.media !== void 0) {
+          throw new TypeError("Use either --media or --clear-media, not both.");
+        }
+        const captionOverrides = {
+          ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
+          ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
+          ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
+          ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption },
+          ...local.linkedinCaption === void 0 ? {} : { LINKEDIN: local.linkedinCaption }
+        };
+        const resolvedTikTokSettings = tiktokSettings(local);
+        const resolvedYouTubeSettings = youtubeSettings(local);
         const input = {
-          caption: local.caption,
-          platforms: local.platform,
-          mediaAssetIds: local.media,
-          captionOverrides: {
-            ...local.instagramCaption === void 0 ? {} : { INSTAGRAM: local.instagramCaption },
-            ...local.tiktokCaption === void 0 ? {} : { TIKTOK: local.tiktokCaption },
-            ...local.youtubeCaption === void 0 ? {} : { YOUTUBE: local.youtubeCaption },
-            ...local.blueskyCaption === void 0 ? {} : { BLUESKY: local.blueskyCaption }
-          },
-          tiktokSettings: null,
-          youtubeSettings: youtubeSettings(local)
+          ...local.caption === void 0 ? {} : { caption: local.caption },
+          ...local.platform === void 0 && !local.clearPlatforms ? {} : { platforms: local.clearPlatforms ? [] : local.platform },
+          ...local.media === void 0 && !local.clearMedia ? {} : { mediaAssetIds: local.clearMedia ? [] : local.media },
+          ...Object.keys(captionOverrides).length ? { captionOverrides } : {},
+          ...resolvedTikTokSettings === void 0 ? {} : { tiktokSettings: resolvedTikTokSettings },
+          ...resolvedYouTubeSettings === null ? {} : { youtubeSettings: resolvedYouTubeSettings }
         };
         const post = await client.posts.update(local.project, postId, input, {
           requestId: context.requestId,
@@ -1645,7 +1727,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const publish = posts.command("publish").description("Preview and queue server-confirmed immediate publishing");
-  publish.command("preview").description("Validate exact destinations and issue a five-minute confirmation").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, or BLUESKY; repeat as needed", collectPublishingProvider).action(async (postId, local) => {
+  publish.command("preview").description("Validate exact destinations and issue a five-minute confirmation").argument("<post-id>").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--expected-version <number>", "current post version from posts show", positiveInteger).requiredOption("--platform <provider>", "INSTAGRAM, TIKTOK, YOUTUBE, BLUESKY, or LINKEDIN; repeat as needed", collectPublishingProvider).action(async (postId, local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "posts publish preview",
@@ -1728,6 +1810,27 @@ async function runCli(argv = process.argv, overrides = {}) {
       }
     });
   });
+  integrations.command("delivery-options").description("Refresh secret-safe creator delivery choices for one provider").requiredOption("--project <project-id>", "exact Rolino project ID").requiredOption("--provider <provider>", "publishing provider; TIKTOK or LINKEDIN", deliveryOptionsProvider).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({
+      command: "integrations delivery-options",
+      global,
+      runtime,
+      async action(context, client) {
+        const options = await client.integrations.deliveryOptions(
+          local.project,
+          local.provider,
+          { requestId: context.requestId }
+        );
+        writeSuccess(
+          context,
+          options,
+          formatProviderDeliveryOptions(options),
+          [`rolino posts create --project ${local.project} --caption <text> --platform ${local.provider} --agent --yes`]
+        );
+      }
+    });
+  });
   const calendar = program.command("calendar").description("Read scheduled publishing events");
   calendar.command("list").description("List scheduled posts in a bounded calendar window").requiredOption("--project <project-id>", "exact Rolino project ID").option("--from <datetime>", "inclusive ISO-8601 window start", isoDateTime).option("--to <datetime>", "exclusive ISO-8601 window end", isoDateTime).option("--limit <number>", "maximum events to return", (value) => {
     const parsed = Number(value);