posterly-mcp-server 0.8.2 → 0.8.3

package/dist/tools/create-post.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-const instagramSettingsSchema = z.object({
+export const instagramSettingsSchema = z.object({
     __type: z.enum(['instagram', 'instagram-standalone']).optional(),
     post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
     is_trial_reel: z.boolean().optional(),
@@ -15,7 +15,7 @@ const instagramSettingsSchema = z.object({
     reel_cover_url: z.string().optional(),
     reel_thumb_offset: z.number().nonnegative().optional(),
 });
-const platformSettingsSchema = z.object({
+export const platformSettingsSchema = z.object({
     __type: z.string().optional(),
     post_type: z.string().optional(),
     content_type: z.string().optional(),
@@ -67,6 +67,79 @@ const platformSettingsSchema = z.object({
     // Bluesky
     langs: z.array(z.string()).optional(),
 }).passthrough();
+export const createPostInputSchema = z.object({
+    account_id: z.string().optional().describe('Social account ID (from list_accounts)'),
+    username: z.string().optional().describe('Account username (alternative to account_id)'),
+    platform: z
+        .string()
+        .optional()
+        .describe('Platform name (required with username): instagram, twitter, linkedin, facebook, tiktok, threads, youtube, pinterest, google_business'),
+    caption: z.string().optional().describe('The post caption/text content. Ignored when `thread_posts` is provided.'),
+    scheduled_at: z
+        .string()
+        .optional()
+        .describe('ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.'),
+    media_url: z.string().optional().describe('URL of media to attach (image or video). For threads, attaches to the lead post only.'),
+    media_urls: z
+        .array(z.string())
+        .optional()
+        .describe('Multiple media URLs for carousel posts'),
+    post_type: z
+        .string()
+        .optional()
+        .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided.'),
+    thread_posts: z
+        .array(z.string())
+        .optional()
+        .describe('For X or Threads only: array of 2+ strings, one per post in the thread. The first entry leads, the rest reply in order. When set, the platform must be twitter or threads.'),
+    instagram_settings: instagramSettingsSchema
+        .optional()
+        .describe('Instagram-specific settings: post_type (post/feed/story/reel/carousel), collaborators, user_tags, first_comment, media_alt_texts, is_trial_reel, graduation_strategy (defaults to MANUAL), reel_cover_url, reel_thumb_offset.'),
+    platform_settings: platformSettingsSchema
+        .optional()
+        .describe('Platform-specific settings for the selected account. Use this for non-Instagram settings and prefer it over raw metadata.'),
+    workspace_id: z
+        .string()
+        .optional()
+        .describe('Workspace ID to assign the post to (from whoami). If omitted, uses the account\'s workspace or the caller\'s default workspace.'),
+});
+export function buildCreatePostPayload(input) {
+    const { thread_posts, caption, post_type, instagram_settings, platform_settings, ...rest } = input;
+    if (thread_posts && thread_posts.length > 0) {
+        if (thread_posts.length < 2) {
+            throw new Error('thread_posts must contain at least 2 entries');
+        }
+        const platformHint = (input.platform || '').toLowerCase();
+        const isTwitter = platformHint === 'twitter' || platformHint === 'x';
+        const isThreads = platformHint === 'threads';
+        if (!isTwitter && !isThreads && !input.account_id) {
+            throw new Error('thread_posts requires `platform` to be "twitter" or "threads", or pass `account_id` for an X/Threads account.');
+        }
+        const arrayKey = isThreads ? 'threads_thread_posts' : 'x_thread_tweets';
+        const totalKey = isThreads ? 'threads_thread_total' : 'x_thread_total';
+        return {
+            ...rest,
+            platform: isTwitter ? 'twitter' : isThreads ? 'threads' : input.platform,
+            caption: thread_posts[0],
+            post_type: isThreads ? 'threads_thread' : 'x_thread',
+            metadata: {
+                [arrayKey]: thread_posts,
+                [totalKey]: thread_posts.length,
+            },
+        };
+    }
+    if (!caption) {
+        throw new Error('caption is required (or pass `thread_posts` for an X/Threads thread)');
+    }
+    return {
+        ...rest,
+        caption,
+        post_type,
+        ...(platform_settings || instagram_settings
+            ? { settings: { ...(instagram_settings ? { __type: 'instagram', ...instagram_settings } : {}), ...(platform_settings || {}) } }
+            : {}),
+    };
+}
 export const createPostTool = {
     name: 'create_post',
     description: 'Schedule or immediately publish a social media post. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, it will be posted publicly and cannot be un-posted.\n\n' +
@@ -74,85 +147,14 @@ export const createPostTool = {
         '1. Call `whoami` at the start of any new session to confirm which workspace and user you are acting for.\n' +
         '2. Show the user a preview containing ALL of: account(s) and platform(s), final caption text, scheduled time (in the user\'s timezone), media attached (if any), and workspace name.\n' +
         '3. Get explicit confirmation from the user (e.g. "post it", "yes schedule that", "looks good") BEFORE calling this tool. Do NOT infer consent from earlier instructions like "post about X every Monday" — confirm each individual post or the entire batch.\n' +
-        '4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole before calling create_post repeatedly.\n\n' +
+        '4. If scheduling multiple posts in one turn, list every post first and confirm the batch as a whole, then prefer `create_posts_batch` so they are created in one API request.\n\n' +
         'Provide either account_id OR username+platform to identify the account. If scheduled_at is omitted, the post publishes immediately. If workspace_id is omitted, the server resolves one from the social account, falling back to the caller\'s default (personal) workspace — pass workspace_id explicitly if the user has more than one workspace.\n\n' +
         'THREADS: Pass `thread_posts` (an array of 2+ strings) to schedule a multi-post thread on X (Twitter) or Threads (Meta). The first entry is the lead post; the rest are published as replies in the same chain. X entries are capped at 280 characters each (4000 for verified, 25000 for organization accounts); Threads entries are capped at 500 characters each. When `thread_posts` is set, `caption` is ignored.\n\n' +
         'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/playlist, LinkedIn document titles/mentions/video thumbnails, TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/link/title/video cover, GBP event/offer/CTA, X reply settings/polls, Threads reply controls/text attachments, Bluesky languages/alt text, and Instagram feed/story/reel/carousel/collaborators/first comments/trial Reels. `instagram_settings` remains as a backwards-compatible alias.',
-    inputSchema: z.object({
-        account_id: z.string().optional().describe('Social account ID (from list_accounts)'),
-        username: z.string().optional().describe('Account username (alternative to account_id)'),
-        platform: z
-            .string()
-            .optional()
-            .describe('Platform name (required with username): instagram, twitter, linkedin, facebook, tiktok, threads, youtube, pinterest, google_business'),
-        caption: z.string().optional().describe('The post caption/text content. Ignored when `thread_posts` is provided.'),
-        scheduled_at: z
-            .string()
-            .optional()
-            .describe('ISO 8601 datetime for scheduling (e.g. 2026-03-05T09:00:00Z). Omit for immediate publish.'),
-        media_url: z.string().optional().describe('URL of media to attach (image or video). For threads, attaches to the lead post only.'),
-        media_urls: z
-            .array(z.string())
-            .optional()
-            .describe('Multiple media URLs for carousel posts'),
-        post_type: z
-            .string()
-            .optional()
-            .describe('Post type: text, image, video, carousel, reel, story. Auto-set to x_thread/threads_thread when `thread_posts` is provided.'),
-        thread_posts: z
-            .array(z.string())
-            .optional()
-            .describe('For X or Threads only: array of 2+ strings, one per post in the thread. The first entry leads, the rest reply in order. When set, the platform must be twitter or threads.'),
-        instagram_settings: instagramSettingsSchema
-            .optional()
-            .describe('Instagram-specific settings: post_type (post/feed/story/reel/carousel), collaborators, user_tags, first_comment, media_alt_texts, is_trial_reel, graduation_strategy, reel_cover_url, reel_thumb_offset.'),
-        platform_settings: platformSettingsSchema
-            .optional()
-            .describe('Platform-specific settings for the selected account. Use this for non-Instagram settings and prefer it over raw metadata.'),
-        workspace_id: z
-            .string()
-            .optional()
-            .describe('Workspace ID to assign the post to (from whoami). If omitted, uses the account\'s workspace or the caller\'s default workspace.'),
-    }),
+    inputSchema: createPostInputSchema,
     async execute(client, input) {
-        const { thread_posts, caption, post_type, instagram_settings, platform_settings, ...rest } = input;
-        let payload;
-        if (thread_posts && thread_posts.length > 0) {
-            if (thread_posts.length < 2) {
-                throw new Error('thread_posts must contain at least 2 entries');
-            }
-            const platformHint = (input.platform || '').toLowerCase();
-            const isTwitter = platformHint === 'twitter' || platformHint === 'x';
-            const isThreads = platformHint === 'threads';
-            if (!isTwitter && !isThreads && !input.account_id) {
-                throw new Error('thread_posts requires `platform` to be "twitter" or "threads", or pass `account_id` for an X/Threads account.');
-            }
-            const arrayKey = isThreads ? 'threads_thread_posts' : 'x_thread_tweets';
-            const totalKey = isThreads ? 'threads_thread_total' : 'x_thread_total';
-            payload = {
-                ...rest,
-                platform: isTwitter ? 'twitter' : isThreads ? 'threads' : input.platform,
-                caption: thread_posts[0],
-                post_type: isThreads ? 'threads_thread' : 'x_thread',
-                metadata: {
-                    [arrayKey]: thread_posts,
-                    [totalKey]: thread_posts.length,
-                },
-            };
-        }
-        else {
-            if (!caption) {
-                throw new Error('caption is required (or pass `thread_posts` for an X/Threads thread)');
-            }
-            payload = {
-                ...rest,
-                caption,
-                post_type,
-                ...(platform_settings || instagram_settings
-                    ? { settings: { ...(instagram_settings ? { __type: 'instagram', ...instagram_settings } : {}), ...(platform_settings || {}) } }
-                    : {}),
-            };
-        }
+        const payload = buildCreatePostPayload(input);
+        const { thread_posts, instagram_settings, platform_settings } = input;
         const result = await client.createPost(payload);
         const p = result.post;
         const ws = result.workspace;