@jclvsh/dropspace 2.17.0 → 2.20.0

package/dist/cli.js

@@ -17,6 +17,7 @@ import { registerBoostCommands } from "./commands/boosts.js";
 import { registerRedditCommands } from "./commands/reddit.js";
 import { registerAutopilotCommands } from "./commands/autopilot.js";
 import { registerRecommendationCommands } from "./commands/recommendations.js";
+import { registerAudienceCommands } from "./commands/audience.js";
 const program = new Command()
     .name("dropspace")
     .description("dropspace CLI - manage launches, personas, boosts, and more")
@@ -32,6 +33,7 @@ try {
     registerWebhookCommands(program, client);
     registerDropspaceCommands(program, client);
     registerUsageCommands(program, client);
+    registerAudienceCommands(program, client);
     registerCreditCommands(program, client);
     registerMediaCommands(program, client);
     registerBoostCommands(program, client);

package/dist/commands/audience.d.ts

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

package/dist/commands/audience.js

@@ -0,0 +1,19 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerAudienceCommands(program, client) {
+    program
+        .command("audience")
+        .description("follower counts + growth per connected account (instagram, youtube, tiktok, twitter, facebook pages)")
+        .option("-w, --window-days <n>", "growth window in days (max 365)", "30")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.windowDays)
+                params.window_days = opts.windowDays;
+            const result = await client.get("/audience", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/connections.js

@@ -36,4 +36,19 @@ export function registerConnectionCommands(program, client) {
             handleError(error);
         }
     });
+    connections
+        .command("profile <platform>")
+        .description("edit the connected account's profile on the platform (youtube only today: the channel description, max 1,000 chars; pass an empty string to clear)")
+        .requiredOption("--description <text>", "the new profile / channel description")
+        .action(async (platform, opts) => {
+        try {
+            const result = await client.patch(`/connections/${encodeURIComponent(platform)}/profile`, {
+                description: opts.description,
+            });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
 }

package/dist/commands/launches.js

@@ -35,6 +35,7 @@ export function registerLaunchCommands(program, client) {
         .option("--custom-content <text>", "single content string for all platforms")
         .option("--reddit-title <title>", "reddit title (with custom-content)")
         .option("--user-accounts <json>", 'platform→token_id map as JSON. simple key = primary account ("instagram"); composite key targets a specific account when you have several ("instagram:<account_id>", ids from `connections list`) — works for instagram/tiktok/youtube/twitter/reddit')
+        .option("--attribution-mode <mode>", 'how official-account posts credit you: "handle" (default) or "anonymous"')
         .option("--publish", "immediately publish after creation")
         .option("--wait", "wait for publishing to complete (requires --publish)")
         .action(async (opts) => {
@@ -52,6 +53,8 @@ export function registerLaunchCommands(program, client) {
                 body.persona_id = opts.persona;
             if (opts.dropspacePlatforms)
                 body.dropspace_platforms = opts.dropspacePlatforms;
+            if (opts.attributionMode)
+                body.attribution_mode = opts.attributionMode;
             if (opts.mediaMode)
                 body.media_mode = opts.mediaMode;
             if (opts.platformContents)
@@ -100,6 +103,7 @@ export function registerLaunchCommands(program, client) {
         .option("--persona <id>", "persona ID (empty to clear)")
         .option("--platform-contents <json>", 'per-platform content as JSON string. reddit supports metadata.subreddits (string[], max 10, no r/ prefix — one post per subreddit) and metadata.first_comment (max 1500). e.g. \'{"reddit":{"title":"...","content":"...","metadata":{"subreddits":["SideProject"],"first_comment":"..."}}}\'')
         .option("--dropspace-platforms <list>", "official dropspace account platforms", parseList)
+        .option("--attribution-mode <mode>", 'how official-account posts credit you: "handle" (default) or "anonymous"')
         .option("--user-accounts <json>", 'platform→token_id map as JSON. simple key = primary account ("instagram"); composite key targets a specific account when you have several ("instagram:<account_id>", ids from `connections list`) — works for instagram/tiktok/youtube/twitter/reddit')
         .option("--media-mode <mode>", "media mode: images or video")
         .action(async (id, opts) => {
@@ -123,6 +127,8 @@ export function registerLaunchCommands(program, client) {
                 body.platform_contents = JSON.parse(opts.platformContents);
             if (opts.dropspacePlatforms)
                 body.dropspace_platforms = opts.dropspacePlatforms;
+            if (opts.attributionMode)
+                body.attribution_mode = opts.attributionMode;
             if (opts.userAccounts)
                 body.user_platform_accounts = JSON.parse(opts.userAccounts);
             if (opts.mediaMode)
@@ -160,10 +166,17 @@ export function registerLaunchCommands(program, client) {
     });
     launches
         .command("retry <id>")
-        .description("retry failed platforms for a launch")
-        .action(async (id) => {
+        .description("retry failed platforms for a launch, or one reddit destination with --subreddit")
+        .option("--subreddit <name>", "retry only this reddit destination (no r/ prefix)")
+        .option("--account-id <id>", "the connected reddit account owning that destination (entity_id from `connections list`); omit for your primary. only meaningful with --subreddit")
+        .action(async (id, opts) => {
         try {
-            const result = await client.post(`/launches/${id}/retry`);
+            const body = {};
+            if (opts.subreddit)
+                body.subreddit = opts.subreddit;
+            if (opts.accountId)
+                body.account_id = opts.accountId;
+            const result = await client.post(`/launches/${id}/retry`, Object.keys(body).length > 0 ? body : undefined);
             formatOutput(result, getFormat(program.opts()));
         }
         catch (error) {

package/dist/index.js

@@ -15,9 +15,10 @@ import { registerBoostTools } from "./tools/boosts.js";
 import { registerAutopilotTools } from "./tools/autopilot.js";
 import { registerRecommendationTools } from "./tools/recommendations.js";
 import { registerRedditTools } from "./tools/reddit.js";
+import { registerAudienceTools } from "./tools/audience.js";
 const server = new McpServer({
     name: "dropspace",
-    version: "2.9.0",
+    version: "2.20.0",
 });
 const client = new DropspaceClient();
 registerLaunchTools(server, client);
@@ -33,5 +34,6 @@ registerBoostTools(server, client);
 registerAutopilotTools(server, client);
 registerRecommendationTools(server, client);
 registerRedditTools(server, client);
+registerAudienceTools(server, client);
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/audience.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DropspaceClient } from "../client.js";
+export declare function registerAudienceTools(server: McpServer, client: DropspaceClient): void;

package/dist/tools/audience.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export function registerAudienceTools(server, client) {
+    server.tool("get_audience", 'follower counts + growth for every connected instagram / youtube / tiktok / twitter account and facebook page. one entry per ACCOUNT, not per platform: "entity_id" is null for your primary account on a platform and set for each additional one, so a user with two instagram accounts returns two instagram entries. counts are read live from each platform API (cached ~15 min); "series" is the stored history. growth is measured from the OLDEST stored point inside the window, which — because history points are recorded when you read, at most one per account per day — can be much younger than window_days: read "effective_window_days" (the span the delta actually covers) and "baseline_captured_at" before comparing growth across accounts. linkedin is not covered (its API exposes no personal-profile follower count).', {
+        window_days: z
+            .number()
+            .int()
+            .min(1)
+            .max(365)
+            .optional()
+            .describe("growth window in days (default: 30, max: 365)"),
+    }, async ({ window_days }) => {
+        try {
+            const result = await client.get("/audience", window_days ? { window_days: String(window_days) } : undefined);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/connections.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerConnectionTools(server, client) {
-    server.tool("list_connections", 'list your connected social media accounts. each row has a "platform" and an "entity_id" (null for your primary account on that platform, set for additional accounts). to target a specific account in create_launch when you have more than one on instagram/tiktok/youtube, pass "{platform}:{entity_id}" as a user_platform_accounts key', {
+    server.tool("list_connections", 'list your connected social media accounts. each row has a "platform" and an "entity_id" (null for your primary account on that platform, set for additional accounts). to target a specific account in create_launch when you have more than one on instagram / tiktok / youtube / twitter / reddit, pass "{platform}:{entity_id}" as a user_platform_accounts key (the bare "{platform}" key targets your primary). the same entity_id is what DELETE /connections/{platform}?account_id=... disconnects, and what retry_launch takes as account_id', {
         page: z.number().int().positive().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 ({ page, page_size }) => {
@@ -27,4 +27,26 @@ export function registerConnectionTools(server, client) {
             };
         }
     });
+    server.tool("update_connection_profile", "edit the connected account's profile ON the platform. youtube only today: sets the channel description (max 1,000 characters; an empty string clears it) via channels.update. instagram's api can read a profile but not write it, facebook page \"about\" needs a permission dropspace does not hold, and tiktok / x / linkedin expose no profile write - those return an error with the reason. requires the write scope.", {
+        platform: z.string().describe('platform whose profile to edit (currently only "youtube")'),
+        description: z.string().max(1000).describe("the new profile / channel description (max 1,000 characters)"),
+    }, async ({ platform, description }) => {
+        try {
+            const result = await client.patch(`/connections/${encodeURIComponent(platform)}/profile`, { description });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
 }

package/dist/tools/launches.js

@@ -98,6 +98,10 @@ export function registerLaunchTools(server, client) {
             .array(z.enum(PLATFORMS))
             .optional()
             .describe("platforms to post via official dropspace accounts"),
+        attribution_mode: z
+            .enum(["handle", "anonymous"])
+            .optional()
+            .describe('how official-account posts credit the author: "handle" (default) signs with the connected @handle on that platform when one exists, "anonymous" always uses the plain "posted from dropspace user" note'),
         media_mode: z.enum(["images", "video"]).optional().describe("media mode for the launch"),
         user_platform_accounts: z
             .record(z.string(), z.string())
@@ -106,7 +110,7 @@ export function registerLaunchTools(server, client) {
         platform_contents: z
             .record(z.string(), z.record(z.string(), z.unknown()))
             .optional()
-            .describe('per-platform content — each value needs "content" (string). Reddit also requires "title" (max 300) and supports "metadata": { "subreddits": string[] (max 10, names without the r/ prefix — posts the launch once per subreddit, each tracked and retryable on its own; omit to post to the default community), "first_comment": string (max 1500 — posted as a comment under each reddit post once it goes live) }. for multi-account reddit, each connected account can target its own subreddits via "reddit:<account_id>" content keys (falls back to the base "reddit" block); a subreddit is posted by at most one of your accounts per launch (first wins, others skipped as SUBREDDIT_ALREADY_TARGETED). each subreddit has its own rules: many restrict or ban promotional posts and posting where the account has no history gets filtered, so target a few genuinely relevant subreddits rather than blasting. Twitter supports "thread" (string[], max 6, each ≤280 or ≤25,000 for X Premium) instead of "content". TikTok supports "tiktok_settings": { "publish_mode"?: "direct"|"draft" (default "direct"; "draft" uploads to the TikTok inbox to finish and publish in-app), "privacy_level": "PUBLIC_TO_EVERYONE"|"FOLLOWER_OF_CREATOR"|"MUTUAL_FOLLOW_FRIENDS"|"SELF_ONLY" (required before publish in direct mode; not required for draft), "allow_comments"?, "allow_duet"?, "allow_stitch"?, "is_commercial"?, "is_your_brand"?, "is_branded_content"?, "auto_add_music"? (booleans, direct mode) }. YouTube requires video and supports "title" (max 100 chars). character limits: Twitter 280/tweet (25,000 for X Premium), LinkedIn 3000, Instagram 2200, Reddit 3000, Facebook 3000, TikTok 4000, YouTube 5000 (description). X Premium status is auto-detected from the connected account. mutually exclusive with custom_content'),
+            .describe('per-platform content — each value needs "content" (string). Reddit also requires "title" (max 300) and supports "metadata": { "subreddits": string[] (max 10, names without the r/ prefix — posts the launch once per subreddit, each tracked and retryable on its own; omit to post to the default community), "first_comment": string (max 1500 — posted as a comment under each reddit post once it goes live) }. for multi-account reddit, each connected account can target its own subreddits via "reddit:<account_id>" content keys (falls back to the base "reddit" block); a subreddit is posted by at most one of your accounts per launch (first wins, others skipped as SUBREDDIT_ALREADY_TARGETED). each subreddit has its own rules: many restrict or ban promotional posts and posting where the account has no history gets filtered, so target a few genuinely relevant subreddits rather than blasting. Twitter supports "thread" (string[], max 6, each ≤280 or ≤25,000 for X Premium) instead of "content". TikTok supports "tiktok_settings": { "publish_mode"?: "direct"|"draft" (default "direct"; "draft" uploads to the TikTok inbox to finish and publish in-app), "privacy_level": "PUBLIC_TO_EVERYONE"|"FOLLOWER_OF_CREATOR"|"MUTUAL_FOLLOW_FRIENDS"|"SELF_ONLY" (required before publish in direct mode; not required for draft), "allow_comments"?, "allow_duet"?, "allow_stitch"?, "is_commercial"?, "is_your_brand"?, "is_branded_content"?, "auto_add_music"? (booleans, direct mode), "cover_timestamp_ms"? (integer 0-600000 — which frame TikTok uses as the cover, in ms from the start; VIDEO posts only, photo posts take their cover by index; omit for the first frame) }. YouTube requires video and supports "title" (max 100 chars). character limits: Twitter 280/tweet (25,000 for X Premium), LinkedIn 3000, Instagram 2200, Reddit 3000, Facebook 3000, TikTok 4000, YouTube 5000 (description). X Premium status is auto-detected from the connected account. mutually exclusive with custom_content'),
         custom_content: z
             .union([z.string().min(1), z.array(z.string()).min(1).max(6)])
             .optional()
@@ -222,6 +226,10 @@ export function registerLaunchTools(server, client) {
             .optional()
             .describe('per-platform content update (deep-merged with existing). each value can include "content" (string). Twitter supports "thread" (string[]) instead. Reddit "title" is optional on update, and "metadata" accepts "subreddits" (string[], max 10, no r/ prefix — one post per subreddit) and "first_comment" (string, max 1500). TikTok "tiktok_settings" is deep-merged — you can update individual fields (e.g. just "privacy_level") without overwriting the rest. see create_launch for full field details'),
         dropspace_platforms: z.array(z.enum(PLATFORMS)).optional().describe("official dropspace account platforms"),
+        attribution_mode: z
+            .enum(["handle", "anonymous"])
+            .optional()
+            .describe('how official-account posts credit the author ("handle" default, "anonymous" for the plain note)'),
         user_platform_accounts: z
             .record(z.string(), z.string())
             .optional()
@@ -302,11 +310,24 @@ export function registerLaunchTools(server, client) {
             };
         }
     });
-    server.tool("retry_launch", "retry failed platforms for a launch", {
+    server.tool("retry_launch", "retry failed platforms for a launch. by default every failed platform is retried; pass `subreddit` to retry ONE reddit destination (leaving its siblings — succeeded or failed — untouched), and add `account_id` when that destination belongs to a secondary connected reddit account rather than your primary.", {
         id: z.string().uuid().describe("launch ID"),
-    }, async ({ id }) => {
+        subreddit: z
+            .string()
+            .optional()
+            .describe("retry only this reddit destination (name without the r/ prefix)"),
+        account_id: z
+            .string()
+            .optional()
+            .describe("the connected reddit account that owns the destination (its entity_id from list_connections); omit for your primary account. only meaningful with `subreddit`"),
+    }, async ({ id, subreddit, account_id }) => {
         try {
-            const result = await client.post(`/launches/${id}/retry`);
+            const body = {};
+            if (subreddit)
+                body.subreddit = subreddit;
+            if (account_id)
+                body.account_id = account_id;
+            const result = await client.post(`/launches/${id}/retry`, Object.keys(body).length > 0 ? body : undefined);
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/dropspace",
-	"version": "2.17.0",
+	"version": "2.20.0",
 	"description": "MCP server and CLI for the Dropspace API",
 	"type": "module",
 	"main": "dist/index.js",