@cmo-so/mcp 0.8.0 → 0.9.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.8.0",
+  version: "0.9.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",
@@ -7669,8 +7669,11 @@ function domainApi(api2, domain) {
     }),
     /** This website's topics, for assigning an idea to one. */
     topics: () => api2.request(`${base}/topics`),
-    /** Add a waiting idea to the end of the plan. */
-    planIdea: (id) => post(`${base}/ideas/${encodeURIComponent(id)}/plan`),
+    /** Add a waiting idea to the plan: at the end, or at `position` (1-based in the answer). */
+    planIdea: (id, position) => post(
+      `${base}/ideas/${encodeURIComponent(id)}/plan`,
+      position != null ? { position } : void 0
+    ),
     /** One step up or down the 1-10 priority the planner sorts ideas by. */
     ideaPriority: (id, delta) => post(`${base}/ideas/${encodeURIComponent(id)}/priority`, { delta }),
     /** Take a post out of the plan; its idea can be restored to Ideas. */
@@ -7767,8 +7770,8 @@ function domainApi(api2, domain) {
       ...source ? { sitemap_url: source } : {}
     }),
     discardIdea: (id, restore = false) => post(`${base}/ideas/${encodeURIComponent(id)}/discard${restore ? "?restore=true" : ""}`),
-    /** OK a draft (or retry a failed post): it goes to the front of the queue; the post comes back with its eta. */
-    approveSocial: (id) => post(`${base}/social/${id}/approve`),
+    /** OK a draft (or retry a failed post): it goes to the front of the queue, or to `position`; the post comes back with its eta. */
+    approveSocial: (id, position) => post(`${base}/social/${id}/approve`, position != null ? { position } : void 0),
     skipSocial: (id) => post(`${base}/social/${id}/skip`),
     /** Post it on LinkedIn now, not at the next posting time (even while posting is paused). */
     /** Post it now. `background`: the reply comes at once (status "publishing") and it goes out behind the
@@ -7844,9 +7847,15 @@ function domainApi(api2, domain) {
     /** "Looks good, start": setup done, and Maggie writes the first week's posts. */
     socialSetupConfirm: () => post(`${base}/social/setup/confirm`),
     /** OK every post waiting for you (not a series that hasn't been approved), on one channel or all. */
-    approveAllSocial: (channel) => post(
-      `${base}/social/approve-all${channel ? `?channel=${channel}` : ""}`
-    ),
+    approveAllSocial: (channel, position) => {
+      const q2 = new URLSearchParams();
+      if (channel) q2.set("channel", channel);
+      if (position != null) q2.set("position", String(position));
+      const qs = q2.toString();
+      return post(
+        `${base}/social/approve-all${qs ? `?${qs}` : ""}`
+      );
+    },
     /** A Facebook sign-in link: after it the user lands on returnTo with ?facebook=connected (or =error). */
     connectFacebook: (returnTo = "close") => post(`${base}/social/facebook/connect`, { return_to: returnTo }),
     /** The Facebook Pages you connected, and the one this website posts to. */
@@ -7962,6 +7971,19 @@ function domainApi(api2, domain) {
       photo,
       ...opts.instruction?.trim() ? { instruction: opts.instruction.trim() } : {}
     }),
+    /** Your own set of pictures for the post, in order (up to 20; free, no AI): base64 photos and/or public
+     *  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. */
+    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`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(changes)
+    }),
     /** A new picture for every post here without one (or these), one after another in the background. */
     fillSocialImages: (opts = {}) => post(
       `${base}/social/images/fill`,
@@ -7995,20 +8017,24 @@ function domainApi(api2, domain) {
       background: true,
       ...channels ? { channels } : {}
     }),
-    startSocialFromPost: (sourcePostId, channels) => post(`${base}/social/from-post`, {
+    /** `position`: where the posts are queued when approval mode is auto (the front by default). */
+    startSocialFromPost: (sourcePostId, channels, position) => post(`${base}/social/from-post`, {
       source_post_id: sourcePostId,
       background: true,
-      ...channels ? { channels } : {}
+      ...channels ? { channels } : {},
+      ...position != null ? { position } : {}
     }),
-    startSocialPlan: (days, timezone, channels) => post(`${base}/social/plan`, {
+    startSocialPlan: (days, timezone, channels, position) => post(`${base}/social/plan`, {
       days,
       timezone,
       background: true,
-      ...channels ? { channels } : {}
+      ...channels ? { channels } : {},
+      ...position != null ? { position } : {}
     }),
-    startWriteSocialIdea: (id, channels) => post(`${base}/social/ideas/${id}/write`, {
+    startWriteSocialIdea: (id, channels, position) => post(`${base}/social/ideas/${id}/write`, {
       background: true,
-      ...channels ? { channels } : {}
+      ...channels ? { channels } : {},
+      ...position != null ? { position } : {}
     }),
     /** Disconnect the website's LinkedIn account. */
     disconnectLinkedIn: (connectionId) => api2.request(`${base}/social/linkedin/${connectionId}`, { method: "DELETE" }),
@@ -8181,10 +8207,12 @@ function domainApi(api2, domain) {
     }),
     // docs/19 P3: autopilot cadence and publish-now.
     autopilot: () => api2.request(`${base}/autopilot`),
-    /** Posts per day for pushed blogs (one of `choices`, up to the plan's limit). */
-    setPostsPerDay: (postsPerDay) => put(`${base}/autopilot/cadence`, {
-      posts_per_day: postsPerDay
-    }),
+    /** Posts per day (one of `choices`, up to the plan's limit). Pushed blogs: how many
+     * AI CMO sends a day. Pull sites: the most the site collects a day; null = the plan's. */
+    setPostsPerDay: (postsPerDay) => put(
+      `${base}/autopilot/cadence`,
+      { posts_per_day: postsPerDay }
+    ),
     /** Publish a ready draft to the connected site now (one post from today's quota). */
     publishNow: (id) => post(
       `${base}/posts/${encodeURIComponent(id)}/publish`
@@ -8255,6 +8283,8 @@ function domainApi(api2, domain) {
     inboxReport: (id) => api2.request(`${base}/reports/${id}`),
     saveReport: (r) => post(`${base}/reports`, r),
     readAllReports: () => post(`${base}/reports/read-all`, {}),
+    /** One social post in full (social_list clips its text). */
+    socialPost: (id) => api2.request(`${base}/social/${id}`),
     // Ops Autopilot: ideas the weekly clean-up archived (restorable), post health, Google reviews.
     ideaCleanup: (limit = 50) => api2.request(`${base}/idea-cleanup?limit=${limit}`),
     restoreIdeaCleanup: (id) => post(`${base}/idea-cleanup/${id}/restore`, {}),
@@ -8467,6 +8497,14 @@ var CHANNEL_EN = {
   google_business: "Google Business"
 };
 var CHANNEL_ZH = { ...CHANNEL_EN, google_business: "Google \u5546\u5BB6" };
+var channelsEn = (a) => {
+  const list2 = (Array.isArray(a.channels) ? a.channels : []).map((c) => CHANNEL_EN[String(c)] ?? String(c));
+  return list2.length ? list2.join(list2.length === 2 ? " and " : ", ") : null;
+};
+var channelsZh = (a) => {
+  const list2 = (Array.isArray(a.channels) ? a.channels : []).map((c) => CHANNEL_ZH[String(c)] ?? String(c));
+  return list2.length ? list2.join("\u3001") : null;
+};
 var named = (title, id) => {
   if (title != null && String(title).trim()) return ` ${q(title)}`;
   const s = String(id ?? "").trim();
@@ -8476,6 +8514,20 @@ var list = (xs, n = 5) => {
   const a = (Array.isArray(xs) ? xs : xs == null ? [] : [xs]).map(String);
   return a.length > n ? `${a.slice(0, n).join(", ")} +${a.length - n}` : a.join(", ");
 };
+var placeEn = (p, items = "posts") => {
+  const t = String(p ?? "").trim().toLowerCase();
+  if (t === "end") return `at the end of the queue, after the ${items} already waiting`;
+  if (t === "random") return "at a random place in the queue";
+  if (/^\d+$/.test(t)) return Number(t) === 0 ? null : `after the first ${t} in the queue`;
+  return null;
+};
+var placeZh = (p) => {
+  const t = String(p ?? "").trim().toLowerCase();
+  if (t === "end") return "\u6392\u5728\u968A\u5217\u6700\u5F8C\uFF0C\u5728\u5DF2\u5728\u7B49\u5F85\u7684\u4E4B\u5F8C";
+  if (t === "random") return "\u96A8\u6A5F\u6392\u9032\u968A\u5217";
+  if (/^\d+$/.test(t)) return Number(t) === 0 ? null : `\u6392\u5728\u968A\u5217\u524D ${t} \u7BC7\u4E4B\u5F8C`;
+  return null;
+};
 var ids = (a) => (Array.isArray(a.ids) && a.ids.length ? a.ids : a.id != null ? [a.id] : []).map(Number);
 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(
@@ -8635,8 +8687,16 @@ var confirmCopy = {
     "zh-Hant": (a) => `${Number(a.delta) > 0 ? "\u63D0\u9AD8" : "\u964D\u4F4E"}${named(a.title, a.id)} \u7684\u512A\u5148\u7D1A\u3002`
   },
   idea_plan: {
-    en: (a) => `Add${named(a.title, a.id)} to the end of the plan.`,
-    "zh-Hant": (a) => `\u628A${named(a.title, a.id)} \u52A0\u5230\u8A08\u5283\u6700\u5F8C\u3002`
+    en: (a) => {
+      const t = String(a.position ?? "").trim().toLowerCase();
+      const where = t === "front" || t === "0" ? "the front of the plan" : t === "random" ? "a random place in the plan" : /^\d+$/.test(t) ? `the plan, after the first ${t} planned posts` : "the end of the plan";
+      return `Add${named(a.title, a.id)} to ${where}.`;
+    },
+    "zh-Hant": (a) => {
+      const t = String(a.position ?? "").trim().toLowerCase();
+      const where = t === "front" || t === "0" ? "\u8A08\u5283\u6700\u524D\u9762" : t === "random" ? "\u8A08\u5283\u4E2D\u7684\u96A8\u6A5F\u4F4D\u7F6E" : /^\d+$/.test(t) ? `\u8A08\u5283\u4E2D\u524D ${t} \u7BC7\u4E4B\u5F8C` : "\u8A08\u5283\u6700\u5F8C";
+      return `\u628A${named(a.title, a.id)} \u52A0\u5230${where}\u3002`;
+    }
   },
   idea_discard: {
     en: (a) => `Remove the idea${named(a.title, a.id)}.`,
@@ -8706,23 +8766,29 @@ var confirmCopy = {
   },
   // ----------------------------------------------------------------- social
   social_update_copy: {
-    en: (a) => `Change the text of LinkedIn post #${a.id}.`,
-    "zh-Hant": (a) => `\u4FEE\u6539 LinkedIn \u8CBC\u6587 #${a.id} \u7684\u5167\u5BB9\u3002`
+    en: (a) => `Change the text of post #${a.id}.`,
+    "zh-Hant": (a) => `\u4FEE\u6539\u8CBC\u6587 #${a.id} \u7684\u5167\u5BB9\u3002`
   },
   social_approve: {
     en: (a) => {
       const n = ids(a);
-      return n.length > 1 ? `Approve ${n.length} LinkedIn posts: ${n.map((i) => `#${i}`).join(", ")}. Each goes out at your next posting times, where your network can see it.` : `Approve LinkedIn post #${n[0]}. It goes out at your next posting time, where your network can see it.`;
+      const at = placeEn(a.position);
+      if (at)
+        return `Approve ${n.length > 1 ? `${n.length} posts: ${n.map((i) => `#${i}`).join(", ")}` : `post #${n[0]}`}. ${n.length > 1 ? "They are" : "It is"} queued ${at}, and go${n.length > 1 ? "" : "es"} out where your network can see ${n.length > 1 ? "them" : "it"}.`;
+      return n.length > 1 ? `Approve ${n.length} posts: ${n.map((i) => `#${i}`).join(", ")}. Each goes out at your next posting times, where your network can see it.` : `Approve post #${n[0]}. It goes out at your next posting time, where your network can see it.`;
     },
     "zh-Hant": (a) => {
       const n = ids(a);
-      return n.length > 1 ? `\u6279\u51C6 ${n.length} \u7BC7 LinkedIn \u8CBC\u6587\uFF1A${n.map((i) => `#${i}`).join("\u3001")}\u3002\u6BCF\u7BC7\u5728\u63A5\u4E0B\u4F86\u7684\u767C\u6587\u6642\u9593\u767C\u51FA\uFF0C\u4F60\u7684\u4EBA\u8108\u90FD\u770B\u5F97\u5230\u3002` : `\u6279\u51C6 LinkedIn \u8CBC\u6587 #${n[0]}\u3002\u5B83\u6703\u5728\u4E0B\u4E00\u500B\u767C\u6587\u6642\u9593\u767C\u51FA\uFF0C\u4F60\u7684\u4EBA\u8108\u90FD\u770B\u5F97\u5230\u3002`;
+      const at = placeZh(a.position);
+      if (at)
+        return `\u6279\u51C6${n.length > 1 ? ` ${n.length} \u7BC7\u8CBC\u6587\uFF1A${n.map((i) => `#${i}`).join("\u3001")}` : `\u8CBC\u6587 #${n[0]}`}\u3002${at}\uFF0C\u767C\u51FA\u5F8C\u4F60\u7684\u4EBA\u8108\u90FD\u770B\u5F97\u5230\u3002`;
+      return n.length > 1 ? `\u6279\u51C6 ${n.length} \u7BC7\u8CBC\u6587\uFF1A${n.map((i) => `#${i}`).join("\u3001")}\u3002\u6BCF\u7BC7\u5728\u63A5\u4E0B\u4F86\u7684\u767C\u6587\u6642\u9593\u767C\u51FA\uFF0C\u4F60\u7684\u4EBA\u8108\u90FD\u770B\u5F97\u5230\u3002` : `\u6279\u51C6\u8CBC\u6587 #${n[0]}\u3002\u5B83\u6703\u5728\u4E0B\u4E00\u500B\u767C\u6587\u6642\u9593\u767C\u51FA\uFF0C\u4F60\u7684\u4EBA\u8108\u90FD\u770B\u5F97\u5230\u3002`;
     }
   },
-  social_skip: { en: (a) => `Skip LinkedIn post #${a.id}.`, "zh-Hant": (a) => `\u8DF3\u904E LinkedIn \u8CBC\u6587 #${a.id}\u3002` },
+  social_skip: { en: (a) => `Skip post #${a.id}.`, "zh-Hant": (a) => `\u8DF3\u904E\u8CBC\u6587 #${a.id}\u3002` },
   social_restore: {
-    en: (a) => `Bring back LinkedIn post #${a.id}.`,
-    "zh-Hant": (a) => `\u6062\u5FA9 LinkedIn \u8CBC\u6587 #${a.id}\u3002`
+    en: (a) => `Bring back post #${a.id}.`,
+    "zh-Hant": (a) => `\u6062\u5FA9\u8CBC\u6587 #${a.id}\u3002`
   },
   youtube_connect_link: {
     en: () => "Make a link to connect your YouTube channel.",
@@ -8763,28 +8829,52 @@ 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 LinkedIn 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 LinkedIn \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) => `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`
   },
   social_image_stop: {
-    en: () => "Stop the LinkedIn picture being made; the post keeps the one it had.",
-    "zh-Hant": () => "\u505C\u6B62\u6B63\u5728\u751F\u6210\u7684 LinkedIn \u5716\u7247\uFF1B\u8CBC\u6587\u4FDD\u7559\u539F\u4F86\u7684\u5716\u7247\u3002"
+    en: () => "Stop the picture being made; the post keeps the one it had.",
+    "zh-Hant": () => "\u505C\u6B62\u6B63\u5728\u751F\u6210\u7684\u5716\u7247\uFF1B\u8CBC\u6587\u4FDD\u7559\u539F\u4F86\u7684\u5716\u7247\u3002"
+  },
+  social_pictures_attach: {
+    en: (a) => {
+      const n = Array.isArray(a.urls) ? a.urls.length : 0;
+      return `${a.append ? "Add" : "Put"} your ${n} picture${n === 1 ? "" : "s"} ${a.append ? "after the pictures on" : "on"} post #${a.id}${a.append ? "" : ", in place of its picture"} (free). On LinkedIn a set goes out as a swipeable PDF carousel.`;
+    },
+    "zh-Hant": (a) => {
+      const n = Array.isArray(a.urls) ? a.urls.length : 0;
+      return `${a.append ? `\u5728\u8CBC\u6587 #${a.id} \u73FE\u6709\u5716\u7247\u5F8C\u52A0\u4E0A` : `\u628A\u8CBC\u6587 #${a.id} \u7684\u5716\u7247\u63DB\u6210`}\u4F60\u7684 ${n} \u5F35\u5716\u7247\uFF08\u514D\u8CBB\uFF09\u3002\u5728 LinkedIn \u4E0A\uFF0C\u4E00\u7D44\u5716\u7247\u6703\u4EE5\u53EF\u6ED1\u52D5\u7684 PDF \u8F2A\u64AD\u767C\u51FA\u3002`;
+    }
+  },
+  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`
+  },
+  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)}` : ""}.`,
+    "zh-Hant": (a) => `LinkedIn \u8CBC\u6587 #${a.id} ${a.format === "images" ? "\u4EE5\u591A\u5F35\u5716\u7247\u767C\u51FA" : a.format === "pdf" ? "\u4EE5\u53EF\u6ED1\u52D5\u7684 PDF \u8F2A\u64AD\u767C\u51FA" : "\u7167\u76EE\u524D\u8A2D\u5B9A\u767C\u51FA"}${a.title ? `\uFF0C\u6A19\u984C ${q(a.title)}` : ""}\u3002`
   },
   social_move: {
-    en: (a) => `Move LinkedIn post #${a.id} ${a.to === "top" ? "to the top of" : a.to} Upcoming.`,
-    "zh-Hant": (a) => `\u628A LinkedIn \u8CBC\u6587 #${a.id} ${a.to === "top" ? "\u79FB\u5230\u5373\u5C07\u767C\u51FA\u7684\u6700\u524D" : a.to === "up" ? "\u4E0A\u79FB" : "\u4E0B\u79FB"}\u3002`
+    en: (a) => `Move post #${a.id} ${a.to === "top" ? "to the top of its channel's queue" : `${a.to} in its channel's queue`}.`,
+    "zh-Hant": (a) => `\u628A\u8CBC\u6587 #${a.id} ${a.to === "top" ? "\u79FB\u5230\u8A72\u6E20\u9053\u968A\u5217\u7684\u6700\u524D" : a.to === "up" ? "\u5728\u8A72\u6E20\u9053\u968A\u5217\u4E2D\u4E0A\u79FB" : "\u5728\u8A72\u6E20\u9053\u968A\u5217\u4E2D\u4E0B\u79FB"}\u3002`
   },
   social_set_paused: {
-    en: (a) => a.paused ? "Pause all LinkedIn posting." : "Resume LinkedIn posting.",
-    "zh-Hant": (a) => a.paused ? "\u66AB\u505C\u6240\u6709 LinkedIn \u767C\u6587\u3002" : "\u6062\u5FA9 LinkedIn \u767C\u6587\u3002"
+    en: (a) => {
+      const on2 = a.channel ? `${CHANNEL_EN[String(a.channel)] ?? a.channel} posting` : "posting on every channel";
+      return a.paused ? `Pause ${on2}.` : `Resume ${on2}.`;
+    },
+    "zh-Hant": (a) => {
+      const on2 = a.channel ? `${CHANNEL_ZH[String(a.channel)] ?? a.channel} ` : "\u6240\u6709\u6E20\u9053\u7684";
+      return a.paused ? `\u66AB\u505C${on2}\u767C\u6587\u3002` : `\u6062\u5FA9${on2}\u767C\u6587\u3002`;
+    }
   },
   social_from_article: {
-    en: (a) => `Write a LinkedIn post about ${q(a.title || a.source_id)}; it waits for your OK unless your LinkedIn posts go out on their own.`,
-    "zh-Hant": (a) => `\u6839\u64DA ${q(a.title || a.source_id)} \u5BEB\u4E00\u7BC7 LinkedIn \u8CBC\u6587\uFF1B\u9664\u975E\u4F60\u8A2D\u5B9A\u8CBC\u6587\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6\u3002`
+    en: (a) => `Write ${channelsEn(a) ? `a ${channelsEn(a)} post` : "a post for each connected channel"} about ${q(a.title || a.source_id)}; it waits for your OK unless your posts go out on their own${placeEn(a.position) ? ` (then it is queued ${placeEn(a.position)})` : ""}.`,
+    "zh-Hant": (a) => `\u6839\u64DA ${q(a.title || a.source_id)} ${channelsZh(a) ? `\u5BEB\u4E00\u7BC7 ${channelsZh(a)} \u8CBC\u6587` : "\u70BA\u6BCF\u500B\u5DF2\u9023\u63A5\u7684\u6E20\u9053\u5404\u5BEB\u4E00\u7BC7\u8CBC\u6587"}\uFF1B\u9664\u975E\u4F60\u8A2D\u5B9A\u8CBC\u6587\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6${placeZh(a.position) ? `\uFF08\u81EA\u52D5\u767C\u51FA\u6642${placeZh(a.position)}\uFF09` : ""}\u3002`
   },
   social_plan_days: {
-    en: (a) => `Write LinkedIn posts for the next ${a.days} day${Number(a.days) === 1 ? "" : "s"} from your best articles; they wait for your OK unless your LinkedIn posts go out on their own.`,
-    "zh-Hant": (a) => `\u7528\u4F60\u6700\u597D\u7684\u6587\u7AE0\u5BEB\u672A\u4F86 ${a.days} \u5929\u7684 LinkedIn \u8CBC\u6587\uFF1B\u9664\u975E\u4F60\u8A2D\u5B9A\u8CBC\u6587\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6\u3002`
+    en: (a) => `Write ${channelsEn(a) ? `${channelsEn(a)} posts` : "posts on each connected channel"} for the next ${a.days} day${Number(a.days) === 1 ? "" : "s"} from your best articles; they wait for your OK unless your posts go out on their own${placeEn(a.position) ? ` (then they are queued ${placeEn(a.position)})` : ""}.`,
+    "zh-Hant": (a) => `\u7528\u4F60\u6700\u597D\u7684\u6587\u7AE0\u5BEB\u672A\u4F86 ${a.days} \u5929\u7684${channelsZh(a) ? ` ${channelsZh(a)} ` : "\u5404\u6E20\u9053"}\u8CBC\u6587\uFF1B\u9664\u975E\u4F60\u8A2D\u5B9A\u8CBC\u6587\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6${placeZh(a.position) ? `\uFF08\u81EA\u52D5\u767C\u51FA\u6642${placeZh(a.position)}\uFF09` : ""}\u3002`
   },
   social_idea_add: {
     en: (a) => `Add the LinkedIn idea ${q(a.title)}.`,
@@ -8799,8 +8889,8 @@ var confirmCopy = {
     "zh-Hant": (a) => `\u522A\u9664 LinkedIn idea #${a.id}${a.title ? ` ${q(a.title)}` : ""}\u3002`
   },
   social_idea_write: {
-    en: (a) => `Write the LinkedIn post for idea #${a.id}${a.title ? ` ${q(a.title)}` : ""}; your own idea's post waits for your OK unless your LinkedIn posts go out on their own.`,
-    "zh-Hant": (a) => `\u70BA idea #${a.id}${a.title ? ` ${q(a.title)}` : ""} \u5BEB LinkedIn \u8CBC\u6587\uFF1B\u4F60\u81EA\u5DF1 idea \u7684\u8CBC\u6587\uFF0C\u9664\u975E\u4F60\u8A2D\u5B9A\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6\u3002`
+    en: (a) => `Write ${channelsEn(a) ? `the ${channelsEn(a)} post` : "a post for each connected channel"} for idea #${a.id}${a.title ? ` ${q(a.title)}` : ""}; your own idea's posts wait for your OK unless your posts go out on their own${placeEn(a.position) ? ` (then it is queued ${placeEn(a.position)})` : ""}.`,
+    "zh-Hant": (a) => `\u70BA idea #${a.id}${a.title ? ` ${q(a.title)}` : ""} \u5BEB${channelsZh(a) ? ` ${channelsZh(a)} ` : "\u5404\u6E20\u9053\u7684"}\u8CBC\u6587\uFF1B\u4F60\u81EA\u5DF1 idea \u7684\u8CBC\u6587\uFF0C\u9664\u975E\u4F60\u8A2D\u5B9A\u81EA\u52D5\u767C\u51FA\uFF0C\u5426\u5247\u6703\u7B49\u4F60\u6279\u51C6${placeZh(a.position) ? `\uFF08\u81EA\u52D5\u767C\u51FA\u6642${placeZh(a.position)}\uFF09` : ""}\u3002`
   },
   social_idea_save: {
     en: (a) => `Save this LinkedIn post for idea #${a.id} (one AI generation): ${q(a.text)}`,
@@ -8866,8 +8956,8 @@ var confirmCopy = {
     "zh-Hant": () => "\u7522\u751F\u4E00\u500B\u9023\u63A5 LinkedIn \u7684\u9023\u7D50\u3002"
   },
   social_approve_all: {
-    en: (a) => `Approve every ${a.channel ? `${CHANNEL_EN[String(a.channel)] ?? a.channel} ` : ""}post waiting for your OK${a.channel ? "" : ", on every channel"}, including any held for a picture check. They go out one by one at each channel's posting times, where people can see them.`,
-    "zh-Hant": (a) => `\u6279\u51C6\u6240\u6709\u7B49\u4F60\u78BA\u8A8D\u7684${a.channel ? ` ${CHANNEL_ZH[String(a.channel)] ?? a.channel} ` : "\uFF08\u6240\u6709\u6E20\u9053\uFF09"}\u8CBC\u6587\uFF0C\u5305\u62EC\u56E0\u5716\u7247\u6AA2\u67E5\u800C\u66AB\u505C\u7684\u3002\u5B83\u5011\u6703\u5728\u5404\u6E20\u9053\u63A5\u4E0B\u4F86\u7684\u767C\u6587\u6642\u9593\u9010\u7BC7\u767C\u51FA\uFF0C\u5927\u5BB6\u90FD\u770B\u5F97\u5230\u3002`
+    en: (a) => `Approve every ${a.channel ? `${CHANNEL_EN[String(a.channel)] ?? a.channel} ` : ""}post waiting for your OK${a.channel ? "" : ", on every channel"}, including any held for a picture check. They go out one by one at each channel's posting times${placeEn(a.position) ? `, queued ${placeEn(a.position)}` : ""}, where people can see them.`,
+    "zh-Hant": (a) => `\u6279\u51C6\u6240\u6709\u7B49\u4F60\u78BA\u8A8D\u7684${a.channel ? ` ${CHANNEL_ZH[String(a.channel)] ?? a.channel} ` : "\uFF08\u6240\u6709\u6E20\u9053\uFF09"}\u8CBC\u6587\uFF0C\u5305\u62EC\u56E0\u5716\u7247\u6AA2\u67E5\u800C\u66AB\u505C\u7684\u3002\u5B83\u5011\u6703\u5728\u5404\u6E20\u9053\u7684\u767C\u6587\u6642\u9593\u9010\u7BC7\u767C\u51FA${placeZh(a.position) ? `\uFF08${placeZh(a.position)}\uFF09` : ""}\uFF0C\u5927\u5BB6\u90FD\u770B\u5F97\u5230\u3002`
   },
   series_create: {
     en: (a) => `Plan and write a LinkedIn series about ${q(a.brief)}: ${a.count || 3} posts that read as a series. Each waits in Review for your OK. Uses one AI generation a post.`,
@@ -9022,6 +9112,18 @@ var int = (v, min, max, fallback) => {
   const n = Math.trunc(Number(v));
   return Number.isFinite(n) ? Math.min(max, Math.max(min, n)) : fallback;
 };
+var positionParam = (what, fallback) => ({
+  type: "string",
+  description: `Where ${what} go: "front", "end", "random", or a number of items to go after ("0" = front; more than there are = end). ${fallback} Scheduled or automated runs should use "end" so they don't jump ahead of what is already waiting.`
+});
+var positionOf = (value) => {
+  if (value == null || value === "") return void 0;
+  if (typeof value === "number" && Number.isInteger(value) && value >= 0) return value;
+  const text3 = String(value).trim().toLowerCase();
+  if (text3 === "front" || text3 === "end" || text3 === "random") return text3;
+  if (/^\d+$/.test(text3)) return Number(text3);
+  throw new Error('position must be "front", "end", "random" or a number of items to go after (0 = front).');
+};
 function tool(t) {
   const out = { ...t };
   if (t.risk !== "R0" && !t.confirm)
@@ -9716,19 +9818,20 @@ var blogTools = [
   }),
   tool({
     name: "idea_plan",
-    description: "Add a waiting idea to the end of the plan (the plan holds up to 100).",
+    description: "Add a waiting idea to the plan (the plan holds up to 100): at the end, or where `position` says (front, random, after N planned posts). The answer's position counts from 1.",
     parameters: {
       type: "object",
       properties: {
         id: { type: "string" },
-        title: { type: "string", description: "As listed (shown on the approval card and in History)" }
+        title: { type: "string", description: "As listed (shown on the approval card and in History)" },
+        position: positionParam("the idea", "Leave out for the end of the plan.")
       },
       required: ["id", "title"]
     },
     group: "blog",
     need: write,
     risk: "W1",
-    run: async (ctx, { id }) => ws(ctx).planIdea(id)
+    run: async (ctx, { id, position }) => ws(ctx).planIdea(id, positionOf(position))
   }),
   tool({
     name: "idea_discard",
@@ -10899,6 +11002,32 @@ var opsTools = [
       const { reviewer, comment, ...rest } = r;
       return { ...rest, ...untrusted({ reviewer, comment }) };
     }
+  }),
+  tool({
+    name: "social_post_get",
+    description: "One social post in full: its whole text (social_list shortens it to about 300 characters), its pictures, its link, its channel and status, when it goes out, and why it was held before going out, if it was. Use it to check a post's ending (a web address or phone number on Google, a cut-off sentence) before approving or fixing it.",
+    parameters: { type: "object", properties: { id: { type: "integer" } }, required: ["id"] },
+    group: "social",
+    need: { resource: "autopilot", level: "read" },
+    risk: "R0",
+    run: async (ctx, { id }) => {
+      const p = await ws(ctx).socialPost(int(id, 1, Number.MAX_SAFE_INTEGER, 0));
+      return {
+        id: p.id,
+        channel: p.provider,
+        status: p.status,
+        eta: p.eta ?? null,
+        text: p.social_copy,
+        characters: String(p.social_copy ?? "").length,
+        picture: p.image_url ?? null,
+        pictures: p.image_urls ?? [],
+        // LinkedIn with a set (or an uploaded PDF): a PDF carousel or several pictures.
+        carousel: p.carousel ?? null,
+        link: p.cta_url ?? p.source_url ?? null,
+        held: p.held ?? null,
+        failure: p.failure_message ?? null
+      };
+    }
   })
 ];
 
@@ -10921,7 +11050,7 @@ var publishingTools = [
   }),
   tool({
     name: "posts_per_day_set",
-    description: "How many blog posts a day AI CMO publishes to the website (1, 2, 12, 24, 48 or 96, up to the plan's limit). Only for sites AI CMO pushes to; plugin / API sites fetch on their own schedule.",
+    description: "Blog posts a day for the website (1, 2, 12, 24, 48 or 96, up to the plan's limit). Sites AI CMO pushes to: how many it publishes a day. Plugin / API sites: the most the site collects a day (it still decides how often it checks).",
     parameters: {
       type: "object",
       properties: {
@@ -11484,6 +11613,7 @@ var channelsParam = {
   items: { type: "string", enum: CHANNEL_KEYS },
   description: "Which channels to write for: linkedin, facebook, instagram, google_business. Leave out to write for every connected channel (one post each, one credit each); give one only when the user names it. YouTube and TikTok take a video: use social_video_add."
 };
+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)) : [];
   return list2.length ? list2 : void 0;
@@ -11576,24 +11706,28 @@ var socialTools = [
   }),
   tool({
     name: "social_approve",
-    description: "Approve LinkedIn post drafts: each goes to the front of the user's queue and out at the next posting times. Pass every id to approve in one call.",
+    description: "Approve post drafts: each goes to the front of the user's queue and out at the next posting times, or where `position` says (end, random, after N posts). Pass every id to approve in one call.",
     parameters: {
       type: "object",
-      properties: { ids: { type: "array", items: { type: "integer" }, description: "The drafts to approve" } },
+      properties: {
+        ids: { type: "array", items: { type: "integer" }, description: "The drafts to approve" },
+        position: queuedAt
+      },
       required: ["ids"]
     },
     group: "social",
     need: write5,
     risk: "W3",
     gates: ["VER", "LI"],
-    run: async (ctx, { ids: ids2, id }) => {
+    run: async (ctx, { ids: ids2, id, position }) => {
       const list2 = (Array.isArray(ids2) && ids2.length ? ids2 : id != null ? [id] : []).map(Number).slice(0, 20);
       if (!list2.length) throw new Error("Which post?");
+      const at = positionOf(position);
       const api2 = ws(ctx);
       const results = [];
       for (const n of list2) {
         try {
-          await api2.approveSocial(n);
+          await api2.approveSocial(n, at);
           results.push({ id: n, ok: true });
         } catch (e) {
           results.push({ id: n, ok: false, error: e instanceof Error ? e.message : String(e) });
@@ -11846,6 +11980,90 @@ var socialTools = [
       return { id: out.id, picture: out.picture, pictures: out.image_urls?.length ? out.image_urls : [out.image_url] };
     }
   }),
+  tool({
+    name: "social_pictures_attach",
+    description: "Put the user's own pictures on a post, in order: public https links to image files (JPEG, PNG or WebP), for example slides another assistant made. 1-20 pictures; append adds them after the post's current ones. Free (no AI). They replace Maggie's picture; a post from an idea shares them with its other channels. Instagram and Facebook post the first 10, Google Business the first. On LinkedIn a set goes out as a swipeable PDF carousel unless social_carousel_set says images. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The post (from social_list), not gone out yet" },
+        urls: {
+          type: "array",
+          items: { type: "string" },
+          description: "Public https links to the image files, in the order they should appear"
+        },
+        append: { type: "boolean", description: "Add after the post's current pictures instead of replacing them" }
+      },
+      required: ["id", "urls"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, urls, append }) => {
+      const list2 = (Array.isArray(urls) ? urls : []).map((u) => String(u).trim()).filter(Boolean);
+      if (!list2.length) throw new Error("Give at least one https link to a picture.");
+      if (list2.length > 20) throw new Error("A post takes up to 20 pictures.");
+      if (list2.some((u) => !u.startsWith("https://"))) throw new Error("Every picture needs a public https link.");
+      const out = await ws(ctx).setSocialPictures(Number(id), { urls: list2, append: append === true });
+      return {
+        id: out.id,
+        pictures: out.image_urls?.length ? out.image_urls : [out.image_url],
+        carousel: out.carousel ?? null
+      };
+    }
+  }),
+  tool({
+    name: "social_carousel_pdf_attach",
+    description: "A LinkedIn post goes out as this PDF: a swipeable document carousel (a public https link to the PDF, 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. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A LinkedIn post (from social_list), not gone out yet" },
+        url: { type: "string", description: "Public https link to the PDF file" },
+        title: {
+          type: "string",
+          description: "Shown on the carousel (up to 120 characters); the post's topic if left out"
+        }
+      },
+      required: ["id", "url"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER", "LI"],
+    run: async (ctx, { id, url, title }) => {
+      const link = String(url ?? "").trim();
+      if (!link.startsWith("https://")) throw new Error("Give a public https link to the PDF.");
+      const out = await ws(ctx).attachSocialCarouselPdf(Number(id), { url: link, ...title ? { title } : {} });
+      return { id: out.id, pages: out.pages, pictures: out.pictures, carousel: out.carousel ?? null };
+    }
+  }),
+  tool({
+    name: "social_carousel_set",
+    description: "How a LinkedIn post with a set of pictures goes out: format pdf (a swipeable PDF carousel made from the pictures, the default) or images (several pictures); and the carousel's title. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A LinkedIn post with a set of pictures (from social_list)" },
+        format: { type: "string", enum: ["pdf", "images"] },
+        title: { type: "string", description: "Shown on the carousel (up to 120 characters)" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, format, title }) => {
+      if (format == null && title == null) throw new Error("Say the format (pdf or images) or a title.");
+      const out = await ws(ctx).setSocialCarousel(Number(id), {
+        ...format ? { format } : {},
+        ...title != null ? { title: String(title) } : {}
+      });
+      return { id: out.id, carousel: out.carousel ?? null };
+    }
+  }),
   tool({
     name: "social_post_insights",
     description: "How a posted Instagram post is doing: views, reach, likes, comments, saves and shares, read from Instagram (kept 15 minutes; refresh: true reads again). Saves and shares per reach are the best signs of a good post. available: false says why (not posted yet, deleted on Instagram, the account needs reconnecting).",
@@ -11954,13 +12172,14 @@ var socialTools = [
   }),
   tool({
     name: "social_from_article",
-    description: "Maggie writes a post about one published article (id from social_sources_list) for each channel. It waits for the user's OK as a draft, unless their approval mode is auto (then it goes to the front of the queue). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
+    description: "Maggie writes a post about one published article (id from social_sources_list) for each channel. It waits for the user's OK as a draft, unless their approval mode is auto (then it is queued: at the front, or where `position` says). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
     parameters: {
       type: "object",
       properties: {
         source_id: { type: "string" },
         title: { type: "string", description: "As listed (shown on the approval card and in History)" },
-        channels: channelsParam
+        channels: channelsParam,
+        position: queuedAt
       },
       required: ["source_id", "title"]
     },
@@ -11968,17 +12187,18 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "LLM"],
-    run: async (ctx, { source_id, channels }) => writing((await ws(ctx).startSocialFromPost(String(source_id), channelsOf(channels))).job)
+    run: async (ctx, { source_id, channels, position }) => writing((await ws(ctx).startSocialFromPost(String(source_id), channelsOf(channels), positionOf(position))).job)
   }),
   tool({
     name: "social_plan_days",
-    description: "Maggie writes posts for the next 1\u20137 days from the best recent articles, on each channel. They wait for the user's OK as drafts, unless the user's approval mode is auto (then they are queued in order). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
+    description: "Maggie writes posts for the next 1\u20137 days from the best recent articles, on each channel. They wait for the user's OK as drafts, unless the user's approval mode is auto (then they are queued in order: at the front, or where `position` says). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
     parameters: {
       type: "object",
       properties: {
         days: { type: "integer", minimum: 1, maximum: 7 },
         timezone: { type: "string", description: "IANA timezone, if known" },
-        channels: channelsParam
+        channels: channelsParam,
+        position: queuedAt
       },
       required: ["days"]
     },
@@ -11986,7 +12206,14 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "LLM"],
-    run: async (ctx, { days, timezone, channels }) => writing((await ws(ctx).startSocialPlan(int(days, 1, 7, 3), timezone || "UTC", channelsOf(channels))).job)
+    run: async (ctx, { days, timezone, channels, position }) => writing(
+      (await ws(ctx).startSocialPlan(
+        int(days, 1, 7, 3),
+        timezone || "UTC",
+        channelsOf(channels),
+        positionOf(position)
+      )).job
+    )
   }),
   tool({
     name: "social_ideas_list",
@@ -12059,13 +12286,14 @@ var socialTools = [
   }),
   tool({
     name: "social_idea_write",
-    description: "Maggie writes one idea's post for each channel (1 credit per post). The user's own idea's posts wait for their OK (queued straight away only in approval mode auto); a campaign's wait for the campaign to start. Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
+    description: "Maggie writes one idea's post for each channel (1 credit per post). The user's own idea's posts wait for their OK (queued straight away only in approval mode auto, at the front or where `position` says); a campaign's wait for the campaign to start. Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts).",
     parameters: {
       type: "object",
       properties: {
         id: { type: "integer" },
         title: { type: "string", description: "As listed (shown on the approval card and in History)" },
-        channels: channelsParam
+        channels: channelsParam,
+        position: queuedAt
       },
       required: ["id", "title"]
     },
@@ -12073,7 +12301,7 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "CR", "LLM"],
-    run: async (ctx, { id, channels }) => writing((await ws(ctx).startWriteSocialIdea(Number(id), channelsOf(channels))).job)
+    run: async (ctx, { id, channels, position }) => writing((await ws(ctx).startWriteSocialIdea(Number(id), channelsOf(channels), positionOf(position))).job)
   }),
   tool({
     name: "social_idea_brief",
@@ -12199,13 +12427,16 @@ var socialTools = [
   }),
   tool({
     name: "social_approve_all",
-    description: "Approve every post waiting for the user's OK (not a series that hasn't been approved), on one channel or all: they go out one by one at each channel's next posting times.",
-    parameters: { type: "object", properties: { channel: { type: "string", enum: CHANNEL_KEYS } } },
+    description: "Approve every post waiting for the user's OK (not a series that hasn't been approved), on one channel or all: they go out one by one at each channel's next posting times (from the front of the queue, or where `position` says).",
+    parameters: {
+      type: "object",
+      properties: { channel: { type: "string", enum: CHANNEL_KEYS }, position: queuedAt }
+    },
     group: "social",
     need: write5,
     risk: "W3",
     gates: ["VER", "LI"],
-    run: async (ctx, { channel }) => ws(ctx).approveAllSocial(channelsOf(channel ? [channel] : [])?.[0])
+    run: async (ctx, { channel, position }) => ws(ctx).approveAllSocial(channelsOf(channel ? [channel] : [])?.[0], positionOf(position))
   }),
   tool({
     name: "series_create",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.8.0",
+	"version": "0.9.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",