@cmo-so/cli 0.9.3 → 0.10.0

package/dist/cmo.mjs

@@ -7921,8 +7921,9 @@ function domainApi(api2, domain) {
      *  https links to pictures. Send a few photos per call (16 MB request limit), `append` after the first.
      *  On LinkedIn a set goes out as a swipeable PDF carousel unless setSocialCarousel says images. */
     setSocialPictures: (id, pictures) => post(`${base}/social/${id}/pictures`, pictures),
-    /** A LinkedIn post goes out as this PDF (base64 under ~11 MB, or a public https link; up to 300 pages);
-     *  its first 20 pages become the post's pictures. */
+    /** A PDF carousel (base64 under ~11 MB, or a public https link; up to 300 pages): its first 20 pages become
+     *  the post's pictures; a LinkedIn post (or the idea's LinkedIn post) goes out as the PDF itself. LinkedIn,
+     *  Instagram, Facebook and TikTok posts. */
     attachSocialCarouselPdf: (id, pdf) => post(`${base}/social/${id}/carousel/pdf`, pdf),
     /** How a LinkedIn post with a set goes out: "pdf" (swipeable carousel, the default) or "images"; its title. */
     setSocialCarousel: (id, changes) => api2.request(`${base}/social/${id}/carousel`, {
@@ -8072,6 +8073,26 @@ function domainApi(api2, domain) {
     /** A post on one video channel (YouTube by default, or TikTok) from a ready video, waiting in Review; Maggie
      *  writes the details (YouTube) or the caption (TikTok) unless write is false. */
     postFromVideo: (videoId, opts = {}) => post(`${base}/social/video/${videoId}/post`, opts),
+    /** A TikTok photo post (a swipeable set; TikTok adds music) from this post's pictures, waiting in Review;
+     *  Maggie writes the caption unless `caption` is given or write is false. Beta, like TikTok. */
+    tiktokPhotoPost: (id, opts = {}) => post(`${base}/social/${id}/tiktok-photo`, opts),
+    /** Ad videos (Beta): this website's, with the voices and lengths to choose from. */
+    adVideos: () => api2.request(
+      `${base}/social/ad-videos`
+    ),
+    adVideo: (adId) => api2.request(`${base}/social/ad-videos/${adId}`),
+    /** A storyboard and its cost (one AI generation; nothing billed by the second yet). */
+    planAdVideo: (opts) => post(`${base}/social/ad-videos`, opts),
+    /** Change the storyboard: only what a change touches is made again (`redo`), with the new cost. */
+    changeAdVideo: (adId, changes) => api2.request(`${base}/social/ad-videos/${adId}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(changes)
+    }),
+    /** Make it (billed): send back the estimate the person agreed to. */
+    makeAdVideo: (adId, estimateUsd) => post(`${base}/social/ad-videos/${adId}/make`, { confirm: true, estimate_usd: estimateUsd }),
+    /** Stop one being made (what's made is kept), or remove one. */
+    stopAdVideo: (adId) => api2.request(`${base}/social/ad-videos/${adId}`, { method: "DELETE" }),
     /** Make a LinkedIn, Facebook or Instagram post a video post: it goes out as this video (its picture is dropped). */
     attachVideo: (id, videoId) => post(`${base}/social/${id}/video`, { video_id: videoId }),
     /** Take the video off a post: it's a text post again. */
@@ -8479,6 +8500,12 @@ var keys = (a) => Object.keys(a ?? {}).filter((k) => a[k] !== void 0);
 var videoChannels = (a) => (Array.isArray(a.channels) && a.channels.length ? a.channels : ["youtube"]).map(
   (c) => ({ tiktok: "TikTok", linkedin: "LinkedIn", facebook: "Facebook", instagram: "Instagram" })[String(c)] ?? "YouTube"
 );
+var videoFrom = (a, lang = "en") => {
+  const name = a.file?.file_name;
+  if (a.file) return name ? q(String(name)) : lang === "en" ? "your video" : "\u4F60\u7684\u5F71\u7247";
+  if (a.video_id) return lang === "en" ? `video #${a.video_id}` : `\u5F71\u7247 #${a.video_id}`;
+  return String(a.url ?? "");
+};
 var confirmCopy = {
   // --------------------------------------------------------- account / setup
   website_add: {
@@ -8753,8 +8780,8 @@ var confirmCopy = {
     "zh-Hant": () => "\u7522\u751F\u9023\u63A5\u4F60 YouTube \u983B\u9053\u7684\u9023\u7D50\u3002"
   },
   social_video_attach: {
-    en: (a) => `Make post #${a.id} a video post with ${a.url} (its picture is removed).`,
-    "zh-Hant": (a) => `\u628A\u8CBC\u6587 #${a.id} \u6539\u6210\u5F71\u7247\u8CBC\u6587\uFF0C\u7528 ${a.url}\uFF08\u5716\u7247\u6703\u79FB\u9664\uFF09\u3002`
+    en: (a) => `Make post #${a.id} a video post with ${videoFrom(a)} (its picture is removed).`,
+    "zh-Hant": (a) => `\u628A\u8CBC\u6587 #${a.id} \u6539\u6210\u5F71\u7247\u8CBC\u6587\uFF0C\u7528 ${videoFrom(a, "zh-Hant")}\uFF08\u5716\u7247\u6703\u79FB\u9664\uFF09\u3002`
   },
   social_video_detach: {
     en: (a) => `Take the video off post #${a.id} (it's a text post again).`,
@@ -8767,11 +8794,11 @@ var confirmCopy = {
   social_video_add: {
     en: (a) => {
       const names = videoChannels(a).join(" and ");
-      return `Make a ${names} post from ${a.url}${a.write === false ? "" : ` (Maggie writes it: one AI generation per channel)`}; it waits for your OK.`;
+      return `Make a ${names} post from ${videoFrom(a)}${a.write === false ? "" : ` (Maggie writes it: one AI generation per channel)`}; it waits for your OK.`;
     },
     "zh-Hant": (a) => {
       const names = videoChannels(a).join(" \u548C ");
-      return `\u7528 ${a.url} \u505A ${names} \u5F71\u7247\u8CBC\u6587${a.write === false ? "" : "\uFF08Maggie \u4F86\u5BEB\uFF1A\u6BCF\u500B\u6E20\u9053\u7528\u4E00\u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`;
+      return `\u7528 ${videoFrom(a, "zh-Hant")} \u505A ${names} \u5F71\u7247\u8CBC\u6587${a.write === false ? "" : "\uFF08Maggie \u4F86\u5BEB\uFF1A\u6BCF\u500B\u6E20\u9053\u7528\u4E00\u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`;
     }
   },
   social_tiktok_set: {
@@ -8787,8 +8814,8 @@ var confirmCopy = {
     "zh-Hant": (a) => `\u4FEE\u6539 YouTube \u9810\u8A2D\uFF1A${keys(a).join("\u3001") || "\u7121"}\u3002`
   },
   social_image_new: {
-    en: (a) => `Make a new picture for post #${a.id}${a.instruction ? `: ${String(a.instruction).slice(0, 300)}` : ""} (1 AI generation, in the background)${a.replace ? ", stopping the one being made for another post" : ""}.`,
-    "zh-Hant": (a) => `\u70BA\u8CBC\u6587 #${a.id} \u751F\u6210\u65B0\u5716\u7247${a.instruction ? `\uFF1A${String(a.instruction).slice(0, 300)}` : ""}\uFF08\u7528 1 \u6B21 AI \u751F\u6210\uFF0C\u5728\u80CC\u666F\u9032\u884C\uFF09${a.replace ? "\uFF0C\u4E26\u505C\u6B62\u6B63\u5728\u70BA\u53E6\u4E00\u7BC7\u751F\u6210\u7684\u5716\u7247" : ""}\u3002`
+    en: (a) => Number(a.count) >= 5 ? `Make a text carousel of ${a.count} slides for post #${a.id} (words on your brand's colours; free, no AI picture, in the background)${a.replace ? ", stopping the one being made for another post" : ""}.` : `Make a new picture for post #${a.id}${a.instruction ? `: ${String(a.instruction).slice(0, 300)}` : ""} (1 AI generation, in the background)${a.replace ? ", stopping the one being made for another post" : ""}.`,
+    "zh-Hant": (a) => Number(a.count) >= 5 ? `\u70BA\u8CBC\u6587 #${a.id} \u505A ${a.count} \u9801\u6587\u5B57\u8F2A\u64AD\uFF08\u54C1\u724C\u8272\u4E0A\u7684\u6587\u5B57\uFF1B\u514D\u8CBB\uFF0C\u4E0D\u7528 AI \u751F\u5716\uFF0C\u5728\u80CC\u666F\u9032\u884C\uFF09${a.replace ? "\uFF0C\u4E26\u505C\u6B62\u6B63\u5728\u70BA\u53E6\u4E00\u7BC7\u751F\u6210\u7684\u5716\u7247" : ""}\u3002` : `\u70BA\u8CBC\u6587 #${a.id} \u751F\u6210\u65B0\u5716\u7247${a.instruction ? `\uFF1A${String(a.instruction).slice(0, 300)}` : ""}\uFF08\u7528 1 \u6B21 AI \u751F\u6210\uFF0C\u5728\u80CC\u666F\u9032\u884C\uFF09${a.replace ? "\uFF0C\u4E26\u505C\u6B62\u6B63\u5728\u70BA\u53E6\u4E00\u7BC7\u751F\u6210\u7684\u5716\u7247" : ""}\u3002`
   },
   social_image_stop: {
     en: () => "Stop the picture being made; the post keeps the one it had.",
@@ -8805,8 +8832,28 @@ var confirmCopy = {
     }
   },
   social_carousel_pdf_attach: {
-    en: (a) => `LinkedIn post #${a.id} goes out as your PDF, a swipeable carousel${a.title ? ` titled ${q(a.title)}` : ""}; its first pages become the post's pictures (free).`,
-    "zh-Hant": (a) => `LinkedIn \u8CBC\u6587 #${a.id} \u6703\u4EE5\u4F60\u7684 PDF \u767C\u51FA\uFF0C\u6210\u70BA\u53EF\u6ED1\u52D5\u7684\u8F2A\u64AD${a.title ? `\uFF0C\u6A19\u984C ${q(a.title)}` : ""}\uFF1BPDF \u7684\u524D\u5E7E\u9801\u4E5F\u6703\u6210\u70BA\u8CBC\u6587\u7684\u5716\u7247\uFF08\u514D\u8CBB\uFF09\u3002`
+    en: (a) => `Your PDF becomes post #${a.id}'s carousel${a.title ? `, titled ${q(a.title)}` : ""}: its first pages become the post's pictures, and on LinkedIn it goes out as the PDF itself (free).`,
+    "zh-Hant": (a) => `\u4F60\u7684 PDF \u6210\u70BA\u8CBC\u6587 #${a.id} \u7684\u8F2A\u64AD${a.title ? `\uFF0C\u6A19\u984C ${q(a.title)}` : ""}\uFF1A\u524D\u5E7E\u9801\u6703\u6210\u70BA\u8CBC\u6587\u7684\u5716\u7247\uFF0C\u5728 LinkedIn \u4E0A\u76F4\u63A5\u4EE5 PDF \u767C\u51FA\uFF08\u514D\u8CBB\uFF09\u3002`
+  },
+  social_tiktok_photo: {
+    en: (a) => `Make a TikTok photo post from post #${a.id}'s pictures${a.caption ? " with your caption" : " (Maggie writes the caption: 1 AI generation)"}; it waits for your OK.`,
+    "zh-Hant": (a) => `\u7528\u8CBC\u6587 #${a.id} \u7684\u5716\u7247\u505A\u4E00\u5247 TikTok \u5716\u7247\u8CBC\u6587${a.caption ? "\uFF0C\u7528\u4F60\u7684\u6587\u6848" : "\uFF08Maggie \u5BEB\u6587\u6848\uFF1A\u7528 1 \u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`
+  },
+  ad_video_plan: {
+    en: (a) => `Plan a ${a.seconds ?? 20}-second ${a.aspect === "16:9" ? "landscape" : "vertical"} ad video${a.item_id ? ` from post #${a.item_id}` : ""}${a.reference_url ? ", following the YouTube ad you gave" : ""} (1 AI generation; nothing is billed by the second yet). You'll see the storyboard and the cost first.`,
+    "zh-Hant": (a) => `\u898F\u5283\u4E00\u652F ${a.seconds ?? 20} \u79D2${a.aspect === "16:9" ? "\u6A6B\u5411" : "\u76F4\u5411"}\u5EE3\u544A\u5F71\u7247${a.item_id ? `\uFF08\u6839\u64DA\u8CBC\u6587 #${a.item_id}\uFF09` : ""}${a.reference_url ? "\uFF0C\u53C3\u8003\u4F60\u7D66\u7684 YouTube \u5EE3\u544A\u7BC0\u594F" : ""}\uFF08\u7528 1 \u6B21 AI \u751F\u6210\uFF0C\u9084\u4E0D\u6703\u6309\u79D2\u8A08\u8CBB\uFF09\u3002\u6703\u5148\u7D66\u4F60\u770B\u5206\u93E1\u548C\u8CBB\u7528\u3002`
+  },
+  ad_video_change: {
+    en: (a) => `Change ad video #${a.id}'s storyboard: ${keys(a).filter((k) => k !== "id").join(", ") || "nothing"}.`,
+    "zh-Hant": (a) => `\u4FEE\u6539\u5EE3\u544A\u5F71\u7247 #${a.id} \u7684\u5206\u93E1\uFF1A${keys(a).filter((k) => k !== "id").join("\u3001") || "\u7121"}\u3002`
+  },
+  ad_video_make: {
+    en: (a) => `Make ad video #${a.id} now. This costs about $${Number(a.estimate_usd ?? 0).toFixed(2)} (pictures, moving clips, voice and music), in the background.`,
+    "zh-Hant": (a) => `\u73FE\u5728\u88FD\u4F5C\u5EE3\u544A\u5F71\u7247 #${a.id}\uFF0C\u8CBB\u7528\u7D04 $${Number(a.estimate_usd ?? 0).toFixed(2)}\uFF08\u5716\u7247\u3001\u52D5\u614B\u7247\u6BB5\u3001\u914D\u97F3\u548C\u914D\u6A02\uFF09\uFF0C\u5728\u80CC\u666F\u9032\u884C\u3002`
+  },
+  ad_video_stop: {
+    en: (a) => `Stop ad video #${a.id} if it's being made (what's made is kept), or remove it from the list.`,
+    "zh-Hant": (a) => `\u505C\u6B62\u88FD\u4F5C\u5EE3\u544A\u5F71\u7247 #${a.id}\uFF08\u5DF2\u505A\u597D\u7684\u90E8\u5206\u6703\u4FDD\u7559\uFF09\uFF0C\u6216\u628A\u5B83\u5F9E\u6E05\u55AE\u79FB\u9664\u3002`
   },
   social_carousel_set: {
     en: (a) => `LinkedIn post #${a.id} goes out ${a.format === "images" ? "as several pictures" : a.format === "pdf" ? "as a swipeable PDF carousel" : "as it is set"}${a.title ? `, titled ${q(a.title)}` : ""}.`,
@@ -11566,6 +11613,36 @@ var CHANNEL_KEYS = ["linkedin", "facebook", "instagram", "google_business"];
 var ALL_CHANNEL_KEYS = [...CHANNEL_KEYS, "youtube", "tiktok"];
 var VIDEO_KEYS = ["linkedin", "facebook", "instagram", "youtube", "tiktok"];
 var TIKTOK_PRIVACY = ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY"];
+var SLIDES = [5, 6, 7, 8, 9, 10];
+var adVideo = (v) => ({
+  id: v.id,
+  status: v.status,
+  step: v.step,
+  aspect: v.aspect,
+  plan: v.plan ? {
+    title: v.plan.title,
+    style: v.plan.style,
+    voice: v.plan.voice,
+    music: v.plan.music,
+    seconds: v.plan.seconds,
+    end_card: v.plan.cta,
+    scenes: v.plan.scenes.map((s) => ({
+      id: s.id,
+      seconds: s.seconds,
+      picture: s.still,
+      motion: s.motion,
+      line: s.line,
+      caption: s.caption,
+      picture_url: s.still_url ?? null
+    }))
+  } : null,
+  estimate: v.estimate,
+  cost_usd: v.cost_usd,
+  video_id: v.video_id,
+  video: v.video ? { status: v.video.status, preview_url: v.video.preview_url, poster_url: v.video.poster_url } : null,
+  error: v.error,
+  next: v.status === "planned" ? `Show the storyboard and the cost (about $${(v.estimate?.usd ?? 0).toFixed(2)}); change it with ad_video_change, make it with ad_video_make when the user agrees to that cost.` : v.status === "running" ? "Being made; check again with ad_video_get in a minute or so." : v.status === "ready" ? "Ready: post it with social_video_add (video_id and channels) once video.status is ready." : v.status === "failed" ? "Failed: say why; ad_video_make again carries on from what was made." : ""
+});
 var channelsParam = {
   type: "array",
   items: { type: "string", enum: CHANNEL_KEYS },
@@ -11582,6 +11659,11 @@ var FILE_SCHEMA = {
   required: ["download_url", "file_id"]
 };
 var fileLinks = (value) => (Array.isArray(value) ? value : value ? [value] : []).map((f) => String(f?.download_url ?? "").trim()).filter(Boolean);
+var videoLink = (a) => {
+  const link = fileLinks(a.file)[0] ?? String(a.url ?? "").trim();
+  if (!link.startsWith("https://")) throw new Error("Give the video (a file from this chat, or a direct https link).");
+  return link;
+};
 var queuedAt = positionParam("the posts", "Leave out for the front (the next posting times).");
 var channelsOf = (value) => {
   const list2 = Array.isArray(value) ? value.map((v) => String(v).toLowerCase()).filter((v) => CHANNEL_KEYS.includes(v)) : [];
@@ -11780,7 +11862,7 @@ var socialTools = [
   }),
   tool({
     name: "social_image_new",
-    description: "Make a new picture for a social post that hasn't gone out, or change its current one (mode: edit, as `instruction` says). Uses 1 AI generation. It is made in the background, on the user's own ChatGPT when their Maggie Bridge has images on, else by CMO.so; it takes up to a couple of minutes and appears on the post by itself (check with social_image_status). One picture is made at a time per website: while another is being made this one waits in line (status queued). It fails with image_busy only when this post already has one being made or in line; pass replace: true only when the user agrees to stop the one being made and make this one now. A post written from an article gets its own picture (from its text and the article's title) and then goes out as that picture. Every new picture carries a short title and line set on it; count: 4 makes a set of 4 pictures that tell one story (still 1 AI generation, drawn as one storyboard and cut); LinkedIn and Facebook post a set together as a collage. text_effect picks the style of those words (an id from social_text_effects); leave it out to let Maggie pick. style picks the picture style (an id from social_look: photo_headline, editorial, duotone, illustrated, bold_type, infographic); leave it out and Maggie takes turns with the brand's 3. bold_type and infographic make no AI picture (big words or a list in the brand's look) and cost nothing.",
+    description: "Make a new picture for a social post that hasn't gone out, or change its current one (mode: edit, as `instruction` says). Uses 1 AI generation. It is made in the background, on the user's own ChatGPT when their Maggie Bridge has images on, else by CMO.so; it takes up to a couple of minutes and appears on the post by itself (check with social_image_status). One picture is made at a time per website: while another is being made this one waits in line (status queued). It fails with image_busy only when this post already has one being made or in line; pass replace: true only when the user agrees to stop the one being made and make this one now. A post written from an article gets its own picture (from its text and the article's title) and then goes out as that picture. Every new picture carries a short title and line set on it; count: 4 makes a set of 4 pictures that tell one story (still 1 AI generation, drawn as one storyboard and cut); LinkedIn and Facebook post a set together as a collage. text_effect picks the style of those words (an id from social_text_effects); leave it out to let Maggie pick. style picks the picture style (an id from social_look: photo_headline, editorial, duotone, illustrated, bold_type, infographic); leave it out and Maggie takes turns with the brand's 3. bold_type and infographic make no AI picture (big words or a list in the brand's look) and cost nothing. count 5-10 makes a text carousel: a cover with the hook, one point a slide and a last slide with the next step, words on the brand's colours (style bold_type or infographic), no AI picture and free; LinkedIn posts it as a swipeable PDF carousel, Instagram and Facebook as a carousel (the first 10), TikTok as a photo post (social_tiktok_photo).",
     parameters: {
       type: "object",
       properties: {
@@ -11797,7 +11879,7 @@ var socialTools = [
         },
         count: {
           type: "integer",
-          description: "1 (default) or 4: a set of 4 pictures telling one story, a line of words on each"
+          description: "1 (default); 4: a set of 4 pictures telling one story, a line of words on each; 5-10: a text carousel of that many slides (free)"
         },
         text_effect: {
           type: "string",
@@ -11819,7 +11901,7 @@ var socialTools = [
         replace: replace === true,
         ...typeof style === "string" && style.trim() && mode !== "edit" ? { style: style.trim() } : {},
         ...mode === "edit" ? { mode: "edit" } : {},
-        ...Number(count) === 4 && mode !== "edit" ? { count: 4 } : {},
+        ...mode !== "edit" && (Number(count) === 4 || SLIDES.includes(Number(count))) ? { count: Number(count) } : {},
         ...typeof text_effect === "string" && text_effect.trim() ? { textEffect: text_effect.trim() } : {},
         ...typeof instruction === "string" && instruction.trim() ? { instruction: instruction.trim().slice(0, 300) } : {}
       });
@@ -12045,11 +12127,14 @@ var socialTools = [
   }),
   tool({
     name: "social_carousel_pdf_attach",
-    description: "A LinkedIn post goes out as this PDF: a swipeable document carousel. The PDF from this chat (file: one the user added or that was made here) or a public https link to it (url); up to 300 pages and 20 MB, no password. Its first 20 pages also become the post's pictures (what its other channels post). Free. Change the pictures later and the carousel is made from them instead. If you can pass neither, give the user social_upload_link. Preview first.",
+    description: "A PDF carousel for a LinkedIn, Instagram, Facebook or TikTok post: the PDF from this chat (file: one the user added or that was made here) or a public https link to it (url); up to 300 pages and 20 MB, no password. Its first 20 pages become the post's pictures: Instagram and Facebook post them as a carousel (the first 10), TikTok as a photo post. A LinkedIn post (this one, or the same idea's LinkedIn post) goes out as the PDF itself, a swipeable document carousel. Free. Change the pictures later and the LinkedIn carousel is made from them instead. If you can pass neither, give the user social_upload_link. Preview first.",
     parameters: {
       type: "object",
       properties: {
-        id: { type: "integer", description: "A LinkedIn post (from social_list), not gone out yet" },
+        id: {
+          type: "integer",
+          description: "A LinkedIn, Instagram, Facebook or TikTok post (from social_list), not gone out yet"
+        },
         file: { ...FILE_SCHEMA, description: "The PDF from this chat" },
         url: { type: "string", description: "Public https link to the PDF file" },
         title: {
@@ -12063,7 +12148,7 @@ var socialTools = [
     group: "social",
     need: write5,
     risk: "W1",
-    gates: ["VER", "LI"],
+    gates: ["VER"],
     run: async (ctx, { id, url, file, title }) => {
       const link = fileLinks(file)[0] ?? String(url ?? "").trim();
       if (!link.startsWith("https://"))
@@ -12092,7 +12177,7 @@ var socialTools = [
         id: post.id,
         channel: post.provider ?? null,
         url: `https://app.cmo.so/social?picture=${post.id}${site}`,
-        how: post.provider === "linkedin" ? "Open it, then Upload several photos (in order), or on a computer Upload a PDF carousel." : "Open it, then Upload several photos (in order)."
+        how: ["linkedin", "instagram", "facebook", "tiktok"].includes(String(post.provider)) ? "Open it, then Upload several photos (in order), or on a computer Upload a PDF carousel." : "Open it, then Upload several photos (in order)."
       };
     }
   }),
@@ -12790,22 +12875,24 @@ var socialTools = [
   }),
   tool({
     name: "social_video_attach",
-    description: "Make a LinkedIn, Facebook or Instagram post that hasn't gone out a video post: it goes out as this video (a DIRECT link to a video file, 5-30 seconds; never a platform page) with its text, and its picture is removed (a video post has no picture). Not for Google Business (posts can't carry video). Preview first.",
+    description: "Make a LinkedIn, Facebook or Instagram post that hasn't gone out a video post: it goes out as this video (5-30 seconds) with its text, and its picture is removed (a video post has no picture). The video from this chat (file: one the user added) or a DIRECT https link to a video file (url; never a platform page). If you can pass neither, the user adds the video in the CMO.so app (Social). Not for Google Business (posts can't carry video). Preview first.",
     parameters: {
       type: "object",
       properties: {
         id: { type: "integer", description: "The post (from social_list)" },
+        file: { ...FILE_SCHEMA, description: "The video from this chat (MP4 or MOV)" },
         url: { type: "string", description: "Direct https link to the video file" }
       },
-      required: ["id", "url"]
+      required: ["id"]
     },
+    fileParams: ["file"],
     group: "social",
     need: write5,
     risk: "W1",
     gates: ["VER"],
     run: async (ctx, a) => {
       const d = ws(ctx);
-      let v = await d.videoFromLink(String(a.url));
+      let v = await d.videoFromLink(videoLink(a));
       const until = Date.now() + 15e4;
       while ((v.status === "checking" || v.status === "uploading") && Date.now() < until) {
         await new Promise((r) => setTimeout(r, 3e3));
@@ -12881,11 +12968,13 @@ var socialTools = [
   }),
   tool({
     name: "social_video_add",
-    description: "Make video posts (channels: linkedin, facebook, instagram, youtube, tiktok; default youtube; one post each, never google_business: Google posts can't carry video) from a video: a DIRECT link to a video file (an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those; tell the user to upload the video in the app instead). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes YouTube's title, description and tags, TikTok's caption, or the LinkedIn / Facebook / Instagram text, from the video and the note (one AI generation per channel) unless write is false. Each post waits in Review: video posts are always approved by the user. YouTube asks whether it's made for kids; TikTok asks who can view it and the other TikTok settings (social_tiktok_set, as the user chooses). is_aigc: TikTok's AI-generated label, only when the user says the video was made with AI. Preview first.",
+    description: "Make video posts (channels: linkedin, facebook, instagram, youtube, tiktok; default youtube; one post each, never google_business: Google posts can't carry video) from a video: a video already in CMO.so (video_id, e.g. a ready ad video's), the video from this chat (file: one the user added) or a DIRECT https link to a video file (url: an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those). If you can pass neither, tell the user to add the video in the CMO.so app (Social). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes YouTube's title, description and tags, TikTok's caption, or the LinkedIn / Facebook / Instagram text, from the video and the note (one AI generation per channel) unless write is false. Each post waits in Review: video posts are always approved by the user. YouTube asks whether it's made for kids; TikTok asks who can view it and the other TikTok settings (social_tiktok_set, as the user chooses). is_aigc: TikTok's AI-generated label, only when the user says the video was made with AI. Preview first.",
     parameters: {
       type: "object",
       properties: {
+        file: { ...FILE_SCHEMA, description: "The video from this chat (MP4 or MOV)" },
         url: { type: "string", description: "Direct https link to the video file" },
+        video_id: { type: "integer", description: "A video already in CMO.so (an ad video's video_id)" },
         channels: {
           type: "array",
           items: { type: "string", enum: [...VIDEO_KEYS] },
@@ -12897,9 +12986,9 @@ var socialTools = [
         start: { type: "number", description: "Start of the part to use, seconds" },
         end: { type: "number", description: "End of the part to use, seconds" },
         vertical: { type: "string", enum: ["left", "middle", "right"] }
-      },
-      required: ["url"]
+      }
     },
+    fileParams: ["file"],
     group: "social",
     need: write5,
     risk: "W2",
@@ -12911,7 +13000,7 @@ var socialTools = [
         ...a.end != null ? { end: Number(a.end) } : {},
         ...a.vertical ? { aspect: "9:16", crop_x: a.vertical === "left" ? 0 : a.vertical === "right" ? 1 : 0.5 } : {}
       };
-      let v = await d.videoFromLink(String(a.url), Object.keys(edit).length ? edit : void 0);
+      let v = a.video_id ? await d.video(Number(a.video_id)) : await d.videoFromLink(videoLink(a), Object.keys(edit).length ? edit : void 0);
       const until = Date.now() + 15e4;
       while ((v.status === "checking" || v.status === "uploading") && Date.now() < until) {
         await new Promise((r) => setTimeout(r, 3e3));
@@ -12944,6 +13033,183 @@ var socialTools = [
       };
     }
   }),
+  tool({
+    name: "social_tiktok_photo",
+    description: "A TikTok photo post (a swipeable set of pictures; TikTok adds music) from a post's pictures: a set, a text carousel (social_image_new count 5-10) or the pages of a PDF. A new TikTok post that waits in Review like every TikTok post. Maggie writes the caption from the post (one AI generation) unless caption is given. Then TikTok's settings: read tiktok_creator, ask who can view it and the rest, social_tiktok_set exactly as the user says. TikTok is in beta. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A post with pictures (from social_list), not a video post" },
+        note: { type: "string", description: "What to say in the caption, in the user's words" },
+        caption: { type: "string", description: "The caption itself, when the user wrote it (no AI)" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W2",
+    gates: ["VER", "LLM"],
+    run: async (ctx, { id, note, caption }) => {
+      const out = await ws(ctx).tiktokPhotoPost(Number(id), {
+        ...note ? { note: String(note).slice(0, 1e3) } : {},
+        ...typeof caption === "string" && caption.trim() ? { caption: caption.trim(), write: false } : {}
+      });
+      return {
+        post: item(out),
+        next: "Show the caption; read tiktok_creator and ask who can view it, whether to allow comments and whether it promotes a brand, then social_tiktok_set exactly as they say; tell them the Music Usage Confirmation line. The user approves it."
+      };
+    }
+  }),
+  tool({
+    name: "ad_video_plan",
+    description: "Plan a short ad video (beta) and say what making it costs. Maggie writes a storyboard: 2-5 scenes, each with the first picture's brief (no words in pictures), what moves and one camera move, the narrator's line and the words on screen; an end card with the next step and the logo; a voice and music. One AI generation; nothing is billed by the second yet. brief: what the ad should do, in the user's words, or item_id: a post whose text is the brief. aspect 9:16 (Reels, TikTok, Shorts; default) or 16:9 (LinkedIn, YouTube); seconds 15, 20 (default) or 30; reference_url: a public YouTube ad whose rhythm to follow (Gemini watches it; never downloaded). Show the storyboard and the cost (estimate.items, estimate.usd) before ad_video_make. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        brief: { type: "string", description: "What the ad should do, who it's for, the offer (user's words)" },
+        item_id: { type: "integer", description: "A post (from social_list) to make the ad from" },
+        aspect: { type: "string", enum: ["9:16", "16:9"] },
+        seconds: { type: "integer", description: "15, 20 or 30" },
+        scenes: { type: "integer", description: "2-5 (default 3, or 4 for 30 seconds)" },
+        reference_url: { type: "string", description: "A public YouTube ad to follow the rhythm of" }
+      }
+    },
+    group: "social",
+    need: write5,
+    risk: "W2",
+    gates: ["VER", "LLM"],
+    run: async (ctx, a) => {
+      const out = await ws(ctx).planAdVideo({
+        ...a.brief ? { brief: String(a.brief).slice(0, 3e3) } : {},
+        ...a.item_id ? { item_id: Number(a.item_id) } : {},
+        ...a.aspect ? { aspect: a.aspect } : {},
+        ...a.seconds ? { seconds: Number(a.seconds) } : {},
+        ...a.scenes ? { scenes: Number(a.scenes) } : {},
+        ...a.reference_url ? { reference_url: String(a.reference_url).trim() } : {}
+      });
+      return adVideo(out);
+    }
+  }),
+  tool({
+    name: "ad_video_list",
+    description: "This website's ad videos (beta): each with its status (planned, running and its step, ready, failed), the storyboard's title, its cost so far and, when ready, the video (video_id) to post.",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => {
+      const out = await ws(ctx).adVideos();
+      return {
+        ad_videos: out.ad_videos.map((v) => ({
+          id: v.id,
+          status: v.status,
+          step: v.step,
+          title: v.plan?.title ?? null,
+          aspect: v.aspect,
+          cost_usd: v.cost_usd,
+          video_id: v.video_id,
+          video_status: v.video?.status ?? null,
+          error: v.error
+        })),
+        voices: out.voices
+      };
+    }
+  }),
+  tool({
+    name: "ad_video_get",
+    description: "One ad video (beta): its storyboard (scenes with their pictures once made), what making the missing pieces costs (estimate), its status and step; when ready, video_id and the video's status (it is prepared for the channels in the background: post it once video.status is ready). While it's running, check again every minute or so.",
+    parameters: {
+      type: "object",
+      properties: { id: { type: "integer", description: "The ad video (from ad_video_list)" } },
+      required: ["id"]
+    },
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx, { id }) => adVideo(await ws(ctx).adVideo(Number(id)))
+  }),
+  tool({
+    name: "ad_video_change",
+    description: "Change an ad video's storyboard (beta) as the user asks: a scene's picture brief (still), its movement (motion), the narrator's line, the words on screen (caption) or its seconds (3-8); redo_scenes to make scenes' pictures and clips again; the end card (cta_headline, cta_sub); the voice (a name from ad_video_list voices, or none); the music (words, or none). Only what a change touches is made again (redo): a picture brief or movement means a new paid clip; lines, words, end card, voice or music are cheap. Says the new cost; then ad_video_make. Not while it's being made. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The ad video" },
+        scenes: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string", description: "Scene id, e.g. s2" },
+              still: { type: "string" },
+              motion: { type: "string" },
+              line: { type: "string" },
+              caption: { type: "string" },
+              seconds: { type: "number" }
+            },
+            required: ["id"]
+          }
+        },
+        redo_scenes: { type: "array", items: { type: "string" } },
+        cta_headline: { type: "string" },
+        cta_sub: { type: "string" },
+        voice: { type: "string", description: "A voice name, or none" },
+        music: { type: "string", description: "The music in words, or none" },
+        title: { type: "string" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, a) => {
+      const cta = {
+        ...a.cta_headline != null ? { headline: a.cta_headline } : {},
+        ...a.cta_sub != null ? { sub: a.cta_sub } : {}
+      };
+      const out = await ws(ctx).changeAdVideo(Number(a.id), {
+        ...a.scenes?.length ? { scenes: a.scenes } : {},
+        ...a.redo_scenes?.length ? { redo_scenes: a.redo_scenes } : {},
+        ...Object.keys(cta).length ? { cta } : {},
+        ...a.voice != null ? { voice: /^none$/i.test(a.voice) ? false : a.voice } : {},
+        ...a.music != null ? { music: /^none$/i.test(a.music) ? "" : a.music } : {},
+        ...a.title ? { title: a.title } : {}
+      });
+      return { ...adVideo(out), redo: out.redo ?? [] };
+    }
+  }),
+  tool({
+    name: "ad_video_make",
+    description: "Make the ad video (beta): its pictures (on the user's own ChatGPT when their Maggie Bridge has images on, else Gemini), the moving clips (Gemini, billed per second), the voice, the music, the words and the end card, cut into one video, in the background (several minutes; follow it with ad_video_get). It COSTS MONEY: estimate_usd must be the estimate.usd from ad_video_plan / ad_video_get / ad_video_change that the user agreed to; if the cost changed it is refused with the new one. Each website has a daily limit. Making it again after a change or a failure only makes what's missing. When ready, post it with social_video_add and its video_id. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The ad video" },
+        estimate_usd: { type: "number", description: "The cost the user agreed to (estimate.usd)" }
+      },
+      required: ["id", "estimate_usd"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W3",
+    gates: ["VER"],
+    run: async (ctx, { id, estimate_usd }) => adVideo(await ws(ctx).makeAdVideo(Number(id), Number(estimate_usd)))
+  }),
+  tool({
+    name: "ad_video_stop",
+    description: "Stop an ad video being made (after the piece it's on; what was made is kept and making it again carries on), or remove one that isn't being made from the list (posts made from it keep their video). Preview first.",
+    parameters: {
+      type: "object",
+      properties: { id: { type: "integer", description: "The ad video" } },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id }) => ws(ctx).stopAdVideo(Number(id))
+  }),
   tool({
     name: "social_youtube_set",
     description: "Change a YouTube post that hasn't gone out: title (at most 100 characters, aim 40-60), tags, visibility (public, unlisted, private), made_for_kids (YouTube asks for every video: ask the user, never guess) or synthetic (realistic AI-made or altered content). The description is the post's text (social_update_copy). Preview first.",
@@ -16616,7 +16882,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.9.3",
+  version: "0.10.0",
   description: "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
   type: "module",
   license: "MIT",
@@ -16826,75 +17092,6 @@ import { randomBytes } from "node:crypto";
 // ../../packages/mcp/src/index.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
 
-// ../../packages/mcp/src/messages.ts
-var UPPER = /* @__PURE__ */ new Set(["seo", "gsc", "gbp", "cta", "cmo", "dns", "ai", "api", "pdf", "url", "id"]);
-var n = (count, word, plural) => count === 1 ? `1 ${word}` : `${count ? count : "no"} ${plural ?? `${word}s`}`;
-function titleOf(name) {
-  const words = name.split("_").map((w) => UPPER.has(w) ? w.toUpperCase() : w);
-  const head = words[0] ?? "";
-  return [head.charAt(0).toUpperCase() + head.slice(1), ...words.slice(1)].join(" ");
-}
-var LIST_KEYS = ["items", "results", "posts", "ideas", "workspaces", "rows"];
-function items(value) {
-  if (Array.isArray(value)) return value;
-  if (value && typeof value === "object") {
-    for (const k of LIST_KEYS) {
-      const v = value[k];
-      if (Array.isArray(v)) return v;
-    }
-  }
-  return null;
-}
-function label(x) {
-  if (x && typeof x === "object") {
-    const o = x;
-    for (const k of ["title", "name", "domain", "label", "what", "text", "id"]) {
-      if (o[k] !== void 0 && o[k] !== null && o[k] !== "") return String(o[k]);
-    }
-    return Object.entries(o).filter(([, v]) => typeof v !== "object").slice(0, 3).map(([k, v]) => `${k} ${v}`).join(", ");
-  }
-  return String(x);
-}
-function bodyLines(value) {
-  const list2 = items(value);
-  if (list2) {
-    const out = list2.slice(0, 8).map((x) => `- ${label(x)}`.slice(0, 200));
-    return list2.length > 8 ? [...out, `\u2026and ${list2.length - 8} more`] : out;
-  }
-  if (value && typeof value === "object") {
-    return Object.entries(value).filter(([k, v]) => v !== null && v !== void 0 && v !== "" && typeof v !== "object" && k !== "next").slice(0, 8).map(([k, v]) => `${k.replace(/_/g, " ")}: ${v}`.slice(0, 200));
-  }
-  return value === null || value === void 0 || value === "" ? [] : [String(value).slice(0, 600)];
-}
-function said(name, value) {
-  if (value && typeof value === "object" && !Array.isArray(value)) {
-    for (const k of ["say", "headline", "summary", "message"]) {
-      const v = value[k];
-      if (typeof v === "string" && v.trim()) return (v.trim().split("\n")[0] ?? "").slice(0, 240);
-    }
-  }
-  const list2 = items(value);
-  if (list2) {
-    let noun = name.endsWith("_list") ? name.slice(0, -5).split("_").pop() ?? "item" : "item";
-    if (noun.endsWith("s")) noun = noun.slice(0, -1);
-    return list2.length ? `I found ${n(list2.length, noun)}.` : "There's nothing there yet.";
-  }
-  if (typeof value === "string") return (value.trim().split("\n")[0] ?? "").slice(0, 240) || "Done.";
-  return "Here it is.";
-}
-var lowerFirst = (s) => /^[A-Za-z][a-z]/.test(s) ? s.charAt(0).toLowerCase() + s.slice(1) : s;
-function message(name, value, opts = {}) {
-  const title = titleOf(name);
-  if (opts.error) return { say: `That didn't work: ${opts.error}`.slice(0, 300), title, lines: [] };
-  if (opts.preview) return { say: "This needs your yes first; nothing has changed yet.", title, lines: [opts.preview] };
-  if (opts.done) return { say: `Done: ${lowerFirst(opts.done)}`, title, lines: bodyLines(value) };
-  return { say: said(name, value), title, lines: bodyLines(value) };
-}
-function messageText(m) {
-  const body = [m.title ? `**${m.title}**` : "", ...m.lines].filter(Boolean).join("\n");
-  return [m.say, body].filter(Boolean).join("\n\n").trim();
-}
-
 // ../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/util.js
 var util_exports = {};
 __export(util_exports, {
@@ -26552,6 +26749,75 @@ var Server = class extends Protocol {
   }
 };
 
+// ../../packages/mcp/src/messages.ts
+var UPPER = /* @__PURE__ */ new Set(["seo", "gsc", "gbp", "cta", "cmo", "dns", "ai", "api", "pdf", "url", "id"]);
+var n = (count, word, plural) => count === 1 ? `1 ${word}` : `${count ? count : "no"} ${plural ?? `${word}s`}`;
+function titleOf(name) {
+  const words = name.split("_").map((w) => UPPER.has(w) ? w.toUpperCase() : w);
+  const head = words[0] ?? "";
+  return [head.charAt(0).toUpperCase() + head.slice(1), ...words.slice(1)].join(" ");
+}
+var LIST_KEYS = ["items", "results", "posts", "ideas", "workspaces", "rows"];
+function items(value) {
+  if (Array.isArray(value)) return value;
+  if (value && typeof value === "object") {
+    for (const k of LIST_KEYS) {
+      const v = value[k];
+      if (Array.isArray(v)) return v;
+    }
+  }
+  return null;
+}
+function label(x) {
+  if (x && typeof x === "object") {
+    const o = x;
+    for (const k of ["title", "name", "domain", "label", "what", "text", "id"]) {
+      if (o[k] !== void 0 && o[k] !== null && o[k] !== "") return String(o[k]);
+    }
+    return Object.entries(o).filter(([, v]) => typeof v !== "object").slice(0, 3).map(([k, v]) => `${k} ${v}`).join(", ");
+  }
+  return String(x);
+}
+function bodyLines(value) {
+  const list2 = items(value);
+  if (list2) {
+    const out = list2.slice(0, 8).map((x) => `- ${label(x)}`.slice(0, 200));
+    return list2.length > 8 ? [...out, `\u2026and ${list2.length - 8} more`] : out;
+  }
+  if (value && typeof value === "object") {
+    return Object.entries(value).filter(([k, v]) => v !== null && v !== void 0 && v !== "" && typeof v !== "object" && k !== "next").slice(0, 8).map(([k, v]) => `${k.replace(/_/g, " ")}: ${v}`.slice(0, 200));
+  }
+  return value === null || value === void 0 || value === "" ? [] : [String(value).slice(0, 600)];
+}
+function said(name, value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    for (const k of ["say", "headline", "summary", "message"]) {
+      const v = value[k];
+      if (typeof v === "string" && v.trim()) return (v.trim().split("\n")[0] ?? "").slice(0, 240);
+    }
+  }
+  const list2 = items(value);
+  if (list2) {
+    let noun = name.endsWith("_list") ? name.slice(0, -5).split("_").pop() ?? "item" : "item";
+    if (noun.endsWith("s")) noun = noun.slice(0, -1);
+    return list2.length ? `I found ${n(list2.length, noun)}.` : "There's nothing there yet.";
+  }
+  if (typeof value === "string") return (value.trim().split("\n")[0] ?? "").slice(0, 240) || "Done.";
+  return "Here it is.";
+}
+var lowerFirst = (s) => /^[A-Za-z][a-z]/.test(s) ? s.charAt(0).toLowerCase() + s.slice(1) : s;
+function message(name, value, opts = {}) {
+  const title = titleOf(name);
+  if (opts.error) return { say: `That didn't work: ${opts.error}`.slice(0, 300), title, lines: [] };
+  if (opts.preview) return { say: "This needs your yes first; nothing has changed yet.", title, lines: [opts.preview] };
+  if (opts.done) return { say: `Done: ${lowerFirst(opts.done)}`, title, lines: bodyLines(value) };
+  return { say: said(name, value), title, lines: bodyLines(value) };
+}
+function messageText(m) {
+  const body = [m.title ? `**${m.title}**` : "", ...m.lines].filter(Boolean).join("\n");
+  return [m.say, body].filter(Boolean).join("\n\n").trim();
+}
+
 // ../../packages/mcp/src/prompts.ts
 var workspaceArg = {
   name: "workspace",
@@ -27708,7 +27974,18 @@ social.command("pictures <id> <urls...>").description("your own pictures on a po
     async (opts, id, urls) => tool2(opts, "social_pictures_attach", { id: ids2([id])[0], urls, append: opts.append === true })
   )
 );
-social.command("carousel <id>").description("a LinkedIn post with a set of pictures: a swipeable PDF carousel or several pictures").option("--format <format>", "pdf (a swipeable carousel, the default) or images").option("--title <text>", "shown on the carousel").option("--pdf <url>", "a public https link to your own PDF: it goes out as it is").action(
+social.command("slides <id> [count]").description("a text carousel of 5-10 slides for a post (a cover, one point a slide, the next step; free)").option("--style <style>", "bold_type (big words, the default) or infographic (lists and numbers)").action(
+  act(
+    async (opts, id, count) => tool2(opts, "social_image_new", {
+      id: ids2([id])[0],
+      count: Number(count ?? 7),
+      ...opts.style ? { style: opts.style } : {}
+    })
+  )
+);
+social.command("carousel <id>").description(
+  "a post's carousel: --pdf for LinkedIn, Instagram, Facebook or TikTok; --format / --title for LinkedIn's"
+).option("--format <format>", "pdf (a swipeable carousel, the default) or images").option("--title <text>", "shown on the carousel").option("--pdf <url>", "a public https link to your own PDF: its pages become the pictures (LinkedIn: the PDF)").action(
   act(async (opts, id) => {
     const post = ids2([id])[0];
     if (opts.pdf)
@@ -27800,6 +28077,58 @@ video.command("add <url>").description("posts from a direct link to a video file
     })
   )
 );
+video.command("post <videoId>").description("posts from a video already in CMO.so (e.g. a ready ad video's video_id), one per channel").option("--channel <names>", "linkedin, facebook, instagram, youtube, tiktok (comma-separated)", "youtube").option("--note <text>", "what the video is about").action(
+  act(
+    async (opts, videoId) => tool2(opts, "social_video_add", {
+      video_id: ids2([videoId])[0],
+      channels: (channelsOpt(opts.channel) ?? ["youtube"]).filter((c) => c !== "google_business"),
+      ...opts.note ? { note: opts.note } : {}
+    })
+  )
+);
+var ad = video.command("ad").description("ad videos (beta): plan, change, make (billed), post");
+ad.command("plan [brief...]").description("a storyboard and what making it costs (one AI generation)").option("--seconds <n>", "15, 20 or 30", "20").option("--landscape", "16:9 instead of vertical 9:16").option("--scenes <n>", "2-5").option("--from-post <id>", "make it from a post's text").option("--reference <youtubeUrl>", "a YouTube ad whose rhythm to follow").action(
+  act(
+    async (opts, brief2) => tool2(opts, "ad_video_plan", {
+      ...brief2?.length ? { brief: brief2.join(" ") } : {},
+      ...opts.fromPost ? { item_id: ids2([opts.fromPost])[0] } : {},
+      seconds: Number(opts.seconds),
+      aspect: opts.landscape ? "16:9" : "9:16",
+      ...opts.scenes ? { scenes: Number(opts.scenes) } : {},
+      ...opts.reference ? { reference_url: opts.reference } : {}
+    })
+  )
+);
+ad.command("list").description("this website's ad videos").action(act(async (opts) => tool2(opts, "ad_video_list")));
+ad.command("show <id>").description("one ad video: storyboard, cost, status").action(act(async (opts, id) => tool2(opts, "ad_video_get", { id: ids2([id])[0] })));
+ad.command("change <id>").description("change the storyboard (only what a change touches is made again)").option("--scene <id=field:text...>", "e.g. s2=line:Book today (fields: still, motion, line, caption, seconds)").option("--redo <sceneIds>", "make these scenes' pictures and clips again (comma-separated)").option("--headline <text>", "the end card's headline").option("--sub <text>", "the end card's line").option("--voice <name>", "a voice name, or none").option("--music <text>", "the music in words, or none").action(
+  act(
+    async (opts, id) => {
+      const scenes = {};
+      for (const spec of opts.scene ?? []) {
+        const m = /^([a-z0-9]+)=(still|motion|line|caption|seconds):(.*)$/s.exec(spec);
+        if (!m) throw new Error(`--scene ${spec}: use <sceneId>=<field>:<text>, e.g. s2=line:Book today`);
+        const [, sid = "", field = "", text3 = ""] = m;
+        scenes[sid] = { ...scenes[sid] ?? {}, [field]: field === "seconds" ? Number(text3) : text3 };
+      }
+      return tool2(opts, "ad_video_change", {
+        id: ids2([id])[0],
+        ...Object.keys(scenes).length ? { scenes: Object.entries(scenes).map(([sid, f]) => ({ id: sid, ...f })) } : {},
+        ...opts.redo ? { redo_scenes: opts.redo.split(",").map((x) => x.trim()) } : {},
+        ...opts.headline ? { cta_headline: opts.headline } : {},
+        ...opts.sub ? { cta_sub: opts.sub } : {},
+        ...opts.voice ? { voice: opts.voice } : {},
+        ...opts.music ? { music: opts.music } : {}
+      });
+    }
+  )
+);
+ad.command("make <id> <usd>").description("make it: costs money; <usd> is the estimate you agreed to (from plan / show)").action(
+  act(
+    async (opts, id, usd) => tool2(opts, "ad_video_make", { id: ids2([id])[0], estimate_usd: Number(usd) })
+  )
+);
+ad.command("stop <id>").description("stop one being made (what's made is kept), or remove one").action(act(async (opts, id) => tool2(opts, "ad_video_stop", { id: ids2([id])[0] })));
 video.command("attach <id> <url>").description("make a LinkedIn / Facebook / Instagram post a video post (its picture is removed)").action(act(async (opts, id, url) => tool2(opts, "social_video_attach", { id: ids2([id])[0], url })));
 video.command("detach <id>").description("take the video off a post (it's a text post again)").action(act(async (opts, id) => tool2(opts, "social_video_detach", { id: ids2([id])[0] })));
 var tiktok = social.command("tiktok").description("your TikTok account (beta): short videos you approve one by one");
@@ -27819,6 +28148,15 @@ tiktok.command("add <url>").description("a TikTok post from a direct link to a v
     })
   )
 );
+tiktok.command("photo <id>").description("a TikTok photo post from a post's pictures (a set, a text carousel or a PDF's pages)").option("--note <text>", "what to say in the caption").option("--caption <text>", "your own caption (no AI)").action(
+  act(
+    async (opts, id) => tool2(opts, "social_tiktok_photo", {
+      id: ids2([id])[0],
+      ...opts.note ? { note: opts.note } : {},
+      ...opts.caption ? { caption: opts.caption } : {}
+    })
+  )
+);
 tiktok.command("set <id>").description("a TikTok post's settings, as you choose them (nothing is preset)").option("--privacy <p>", "everyone, friends, followers or only-me (what your account offers)").option("--comment <yes|no>").option("--duet <yes|no>").option("--stitch <yes|no>").option("--promotes <what>", "none, your-brand, branded or both (content disclosure)").option("--ai <yes|no>", "AI-generated content label").action(
   act(
     async (opts, id) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/cli",
-	"version": "0.9.3",
+	"version": "0.10.0",
 	"description": "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
 	"type": "module",
 	"license": "MIT",