@autoposting.ai/cli 0.3.5 → 0.3.6

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.3.6";
     AutopostingError = class extends Error {
       status;
       code;
@@ -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}`);
@@ -656,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
       {
@@ -707,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
@@ -715,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
@@ -1156,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
@@ -1424,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);
     }
@@ -1434,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);
     }
@@ -1622,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": {
@@ -3118,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 });
@@ -3137,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) {
@@ -3153,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);