@cmo-so/mcp 0.12.0 → 0.12.2

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.12.0",
+  version: "0.12.2",
   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",
@@ -7722,6 +7722,8 @@ function domainApi(api2, domain) {
     wpBuilder: () => api2.request(`${base}/wp/builder`),
     connectWpBuilder: (input) => post(`${base}/wp/builder`, input),
     disconnectWpBuilder: () => api2.request(`${base}/wp/builder`, { method: "DELETE" }),
+    /** Put one picture in the site's media library: a public https link, or a local file as base64 (≤ 10 MB). */
+    wpMedia: (input) => post(`${base}/wp/media`, input),
     /** One WordPress REST request, signed by TOPY with the saved login (allowlisted routes only). */
     wpRequest: (input) => post(`${base}/wp/request`, input),
     /** A new website API key (aicmo_…) for the user's own code, shown once; for the CLI, which writes it to .env. */
@@ -14806,6 +14808,23 @@ function apiSite(api2, domain) {
   return {
     url: `https://${domain}`,
     fetchPage: publicFetch,
+    async uploadMedia(input) {
+      let data_base64;
+      if (input.data) {
+        let bin = "";
+        for (let i = 0; i < input.data.length; i += 32768)
+          bin += String.fromCharCode(...input.data.subarray(i, i + 32768));
+        data_base64 = btoa(bin);
+      }
+      return d.wpMedia({
+        url: input.url,
+        data_base64,
+        filename: input.filename,
+        alt: input.alt,
+        title: input.title,
+        caption: input.caption
+      });
+    },
     async request(req) {
       let r;
       try {
@@ -14838,6 +14857,12 @@ async function call(site, req) {
   const r = await site.request(req);
   if (r.status >= 200 && r.status < 300) return r.data;
   const body = r.data;
+  if (r.status >= 300 && r.status < 400)
+    throw new WpError(
+      `WordPress redirected the request (HTTP ${r.status}): use the site's final address (https, with or without www).`,
+      r.status,
+      "redirect"
+    );
   const msg = typeof body === "object" && body?.message ? body.message.replace(/<[^>]+>/g, "") : `HTTP ${r.status}`;
   const code = typeof body === "object" ? body?.code : void 0;
   if (r.status === 409 && code === "wp_not_connected")
@@ -16326,6 +16351,8 @@ var pageTools = [
           meta: meta4
         }
       });
+      if (!created || typeof created.id !== "number")
+        throw new Error("WordPress didn't create the page (no id came back); nothing was saved.");
       let menu = null;
       if (typeof a.menu_parent === "string") {
         menu = await menuSet(site, {
@@ -16496,6 +16523,8 @@ var pageTools = [
           }
         }
       });
+      if (!created || typeof created.id !== "number")
+        throw new Error("WordPress didn't create the page (no id came back); nothing was saved.");
       return {
         created: true,
         id: created.id,
@@ -16740,6 +16769,103 @@ var sectionTools = [
     }
   })
 ];
+var CHAT_FILE = {
+  type: "object",
+  description: "The picture from this chat (ChatGPT passes it here).",
+  properties: {
+    download_url: { type: "string" },
+    file_id: { type: "string" },
+    mime_type: { type: "string" },
+    file_name: { type: "string" }
+  },
+  required: ["download_url", "file_id"]
+};
+var mediaTools = [
+  tool({
+    name: "wp_media_upload",
+    description: "Put a picture in the WordPress site's media library: a picture from this chat (file) or a public https link to an image (url). JPEG, PNG, WebP, GIF or AVIF, up to 15 MB; checked as a real image. Give alt text that says what the picture shows. Returns its id and source_url; then use the url in a section (wp_section_update edits.images, or slots image) or as a page's featured_media. Doesn't change any page by itself.",
+    parameters: {
+      type: "object",
+      properties: {
+        file: CHAT_FILE,
+        url: str2("Public https link to the image file."),
+        filename: str2("File name to save it as (default from the link), e.g. maggie-hero.webp."),
+        alt: str2("Alt text: what the picture shows, in one short sentence."),
+        title: str2("Media title (optional)."),
+        caption: str2("Caption (optional).")
+      }
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W2",
+    gates: [...GATES],
+    fileParams: ["file"],
+    confirm: (a, lang) => {
+      const name = a.file?.file_name ?? (typeof a.url === "string" ? a.url.split("/").pop() : "");
+      return say(
+        lang,
+        `Upload the picture ${q2(name, "")} to your website's media library.`,
+        `\u628A\u5716\u7247 ${q2(name, "")} \u4E0A\u50B3\u5230\u7DB2\u7AD9\u7684\u5A92\u9AD4\u5EAB\u3002`
+      );
+    },
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      if (!site.uploadMedia) throw new Error("This connection can't upload pictures.");
+      const chat = a.file;
+      const url = String(chat?.download_url ?? a.url ?? "").trim();
+      if (!url) throw new Error("Give the picture: a file from this chat, or a public https link (url).");
+      const out = await site.uploadMedia({
+        url,
+        filename: a.filename || chat?.file_name || void 0,
+        alt: a.alt || void 0,
+        title: a.title || void 0,
+        caption: a.caption || void 0
+      });
+      return {
+        uploaded: true,
+        ...out,
+        next: "Use source_url in wp_section_update (edits.images from \u2192 to, or slots image), or set it as the page's featured_media with wp_page_update."
+      };
+    }
+  }),
+  tool({
+    name: "wp_media_list",
+    description: "Pictures already in the WordPress media library (newest first), with id, link, alt text and size; search by words in the title or file name.",
+    parameters: {
+      type: "object",
+      properties: {
+        search: str2("Words in the title or file name."),
+        limit: int2("How many (default 30, at most 100).")
+      }
+    },
+    group: "site",
+    need: READ,
+    risk: "R0",
+    gates: ["WP"],
+    run: async (ctx, a) => {
+      const rows = await call(siteOf(ctx), {
+        path: "/wp/v2/media",
+        query: {
+          search: a.search || void 0,
+          per_page: Math.min(100, Math.max(1, Number(a.limit) || 30)),
+          media_type: "image",
+          _fields: "id,source_url,alt_text,mime_type,date,title,media_details"
+        }
+      });
+      return {
+        count: rows.length,
+        items: rows.map((m) => ({
+          id: m.id,
+          url: m.source_url,
+          alt: m.alt_text,
+          type: m.mime_type,
+          size: m.media_details?.width ? `${m.media_details.width}\xD7${m.media_details.height}` : null,
+          date: m.date
+        }))
+      };
+    }
+  })
+];
 var seoFields = {
   title: str2("SEO title (\u224860 characters; the site name is added by the theme)."),
   description: str2("Meta description (\u2248150-160 characters)."),
@@ -16995,7 +17121,14 @@ var elementTools = [
     }
   })
 ];
-var wordpressTools = [...siteTools, ...pageTools, ...sectionTools, ...seoTools, ...elementTools];
+var wordpressTools = [
+  ...siteTools,
+  ...pageTools,
+  ...sectionTools,
+  ...mediaTools,
+  ...seoTools,
+  ...elementTools
+];
 
 // ../../packages/tools/src/index.ts
 var tools = [

package/package.json

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