posterly-mcp-server 0.43.8 → 0.45.0

package/dist/tools/create-connect-session.js

@@ -3,7 +3,7 @@ import { DASHBOARD_CONNECT_URL, formatConnectedAccounts, formatLocalDateTime } f
 import { CONNECT_INPUTS } from '../generated/platform-manifest.js';
 export const createConnectSessionTool = {
     name: 'create_connect_session',
-    description: 'Create a short-lived posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll get_connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; posterly handles those browser steps.',
+    description: 'Create a short-lived posterly dashboard handoff session for connecting a social account. Send the secure connection URL to the user, then poll list_accounts with view=connect_session to narrate progress. Do not ask for social media passwords or OAuth codes; posterly handles those browser steps.',
     inputSchema: z.object({
         platform: z
             .enum(CONNECT_INPUTS)
@@ -41,7 +41,7 @@ function formatConnectSession(session, includeRaw) {
         `Expires: ${formatLocalDateTime(session.expires_at)}`,
         `Dashboard connect page: ${DASHBOARD_CONNECT_URL}`,
         '',
-        'Next step for the AI agent: send the secure connection URL to the user, explain that posterly will handle the browser OAuth step, then poll get_connect_session until the account is connected or the session ends.',
+        'Next step for the AI agent: send the secure connection URL to the user, explain that posterly will handle the browser OAuth step, then poll list_accounts with view=connect_session until the account is connected or the session ends.',
         includeRaw ? `\nRaw connect session:\n${JSON.stringify(session, null, 2)}` : '',
     ].filter(Boolean).join('\n');
 }

package/dist/tools/create-post.d.ts

@@ -968,7 +968,7 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
     workspace_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
@@ -1131,7 +1131,7 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
         ai_generated: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
@@ -1787,7 +1787,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     confirm: z.ZodLiteral<true>;
 }, "strip", z.ZodTypeAny, {
     confirm: true;
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
@@ -1951,7 +1951,7 @@ export declare const createPostInputSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     confirm: true;
-    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+    platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
@@ -2613,7 +2613,7 @@ export declare const createPostTool: {
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
@@ -2777,7 +2777,7 @@ export declare const createPostTool: {
         }, z.ZodTypeAny, "passthrough"> | undefined;
     }, {
         confirm: true;
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;

package/dist/tools/create-post.js

@@ -151,7 +151,7 @@ export const createPostPayloadInputSchema = z.object({
         .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. If “tag” is ambiguous, distinguish caption @mentions (put @username in caption), native media tags (user_tags), and co-author invitations (collaborators). Native media tags work with eligible direct or Meta-linked accounts; collaborators require an eligible Meta-linked account. Call get_platform_schema(account_id) first.'),
+        .describe('Instagram-specific settings. If “tag” is ambiguous, distinguish caption @mentions (put @username in caption), native media tags (user_tags), and co-author invitations (collaborators). Native media tags work with eligible direct or Meta-linked accounts; collaborators require an eligible Meta-linked account. Call list_platforms with view=schema and account_id first.'),
     platform_settings: platformSettingsSchema
         .optional()
         .describe('Platform-specific settings for the selected account. Use this for non-Instagram settings and prefer it over raw metadata.'),
@@ -218,9 +218,9 @@ export const createPostTool = {
         '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' +
         'AFTER CALLING: Tell the user the post was created, include the posterly dashboard link returned by the tool, and offer the next natural action. Do not narrate raw HTTP, curl, or API plumbing.\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' +
-        'MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media_from_url` first if you want to upload once and reuse the returned posterly URL across posts.\n\n' +
+        'MEDIA URLS: Posterly storage URLs are used as-is. Third-party HTTP(S) media URLs are copied into posterly storage before the post is saved, so API-created posts do not later fail on expired signed URLs. Short-lived signed URLs must still be live when this tool runs. You can also call `upload_media` with `url` first if you want to upload once and reuse the returned posterly URL across posts.\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/brandPartner, LinkedIn document titles/mentions/polls/content_call_to_action_label (including BUY_NOW and SHOP_NOW), TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/title/link/product_tags, GBP event/offer/CTA/recurrence, X reply settings/polls/paid_partnership, Threads reply controls/text attachments/ghost posts/spoilers/reply approvals/GIPHY, Telegram polls/buttons/video cover/live photo, Slack markdown/blocks, Mastodon visibility/quote/poll (media+poll allowed), and Instagram feed/story/reel/carousel/native media tags/collaborators/first comments/trial Reels/is_ai_generated/audio_id. For Instagram, @username in caption is only a caption mention; `user_tags` creates native media tags and `collaborators` sends co-author invitations only when the selected Meta-linked account reports those capabilities. Call `get_platform_schema` with the account ID first. `instagram_settings` remains as a backwards-compatible alias.\n\n' +
+        'PLATFORM SETTINGS: Pass `platform_settings` for composer-equivalent controls: Facebook story/reel/backgrounds, YouTube title/privacy/thumbnail/brandPartner, LinkedIn document titles/mentions/polls/content_call_to_action_label (including BUY_NOW and SHOP_NOW), TikTok direct-post privacy/toggles/commercial disclosure, Pinterest board/title/link/product_tags, GBP event/offer/CTA/recurrence, X reply settings/polls/paid_partnership, Threads reply controls/text attachments/ghost posts/spoilers/reply approvals/GIPHY, Telegram polls/buttons/video cover/live photo, Slack markdown/blocks, Mastodon visibility/quote/poll (media+poll allowed), and Instagram feed/story/reel/carousel/native media tags/collaborators/first comments/trial Reels/is_ai_generated/audio_id. For Instagram, @username in caption is only a caption mention; `user_tags` creates native media tags and `collaborators` sends co-author invitations only when the selected Meta-linked account reports those capabilities. Call `list_platforms` with `view: "schema"` and the account ID first. `instagram_settings` remains as a backwards-compatible alias.\n\n' +
         'TIKTOK MEDIA: TikTok supports a single video or a photo slideshow of 1 to 35 images, never multiple videos. Image media auto-detects as a slideshow, so you usually do not set post_type or media_type for photos and every image is posted. Pass `platform_settings.media_type: "PHOTO"` to force a slideshow explicitly.',
     inputSchema: createPostInputSchema,
     async execute(client, input) {

package/dist/tools/create-posts-batch.d.ts

@@ -495,7 +495,7 @@ export declare const createPostsBatchTool: {
             }, z.ZodTypeAny, "passthrough">>>;
             workspace_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
@@ -658,7 +658,7 @@ export declare const createPostsBatchTool: {
                 ai_generated: z.ZodOptional<z.ZodBoolean>;
             }, z.ZodTypeAny, "passthrough"> | undefined;
         }, {
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
@@ -825,7 +825,7 @@ export declare const createPostsBatchTool: {
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         posts: {
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
@@ -991,7 +991,7 @@ export declare const createPostsBatchTool: {
     }, {
         confirm: true;
         posts: {
-            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "gmb" | "google-business" | "google_business_profile" | undefined;
+            platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;

package/dist/tools/create-webhook.d.ts

@@ -11,19 +11,19 @@ export declare const createWebhookTool: {
         is_active: z.ZodOptional<z.ZodBoolean>;
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
-        url: string;
         confirm: true;
+        url: string;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
     }, {
-        url: string;
         confirm: true;
+        url: string;
         description?: string | undefined;
         workspace_id?: string | undefined;
-        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
         is_active?: boolean | undefined;
+        events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         url: string;

package/dist/tools/delete-post.d.ts

@@ -1,20 +1,44 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type DeletePostInput = {
+    post_id?: number;
+    group_id?: string;
+    confirm?: boolean;
+    preview_id?: string;
+};
 export declare const deletePostTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
-        post_id: z.ZodNumber;
-        confirm: z.ZodLiteral<true>;
+        post_id: z.ZodOptional<z.ZodNumber>;
+        group_id: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+        preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        post_id: number;
-        confirm: true;
+        confirm?: boolean | undefined;
+        preview_id?: string | undefined;
+        post_id?: number | undefined;
+        group_id?: string | undefined;
     }, {
-        post_id: number;
-        confirm: true;
+        confirm?: boolean | undefined;
+        preview_id?: string | undefined;
+        post_id?: number | undefined;
+        group_id?: string | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        post_id: number;
-        confirm: true;
-    }): Promise<string>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        delete_post_group: z.ZodObject<{
+            group_id: z.ZodString;
+            confirm: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            confirm: true;
+            group_id: string;
+        }, {
+            confirm: true;
+            group_id: string;
+        }>;
+    };
+    execute(client: PosterlyClient, input: DeletePostInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/delete-post.js

@@ -1,24 +1,60 @@
 import { z } from 'zod';
-import { dashboardUrlForPosts } from '../lib/format.js';
+import { code, dashboardUrlForPosts } from '../lib/format.js';
+import { previewThenConfirm, validateArgs } from '../lib/tool-runtime.js';
 export const deletePostTool = {
     name: 'delete_post',
-    description: 'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE - the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
-        'REQUIRED BEFORE CALLING: Fetch the post with `get_post` first and show the user what will be deleted (caption, account, scheduled time). Get explicit confirmation ("yes delete it", "remove it") before calling. Never delete multiple posts in a single batch without listing each one and confirming the full list.',
+    description: 'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered, and published or currently publishing posts are never deleted. post_id: delete one scheduled or draft post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id; preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
     inputSchema: z.object({
-        post_id: z.number().describe('The post ID to delete'),
-        confirm: z.literal(true).describe('Must be true after explicit user confirmation of the post deletion.'),
+        post_id: z.number().optional().describe('Delete this one post.'),
+        group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead.'),
+        confirm: z
+            .boolean()
+            .optional()
+            .describe('post_id: true after explicit user confirmation of the deletion. group_id: leave out to get a preview; true only with the preview_id after the user approved it.'),
+        preview_id: z.string().optional().describe('group_id: the preview_id from the preview call. Required with confirm: true.'),
     }),
-    async execute(client, input) {
-        if (input.confirm !== true) {
-            throw new Error('Refusing to delete post without confirm=true after explicit user confirmation.');
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        delete_post_group: z.object({
+            group_id: z.string().min(1).max(160),
+            confirm: z.literal(true),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'delete_post', input);
+        if (mode === 'group') {
+            return previewThenConfirm({
+                tool: 'delete_post',
+                action: 'group',
+                args,
+                nonce: false,
+                legacyRefusal: 'Refusing to delete post group without confirm=true after explicit user confirmation.',
+                ctx,
+                // GET /api/v1/posts has no group filter, so the preview says in plain
+                // words which posts match instead of listing them.
+                describe: async () => [
+                    `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. Published posts are never deleted. This cannot be undone.`,
+                    'To see the posts first, call list_posts and check each post\'s group or release ID.',
+                ].join('\n\n'),
+                run: async () => {
+                    const result = await client.deletePostGroup(args.group_id);
+                    return JSON.stringify(result, null, 2);
+                },
+            });
         }
-        const result = await client.deletePost(input.post_id);
-        return [
-            `Post #${result.id} deleted successfully.`,
-            'It has been removed from the posterly queue.',
-            `View queue in posterly: ${dashboardUrlForPosts()}`,
-            '',
-            'Next step for the AI agent: tell the user the post is gone and offer to create, reschedule, or review the next post.',
-        ].join('\n');
+        return deleteOne(client, args);
     },
 };
+async function deleteOne(client, input) {
+    if (input.confirm !== true) {
+        throw new Error('Refusing to delete post without confirm=true after explicit user confirmation.');
+    }
+    const result = await client.deletePost(input.post_id);
+    return [
+        `Post #${result.id} deleted successfully.`,
+        'It has been removed from the posterly queue.',
+        `View queue in posterly: ${dashboardUrlForPosts()}`,
+        '',
+        'Next step for the AI agent: tell the user the post is gone and offer to create, reschedule, or review the next post.',
+    ].join('\n');
+}

package/dist/tools/disconnect-account.d.ts

@@ -7,11 +7,11 @@ export declare const disconnectAccountTool: {
         account_id: z.ZodString;
         confirm: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        account_id: string;
         confirm: boolean;
-    }, {
         account_id: string;
+    }, {
         confirm: boolean;
+        account_id: string;
     }>;
     execute(client: PosterlyClient, input: {
         account_id: string;

package/dist/tools/generate-captions.d.ts

@@ -35,12 +35,12 @@ export declare const generateCaptionsTool: {
         platforms: ("instagram" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business")[];
         workspace_id?: string | undefined;
         count?: number | undefined;
+        mode?: "generate" | "adapt" | undefined;
         social_account_id?: string | undefined;
         brief?: string | undefined;
         tone?: string | undefined;
         allow_emojis?: boolean | undefined;
         hashtag_strategy?: "none" | "smart" | "minimal" | "aggressive" | undefined;
-        mode?: "generate" | "adapt" | undefined;
         source_caption?: string | undefined;
         source_platform?: "instagram" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | undefined;
         preserve_links?: boolean | undefined;
@@ -55,12 +55,12 @@ export declare const generateCaptionsTool: {
         platforms: ("instagram" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business")[];
         workspace_id?: string | undefined;
         count?: number | undefined;
+        mode?: "generate" | "adapt" | undefined;
         social_account_id?: string | undefined;
         brief?: string | undefined;
         tone?: string | undefined;
         allow_emojis?: boolean | undefined;
         hashtag_strategy?: "none" | "smart" | "minimal" | "aggressive" | undefined;
-        mode?: "generate" | "adapt" | undefined;
         source_caption?: string | undefined;
         source_platform?: "instagram" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | undefined;
         preserve_links?: boolean | undefined;

package/dist/tools/generate-image.d.ts

@@ -20,10 +20,10 @@ export declare const generateImageTool: {
         prompt: string;
         provider?: "google" | "xai" | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "4:5" | "1:4" | "1:8" | "21:9" | "4:1" | "8:1" | "5:4" | undefined;
+        resolution?: "512" | "1K" | "2K" | "4K" | undefined;
+        model?: "pro" | "lite" | "flash" | undefined;
         style?: "minimal" | "professional" | "photographic" | "illustration" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
-        model?: "pro" | "lite" | "flash" | undefined;
-        resolution?: "512" | "1K" | "2K" | "4K" | undefined;
         quality?: "low" | "medium" | "high" | undefined;
         thinking_level?: "minimal" | "high" | undefined;
         reference_image_urls?: string[] | undefined;
@@ -32,10 +32,10 @@ export declare const generateImageTool: {
         prompt: string;
         provider?: "google" | "xai" | undefined;
         aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "4:5" | "1:4" | "1:8" | "21:9" | "4:1" | "8:1" | "5:4" | undefined;
+        resolution?: "512" | "1K" | "2K" | "4K" | undefined;
+        model?: "pro" | "lite" | "flash" | undefined;
         style?: "minimal" | "professional" | "photographic" | "illustration" | "vibrant" | "youtube_thumbnail" | "reel_cover" | "review_background" | undefined;
         variations?: number | undefined;
-        model?: "pro" | "lite" | "flash" | undefined;
-        resolution?: "512" | "1K" | "2K" | "4K" | undefined;
         quality?: "low" | "medium" | "high" | undefined;
         thinking_level?: "minimal" | "high" | undefined;
         reference_image_urls?: string[] | undefined;

package/dist/tools/generate-image.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { mdKeyValue, mdTitle } from '../lib/format.js';
 export const generateImageTool = {
     name: 'generate_image',
-    description: 'Queue an AI image job via posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll get_image_job until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price.\n\n' +
+    description: 'Queue an AI image job via posterly using Nano Banana (Gemini) or Grok Imagine Image 2.0 (xAI). Returns job_id. Poll list_jobs with type=image until status is completed, then pass urls to create_post as media_url / media_urls. Gemini thinking high does not change the credit price.\n\n' +
         'COSTS CREDITS. Every call consumes part of the user\'s monthly AI image quota (or purchased credits once the quota is exhausted). Do NOT call speculatively - always describe the image you\'re about to generate (subject, style, aspect ratio, quality/thinking, resolution) to the user and get confirmation before calling.\n\n' +
         'If the user is over their plan limit and has no credits, this tool returns a 402 with upgrade info. Surface that message verbatim - do not retry.\n\n' +
         'Common aspect ratios by platform:\n' +
@@ -80,7 +80,7 @@ export const generateImageTool = {
                 ['Credits used', result.credits_used],
                 ['Billed from', result.usage?.billed_from],
             ]),
-            result.message || 'Poll get_image_job with this job_id until status is completed, then pass urls to create_post.',
+            result.message || 'Poll list_jobs with type=image and this job_id until status is completed, then pass urls to create_post.',
         ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/generate-video.d.ts

@@ -30,11 +30,11 @@ export declare const generateVideoTool: {
         confirm: true;
         prompt: string;
         provider?: "google" | "xai" | undefined;
-        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
-        model?: "lite" | "fast" | "standard" | undefined;
-        resolution?: "480p" | "720p" | "1080p" | undefined;
         negative_prompt?: string | undefined;
+        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
         duration_seconds?: number | undefined;
+        resolution?: "480p" | "720p" | "1080p" | undefined;
+        model?: "lite" | "fast" | "standard" | undefined;
         image_url?: string | undefined;
         end_image_url?: string | undefined;
         reference_images?: {
@@ -47,11 +47,11 @@ export declare const generateVideoTool: {
         confirm: true;
         prompt: string;
         provider?: "google" | "xai" | undefined;
-        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
-        model?: "lite" | "fast" | "standard" | undefined;
-        resolution?: "480p" | "720p" | "1080p" | undefined;
         negative_prompt?: string | undefined;
+        aspect_ratio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | undefined;
         duration_seconds?: number | undefined;
+        resolution?: "480p" | "720p" | "1080p" | undefined;
+        model?: "lite" | "fast" | "standard" | undefined;
         image_url?: string | undefined;
         end_image_url?: string | undefined;
         reference_images?: {

package/dist/tools/generate-video.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export const generateVideoTool = {
     name: 'generate_video',
-    description: 'Queue an AI video generation job with Google Veo 3.1 or xAI Grok Imagine Video 1.5. COSTS CREDITS: confirm provider, prompt, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Grok supports 1–15 seconds and 480p–1080p; reference-to-video is capped at 720p. Poll get_video_job for status and final video_url.',
+    description: 'Queue an AI video generation job with Google Veo 3.1 or xAI Grok Imagine Video 1.5. COSTS CREDITS: confirm provider, prompt, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Grok supports 1 to 15 seconds and 480p to 1080p; reference-to-video is capped at 720p. Poll list_jobs with type=video for status and final video_url.',
     inputSchema: z.object({
         provider: z.enum(['google', 'xai']).default('google').optional(),
         prompt: z.string().min(5).max(4000),

package/dist/tools/get-agent-signup-info.js

@@ -13,14 +13,14 @@ export const getAgentSignupInfoTool = {
             authState,
             '',
             'Pre-auth tools:',
-            '- get_mcp_status: checks the installed server version, latest npm version, MCP endpoint health, API auth health, and whether POSTERLY_API_KEY is configured.',
+            '- whoami with view=status: checks the installed server version, latest npm version, MCP endpoint health, API auth health, and whether POSTERLY_API_KEY is configured.',
             '- start_signup: starts paid signup and returns a signup poll URL, a browser Checkout fallback, and, when enabled, a prepaid PaymentIntent for a Link virtual card (credential_type: card).',
             '- get_signup_session: polls payment, password, and agent-access status.',
             '',
             'After posterly access is installed, onboard the user IN THIS chat (do not send them to /onboarding-v2):',
             '- whoami: confirm the paid account and read onboarding.next_step.',
             '- About you: confirm name and IANA timezone.',
-            '- create_connect_session / get_connect_session: first social account in the browser.',
+            '- create_connect_session, then list_accounts with view=connect_session: first social account in the browser.',
             '- Brand voice: ask how they want to sound, then use that on captions.',
             '- create_post: first scheduled post after validate_post and explicit confirm.',
             '',

package/dist/tools/get-post.d.ts

@@ -1,16 +1,31 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
 export declare const getPostTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
         post_id: z.ZodNumber;
+        view: z.ZodOptional<z.ZodEnum<["post", "missing"]>>;
     }, "strip", z.ZodTypeAny, {
         post_id: number;
+        view?: "post" | "missing" | undefined;
     }, {
         post_id: number;
+        view?: "post" | "missing" | undefined;
     }>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_post_missing: z.ZodObject<{
+            post_id: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            post_id: number;
+        }, {
+            post_id: number;
+        }>;
+    };
     execute(client: PosterlyClient, input: {
         post_id: number;
-    }): Promise<string>;
+        view?: "post" | "missing";
+    }, ctx: ToolContext): Promise<string>;
 };

package/dist/tools/get-post.js

@@ -1,28 +1,44 @@
 import { z } from 'zod';
 import { dashboardUrlForPost, formatLocalDateTime } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 export const getPostTool = {
     name: 'get_post',
-    description: 'Get details of a specific post by ID. Returns caption, status, scheduled time, media, and platform info.',
+    description: 'One post by ID. view=post (default): caption, status, scheduled time, media, and platform info. view=missing: whether the post is missing required content, media, account, platform settings, or metadata before it can publish; use it to repair failed or imported posts.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to look up'),
+        view: z.enum(['post', 'missing']).optional().describe('post (default) or missing.'),
     }),
-    async execute(client, input) {
-        const result = await client.getPost(input.post_id);
-        const p = result.post;
-        const lines = [
-            `Post #${p.id}`,
-            `• Status: ${p.status}`,
-            `• Caption: ${p.content || '(empty)'}`,
-            `• Type: ${p.post_type || 'unknown'}`,
-            `• Scheduled: ${formatLocalDateTime(p.scheduled_at)}`,
-            `• View in posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`,
-        ];
-        if (p.platform_post_url)
-            lines.push(`• Published URL: ${p.platform_post_url}`);
-        if (p.media_url)
-            lines.push(`• Media: ${p.media_url}`);
-        if (p.media_urls?.length)
-            lines.push(`• Media (${p.media_urls.length}): ${p.media_urls.join(', ')}`);
-        return lines.join('\n');
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_post_missing: z.object({ post_id: z.number().int().positive() }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'get_post', input);
+        if (mode === 'missing')
+            return postMissing(client, args);
+        return post(client, args);
     },
 };
+async function post(client, input) {
+    const result = await client.getPost(input.post_id);
+    const p = result.post;
+    const lines = [
+        `Post #${p.id}`,
+        `• Status: ${p.status}`,
+        `• Caption: ${p.content || '(empty)'}`,
+        `• Type: ${p.post_type || 'unknown'}`,
+        `• Scheduled: ${formatLocalDateTime(p.scheduled_at)}`,
+        `• View in posterly: ${dashboardUrlForPost({ id: p.id, scheduled_at: p.scheduled_at })}`,
+    ];
+    if (p.platform_post_url)
+        lines.push(`• Published URL: ${p.platform_post_url}`);
+    if (p.media_url)
+        lines.push(`• Media: ${p.media_url}`);
+    if (p.media_urls?.length)
+        lines.push(`• Media (${p.media_urls.length}): ${p.media_urls.join(', ')}`);
+    return lines.join('\n');
+}
+async function postMissing(client, input) {
+    const result = await client.getPostMissing(input.post_id);
+    return JSON.stringify(result, null, 2);
+}