@jclvsh/dropspace 2.29.0 → 2.31.0

package/dist/commands/autopilot.js

@@ -31,6 +31,7 @@ export function registerAutopilotCommands(program, client) {
         .option("--timezone <tz>", "IANA timezone, e.g. America/New_York")
         .option("--product-url <url>", "product link included in posts")
         .option("--product-image <url>", "slideshow reference image (\"none\" clears it)")
+        .option("--media-source <source>", "ai | library | mixed: where image and video posts get media")
         .option("--brief <text>", "product brief (what you're building, who it's for)")
         .option("--pillars <list>", "comma-separated content pillars")
         .option("--min-queue <n>", "ideas to keep queued (1-30)")
@@ -78,6 +79,8 @@ export function registerAutopilotCommands(program, client) {
                 body.timezone = opts.timezone;
             if (opts.productUrl)
                 body.product_url = opts.productUrl;
+            if (opts.mediaSource)
+                body.media_source = opts.mediaSource;
             if (opts.productImage)
                 body.product_image_url = opts.productImage === "none" ? null : opts.productImage;
             if (opts.brief)

package/dist/commands/boosts.js

@@ -8,7 +8,8 @@ export function registerBoostCommands(program, client) {
         .requiredOption("-b, --daily-budget-cents <n>", "daily budget in cents (100 - 10000 = $1 - $100)")
         .requiredOption("-d, --duration-days <n>", "campaign duration in days (1 - 7)")
         .option("--platform <platform>", "ad platform: facebook | instagram", "facebook")
-        .option("--objective <objective>", "campaign objective (phase 1: engagement)", "engagement")
+        .option("--objective <objective>", "engagement | traffic (link clicks, facebook posts only)", "engagement")
+        .option("--max-cpc-cents <n>", "pause when the average cost per click passes this many cents")
         .option("--ad-account-id <id>", "explicit meta ad account id (e.g. 'act_123'); defaults to the first active one")
         .action(async (opts) => {
         try {
@@ -20,6 +21,8 @@ export function registerBoostCommands(program, client) {
             };
             if (opts.adAccountId)
                 body.ad_account_id = opts.adAccountId;
+            if (opts.maxCpcCents)
+                body.stop_rules = { max_cpc_cents: parseInt(opts.maxCpcCents, 10) };
             const result = await client.post(`/launches/${opts.launchId}/boost`, body);
             formatOutput(result, getFormat(program.opts()));
         }

package/dist/commands/media.js

@@ -60,4 +60,65 @@ export function registerMediaCommands(program, client) {
             handleError(error);
         }
     });
+    const library = media.command("library").description("your own photos and videos for autopilot to post");
+    library
+        .command("list")
+        .description("list media library items")
+        .option("-p, --page <n>", "page number", "1")
+        .option("-s, --page-size <n>", "items per page (max 100)", "50")
+        .action(async (opts) => {
+        try {
+            const result = await client.get("/media-library", { page: opts.page, page_size: opts.pageSize });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    library
+        .command("add <url>")
+        .description("add a photo or video by public URL")
+        .requiredOption("-t, --type <type>", "image or video")
+        .option("-d, --description <text>", "what it shows (autopilot chooses media by this)")
+        .option("--thumbnail <url>", "video thumbnail URL")
+        .action(async (url, opts) => {
+        try {
+            const item = { url, type: opts.type };
+            if (opts.description)
+                item.description = opts.description;
+            if (opts.thumbnail)
+                item.thumbnail_url = opts.thumbnail;
+            const result = await client.post("/media-library", { items: [item] });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    library
+        .command("describe <id> <description>")
+        .description("set what a library item shows (\"none\" clears it)")
+        .action(async (id, description) => {
+        try {
+            const result = await client.patch(`/media-library/${id}`, {
+                description: description === "none" ? null : description,
+            });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    library
+        .command("delete <id>")
+        .description("remove an item from the library")
+        .action(async (id) => {
+        try {
+            await client.delete(`/media-library/${id}`);
+            formatOutput({ id, deleted: true }, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
 }

package/dist/tool-policy.js

@@ -74,6 +74,13 @@ export const TOOL_POLICY = {
     // media
     generate_media: hosted("media", "write"),
     get_media_job: hosted("media", "read"),
+    // stdio only for now: the hosted set is pinned to what was submitted to Meta on 10/13/2026
+    // (__tests__/hosted.test.ts). Move these to hosted() once that review settles.
+    list_media_library: localOnly("media", "read"),
+    add_to_media_library: localOnly("media", "write"),
+    update_media_library_item: localOnly("media", "write"),
+    // removing an item changes what autopilot posts, but nothing published is touched
+    delete_media_library_item: localOnly("media", "write"),
     // connections
     list_connections: hosted("connections", "read"),
     // edits the profile ON the platform (youtube channel description)

package/dist/tools/autopilot.js

@@ -42,6 +42,10 @@ export function registerAutopilotTools(server, client) {
         run_hour: z.number().int().min(0).max(23).optional().describe("local hour the nightly run fires"),
         timezone: z.string().optional().describe("IANA timezone, e.g. America/New_York"),
         product_url: z.string().nullable().optional().describe("product link included in posts"),
+        media_source: z
+            .enum(["ai", "library", "mixed"])
+            .optional()
+            .describe("where image and video posts get media: ai (generated), library (only the user's media library), mixed (library first, AI when nothing fits)"),
         product_image_url: z
             .string()
             .nullable()

package/dist/tools/boosts.d.ts

@@ -1,7 +1,7 @@
 /**
  * Launch boost MCP tools — paid amplification of organic Facebook launches.
  *
- * Phase 1: facebook only, engagement objective, auto-targeting. API key auth.
+ * Engagement or traffic objective, optional cost-per-click stop rule, auto-targeting. API key auth.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { DropspaceClient } from "../client.js";

package/dist/tools/boosts.js

@@ -1,13 +1,15 @@
 /**
  * Launch boost MCP tools — paid amplification of organic Facebook launches.
  *
- * Phase 1: facebook only, engagement objective, auto-targeting. API key auth.
+ * Engagement or traffic objective, optional cost-per-click stop rule, auto-targeting. API key auth.
  */
 import { z } from "zod";
 const platformSchema = z
     .enum(["facebook", "instagram"])
     .describe("ad platform — facebook or instagram (IG boost requires the IG business account linked to one of the user's facebook pages)");
-const objectiveSchema = z.literal("engagement").describe("campaign objective (phase 1: engagement only)");
+const objectiveSchema = z
+    .enum(["engagement", "traffic"])
+    .describe("engagement optimizes for reactions on the post; traffic optimizes for clicks on the link of a facebook link post (no photos or video)");
 const launchIdParam = z.string().uuid().describe("launch ID to boost — must have a successful facebook post");
 const boostIdParam = z.string().uuid().describe("boost ID");
 export function registerBoostTools(server, client) {
@@ -26,6 +28,13 @@ export function registerBoostTools(server, client) {
             .string()
             .optional()
             .describe("explicit meta ad account id (e.g. 'act_123'). defaults to the first active ad account."),
+        max_cpc_cents: z
+            .number()
+            .int()
+            .min(10)
+            .max(10000)
+            .optional()
+            .describe("pause the boost when its average cost per click passes this many cents. it also always pauses when click-through falls below half its first day"),
     }, async (args) => {
         try {
             const result = await client.post(`/launches/${args.launch_id}/boost`, {
@@ -34,6 +43,7 @@ export function registerBoostTools(server, client) {
                 duration_days: args.duration_days,
                 objective: args.objective ?? "engagement",
                 ...(args.ad_account_id ? { ad_account_id: args.ad_account_id } : {}),
+                ...(args.max_cpc_cents ? { stop_rules: { max_cpc_cents: args.max_cpc_cents } } : {}),
             });
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }

package/dist/tools/media.js

@@ -84,4 +84,65 @@ export function registerMediaTools(server, client) {
             };
         }
     });
+    const text = (value) => ({ content: [{ type: "text", text: JSON.stringify(value, null, 2) }] });
+    const fail = (error) => ({
+        content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+        isError: true,
+    });
+    server.tool("list_media_library", "list the user's media library: their own photos and videos that autopilot can post (when autopilot's media_source is library or mixed). Each item's description is what autopilot reads to choose it.", {
+        page: z.number().int().min(1).optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+    }, async (args) => {
+        try {
+            const params = {};
+            if (args.page)
+                params.page = String(args.page);
+            if (args.page_size)
+                params.page_size = String(args.page_size);
+            return text(await client.get("/media-library", params));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("add_to_media_library", "add photos or videos to the user's media library by public URL (up to 20 at once; a URL already in the library is skipped). Give each a description of what it shows - autopilot chooses media by it; images without one are captioned automatically on autopilot's next run, videos need one.", {
+        items: z
+            .array(z.object({
+            url: z.string().url().describe("public http(s) URL of the image or video"),
+            type: z.enum(["image", "video"]),
+            description: z.string().max(500).optional().describe("what the media shows"),
+            thumbnail_url: z.string().url().optional().describe("video thumbnail (lets autopilot caption it)"),
+            mime_type: z.string().optional(),
+            filename: z.string().optional(),
+        }))
+            .min(1)
+            .max(20),
+    }, async (args) => {
+        try {
+            return text(await client.post("/media-library", args));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("update_media_library_item", "set the description of a media library item (what it shows; autopilot reads it to choose media). null clears it.", {
+        id: z.string().uuid().describe("media library item ID"),
+        description: z.string().max(500).nullable(),
+    }, async (args) => {
+        try {
+            return text(await client.patch(`/media-library/${args.id}`, { description: args.description }));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("delete_media_library_item", "remove an item from the user's media library so autopilot stops using it. Launches that already posted it keep their media.", { id: z.string().uuid().describe("media library item ID") }, async (args) => {
+        try {
+            await client.delete(`/media-library/${args.id}`);
+            return text({ id: args.id, deleted: true });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
 }

package/dist/types.d.ts

@@ -325,7 +325,7 @@ export interface Boost {
     platform: "facebook" | "instagram";
     post_id: string;
     status: "paused" | "active" | "completed" | "failed" | "canceled";
-    objective: "engagement";
+    objective: "engagement" | "traffic";
     daily_budget_cents: number;
     duration_days: number;
     meta_ad_account_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/dropspace",
-	"version": "2.29.0",
+	"version": "2.31.0",
 	"description": "MCP server and CLI for the Dropspace API",
 	"repository": {
 		"type": "git",