@cmo-so/cli 0.9.3 → 0.11.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,35 @@ 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 (estimate.pictures_usd for stage
+     *  "pictures": only the first frames, to look at before the paid clips). A script that doesn't fit its
+     *  timing is refused (409 script_check) unless goAhead. */
+    makeAdVideo: (adId, estimateUsd, opts = {}) => post(`${base}/social/ad-videos/${adId}/make`, {
+      confirm: true,
+      estimate_usd: estimateUsd,
+      ...opts.stage ? { stage: opts.stage } : {},
+      ...opts.goAhead ? { go_ahead: true } : {}
+    }),
+    /** The person's own photo as a scene's first frame (base64, or photo_url: a picture already on CMO.so). */
+    adVideoScenePicture: (adId, sceneId, photo) => post(`${base}/social/ad-videos/${adId}/scenes/${encodeURIComponent(sceneId)}/picture`, photo),
+    /** 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 +8509,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 +8789,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 +8803,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 +8823,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 +8841,32 @@ 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) => a.stage === "pictures" ? `Make the pictures of ad video #${a.id} now, to look at before the moving clips. This costs about $${Number(a.estimate_usd ?? 0).toFixed(2)}.` : `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.${a.go_ahead ? " Its script doesn't fit its timing everywhere; it's made anyway." : ""}`,
+    "zh-Hant": (a) => a.stage === "pictures" ? `\u73FE\u5728\u5148\u88FD\u4F5C\u5EE3\u544A\u5F71\u7247 #${a.id} \u7684\u5716\u7247\uFF0C\u770B\u904E\u518D\u505A\u52D5\u614B\u7247\u6BB5\u3002\u8CBB\u7528\u7D04 $${Number(a.estimate_usd ?? 0).toFixed(2)}\u3002` : `\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${a.go_ahead ? "\u8173\u672C\u6709\u90E8\u5206\u6642\u9593\u4E0D\u5408\uFF0C\u4ECD\u7167\u6A23\u88FD\u4F5C\u3002" : ""}`
+  },
+  ad_video_picture: {
+    en: (a) => `Use this picture as the first frame of scene ${a.scene} in ad video #${a.id} (its clip is made again).`,
+    "zh-Hant": (a) => `\u628A\u9019\u5F35\u5716\u7247\u7528\u4F5C\u5EE3\u544A\u5F71\u7247 #${a.id} \u7B2C ${a.scene} \u683C\u7684\u7B2C\u4E00\u500B\u756B\u9762\uFF08\u9019\u683C\u7684\u52D5\u614B\u7247\u6BB5\u6703\u91CD\u505A\uFF09\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 +11626,44 @@ 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, seconds: v.plan.card_seconds ?? 2.5 },
+    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,
+      own_picture: s.own_picture ?? false,
+      ...s.caption_in != null ? { caption_in: s.caption_in } : {},
+      ...s.caption_out != null ? { caption_out: s.caption_out } : {},
+      ...s.voice_at != null ? { voice_at: s.voice_at } : {}
+    }))
+  } : null,
+  timeline: v.timeline ?? null,
+  script_check: v.script_check ? { ok: v.script_check.ok, total: v.script_check.total, issues: v.script_check.issues } : null,
+  pictures_ready: v.pictures_ready ?? false,
+  estimate: v.estimate,
+  cost_usd: v.cost_usd,
+  video_id: v.video_id,
+  post: v.item ?? null,
+  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, the timeline, any script_check issues and the cost (about $${(v.estimate?.usd ?? 0).toFixed(2)}${v.pictures_ready ? "" : `; the pictures alone about $${(v.estimate?.pictures_usd ?? 0).toFixed(2)}`}); change it with ad_video_change (or ad_video_picture for the user's own photo); ${v.pictures_ready ? "the pictures are made: show them (picture_url), then" : "suggest ad_video_make stage pictures first to see the pictures cheaply, then"} 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" ? v.item?.attached ? `Ready, and it's on the post it was made from (post ${v.item.id}): that post goes out as this video. To post it elsewhere too: social_video_add (video_id and channels) once video.status is ready.` : `Ready: post it with social_video_add (video_id and channels) once video.status is ready.${v.item?.skipped ? ` It wasn't put on post ${v.item.id}: ${v.item.skipped}` : ""}` : 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 +11680,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 +11883,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 +11900,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 +11922,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 +12148,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 +12169,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 +12198,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 +12896,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 +12989,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 +13007,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 +13021,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 +13054,250 @@ 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 (once made, the video goes on that post if it's still to go out on LinkedIn, Facebook or Instagram). 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,
+          post_id: v.item?.id ?? null,
+          on_post: v.item?.attached ?? false,
+          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, before making it (or after: only what changed is made again). A scene (scenes[]): its picture brief (still), movement (motion), the narrator's line, the words on screen (caption), its seconds (3-8), and timing inside it: caption_in / caption_out (when the words show and go, seconds into the scene) and voice_at (when the narrator starts); -1 puts a time back to its default; picture "ai" swaps the user's own photo back to an AI picture. add_scenes (still required; after: a scene id, else at the end); order: the scene ids to keep, in order (removes and reorders; 2-5 scenes); redo_scenes: make scenes' pictures and clips again. The whole video: style (the look; every AI picture and clip again), aspect 9:16 or 16:9 (every picture and clip again), seconds 15/20/30 (scenes rescaled), card_seconds (1.5-4); the end card (cta_headline, cta_sub); the voice (a name from ad_video_list voices, or none); the music (words, or none). redo says what's made again: a picture brief, the look or the shape mean new paid pictures and clips, a movement a new paid clip; lines, words, timing, order, end card, voice or music are cheap. Returns the new cost, the timeline and the script check (lines that don't fit their time, captions too fast to read, length); fix errors before 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" },
+              caption_in: { type: "number", description: "Words show at, seconds into the scene (-1: default)" },
+              caption_out: { type: "number", description: "Words go at, seconds into the scene (-1: default)" },
+              voice_at: { type: "number", description: "Narrator starts at, seconds into the scene (-1: default)" },
+              picture: { type: "string", enum: ["ai"], description: "Back to an AI picture" }
+            },
+            required: ["id"]
+          }
+        },
+        add_scenes: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              still: { type: "string", description: "The first frame's brief (no words in it)" },
+              motion: { type: "string" },
+              line: { type: "string" },
+              caption: { type: "string" },
+              seconds: { type: "number" },
+              after: { type: "string", description: "Put it after this scene id" }
+            },
+            required: ["still"]
+          }
+        },
+        order: { type: "array", items: { type: "string" }, description: "Scene ids to keep, in order" },
+        redo_scenes: { type: "array", items: { type: "string" } },
+        style: { type: "string", description: "The look of every scene, one sentence" },
+        aspect: { type: "string", enum: ["9:16", "16:9"] },
+        seconds: { type: "integer", description: "15, 20 or 30" },
+        card_seconds: { type: "number", description: "The end card's seconds, 1.5-4" },
+        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.map((sc) => {
+            const out2 = { ...sc };
+            for (const k of ["caption_in", "caption_out", "voice_at"]) {
+              if (out2[k] != null && Number(out2[k]) < 0) out2[k] = null;
+            }
+            return out2;
+          })
+        } : {},
+        ...a.add_scenes?.length ? { add_scenes: a.add_scenes } : {},
+        ...a.order?.length ? { order: a.order.map(String) } : {},
+        ...a.redo_scenes?.length ? { redo_scenes: a.redo_scenes } : {},
+        ...a.style ? { style: a.style } : {},
+        ...a.aspect ? { aspect: a.aspect } : {},
+        ...a.seconds ? { seconds: Number(a.seconds) } : {},
+        ...a.card_seconds != null ? { card_seconds: Number(a.card_seconds) } : {},
+        ...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). stage "pictures" makes only the first frames (cheap: estimate.pictures_usd) so the user sees them (picture_url) and changes any before the paid clips; then make it again (stage all) for the rest. Stage all: 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 (or estimate.pictures_usd for stage pictures) 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. A script that doesn't fit its timing (script_check errors) is refused: fix it with ad_video_change, or go_ahead true only when the user says to make it anyway. 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, or pictures_usd)" },
+        stage: { type: "string", enum: ["all", "pictures"], description: "pictures: only the first frames" },
+        go_ahead: { type: "boolean", description: "Make it although the script check found errors" }
+      },
+      required: ["id", "estimate_usd"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W3",
+    gates: ["VER"],
+    run: async (ctx, { id, estimate_usd, stage, go_ahead }) => adVideo(
+      await ws(ctx).makeAdVideo(Number(id), Number(estimate_usd), {
+        ...stage ? { stage } : {},
+        ...go_ahead ? { goAhead: true } : {}
+      })
+    )
+  }),
+  tool({
+    name: "ad_video_picture",
+    description: `Use the user's own photo as an ad video scene's first frame (beta): a picture already on CMO.so (picture_url: a post's picture from social_list / social_post_get). It is cropped to the video's shape; no AI picture, no cost for it; the scene's moving clip is made again. For a photo on their device, they use the Ad video screen in the CMO.so app. Back to an AI picture: ad_video_change scenes [{id, picture: "ai"}]. Not while it's being made. Preview first.`,
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The ad video" },
+        scene: { type: "string", description: "Scene id, e.g. s2" },
+        picture_url: { type: "string", description: "A picture on CMO.so (a post's picture)" }
+      },
+      required: ["id", "scene", "picture_url"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, a) => adVideo(
+      await ws(ctx).adVideoScenePicture(Number(a.id), String(a.scene), { photo_url: String(a.picture_url).trim() })
+    )
+  }),
+  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 +16970,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.9.3",
+  version: "0.11.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 +17180,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 +26837,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 +28062,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 +28165,90 @@ 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, caption_in, caption_out, voice_at; picture:ai)"
+).option(
+  "--add <field:text...>",
+  "a new scene, e.g. --add still:A wide shot of the shop --add line:Come in (after:s1)"
+).option("--order <sceneIds>", "the scenes to keep, in order (comma-separated): removes and reorders").option("--redo <sceneIds>", "make these scenes' pictures and clips again (comma-separated)").option("--style <text>", "the look of every scene (every AI picture again)").option("--shape <aspect>", "9:16 or 16:9 (every picture again)").option("--length <seconds>", "15, 20 or 30 (scenes rescaled)").option("--card-seconds <n>", "the end card's seconds (1.5-4)").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|caption_in|caption_out|voice_at|picture):(.*)$/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;
+        const numeric = ["seconds", "caption_in", "caption_out", "voice_at"].includes(field);
+        scenes[sid] = { ...scenes[sid] ?? {}, [field]: numeric ? Number(text3) : text3 };
+      }
+      const added = {};
+      for (const spec of opts.add ?? []) {
+        const m = /^(still|motion|line|caption|seconds|after):(.*)$/s.exec(spec);
+        if (!m) throw new Error(`--add ${spec}: use <field>:<text>, e.g. still:A wide shot of the shop`);
+        const [, field = "", text3 = ""] = m;
+        added[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 })) } : {},
+        ...Object.keys(added).length ? { add_scenes: [added] } : {},
+        ...opts.order ? { order: opts.order.split(",").map((x) => x.trim()) } : {},
+        ...opts.redo ? { redo_scenes: opts.redo.split(",").map((x) => x.trim()) } : {},
+        ...opts.style ? { style: opts.style } : {},
+        ...opts.shape ? { aspect: opts.shape } : {},
+        ...opts.length ? { seconds: Number(opts.length) } : {},
+        ...opts.cardSeconds ? { card_seconds: Number(opts.cardSeconds) } : {},
+        ...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)").option("--pictures", "only the pictures first (<usd> = estimate.pictures_usd), to look at before the clips").option("--go-ahead", "make it although the script check found lines that don't fit").action(
+  act(
+    async (opts, id, usd) => tool2(opts, "ad_video_make", {
+      id: ids2([id])[0],
+      estimate_usd: Number(usd),
+      ...opts.pictures ? { stage: "pictures" } : {},
+      ...opts.goAhead ? { go_ahead: true } : {}
+    })
+  )
+);
+ad.command("picture <id> <scene> <url>").description("your own photo (a picture on CMO.so, e.g. a post's) as a scene's first frame").action(
+  act(
+    async (opts, id, scene, url) => tool2(opts, "ad_video_picture", { id: ids2([id])[0], scene, picture_url: url })
+  )
+);
+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 +28268,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.11.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",