@jclvsh/dropspace 2.49.0 → 2.51.0

package/README.md

@@ -61,6 +61,9 @@ dropspace launches --help
 | audience               | follower counts + growth per connected account                                                                                                                                                                         |
 | autopilot              | status, configure, review, approve, reject, run, runs                                                                                                                                                                  |
 | recommendations (recs) | list, apply, dismiss                                                                                                                                                                                                   |
+| songs                  | list, get, add, lyrics, rename, retry, delete                                                                                                                                                                          |
+| song-reels             | make, list, get, retry, launch, delete                                                                                                                                                                                 |
+| scene-clips            | cut, list, get, retry, delete                                                                                                                                                                                          |
 | profile                | get, update                                                                                                                                                                                                            |
 | billing                | portal                                                                                                                                                                                                                 |
 
@@ -394,6 +397,16 @@ Reddit engagement (drafted comments in other communities) is paused: its tools a
 | `add_song` | Add a song from a YouTube or SoundCloud link, or a public audio file url (local package only) |
 | `get_song_lyrics` | The song's lyrics with word timings, transcribed once (local package only) |
 | `delete_song` | Delete a song and its audio file (local package only) |
+| `make_song_reel` | Make a 9:16 lyric reel from a snippet of a song: clips from the media library or a gradient, lyrics burned in (local package only) |
+| `list_song_reels` | Lyric reels, newest first, with render status and video_url once ready (local package only) |
+| `get_song_reel` | One reel with its lyric lines (local package only) |
+| `launch_song_reel` | A draft launch carrying a ready reel and its lyrics as the caption (local package only) |
+| `delete_song_reel` | Delete a reel; its media library item and launch stay (local package only) |
+| `cut_scene_clips` | Cut a long video (a media library video, a YouTube link, or a public video url) into 2-8 second clips at its scene changes, up to 40, into the media library (local package only) |
+| `list_scene_clip_jobs` | Clip jobs, newest first, with status, clips made and added, and each clip's urls (local package only) |
+| `get_scene_clip_job` | One clip job; reading a ready job adds its clips to the media library (local package only) |
+| `retry_scene_clip_job` | Cut a failed or stuck job again (local package only) |
+| `delete_scene_clip_job` | Delete a clip job; clips already in the media library stay (local package only) |
 
 Prompts (local package only): `instagram_audit`, `best_times_plan`, `winners_report`. Each tells the AI app which tools to call and ends with `save_report`.
 

package/dist/cli.js

@@ -20,6 +20,8 @@ import { registerRecommendationCommands } from "./commands/recommendations.js";
 import { registerAudienceCommands } from "./commands/audience.js";
 import { registerAccountCommands } from "./commands/account.js";
 import { registerSongCommands } from "./commands/songs.js";
+import { registerSongReelCommands } from "./commands/song-reels.js";
+import { registerSceneClipCommands } from "./commands/scene-clips.js";
 const program = new Command()
     .name("dropspace")
     .description("dropspace CLI - manage launches, personas, boosts, and more")
@@ -44,6 +46,8 @@ try {
     registerRedditCommands(program, client);
     registerAccountCommands(program, client);
     registerSongCommands(program, client);
+    registerSongReelCommands(program, client);
+    registerSceneClipCommands(program, client);
     await program.parseAsync(process.argv);
 }
 catch (error) {

package/dist/commands/scene-clips.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { DropspaceClient } from "../client.js";
+export declare function registerSceneClipCommands(program: Command, client: DropspaceClient): void;

package/dist/commands/scene-clips.js

@@ -0,0 +1,79 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerSceneClipCommands(program, client) {
+    const clips = program
+        .command("scene-clips")
+        .description("cut a long video into short clips for your media library (pro and premium)");
+    clips
+        .command("cut")
+        .description("start a job: give one of --media, --link, or --url")
+        .option("--media <id>", "a video in your media library")
+        .option("--link <url>", "a YouTube link (up to 30 minutes)")
+        .option("--url <url>", "a public video file url (up to 512 MB)")
+        .action(async (opts) => {
+        try {
+            const body = {};
+            if (opts.media)
+                body.media_library_id = opts.media;
+            if (opts.link)
+                body.link_url = opts.link;
+            if (opts.url)
+                body.video_url = opts.url;
+            formatOutput(await client.post("/scene-clips", body), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    clips
+        .command("list")
+        .description("your clip jobs, newest first")
+        .option("--page <n>", "page number")
+        .option("--page-size <n>", "jobs per page (max 100)")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            formatOutput(await client.get("/scene-clips", params), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    clips
+        .command("get <id>")
+        .description("one job; reading a ready job adds its clips to your media library")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.get(`/scene-clips/${id}`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    clips
+        .command("retry <id>")
+        .description("cut a failed (or stuck) job again")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.post(`/scene-clips/${id}/retry`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    clips
+        .command("delete <id>")
+        .description("delete a job; clips already in your media library stay")
+        .action(async (id) => {
+        try {
+            await client.delete(`/scene-clips/${id}`);
+            formatOutput({ id, deleted: true }, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/song-reels.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { DropspaceClient } from "../client.js";
+export declare function registerSongReelCommands(program: Command, client: DropspaceClient): void;

package/dist/commands/song-reels.js

@@ -0,0 +1,95 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerSongReelCommands(program, client) {
+    const reels = program.command("song-reels").description("lyric reels made from your songs (pro and premium)");
+    reels
+        .command("make <songId>")
+        .description("make a lyric reel from a snippet of a ready song")
+        .requiredOption("--start <seconds>", "snippet start, seconds from the song's start")
+        .requiredOption("--end <seconds>", "snippet end, 5 to 30 seconds after the start")
+        .option("--style <style>", "lower-third, center-bold, karaoke, one-word, or caps-top", "lower-third")
+        .option("--clips <ids>", "media library ids in order, comma separated (footage from your library)")
+        .option("--background <name>", "midnight, sunset, forest, sand, slate, or violet (no footage)")
+        .action(async (songId, opts) => {
+        try {
+            const body = {
+                snippet_start: Number(opts.start),
+                snippet_end: Number(opts.end),
+                style: opts.style,
+                footage_mode: opts.clips ? "clips" : "none",
+            };
+            if (opts.clips)
+                body.clip_ids = String(opts.clips).split(",").map((id) => id.trim()).filter(Boolean);
+            if (opts.background)
+                body.background = opts.background;
+            formatOutput(await client.post(`/songs/${songId}/reels`, body), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    reels
+        .command("list")
+        .description("your lyric reels, newest first")
+        .option("--song <id>", "only this song's reels")
+        .option("--page <n>", "page number")
+        .option("--page-size <n>", "reels per page (max 100)")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.song)
+                params.song_id = opts.song;
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            formatOutput(await client.get("/song-reels", params), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    reels
+        .command("get <id>")
+        .description("one reel, with its lyric lines")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.get(`/song-reels/${id}`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    reels
+        .command("retry <id>")
+        .description("render a failed reel again")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.post(`/song-reels/${id}/retry`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    reels
+        .command("launch <id>")
+        .description("make a draft launch from a ready reel")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.post(`/song-reels/${id}/launch`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    reels
+        .command("delete <id>")
+        .description("delete a reel (its media library item and launch stay)")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.delete(`/song-reels/${id}`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/server.js

@@ -20,6 +20,8 @@ import { registerAccountTools } from "./tools/account.js";
 import { registerTrialReelTools } from "./tools/trial-reels.js";
 import { registerReportTools, registerWorkflowPrompts } from "./tools/reports.js";
 import { registerSongTools } from "./tools/songs.js";
+import { registerSongReelTools } from "./tools/song-reels.js";
+import { registerSceneClipTools } from "./tools/scene-clips.js";
 /** Drops tools whose feature is paused before the policy registrar sees them (see PAUSED_TOOLS). */
 function skipPausedTools(registrar) {
     return {
@@ -52,6 +54,8 @@ export function createDropspaceServer({ client, version, profile }) {
     registerTrialReelTools(registrar, client);
     registerReportTools(registrar, client);
     registerSongTools(registrar, client);
+    registerSongReelTools(registrar, client);
+    registerSceneClipTools(registrar, client);
     // Prompts are not tools, so the policy registrar does not filter them: the hosted profile
     // (frozen for the Meta review) gets none.
     if (profile === "full")

package/dist/tool-policy.js

@@ -142,6 +142,18 @@ const FULL_TOOL_POLICY = {
     add_song: localOnly("media", "write"),
     get_song_lyrics: localOnly("media", "read"),
     delete_song: localOnly("media", "write"),
+    // lyric reels: a render spends the plan's quota; a launch is a draft the user still publishes
+    make_song_reel: localOnly("media", "write"),
+    list_song_reels: localOnly("media", "read"),
+    get_song_reel: localOnly("media", "read"),
+    launch_song_reel: localOnly("media", "write"),
+    delete_song_reel: localOnly("media", "write"),
+    // scene clips: a job spends server minutes and adds up to 40 items to the media library
+    cut_scene_clips: localOnly("media", "write"),
+    list_scene_clip_jobs: localOnly("media", "read"),
+    get_scene_clip_job: localOnly("media", "read"),
+    retry_scene_clip_job: localOnly("media", "write"),
+    delete_scene_clip_job: localOnly("media", "write"),
     get_usage: hosted("usage", "read"),
     get_changelog: hosted("usage", "read"),
     get_dropspace_status: hosted("dropspace", "read"),

package/dist/tools/scene-clips.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DropspaceClient } from "../client.js";
+/** Scene clips: a long video cut into short clips for the media library (pro and premium). Local package only. */
+export declare function registerSceneClipTools(server: McpServer, client: DropspaceClient): void;

package/dist/tools/scene-clips.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+function text(result) {
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+function fail(error) {
+    return {
+        content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+        isError: true,
+    };
+}
+/** Scene clips: a long video cut into short clips for the media library (pro and premium). Local package only. */
+export function registerSceneClipTools(server, client) {
+    server.tool("cut_scene_clips", "cut a long video into 2 to 8 second clips at its scene changes, up to 40 a job, each with a thumbnail, for the user's media library (footage for make_song_reel and autopilot). give exactly one source: media_library_id (a video from list_media_library), link_url (a YouTube link, up to 30 minutes), or video_url (a public mp4 or mov url, up to 512 MB). only the first 15 minutes are scanned. the work runs on the server: the job comes back pending; read it with get_scene_clip_job until ready (the clips are added to the media library then, source scene) or failed (error). pro and premium; at most 10 jobs a day and one running at a time.", {
+        media_library_id: z.string().uuid().optional().describe("a video in the media library"),
+        link_url: z.string().url().optional().describe("a YouTube link"),
+        video_url: z.string().url().optional().describe("a public video file url"),
+    }, async (body) => {
+        try {
+            return text(await client.post("/scene-clips", body));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("list_scene_clip_jobs", "the user's clip jobs, newest first: id, source (library, link, url), source_title, status (pending, running, ready, or failed with error), clips_made, clips_added (in the media library), clips (start, end, video_url, thumbnail_url, media_library_id), and a note when clips are waiting for room in the library.", {
+        page: z.number().int().min(1).optional(),
+        page_size: z.number().int().min(1).max(100).optional(),
+    }, async ({ page, page_size }) => {
+        try {
+            const params = {};
+            if (page)
+                params.page = String(page);
+            if (page_size)
+                params.page_size = String(page_size);
+            return text(await client.get("/scene-clips", params));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("get_scene_clip_job", "one clip job. reading a ready job adds its clips to the media library (as many as fit under the 500-item cap; the rest on a later read).", { job_id: z.string().uuid() }, async ({ job_id }) => {
+        try {
+            return text(await client.get(`/scene-clips/${job_id}`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("retry_scene_clip_job", "cut a failed (or stuck) clip job again. three attempts in all.", { job_id: z.string().uuid() }, async ({ job_id }) => {
+        try {
+            return text(await client.post(`/scene-clips/${job_id}/retry`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("delete_scene_clip_job", "delete a clip job. clips already in the media library stay (delete_media_library_item removes one).", { job_id: z.string().uuid() }, async ({ job_id }) => {
+        try {
+            await client.delete(`/scene-clips/${job_id}`);
+            return text({ id: job_id, deleted: true });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}

package/dist/tools/song-reels.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DropspaceClient } from "../client.js";
+/** Lyric reels made from songs (pro and premium). Local package only. */
+export declare function registerSongReelTools(server: McpServer, client: DropspaceClient): void;

package/dist/tools/song-reels.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+function text(result) {
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+function fail(error) {
+    return {
+        content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+        isError: true,
+    };
+}
+const STYLES = ["lower-third", "center-bold", "karaoke", "one-word", "caps-top"];
+const BACKGROUNDS = ["midnight", "sunset", "forest", "sand", "slate", "violet"];
+/** Lyric reels made from songs (pro and premium). Local package only. */
+export function registerSongReelTools(server, client) {
+    server.tool("make_song_reel", "make a 9:16 lyric reel from a snippet of a ready song (get_song for its duration and peaks): 5 to 30 seconds of the song under footage, with the lyrics inside the snippet burned in. footage_mode clips uses the user's media library videos and images (clip_ids from list_media_library, in order; the clip changes at lyric lines, skipping cuts closer than 1.5 s apart); none puts the lyrics over a gradient (background). the lyrics are read from the song on the first reel (takes up to a minute). the render runs on the server: the reel comes back pending; read it with get_song_reel until ready (video_url, and it is in the media library) or failed. counts against the plan's song reels per billing period (pro 30, premium 100; a rendered reel keeps its slot even when deleted).", {
+        song_id: z.string().uuid(),
+        snippet_start: z.number().min(0).describe("seconds from the start of the song"),
+        snippet_end: z.number().positive().describe("5 to 30 seconds after snippet_start"),
+        style: z.enum(STYLES).describe("how the lyrics look: lower-third, center-bold, karaoke (word by word), one-word, caps-top"),
+        footage_mode: z.enum(["clips", "none"]),
+        clip_ids: z.array(z.string().uuid()).max(20).optional().describe("media library ids, in order (footage_mode clips)"),
+        background: z.enum(BACKGROUNDS).optional().describe("the gradient (footage_mode none); midnight unless given"),
+    }, async ({ song_id, ...body }) => {
+        try {
+            return text(await client.post(`/songs/${song_id}/reels`, body));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("list_song_reels", "the user's lyric reels, newest first: id, song_id, title, snippet, style, footage_mode, render_status (pending, running, ready, or failed with render_error), video_url and thumbnail_url once ready, media_library_id, launch_id. song_id narrows to one song.", {
+        song_id: z.string().uuid().optional(),
+        page: z.number().int().min(1).optional(),
+        page_size: z.number().int().min(1).max(100).optional(),
+    }, async ({ song_id, page, page_size }) => {
+        try {
+            const params = {};
+            if (song_id)
+                params.song_id = song_id;
+            if (page)
+                params.page = String(page);
+            if (page_size)
+                params.page_size = String(page_size);
+            return text(await client.get("/song-reels", params));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("get_song_reel", "one lyric reel: everything list_song_reels shows plus its lines (the lyric lines inside the snippet with their timing).", { reel_id: z.string().uuid() }, async ({ reel_id }) => {
+        try {
+            return text(await client.get(`/song-reels/${reel_id}`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("launch_song_reel", "make a draft launch from a ready reel: the reel is its video and the snippet's lyrics its instagram caption. the launch stays a draft until the user (or update_launch + publish) sets platforms, caption, and timing, and it counts as one of the plan's launches. returns the reel with launch_id.", { reel_id: z.string().uuid() }, async ({ reel_id }) => {
+        try {
+            return text(await client.post(`/song-reels/${reel_id}/launch`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("delete_song_reel", "delete a lyric reel. its media library item and any launch made from it stay.", { reel_id: z.string().uuid() }, async ({ reel_id }) => {
+        try {
+            await client.delete(`/song-reels/${reel_id}`);
+            return text({ id: reel_id, deleted: true });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}

package/package.json

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