@autoposting.ai/cli 0.3.6 → 0.4.1

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.6";
+    VERSION = "0.4.1";
     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);
@@ -663,6 +663,131 @@ 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 MEDIA_ITEMS, ALL_TOOLS;
 var init_tools = __esm({
@@ -671,7 +796,7 @@ var init_tools = __esm({
     MEDIA_ITEMS = {
       type: "array",
       maxItems: 10,
-      description: "Images or videos to attach, as public https URLs. To attach a local file, use `ap posts create --media <file>` instead.",
+      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: {
@@ -1041,9 +1166,10 @@ var init_tools = __esm({
         inputSchema: {
           type: "object",
           properties: {
-            name: { type: "string", description: "Knowledge base name" }
+            name: { type: "string", minLength: 4, maxLength: 20, description: "Knowledge base name" },
+            description: { type: "string", minLength: 20, maxLength: 500, description: "Knowledge base description" }
           },
-          required: ["name"],
+          required: ["name", "description"],
           additionalProperties: false
         }
       },
@@ -1221,6 +1347,39 @@ var init_tools = __esm({
           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.",
@@ -1233,6 +1392,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",
@@ -1415,6 +1613,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) }] };
@@ -1434,6 +1666,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());
@@ -1598,7 +1839,7 @@ async function dispatchToolCall(name, args, client) {
       return ok(result);
     }
     case "create-kb": {
-      const result = await client.kb.create({ name: args.name });
+      const result = await client.kb.create({ name: args.name, description: args.description });
       return ok(result);
     }
     case "delete-kb": {
@@ -1685,6 +1926,21 @@ async function dispatchToolCall(name, args, client) {
       });
       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 });
@@ -1753,6 +2009,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();
@@ -1774,10 +2055,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",
@@ -1786,6 +2071,7 @@ var init_handler = __esm({
       "youtube"
     ];
     PLATFORM_SET = new Set(PLATFORMS);
+    routeCache = /* @__PURE__ */ new WeakMap();
   }
 });
 
@@ -1824,7 +2110,7 @@ var init_server = __esm({
 });
 
 // src/cli.ts
-var import_commander20 = require("commander");
+var import_commander21 = require("commander");
 init_dist();
 
 // src/commands/agents.ts
@@ -2375,16 +2661,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
@@ -2618,125 +2914,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"));
@@ -3262,6 +3440,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"];
@@ -3935,14 +4114,14 @@ function createKbCommand() {
       process.exit(resolveExitCode6(err));
     }
   });
-  kb.command("create").description("Create a new knowledge base").requiredOption("--name <name>", "Knowledge base name").action(async (opts, cmd) => {
+  kb.command("create").description("Create a new knowledge base").requiredOption("--name <name>", "Knowledge base name").requiredOption("--description <description>", "Knowledge base description (20\u2013500 characters)").action(async (opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner("Creating knowledge base\u2026");
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const result = await client.kb.create({ name: opts.name });
+      const result = await client.kb.create({ name: opts.name, description: opts.description });
       spinner.stop();
       printer.log(result);
     } catch (err) {
@@ -4719,8 +4898,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();
 });
@@ -4729,6 +4973,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());