@autoposting.ai/cli 0.3.5 → 0.4.0

package/dist/cli.cjs

@@ -79,7 +79,7 @@ var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, V
 var init_dist = __esm({
   "../sdk/dist/index.mjs"() {
     "use strict";
-    VERSION = "0.3.5";
+    VERSION = "0.4.0";
     AutopostingError = class extends Error {
       status;
       code;
@@ -245,8 +245,8 @@ var init_dist = __esm({
           throw new AutopostingError("brandId is required to upload a clip.", 0, "VALIDATION_ERROR");
         }
         const { open: open2, stat } = await import("fs/promises");
-        const { basename } = await import("path");
-        const fileName = basename(filePath);
+        const { basename: basename2 } = await import("path");
+        const fileName = basename2(filePath);
         const title = options.title ?? fileName;
         const mimeType = options.contentType ?? guessVideoMime(fileName);
         const { size: fileSize } = await stat(filePath);
@@ -298,8 +298,16 @@ var init_dist = __esm({
         return this.client.request("POST", "/clips/import-url", params);
       }
       /** POST /clips/:id/render — backend returns render job ids, not a Clip. */
-      render(id) {
-        return this.client.request("POST", `/clips/${id}/render`);
+      async render(id, params = {}) {
+        const editRevision = params.editRevision ?? (await this.retrieve(id)).editRevision ?? 0;
+        return this.client.request("POST", `/clips/${id}/render`, {
+          editRevision,
+          ...params.candidateId ? { candidateId: params.candidateId } : {}
+        });
+      }
+      /** POST /clips/:id/create-draft — turns a rendered clip into a draft post. */
+      createDraft(id, params = {}) {
+        return this.client.request("POST", `/clips/${id}/create-draft`, params);
       }
       remove(id) {
         return this.client.request("DELETE", `/clips/${id}`);
@@ -655,11 +663,151 @@ var init_dist = __esm({
   }
 });
 
+// src/lib/media-flags.ts
+function extToMime(filename) {
+  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+  const mime = EXT_TO_MIME[ext];
+  if (!mime) {
+    throw new Error(
+      `Unsupported file extension ".${ext || "(none)"}" in "${filename}". Supported: ${Object.keys(EXT_TO_MIME).join(", ")}`
+    );
+  }
+  return mime;
+}
+function parsePairs(flag, vals) {
+  const result = {};
+  for (const val of vals) {
+    const eqIdx = val.indexOf("=");
+    if (eqIdx < 1) {
+      throw new Error(`${flag}: expected "platform=value" format, got "${val}"`);
+    }
+    const p = val.slice(0, eqIdx).trim();
+    const v = val.slice(eqIdx + 1);
+    if (!VALID_PLATFORMS.includes(p)) {
+      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
+    }
+    result[p] = v;
+  }
+  return result;
+}
+function parsePlatformMediaPairs(flag, vals) {
+  const result = {};
+  for (const val of vals) {
+    const eqIdx = val.indexOf("=");
+    if (eqIdx < 1) {
+      throw new Error(`${flag}: expected "platform=path[,path...]" format, got "${val}"`);
+    }
+    const p = val.slice(0, eqIdx).trim();
+    const paths = val.slice(eqIdx + 1).split(",").map((s) => s.trim()).filter(Boolean);
+    if (!VALID_PLATFORMS.includes(p)) {
+      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
+    }
+    result[p] = paths;
+  }
+  return result;
+}
+function validateMediaExtensions(paths) {
+  for (const p of paths) extToMime(p);
+}
+function validateMediaCount(paths) {
+  if (paths.length > 10) {
+    throw new Error(`--media accepts at most 10 files (received ${paths.length}).`);
+  }
+}
+function validateMediaPaths(paths) {
+  for (const p of paths) {
+    if (!(0, import_node_fs2.existsSync)(p)) {
+      throw new Error(`Media file not found: "${p}"`);
+    }
+  }
+}
+function alignAltText(mediaPaths, altTexts) {
+  if (altTexts.length > mediaPaths.length) {
+    throw new Error(
+      `--alt-text has more values (${altTexts.length}) than --media (${mediaPaths.length}). Alt text aligns to media by index.`
+    );
+  }
+  return mediaPaths.map((_, i) => altTexts[i]);
+}
+function buildYoutubeOptions(opts) {
+  const { ytTitle, ytDescription, ytTags, ytPrivacy, ytCategory, ytMadeForKids } = opts;
+  const o = {};
+  if (ytTitle) o.title = ytTitle;
+  if (ytDescription) o.description = ytDescription;
+  if (ytTags) o.tags = ytTags.split(",").map((t) => t.trim()).filter(Boolean);
+  if (ytPrivacy) o.privacyStatus = ytPrivacy;
+  if (ytCategory) o.categoryId = ytCategory;
+  if (ytMadeForKids !== void 0) o.madeForKids = ytMadeForKids;
+  return Object.keys(o).length > 0 ? o : void 0;
+}
+function buildInstagramOptions(opts) {
+  const { igReel, igShareToFeed, igCoverUrl, igThumbOffsetMs, igCollaborators } = opts;
+  const hasAnyReelFlag = igReel !== void 0 || igShareToFeed !== void 0 || igCoverUrl !== void 0 || igThumbOffsetMs !== void 0 || igCollaborators !== void 0;
+  if (!hasAnyReelFlag) return void 0;
+  const reel = {};
+  if (igShareToFeed !== void 0) reel.shareToFeed = igShareToFeed;
+  if (igCoverUrl) reel.coverUrl = igCoverUrl;
+  if (igThumbOffsetMs !== void 0) {
+    const n = Number(igThumbOffsetMs);
+    if (!Number.isFinite(n) || n < 0) {
+      throw new Error(
+        `--ig-thumb-offset-ms must be a non-negative number (received "${igThumbOffsetMs}")`
+      );
+    }
+    reel.thumbOffsetMs = n;
+  }
+  if (igCollaborators) {
+    reel.collaborators = igCollaborators.split(",").map((s) => s.trim()).filter(Boolean);
+  }
+  return { reel };
+}
+function buildThreadsOptions(opts) {
+  const { threadsReplyTo, threadsReplyControl } = opts;
+  if (!threadsReplyTo && !threadsReplyControl) return void 0;
+  const o = {};
+  if (threadsReplyTo) o.replyToId = threadsReplyTo;
+  if (threadsReplyControl) o.replyControl = threadsReplyControl;
+  return o;
+}
+var import_node_fs2, VALID_PLATFORMS, EXT_TO_MIME;
+var init_media_flags = __esm({
+  "src/lib/media-flags.ts"() {
+    "use strict";
+    import_node_fs2 = require("fs");
+    VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube"];
+    EXT_TO_MIME = {
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      png: "image/png",
+      gif: "image/gif",
+      webp: "image/webp",
+      mp4: "video/mp4",
+      mov: "video/quicktime",
+      webm: "video/webm"
+    };
+  }
+});
+
 // src/mcp/tools.ts
-var ALL_TOOLS;
+var MEDIA_ITEMS, ALL_TOOLS;
 var init_tools = __esm({
   "src/mcp/tools.ts"() {
     "use strict";
+    MEDIA_ITEMS = {
+      type: "array",
+      maxItems: 10,
+      description: "Images or videos to attach, as https URLs. For a local file, call upload-media first and pass its result here.",
+      items: {
+        type: "object",
+        properties: {
+          url: { type: "string", description: "Public https URL of the image or video" },
+          type: { type: "string", enum: ["image", "video", "gif"] },
+          altText: { type: "string", description: "Optional alt text" }
+        },
+        required: ["url", "type"],
+        additionalProperties: false
+      }
+    };
     ALL_TOOLS = [
       // Posts
       {
@@ -707,7 +855,8 @@ var init_tools = __esm({
             scheduledAt: {
               type: "string",
               description: "ISO 8601 datetime to schedule the post"
-            }
+            },
+            media: MEDIA_ITEMS
           },
           required: ["brandSlug", "text", "platforms"],
           additionalProperties: false
@@ -715,14 +864,15 @@ var init_tools = __esm({
       },
       {
         name: "update-post",
-        description: "Update the text, platforms, or scheduled time of an existing post.",
+        description: "Update the text, platforms, scheduled time, or media of an existing post.",
         inputSchema: {
           type: "object",
           properties: {
             id: { type: "string", description: "Post ID" },
             text: { type: "string", description: "New post text" },
             platforms: { type: "string", description: "Comma-separated new platform list" },
-            scheduledAt: { type: "string", description: "New ISO 8601 scheduled datetime" }
+            scheduledAt: { type: "string", description: "New ISO 8601 scheduled datetime" },
+            media: MEDIA_ITEMS
           },
           required: ["id"],
           additionalProperties: false
@@ -1156,29 +1306,79 @@ var init_tools = __esm({
       },
       {
         name: "import-clip",
-        description: "Import a video clip from a remote URL.",
+        description: "Start AI clipping: import a long video from a public URL (e.g. a YouTube video). Poll get-clip until status is ready.",
         inputSchema: {
           type: "object",
           properties: {
             url: { type: "string", description: "URL of the video to import" },
+            brandId: { type: "string", description: "Brand ID (the `id` from list-brands)" },
             name: { type: "string", description: "Optional name for the imported clip" }
           },
-          required: ["url"],
+          required: ["url", "brandId"],
           additionalProperties: false
         }
       },
       {
         name: "render-clip",
-        description: "Trigger rendering for a video clip.",
+        description: "Render a clip (uses credits). Call get-clip first for its editRevision and candidates.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: { type: "string", description: "Clip ID to render" },
+            editRevision: { type: "number", description: "Current editRevision from get-clip" },
+            candidateId: { type: "string", description: "Optional: render only this candidate" }
+          },
+          required: ["id", "editRevision"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "create-clip-draft",
+        description: "Create a draft post from a rendered clip. Publish it with publish-post or schedule it.",
         inputSchema: {
           type: "object",
           properties: {
-            id: { type: "string", description: "Clip ID to render" }
+            id: { type: "string", description: "Clip ID" },
+            candidateId: { type: "string", description: "Optional candidate ID (defaults to the first rendered one)" },
+            aspectRatio: { type: "string", enum: ["9:16", "16:9", "1:1", "4:5"], description: "Optional render format" }
           },
           required: ["id"],
           additionalProperties: false
         }
       },
+      {
+        name: "upload-clip",
+        description: "Upload a local video file for AI clipping (multipart, any size). Poll get-clip until status is ready, then render-clip.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            filePath: { type: "string", description: "Absolute path to the video file on this machine" },
+            brandId: { type: "string", description: "Brand ID (the `id` from list-brands)" },
+            title: { type: "string", description: "Optional clip title" }
+          },
+          required: ["filePath", "brandId"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "publish-clip",
+        description: "Publish, schedule, or save as a draft a rendered clip candidate.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: { type: "string", description: "Clip ID" },
+            mode: { type: "string", enum: ["publish", "schedule", "draft"] },
+            candidateId: { type: "string", description: "Candidate to post (defaults to the best rendered one)" },
+            platforms: { type: "string", description: 'Comma-separated platforms, e.g. "x,linkedin"' },
+            text: { type: "string", description: "Post caption" },
+            brandSlug: { type: "string", description: "Brand slug" },
+            scheduledAt: { type: "string", description: 'ISO 8601 time, for mode "schedule"' },
+            aspectRatio: { type: "string", enum: ["9:16", "4:5", "1:1", "16:9"] }
+          },
+          required: ["id", "mode"],
+          additionalProperties: false
+        }
+      },
       {
         name: "delete-clip",
         description: "Permanently delete a video clip by ID.",
@@ -1191,6 +1391,45 @@ var init_tools = __esm({
           additionalProperties: false
         }
       },
+      // Media
+      {
+        name: "upload-media",
+        description: "Upload a local image or video and get back a media item ({url, type, altText}) to pass in create-post or update-post `media`.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            filePath: { type: "string", description: "Absolute path to the file on this machine" },
+            altText: { type: "string", description: "Optional alt text" }
+          },
+          required: ["filePath"],
+          additionalProperties: false
+        }
+      },
+      // Any other REST route
+      {
+        name: "list-api-routes",
+        description: 'List the REST routes api-request may call, as "METHOD /path/:param". Optional prefix filter, e.g. "/clips".',
+        inputSchema: {
+          type: "object",
+          properties: { prefix: { type: "string", description: "Only routes whose path starts with this" } },
+          additionalProperties: false
+        }
+      },
+      {
+        name: "api-request",
+        description: "Call any Autoposting REST route on the allow-list (see list-api-routes) with your API key. Replace :params with real IDs.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            method: { type: "string", enum: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+            path: { type: "string", description: "Path such as /clips/abc123/jobs, no query string" },
+            query: { type: "object", description: "Query string parameters" },
+            body: { type: "object", description: "JSON body for POST, PUT and PATCH" }
+          },
+          required: ["method", "path"],
+          additionalProperties: false
+        }
+      },
       // Carousels
       {
         name: "list-carousels",
@@ -1373,6 +1612,40 @@ var init_tools = __esm({
   }
 });
 
+// src/lib/api-routes.ts
+async function fetchApiRoutes(client) {
+  const res = await client.request("POST", "/mcp", {
+    jsonrpc: "2.0",
+    id: 1,
+    method: "tools/call",
+    params: { name: "list-api-routes", arguments: {} }
+  });
+  try {
+    const routes = JSON.parse(res.result?.content?.[0]?.text ?? "").routes;
+    if (Array.isArray(routes)) return routes;
+  } catch {
+  }
+  throw new Error(`Could not load the API allow-list from the server${res.error?.message ? `: ${res.error.message}` : ""}.`);
+}
+function assertApiRoute(routes, method, path3) {
+  const m = method.toUpperCase();
+  const segs = path3.startsWith("/") ? path3.slice(1).split("/") : [];
+  const safe = segs.length > 0 && segs.every((s) => SAFE_SEGMENT.test(s) && s !== "." && s !== "..");
+  const match = safe && routes.some((r) => {
+    const [rm, rp] = r.split(" ");
+    const rs = rp.slice(1).split("/");
+    return rm === m && rs.length === segs.length && rs.every((s, i) => s.startsWith(":") || s === segs[i]);
+  });
+  if (!match) throw new Error(`${m} ${path3} is not available. Run list-api-routes (or \`ap api --list\`) to see what is.`);
+}
+var SAFE_SEGMENT;
+var init_api_routes = __esm({
+  "src/lib/api-routes.ts"() {
+    "use strict";
+    SAFE_SEGMENT = /^[\w\-.~]+$/;
+  }
+});
+
 // src/mcp/handler.ts
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
@@ -1392,6 +1665,15 @@ function parsePlatforms2(raw) {
   }
   return platforms;
 }
+function apiRoutes(client) {
+  let routes = routeCache.get(client);
+  if (!routes) {
+    routes = fetchApiRoutes(client);
+    routeCache.set(client, routes);
+    routes.catch(() => routeCache.delete(client));
+  }
+  return routes;
+}
 function parseEvents(raw) {
   if (typeof raw !== "string") return [];
   return raw.split(",").map((e) => e.trim());
@@ -1424,7 +1706,8 @@ async function dispatchToolCall(name, args, client) {
         brandSlug: args.brandSlug,
         text: args.text,
         platforms: parsePlatforms2(args.platforms),
-        ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {}
+        ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {},
+        ...args.media ? { media: args.media } : {}
       });
       return ok(result);
     }
@@ -1434,7 +1717,8 @@ async function dispatchToolCall(name, args, client) {
         ...args.platforms ? {
           platforms: parsePlatforms2(args.platforms)
         } : {},
-        ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {}
+        ...args.scheduledAt ? { scheduledAt: args.scheduledAt } : {},
+        ...args.media ? { media: args.media } : {}
       });
       return ok(result);
     }
@@ -1622,14 +1906,40 @@ async function dispatchToolCall(name, args, client) {
     case "import-clip": {
       const result = await client.clips.importUrl({
         url: args.url,
-        ...args.name ? { name: args.name } : {}
+        brandId: args.brandId,
+        ...args.name ? { title: args.name } : {}
       });
       return ok(result);
     }
     case "render-clip": {
-      const result = await client.clips.render(args.id);
+      const result = await client.clips.render(args.id, {
+        editRevision: args.editRevision,
+        ...args.candidateId ? { candidateId: args.candidateId } : {}
+      });
       return ok(result);
     }
+    case "create-clip-draft": {
+      const result = await client.clips.createDraft(args.id, {
+        ...args.candidateId ? { candidateId: args.candidateId } : {},
+        ...args.aspectRatio ? { aspectRatio: args.aspectRatio } : {}
+      });
+      return ok(result);
+    }
+    case "upload-clip": {
+      const result = await client.clips.upload(args.filePath, {
+        brandId: args.brandId,
+        ...args.title ? { title: args.title } : {}
+      });
+      return ok(result);
+    }
+    case "publish-clip": {
+      const body = { mode: args.mode };
+      for (const k of ["candidateId", "text", "brandSlug", "scheduledAt", "aspectRatio"]) {
+        if (args[k] !== void 0) body[k] = args[k];
+      }
+      if (args.platforms !== void 0) body.platforms = parsePlatforms2(args.platforms);
+      return ok(await client.request("POST", `/clips/${encodeURIComponent(args.id)}/publish`, body));
+    }
     case "delete-clip": {
       await client.clips.remove(args.id);
       return ok({ deleted: true, id: args.id });
@@ -1698,6 +2008,31 @@ async function dispatchToolCall(name, args, client) {
       await client.webhooks.test(args.id);
       return ok({ sent: true, id: args.id });
     }
+    // Media
+    case "upload-media": {
+      const filePath = args.filePath;
+      const filename = (0, import_node_path4.basename)(filePath);
+      const uploaded = await client.media.upload({
+        data: new Uint8Array(await (0, import_promises2.readFile)(filePath)),
+        filename,
+        contentType: extToMime(filename)
+      });
+      return ok({ url: uploaded.url, type: uploaded.type, ...args.altText ? { altText: args.altText } : {} });
+    }
+    // Any other REST route on the server's allow-list
+    case "list-api-routes": {
+      const prefix = typeof args.prefix === "string" ? args.prefix : "/";
+      const routes = await apiRoutes(client);
+      return ok({ routes: routes.filter((r) => r.split(" ")[1].startsWith(prefix)) });
+    }
+    case "api-request": {
+      const method = String(args.method ?? "").toUpperCase();
+      const path3 = String(args.path ?? "");
+      assertApiRoute(await apiRoutes(client), method, path3);
+      const query = typeof args.query === "object" && args.query ? args.query : void 0;
+      const body = method !== "GET" && method !== "DELETE" && typeof args.body === "object" && args.body ? args.body : void 0;
+      return ok(await client.request(method, path3, body, query));
+    }
     // Billing
     case "billing-status": {
       const result = await client.billing.status();
@@ -1719,10 +2054,14 @@ async function dispatchToolCall(name, args, client) {
       };
   }
 }
-var PLATFORMS, PLATFORM_SET;
+var import_promises2, import_node_path4, PLATFORMS, PLATFORM_SET, routeCache;
 var init_handler = __esm({
   "src/mcp/handler.ts"() {
     "use strict";
+    import_promises2 = require("fs/promises");
+    import_node_path4 = require("path");
+    init_api_routes();
+    init_media_flags();
     PLATFORMS = [
       "x",
       "linkedin",
@@ -1731,6 +2070,7 @@ var init_handler = __esm({
       "youtube"
     ];
     PLATFORM_SET = new Set(PLATFORMS);
+    routeCache = /* @__PURE__ */ new WeakMap();
   }
 });
 
@@ -1769,7 +2109,7 @@ var init_server = __esm({
 });
 
 // src/cli.ts
-var import_commander20 = require("commander");
+var import_commander21 = require("commander");
 init_dist();
 
 // src/commands/agents.ts
@@ -2320,16 +2660,26 @@ async function requestDeviceCode(baseUrl) {
     const text = await res.text().catch(() => res.statusText);
     throw new Error(`Device code request failed (${res.status}): ${text}`);
   }
-  return parseJson(res);
+  const { data } = await parseJson(res);
+  if (!data?.deviceCode || !data.userCode || !data.verificationUri) {
+    throw new Error("Device code response is missing deviceCode, userCode or verificationUri.");
+  }
+  return data;
 }
 async function pollDeviceCode(baseUrl, deviceCode) {
   const url = `${baseUrl}/auth/cli/poll?device_code=${encodeURIComponent(deviceCode)}`;
   const res = await fetchWithTimeout(url);
-  if (!res.ok) {
-    const text = await res.text().catch(() => res.statusText);
-    throw new Error(`Poll request failed (${res.status}): ${text}`);
+  const text = await res.text().catch(() => res.statusText);
+  let body = {};
+  try {
+    body = JSON.parse(text);
+  } catch {
+  }
+  if (res.ok || res.status === 400 && body.status) {
+    if (!body.status) throw new Error(`Poll response (HTTP ${res.status}) has no status.`);
+    return body;
   }
-  return parseJson(res);
+  throw new Error(`Poll request failed (${res.status}): ${text}`);
 }
 
 // src/commands/auth.ts
@@ -2563,125 +2913,7 @@ function createBillingCommand() {
 // src/commands/brands.ts
 var import_commander4 = require("commander");
 init_dist();
-
-// src/lib/media-flags.ts
-var import_node_fs2 = require("fs");
-var VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube"];
-var EXT_TO_MIME = {
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  png: "image/png",
-  gif: "image/gif",
-  webp: "image/webp",
-  mp4: "video/mp4",
-  mov: "video/quicktime",
-  webm: "video/webm"
-};
-function extToMime(filename) {
-  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
-  const mime = EXT_TO_MIME[ext];
-  if (!mime) {
-    throw new Error(
-      `Unsupported file extension ".${ext || "(none)"}" in "${filename}". Supported: ${Object.keys(EXT_TO_MIME).join(", ")}`
-    );
-  }
-  return mime;
-}
-function parsePairs(flag, vals) {
-  const result = {};
-  for (const val of vals) {
-    const eqIdx = val.indexOf("=");
-    if (eqIdx < 1) {
-      throw new Error(`${flag}: expected "platform=value" format, got "${val}"`);
-    }
-    const p = val.slice(0, eqIdx).trim();
-    const v = val.slice(eqIdx + 1);
-    if (!VALID_PLATFORMS.includes(p)) {
-      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
-    }
-    result[p] = v;
-  }
-  return result;
-}
-function parsePlatformMediaPairs(flag, vals) {
-  const result = {};
-  for (const val of vals) {
-    const eqIdx = val.indexOf("=");
-    if (eqIdx < 1) {
-      throw new Error(`${flag}: expected "platform=path[,path...]" format, got "${val}"`);
-    }
-    const p = val.slice(0, eqIdx).trim();
-    const paths = val.slice(eqIdx + 1).split(",").map((s) => s.trim()).filter(Boolean);
-    if (!VALID_PLATFORMS.includes(p)) {
-      throw new Error(`${flag}: unknown platform "${p}". Valid: ${VALID_PLATFORMS.join(", ")}`);
-    }
-    result[p] = paths;
-  }
-  return result;
-}
-function validateMediaExtensions(paths) {
-  for (const p of paths) extToMime(p);
-}
-function validateMediaCount(paths) {
-  if (paths.length > 10) {
-    throw new Error(`--media accepts at most 10 files (received ${paths.length}).`);
-  }
-}
-function validateMediaPaths(paths) {
-  for (const p of paths) {
-    if (!(0, import_node_fs2.existsSync)(p)) {
-      throw new Error(`Media file not found: "${p}"`);
-    }
-  }
-}
-function alignAltText(mediaPaths, altTexts) {
-  if (altTexts.length > mediaPaths.length) {
-    throw new Error(
-      `--alt-text has more values (${altTexts.length}) than --media (${mediaPaths.length}). Alt text aligns to media by index.`
-    );
-  }
-  return mediaPaths.map((_, i) => altTexts[i]);
-}
-function buildYoutubeOptions(opts) {
-  const { ytTitle, ytDescription, ytTags, ytPrivacy, ytCategory, ytMadeForKids } = opts;
-  const o = {};
-  if (ytTitle) o.title = ytTitle;
-  if (ytDescription) o.description = ytDescription;
-  if (ytTags) o.tags = ytTags.split(",").map((t) => t.trim()).filter(Boolean);
-  if (ytPrivacy) o.privacyStatus = ytPrivacy;
-  if (ytCategory) o.categoryId = ytCategory;
-  if (ytMadeForKids !== void 0) o.madeForKids = ytMadeForKids;
-  return Object.keys(o).length > 0 ? o : void 0;
-}
-function buildInstagramOptions(opts) {
-  const { igReel, igShareToFeed, igCoverUrl, igThumbOffsetMs, igCollaborators } = opts;
-  const hasAnyReelFlag = igReel !== void 0 || igShareToFeed !== void 0 || igCoverUrl !== void 0 || igThumbOffsetMs !== void 0 || igCollaborators !== void 0;
-  if (!hasAnyReelFlag) return void 0;
-  const reel = {};
-  if (igShareToFeed !== void 0) reel.shareToFeed = igShareToFeed;
-  if (igCoverUrl) reel.coverUrl = igCoverUrl;
-  if (igThumbOffsetMs !== void 0) {
-    const n = Number(igThumbOffsetMs);
-    if (!Number.isFinite(n) || n < 0) {
-      throw new Error(
-        `--ig-thumb-offset-ms must be a non-negative number (received "${igThumbOffsetMs}")`
-      );
-    }
-    reel.thumbOffsetMs = n;
-  }
-  if (igCollaborators) {
-    reel.collaborators = igCollaborators.split(",").map((s) => s.trim()).filter(Boolean);
-  }
-  return { reel };
-}
-function buildThreadsOptions(opts) {
-  const { threadsReplyTo, threadsReplyControl } = opts;
-  if (!threadsReplyTo && !threadsReplyControl) return void 0;
-  const o = {};
-  if (threadsReplyTo) o.replyToId = threadsReplyTo;
-  if (threadsReplyControl) o.replyControl = threadsReplyControl;
-  return o;
-}
+init_media_flags();
 
 // src/auth/config-store.ts
 var import_node_fs3 = __toESM(require("fs"));
@@ -3118,16 +3350,18 @@ function createClipsCommand() {
       process.exit(resolveExitCode4(err));
     }
   });
-  clips.command("import").description("Import a clip from a URL").requiredOption("--url <url>", "URL of the video to import").option("--name <name>", "Name for the imported clip").action(async (opts, cmd) => {
+  clips.command("import").description("Start AI clipping from a video URL (e.g. a YouTube video)").requiredOption("--url <url>", "URL of the video to import").option("--brand <id>", "Brand ID (auto-picked when the workspace has exactly one brand)").option("--name <name>", "Name for the imported clip").action(async (opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner("Importing clip\u2026");
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
+      const brandId = await resolveBrandId(client, opts.brand);
       const { clipId } = await client.clips.importUrl({
         url: opts.url,
-        ...opts.name ? { name: opts.name } : {}
+        brandId,
+        ...opts.name ? { title: opts.name } : {}
       });
       spinner.stop();
       printer.log({ clipId });
@@ -3137,14 +3371,17 @@ function createClipsCommand() {
       process.exit(resolveExitCode4(err));
     }
   });
-  clips.command("render <id>").description("Trigger rendering for a clip").action(async (id, _opts, cmd) => {
+  clips.command("render <id>").description("Render a clip (uses credits)").option("--candidate <id>", "Render only this candidate").option("--revision <n>", "Clip editRevision (read from the clip when omitted)", (v) => Number(v)).action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner(`Rendering clip "${id}"\u2026`);
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const { jobIds, activeJobIds, reusedJobIds } = await client.clips.render(id);
+      const { jobIds, activeJobIds, reusedJobIds } = await client.clips.render(id, {
+        ...opts.revision !== void 0 ? { editRevision: opts.revision } : {},
+        ...opts.candidate ? { candidateId: opts.candidate } : {}
+      });
       spinner.stop();
       printer.log({ jobIds, activeJobIds, reusedJobIds });
     } catch (err) {
@@ -3153,6 +3390,25 @@ function createClipsCommand() {
       process.exit(resolveExitCode4(err));
     }
   });
+  clips.command("draft <id>").description("Create a draft post from a rendered clip").option("--candidate <id>", "Candidate to use (defaults to the first rendered one)").option("--aspect-ratio <ratio>", "Render format: 9:16, 16:9, 1:1 or 4:5").action(async (id, opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const printer = createPrinter(globals);
+    const spinner = printer.spinner(`Creating draft from clip "${id}"\u2026`);
+    try {
+      const cred = resolveAuth({ apiKey: globals.apiKey });
+      const client = new Autoposting({ apiKey: cred.apiKey });
+      const { postId } = await client.clips.createDraft(id, {
+        ...opts.candidate ? { candidateId: opts.candidate } : {},
+        ...opts.aspectRatio ? { aspectRatio: opts.aspectRatio } : {}
+      });
+      spinner.stop();
+      printer.log({ postId });
+    } catch (err) {
+      spinner.fail();
+      printer.error(err);
+      process.exit(resolveExitCode4(err));
+    }
+  });
   clips.command("delete <id>").description("Delete a clip (requires --force)").option("--force", "Confirm deletion without interactive prompt").action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
@@ -3183,6 +3439,7 @@ init_dist();
 // src/lib/post-create.ts
 var import_promises = __toESM(require("fs/promises"));
 var import_node_path3 = __toESM(require("path"));
+init_media_flags();
 
 // src/lib/account-select.ts
 var VALID_PLATFORMS2 = ["x", "linkedin", "instagram", "threads", "youtube"];
@@ -4640,8 +4897,73 @@ function createConfigCommand() {
   return config;
 }
 
+// src/commands/api.ts
+var import_commander20 = require("commander");
+init_dist();
+init_api_routes();
+function validationError(message) {
+  return Object.assign(new Error(message), { exitCode: EXIT_CODES.VALIDATION_ERROR });
+}
+function collect(value, previous) {
+  return [...previous, value];
+}
+function parseFields(pairs) {
+  const out = {};
+  for (const pair of pairs) {
+    const i = pair.indexOf("=");
+    if (i < 1) throw validationError(`Expected key=value, got "${pair}".`);
+    const raw = pair.slice(i + 1);
+    let value = raw;
+    try {
+      value = JSON.parse(raw);
+    } catch {
+    }
+    out[pair.slice(0, i)] = value;
+  }
+  return out;
+}
+function createApiCommand() {
+  return new import_commander20.Command("api").description("Call any Autoposting REST route on the server allow-list, like `gh api`").argument("[method]", "GET, POST, PUT, PATCH or DELETE").argument("[path]", "Route path, e.g. /clips/abc123/jobs").option("-d, --data <json>", "JSON request body").option("-f, --field <key=value>", "Body field (repeatable)", collect, []).option("-q, --query <key=value>", "Query parameter (repeatable)", collect, []).option("--list [prefix]", "List the routes you may call").action(async (method, path3, opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const printer = createPrinter(globals);
+    try {
+      const cred = resolveAuth({ apiKey: globals.apiKey });
+      let body;
+      if (opts.data !== void 0) {
+        try {
+          body = JSON.parse(opts.data);
+        } catch {
+          throw validationError("--data is not valid JSON.");
+        }
+      }
+      if (opts.field.length > 0) body = { ...body, ...parseFields(opts.field) };
+      const query = opts.query.length > 0 ? parseFields(opts.query) : void 0;
+      const client = new Autoposting({ apiKey: cred.apiKey });
+      const routes = await fetchApiRoutes(client);
+      if (opts.list !== void 0) {
+        const prefix = typeof opts.list === "string" ? opts.list : "/";
+        printer.log(routes.filter((r) => r.split(" ")[1].startsWith(prefix)));
+        return;
+      }
+      if (!method || !path3) throw validationError("Usage: ap api <METHOD> <path>, or ap api --list.");
+      const m = method.toUpperCase();
+      try {
+        assertApiRoute(routes, m, path3);
+      } catch (err) {
+        throw validationError(err.message);
+      }
+      const sendBody = m === "GET" || m === "DELETE" ? void 0 : body;
+      printer.log(await client.request(m, path3, sendBody, query));
+    } catch (err) {
+      printer.error(err);
+      const attached = err.exitCode;
+      process.exit(typeof attached === "number" ? attached : exitCodeFromError(err));
+    }
+  });
+}
+
 // src/cli.ts
-var program = new import_commander20.Command().name("autoposting").description("Autoposting CLI \u2014 manage social media from the terminal").version(VERSION).option("--json", "Output as JSON").option("--quiet", "Suppress spinners and non-essential output").option("--format <type>", "Output format: auto (table on a terminal, JSON when piped), table, json", "auto").option("--jq <expr>", 'Filter JSON output with a minimal jq expression (e.g. ".[].id")').option("--api-key <key>", "API key (overrides env/stored credentials)").option("--no-color", "Disable color output").hook("preAction", (thisCommand) => {
+var program = new import_commander21.Command().name("autoposting").description("Autoposting CLI \u2014 manage social media from the terminal").version(VERSION).option("--json", "Output as JSON").option("--quiet", "Suppress spinners and non-essential output").option("--format <type>", "Output format: auto (table on a terminal, JSON when piped), table, json", "auto").option("--jq <expr>", 'Filter JSON output with a minimal jq expression (e.g. ".[].id")').option("--api-key <key>", "API key (overrides env/stored credentials)").option("--no-color", "Disable color output").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (!opts.color) disableColor();
 });
@@ -4650,6 +4972,7 @@ program.addCommand(createBillingCommand());
 program.addCommand(createBrandsCommand());
 program.addCommand(createCarouselsCommand());
 program.addCommand(createClipsCommand());
+program.addCommand(createApiCommand());
 program.addCommand(createPostsCommand());
 program.addCommand(createAgentsCommand());
 program.addCommand(createKbCommand());