@autoposting.ai/cli 0.3.4 → 0.3.6

package/dist/cli.cjs

@@ -42,11 +42,44 @@ function createError(status, body) {
   if (status >= 500) return new ServerError(message, status, code);
   return new AutopostingError(message, status, code);
 }
-var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, ValidationError, RateLimitError, ServerError, Resource, MediaResource, AgentsResource, BillingResource, BrandsResource, CarouselsResource, ClipsResource, PostsResource, KbResource, IdeasResource, UsageResource, WebhooksResource, WorkspacesResource, IDEMPOTENT_METHODS, RETRYABLE_STATUS, sleep, Autoposting;
+function resolvePartSize(fileSize, requested) {
+  let size = requested && requested > 0 ? requested : DEFAULT_PART_SIZE;
+  if (Math.ceil(fileSize / size) > MAX_PARTS) size = Math.ceil(fileSize / MAX_PARTS);
+  return Math.max(size, MIN_PART_SIZE);
+}
+function guessVideoMime(fileName) {
+  const ext = fileName.split(".").pop()?.toLowerCase() ?? "";
+  return VIDEO_MIME[ext] ?? "video/mp4";
+}
+async function putPart(url, body) {
+  let res;
+  try {
+    res = await fetch(url, { method: "PUT", body });
+  } catch (err) {
+    throw new AutopostingError(
+      `Failed to upload part: ${err instanceof Error ? err.message : String(err)}`,
+      0,
+      "UPLOAD_FAILED"
+    );
+  }
+  if (!res.ok) {
+    throw new AutopostingError(
+      `Failed to upload part: HTTP ${res.status} ${res.statusText}`,
+      res.status,
+      "UPLOAD_FAILED"
+    );
+  }
+  const etag = res.headers.get("etag");
+  if (!etag) {
+    throw new AutopostingError("Upload part response is missing the ETag header.", res.status, "UPLOAD_FAILED");
+  }
+  return etag;
+}
+var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, ValidationError, RateLimitError, ServerError, Resource, MediaResource, AgentsResource, BillingResource, BrandsResource, CarouselsResource, MIN_PART_SIZE, DEFAULT_PART_SIZE, MAX_PARTS, VIDEO_MIME, ClipsResource, PostsResource, KbResource, IdeasResource, UsageResource, WebhooksResource, WorkspacesResource, IDEMPOTENT_METHODS, RETRYABLE_STATUS, sleep, Autoposting;
 var init_dist = __esm({
   "../sdk/dist/index.mjs"() {
     "use strict";
-    VERSION = "0.3.4";
+    VERSION = "0.3.6";
     AutopostingError = class extends Error {
       status;
       code;
@@ -180,6 +213,17 @@ var init_dist = __esm({
         return this.client.request("DELETE", `/carousels/${id}`);
       }
     };
+    MIN_PART_SIZE = 5 * 1024 * 1024;
+    DEFAULT_PART_SIZE = 16 * 1024 * 1024;
+    MAX_PARTS = 1e4;
+    VIDEO_MIME = {
+      mp4: "video/mp4",
+      mov: "video/quicktime",
+      webm: "video/webm",
+      mkv: "video/x-matroska",
+      avi: "video/x-msvideo",
+      m4v: "video/x-m4v"
+    };
     ClipsResource = class extends Resource {
       /** GET /clips — backend returns `{ clips, pagination }`, not a bare array. */
       list() {
@@ -188,24 +232,82 @@ var init_dist = __esm({
       retrieve(id) {
         return this.client.request("GET", `/clips/${id}`);
       }
-      // ponytail: the backend has no single-request /clips/upload; uploading a file means the
-      // multipart init/presign/complete flow (upload-initiate → upload-presign → upload-complete).
-      // That's too much surface for v0.3.1 — fail honestly and point at importUrl. Upgrade path:
-      // implement the init/presign/complete dance here when direct upload is actually needed.
-      async upload(_filePath, _options) {
-        throw new AutopostingError(
-          "Direct clip file upload is not supported by the API yet \u2014 use `importUrl` with a public video URL instead.",
-          0,
-          "NOT_IMPLEMENTED"
+      /**
+       * Upload a local video file as a clip by driving the backend multipart flow:
+       * `init → presign → PUT each part → complete`. On any failure after init, the
+       * multipart upload is aborted so it leaves no dangling clip. Returns the created clip.
+       *
+       * Node-only: reads the file in chunks (memory-bounded for multi-GB videos). `node:fs`
+       * is imported dynamically so the rest of the SDK stays runtime-agnostic.
+       */
+      async upload(filePath, options) {
+        if (!options?.brandId) {
+          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 title = options.title ?? fileName;
+        const mimeType = options.contentType ?? guessVideoMime(fileName);
+        const { size: fileSize } = await stat(filePath);
+        if (fileSize <= 0) {
+          throw new AutopostingError(`File is empty: ${filePath}`, 0, "VALIDATION_ERROR");
+        }
+        const partSize = resolvePartSize(fileSize, options.partSize);
+        const partNumbers = Array.from(
+          { length: Math.max(1, Math.ceil(fileSize / partSize)) },
+          (_, i) => i + 1
         );
+        const { clipId, uploadId, key } = await this.client.request("POST", "/clips/upload/init", { brandId: options.brandId, title, fileName, fileSize, mimeType });
+        let completed;
+        const handle = await open2(filePath, "r");
+        try {
+          const { presignedUrls } = await this.client.request("POST", "/clips/upload/presign", { clipId, uploadId, key, partNumbers });
+          const urlByPart = new Map(presignedUrls.map((p) => [p.partNumber, p.url]));
+          const parts = [];
+          let uploaded = 0;
+          for (const partNumber of partNumbers) {
+            const url = urlByPart.get(partNumber);
+            if (!url) {
+              throw new AutopostingError(`Missing presigned URL for part ${partNumber}.`, 0, "UPLOAD_FAILED");
+            }
+            const offset = (partNumber - 1) * partSize;
+            const length = Math.min(partSize, fileSize - offset);
+            const buffer = Buffer.allocUnsafe(length);
+            await handle.read(buffer, 0, length, offset);
+            parts.push({ partNumber, etag: await putPart(url, buffer) });
+            uploaded += length;
+            options.onProgress?.(Math.round(uploaded / fileSize * 100));
+          }
+          completed = await this.client.request(
+            "POST",
+            "/clips/upload/complete",
+            { clipId, uploadId, key, parts }
+          );
+        } catch (err) {
+          await this.client.request("POST", "/clips/upload/abort", { clipId, uploadId, key }).catch(() => {
+          });
+          throw err;
+        } finally {
+          await handle.close();
+        }
+        return this.retrieve(completed.clipId);
       }
       /** POST /clips/import-url — backend returns `{ clipId }`, not a full Clip. */
       importUrl(params) {
         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}`);
@@ -562,10 +664,25 @@ var init_dist = __esm({
 });
 
 // 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 public https URLs. To attach a local file, use `ap posts create --media <file>` instead.",
+      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
       {
@@ -613,7 +730,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
@@ -621,14 +739,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
@@ -1062,24 +1181,41 @@ 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
@@ -1330,7 +1466,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);
     }
@@ -1340,7 +1477,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);
     }
@@ -1528,12 +1666,23 @@ 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 "delete-clip": {
@@ -2950,6 +3099,17 @@ function resolveExitCode4(err) {
   if (typeof attached === "number") return attached;
   return exitCodeFromError(err);
 }
+async function resolveBrandId(client, explicit) {
+  if (explicit) return explicit;
+  const brands = await client.brands.list();
+  if (brands.length === 1) return brands[0].id;
+  if (brands.length === 0) {
+    throw new Error("No brands found. Create a brand first, then pass --brand <id>.");
+  }
+  throw new Error(
+    `Multiple brands found \u2014 pass --brand <id>. Available: ${brands.map((b) => `${b.name} (${b.id})`).join(", ")}`
+  );
+}
 function createClipsCommand() {
   const clips = new import_commander6.Command("clips").description("Manage video clips");
   clips.command("list").description("List all clips").action(async (_opts, cmd) => {
@@ -2990,15 +3150,17 @@ function createClipsCommand() {
       process.exit(resolveExitCode4(err));
     }
   });
-  clips.command("upload <file>").description("Upload a video file as a clip").option("--name <name>", "Override the clip name (defaults to filename)").action(async (file, opts, cmd) => {
+  clips.command("upload <file>").description("Upload a video file as a clip").option("--brand <id>", "Brand to attach the clip to (defaults to your only brand)").option("--name <name>", "Override the clip title (defaults to filename)").action(async (file, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
     const spinner = printer.spinner("Uploading clip\u2026");
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
+      const brandId = await resolveBrandId(client, opts.brand);
       const clip = await client.clips.upload(file, {
-        name: opts.name,
+        brandId,
+        ...opts.name ? { title: opts.name } : {},
         onProgress: (pct) => {
           if (pct > 0 && pct < 100) spinner.stop();
         }
@@ -3011,16 +3173,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 });
@@ -3030,14 +3194,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) {
@@ -3046,6 +3213,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);