posterly-mcp-server 0.44.0 → 0.45.0

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

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ManageConversationInput = {
+    action: 'send' | 'sync';
+    conversation_id?: string;
+    content?: string;
+    account_id?: number;
+    sync_type?: 'all' | 'dm' | 'comments';
+    workspace_id?: string;
+    confirm?: boolean;
+    preview_id?: string;
+};
+export declare const manageConversationTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["send", "sync"]>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        sync_type: z.ZodOptional<z.ZodEnum<["all", "dm", "comments"]>>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+        preview_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: "send" | "sync";
+        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";
+        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;
+    }>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        send_message: z.ZodObject<{
+            conversation_id: z.ZodString;
+            content: z.ZodString;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            confirm: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            confirm: true;
+            content: string;
+            conversation_id: string;
+            workspace_id?: string | undefined;
+        }, {
+            confirm: true;
+            content: string;
+            conversation_id: string;
+            workspace_id?: string | undefined;
+        }>;
+        sync_inbox: z.ZodObject<{
+            account_id: z.ZodNumber;
+            sync_type: z.ZodOptional<z.ZodEnum<["all", "dm", "comments"]>>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            account_id: number;
+            workspace_id?: string | undefined;
+            sync_type?: "all" | "dm" | "comments" | undefined;
+        }, {
+            account_id: number;
+            workspace_id?: string | undefined;
+            sync_type?: "all" | "dm" | "comments" | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ManageConversationInput, ctx: ToolContext): Promise<string>;
+};
+export {};

package/dist/tools/manage-conversation.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { code, mdKeyValue, mdQuote, mdSection } from '../lib/format.js';
+import { omitKeys, previewThenConfirm, readFailedNote, readForPreview, validateArgs } from '../lib/tool-runtime.js';
+export const manageConversationTool = {
+    name: 'manage_conversation',
+    description: 'Act on the social inbox (Pro plan or higher plus posts:write). action=send (conversation_id, content): send a DM reply in an Instagram or Facebook Page conversation, honoring the 24-hour messaging window (Threads has no DMs); 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. action=sync (account_id): pull the latest Instagram, Facebook Page, Threads, or LinkedIn inbox data for one account; 30-second cooldown (60 seconds for LinkedIn); Threads and LinkedIn sync comments only.',
+    inputSchema: z.object({
+        action: z.enum(['send', 'sync']).describe('send or sync.'),
+        conversation_id: z.string().min(1).optional().describe('send: conversation ID from list_conversations.'),
+        content: z.string().min(1).optional().describe('send: message text to send.'),
+        account_id: z.number().int().positive().optional().describe('sync: social account ID from list_accounts.'),
+        sync_type: z.enum(['all', 'dm', 'comments']).optional().describe('sync: what to sync. Defaults to all. Threads and LinkedIn are comments-only.'),
+        workspace_id: z.string().optional().describe('Optional. Omit to search every workspace you belong to; pass a workspace ID from whoami to limit to one.'),
+        confirm: z.boolean().optional().describe('send: leave out to get a preview; true only with the preview_id after the user approved it.'),
+        preview_id: z.string().optional().describe('send: the preview_id from the preview call. Required with confirm: true.'),
+    }),
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        send_message: z.object({
+            conversation_id: z.string().min(1),
+            content: z.string().min(1),
+            workspace_id: z.string().optional(),
+            confirm: z.literal(true),
+        }),
+        sync_inbox: z.object({
+            account_id: z.number().int().positive(),
+            sync_type: z.enum(['all', 'dm', 'comments']).optional(),
+            workspace_id: z.string().optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'manage_conversation', input);
+        if (mode === 'sync')
+            return syncInbox(client, args);
+        return previewThenConfirm({
+            tool: 'manage_conversation',
+            action: 'send',
+            args,
+            nonce: true,
+            legacyRefusal: 'Refusing to send an inbox message without confirm=true after explicit user confirmation.',
+            ctx,
+            describe: async () => {
+                const read = await readForPreview(() => client.getConversation({ conversation_id: args.conversation_id, workspace_id: args.workspace_id, limit: 3 }));
+                const header = read.ok
+                    ? mdSection('Conversation', mdKeyValue([
+                        ['Conversation ID', code(String(read.data.conversation.id))],
+                        ['Platform', typeof read.data.conversation.platform === 'string' ? read.data.conversation.platform : 'unknown'],
+                        ['Participant', typeof read.data.conversation.participant_username === 'string' ? `@${read.data.conversation.participant_username}` : 'unknown'],
+                    ]))
+                    : [readFailedNote(read.error), mdKeyValue([['Conversation ID', code(args.conversation_id)]])].join('\n\n');
+                return [
+                    header,
+                    mdSection('Message to send', mdQuote(String(args.content ?? ''))),
+                    'This sends a DM as your account. Instagram and Facebook only allow replies within 24 hours of the person\'s last message.',
+                ].join('\n\n');
+            },
+            run: async () => {
+                const result = await client.sendMessage({
+                    conversation_id: args.conversation_id,
+                    content: args.content,
+                    workspace_id: args.workspace_id,
+                });
+                return `Message sent (message_id ${result.message_id}).`;
+            },
+        });
+    },
+};
+async function syncInbox(client, input) {
+    const result = await client.syncInbox(omitKeys(input, ['action', 'confirm', 'preview_id']));
+    const parts = ['Inbox sync completed.'];
+    const keys = Object.keys(result.results || {});
+    if (keys.length > 0)
+        parts.push(`Synced: ${keys.join(', ')}.`);
+    return parts.join(' ');
+}

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

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+declare const CATEGORIES: readonly ["COVER", "PROFILE", "LOGO", "EXTERIOR", "INTERIOR", "PRODUCT", "AT_WORK", "FOOD_AND_DRINK", "MENU", "COMMON_AREA", "ROOMS", "TEAMS", "ADDITIONAL"];
+type ManageMediaInput = {
+    action: 'add' | 'delete';
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+    source_url?: string;
+    category?: (typeof CATEGORIES)[number];
+    media_format?: 'PHOTO' | 'VIDEO';
+    media_name?: string;
+    confirm?: boolean;
+    preview_id?: string;
+};
+export declare const manageGoogleBusinessMediaTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["add", "delete"]>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        location_id: z.ZodOptional<z.ZodString>;
+        source_url: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodEnum<["COVER", "PROFILE", "LOGO", "EXTERIOR", "INTERIOR", "PRODUCT", "AT_WORK", "FOOD_AND_DRINK", "MENU", "COMMON_AREA", "ROOMS", "TEAMS", "ADDITIONAL"]>>;
+        media_format: z.ZodOptional<z.ZodEnum<["PHOTO", "VIDEO"]>>;
+        media_name: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+        preview_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: "delete" | "add";
+        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;
+        media_format?: "PHOTO" | "VIDEO" | undefined;
+        media_name?: string | undefined;
+    }, {
+        action: "delete" | "add";
+        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;
+        media_format?: "PHOTO" | "VIDEO" | undefined;
+        media_name?: string | undefined;
+    }>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        add_google_business_media: z.ZodObject<{
+            source_url: z.ZodString;
+            category: z.ZodEnum<["COVER", "PROFILE", "LOGO", "EXTERIOR", "INTERIOR", "PRODUCT", "AT_WORK", "FOOD_AND_DRINK", "MENU", "COMMON_AREA", "ROOMS", "TEAMS", "ADDITIONAL"]>;
+            media_format: z.ZodOptional<z.ZodEnum<["PHOTO", "VIDEO"]>>;
+            confirm: z.ZodLiteral<true>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            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;
+            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;
+            location_id?: string | undefined;
+            media_format?: "PHOTO" | "VIDEO" | undefined;
+        }>;
+        delete_google_business_media: z.ZodObject<{
+            media_name: z.ZodString;
+            confirm: z.ZodLiteral<true>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            confirm: true;
+            media_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }, {
+            confirm: true;
+            media_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ManageMediaInput, ctx: ToolContext): Promise<string>;
+};
+export {};

package/dist/tools/manage-google-business-media.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { code, mdKeyValue, mdSection } from '../lib/format.js';
+import { omitKeys, previewThenConfirm, readFailedNote, readForPreview, validateArgs } from '../lib/tool-runtime.js';
+const CATEGORIES = [
+    'COVER',
+    'PROFILE',
+    'LOGO',
+    'EXTERIOR',
+    'INTERIOR',
+    'PRODUCT',
+    'AT_WORK',
+    'FOOD_AND_DRINK',
+    'MENU',
+    'COMMON_AREA',
+    'ROOMS',
+    'TEAMS',
+    'ADDITIONAL',
+];
+const LOCATION_ID_DESCRIPTION = 'Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Prefer account_id.';
+const LEGACY_LOCATION = {
+    workspace_id: z.string().optional(),
+    account_id: z.number().int().positive().optional(),
+    location_id: z.string().optional(),
+};
+function payloadOf(input) {
+    return omitKeys(input, ['action', 'confirm', 'preview_id']);
+}
+function locationRows(input) {
+    return [
+        ['Account ID', input.account_id !== undefined ? code(input.account_id) : undefined],
+        ['Location ID', input.location_id ? code(input.location_id) : undefined],
+        ['Workspace', input.workspace_id ? code(input.workspace_id) : undefined],
+    ];
+}
+export const manageGoogleBusinessMediaTool = {
+    name: 'manage_google_business_media',
+    description: 'Change a Google Business Profile gallery (the photos and videos shown on Maps and Search). action=add (source_url, category): add a photo or video from a public https URL (upload it with upload_media first); COVER and PROFILE are single-slot and replace the existing one. action=delete (media_name from list_google_business_media): permanently remove an item from the public profile. Both use 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.',
+    inputSchema: z.object({
+        action: z.enum(['add', 'delete']).describe('add or delete.'),
+        workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
+        account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts.'),
+        location_id: z.string().optional().describe(LOCATION_ID_DESCRIPTION),
+        source_url: z.string().url().optional().describe('add: public https URL of the photo or video (from upload_media).'),
+        category: z.enum(CATEGORIES).optional().describe('add: which gallery category to add the media to.'),
+        media_format: z.enum(['PHOTO', 'VIDEO']).optional().describe('add: defaults to PHOTO. Use VIDEO for videos (Google caps profile videos at 30s / 75MB).'),
+        media_name: z.string().min(1).optional().describe('delete: full media resource name from list_google_business_media (accounts/.../locations/.../media/...).'),
+        confirm: z.boolean().optional().describe('Leave out to get a preview; true only with the preview_id after the user approved it.'),
+        preview_id: z.string().optional().describe('The preview_id from the preview call. Required with confirm: true.'),
+    }),
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        add_google_business_media: z.object({
+            ...LEGACY_LOCATION,
+            source_url: z.string().url(),
+            category: z.enum(CATEGORIES),
+            media_format: z.enum(['PHOTO', 'VIDEO']).optional(),
+            confirm: z.literal(true),
+        }),
+        delete_google_business_media: z.object({
+            ...LEGACY_LOCATION,
+            media_name: z.string().min(1),
+            confirm: z.literal(true),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'manage_google_business_media', input);
+        const call = args;
+        if (mode === 'delete') {
+            return previewThenConfirm({
+                tool: 'manage_google_business_media',
+                action: 'delete',
+                args,
+                nonce: false,
+                legacyRefusal: 'Refusing to delete Google Business media without confirm=true after explicit user confirmation.',
+                ctx,
+                describe: async () => {
+                    const read = await readForPreview(() => client.listGoogleBusinessMedia({
+                        workspace_id: call.workspace_id,
+                        account_id: call.account_id,
+                        location_id: call.location_id,
+                    }));
+                    const item = read.ok ? (read.data.media || []).find((media) => media?.name === call.media_name) : null;
+                    const details = item
+                        ? mdSection('Media', mdKeyValue([
+                            ['Resource name', code(String(item.name))],
+                            ['Type', item.mediaFormat === 'VIDEO' ? 'video' : 'photo'],
+                            ['Category', item.category || 'uncategorised'],
+                            ...locationRows(call),
+                        ]))
+                        : [
+                            read.ok ? '_This item was not found in the current gallery listing, so the preview shows the request as given._' : readFailedNote(read.error),
+                            mdKeyValue([['Resource name', code(String(call.media_name))], ...locationRows(call)]),
+                        ].join('\n\n');
+                    return [details, 'This permanently removes the item from the public Google Business profile.'].join('\n\n');
+                },
+                run: async () => {
+                    const result = await client.deleteGoogleBusinessMedia(payloadOf(call));
+                    return result.message || 'Media removed from the Google Business profile.';
+                },
+            });
+        }
+        return previewThenConfirm({
+            tool: 'manage_google_business_media',
+            action: 'add',
+            args,
+            nonce: true,
+            legacyRefusal: 'Refusing to add Google Business media without confirm=true after explicit user confirmation.',
+            ctx,
+            describe: async () => [
+                mdSection('Media to add', mdKeyValue([
+                    ['Source URL', call.source_url],
+                    ['Category', call.category],
+                    ['Format', call.media_format || 'PHOTO'],
+                    ...locationRows(call),
+                ])),
+                call.category === 'COVER' || call.category === 'PROFILE'
+                    ? `This adds the item publicly to the Google Business profile and replaces the current ${String(call.category).toLowerCase()} image.`
+                    : 'This adds the item publicly to the Google Business profile gallery on Maps and Search.',
+            ].join('\n\n'),
+            run: async () => {
+                const result = await client.addGoogleBusinessMedia(payloadOf(call));
+                return result.message || 'Media added to the Google Business profile.';
+            },
+        });
+    },
+};

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

@@ -0,0 +1,146 @@
+import { z } from 'zod';
+import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ManageReviewInput = {
+    action: 'suggest_reply' | 'reply' | 'delete_reply';
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+    review_name?: string;
+    comment?: string;
+    review_text?: string;
+    star_rating?: number;
+    reviewer_name?: string;
+    business_name?: string;
+    tone?: 'professional' | 'friendly' | 'apologetic';
+    count?: number;
+    confirm?: boolean;
+    preview_id?: string;
+};
+export declare const manageGoogleBusinessReviewTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["suggest_reply", "reply", "delete_reply"]>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        account_id: z.ZodOptional<z.ZodNumber>;
+        location_id: z.ZodOptional<z.ZodString>;
+        review_name: z.ZodOptional<z.ZodString>;
+        comment: z.ZodOptional<z.ZodString>;
+        review_text: z.ZodOptional<z.ZodString>;
+        star_rating: z.ZodOptional<z.ZodNumber>;
+        reviewer_name: z.ZodOptional<z.ZodString>;
+        business_name: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<["professional", "friendly", "apologetic"]>>;
+        count: z.ZodOptional<z.ZodNumber>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+        preview_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: "suggest_reply" | "reply" | "delete_reply";
+        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;
+        tone?: "professional" | "friendly" | "apologetic" | undefined;
+        review_name?: string | undefined;
+        review_text?: string | undefined;
+        star_rating?: number | undefined;
+        reviewer_name?: string | undefined;
+        business_name?: string | undefined;
+    }, {
+        action: "suggest_reply" | "reply" | "delete_reply";
+        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;
+        tone?: "professional" | "friendly" | "apologetic" | undefined;
+        review_name?: string | undefined;
+        review_text?: string | undefined;
+        star_rating?: number | undefined;
+        reviewer_name?: string | undefined;
+        business_name?: string | undefined;
+    }>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        suggest_google_business_review_reply: z.ZodObject<{
+            review_text: z.ZodOptional<z.ZodString>;
+            star_rating: z.ZodNumber;
+            reviewer_name: z.ZodOptional<z.ZodString>;
+            business_name: z.ZodOptional<z.ZodString>;
+            tone: z.ZodOptional<z.ZodEnum<["professional", "friendly", "apologetic"]>>;
+            count: z.ZodOptional<z.ZodNumber>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            star_rating: number;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            count?: number | undefined;
+            location_id?: string | undefined;
+            tone?: "professional" | "friendly" | "apologetic" | undefined;
+            review_text?: string | undefined;
+            reviewer_name?: string | undefined;
+            business_name?: string | undefined;
+        }, {
+            star_rating: number;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            count?: number | undefined;
+            location_id?: string | undefined;
+            tone?: "professional" | "friendly" | "apologetic" | undefined;
+            review_text?: string | undefined;
+            reviewer_name?: string | undefined;
+            business_name?: string | undefined;
+        }>;
+        reply_google_business_review: z.ZodObject<{
+            review_name: z.ZodString;
+            comment: z.ZodString;
+            confirm: z.ZodLiteral<true>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            confirm: true;
+            comment: string;
+            review_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }, {
+            confirm: true;
+            comment: string;
+            review_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }>;
+        delete_google_business_review_reply: z.ZodObject<{
+            review_name: z.ZodString;
+            confirm: z.ZodLiteral<true>;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            confirm: true;
+            review_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }, {
+            confirm: true;
+            review_name: string;
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ManageReviewInput, ctx: ToolContext): Promise<string>;
+};
+export {};

package/dist/tools/manage-google-business-review.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+import { code, mdKeyValue, mdQuote, mdSection } from '../lib/format.js';
+import { omitKeys, previewThenConfirm, validateArgs } from '../lib/tool-runtime.js';
+const LOCATION_ID_DESCRIPTION = 'Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from list_google_business_reviews view=review_link. Prefer account_id.';
+const LEGACY_LOCATION = {
+    workspace_id: z.string().optional(),
+    account_id: z.number().int().positive().optional(),
+    location_id: z.string().optional(),
+};
+/** Everything the review endpoints accept, without the selector and confirm fields. */
+function payloadOf(input) {
+    return omitKeys(input, ['action', 'confirm', 'preview_id']);
+}
+function locationRows(input) {
+    return [
+        ['Account ID', input.account_id !== undefined ? code(input.account_id) : undefined],
+        ['Location ID', input.location_id ? code(input.location_id) : undefined],
+        ['Workspace', input.workspace_id ? code(input.workspace_id) : undefined],
+    ];
+}
+export const manageGoogleBusinessReviewTool = {
+    name: 'manage_google_business_review',
+    description: 'Act on Google Business Profile reviews. action=suggest_reply (star_rating, optional review_text): short, brand-aware AI reply suggestions; uses the AI Caption Assist allowance and never posts. action=reply (review_name, comment): post or update the owner reply. action=delete_reply (review_name): delete the owner reply. reply and delete_reply use preview then confirm: call without confirm to get a preview and preview_id (it repeats the review name, location, and exact reply text; show the reviewer, rating, and review text from list_google_business_reviews alongside it), then call again with confirm=true and that preview_id.',
+    inputSchema: z.object({
+        action: z.enum(['suggest_reply', 'reply', 'delete_reply']).describe('suggest_reply, reply, or delete_reply.'),
+        workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
+        account_id: z.number().int().positive().optional().describe('Google Business account ID from list_accounts (optional brand voice context for suggest_reply).'),
+        location_id: z.string().optional().describe(LOCATION_ID_DESCRIPTION),
+        review_name: z.string().min(1).optional().describe('reply and delete_reply: full Google review resource name.'),
+        comment: z.string().min(1).max(4096).optional().describe('reply: exact owner reply text to post.'),
+        review_text: z.string().optional().describe('suggest_reply: review text. Leave empty for rating-only reviews.'),
+        star_rating: z.number().min(1).max(5).optional().describe('suggest_reply: review rating from 1 to 5.'),
+        reviewer_name: z.string().optional(),
+        business_name: z.string().optional(),
+        tone: z.enum(['professional', 'friendly', 'apologetic']).optional(),
+        count: z.number().int().min(1).max(5).optional(),
+        confirm: z.boolean().optional().describe('reply and delete_reply: leave out to get a preview; true only with the preview_id after the user approved it.'),
+        preview_id: z.string().optional().describe('reply and delete_reply: the preview_id from the preview call. Required with confirm: true.'),
+    }),
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        suggest_google_business_review_reply: z.object({
+            ...LEGACY_LOCATION,
+            review_text: z.string().optional(),
+            star_rating: z.number().min(1).max(5),
+            reviewer_name: z.string().optional(),
+            business_name: z.string().optional(),
+            tone: z.enum(['professional', 'friendly', 'apologetic']).optional(),
+            count: z.number().int().min(1).max(5).optional(),
+        }),
+        reply_google_business_review: z.object({
+            ...LEGACY_LOCATION,
+            review_name: z.string().min(1),
+            comment: z.string().min(1).max(4096),
+            confirm: z.literal(true),
+        }),
+        delete_google_business_review_reply: z.object({
+            ...LEGACY_LOCATION,
+            review_name: z.string().min(1),
+            confirm: z.literal(true),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'manage_google_business_review', input);
+        const call = args;
+        if (mode === 'suggest_reply')
+            return suggestReply(client, call);
+        if (mode === 'delete_reply') {
+            return previewThenConfirm({
+                tool: 'manage_google_business_review',
+                action: 'delete_reply',
+                args,
+                nonce: false,
+                legacyRefusal: 'Refusing to delete a Google review reply without confirm=true after explicit user confirmation.',
+                ctx,
+                describe: async () => [
+                    mdSection('Review', mdKeyValue([['Review', code(String(call.review_name))], ...locationRows(call)])),
+                    'This deletes the owner reply from this review on Google. The review itself stays.',
+                ].join('\n\n'),
+                run: async () => {
+                    const result = await client.deleteGoogleBusinessReviewReply(payloadOf(call));
+                    return result.message || 'Google Business review reply deleted successfully.';
+                },
+            });
+        }
+        return previewThenConfirm({
+            tool: 'manage_google_business_review',
+            action: 'reply',
+            args,
+            nonce: true,
+            legacyRefusal: 'Refusing to post a Google review reply without confirm=true after explicit user confirmation.',
+            ctx,
+            describe: async () => [
+                mdSection('Review', mdKeyValue([['Review', code(String(call.review_name))], ...locationRows(call)])),
+                mdSection('Owner reply to post', mdQuote(String(call.comment ?? ''))),
+                'This posts publicly on Google as the business owner and replaces any existing owner reply on this review.',
+            ].join('\n\n'),
+            run: async () => {
+                const result = await client.replyGoogleBusinessReview(payloadOf(call));
+                return result.message || 'Google Business review reply posted successfully.';
+            },
+        });
+    },
+};
+async function suggestReply(client, input) {
+    const result = await client.suggestGoogleBusinessReviewReply(payloadOf(input));
+    const suggestions = Array.isArray(result.suggestions) ? result.suggestions : [];
+    if (suggestions.length === 0) {
+        return 'No reply suggestions were generated.';
+    }
+    return [
+        `Suggested replies (${result.tone || 'professional'}, ${result.rating || input.star_rating} stars):`,
+        ...suggestions.map((text, index) => `${index + 1}. ${text}`),
+    ].join('\n');
+}