@cmo-so/mcp 0.10.0 → 0.11.0

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.10.0",
+  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",
@@ -8149,8 +8149,17 @@ function domainApi(api2, domain) {
       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 }),
+    /** 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). */
@@ -8908,8 +8917,12 @@ var confirmCopy = {
     "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`
+    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.`,
@@ -11685,7 +11698,7 @@ var adVideo = (v) => ({
     voice: v.plan.voice,
     music: v.plan.music,
     seconds: v.plan.seconds,
-    end_card: v.plan.cta,
+    end_card: { ...v.plan.cta, seconds: v.plan.card_seconds ?? 2.5 },
     scenes: v.plan.scenes.map((s) => ({
       id: s.id,
       seconds: s.seconds,
@@ -11693,15 +11706,23 @@ var adVideo = (v) => ({
       motion: s.motion,
       line: s.line,
       caption: s.caption,
-      picture_url: s.still_url ?? null
+      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 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." : ""
+  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",
@@ -13122,7 +13143,7 @@ var socialTools = [
   }),
   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.",
+    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: {
@@ -13169,6 +13190,8 @@ var socialTools = [
           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
@@ -13190,7 +13213,7 @@ var socialTools = [
   }),
   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.",
+    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: {
@@ -13205,12 +13228,36 @@ var socialTools = [
               motion: { type: "string" },
               line: { type: "string" },
               caption: { type: "string" },
-              seconds: { type: "number" }
+              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" },
@@ -13229,8 +13276,22 @@ var socialTools = [
         ...a.cta_sub != null ? { sub: a.cta_sub } : {}
       };
       const out = await ws(ctx).changeAdVideo(Number(a.id), {
-        ...a.scenes?.length ? { scenes: a.scenes } : {},
+        ...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 } : {},
@@ -13241,12 +13302,14 @@ var socialTools = [
   }),
   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.",
+    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)" }
+        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"]
     },
@@ -13254,7 +13317,32 @@ var socialTools = [
     need: write5,
     risk: "W3",
     gates: ["VER"],
-    run: async (ctx, { id, estimate_usd }) => adVideo(await ws(ctx).makeAdVideo(Number(id), Number(estimate_usd)))
+    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",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.10.0",
+	"version": "0.11.0",
 	"description": "CMO.so's MCP server for Claude Desktop, Cursor, VS Code and other MCP clients: manage your websites, blog posts, LinkedIn queue and results with Maggie.",
 	"type": "module",
 	"license": "MIT",