@jclvsh/dropspace 2.42.0 → 2.43.0

package/README.md

@@ -377,6 +377,10 @@ Reddit engagement (drafted comments in other communities) is paused: its tools a
 | `get_audience_demographics` | Age, gender, country, and city of your Instagram followers and engaged audience (local package only, not the hosted endpoint) |
 | `get_reels_read` | Each Instagram account's latest reels read (local package only, not the hosted endpoint) |
 | `generate_reels_read` | Claude compares your top, middle, and bottom reels of the last 90 days; pro and premium, one a day per account (local package only, not the hosted endpoint) |
+| `list_trial_reels` | Trial reel programs: each Instagram account's program, posting hours, and reshared reels with their 1/3/7-day numbers; pro and premium (local package only) |
+| `update_trial_reel_program` | Turn an account's trial reel program on or off, or change reels per day, auto-approve, skip terms, timezone (send scope to turn on; local package only) |
+| `scan_trial_reels` | Scan an account's reels again and queue the strong ones (local package only) |
+| `update_trial_reel` | Approve, hold, re-caption, or remove a waiting reel, or approve all (send scope to approve; local package only) |
 
 #### `get_audience` Parameters
 
@@ -385,7 +389,7 @@ Reddit engagement (drafted comments in other communities) is paused: its tools a
 | `window_days` | number | No       | Growth window in days (1-365, default 30) |
 | `include_instagram_insights` | boolean | No | Add Instagram growth analytics to each Instagram entry (default false) |
 
-CLI: `dropspace audience [-w, --window-days <n>] [--instagram-insights]`, `dropspace trial-reels`, `dropspace best-hours [--timezone <zone>]`, `dropspace demographics [--timeframe <this_week|this_month|last_90_days>]`, and `dropspace reels-read [--generate] [--connection-id <id>]`.
+CLI: `dropspace audience [-w, --window-days <n>] [--instagram-insights]`, `dropspace trial-reels`, `dropspace best-hours [--timezone <zone>]`, `dropspace demographics [--timeframe <this_week|this_month|last_90_days>]`, `dropspace reels-read [--generate] [--connection-id <id>]`, and `dropspace trial-reel-program list|set|scan|approve|approve-all|remove`.
 
 With `include_instagram_insights`, each Instagram entry carries `instagram_insights`: follows, unfollows, net, and reach split into followers and non-followers per Pacific-time day, an estimated followers-over-time series rebuilt back from the current count, weekly growth velocity, the share of reach from non-followers, and contact-button taps. Instagram revises the last 7 days (`settled: false`). Each call reads up to 31 days, newest first, so a 90-day window fills over a few calls (`days_pending`). Instagram reports none of this for accounts under 100 followers (`available: false`).
 

package/dist/commands/audience.js

@@ -108,4 +108,96 @@ export function registerAudienceCommands(program, client) {
             }
         });
     }
+    const trial = program
+        .command("trial-reel-program")
+        .description("reshare your strongest instagram reels as trial reels (pro and premium)");
+    trial
+        .command("list")
+        .description("each instagram account with its trial reel program, posting hours, and reels")
+        .action(async () => {
+        try {
+            formatOutput(await client.get("/trial-reels"), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    trial
+        .command("set <connectionId>")
+        .description("change a program; --on needs the send scope and scans the account's reels the first time")
+        .option("--on", "turn the program on")
+        .option("--off", "turn the program off")
+        .option("--per-day <n>", "trial reels a day, 1-3")
+        .option("--auto-approve <bool>", "post queued reels without approving each one (true or false)")
+        .option("--skip <terms>", "comma-separated: never queue a reel whose caption contains one")
+        .option("--timezone <tz>", "IANA timezone for posting hours")
+        .action(async (connectionId, options) => {
+        try {
+            const body = {
+                ...(options.on ? { enabled: true } : options.off ? { enabled: false } : {}),
+                ...(options.perDay ? { reels_per_day: Number(options.perDay) } : {}),
+                ...(options.autoApprove !== undefined
+                    ? { auto_approve: ["true", "yes", "on", "1"].includes(options.autoApprove.toLowerCase()) }
+                    : {}),
+                ...(options.skip !== undefined
+                    ? {
+                        skip_caption_terms: options.skip
+                            .split(",")
+                            .map((term) => term.trim())
+                            .filter(Boolean),
+                    }
+                    : {}),
+                ...(options.timezone ? { timezone: options.timezone } : {}),
+            };
+            formatOutput(await client.put(`/trial-reels/programs/${connectionId}`, body), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    trial
+        .command("scan <connectionId>")
+        .description("scan the account's reels again and queue the strong ones")
+        .action(async (connectionId) => {
+        try {
+            formatOutput(await client.post(`/trial-reels/programs/${connectionId}/scan`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    trial
+        .command("approve <itemId>")
+        .description("approve a waiting reel so it posts at the next posting hour (send scope)")
+        .action(async (itemId) => {
+        try {
+            formatOutput(await client.patch(`/trial-reels/items/${itemId}`, { approved: true }), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    trial
+        .command("approve-all <connectionId>")
+        .description("approve every waiting reel with a caption (send scope)")
+        .action(async (connectionId) => {
+        try {
+            formatOutput(await client.post(`/trial-reels/programs/${connectionId}/approve-all`), getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    trial
+        .command("remove <itemId>")
+        .description("remove a waiting reel for good")
+        .action(async (itemId) => {
+        try {
+            await client.delete(`/trial-reels/items/${itemId}`);
+            formatOutput({ data: { id: itemId, status: "removed" } }, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
 }

package/dist/server.js

@@ -17,6 +17,7 @@ import { registerRedditTools } from "./tools/reddit.js";
 import { registerAudienceTools } from "./tools/audience.js";
 import { registerCommentTools } from "./tools/comments.js";
 import { registerAccountTools } from "./tools/account.js";
+import { registerTrialReelTools } from "./tools/trial-reels.js";
 /** Drops tools whose feature is paused before the policy registrar sees them (see PAUSED_TOOLS). */
 function skipPausedTools(registrar) {
     return {
@@ -46,5 +47,6 @@ export function createDropspaceServer({ client, version, profile }) {
     registerAudienceTools(registrar, client);
     registerCommentTools(registrar, client);
     registerAccountTools(registrar, client);
+    registerTrialReelTools(registrar, client);
     return server;
 }

package/dist/tool-policy.js

@@ -128,6 +128,11 @@ const FULL_TOOL_POLICY = {
     get_reels_read: localOnly("audience", "read"),
     // spends a Claude call and up to 60 Instagram requests; changes nothing the user posted
     generate_reels_read: localOnly("audience", "write"),
+    list_trial_reels: localOnly("audience", "read"),
+    // turning a program on or approving reels leads to instagram posts
+    update_trial_reel_program: localOnly("audience", "sensitive"),
+    scan_trial_reels: localOnly("audience", "write"),
+    update_trial_reel: localOnly("audience", "sensitive"),
     get_usage: hosted("usage", "read"),
     get_changelog: hosted("usage", "read"),
     get_dropspace_status: hosted("dropspace", "read"),

package/dist/tools/comments.js

@@ -76,7 +76,7 @@ export function registerCommentTools(server, client) {
             return fail(error);
         }
     });
-    server.tool("list_comment_queue", "every comment still waiting for you across your instagram and youtube posts made through dropspace in the last 30 days (newest 30 posts, newest 50 comments each), newest first, up to 200. waiting: not hidden, not written or answered by your account, and not replied to, hidden, deleted, or dismissed through dropspace. each comment carries its post (platform, post_id, launch_id, launch_name) and claude's read: kind (question, feedback, praise, spam, attack, other; null until sorted), suggested_action (reply, hide, dismiss), and reply_draft for questions and feedback; may_be_answered is true when youtube returned only some replies and none was yours. counts per kind; post_issues lists posts that could not be read. reply with reply_to_comment, delete with delete_comment (launch_id + post_id + comment id); hide or dismiss several with act_on_comments.", {}, async () => {
+    server.tool("list_comment_queue", "every comment still waiting for you across your instagram and youtube posts made through dropspace in the last 30 days (up to 30 posts, the ones with comments first; newest 50 comments each; posts_in_window says how many posts the window has), newest first, up to 200. waiting: not hidden, not written or answered by your account, and not replied to, hidden, deleted, or dismissed through dropspace. each comment carries its post (platform, post_id, launch_id, launch_name) and claude's read: kind (question, feedback, praise, spam, attack, other; null until sorted), suggested_action (reply, hide, dismiss), and reply_draft for questions and feedback; may_be_answered is true when youtube returned only some replies and none was yours. counts per kind; post_issues lists posts that could not be read. reply with reply_to_comment, delete with delete_comment (launch_id + post_id + comment id); hide or dismiss several with act_on_comments.", {}, async () => {
         try {
             return text(await client.get("/comments/queue"));
         }

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

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

package/dist/tools/trial-reels.js

@@ -0,0 +1,77 @@
+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,
+    };
+}
+export function registerTrialReelTools(server, client) {
+    server.tool("list_trial_reels", "trial reel programs (pro and premium): each connected instagram account with eligible (instagram takes trial reels only from professional accounts with 200+ followers), its program (absent until saved: enabled, auto_approve, reels_per_day 1-3, skip_caption_terms, timezone, last_note), posting_hours (0-23 in the program's timezone: the account's best hours, else 9, 13, 18), and items, newest 100: status queued (waits for approval), posting, posted, won, retired, or failed (failure says why), with reason, caption, the source reel and its views, win_target (half the source's views, capped at 10,000), and checkpoints d1/d3/d7.", {}, async () => {
+        try {
+            return text(await client.get("/trial-reels"));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("update_trial_reel_program", "create or change the trial reel program for one instagram account. turning it on the first time scans the account's reels and queues the strong ones (returned as scan). nothing posts until a reel is approved (update_trial_reel, or auto_approve). approved reels are reshared as instagram trial reels (shown to non-followers only, graduation manual) one per posting hour, never within 2 hours of another dropspace post to that account; each is a launch on the user's plan. enabled or auto_approve true needs the send scope.", {
+        connection_id: z.string().uuid().describe("instagram connection_id from list_trial_reels"),
+        enabled: z.boolean().optional().describe("turn the program on or off"),
+        auto_approve: z.boolean().optional().describe("post queued reels without approving each one"),
+        reels_per_day: z.number().int().min(1).max(3).optional().describe("trial reels a day, 1-3"),
+        skip_caption_terms: z
+            .array(z.string().max(50))
+            .max(20)
+            .optional()
+            .describe("never queue a reel whose caption contains one of these"),
+        timezone: z.string().optional().describe("IANA timezone for posting hours, e.g. America/New_York"),
+    }, async ({ connection_id, ...settings }) => {
+        try {
+            return text(await client.put(`/trial-reels/programs/${connection_id}`, settings));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("scan_trial_reels", "scan an instagram account's reels again (last 180 days, up to 100) and queue the ones with 1.5x the median views or more that are older than 21 days and were never queued. returns queued, rated, median_views, and note (why nothing was queued). one scan per account every 10 minutes.", { connection_id: z.string().uuid().describe("instagram connection_id with a saved program") }, async ({ connection_id }) => {
+        try {
+            return text(await client.post(`/trial-reels/programs/${connection_id}/scan`));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+    server.tool("update_trial_reel", "change one waiting (queued) trial reel: approved true lets it post at the next posting hour (send scope; needs a caption), false holds it; caption replaces the caption it posts with (up to 2,200 characters) and holds the reel unless approved true is sent with it; remove true takes it out of the queue for good. approve every waiting reel at once with approve_all.", {
+        id: z.string().uuid().optional().describe("item id from list_trial_reels (not needed with approve_all)"),
+        approved: z.boolean().optional(),
+        caption: z.string().max(2200).optional(),
+        remove: z.boolean().optional(),
+        approve_all: z
+            .string()
+            .uuid()
+            .optional()
+            .describe("instead of one item: a connection_id whose waiting reels with captions are all approved"),
+    }, async ({ id, approved, caption, remove, approve_all }) => {
+        try {
+            if (approve_all) {
+                return text(await client.post(`/trial-reels/programs/${approve_all}/approve-all`));
+            }
+            if (!id)
+                return fail(new Error("send id, or approve_all with a connection_id"));
+            if (remove) {
+                await client.delete(`/trial-reels/items/${id}`);
+                return text({ data: { id, status: "removed" } });
+            }
+            return text(await client.patch(`/trial-reels/items/${id}`, {
+                ...(approved !== undefined ? { approved } : {}),
+                ...(caption !== undefined ? { caption } : {}),
+            }));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}

package/package.json

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