@cmo-so/cli 0.2.0 → 0.3.0

package/dist/cmo.mjs

@@ -7473,7 +7473,7 @@ function dataUrl(type, bytes) {
 }
 
 // ../../packages/api-client/src/domains.ts
-var MEMORY_CHANNELS = ["general", "blog", "linkedin", "facebook"];
+var MEMORY_CHANNELS = ["general", "blog", "linkedin", "facebook", "instagram", "google_business"];
 function addWebsite(api2, url) {
   return api2.request("/v1/domains", {
     method: "POST",
@@ -7592,8 +7592,15 @@ function domainApi(api2, domain) {
     approveSocial: (id) => post(`${base}/social/${id}/approve`),
     skipSocial: (id) => post(`${base}/social/${id}/skip`),
     /** Post it on LinkedIn now, not at the next posting time (even while posting is paused). */
-    publishSocialNow: (id) => post(`${base}/social/${id}/publish`),
+    /** Post it now. `background`: the reply comes at once (status "publishing") and it goes out behind the
+     *  scenes (a notice when it's out); 409 `picture_busy` while its picture is being made. */
+    publishSocialNow: (id, opts = {}) => post(
+      `${base}/social/${id}/publish`,
+      opts.background ? { background: true } : void 0
+    ),
     /** Take a posted LinkedIn post down (its likes and comments go with it). */
+    /** How a posted Instagram post is doing (read from Instagram, kept 15 minutes; `refresh` reads again). */
+    socialInsights: (id, refresh = false) => api2.request(`${base}/social/${id}/insights${refresh ? "?refresh=true" : ""}`),
     deletePostedSocial: (id) => api2.request(`${base}/social/${id}/published`, { method: "DELETE" }),
     /** Change a posted LinkedIn post and put it up again: the old one comes down, the new text goes out now. */
     republishSocial: (id, socialCopy) => post(`${base}/social/${id}/republish`, socialCopy ? { social_copy: socialCopy } : {}),
@@ -7629,10 +7636,10 @@ function domainApi(api2, domain) {
     /** The template library, searchable. */
     socialTemplates: (search = "") => api2.request(`${base}/social/templates?search=${encodeURIComponent(search)}`),
     socialTemplatePreview: (key) => api2.request(`${base}/social/templates/${encodeURIComponent(key)}/preview`),
-    socialSetupTemplates: (keys3, writing) => api2.request(`${base}/social/setup/templates`, {
+    socialSetupTemplates: (keys3, writing2) => api2.request(`${base}/social/setup/templates`, {
       method: "PUT",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ keys: keys3, writing })
+      body: JSON.stringify({ keys: keys3, writing: writing2 })
     }),
     socialSetupSchedule: (schedule) => api2.request(`${base}/social/setup/schedule`, {
       method: "PUT",
@@ -7674,6 +7681,32 @@ function domainApi(api2, domain) {
       }
     ),
     disconnectFacebook: (connectionId) => api2.request(`${base}/social/facebook/${connectionId}`, { method: "DELETE" }),
+    /** Instagram connects through the Facebook sign-in (the accounts linked to your Pages): the same link;
+     *  back with ?facebook=connected, then `channels` says whether an Instagram account was found. */
+    connectInstagram: (returnTo = "close") => post(`${base}/social/instagram/connect`, { return_to: returnTo }),
+    /** Your Instagram accounts here (each with the Facebook Page it posts through), and the chosen one. */
+    instagramAccounts: () => api2.request(`${base}/social/instagram/accounts`),
+    chooseInstagramAccount: (connectionId) => api2.request(
+      `${base}/social/instagram/account`,
+      {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ connection_id: connectionId })
+      }
+    ),
+    disconnectInstagram: (connectionId) => api2.request(`${base}/social/instagram/${connectionId}`, { method: "DELETE" }),
+    /** A Google sign-in link for this website's Google Business Profile; back with ?google_business=connected
+     *  (or none / error&message=…). Every profile the account can post to is saved; this website's is picked. */
+    connectGoogleBusiness: (returnTo = "close") => post(`${base}/social/google_business/connect`, {
+      return_to: returnTo
+    }),
+    /** Your Google Business profiles here (name, address, website), and the one this website posts to. */
+    googleBusinessLocations: () => api2.request(`${base}/social/google_business/locations`),
+    chooseGoogleBusinessLocation: (connectionId) => put(
+      `${base}/social/google_business/location`,
+      { connection_id: connectionId }
+    ),
+    disconnectGoogleBusiness: (connectionId) => api2.request(`${base}/social/google_business/${connectionId}`, { method: "DELETE" }),
     /** One channel's own pause switch (pauseSocial / resumeSocial hold every channel). */
     setChannelPaused: (channel, paused) => post(`${base}/social/channels/${channel}/${paused ? "pause" : "resume"}`),
     /** How often one channel posts. */
@@ -7683,14 +7716,56 @@ function domainApi(api2, domain) {
     ),
     /** Start a new picture for the post in the background (one AI generation); `replace` stops the one
      * already running; `instruction` (up to 300 characters) steers it: "gold border, our logo". */
+    // `mode: "edit"` changes the post's current picture as `instruction` says. Another picture
+    // being made here: this one waits its turn (status queued).
+    // `count: 4` makes a set of 4 pictures from one storyboard (one AI generation), with words on each in
+    // `textEffect` (an id from socialTextEffects; omit = Maggie picks).
     regenerateSocialImage: (id, opts = {}) => post(`${base}/social/${id}/image/regenerate`, {
+      ...opts.style ? { style: opts.style } : {},
       ...opts.replace ? { replace: true } : {},
+      ...opts.instruction?.trim() ? { instruction: opts.instruction.trim() } : {},
+      ...opts.mode === "edit" ? { mode: "edit" } : {},
+      ...opts.count && opts.count > 1 ? { count: opts.count } : {},
+      ...opts.textEffect ? { text_effect: opts.textEffect } : {}
+    }),
+    /** Change a picture Maggie made without a new one (free): the words on each picture, its style, its text
+     *  style, the order of a set, or drop pictures from it. `words` follow the new order when `order` is given. */
+    editSocialPicture: (id, changes) => api2.request(`${base}/social/${id}/picture`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(changes)
+    }),
+    /** A title and a line on your own photo(s) in your look (Maggie plans the words; no AI picture, free). */
+    wordsOnPhoto: (id, style = "real_photo") => post(`${base}/social/${id}/picture/words`, { style }),
+    /** The brand's picture look (made the first time it's asked for). */
+    socialLook: () => api2.request(`${base}/social/look`),
+    updateSocialLook: (changes) => put(`${base}/social/look`, changes),
+    /** Maggie looks again and suggests a new look (one AI generation). */
+    suggestSocialLook: () => post(`${base}/social/look/suggest`, {}),
+    /** A sample picture of a style in the brand's look: a data: URL. */
+    socialLookSample: (style) => api2.request(`${base}/social/look/sample?style=${encodeURIComponent(style)}`),
+    /** The text effects for the words on a set of pictures, each with a sample picture. */
+    socialTextEffects: () => api2.request(`${base}/social/text-effects`),
+    /** Your own photo (base64 JPEG) as the post's picture: no AI, no charge; only before it goes out.
+     *  With `instruction`, Maggie changes the photo as it says, in the background (one AI generation). */
+    uploadSocialPhoto: (id, photo, opts = {}) => post(`${base}/social/${id}/image`, {
+      photo,
       ...opts.instruction?.trim() ? { instruction: opts.instruction.trim() } : {}
     }),
-    /** Your own photo (base64 JPEG) as the post's picture: no AI, no charge; only before it goes out. */
-    uploadSocialPhoto: (id, photo) => post(`${base}/social/${id}/image`, { photo }),
-    /** Stop the picture being made (it's thrown away). */
-    stopSocialImage: () => api2.request(`${base}/social/image-job`, { method: "DELETE" }),
+    /** A new picture for every post here without one (or these), one after another in the background. */
+    fillSocialImages: (opts = {}) => post(
+      `${base}/social/images/fill`,
+      {
+        ...opts.item_ids ? { item_ids: opts.item_ids } : {},
+        ...opts.instruction?.trim() ? { instruction: opts.instruction.trim() } : {},
+        ...opts.count && opts.count > 1 ? { count: opts.count } : {},
+        ...opts.textEffect ? { text_effect: opts.textEffect } : {}
+      }
+    ),
+    /** Stop the picture being made (it's thrown away; the next in line starts). `all` empties the line too. */
+    stopSocialImage: (all = false) => api2.request(`${base}/social/image-job${all ? "?all=true" : ""}`, {
+      method: "DELETE"
+    }),
     /** Maggie changes the post as asked, in 3-255 characters (one AI generation). */
     rewriteSocial: (id, instruction) => post(`${base}/social/${id}/rewrite`, { instruction }),
     /** Maggie plans and writes a series; it waits for one OK. */
@@ -7703,13 +7778,35 @@ function domainApi(api2, domain) {
       brief: brief2,
       ...channels ? { channels } : {}
     }),
+    // In the background: the answer is the job at once; watch `write_jobs` in GET /social.
+    startSocialFromPhotos: (photos, brief2 = "", channels) => post(`${base}/social/from-photos`, {
+      photos,
+      brief: brief2,
+      background: true,
+      ...channels ? { channels } : {}
+    }),
+    startSocialFromPost: (sourcePostId, channels) => post(`${base}/social/from-post`, {
+      source_post_id: sourcePostId,
+      background: true,
+      ...channels ? { channels } : {}
+    }),
+    startSocialPlan: (days, timezone, channels) => post(`${base}/social/plan`, {
+      days,
+      timezone,
+      background: true,
+      ...channels ? { channels } : {}
+    }),
+    startWriteSocialIdea: (id, channels) => post(`${base}/social/ideas/${id}/write`, {
+      background: true,
+      ...channels ? { channels } : {}
+    }),
     /** Disconnect the website's LinkedIn account. */
     disconnectLinkedIn: (connectionId) => api2.request(`${base}/social/linkedin/${connectionId}`, { method: "DELETE" }),
     /** Published articles a LinkedIn post can be made from. */
     socialSources: (search = "") => api2.request(
       `${base}/social/sources?search=${encodeURIComponent(search)}`
     ),
-    /** Maggie writes a LinkedIn draft about one article. */
+    /** Maggie writes a post about one article for each channel; `failed` lists a channel that could not be written while the others were. */
     socialFromPost: (sourcePostId, channels) => post(`${base}/social/from-post`, {
       source_post_id: sourcePostId,
       ...channels ? { channels } : {}
@@ -7768,6 +7865,12 @@ function domainApi(api2, domain) {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ publish_mode: mode })
     }),
+    /** A Google Business post's button (LEARN_MORE, BOOK, ORDER, SHOP, SIGN_UP, CALL); "" = Learn more. */
+    setSocialButton: (id, ctaType) => api2.request(`${base}/social/${id}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ cta_type: ctaType })
+    }),
     resumeSocial: () => post(`${base}/social/resume`),
     pauseAutopilot: () => post(`${base}/autopilot/pause`),
     resumeAutopilot: () => post(`${base}/autopilot/resume`),
@@ -7775,6 +7878,9 @@ function domainApi(api2, domain) {
     visibility: () => api2.request(`${base}/visibility`),
     searchConsole: (period2 = "30d") => api2.request(`${base}/search-console?period=${period2}`),
     searchConsoleQueries: (period2 = "30d", filter = "top", limit = 20) => api2.request(`${base}/search-console/queries?period=${period2}&filter=${filter}&limit=${limit}`),
+    /** A Google sign-in link that connects Search Console for this website (open it in a
+     *  browser; back at returnTo with ?gsc=connected or ?gsc=error&message=…). 10 minutes. */
+    connectSearchConsole: (returnTo = "close") => post(`${base}/search-console/connect`, { return_to: returnTo }),
     /** Fresh numbers from Google now; at most once an hour per website. */
     syncSearchConsole: () => post(`${base}/search-console/sync`),
     contentPerformance: (sort = "clicks", band, limit = 20) => api2.request(
@@ -9719,7 +9825,7 @@ var brief = (m) => ({
 var memoryTools = [
   tool({
     name: "memory_get",
-    description: "The user's Maggie Memory on this website: their saved taste per channel (general, blog, linkedin, facebook) as prefer / always / never items, each with an id. Already in your instructions when it is on; read it to answer what you remember or to find an id to forget.",
+    description: "The user's Maggie Memory on this website: their saved taste per channel (general, blog, linkedin, facebook, instagram, google_business) as prefer / always / never items, each with an id. Already in your instructions when it is on; read it to answer what you remember or to find an id to forget.",
     parameters: none,
     group: "memory",
     need: own,
@@ -10017,9 +10123,21 @@ var reportTools = [
       };
     }
   }),
+  tool({
+    name: "gsc_connect_link",
+    description: "A Google sign-in link for the user to connect Google Search Console for this website (or reconnect). Give them the link to open; never ask for their Google password. They must sign in with a Google account that can see this website in Search Console; if it can't, the page says which account and how to add it.",
+    parameters: none,
+    group: "reports",
+    need: { resource: "autopilot", level: "write" },
+    risk: "W1",
+    run: async (ctx) => {
+      const out = await ws(ctx).connectSearchConsole("close");
+      return { url: out.url, expires_in_seconds: out.expires_in_seconds };
+    }
+  }),
   tool({
     name: "gsc_performance_get",
-    description: "Google Search Console for the period (30d, 90d or 12m): clicks, impressions, CTR and average position, with the change against the period before, the daily trend and the top pages.",
+    description: "Google Search Console for the period (30d, 90d or 12m): clicks, impressions, CTR and average position, with the change against the period before (clicks and impressions as a ratio: -0.25 = 25% fewer, null when there was nothing before; ctr in points as a fraction; position in places, lower is better), the daily trend and the top pages.",
     parameters: { type: "object", properties: { period: { type: "string", enum: periods } } },
     group: "reports",
     need: read4,
@@ -10186,7 +10304,7 @@ var reportTools = [
 var read5 = { resource: "autopilot", level: "read" };
 var write5 = { resource: "autopilot", level: "write" };
 var moves2 = ["up", "down", "top"];
-var CHANNEL_KEYS = ["linkedin", "facebook"];
+var CHANNEL_KEYS = ["linkedin", "facebook", "instagram", "google_business"];
 var channelsParam = {
   type: "array",
   items: { type: "string", enum: CHANNEL_KEYS },
@@ -10196,6 +10314,13 @@ 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;
 };
+var writing = (job) => ({
+  job_id: job.id,
+  status: "writing",
+  posts_expected: job.expected,
+  channels: job.channels,
+  note: "Maggie is writing in the background (a minute or two). Tell the user they'll be told when it's ready; social_write_status says when it's done."
+});
 var item = (i) => ({
   id: i.id,
   channel: i.provider || "linkedin",
@@ -10314,7 +10439,7 @@ var socialTools = [
   }),
   tool({
     name: "social_image_new",
-    description: "Make a new picture for a LinkedIn post that hasn't gone out (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: if another is being made this fails with image_busy; only pass replace: true when the user agrees to stop that one. 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.",
+    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.",
     parameters: {
       type: "object",
       properties: {
@@ -10323,6 +10448,23 @@ var socialTools = [
         instruction: {
           type: "string",
           description: "What the user wants in the picture, in their words (up to 300 characters), e.g. 'gold border, our logo, Future 100 \xB7 2025'. Leave out when they gave no direction."
+        },
+        mode: {
+          type: "string",
+          enum: ["new", "edit"],
+          description: "edit: change the post's current picture as the instruction says (it must have one)"
+        },
+        count: {
+          type: "integer",
+          description: "1 (default) or 4: a set of 4 pictures telling one story, a line of words on each"
+        },
+        text_effect: {
+          type: "string",
+          description: "For a set: the words' style id from social_text_effects (omit = Maggie picks)"
+        },
+        style: {
+          type: "string",
+          description: "Picture style id from social_look (omit = Maggie picks from the brand's 3)"
         }
       },
       required: ["id"]
@@ -10331,36 +10473,253 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "CR"],
-    run: async (ctx, { id, replace, instruction }) => {
+    run: async (ctx, { id, replace, instruction, mode, count, text_effect, style }) => {
       const out = await ws(ctx).regenerateSocialImage(Number(id), {
         replace: replace === true,
+        ...typeof style === "string" && style.trim() && mode !== "edit" ? { style: style.trim() } : {},
+        ...mode === "edit" ? { mode: "edit" } : {},
+        ...Number(count) === 4 && mode !== "edit" ? { count: 4 } : {},
+        ...typeof text_effect === "string" && text_effect.trim() ? { textEffect: text_effect.trim() } : {},
         ...typeof instruction === "string" && instruction.trim() ? { instruction: instruction.trim().slice(0, 300) } : {}
       });
       return {
         id: out.id,
         image_job: out.image_job,
-        note: "Making it in the background; it shows on the post when ready."
+        note: out.image_job?.status === "queued" ? "In line after the picture being made now; it shows on the post when ready." : "Making it in the background; it shows on the post when ready."
+      };
+    }
+  }),
+  tool({
+    name: "social_images_fill",
+    description: "A new picture for every social post here that hasn't gone out and has none (or only these ids), made one after another in the background: 1 AI generation each. A LinkedIn and a Facebook post of the same idea share one picture. Says how many are in line, how many already were, and why it stopped early (the line is full, or the day's AI generations ran out). Preview the count first.",
+    parameters: {
+      type: "object",
+      properties: {
+        ids: { type: "array", items: { type: "integer" }, description: "Only these posts (from social_list)" },
+        instruction: { type: "string", description: "What the user wants in every picture, up to 300 characters" }
+      }
+    },
+    group: "social",
+    need: write5,
+    risk: "W2",
+    gates: ["VER", "CR"],
+    run: async (ctx, { ids: ids3, instruction }) => {
+      const out = await ws(ctx).fillSocialImages({
+        ...Array.isArray(ids3) && ids3.length ? { item_ids: ids3.map(Number) } : {},
+        ...typeof instruction === "string" && instruction.trim() ? { instruction: instruction.trim().slice(0, 300) } : {}
+      });
+      return { queued: out.queued, already: out.skipped, stopped_because: out.message, line: out.image_jobs.length };
+    }
+  }),
+  tool({
+    name: "social_text_effects",
+    description: "The styles for the words on a set of pictures (social_image_new with count 4): id, name, family and a sample picture URL. Use when the user wants to choose how the words look ('bold sticker', 'neon', 'gold').",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => {
+      const out = await ws(ctx).socialTextEffects();
+      return { effects: out.effects.map(({ id, name, family }) => ({ id, name, family })), auto: out.auto };
+    }
+  }),
+  tool({
+    name: "social_look",
+    description: "The brand's picture look on this website (made the first time it's asked for): the 3 picture styles Maggie takes turns with, the 5 text styles she picks from per picture, two fonts, the colours (ink, paper, primary, accent, muted), a short description of how its photos look, and things never to show; plus every style, font and text style that can be chosen. Read it before changing the look or when the user asks how their pictures look.",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => {
+      const l = await ws(ctx).socialLook();
+      return {
+        styles: l.styles.map((s) => ({ id: s.id, name: s.name, about: s.about })),
+        text_effects: l.text_effects.map((e) => ({ id: e.id, name: e.name, family: e.family })),
+        fonts: l.fonts,
+        colours: l.colours,
+        description: l.brand_suffix,
+        never: l.never,
+        why: l.suggested.reason ?? null,
+        can_choose: {
+          styles: l.catalogue.styles.map((s) => ({ id: s.id, name: s.name, led: s.led, needs_photo: s.needs_photo })),
+          fonts: l.catalogue.fonts,
+          text_effect_families: [...new Set(l.catalogue.text_effects.map((e) => e.family))]
+        }
       };
     }
   }),
+  tool({
+    name: "social_look_update",
+    description: "Change the brand's picture look: the 3 styles Maggie takes turns with (style_ids, 1-3), the text styles (text_effect_ids, 1-5, ids from social_text_effects), fonts, colours (hex), the description of how photos look, things never to show, or reset: true (back to Maggie's suggestion). New pictures use it; pictures already made keep theirs (social_picture_edit changes one). Preview the change first.",
+    parameters: {
+      type: "object",
+      properties: {
+        style_ids: { type: "array", items: { type: "string" }, description: "1-3 picture style ids" },
+        text_effect_ids: { type: "array", items: { type: "string" }, description: "1-5 text style ids" },
+        font_display: { type: "string", description: "Font for big words (from social_look can_choose.fonts)" },
+        font_body: { type: "string", description: "Font for lines and lists" },
+        colours: {
+          type: "object",
+          description: "Any of these as #RRGGBB",
+          properties: {
+            ink: { type: "string", description: "Text on paper" },
+            paper: { type: "string", description: "The light ground" },
+            primary: { type: "string", description: "The brand colour" },
+            accent: { type: "string", description: "A second colour" },
+            muted: { type: "string", description: "Small text" }
+          }
+        },
+        description: { type: "string", description: "How the brand's photos look, up to 600 characters" },
+        never: { type: "array", items: { type: "string" }, description: "Things never to show (the whole list)" },
+        reset: { type: "boolean", description: "Back to Maggie's suggested look" }
+      }
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, a) => {
+      const fonts = {
+        ...a.font_display ? { display: a.font_display } : {},
+        ...a.font_body ? { body: a.font_body } : {}
+      };
+      const l = await ws(ctx).updateSocialLook({
+        ...a.style_ids ? { style_ids: a.style_ids } : {},
+        ...a.text_effect_ids ? { text_effect_ids: a.text_effect_ids } : {},
+        ...Object.keys(fonts).length ? { fonts } : {},
+        ...a.colours ? { colours: a.colours } : {},
+        ...typeof a.description === "string" ? { brand_suffix: a.description } : {},
+        ...a.never ? { never: a.never } : {},
+        ...a.reset ? { reset: true } : {}
+      });
+      return {
+        styles: l.styles.map((s) => s.id),
+        text_effects: l.text_effects.map((e) => e.id),
+        fonts: l.fonts,
+        colours: l.colours
+      };
+    }
+  }),
+  tool({
+    name: "social_picture_edit",
+    description: "Change a picture Maggie made for a post that hasn't gone out, without making a new one (free, a few seconds): the words on each picture (title up to 60 characters, line up to 90), its picture style, its text style, or for a set the order (indexes, 0 = first) or pictures to drop. Only posts whose picture says editable in social_list; a photo style needs the picture's photos (has_photos). Changing the words of one picture: send every picture's words in order. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The post (from social_list)" },
+        words: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: { headline: { type: "string" }, sub: { type: "string" } },
+            required: ["headline"]
+          },
+          description: "The words on each picture, in order (in the new order when order is given)"
+        },
+        style: { type: "string", description: "A picture style id from social_look" },
+        text_effect: { type: "string", description: "A text style id from social_text_effects" },
+        order: { type: "array", items: { type: "integer" }, description: "The pictures in their new order" },
+        remove: { type: "array", items: { type: "integer" }, description: "Pictures to drop from a set" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, words, style, text_effect, order, remove: remove2 }) => {
+      const out = await ws(ctx).editSocialPicture(Number(id), {
+        ...Array.isArray(words) ? { words: words.map((w) => ({ headline: String(w.headline ?? ""), sub: String(w.sub ?? "") })) } : {},
+        ...style ? { style } : {},
+        ...text_effect ? { text_effect } : {},
+        ...Array.isArray(order) ? { order: order.map(Number) } : {},
+        ...Array.isArray(remove2) ? { remove: remove2.map(Number) } : {}
+      });
+      return { id: out.id, pictures: out.image_urls?.length ? out.image_urls : [out.image_url], picture: out.picture };
+    }
+  }),
+  tool({
+    name: "social_photo_words",
+    description: "Put a title and a line on the user's own photo(s) on a post, in the brand's look: Maggie writes the words from the post (no AI picture, free). Only for a post whose picture is the user's own photo (own_photo in social_list). style: real_photo (default, the photo framed with the words below), product_hero (the words on a card), or another photo style. Then social_picture_edit changes the words. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "The post (from social_list)" },
+        style: {
+          type: "string",
+          description: "real_photo (default), product_hero, photo_headline, editorial, duotone"
+        }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, style }) => {
+      const out = await ws(ctx).wordsOnPhoto(Number(id), style || "real_photo");
+      return { id: out.id, picture: out.picture, pictures: out.image_urls?.length ? out.image_urls : [out.image_url] };
+    }
+  }),
+  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).",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A posted Instagram post (from social_list posted)" },
+        refresh: { type: "boolean", description: "Read the numbers again now" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx, { id, refresh }) => ws(ctx).socialInsights(Number(id), refresh === true)
+  }),
+  tool({
+    name: "social_write_status",
+    description: "Posts Maggie is writing in the background for this user on this website (from social_from_article, social_plan_days, social_idea_write or the app), and the ones finished in the last 10 minutes: running, done (the new post ids) or failed (why), and any channel that couldn't be written. Look once when the user asks, not in a loop.",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => ({
+      jobs: ((await ws(ctx).social()).write_jobs ?? []).map((j) => ({
+        id: j.id,
+        kind: j.kind,
+        status: j.status,
+        channels: j.channels,
+        expected: j.expected,
+        written: j.item_ids,
+        queued: j.queued,
+        ...j.failed?.length ? { failed: j.failed } : {},
+        ...j.error ? { error: j.error } : {},
+        started_at: j.started_at
+      }))
+    })
+  }),
   tool({
     name: "social_image_status",
-    description: "Whether a new LinkedIn picture is being made on this website (which post, since when), or how the last one ended (done, failed with why, stopped) and who drew it (chatgpt or gemini).",
+    description: "The picture being made on this website and those waiting in line (which post, new or edit), or how the last one ended (done, failed with why, stopped) and who drew it (chatgpt or gemini).",
     parameters: none,
     group: "social",
     need: read5,
     risk: "R0",
-    run: async (ctx) => ({ image_job: (await ws(ctx).social()).image_job ?? null })
+    run: async (ctx) => {
+      const s = await ws(ctx).social();
+      return { image_job: s.image_job ?? null, line: s.image_jobs ?? [] };
+    }
   }),
   tool({
     name: "social_image_stop",
-    description: "Stop the LinkedIn picture being made on this website; the post keeps the picture it had.",
-    parameters: none,
+    description: "Stop the picture being made on this website (the post keeps the picture it had; the next in line starts). all: true also empties the line.",
+    parameters: { type: "object", properties: { all: { type: "boolean" } } },
     group: "social",
     need: write5,
     risk: "W1",
     gates: ["VER"],
-    run: async (ctx) => ws(ctx).stopSocialImage()
+    run: async (ctx, { all }) => ws(ctx).stopSocialImage(all === true)
   }),
   tool({
     name: "social_move",
@@ -10404,7 +10763,7 @@ 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).",
+    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).",
     parameters: {
       type: "object",
       properties: {
@@ -10418,14 +10777,11 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "LLM"],
-    run: async (ctx, { source_id, channels }) => {
-      const out = await ws(ctx).socialFromPost(String(source_id), channelsOf(channels));
-      return { id: out.id, status: out.status, queued: Boolean(out.queued), text: clip(out.social_copy, 300) };
-    }
+    run: async (ctx, { source_id, channels }) => writing((await ws(ctx).startSocialFromPost(String(source_id), channelsOf(channels))).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).",
+    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).",
     parameters: {
       type: "object",
       properties: {
@@ -10439,10 +10795,7 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "LLM"],
-    run: async (ctx, { days, timezone, channels }) => {
-      const out = await ws(ctx).socialPlan(int(days, 1, 7, 3), timezone || "UTC", channelsOf(channels));
-      return { written: out.items.length, queued: Boolean(out.queued), items: out.items.map(item) };
-    }
+    run: async (ctx, { days, timezone, channels }) => writing((await ws(ctx).startSocialPlan(int(days, 1, 7, 3), timezone || "UTC", channelsOf(channels))).job)
   }),
   tool({
     name: "social_ideas_list",
@@ -10515,7 +10868,7 @@ 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.",
+    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).",
     parameters: {
       type: "object",
       properties: {
@@ -10529,7 +10882,7 @@ var socialTools = [
     need: write5,
     risk: "W2",
     gates: ["VER", "LI", "CR", "LLM"],
-    run: async (ctx, { id, channels }) => ws(ctx).writeSocialIdea(Number(id), void 0, channelsOf(channels))
+    run: async (ctx, { id, channels }) => writing((await ws(ctx).startWriteSocialIdea(Number(id), channelsOf(channels))).job)
   }),
   tool({
     name: "social_idea_brief",
@@ -10826,9 +11179,9 @@ var socialTools = [
     run: async (ctx, { keys: keys3, ...options }) => {
       const api2 = ws(ctx);
       const current = (await api2.socialSetup()).writing;
-      const writing = { ...current };
-      for (const [k, v] of Object.entries(options)) if (v !== void 0) writing[k] = v;
-      return api2.socialSetupTemplates((keys3 ?? []).slice(0, 10), writing);
+      const writing2 = { ...current };
+      for (const [k, v] of Object.entries(options)) if (v !== void 0) writing2[k] = v;
+      return api2.socialSetupTemplates((keys3 ?? []).slice(0, 10), writing2);
     }
   }),
   tool({
@@ -10909,6 +11262,52 @@ var socialTools = [
       const out = await ws(ctx).connectFacebook("close");
       return { url: out.url, expires_in_seconds: out.expires_in_seconds };
     }
+  }),
+  tool({
+    name: "google_business_connect_link",
+    description: "A link for the user to connect their Google Business Profile (or reconnect): they sign in with the Google account that manages the profile; every profile it can post to is saved and the one whose website is this site is picked (else they pick it in the app). Only verified profiles can post. Give them the link to open; never ask for a password. Google posts are short local updates with one photo and a button; Google checks each one before it shows.",
+    parameters: none,
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx) => {
+      const out = await ws(ctx).connectGoogleBusiness("close");
+      return { url: out.url, expires_in_seconds: out.expires_in_seconds };
+    }
+  }),
+  tool({
+    name: "social_google_button",
+    description: "Set the button on a Google Business post that hasn't gone out: LEARN_MORE (default, opens the post's link), BOOK (a booking link), ORDER, SHOP, SIGN_UP, or CALL (calls the profile's phone number; needs no link). Pick the one that matches what the post asks people to do. Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A Google Business post (from social_list)" },
+        button: { type: "string", enum: ["LEARN_MORE", "BOOK", "ORDER", "SHOP", "SIGN_UP", "CALL"] }
+      },
+      required: ["id", "button"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, button }) => {
+      const out = await ws(ctx).setSocialButton(Number(id), button);
+      return { id: out.id, button: out.cta_type ?? "LEARN_MORE", link: out.cta_url ?? null };
+    }
+  }),
+  tool({
+    name: "instagram_connect_link",
+    description: "A link for the user to connect Instagram (or reconnect). Instagram connects through the Facebook sign-in: only an Instagram professional account (Business or Creator) linked to one of their Facebook Pages can be posted to, so tell them that first. Give them the link to open; never ask for a password. Every Instagram post goes out with its picture (no links in it).",
+    parameters: none,
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx) => {
+      const out = await ws(ctx).connectInstagram("close");
+      return { url: out.url, expires_in_seconds: out.expires_in_seconds };
+    }
   })
 ];
 
@@ -14454,7 +14853,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.2.0",
+  version: "0.3.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",
@@ -22596,9 +22995,10 @@ posts.command("ls", { isDefault: true }).description("planned, draft or publishe
 posts.command("show <id>").description("one post in full").action(act(async (opts, id) => tool2(opts, "post_get", { id })));
 posts.command("publish <id>").description("publish a draft now (uses a post credit)").action(act(async (opts, id) => tool2(opts, "post_publish_now", { id })));
 posts.command("delete <id>").description("delete a draft").action(act(async (opts, id) => tool2(opts, "draft_delete", { id })));
-var social = program2.command("social").description("your social posts: LinkedIn and your Facebook Page");
+var social = program2.command("social").description("your social posts: LinkedIn, your Facebook Page, Instagram and your Google Business Profile");
+var CHANNELS = ["linkedin", "facebook", "instagram", "google_business"];
 var channelsOpt = (value) => {
-  const list2 = (value ?? "").split(",").map((v) => v.trim().toLowerCase()).filter((v) => v === "linkedin" || v === "facebook");
+  const list2 = (value ?? "").split(",").map((v) => v.trim().toLowerCase()).map((v) => v === "google" || v === "gbp" ? "google_business" : v).filter((v) => CHANNELS.includes(v));
   return list2.length ? list2 : void 0;
 };
 social.command("ls", { isDefault: true }).description("drafts to review and queued posts").action(
@@ -22606,7 +23006,7 @@ social.command("ls", { isDefault: true }).description("drafts to review and queu
     async (opts) => tool2(opts, "social_list", {}, (v) => {
       const s = v;
       const live = (s.channels ?? []).filter((c) => c.connected);
-      const head = !s.connected ? "No social channel is connected (LinkedIn or a Facebook Page)." : s.posting_paused ? "Posting is paused on every channel." : live.length ? live.map((c) => `${c.channel}: ${c.paused ? "paused" : "on"}${c.account ? ` (${c.account})` : ""}`).join(" \xB7 ") : "Posting is on.";
+      const head = !s.connected ? "No social channel is connected (LinkedIn, a Facebook Page, Instagram or a Google Business Profile)." : s.posting_paused ? "Posting is paused on every channel." : live.length ? live.map((c) => `${c.channel}: ${c.paused ? "paused" : "on"}${c.account ? ` (${c.account})` : ""}`).join(" \xB7 ") : "Posting is on.";
       return `${head}
 ${table(s.queue ?? [], ["id", "channel", "status", "eta", "text"])}`;
     })
@@ -22615,7 +23015,7 @@ ${table(s.queue ?? [], ["id", "channel", "status", "eta", "text"])}`;
 social.command("approve <ids...>").description("approve drafts: they go out at the next posting times").action(act(async (opts, list2) => tool2(opts, "social_approve", { ids: ids2(list2) })));
 social.command("skip <id>").description("skip a draft").action(act(async (opts, id) => tool2(opts, "social_skip", { id: ids2([id])[0] })));
 social.command("restore <id>").description("bring a skipped draft back").action(act(async (opts, id) => tool2(opts, "social_restore", { id: ids2([id])[0] })));
-social.command("draft <topic...>").description("add a post idea for Maggie to write (every connected channel unless --channel)").option("--summary <text>", "what the post should say").option("--channel <names>", "linkedin, facebook or both (comma-separated)").action(
+social.command("draft <topic...>").description("add a post idea for Maggie to write (every connected channel unless --channel)").option("--summary <text>", "what the post should say").option("--channel <names>", "linkedin, facebook, instagram, google_business (comma-separated)").action(
   act(
     async (opts, topic) => tool2(opts, "social_idea_add", {
       title: topic.join(" "),
@@ -22628,7 +23028,7 @@ for (const [cmd, paused] of [
   ["pause", true],
   ["resume", false]
 ])
-  social.command(cmd).description(`${cmd} posting (every channel, or --channel linkedin | facebook)`).option("--channel <name>", "only this channel").action(
+  social.command(cmd).description(`${cmd} posting (every channel, or --channel linkedin | facebook | instagram | google_business)`).option("--channel <name>", "only this channel").action(
     act(
       async (opts) => tool2(opts, "social_set_paused", {
         paused,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/cli",
-	"version": "0.2.0",
+	"version": "0.3.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",