@autoposting.ai/cli 0.5.0 → 0.5.2

package/dist/cli.cjs

@@ -132,7 +132,7 @@ var init_dist = __esm({
         );
       }
     };
-    VERSION = "0.5.0";
+    VERSION = "0.5.2";
     AutopostingError = class extends Error {
       status;
       code;
@@ -222,6 +222,14 @@ var init_dist = __esm({
       authStatus(slug) {
         return this.get(`/brands/${slug}/auth/status`);
       }
+      /** Browser session owns beta checks, official authorization and explicit Page selection. */
+      async facebookConnection(slug) {
+        const brand = await this.retrieve(slug);
+        const url = new URL("/brands", this.client.baseUrl);
+        url.searchParams.set("brand", brand.slug);
+        url.searchParams.set("platform", "facebook");
+        return { url: url.toString(), brandSlug: brand.slug, platform: "facebook" };
+      }
     };
     CarouselsResource = class extends Resource {
       /** GET /carousels — backend paginates: `{ items, total, limit, offset }`. */
@@ -373,15 +381,20 @@ var init_dist = __esm({
       publish(id) {
         return this.client.request("POST", `/posts/${id}/publish`);
       }
-      schedule(id, scheduledAt) {
-        return this.client.request("PUT", `/posts/${id}/schedule`, { scheduledAt });
+      schedule(id, scheduledAt, platform) {
+        return this.client.request("PUT", `/posts/${id}/schedule`, { scheduledAt, ...platform ? { platform } : {} });
       }
-      /** PUT /posts/:id/schedule with { cancel: true } — returns the post to draft. */
+      /** PUT /posts/:id/schedule with { cancel: true } — cancels scheduling; recovery restores the previous outcome. */
       unschedule(id) {
         return this.client.request("PUT", `/posts/${id}/schedule`, { cancel: true });
       }
-      retry(id) {
-        return this.client.request("POST", `/posts/${id}/retry`);
+      retry(id, platform) {
+        return this.client.request(
+          "POST",
+          `/posts/${id}/retry`,
+          void 0,
+          platform ? { platform } : void 0
+        );
       }
       rewrite(id) {
         return this.client.request("POST", `/posts/${id}/rewrite`);
@@ -808,7 +821,7 @@ var init_media_flags = __esm({
   "src/lib/media-flags.ts"() {
     "use strict";
     import_node_fs2 = require("fs");
-    VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube"];
+    VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube", "facebook"];
     EXT_TO_MIME = {
       jpg: "image/jpeg",
       jpeg: "image/jpeg",
@@ -823,7 +836,7 @@ var init_media_flags = __esm({
 });
 
 // src/mcp/tools.ts
-var MEDIA_ITEMS, ALL_TOOLS;
+var MEDIA_ITEMS, FACEBOOK_AUTHORING, ALL_TOOLS;
 var init_tools = __esm({
   "src/mcp/tools.ts"() {
     "use strict";
@@ -842,6 +855,20 @@ var init_tools = __esm({
         additionalProperties: false
       }
     };
+    FACEBOOK_AUTHORING = {
+      facebookOptions: { type: "object", properties: {
+        format: { type: "string", enum: ["text", "link", "photo", "multi-photo", "video", "reel"] },
+        link: { type: "string", description: "Public HTTPS article URL for link format" }
+      }, required: ["format"], additionalProperties: false },
+      targetAccountIds: {
+        type: "object",
+        description: "Explicit selected connected Page IDs, including a sole Page",
+        properties: { facebook: { type: "array", items: { type: "string" }, minItems: 1, uniqueItems: true } },
+        additionalProperties: { type: "array", items: { type: "string" } }
+      },
+      platformTexts: { type: "object", additionalProperties: { type: "string" }, description: "Platform captions; empty Facebook caption is intentional" },
+      platformMedia: { type: "object", additionalProperties: MEDIA_ITEMS, description: "Platform media; empty Facebook array excludes shared attachments" }
+    };
     ALL_TOOLS = [
       { name: "delete-account-import", description: "Delete import progress only. Connected accounts and brands remain. Ask the user before discarding their progress.", inputSchema: { type: "object", properties: { id: { type: "string", description: "Import id" } }, required: ["id"] } },
       { name: "import-accounts", description: "Import 1\u20131000 social account rows from CSV. Headers: brand_name, platform, account_url; optional brand_slug, timezone, account_type. Returns a durable import id. Repeating the same import reuses progress. No passwords or provider tokens.", inputSchema: { type: "object", properties: { csv: { type: "string", maxLength: 9e4, description: "CSV contents, including header row" } }, required: ["csv"] } },
@@ -889,14 +916,16 @@ var init_tools = __esm({
             brandSlug: { type: "string", description: "Brand slug to post under" },
             text: { type: "string", description: "Post text content" },
             platforms: {
-              type: "string",
-              description: "Comma-separated platform list (e.g. x,linkedin)"
+              type: ["string", "array"],
+              items: { type: "string" },
+              description: "Platform array or comma-separated platform list (e.g. x,linkedin)"
             },
             scheduledAt: {
               type: "string",
               description: "ISO 8601 datetime to schedule the post"
             },
-            media: MEDIA_ITEMS
+            media: MEDIA_ITEMS,
+            ...FACEBOOK_AUTHORING
           },
           required: ["brandSlug", "text", "platforms"],
           additionalProperties: false
@@ -910,9 +939,10 @@ var init_tools = __esm({
           properties: {
             id: { type: "string", description: "Post ID" },
             text: { type: "string", description: "New post text" },
-            platforms: { type: "string", description: "Comma-separated new platform list" },
+            platforms: { type: ["string", "array"], items: { type: "string" }, description: "Platform array or comma-separated new platform list" },
             scheduledAt: { type: "string", description: "New ISO 8601 scheduled datetime" },
-            media: MEDIA_ITEMS
+            media: MEDIA_ITEMS,
+            ...FACEBOOK_AUTHORING
           },
           required: ["id"],
           additionalProperties: false
@@ -949,7 +979,8 @@ var init_tools = __esm({
           type: "object",
           properties: {
             id: { type: "string", description: "Post ID to schedule" },
-            scheduledAt: { type: "string", description: "ISO 8601 datetime for publishing" }
+            scheduledAt: { type: "string", description: "ISO 8601 datetime for publishing" },
+            platform: { type: "string", enum: ["facebook"], description: "Explicit failed-Page recovery; preserves Published and Unknown outcomes" }
           },
           required: ["id", "scheduledAt"],
           additionalProperties: false
@@ -961,7 +992,8 @@ var init_tools = __esm({
         inputSchema: {
           type: "object",
           properties: {
-            id: { type: "string", description: "Post ID to retry" }
+            id: { type: "string", description: "Post ID to retry" },
+            platform: { type: "string", enum: ["x", "linkedin", "instagram", "threads", "youtube", "facebook"], description: "Optional explicit platform; facebook retries only failed Pages without remote evidence, preserving Published and Unknown outcomes." }
           },
           required: ["id"],
           additionalProperties: false
@@ -1688,6 +1720,42 @@ var init_api_routes = __esm({
 });
 
 // src/mcp/handler.ts
+function validateAuthoringIntent(args) {
+  const object = (value, field) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${field} must be an object.`);
+    return value;
+  };
+  if (args.facebookOptions !== void 0) {
+    const options = object(args.facebookOptions, "facebookOptions");
+    if (!["text", "link", "photo", "multi-photo", "video", "reel"].includes(options.format)) {
+      throw new Error("facebookOptions.format must be a supported Facebook format.");
+    }
+    if (options.link !== void 0 && typeof options.link !== "string") throw new Error("facebookOptions.link must be a string.");
+    if (Object.keys(options).some((key) => !["format", "link"].includes(key))) throw new Error("Unknown facebookOptions field.");
+  }
+  for (const field of ["targetAccountIds", "platformTexts", "platformMedia"]) {
+    if (args[field] === void 0) continue;
+    for (const [platform, value] of Object.entries(object(args[field], field))) {
+      if (!PLATFORM_SET.has(platform)) throw new Error(`Invalid platform in ${field}.`);
+      if (field === "platformTexts") {
+        if (typeof value !== "string") throw new Error("Platform captions must be strings.");
+      } else if (field === "targetAccountIds") {
+        if (!Array.isArray(value) || value.length === 0 || value.some((id) => typeof id !== "string" || !id.trim()) || new Set(value).size !== value.length) {
+          throw new Error("Target account IDs must be a nonempty array of unique IDs.");
+        }
+      } else {
+        if (!Array.isArray(value)) throw new Error("Platform media must be an array.");
+        for (const item of value) {
+          const media = object(item, "Media item");
+          if (typeof media.url !== "string" || !media.url.trim() || !["image", "video", "gif"].includes(media.type)) {
+            throw new Error("Media items require a URL and image, video or gif type.");
+          }
+          if (media.altText !== void 0 && typeof media.altText !== "string") throw new Error("Media altText must be a string.");
+        }
+      }
+    }
+  }
+}
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -1696,8 +1764,15 @@ function fail(error) {
   return { content: [{ type: "text", text: message }], isError: true };
 }
 function parsePlatforms2(raw) {
-  if (typeof raw !== "string") return [];
-  const platforms = raw.split(",").map((p) => p.trim()).filter(Boolean);
+  if (raw === void 0) return [];
+  if (typeof raw !== "string" && !Array.isArray(raw)) {
+    throw new Error("Platforms must be a comma-separated string or an array of platform names.");
+  }
+  const values = typeof raw === "string" ? raw.split(",") : raw;
+  if (values.some((value) => typeof value !== "string")) {
+    throw new Error("Every platform must be a platform name.");
+  }
+  const platforms = values.map((p) => p.trim()).filter(Boolean);
   const invalid = platforms.filter((platform) => !PLATFORM_SET.has(platform));
   if (invalid.length > 0) {
     throw new Error(
@@ -1727,6 +1802,7 @@ async function handleToolCall(name, args, client) {
   }
 }
 async function dispatchToolCall(name, args, client) {
+  if (name === "create-post" || name === "update-post") validateAuthoringIntent(args);
   switch (name) {
     case "delete-account-import":
       return ok(await client.accountOnboarding.remove(args.id));
@@ -1760,18 +1836,26 @@ async function dispatchToolCall(name, args, client) {
         text: args.text,
         platforms: parsePlatforms2(args.platforms),
         ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {},
-        ...args.media ? { media: args.media } : {}
+        ...args.media ? { media: args.media } : {},
+        ...args.facebookOptions !== void 0 ? { facebookOptions: args.facebookOptions } : {},
+        ...args.targetAccountIds !== void 0 ? { targetAccountIds: args.targetAccountIds } : {},
+        ...args.platformTexts !== void 0 ? { platformTexts: args.platformTexts } : {},
+        ...args.platformMedia !== void 0 ? { platformMedia: args.platformMedia } : {}
       });
       return ok(result);
     }
     case "update-post": {
       const result = await client.posts.update(args.id, {
-        ...args.text ? { text: args.text } : {},
+        ...args.text !== void 0 ? { text: args.text } : {},
         ...args.platforms ? {
           platforms: parsePlatforms2(args.platforms)
         } : {},
         ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {},
-        ...args.media ? { media: args.media } : {}
+        ...args.media ? { media: args.media } : {},
+        ...args.facebookOptions !== void 0 ? { facebookOptions: args.facebookOptions } : {},
+        ...args.targetAccountIds !== void 0 ? { targetAccountIds: args.targetAccountIds } : {},
+        ...args.platformTexts !== void 0 ? { platformTexts: args.platformTexts } : {},
+        ...args.platformMedia !== void 0 ? { platformMedia: args.platformMedia } : {}
       });
       return ok(result);
     }
@@ -1784,14 +1868,14 @@ async function dispatchToolCall(name, args, client) {
       return ok(result);
     }
     case "schedule-post": {
-      const result = await client.posts.schedule(
-        args.id,
-        args.scheduledAt
-      );
+      if (args.platform !== void 0 && args.platform !== "facebook") throw new Error("Scheduled recovery requires platform facebook");
+      const result = args.platform === "facebook" ? await client.posts.schedule(args.id, args.scheduledAt, "facebook") : await client.posts.schedule(args.id, args.scheduledAt);
       return ok(result);
     }
     case "retry-post": {
-      const result = await client.posts.retry(args.id);
+      const platforms = args.platform === void 0 ? void 0 : parsePlatforms2(args.platform);
+      if (platforms && platforms.length !== 1) throw new Error("Retry requires exactly one platform");
+      const result = platforms ? await client.posts.retry(args.id, platforms[0]) : await client.posts.retry(args.id);
       return ok(result);
     }
     case "rewrite-post": {
@@ -2066,7 +2150,7 @@ async function dispatchToolCall(name, args, client) {
       const filePath = args.filePath;
       const filename = (0, import_node_path4.basename)(filePath);
       const uploaded = await client.media.upload({
-        data: new Uint8Array(await (0, import_promises3.readFile)(filePath)),
+        data: new Uint8Array(await (0, import_promises4.readFile)(filePath)),
         filename,
         contentType: extToMime(filename)
       });
@@ -2107,11 +2191,11 @@ async function dispatchToolCall(name, args, client) {
       };
   }
 }
-var import_promises3, import_node_path4, PLATFORMS, PLATFORM_SET, routeCache;
+var import_promises4, import_node_path4, PLATFORMS, PLATFORM_SET, routeCache;
 var init_handler = __esm({
   "src/mcp/handler.ts"() {
     "use strict";
-    import_promises3 = require("fs/promises");
+    import_promises4 = require("fs/promises");
     import_node_path4 = require("path");
     init_api_routes();
     init_media_flags();
@@ -2120,7 +2204,8 @@ var init_handler = __esm({
       "linkedin",
       "instagram",
       "threads",
-      "youtube"
+      "youtube",
+      "facebook"
     ];
     PLATFORM_SET = new Set(PLATFORMS);
     routeCache = /* @__PURE__ */ new WeakMap();
@@ -2936,6 +3021,10 @@ function createBillingCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const credits = await client.billing.credits();
       spinner.stop();
+      if (!printer.isTty()) {
+        printer.log(credits);
+        return;
+      }
       printer.table(
         [
           {
@@ -3129,6 +3218,28 @@ function buildAuthStatusRow(c, now = Date.now()) {
 }
 function createBrandsCommand() {
   const brands = new import_commander5.Command("brands").description("Manage brands");
+  brands.command("connect-facebook <slug>").description("Open the app to connect Facebook Pages; sign in, check beta access and explicitly select Pages there").option("--no-browser", "Print the application link without opening a browser").action(async (slug, opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const printer = createPrinter(globals);
+    try {
+      const cred = resolveAuth({ apiKey: globals.apiKey });
+      const client = new Autoposting({ apiKey: cred.apiKey });
+      const handoff = await client.brands.facebookConnection(slug);
+      printer.log(handoff);
+      if (opts.browser) {
+        try {
+          const { default: open2 } = await import("open");
+          await open2(handoff.url, { wait: true });
+        } catch {
+          printer.error(`Could not open the browser. Open ${handoff.url} manually, then check ap brands auth-status ${slug}.`);
+          process.exitCode = 1;
+        }
+      }
+    } catch (error) {
+      printer.error(error);
+      process.exitCode = exitCodeFromError(error);
+    }
+  });
   brands.command("list").description("List all brands").action(async (_opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
@@ -3559,6 +3670,7 @@ function createClipsCommand() {
 
 // src/commands/posts.ts
 var import_commander8 = require("commander");
+var import_promises3 = require("fs/promises");
 init_dist();
 
 // src/lib/post-create.ts
@@ -3567,7 +3679,7 @@ var import_node_path3 = __toESM(require("path"));
 init_media_flags();
 
 // src/lib/account-select.ts
-var VALID_PLATFORMS2 = ["x", "linkedin", "instagram", "threads", "youtube"];
+var VALID_PLATFORMS2 = ["x", "linkedin", "instagram", "threads", "youtube", "facebook"];
 var FANOUT_CONFIRM_THRESHOLD = 5;
 var PAGED_PICKER_THRESHOLD = 8;
 var isAll = (v) => v === "all" || v === "*";
@@ -3630,24 +3742,28 @@ async function resolveTargetAccounts({
       }
       if (ids.length > 0) result[platform] = ids;
     } else if (specifiedValue !== void 0) {
-      const normalized = specifiedValue.startsWith("@") ? specifiedValue.slice(1) : specifiedValue;
-      const match = accounts.find(
-        (a) => a.platformUsername?.toLowerCase() === normalized.toLowerCase() || a.platformUserId === specifiedValue
-      );
-      if (!match?.platformUserId) {
-        const valid = accounts.map((a) => `  @${a.platformUsername ?? "?"} (${a.platformUserId ?? "?"})`).join("\n");
-        throw Object.assign(
-          new Error(
-            `--account: unknown ${platform} account "${specifiedValue}".
+      const values = platform === "facebook" ? specifiedValue.split(",").map((value) => value.trim()) : [specifiedValue];
+      for (const value of values) {
+        if (!value) throw Object.assign(new Error("--account: Page selection must not contain empty members."), { exitCode: 1 });
+        const normalized = value.startsWith("@") ? value.slice(1) : value;
+        const match = accounts.find(
+          (a) => a.platformUsername?.toLowerCase() === normalized.toLowerCase() || a.platformUserId === value
+        );
+        if (!match?.platformUserId) {
+          const valid = accounts.map((a) => `  @${a.platformUsername ?? "?"} (${a.platformUserId ?? "?"})`).join("\n");
+          throw Object.assign(
+            new Error(
+              `--account: unknown ${platform} account "${value}".
 Connected accounts:
 ${valid || "  (none)"}`
-          ),
-          { exitCode: 1 }
-        );
+            ),
+            { exitCode: 1 }
+          );
+        }
+        if (!result[platform]) result[platform] = [];
+        if (!result[platform].includes(match.platformUserId)) result[platform].push(match.platformUserId);
       }
-      if (!result[platform]) result[platform] = [];
-      result[platform].push(match.platformUserId);
-    } else if (accounts.length >= 2) {
+    } else if (accounts.length >= 2 || platform === "facebook" && accounts.length > 0) {
       if (isTty) {
         const { checkbox } = await import("@inquirer/prompts");
         const choices = accounts.map((a) => ({
@@ -3678,12 +3794,15 @@ Pass --account ${platform}=<handle|id> to select.`
         );
       }
     }
+    if (platform === "facebook" && !result.facebook?.length) {
+      throw Object.assign(new Error("Facebook requires at least one explicitly selected connected Page. Pass --account facebook=<handle|id>."), { exitCode: 1 });
+    }
   }
   return result;
 }
 
 // src/lib/post-create.ts
-var VALID_PLATFORMS3 = ["x", "linkedin", "instagram", "threads", "youtube"];
+var VALID_PLATFORMS3 = ["x", "linkedin", "instagram", "threads", "youtube", "facebook"];
 function parsePlatforms(raw) {
   const parts = raw.split(",").map((p) => p.trim()).filter(Boolean);
   if (parts.length === 0) {
@@ -3711,21 +3830,73 @@ function validateScheduledAt(value) {
   }
   return value;
 }
+function validateCanonicalMedia(items) {
+  for (const item of items) {
+    if (!item || typeof item !== "object" || typeof item.url !== "string" || !["image", "video", "gif"].includes(item.type)) throw new Error("Media items require a URL and supported type");
+    let url;
+    try {
+      url = new URL(item.url);
+    } catch {
+      throw new Error("Media URL must use HTTPS");
+    }
+    if (url.protocol !== "https:" || url.username || url.password) throw new Error("Media URL must use credential-free HTTPS");
+    if (item.altText !== void 0 && typeof item.altText !== "string") throw new Error("Media altText must be a string");
+  }
+}
 async function buildAndCreatePost(client, fields, opts) {
   const platforms = parsePlatforms(fields.platforms);
   const scheduledAt = fields.at ? validateScheduledAt(fields.at) : void 0;
-  if (fields.media && fields.media.length > 0) {
-    validateMediaCount(fields.media);
-    validateMediaPaths(fields.media);
-    validateMediaExtensions(fields.media);
+  const sharedMedia = fields.media ?? [];
+  if (!Array.isArray(sharedMedia)) throw new Error("media must be an array");
+  const localMedia = sharedMedia.every((item) => typeof item === "string") ? sharedMedia : [];
+  const sharedCanonicalMedia = localMedia.length || !sharedMedia.length ? [] : sharedMedia;
+  validateCanonicalMedia(sharedCanonicalMedia);
+  if (localMedia.length) {
+    validateMediaCount(localMedia);
+    validateMediaPaths(localMedia);
+    validateMediaExtensions(localMedia);
   }
   const platformTexts = fields.platformText && fields.platformText.length > 0 ? parsePairs("--platform-text", fields.platformText) : void 0;
-  const platformMediaPaths = fields.platformMedia && fields.platformMedia.length > 0 ? parsePlatformMediaPairs("--platform-media", fields.platformMedia) : {};
+  const suppliedMedia = fields.platformMedia;
+  const canonicalMedia = {};
+  if (suppliedMedia !== void 0 && !Array.isArray(suppliedMedia)) {
+    if (!suppliedMedia || typeof suppliedMedia !== "object") throw new Error("platformMedia must be an object or local path flags");
+    for (const [platform, items] of Object.entries(suppliedMedia)) {
+      if (!VALID_PLATFORMS3.includes(platform) || !Array.isArray(items)) throw new Error("platformMedia requires supported platforms and media arrays");
+      validateCanonicalMedia(items);
+      canonicalMedia[platform] = items;
+    }
+  }
+  const platformMediaPaths = Array.isArray(suppliedMedia) && suppliedMedia.length > 0 ? parsePlatformMediaPairs("--platform-media", suppliedMedia) : {};
   for (const paths of Object.values(platformMediaPaths)) {
     validateMediaPaths(paths);
     validateMediaExtensions(paths);
   }
-  const altTexts = alignAltText(fields.media ?? [], fields.altText ?? []);
+  let facebookOptions;
+  if (platforms.includes("facebook")) {
+    const format = fields.facebookFormat;
+    if (!format || !["text", "link", "photo", "multi-photo", "video", "reel"].includes(format)) {
+      throw new Error("--facebook-format must be text, link, photo, multi-photo, video or reel");
+    }
+    const paths = canonicalMedia.facebook ?? platformMediaPaths.facebook ?? fields.media ?? [];
+    const images = paths.every((item) => typeof item === "string" ? extToMime(item).startsWith("image/") : item.type === "image");
+    const videos = paths.every((item) => typeof item === "string" ? extToMime(item).startsWith("video/") : item.type === "video");
+    if ((format === "text" || format === "link") && paths.length || format === "photo" && (paths.length !== 1 || !images) || format === "multi-photo" && (paths.length < 2 || !images) || (format === "video" || format === "reel") && (paths.length !== 1 || !videos)) {
+      throw new Error("Facebook attachments do not match --facebook-format");
+    }
+    if (format === "text" && !(platformTexts?.facebook ?? fields.text).trim()) throw new Error("Facebook text format requires a caption");
+    if (format === "link") {
+      let link;
+      try {
+        link = new URL(fields.facebookLink ?? "");
+      } catch {
+        throw new Error("--facebook-link must be a public HTTPS URL");
+      }
+      if (link.protocol !== "https:" || link.username || link.password) throw new Error("--facebook-link must be a public HTTPS URL");
+    }
+    facebookOptions = { format, ...format === "link" ? { link: fields.facebookLink } : {} };
+  }
+  const altTexts = alignAltText(localMedia, fields.altText ?? []);
   const youtubeOptions = buildYoutubeOptions({
     ytTitle: fields.ytTitle,
     ytDescription: fields.ytDescription,
@@ -3764,6 +3935,7 @@ async function buildAndCreatePost(client, fields, opts) {
     ...instagramOptions ? { instagramOptions } : {},
     ...threadsOptions ? { threadsOptions } : {},
     ...youtubeOptions ? { youtubeOptions } : {},
+    ...facebookOptions ? { facebookOptions } : {},
     source: "cli"
   };
   if (opts.dryRun) {
@@ -3772,19 +3944,19 @@ async function buildAndCreatePost(client, fields, opts) {
       request: {
         ...common,
         ...fields.media && fields.media.length > 0 ? {
-          media: fields.media.map((path3, i) => ({
+          media: sharedCanonicalMedia.length ? sharedCanonicalMedia : localMedia.map((path3, i) => ({
             path: path3,
             ...altTexts[i] ? { altText: altTexts[i] } : {}
           }))
         } : {},
-        ...Object.keys(platformMediaPaths).length > 0 ? { platformMedia: platformMediaPaths } : {}
+        ...Object.keys(platformMediaPaths).length + Object.keys(canonicalMedia).length > 0 ? { platformMedia: { ...canonicalMedia, ...platformMediaPaths } } : {}
       }
     };
   }
   opts.onBeforeNetwork?.();
-  const mediaInputs = [];
-  for (let i = 0; i < (fields.media ?? []).length; i++) {
-    const filePath = fields.media[i];
+  const mediaInputs = [...sharedCanonicalMedia];
+  for (let i = 0; i < localMedia.length; i++) {
+    const filePath = localMedia[i];
     const data = await import_promises2.default.readFile(filePath);
     const filename = import_node_path3.default.basename(filePath);
     const uploaded = await client.media.upload({
@@ -3798,7 +3970,7 @@ async function buildAndCreatePost(client, fields, opts) {
       ...altTexts[i] ? { altText: altTexts[i] } : {}
     });
   }
-  const platformMediaResult = {};
+  const platformMediaResult = { ...canonicalMedia };
   for (const [p, paths] of Object.entries(platformMediaPaths)) {
     const uploads = [];
     for (const filePath of paths) {
@@ -3890,16 +4062,44 @@ function rowToFields(row, cliBrand) {
   if (!brand) {
     throw new Error('No brand: set "brand" in the row, pass --brand, or set a default context.');
   }
-  if (!row.text) throw new Error('Missing "text".');
+  if (typeof row.text !== "string") throw new Error('Missing "text" or text is not a string.');
   if (!platforms) throw new Error('Missing "platforms".');
   for (const key of ["media", "thread", "account", "altText"]) {
     if (row[key] !== void 0 && !Array.isArray(row[key])) {
       throw new Error(`"${key}" is multi-value \u2014 use a JSON input file with an array (CSV can't express it).`);
     }
   }
+  let platformText = row.platformText;
+  if (row.platformTexts !== void 0) {
+    if (!row.platformTexts || typeof row.platformTexts !== "object" || Array.isArray(row.platformTexts)) throw new Error("platformTexts must map platforms to caption strings");
+    const captions = Object.entries(row.platformTexts).map(([platform, text]) => {
+      if (typeof text !== "string") throw new Error("platformTexts values must be strings");
+      return `${platform}=${text}`;
+    });
+    platformText = platformText ?? captions;
+  }
+  let facebook;
+  if (row.facebookOptions !== void 0) {
+    if (!row.facebookOptions || typeof row.facebookOptions !== "object" || Array.isArray(row.facebookOptions)) throw new Error("facebookOptions must be an object");
+    facebook = row.facebookOptions;
+    if (typeof facebook.format !== "string" || facebook.link !== void 0 && typeof facebook.link !== "string") throw new Error("facebookOptions requires a string format and optional string link");
+  }
+  let account = row.account;
+  if (row.targetAccountIds !== void 0) {
+    if (!row.targetAccountIds || typeof row.targetAccountIds !== "object" || Array.isArray(row.targetAccountIds)) throw new Error("targetAccountIds must map platforms to account ID arrays");
+    const flags = Object.entries(row.targetAccountIds).map(([platform, ids]) => {
+      if (!Array.isArray(ids) || ids.length === 0 || ids.some((id) => typeof id !== "string" || !id.trim() || id.includes(","))) throw new Error("targetAccountIds requires nonempty account ID arrays");
+      return `${platform}=${ids.join(",")}`;
+    });
+    account = account ?? flags;
+  }
   return {
     ...row,
+    ...facebook ? { facebookFormat: facebook.format, facebookLink: facebook.link } : {},
+    ...account ? { account } : {},
+    ...platformText ? { platformText } : {},
     brandSlug: brand,
+    at: row.at ?? row.scheduledAt,
     text: String(row.text),
     platforms: String(platforms)
   };
@@ -3988,7 +4188,7 @@ function createPostsCommand() {
   posts.command("create").description("Create a new post").option("--brand <slug>", "Brand slug (defaults to the saved context: ap config set-context)").option("--text <text>", "Post text content (required unless --from)").option("--platforms <list>", "Comma-separated platforms, e.g. x,linkedin (required unless --from)").option("--from <file>", "Create posts in bulk from a CSV or JSON file (one post per row)").option("--at <iso>", "Schedule date/time (ISO 8601)").option(
     "--thread <text...>",
     "Additional posts appended after --text to form a thread (X/Threads only, max 25)"
-  ).option("--media <path...>", "Media file paths to attach (max 10)").option("--alt-text <text...>", "Alt text for --media files, aligned by index").option("--platform-text <pairs...>", "Per-platform text, e.g. x=Hello linkedin=World").option("--platform-media <pairs...>", "Per-platform media, e.g. instagram=photo.jpg x=banner.png").option("--yt-title <t>", "YouTube video title").option("--yt-description <d>", "YouTube video description").option("--yt-tags <list>", "YouTube tags (comma-separated)").option("--yt-privacy <v>", "YouTube privacy status (public|unlisted|private)").option("--yt-category <id>", "YouTube category ID").option("--yt-made-for-kids", "Mark YouTube video as made for kids").option("--ig-reel", "Post as an Instagram Reel").option("--ig-share-to-feed", "Share Reel to feed").option("--ig-cover-url <url>", "Reel cover image URL").option("--ig-thumb-offset-ms <n>", "Reel thumbnail offset in milliseconds").option("--ig-collaborators <list>", "Reel collaborator handles (comma-separated)").option("--threads-reply-to <id>", "Threads post ID to reply to").option("--threads-reply-control <v>", "Threads reply control (everyone|accounts_you_follow|mentioned_only)").option("--account <p=handle|id...>", "Target specific account per platform, e.g. x=@handle").option("--dry-run", "Print the resolved request body without uploading media or creating the post").option("--preview", "Alias for --dry-run").action(
+  ).option("--media <path...>", "Media file paths to attach (max 10)").option("--alt-text <text...>", "Alt text for --media files, aligned by index").option("--platform-text <pairs...>", "Per-platform text, e.g. x=Hello linkedin=World").option("--platform-media <pairs...>", "Per-platform media, e.g. instagram=photo.jpg x=banner.png").option("--yt-title <t>", "YouTube video title").option("--yt-description <d>", "YouTube video description").option("--yt-tags <list>", "YouTube tags (comma-separated)").option("--yt-privacy <v>", "YouTube privacy status (public|unlisted|private)").option("--yt-category <id>", "YouTube category ID").option("--yt-made-for-kids", "Mark YouTube video as made for kids").option("--ig-reel", "Post as an Instagram Reel").option("--ig-share-to-feed", "Share Reel to feed").option("--ig-cover-url <url>", "Reel cover image URL").option("--ig-thumb-offset-ms <n>", "Reel thumbnail offset in milliseconds").option("--ig-collaborators <list>", "Reel collaborator handles (comma-separated)").option("--threads-reply-to <id>", "Threads post ID to reply to").option("--threads-reply-control <v>", "Threads reply control (everyone|accounts_you_follow|mentioned_only)").option("--facebook-format <format>", "Facebook Pages: text|link|photo|multi-photo|video|reel").option("--facebook-link <url>", "Public HTTPS article URL for Facebook link format").option("--account <p=handle|id...>", "Target specific account per platform, e.g. x=@handle; Facebook Page lists: facebook=page-id-1,page-id-2").option("--dry-run", "Print the resolved request body without uploading media or creating the post").option("--preview", "Alias for --dry-run").action(
     async (opts, cmd) => {
       const globals = cmd.optsWithGlobals();
       const printer = createPrinter(globals);
@@ -4054,7 +4254,7 @@ function createPostsCommand() {
       }
     }
   );
-  posts.command("update <id>").description("Update a post").option("--text <text>", "New post text").option("--platforms <list>", "New comma-separated platforms").option("--at <iso>", "New scheduled date/time (ISO 8601)").action(
+  posts.command("update <id>").description("Update a post").option("--from <file>", "JSON update object with formats, target account IDs, captions and media URLs; explicit flags override file fields").option("--text <text>", "New post text").option("--platforms <list>", "New comma-separated platforms").option("--at <iso>", "New scheduled date/time (ISO 8601)").action(
     async (id, opts, cmd) => {
       const globals = cmd.optsWithGlobals();
       const printer = createPrinter(globals);
@@ -4062,8 +4262,26 @@ function createPostsCommand() {
       try {
         const cred = resolveAuth({ apiKey: globals.apiKey });
         const client = new Autoposting({ apiKey: cred.apiKey });
+        let patch = {};
+        if (opts.from) {
+          const parsed = JSON.parse(await (0, import_promises3.readFile)(opts.from, "utf8"));
+          if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("--from requires one JSON update object");
+          const allowed = ["text", "platforms", "scheduledAt", "media", "platformMedia", "platformTexts", "targetAccountIds", "facebookOptions"];
+          if (Object.keys(parsed).some((key) => !allowed.includes(key))) throw new Error("--from contains an unsupported update field");
+          patch = parsed;
+          if (patch.text !== void 0 && typeof patch.text !== "string") throw new Error("Update text must be a string");
+          if (patch.platforms !== void 0) {
+            if (!Array.isArray(patch.platforms) || patch.platforms.some((platform) => typeof platform !== "string" || !platform.trim() || platform.includes(","))) throw new Error("Update platforms must be an array of platform names");
+            patch.platforms = parsePlatforms(patch.platforms.join(","));
+          }
+          if (patch.scheduledAt !== void 0) {
+            if (typeof patch.scheduledAt !== "string") throw new Error("Update scheduledAt must be an ISO datetime string");
+            patch.scheduledAt = validateScheduledAt(patch.scheduledAt);
+          }
+        }
         const post = await client.posts.update(id, {
-          ...opts.text ? { text: opts.text } : {},
+          ...patch,
+          ...opts.text !== void 0 ? { text: opts.text } : {},
           ...opts.platforms ? { platforms: parsePlatforms(opts.platforms) } : {},
           ...opts.at ? { scheduledAt: validateScheduledAt(opts.at) } : {}
         });
@@ -4115,7 +4333,7 @@ function createPostsCommand() {
       process.exit(resolveExitCode5(err));
     }
   });
-  posts.command("schedule <id>").description("Schedule a post for a specific time, or --cancel to unschedule it").option("--at <iso>", "ISO 8601 datetime to schedule the post").option("--cancel", "Unschedule the post (return it to draft)").action(async (id, opts, cmd) => {
+  posts.command("schedule <id>").description("Schedule a post for a specific time, or --cancel to unschedule it").option("--at <iso>", "ISO 8601 datetime to schedule the post").option("--cancel", "Cancel scheduling").option("--platform <platform>", "facebook schedules only eligible failed Pages for recovery").action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner(
@@ -4128,9 +4346,10 @@ function createPostsCommand() {
       if (!opts.cancel && !opts.at) {
         throw new Error("Provide either --at <iso> to schedule, or --cancel to unschedule.");
       }
+      if (opts.platform && (opts.platform !== "facebook" || opts.cancel)) throw new Error("--platform facebook requires --at and cannot be used with --cancel.");
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const post = opts.cancel ? await client.posts.unschedule(id) : await client.posts.schedule(id, validateScheduledAt(opts.at));
+      const post = opts.cancel ? await client.posts.unschedule(id) : opts.platform === "facebook" ? await client.posts.schedule(id, validateScheduledAt(opts.at), "facebook") : await client.posts.schedule(id, validateScheduledAt(opts.at));
       spinner.stop();
       printer.log(post);
     } catch (err) {
@@ -4139,14 +4358,16 @@ function createPostsCommand() {
       process.exit(resolveExitCode5(err));
     }
   });
-  posts.command("retry <id>").description("Retry a failed post").action(async (id, _opts, cmd) => {
+  posts.command("retry <id>").description("Retry a failed post").option("--platform <platform>", "Select a platform; facebook retries only failed Pages without remote evidence").action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner(`Retrying post "${id}"\u2026`);
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const post = await client.posts.retry(id);
+      const platform = opts.platform ? parsePlatforms(opts.platform) : void 0;
+      if (platform && platform.length !== 1) throw new Error("--platform requires exactly one platform");
+      const post = platform ? await client.posts.retry(id, platform[0]) : await client.posts.retry(id);
       spinner.stop();
       printer.log(post);
     } catch (err) {
@@ -4479,6 +4700,10 @@ function createUsageCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const summary = await client.usage.summary();
       spinner.stop();
+      if (!printer.isTty()) {
+        printer.log(summary);
+        return;
+      }
       printer.log(`Period: ${summary.range.from.slice(0, 10)} \u2192 ${summary.range.to.slice(0, 10)}`);
       printer.table(
         [