@jclvsh/dropspace 2.48.0 → 2.49.0

package/README.md

@@ -389,6 +389,11 @@ Reddit engagement (drafted comments in other communities) is paused: its tools a
 | `save_report` | Save a markdown report to the user's reports page (local package only) |
 | `list_reports` | Saved reports, newest first, without bodies (local package only) |
 | `get_report` | One report with its markdown body (local package only) |
+| `list_songs` | Your songs for song to reels, newest first (pro and premium; local package only) |
+| `get_song` | One song with its waveform peaks (local package only) |
+| `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) |
 
 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

@@ -19,6 +19,7 @@ import { registerAutopilotCommands } from "./commands/autopilot.js";
 import { registerRecommendationCommands } from "./commands/recommendations.js";
 import { registerAudienceCommands } from "./commands/audience.js";
 import { registerAccountCommands } from "./commands/account.js";
+import { registerSongCommands } from "./commands/songs.js";
 const program = new Command()
     .name("dropspace")
     .description("dropspace CLI - manage launches, personas, boosts, and more")
@@ -42,6 +43,7 @@ try {
     registerRecommendationCommands(program, client);
     registerRedditCommands(program, client);
     registerAccountCommands(program, client);
+    registerSongCommands(program, client);
     await program.parseAsync(process.argv);
 }
 catch (error) {

package/dist/commands/songs.d.ts

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

package/dist/commands/songs.js

@@ -0,0 +1,97 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerSongCommands(program, client) {
+    const songs = program.command("songs").description("your songs for song-to-reels (pro and premium)");
+    songs
+        .command("list")
+        .description("your songs, newest first")
+        .option("--page <n>", "page number")
+        .option("--page-size <n>", "songs 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("/songs", params), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("get <id>")
+        .description("one song, with its waveform peaks")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.get(`/songs/${id}`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("add")
+        .description("add a song from a youtube or soundcloud link, or a public audio file url")
+        .option("--link <url>", "a youtube or soundcloud link")
+        .option("--audio <url>", "a public audio file url (mp3, m4a, wav, aac, flac, ogg)")
+        .option("-t, --title <text>", "the title; the link's or file's name otherwise")
+        .action(async (opts) => {
+        try {
+            if (!opts.link && !opts.audio)
+                throw new Error("give --link or --audio");
+            const body = opts.link ? { link_url: opts.link } : { audio_url: opts.audio };
+            if (opts.title)
+                body.title = opts.title;
+            formatOutput(await client.post("/songs", body), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("lyrics <id>")
+        .description("the song's lyrics with word timings (transcribed on first request)")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.get(`/songs/${id}/lyrics`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("rename <id>")
+        .description("rename a song")
+        .requiredOption("-t, --title <text>", "the new title")
+        .action(async (id, opts) => {
+        try {
+            formatOutput(await client.patch(`/songs/${id}`, { title: opts.title }), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("retry <id>")
+        .description("run a failed import again")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.post(`/songs/${id}/retry`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    songs
+        .command("delete <id>")
+        .description("delete a song and its audio file")
+        .action(async (id) => {
+        try {
+            formatOutput(await client.delete(`/songs/${id}`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/server.js

@@ -19,6 +19,7 @@ import { registerCommentTools } from "./tools/comments.js";
 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";
 /** Drops tools whose feature is paused before the policy registrar sees them (see PAUSED_TOOLS). */
 function skipPausedTools(registrar) {
     return {
@@ -50,6 +51,7 @@ export function createDropspaceServer({ client, version, profile }) {
     registerAccountTools(registrar, client);
     registerTrialReelTools(registrar, client);
     registerReportTools(registrar, client);
+    registerSongTools(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

@@ -136,6 +136,12 @@ const FULL_TOOL_POLICY = {
     save_report: localOnly("account", "write"),
     list_reports: localOnly("account", "read"),
     get_report: localOnly("account", "read"),
+    // songs (song to reels): local-only while the hosted set is frozen for the Meta review
+    list_songs: localOnly("media", "read"),
+    get_song: localOnly("media", "read"),
+    add_song: localOnly("media", "write"),
+    get_song_lyrics: localOnly("media", "read"),
+    delete_song: localOnly("media", "write"),
     get_usage: hosted("usage", "read"),
     get_changelog: hosted("usage", "read"),
     get_dropspace_status: hosted("dropspace", "read"),

package/dist/tools/songs.d.ts

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

package/dist/tools/songs.js

@@ -0,0 +1,71 @@
+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,
+    };
+}
+/** Songs for song-to-reels (pro and premium). Local package only. */
+export function registerSongTools(server, client) {
+    server.tool("list_songs", "the user's songs, newest first: id, title, source (upload, link, or url), source_url (the link or audio url it came from), status (pending while the audio is fetched and converted, ready, or failed with error), duration_seconds, size_bytes, audio_url once ready, lyrics_status (none until lyrics are first requested, ready, or failed), created_at. at most 100 songs per user. pro and premium plans.", {
+        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("/songs", params));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("get_song", "one song with its waveform: everything list_songs shows plus peaks (400 numbers from 0 to 1 across the song, for picking a snippet by ear and eye).", { song_id: z.string().uuid() }, async ({ song_id }) => {
+        try {
+            return text(await client.get(`/songs/${song_id}`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("add_song", "add a song from a youtube or soundcloud link, or from a public audio file url (mp3, m4a, wav, aac, flac, ogg, up to 50 MB). the audio is fetched and converted in the background (longer than 15 minutes is cut there): the song comes back pending; read it again with get_song until it is ready or failed (a youtube refusal says to upload the file instead). the song must be the user's own. pro and premium plans; at most 100 songs.", {
+        link_url: z.string().url().optional().describe("a youtube or soundcloud link"),
+        audio_url: z.string().url().optional().describe("a public audio file url, when not using a link"),
+        title: z.string().min(1).max(200).optional().describe("the title; the link's or file's name otherwise"),
+    }, async ({ link_url, audio_url, title }) => {
+        try {
+            if (!link_url && !audio_url)
+                throw new Error("give link_url or audio_url");
+            const body = link_url ? { link_url } : { audio_url };
+            if (title)
+                body.title = title;
+            return text(await client.post("/songs", body));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("get_song_lyrics", "the song's lyrics with word timings, transcribed on first request (takes up to a minute for a long song) and kept: language, text, and words with start and end seconds. a song with no recognizable words comes back with empty words. the song must be ready.", { song_id: z.string().uuid() }, async ({ song_id }) => {
+        try {
+            return text(await client.get(`/songs/${song_id}/lyrics`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("delete_song", "delete a song and its audio file.", { song_id: z.string().uuid() }, async ({ song_id }) => {
+        try {
+            await client.delete(`/songs/${song_id}`);
+            return text({ id: song_id, deleted: true });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}

package/package.json

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