posterly-mcp-server 0.48.4 → 0.49.0

package/dist/tools/list-post-suggestions.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText } from '../lib/format.js';
+import { formatPagingNote, mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText } from '../lib/format.js';
 export const listPostSuggestionsTool = {
     name: 'list_post_suggestions',
-    description: "List proactive post suggestions: evidence-based weekly drafts posterly writes in each account's learned voice, each with a rationale tying it back to what has performed well for that account. Filter by account_id and status (pending, scheduled, dismissed; default pending). Read-only; requires a Pro plan or higher. Use dismiss_suggestion to hide one.",
+    description: "List proactive post suggestions: evidence-based weekly drafts posterly writes in each account's learned voice, each with a rationale tying it back to what has performed well for that account. Filter by account_id and status (pending, scheduled, dismissed; default pending). The output says whether every matching suggestion is shown; page with offset until it does. Read-only; requires a Pro plan or higher. Use dismiss_suggestion to hide one.",
     inputSchema: z.object({
         account_id: z
             .union([z.string(), z.number()])
@@ -13,9 +13,11 @@ export const listPostSuggestionsTool = {
             .optional()
             .describe('Suggestion status to list (default pending).'),
         limit: z.number().int().min(1).max(100).optional().describe('Max suggestions to return (default 20).'),
+        offset: z.number().int().min(0).optional().describe('How many suggestions to skip. Use the offset the previous page gives to get the next page.'),
     }),
     async execute(client, input) {
-        const { suggestions } = await client.listPostSuggestions(input);
+        const page = await client.listPostSuggestions(input);
+        const { suggestions } = page;
         if (!suggestions.length) {
             return mdEmpty('post suggestions', 'No proactive post suggestions match these filters. posterly generates fresh drafts weekly for accounts with a learned voice.');
         }
@@ -31,6 +33,16 @@ export const listPostSuggestionsTool = {
                 ['Rationale', suggestion.rationale ? truncateText(suggestion.rationale, 240) : undefined],
             ]));
         });
-        return [mdTitle(`Post suggestions (${suggestions.length})`), ...blocks].join('\n\n');
+        const note = formatPagingNote({
+            noun: 'suggestions',
+            tool: 'list_post_suggestions',
+            offset: page.offset ?? input.offset ?? 0,
+            count: suggestions.length,
+            total: page.total,
+            // An API older than has_more: a full page may mean more exist.
+            hasMore: page.has_more ?? suggestions.length >= (input.limit || 20),
+            nextOffset: page.next_offset,
+        });
+        return [mdTitle(`Post suggestions (${suggestions.length})`), ...blocks, note].join('\n\n');
     },
 };

package/dist/tools/list-posts.d.ts

@@ -1,44 +1,62 @@
 import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
+import type { ListPostsParams, PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ListPostsInput = ListPostsParams & {
+    view?: 'list' | 'counts';
+    limit?: number;
+    offset?: number;
+    order?: 'asc' | 'desc';
+};
+export declare const LIST_POSTS_DESCRIPTION: string;
 export declare const listPostsTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        view: z.ZodOptional<z.ZodEnum<["list", "counts"]>>;
         status: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "pinterest", "slack", "telegram", "threads", "tiktok", "twitter", "wordpress", "x", "youtube"]>>;
         account_id: z.ZodOptional<z.ZodString>;
+        scheduled_from: z.ZodOptional<z.ZodString>;
+        scheduled_to: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
         limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
         workspace_id: z.ZodOptional<z.ZodString>;
         approval_status: z.ZodOptional<z.ZodEnum<["none", "pending_client", "approved", "changes_requested", "rejected"]>>;
         approval_waiting_on: z.ZodOptional<z.ZodEnum<["client", "team"]>>;
         brand_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" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
         status?: string | undefined;
-        workspace_id?: string | 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;
         account_id?: string | undefined;
-        limit?: number | undefined;
+        workspace_id?: string | undefined;
         approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
         approval_waiting_on?: "client" | "team" | undefined;
         brand_id?: string | undefined;
+        scheduled_from?: string | undefined;
+        scheduled_to?: string | undefined;
+        timezone?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        order?: "asc" | "desc" | undefined;
+        view?: "list" | "counts" | 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;
         status?: string | undefined;
-        workspace_id?: string | 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;
         account_id?: string | undefined;
-        limit?: number | undefined;
+        workspace_id?: string | undefined;
         approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
         approval_waiting_on?: "client" | "team" | undefined;
         brand_id?: string | undefined;
+        scheduled_from?: string | undefined;
+        scheduled_to?: string | undefined;
+        timezone?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        order?: "asc" | "desc" | undefined;
+        view?: "list" | "counts" | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        status?: string;
-        platform?: string;
-        account_id?: string;
-        limit?: number;
-        workspace_id?: string;
-        approval_status?: string;
-        approval_waiting_on?: "client" | "team";
-        brand_id?: string;
-    }): Promise<string>;
+    execute(client: PosterlyClient, input: ListPostsInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/list-posts.js

@@ -1,10 +1,20 @@
 import { z } from 'zod';
-import { dashboardUrlForPostList, formatLocalDateTime, truncateText } from '../lib/format.js';
+import { dashboardUrlForPostList, formatPostCounts, formatPostListPage } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+export const LIST_POSTS_DESCRIPTION = 'Posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to. ' +
+    'view=list (default): posts filtered by status (scheduled, published, failed, draft), platform, account_id, workspace_id, brand_id, approval_status, approval_waiting_on, and a scheduled date range: scheduled_from (inclusive) and scheduled_to (a plain date includes that whole day), read in timezone (IANA, default UTC; also the zone times are shown in). Returns limit posts (default 20, max 200) starting at offset; with a date range the order defaults to oldest first (order=asc|desc). ' +
+    'The output always says whether every matching post was shown. If it says more are available, call again with the offset it gives and keep paging until all are shown before drawing any conclusion about totals, gaps, or how busy a client is. ' +
+    'view=counts (scheduled_from and scheduled_to required, up to 366 days): exact totals per day, status, account, and brand for the same filters (limit, offset, and order are ignored); use it for "how many" or "is this month full" questions. ' +
+    'approval_waiting_on=client is the same queue as approval_status=pending_client. Each post includes approval.pending_client_approval.';
 export const listPostsTool = {
     name: 'list_posts',
-    description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, approval_waiting_on, or brand_id. approval_waiting_on=client is the same queue as approval_status=pending_client. Each post includes approval.pending_client_approval. Returns posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to.',
+    description: LIST_POSTS_DESCRIPTION,
     inputSchema: z.object({
+        view: z
+            .enum(['list', 'counts'])
+            .optional()
+            .describe('list (default): the posts themselves, one page at a time. counts: exact totals per day, status, account, and brand (needs scheduled_from and scheduled_to).'),
         status: z
             .string()
             .optional()
@@ -17,12 +27,34 @@ export const listPostsTool = {
             .string()
             .optional()
             .describe('Filter to a specific social account ID (from list_accounts).'),
+        scheduled_from: z
+            .string()
+            .optional()
+            .describe('Start of the scheduled range, inclusive: a date (2026-10-01) or an ISO date-time. Plain dates and times without an offset are read in timezone.'),
+        scheduled_to: z
+            .string()
+            .optional()
+            .describe('End of the scheduled range: a plain date (2026-10-31) includes that whole day; an ISO date-time is exclusive.'),
+        timezone: z
+            .string()
+            .optional()
+            .describe('IANA time zone such as Europe/London for reading plain dates and showing times. Default UTC.'),
+        order: z
+            .enum(['asc', 'desc'])
+            .optional()
+            .describe('asc (oldest first) or desc (newest first). Default asc with a date range, otherwise desc. Ignored by view=counts.'),
         limit: z
             .number()
             .min(1)
-            .max(100)
+            .max(200)
             .optional()
-            .describe('Number of posts to return (default 20, max 100)'),
+            .describe('Posts per page (default 20, max 200). Ignored by view=counts.'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('How many matching posts to skip. Use the offset the previous page gives to get the next page. Ignored by view=counts.'),
         workspace_id: z
             .string()
             .optional()
@@ -40,36 +72,34 @@ export const listPostsTool = {
             .optional()
             .describe('Filter to posts assigned to a specific brand/client (the id from list_brands).'),
     }),
-    async execute(client, input) {
-        const { posts, total } = await client.listPosts({
-            ...input,
-            limit: input.limit || 20,
-        });
-        if (posts.length === 0) {
-            return 'No posts found matching your criteria.\n\nNext step for the AI agent: tell the user their posterly queue is clear for that filter, then ask what they want to schedule next.';
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_posts', input);
+        const filters = postFilters(args);
+        const timeZone = filters.timezone || 'UTC';
+        if (mode === 'counts') {
+            return formatPostCounts(await client.countPosts(filters));
         }
-        const lines = posts.map((p) => {
-            const date = formatLocalDateTime(p.scheduled_at);
-            const caption = truncateText(p.content, 60);
-            const approvalBits = [];
-            if (p.approval && p.approval.status !== 'none') {
-                approvalBits.push(`approval: ${p.approval.status}`);
-                if (p.approval.waiting_on)
-                    approvalBits.push(`waiting on: ${p.approval.waiting_on}`);
-            }
-            if (p.brand_id)
-                approvalBits.push(`brand: ${p.brand_id}`);
-            if (p.content_plan_id)
-                approvalBits.push(`plan: ${p.content_plan_id}`);
-            const approvalSuffix = approvalBits.length > 0 ? ` [${approvalBits.join(', ')}]` : '';
-            return `• [${p.status}] #${p.id}: ${caption} (${date})${approvalSuffix}`;
+        const hasRange = Boolean(filters.scheduled_from || filters.scheduled_to);
+        const page = await client.listPosts({
+            ...filters,
+            limit: args.limit || 20,
+            offset: args.offset,
+            order: args.order ?? (hasRange ? 'asc' : undefined),
         });
-        return [
-            `Posts (${posts.length} of ${total}):`,
-            ...lines,
-            '',
-            `View in posterly: ${dashboardUrlForPostList(posts)}`,
-            'Next step for the AI agent: summarize the queue in plain language and use the dashboard link above if the user wants to inspect it in posterly.',
-        ].join('\n');
+        return formatPostListPage(page, { timeZone, dashboardUrl: dashboardUrlForPostList(page.posts || []) });
     },
 };
+function postFilters(input) {
+    return {
+        status: input.status,
+        platform: input.platform,
+        account_id: input.account_id,
+        workspace_id: input.workspace_id,
+        approval_status: input.approval_status,
+        approval_waiting_on: input.approval_waiting_on,
+        brand_id: input.brand_id,
+        scheduled_from: input.scheduled_from,
+        scheduled_to: input.scheduled_to,
+        timezone: input.timezone,
+    };
+}

package/dist/tools/list-publishing-pauses.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { PosterlyClient, PublishingPauseChangeResponse, PublishingPauseState, PublishMissedResponse } from '../lib/api-client.js';
+export declare function formatPublishingPauseState(data: PublishingPauseState): string;
+export declare function formatPublishingPauseChange(data: PublishingPauseChangeResponse): string;
+export declare function formatPublishMissed(data: PublishMissedResponse): string;
+export declare const listPublishingPausesTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        workspace_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        workspace_id?: string | undefined;
+    }, {
+        workspace_id?: string | undefined;
+    }>;
+    execute(client: PosterlyClient, input: {
+        workspace_id?: string;
+    }): Promise<string>;
+};

package/dist/tools/list-publishing-pauses.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+// Plain-text output shared by list_publishing_pauses and
+// manage_publishing_pause. The hosted endpoint (lib/mcp/http-tools.ts) renders
+// the same text from the same API responses; scripts/test-publishing-pause-api.ts
+// checks the two surfaces match.
+function yesNo(value) {
+    return value ? 'yes' : 'no';
+}
+function idList(ids) {
+    return Array.isArray(ids) && ids.length > 0 ? ids.join(', ') : 'none';
+}
+function scopeText(data) {
+    if (data.scope === 'brand')
+        return `brand ${data.brand_name ? `${data.brand_name} ` : ''}(${data.brand_id})`;
+    return `the workspace ${data.workspace_name ? `${data.workspace_name} ` : ''}(${data.workspace_id})`;
+}
+export function formatPublishingPauseState(data) {
+    const workspace = data.workspace;
+    const brands = Array.isArray(data.brands) ? data.brands : [];
+    const viewer = data.viewer;
+    return [
+        `Publishing pause for ${workspace.name || 'this workspace'} (${workspace.id})`,
+        `Workspace: ${workspace.paused ? `paused since ${workspace.paused_at}` : 'publishing normally'}`,
+        brands.length > 0
+            ? ['Paused brands:', ...brands.map((brand) => `- ${brand.name || 'Unnamed brand'} (${brand.id}), paused since ${brand.paused_at}`)].join('\n')
+            : 'Paused brands: none',
+        `Your role: ${viewer.role}. Pause the workspace: ${yesNo(viewer.can_pause_workspace)}. Pause a brand: ${yesNo(viewer.can_pause_brand)}. Resume and publish missed posts: ${yesNo(viewer.can_resume)}.`,
+        'While paused, nothing in that scope publishes (scheduled posts are held, Post now is refused). Pause and resume with manage_publishing_pause.',
+    ].join('\n');
+}
+export function formatPublishingPauseChange(data) {
+    if (data.requires_confirmation) {
+        return [
+            'Preview only: nothing has changed yet.',
+            data.error || '',
+            `Scope: ${scopeText(data)}`,
+            `Scheduled posts to hold: ${typeof data.scheduled_posts_to_hold === 'number' ? data.scheduled_posts_to_hold : 'unknown'}`,
+            `Already paused: ${yesNo(data.already_paused)}`,
+            'Next step: show this to the user. Only after they agree, call manage_publishing_pause again with action=pause, the same fields, and confirm=true.',
+        ].filter(Boolean).join('\n');
+    }
+    if (data.action === 'pause') {
+        const failed = data.failed_post_ids || [];
+        return [
+            `Publishing paused for ${scopeText(data)}.`,
+            `Held posts: ${data.held_count ?? 0}`,
+            failed.length > 0 ? `Posts that could not be marked as held (the publish guard still holds them): ${idList(failed)}` : '',
+            data.message || '',
+        ].filter(Boolean).join('\n');
+    }
+    const missed = data.missed_post_ids || [];
+    const failed = data.failed_post_ids || [];
+    return [
+        `Publishing resumed for ${scopeText(data)}.`,
+        `Scheduled again: ${data.resumed_count ?? 0}`,
+        `Missed their time while paused (still paused): ${missed.length}${missed.length > 0 ? ` [post IDs: ${idList(missed)}]` : ''}`,
+        `Still held by another pause: ${data.still_held_count ?? 0}`,
+        (data.disconnected_count ?? 0) > 0 ? `Still paused because the account is disconnected: ${data.disconnected_count}` : '',
+        failed.length > 0 ? `Could not be released (try resume again): ${idList(failed)}` : '',
+        missed.length > 0
+            ? 'Next step: missed posts never publish on their own. Ask the user whether to publish them now (action=publish_missed with these post_ids and confirm=true) or reschedule them.'
+            : '',
+    ].filter(Boolean).join('\n');
+}
+export function formatPublishMissed(data) {
+    return [
+        `Missed posts: ${data.started} publishing now, ${data.skipped} skipped.`,
+        data.message || '',
+    ].filter(Boolean).join('\n');
+}
+export const listPublishingPausesTool = {
+    name: 'list_publishing_pauses',
+    description: 'Is publishing paused? Shows whether the workspace is paused, which brands are paused (only brands you can see), and whether you may pause, resume, or publish missed posts. Read-only. Change it with manage_publishing_pause.',
+    inputSchema: z.object({
+        workspace_id: z.string().optional().describe('Workspace ID from whoami. Defaults to your default workspace.'),
+    }),
+    async execute(client, input) {
+        const state = await client.getPublishingPause(input.workspace_id ? { workspace_id: input.workspace_id } : undefined);
+        return formatPublishingPauseState(state);
+    },
+};

package/dist/tools/manage-comment.d.ts

@@ -28,9 +28,9 @@ export declare const manageCommentTool: {
     }, "strip", z.ZodTypeAny, {
         action: "update" | "delete" | "reply";
         comment_id: string;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
         type?: "public" | "private" | undefined;
         content?: string | undefined;
         is_hidden?: boolean | undefined;
@@ -38,9 +38,9 @@ export declare const manageCommentTool: {
     }, {
         action: "update" | "delete" | "reply";
         comment_id: string;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
         type?: "public" | "private" | undefined;
         content?: string | undefined;
         is_hidden?: boolean | undefined;

package/dist/tools/manage-conversation.d.ts

@@ -25,19 +25,19 @@ export declare const manageConversationTool: {
         preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         action: "send" | "sync";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         content?: string | undefined;
         conversation_id?: string | undefined;
         sync_type?: "all" | "dm" | "comments" | undefined;
     }, {
         action: "send" | "sync";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         content?: string | undefined;
         conversation_id?: string | undefined;
         sync_type?: "all" | "dm" | "comments" | undefined;

package/dist/tools/manage-google-business-media.d.ts

@@ -30,10 +30,10 @@ export declare const manageGoogleBusinessMediaTool: {
         preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         action: "delete" | "add";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         location_id?: string | undefined;
         category?: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL" | undefined;
         source_url?: string | undefined;
@@ -41,10 +41,10 @@ export declare const manageGoogleBusinessMediaTool: {
         media_name?: string | undefined;
     }, {
         action: "delete" | "add";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         location_id?: string | undefined;
         category?: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL" | undefined;
         source_url?: string | undefined;
@@ -65,16 +65,16 @@ export declare const manageGoogleBusinessMediaTool: {
             confirm: true;
             category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
             source_url: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
             media_format?: "PHOTO" | "VIDEO" | undefined;
         }, {
             confirm: true;
             category: "COVER" | "PROFILE" | "LOGO" | "EXTERIOR" | "INTERIOR" | "PRODUCT" | "AT_WORK" | "FOOD_AND_DRINK" | "MENU" | "COMMON_AREA" | "ROOMS" | "TEAMS" | "ADDITIONAL";
             source_url: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
             media_format?: "PHOTO" | "VIDEO" | undefined;
         }>;
@@ -87,14 +87,14 @@ export declare const manageGoogleBusinessMediaTool: {
         }, "strip", z.ZodTypeAny, {
             confirm: true;
             media_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }, {
             confirm: true;
             media_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }>;
     };

package/dist/tools/manage-google-business-review.d.ts

@@ -37,10 +37,10 @@ export declare const manageGoogleBusinessReviewTool: {
         preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         action: "suggest_reply" | "reply" | "delete_reply";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         count?: number | undefined;
         location_id?: string | undefined;
         comment?: string | undefined;
@@ -52,10 +52,10 @@ export declare const manageGoogleBusinessReviewTool: {
         business_name?: string | undefined;
     }, {
         action: "suggest_reply" | "reply" | "delete_reply";
+        account_id?: number | undefined;
+        workspace_id?: string | undefined;
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
-        workspace_id?: string | undefined;
-        account_id?: number | undefined;
         count?: number | undefined;
         location_id?: string | undefined;
         comment?: string | undefined;
@@ -80,8 +80,8 @@ export declare const manageGoogleBusinessReviewTool: {
             location_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             star_rating: number;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             count?: number | undefined;
             location_id?: string | undefined;
             tone?: "professional" | "friendly" | "apologetic" | undefined;
@@ -90,8 +90,8 @@ export declare const manageGoogleBusinessReviewTool: {
             business_name?: string | undefined;
         }, {
             star_rating: number;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             count?: number | undefined;
             location_id?: string | undefined;
             tone?: "professional" | "friendly" | "apologetic" | undefined;
@@ -110,15 +110,15 @@ export declare const manageGoogleBusinessReviewTool: {
             confirm: true;
             comment: string;
             review_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }, {
             confirm: true;
             comment: string;
             review_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }>;
         delete_google_business_review_reply: z.ZodObject<{
@@ -130,14 +130,14 @@ export declare const manageGoogleBusinessReviewTool: {
         }, "strip", z.ZodTypeAny, {
             confirm: true;
             review_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }, {
             confirm: true;
             review_name: string;
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }>;
     };

package/dist/tools/manage-publishing-pause.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ManagePublishingPauseInput = {
+    action: 'pause' | 'resume' | 'publish_missed';
+    workspace_id?: string;
+    brand_id?: string;
+    post_ids?: number[];
+    confirm?: boolean;
+};
+export declare const managePublishingPauseTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["pause", "resume", "publish_missed"]>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        brand_id: z.ZodOptional<z.ZodString>;
+        post_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        action: "pause" | "resume" | "publish_missed";
+        workspace_id?: string | undefined;
+        brand_id?: string | undefined;
+        confirm?: boolean | undefined;
+        post_ids?: number[] | undefined;
+    }, {
+        action: "pause" | "resume" | "publish_missed";
+        workspace_id?: string | undefined;
+        brand_id?: string | undefined;
+        confirm?: boolean | undefined;
+        post_ids?: number[] | undefined;
+    }>;
+    execute(client: PosterlyClient, input: ManagePublishingPauseInput, ctx: ToolContext): Promise<string>;
+};
+export {};

package/dist/tools/manage-publishing-pause.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { validateArgs } from '../lib/tool-runtime.js';
+import { formatPublishingPauseChange, formatPublishMissed } from './list-publishing-pauses.js';
+/** Same wording as EMPTY_BRAND_ID_MESSAGE in lib/publish/publishing-pause-service.ts. */
+const EMPTY_BRAND_ID_MESSAGE = 'brand_id is empty; omit it to target the whole workspace.';
+export const managePublishingPauseTool = {
+    name: 'manage_publishing_pause',
+    description: 'Pause or resume publishing for a whole workspace or one brand (check it first with list_publishing_pauses). Only act when the user asks; never pause on your own initiative. action=pause (optional brand_id; leave it out for the whole workspace): holds every scheduled post in that scope and blocks Post now until an admin resumes. Call it first without confirm to get a preview (scope and how many scheduled posts it holds), show it to the user, and only after they agree call again with confirm=true. Publisher or higher; a seat limited to some brands can only pause those brands. action=resume (optional brand_id; admin or higher): future posts are scheduled again; posts whose time passed while paused stay paused and are listed as missed. Missed posts never publish on their own. action=publish_missed (post_ids from the resume, confirm=true after the user agrees; admin or higher): publishes those missed posts now.',
+    inputSchema: z.object({
+        action: z.enum(['pause', 'resume', 'publish_missed']).describe('pause, resume, or publish_missed.'),
+        workspace_id: z.string().optional().describe('Workspace ID from whoami. Defaults to your default workspace.'),
+        brand_id: z.string().optional().describe('pause and resume: a brand ID from list_brands. Leave it out (never empty) for the whole workspace.'),
+        post_ids: z.array(z.number().int().positive()).max(500).optional().describe('publish_missed: the missed post IDs a resume returned.'),
+        confirm: z.boolean().optional().describe('pause: leave out to get a preview; true only after the user agreed. publish_missed: true after the user agreed. resume: not needed.'),
+    }),
+    async execute(client, input, ctx) {
+        // A present but empty brand_id is refused, never read as the whole
+        // workspace (same rule and wording as the API and the hosted endpoint).
+        if ((input?.action === 'pause' || input?.action === 'resume') && input && Object.prototype.hasOwnProperty.call(input, 'brand_id')) {
+            const value = input.brand_id;
+            if (value === null || (typeof value === 'string' && value.trim() === ''))
+                throw new Error(EMPTY_BRAND_ID_MESSAGE);
+        }
+        const { mode, args } = validateArgs(ctx, 'manage_publishing_pause', input);
+        const call = args;
+        const workspace = call.workspace_id ? { workspace_id: call.workspace_id } : {};
+        if (mode === 'publish_missed') {
+            if (call.confirm !== true) {
+                throw new Error('Refusing to publish missed posts without confirm=true after explicit user confirmation.');
+            }
+            const result = await client.publishMissedPausedPosts({ ...workspace, post_ids: call.post_ids || [], confirm: true });
+            return formatPublishMissed(result);
+        }
+        const brand = call.brand_id ? { brand_id: call.brand_id } : {};
+        if (mode === 'pause') {
+            const result = await client.changePublishingPause({
+                action: 'pause',
+                ...workspace,
+                ...brand,
+                ...(call.confirm === true ? { confirm: true } : {}),
+            });
+            return formatPublishingPauseChange(result);
+        }
+        const result = await client.changePublishingPause({ action: 'resume', ...workspace, ...brand });
+        return formatPublishingPauseChange(result);
+    },
+};