@jclvsh/dropspace 2.30.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/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/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/package.json

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