@cmo-so/cli 0.4.0 → 0.5.0

package/dist/cmo.mjs

@@ -7480,7 +7480,8 @@ var MEMORY_CHANNELS = [
   "facebook",
   "instagram",
   "google_business",
-  "youtube"
+  "youtube",
+  "tiktok"
 ];
 function addWebsite(api2, url) {
   return api2.request("/v1/domains", {
@@ -7732,6 +7733,20 @@ function domainApi(api2, domain) {
     ),
     /** Disconnect: the token is deleted and Google's access revoked (YouTube's policy). */
     disconnectYouTube: (connectionId) => api2.request(`${base}/social/youtube/${connectionId}`, { method: "DELETE" }),
+    /** A TikTok sign-in link for this website (docs/prd/tiktok.md §7); back with ?tiktok=connected (error&message=…). */
+    connectTikTok: (returnTo = "close") => post(`${base}/social/tiktok/connect`, { return_to: returnTo }),
+    /** What the TikTok account allows right now: show it in the TikTok post editor (TikTok's guidelines). */
+    tiktokCreator: () => api2.request(`${base}/social/tiktok/creator`),
+    /** Disconnect: TikTok's access is revoked and the token deleted. */
+    disconnectTikTok: (connectionId) => api2.request(`${base}/social/tiktok/${connectionId}`, { method: "DELETE" }),
+    /** A TikTok post's settings: who can view it, comments / Duet / Stitch, content disclosure, AI label. */
+    setSocialTikTok: (id, answers) => api2.request(`${base}/social/${id}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ tiktok: answers })
+    }),
+    /** Ask to join the beta of these channels: an email says what we need (reply or WhatsApp); the team is told. */
+    requestBeta: (req) => post(`${base}/social/beta-request`, req),
     /** 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. */
@@ -7914,7 +7929,8 @@ function domainApi(api2, domain) {
     video: (videoId) => api2.request(`${base}/social/video/${videoId}`),
     /** Another part or framing; prepared again in the background. */
     editVideo: (videoId, edit) => post(`${base}/social/video/${videoId}/edit`, { edit }),
-    /** A YouTube post from a ready video, waiting in Review; Maggie writes the details unless write is false. */
+    /** A post on one video channel (YouTube by default, or TikTok) from a ready video, waiting in Review; Maggie
+     *  writes the details (YouTube) or the caption (TikTok) unless write is false. */
     postFromVideo: (videoId, opts = {}) => post(`${base}/social/video/${videoId}/post`, opts),
     youtubeSettings: () => api2.request(`${base}/social/youtube/settings`),
     setYouTubeSettings: (s) => put(`${base}/social/youtube/settings`, s),
@@ -8163,6 +8179,9 @@ var list = (xs, n = 5) => {
 };
 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(
+  (c) => c === "tiktok" ? "TikTok" : "YouTube"
+);
 var confirmCopy = {
   // --------------------------------------------------------- account / setup
   website_add: {
@@ -8348,9 +8367,23 @@ var confirmCopy = {
     en: () => "Make a link to connect your YouTube channel.",
     "zh-Hant": () => "\u7522\u751F\u9023\u63A5\u4F60 YouTube \u983B\u9053\u7684\u9023\u7D50\u3002"
   },
+  tiktok_connect_link: {
+    en: () => "Make a link to connect your TikTok account.",
+    "zh-Hant": () => "\u7522\u751F\u9023\u63A5\u4F60 TikTok \u5E33\u865F\u7684\u9023\u7D50\u3002"
+  },
   social_video_add: {
-    en: (a) => `Make a YouTube post from ${a.url}${a.write === false ? "" : " (Maggie writes the title and description: one AI generation)"}; it waits for your OK.`,
-    "zh-Hant": (a) => `\u7528 ${a.url} \u505A\u4E00\u5247 YouTube \u5F71\u7247\u8CBC\u6587${a.write === false ? "" : "\uFF08Maggie \u5BEB\u6A19\u984C\u548C\u8AAA\u660E\uFF1A\u7528\u4E00\u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`
+    en: (a) => {
+      const names = videoChannels(a).join(" and ");
+      return `Make a ${names} post from ${a.url}${a.write === false ? "" : ` (Maggie writes it: one AI generation per channel)`}; it waits for your OK.`;
+    },
+    "zh-Hant": (a) => {
+      const names = videoChannels(a).join(" \u548C ");
+      return `\u7528 ${a.url} \u505A ${names} \u5F71\u7247\u8CBC\u6587${a.write === false ? "" : "\uFF08Maggie \u4F86\u5BEB\uFF1A\u6BCF\u500B\u6E20\u9053\u7528\u4E00\u6B21 AI \u751F\u6210\uFF09"}\uFF0C\u7B49\u4F60\u78BA\u8A8D\u5F8C\u624D\u767C\u3002`;
+    }
+  },
+  social_tiktok_set: {
+    en: (a) => `Set TikTok post #${a.id}: ${keys(a).filter((k) => k !== "id").map((k) => `${k} ${String(a[k])}`).join(", ") || "its settings"}.`,
+    "zh-Hant": (a) => `\u8A2D\u5B9A TikTok \u8CBC\u6587 #${a.id}\uFF1A${keys(a).filter((k) => k !== "id").map((k) => `${k} ${String(a[k])}`).join("\u3001") || "\u8A2D\u5B9A"}\u3002`
   },
   social_youtube_set: {
     en: (a) => `Change YouTube post #${a.id}: ${keys(a).filter((k) => k !== "id").join(", ") || "its details"}.`,
@@ -10373,11 +10406,13 @@ var read5 = { resource: "autopilot", level: "read" };
 var write5 = { resource: "autopilot", level: "write" };
 var moves2 = ["up", "down", "top"];
 var CHANNEL_KEYS = ["linkedin", "facebook", "instagram", "google_business"];
-var ALL_CHANNEL_KEYS = [...CHANNEL_KEYS, "youtube"];
+var ALL_CHANNEL_KEYS = [...CHANNEL_KEYS, "youtube", "tiktok"];
+var VIDEO_KEYS = ["youtube", "tiktok"];
+var TIKTOK_PRIVACY = ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY"];
 var channelsParam = {
   type: "array",
   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 takes a video: use social_video_add."
+  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 channelsOf = (value) => {
   const list2 = Array.isArray(value) ? value.map((v) => String(v).toLowerCase()).filter((v) => CHANNEL_KEYS.includes(v)) : [];
@@ -10404,6 +10439,10 @@ var item = (i) => ({
   ...i.provider === "youtube" ? {
     youtube: i.youtube ?? null,
     video: i.video ? { status: i.video.status, seconds: i.video.duration, shape: i.video.shape, error: i.video.error } : null
+  } : {},
+  ...i.provider === "tiktok" ? {
+    tiktok: i.tiktok ?? null,
+    video: i.video ? { status: i.video.status, seconds: i.video.duration, shape: i.video.shape, error: i.video.error } : null
   } : {}
 });
 var socialTools = [
@@ -11382,13 +11421,72 @@ var socialTools = [
       return { url: out.url, expires_in_seconds: out.expires_in_seconds };
     }
   }),
+  tool({
+    name: "tiktok_connect_link",
+    description: "A link for the user to connect their TikTok account (or reconnect): they sign in to TikTok and allow Maggie to see their profile and post videos. Give them the link to open; never ask for a password. TikTok is in beta (testers only; until TikTok reviews our app, videos post as 'Only me' and the account must be private). TikTok posts are short videos (5-30 seconds) that the user approves one by one.",
+    parameters: none,
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx) => {
+      const out = await ws(ctx).connectTikTok("close");
+      return { url: out.url, expires_in_seconds: out.expires_in_seconds };
+    }
+  }),
+  tool({
+    name: "tiktok_creator",
+    description: "What the user's TikTok account allows right now (TikTok asks to check before every post): its name and @username, who a video can be shown to (privacy_options), whether comments / Duet / Stitch are turned off on the account, the longest video it can post, and whether it can post now (problem). Read it before asking the user the TikTok settings of a post.",
+    parameters: none,
+    group: "social",
+    need: read5,
+    risk: "R0",
+    run: async (ctx) => ws(ctx).tiktokCreator()
+  }),
+  tool({
+    name: "social_tiktok_set",
+    description: "Set a TikTok post's settings, ONLY as the user chose them (TikTok's rules: never pick for them, nothing is preset): privacy (one of the account's privacy_options from tiktok_creator: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY), allow_comment / allow_duet / allow_stitch (off unless the user turns them on; not possible when the account turned them off), disclose (the video promotes a brand, product or service) with your_brand (their own: labelled 'Promotional content') and / or branded (a third party: labelled 'Paid partnership'; can't be SELF_ONLY), is_aigc (AI-generated content label). The caption is the post's text (social_update_copy). Before the user approves, tell them: 'By posting, you agree to TikTok's Music Usage Confirmation' (with branded content: 'TikTok's Branded Content Policy and Music Usage Confirmation'). Preview first.",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "integer", description: "A TikTok post (from social_list)" },
+        privacy: { type: "string", enum: TIKTOK_PRIVACY },
+        allow_comment: { type: "boolean" },
+        allow_duet: { type: "boolean" },
+        allow_stitch: { type: "boolean" },
+        disclose: { type: "boolean" },
+        your_brand: { type: "boolean" },
+        branded: { type: "boolean" },
+        is_aigc: { type: "boolean" }
+      },
+      required: ["id"]
+    },
+    group: "social",
+    need: write5,
+    risk: "W1",
+    gates: ["VER"],
+    run: async (ctx, { id, privacy, ...rest }) => {
+      const answers = Object.fromEntries(
+        Object.entries(rest).filter(([, v]) => v !== void 0)
+      );
+      if (privacy) answers.privacy = privacy;
+      const out = await ws(ctx).setSocialTikTok(Number(id), answers);
+      return item(out);
+    }
+  }),
   tool({
     name: "social_video_add",
-    description: "Make a YouTube post from a video: a DIRECT link to a video file (an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those; tell the user to upload the video in the app instead). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes the title, description and tags from the video and the note (one AI generation) unless write is false. The post waits in Review: YouTube posts are always approved by the user, who must also answer whether it's made for kids. Preview first.",
+    description: "Make a YouTube and / or TikTok post (channels; default youtube) from a video: a DIRECT link to a video file (an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those; tell the user to upload the video in the app instead). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes YouTube's title, description and tags, or TikTok's caption, from the video and the note (one AI generation per channel) unless write is false. Each post waits in Review: video posts are always approved by the user. YouTube asks whether it's made for kids; TikTok asks who can view it and the other TikTok settings (social_tiktok_set, as the user chooses). is_aigc: TikTok's AI-generated label, only when the user says the video was made with AI. Preview first.",
     parameters: {
       type: "object",
       properties: {
         url: { type: "string", description: "Direct https link to the video file" },
+        channels: {
+          type: "array",
+          items: { type: "string", enum: [...VIDEO_KEYS] },
+          description: "youtube, tiktok or both (one post each); default youtube"
+        },
+        is_aigc: { type: "boolean", description: "TikTok: the video is AI-generated (the user said so)" },
         note: { type: "string", description: "What the video is about, in the user's words" },
         write: { type: "boolean", description: "Let Maggie write the details (default true)" },
         start: { type: "number", description: "Start of the part to use, seconds" },
@@ -11416,11 +11514,28 @@ var socialTools = [
       }
       if (v.status !== "ready")
         return { ok: false, video: { status: v.status, error: v.error, seconds: v.source_duration } };
-      const post = await d.postFromVideo(v.id, { note: a.note ?? "", write: a.write !== false });
+      const wanted = (a.channels ?? ["youtube"]).filter(
+        (c) => VIDEO_KEYS.includes(c)
+      );
+      const posts2 = [];
+      for (const channel of wanted.length ? wanted : ["youtube"]) {
+        posts2.push(
+          await d.postFromVideo(v.id, {
+            channel,
+            note: a.note ?? "",
+            write: a.write !== false,
+            ...channel === "tiktok" && a.is_aigc != null ? { is_aigc: a.is_aigc } : {}
+          })
+        );
+      }
       return {
         ok: true,
-        post: item(post),
-        next: "Show the title and description; ask whether it's made for kids and which visibility, then social_youtube_set; the user approves it."
+        ...posts2.length === 1 ? { post: item(posts2[0]) } : { posts: posts2.map(item) },
+        next: [
+          posts2.some((p) => p.provider === "youtube") ? "YouTube: show the title and description; ask whether it's made for kids and which visibility, then social_youtube_set." : "",
+          posts2.some((p) => p.provider === "tiktok") ? "TikTok: show the caption; read tiktok_creator and ask who can view it, whether to allow comments / Duet / Stitch and whether it promotes a brand, then social_tiktok_set exactly as they say; tell them the Music Usage Confirmation line." : "",
+          "The user approves each post."
+        ].filter(Boolean).join(" ")
       };
     }
   }),
@@ -15094,7 +15209,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.4.0",
+  version: "0.5.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",
@@ -23236,10 +23351,14 @@ 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, your Facebook Page, Instagram, your Google Business Profile and YouTube");
-var CHANNELS = ["linkedin", "facebook", "instagram", "google_business", "youtube"];
+var social = program2.command("social").description(
+  "your social posts: LinkedIn, your Facebook Page, Instagram, your Google Business Profile, YouTube and TikTok"
+);
+var CHANNELS = ["linkedin", "facebook", "instagram", "google_business", "youtube", "tiktok"];
 var channelsOpt = (value) => {
-  const list2 = (value ?? "").split(",").map((v) => v.trim().toLowerCase()).map((v) => v === "google" || v === "gbp" ? "google_business" : v === "yt" || v === "shorts" ? "youtube" : v).filter((v) => CHANNELS.includes(v));
+  const list2 = (value ?? "").split(",").map((v) => v.trim().toLowerCase()).map(
+    (v) => v === "google" || v === "gbp" ? "google_business" : v === "yt" || v === "shorts" ? "youtube" : v === "tt" ? "tiktok" : 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(
@@ -23270,7 +23389,7 @@ for (const [cmd, paused] of [
   ["resume", false]
 ])
   social.command(cmd).description(
-    `${cmd} posting (every channel, or --channel linkedin | facebook | instagram | google_business | youtube)`
+    `${cmd} posting (every channel, or --channel linkedin | facebook | instagram | google_business | youtube | tiktok)`
   ).option("--channel <name>", "only this channel").action(
     act(
       async (opts) => tool2(opts, "social_set_paused", {
@@ -23308,6 +23427,49 @@ youtube.command("set <id>").description("a YouTube post's title, tags, visibilit
   )
 );
 youtube.command("settings").description("your YouTube defaults (visibility, made for kids)").action(act(async (opts) => tool2(opts, "youtube_settings")));
+var tiktok = social.command("tiktok").description("your TikTok account (beta): short videos you approve one by one");
+tiktok.command("connect").description("a link to connect your TikTok account").action(act(async (opts) => tool2(opts, "tiktok_connect_link")));
+tiktok.command("account").description("what your TikTok account allows now: who can view, comments / Duet / Stitch, longest video").action(act(async (opts) => tool2(opts, "tiktok_creator")));
+tiktok.command("add <url>").description("a TikTok post from a direct link to a video file (5-30 s): Maggie writes the caption").option("--note <text>", "what the video is about").option("--start <seconds>", "use the part from here").option("--end <seconds>", "use the part up to here").option("--vertical <where>", "make a wide video vertical: left, middle or right").option("--ai", "the video is AI-generated (TikTok labels it)").option("--no-write", "write the caption yourself").action(
+  act(
+    async (opts, url) => tool2(opts, "social_video_add", {
+      url,
+      channels: ["tiktok"],
+      ...opts.note ? { note: opts.note } : {},
+      ...opts.start ? { start: Number(opts.start) } : {},
+      ...opts.end ? { end: Number(opts.end) } : {},
+      ...opts.vertical ? { vertical: opts.vertical } : {},
+      ...opts.ai ? { is_aigc: true } : {},
+      write: opts.write !== false
+    })
+  )
+);
+tiktok.command("set <id>").description("a TikTok post's settings, as you choose them (nothing is preset)").option("--privacy <p>", "everyone, friends, followers or only-me (what your account offers)").option("--comment <yes|no>").option("--duet <yes|no>").option("--stitch <yes|no>").option("--promotes <what>", "none, your-brand, branded or both (content disclosure)").option("--ai <yes|no>", "AI-generated content label").action(
+  act(
+    async (opts, id) => {
+      const privacy = {
+        everyone: "PUBLIC_TO_EVERYONE",
+        friends: "MUTUAL_FOLLOW_FRIENDS",
+        followers: "FOLLOWER_OF_CREATOR",
+        "only-me": "SELF_ONLY"
+      }[String(opts.privacy ?? "").toLowerCase()];
+      const p = opts.promotes?.toLowerCase();
+      return tool2(opts, "social_tiktok_set", {
+        id: ids2([id])[0],
+        ...privacy ? { privacy } : {},
+        ...opts.comment ? { allow_comment: opts.comment === "yes" } : {},
+        ...opts.duet ? { allow_duet: opts.duet === "yes" } : {},
+        ...opts.stitch ? { allow_stitch: opts.stitch === "yes" } : {},
+        ...opts.ai ? { is_aigc: opts.ai === "yes" } : {},
+        ...p ? {
+          disclose: p !== "none",
+          your_brand: p === "your-brand" || p === "both",
+          branded: p === "branded" || p === "both"
+        } : {}
+      });
+    }
+  )
+);
 var autopilot = program2.command("autopilot").description("the blog autopilot");
 autopilot.command("status", { isDefault: true }).description("on or paused, posts per day, where it publishes").action(act(async (opts) => tool2(opts, "publish_settings_get")));
 for (const [cmd, paused] of [

package/package.json

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