posterly-mcp-server 0.44.0 → 0.45.0

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

@@ -1,9 +1,21 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type CommentsInput = {
+    comment_id?: string;
+    workspace_id?: string;
+    account_id?: number;
+    platform?: 'instagram' | 'facebook' | 'threads' | 'linkedin';
+    filter?: 'all' | 'unread' | 'flagged';
+    search?: string;
+    limit?: number;
+    offset?: number;
+};
 export declare const listCommentsTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        comment_id: z.ZodOptional<z.ZodString>;
         workspace_id: z.ZodOptional<z.ZodString>;
         account_id: z.ZodOptional<z.ZodNumber>;
         platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads", "linkedin"]>>;
@@ -19,6 +31,7 @@ export declare const listCommentsTool: {
         offset?: number | undefined;
         filter?: "all" | "unread" | "flagged" | undefined;
         search?: string | undefined;
+        comment_id?: string | undefined;
     }, {
         platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
         workspace_id?: string | undefined;
@@ -27,14 +40,21 @@ export declare const listCommentsTool: {
         offset?: number | undefined;
         filter?: "all" | "unread" | "flagged" | undefined;
         search?: string | undefined;
+        comment_id?: string | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        workspace_id?: string;
-        account_id?: number;
-        platform?: "instagram" | "facebook" | "threads" | "linkedin";
-        filter?: "all" | "unread" | "flagged";
-        search?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<string>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_comment: z.ZodObject<{
+            comment_id: z.ZodString;
+            workspace_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            comment_id: string;
+            workspace_id?: string | undefined;
+        }, {
+            comment_id: string;
+            workspace_id?: string | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: CommentsInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/list-comments.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { truncateText } from '../lib/format.js';
+import { formatLocalDateTime, truncateText } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads', 'linkedin'];
 /**
  * The shared `InboxConversationsResponse`/`InboxCommentsResponse` types
@@ -20,8 +21,9 @@ function describeSkippedWorkspaces(result) {
 }
 export const listCommentsTool = {
     name: 'list_comments',
-    description: 'List social inbox comments and replies for Instagram, Facebook Pages, Threads, and LinkedIn Pages. Filter by account, platform, unread/flagged, or search. Requires a Pro plan or higher plus posts:read.',
+    description: 'Social inbox comments and replies for Instagram, Facebook Pages, Threads, and LinkedIn Pages (Pro plan or higher plus posts:read). Without comment_id: list comments filtered by account, platform, unread/flagged, or search, with limit/offset paging. With comment_id: one comment and its replies; only workspace_id may be added.',
     inputSchema: z.object({
+        comment_id: z.string().min(1).optional().describe('One comment (from a list call) with its replies.'),
         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.'),
         account_id: z.number().int().positive().optional().describe('Social account ID from list_accounts.'),
         platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram, facebook, threads, or linkedin.'),
@@ -30,37 +32,76 @@ export const listCommentsTool = {
         limit: z.number().int().min(1).max(100).optional().describe('Number of comments to return. Default 50, max 100.'),
         offset: z.number().int().min(0).optional().describe('Skip this many comments before returning results.'),
     }),
-    async execute(client, input) {
-        const result = await client.listComments(input);
-        const skippedNote = describeSkippedWorkspaces(result);
-        if (result.comments.length === 0) {
-            return [
-                'No inbox comments found matching your filters.',
-                skippedNote,
-            ].filter(Boolean).join('\n\n');
-        }
-        const lines = [`Inbox comments (showing ${result.comments.length} of ${result.total}):`];
-        for (const comment of result.comments) {
-            const author = typeof comment.author_username === 'string' ? `@${comment.author_username}` : 'unknown';
-            const platform = typeof comment.platform === 'string' ? comment.platform : 'unknown';
-            const flags = [];
-            if (comment.is_read === false)
-                flags.push('unread');
-            if (comment.is_hidden)
-                flags.push('hidden');
-            if (comment.is_flagged)
-                flags.push('flagged');
-            const flagLabel = flags.length > 0 ? `, ${flags.join(', ')}` : '';
-            const text = truncateText(typeof comment.content === 'string' ? comment.content : '', 80);
-            const replies = Array.isArray(comment.replies) ? comment.replies.length : 0;
-            lines.push(`- ${String(comment.id)} (${platform}, ${author}${flagLabel}${replies ? `, ${replies} replies` : ''}): ${text}`);
-        }
-        if (result.hasMore) {
-            const nextOffset = (input.offset ?? 0) + result.comments.length;
-            lines.push('', `More comments available. Call again with offset: ${nextOffset}.`);
-        }
-        if (skippedNote)
-            lines.push('', skippedNote);
-        return lines.join('\n');
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_comment: z.object({
+            comment_id: z.string().min(1),
+            workspace_id: z.string().optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_comments', input);
+        if (mode === 'comment')
+            return oneComment(client, args);
+        return commentList(client, args);
     },
 };
+async function commentList(client, input) {
+    const result = await client.listComments(input);
+    const skippedNote = describeSkippedWorkspaces(result);
+    if (result.comments.length === 0) {
+        return [
+            'No inbox comments found matching your filters.',
+            skippedNote,
+        ].filter(Boolean).join('\n\n');
+    }
+    const lines = [`Inbox comments (showing ${result.comments.length} of ${result.total}):`];
+    for (const comment of result.comments) {
+        const author = typeof comment.author_username === 'string' ? `@${comment.author_username}` : 'unknown';
+        const platform = typeof comment.platform === 'string' ? comment.platform : 'unknown';
+        const flags = [];
+        if (comment.is_read === false)
+            flags.push('unread');
+        if (comment.is_hidden)
+            flags.push('hidden');
+        if (comment.is_flagged)
+            flags.push('flagged');
+        const flagLabel = flags.length > 0 ? `, ${flags.join(', ')}` : '';
+        const text = truncateText(typeof comment.content === 'string' ? comment.content : '', 80);
+        const replies = Array.isArray(comment.replies) ? comment.replies.length : 0;
+        lines.push(`- ${String(comment.id)} (${platform}, ${author}${flagLabel}${replies ? `, ${replies} replies` : ''}): ${text}`);
+    }
+    if (result.hasMore) {
+        const nextOffset = (input.offset ?? 0) + result.comments.length;
+        lines.push('', `More comments available. Call again with offset: ${nextOffset}.`);
+    }
+    if (skippedNote)
+        lines.push('', skippedNote);
+    return lines.join('\n');
+}
+async function oneComment(client, input) {
+    const result = await client.getComment(input);
+    const comment = result.comment;
+    const author = typeof comment.author_username === 'string' ? `@${comment.author_username}` : 'unknown';
+    const lines = [
+        `Comment ${String(comment.id)}`,
+        `• Platform: ${typeof comment.platform === 'string' ? comment.platform : 'unknown'}`,
+        `• Author: ${author}`,
+        `• Hidden: ${comment.is_hidden ? 'yes' : 'no'}`,
+        `• Read: ${comment.is_read === false ? 'no' : 'yes'}`,
+        `• Posted: ${formatLocalDateTime(typeof comment.posted_at === 'string' ? comment.posted_at : null)}`,
+        `• Content: ${typeof comment.content === 'string' ? comment.content : '(empty)'}`,
+    ];
+    if (typeof comment.media_permalink === 'string')
+        lines.push(`• Media: ${comment.media_permalink}`);
+    const replies = Array.isArray(comment.replies) ? comment.replies : [];
+    if (replies.length > 0) {
+        lines.push('', `Replies (${replies.length}):`);
+        for (const reply of replies) {
+            const row = reply;
+            const replyAuthor = typeof row.author_username === 'string' ? `@${row.author_username}` : 'unknown';
+            lines.push(`- ${String(row.id)} ${replyAuthor}: ${typeof row.content === 'string' ? row.content : '(empty)'}`);
+        }
+    }
+    return lines.join('\n');
+}

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

@@ -1,9 +1,21 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ConversationsInput = {
+    conversation_id?: string;
+    workspace_id?: string;
+    account_id?: number;
+    platform?: 'instagram' | 'facebook' | 'threads';
+    filter?: 'all' | 'unread' | 'starred' | 'archived';
+    search?: string;
+    limit?: number;
+    offset?: number;
+};
 export declare const listConversationsTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        conversation_id: z.ZodOptional<z.ZodString>;
         workspace_id: z.ZodOptional<z.ZodString>;
         account_id: z.ZodOptional<z.ZodNumber>;
         platform: z.ZodOptional<z.ZodEnum<["instagram", "facebook", "threads"]>>;
@@ -19,6 +31,7 @@ export declare const listConversationsTool: {
         offset?: number | undefined;
         filter?: "all" | "unread" | "starred" | "archived" | undefined;
         search?: string | undefined;
+        conversation_id?: string | undefined;
     }, {
         platform?: "instagram" | "facebook" | "threads" | undefined;
         workspace_id?: string | undefined;
@@ -27,14 +40,24 @@ export declare const listConversationsTool: {
         offset?: number | undefined;
         filter?: "all" | "unread" | "starred" | "archived" | undefined;
         search?: string | undefined;
+        conversation_id?: string | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        workspace_id?: string;
-        account_id?: number;
-        platform?: "instagram" | "facebook" | "threads";
-        filter?: "all" | "unread" | "starred" | "archived";
-        search?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<string>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_conversation: z.ZodObject<{
+            conversation_id: z.ZodString;
+            workspace_id: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            conversation_id: string;
+            workspace_id?: string | undefined;
+            limit?: number | undefined;
+        }, {
+            conversation_id: string;
+            workspace_id?: string | undefined;
+            limit?: number | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ConversationsInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/list-conversations.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { truncateText } from '../lib/format.js';
+import { formatLocalDateTime, truncateText } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 const INBOX_PLATFORMS = ['instagram', 'facebook', 'threads'];
 /**
  * The shared `InboxConversationsResponse`/`InboxCommentsResponse` types
@@ -20,39 +21,74 @@ function describeSkippedWorkspaces(result) {
 }
 export const listConversationsTool = {
     name: 'list_conversations',
-    description: 'List social inbox DM conversations for Instagram and Facebook Page inboxes. Filter by account, platform, unread/starred/archived, or search. Requires a Pro plan or higher plus posts:read. Threads has no DMs.',
+    description: 'Social inbox DM conversations for Instagram and Facebook Page inboxes (Threads has no DMs; Pro plan or higher plus posts:read). Without conversation_id: list conversations filtered by account, platform, unread/starred/archived, or search, with limit/offset paging. With conversation_id: one conversation and its messages; there limit is the number of messages (default 50, max 100) and only workspace_id may be added.',
     inputSchema: z.object({
+        conversation_id: z.string().min(1).optional().describe('One conversation (from a list call) with its messages.'),
         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.'),
         account_id: z.number().int().positive().optional().describe('Social account ID from list_accounts.'),
         platform: z.enum(INBOX_PLATFORMS).optional().describe('instagram or facebook. Threads has no DMs.'),
         filter: z.enum(['all', 'unread', 'starred', 'archived']).optional().describe('Conversation filter. Defaults to all (excludes archived).'),
         search: z.string().optional().describe('Search participant username or last message preview.'),
-        limit: z.number().int().min(1).max(100).optional().describe('Number of conversations to return. Default 50, max 100.'),
+        limit: z.number().int().min(1).max(100).optional().describe('Conversations to return, or messages with conversation_id. Default 50, max 100.'),
         offset: z.number().int().min(0).optional().describe('Skip this many conversations before returning results.'),
     }),
-    async execute(client, input) {
-        const result = await client.listConversations(input);
-        const skippedNote = describeSkippedWorkspaces(result);
-        if (result.conversations.length === 0) {
-            return [
-                'No inbox conversations found matching your filters.',
-                skippedNote,
-            ].filter(Boolean).join('\n\n');
-        }
-        const lines = [`Inbox conversations (showing ${result.conversations.length} of ${result.total}):`];
-        for (const conversation of result.conversations) {
-            const username = typeof conversation.participant_username === 'string' ? `@${conversation.participant_username}` : 'unknown';
-            const platform = typeof conversation.platform === 'string' ? conversation.platform : 'unknown';
-            const unread = conversation.is_read === false ? 'unread' : 'read';
-            const preview = truncateText(typeof conversation.last_message_preview === 'string' ? conversation.last_message_preview : '', 80);
-            lines.push(`- ${String(conversation.id)} (${platform}, ${username}, ${unread}): ${preview}`);
-        }
-        if (result.hasMore) {
-            const nextOffset = (input.offset ?? 0) + result.conversations.length;
-            lines.push('', `More conversations available. Call again with offset: ${nextOffset}.`);
-        }
-        if (skippedNote)
-            lines.push('', skippedNote);
-        return lines.join('\n');
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_conversation: z.object({
+            conversation_id: z.string().min(1),
+            workspace_id: z.string().optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_conversations', input);
+        if (mode === 'conversation')
+            return oneConversation(client, args);
+        return conversationList(client, args);
     },
 };
+async function conversationList(client, input) {
+    const result = await client.listConversations(input);
+    const skippedNote = describeSkippedWorkspaces(result);
+    if (result.conversations.length === 0) {
+        return [
+            'No inbox conversations found matching your filters.',
+            skippedNote,
+        ].filter(Boolean).join('\n\n');
+    }
+    const lines = [`Inbox conversations (showing ${result.conversations.length} of ${result.total}):`];
+    for (const conversation of result.conversations) {
+        const username = typeof conversation.participant_username === 'string' ? `@${conversation.participant_username}` : 'unknown';
+        const platform = typeof conversation.platform === 'string' ? conversation.platform : 'unknown';
+        const unread = conversation.is_read === false ? 'unread' : 'read';
+        const preview = truncateText(typeof conversation.last_message_preview === 'string' ? conversation.last_message_preview : '', 80);
+        lines.push(`- ${String(conversation.id)} (${platform}, ${username}, ${unread}): ${preview}`);
+    }
+    if (result.hasMore) {
+        const nextOffset = (input.offset ?? 0) + result.conversations.length;
+        lines.push('', `More conversations available. Call again with offset: ${nextOffset}.`);
+    }
+    if (skippedNote)
+        lines.push('', skippedNote);
+    return lines.join('\n');
+}
+async function oneConversation(client, input) {
+    const result = await client.getConversation(input);
+    const conversation = result.conversation;
+    const username = typeof conversation.participant_username === 'string' ? `@${conversation.participant_username}` : 'unknown';
+    const lines = [
+        `Conversation ${String(conversation.id)}`,
+        `• Platform: ${typeof conversation.platform === 'string' ? conversation.platform : 'unknown'}`,
+        `• Participant: ${username}`,
+        `• Read: ${conversation.is_read === false ? 'no' : 'yes'}`,
+        `• Messages: ${result.messages.length}`,
+        '',
+    ];
+    for (const message of result.messages) {
+        const who = message.sender_is_business ? 'you' : (typeof message.sender_username === 'string' ? message.sender_username : 'them');
+        const when = formatLocalDateTime(typeof message.sent_at === 'string' ? message.sent_at : null);
+        const text = truncateText(typeof message.content === 'string' ? message.content : '', 240);
+        lines.push(`- [${when}] ${who}: ${text}`);
+    }
+    return lines.join('\n');
+}

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

@@ -5,7 +5,7 @@ export const listGoogleBusinessMediaTool = {
     inputSchema: z.object({
         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('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID returned by get_google_business_review_link. Prefer account_id.'),
+        location_id: z.string().optional().describe('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.'),
     }),
     async execute(client, input) {
         const result = await client.listGoogleBusinessMedia(input);

package/dist/tools/list-google-business-reviews.d.ts

@@ -1,9 +1,21 @@
 import { z } from 'zod';
 import type { PosterlyClient } from '../lib/api-client.js';
+import { type ToolContext } from '../lib/tool-runtime.js';
+type ReviewsInput = {
+    view?: 'reviews' | 'review_link';
+    workspace_id?: string;
+    account_id?: number;
+    location_id?: string;
+    rating?: number;
+    unanswered?: boolean;
+    limit?: number;
+    offset?: number;
+};
 export declare const listGoogleBusinessReviewsTool: {
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
+        view: z.ZodOptional<z.ZodEnum<["reviews", "review_link"]>>;
         workspace_id: z.ZodOptional<z.ZodString>;
         account_id: z.ZodOptional<z.ZodNumber>;
         location_id: z.ZodOptional<z.ZodString>;
@@ -19,6 +31,7 @@ export declare const listGoogleBusinessReviewsTool: {
         location_id?: string | undefined;
         rating?: number | undefined;
         unanswered?: boolean | undefined;
+        view?: "reviews" | "review_link" | undefined;
     }, {
         workspace_id?: string | undefined;
         account_id?: number | undefined;
@@ -27,14 +40,24 @@ export declare const listGoogleBusinessReviewsTool: {
         location_id?: string | undefined;
         rating?: number | undefined;
         unanswered?: boolean | undefined;
+        view?: "reviews" | "review_link" | undefined;
     }>;
-    execute(client: PosterlyClient, input: {
-        workspace_id?: string;
-        account_id?: number;
-        location_id?: string;
-        rating?: number;
-        unanswered?: boolean;
-        limit?: number;
-        offset?: number;
-    }): Promise<string>;
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_google_business_review_link: z.ZodObject<{
+            workspace_id: z.ZodOptional<z.ZodString>;
+            account_id: z.ZodOptional<z.ZodNumber>;
+            location_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }, {
+            workspace_id?: string | undefined;
+            account_id?: number | undefined;
+            location_id?: string | undefined;
+        }>;
+    };
+    execute(client: PosterlyClient, input: ReviewsInput, ctx: ToolContext): Promise<string>;
 };
+export {};

package/dist/tools/list-google-business-reviews.js

@@ -1,79 +1,104 @@
 import { z } from 'zod';
 import { formatDate } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 /** Matches GOOGLE_BUSINESS_REVIEWS_MAX_LIMIT in lib/api-v1-google-business.ts. */
 const MAX_LIMIT = 1000;
 export const listGoogleBusinessReviewsTool = {
     name: 'list_google_business_reviews',
-    description: 'List Google Business Profile reviews for one location/account or every accessible GBP location. Pages through all reviews Google has (not just the first 50), returns the full untruncated review text with its date, and reports each location\'s total review count. Supports rating and unanswered-only filters plus limit/offset paging.',
+    description: 'Google Business Profile reviews. view=reviews (default): reviews for one location/account or every accessible GBP location, paging through all reviews Google has (not just the first 50) with the full untruncated review text, its date, and each location\'s total review count; filter by rating or unanswered, page with limit/offset. view=review_link (account_id or location_id): the direct public Google review link plus the Google Place ID (ChIJ...); that Place ID is output only and must NOT be passed back as location_id.',
     inputSchema: z.object({
+        view: z.enum(['reviews', 'review_link']).optional().describe('reviews (default) or review_link.'),
         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('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID returned by get_google_business_review_link. Prefer account_id.'),
-        rating: z.number().int().min(1).max(5).optional().describe('Filter to a 1-5 star rating.'),
-        unanswered: z.boolean().optional().describe('Only return reviews without owner replies.'),
+        location_id: z.string().optional().describe('Google Business numeric location id (the location_id/platform_user_id from list_accounts, e.g. "197940849675145390"). NOT the ChIJ... Place ID from view=review_link. Prefer account_id.'),
+        rating: z.number().int().min(1).max(5).optional().describe('reviews: filter to a 1-5 star rating.'),
+        unanswered: z.boolean().optional().describe('reviews: only return reviews without owner replies.'),
         limit: z
             .number()
             .int()
             .min(1)
             .max(MAX_LIMIT)
             .optional()
-            .describe(`Maximum reviews to return in this call (default 200, max ${MAX_LIMIT}). Every returned review is listed in full.`),
+            .describe(`reviews: maximum reviews to return in this call (default 200, max ${MAX_LIMIT}). Every returned review is listed in full.`),
         offset: z
             .number()
             .int()
             .min(0)
             .optional()
-            .describe('Skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.'),
+            .describe('reviews: skip this many reviews before returning results. Use with limit to page through a location with more reviews than one call returns.'),
     }),
-    async execute(client, input) {
-        const result = await client.listGoogleBusinessReviews(input);
-        const locations = (result.locations || []);
-        const offset = result.offset ?? 0;
-        if (result.reviews.length === 0) {
-            // Distinguish "no reviews exist" from "we couldn't read them" — a silent
-            // zero used to be indistinguishable from a broken connection.
-            const lines = ['No Google Business reviews found matching your filters.'];
-            const locationLines = locations.map((location) => formatLocationLine(location));
-            if (locationLines.length > 0) {
-                lines.push('', 'Locations checked:', ...locationLines);
-            }
-            return lines.join('\n');
-        }
-        const header = [`Google Business reviews (showing ${result.reviews.length} of ${result.total} matching`];
-        if (offset > 0)
-            header.push(`, from offset ${offset}`);
-        if (typeof result.total_review_count === 'number') {
-            header.push(`; ${result.total_review_count} total on Google`);
-        }
-        header.push('):');
-        const lines = [header.join('')];
-        for (const location of locations) {
-            if (location.error) {
-                lines.push(`! ${location.business_name || location.name || location.location_id || 'location'}: ${location.error}`);
-            }
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_google_business_review_link: z.object({
+            workspace_id: z.string().optional(),
+            account_id: z.number().int().positive().optional(),
+            location_id: z.string().optional(),
+        }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_google_business_reviews', input);
+        if (mode === 'review_link')
+            return reviewLink(client, args);
+        return reviews(client, args);
+    },
+};
+async function reviews(client, input) {
+    const result = await client.listGoogleBusinessReviews(input);
+    const locations = (result.locations || []);
+    const offset = result.offset ?? 0;
+    if (result.reviews.length === 0) {
+        // Distinguish "no reviews exist" from "we couldn't read them": a silent
+        // zero used to be indistinguishable from a broken connection.
+        const lines = ['No Google Business reviews found matching your filters.'];
+        const locationLines = locations.map((location) => formatLocationLine(location));
+        if (locationLines.length > 0) {
+            lines.push('', 'Locations checked:', ...locationLines);
         }
-        lines.push('');
-        for (const review of result.reviews) {
-            const name = review.reviewer?.displayName || 'Anonymous';
-            const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
-            const location = review.businessName || review.locationName || review.locationId || 'location';
-            const date = formatReviewDate(review);
-            const replied = review.reviewReply ? 'replied' : 'unanswered';
-            lines.push(`- ${name} (${rating}, ${date}, ${location}, ${replied})`);
-            // Full review text, no truncation — collapse whitespace only so the
-            // bullet list stays readable for multi-paragraph reviews.
-            if (review.comment) {
-                lines.push(`  ${review.comment.replace(/\s+/g, ' ').trim()}`);
-            }
+        return lines.join('\n');
+    }
+    const header = [`Google Business reviews (showing ${result.reviews.length} of ${result.total} matching`];
+    if (offset > 0)
+        header.push(`, from offset ${offset}`);
+    if (typeof result.total_review_count === 'number') {
+        header.push(`; ${result.total_review_count} total on Google`);
+    }
+    header.push('):');
+    const lines = [header.join('')];
+    for (const location of locations) {
+        if (location.error) {
+            lines.push(`! ${location.business_name || location.name || location.location_id || 'location'}: ${location.error}`);
         }
-        if (result.has_more) {
-            const nextOffset = offset + result.reviews.length;
-            lines.push('', `More reviews available — call again with offset: ${nextOffset} to continue.`);
+    }
+    lines.push('');
+    for (const review of result.reviews) {
+        const name = review.reviewer?.displayName || 'Anonymous';
+        const rating = review.starRating ? `${review.starRating} stars` : 'unrated';
+        const location = review.businessName || review.locationName || review.locationId || 'location';
+        const date = formatReviewDate(review);
+        const replied = review.reviewReply ? 'replied' : 'unanswered';
+        lines.push(`- ${name} (${rating}, ${date}, ${location}, ${replied})`);
+        // Full review text, no truncation; collapse whitespace only so the
+        // bullet list stays readable for multi-paragraph reviews.
+        if (review.comment) {
+            lines.push(`  ${review.comment.replace(/\s+/g, ' ').trim()}`);
         }
-        lines.push('', 'Locations:', ...locations.map((location) => formatLocationLine(location)));
-        return lines.join('\n');
-    },
-};
+    }
+    if (result.has_more) {
+        const nextOffset = offset + result.reviews.length;
+        lines.push('', `More reviews available. Call again with offset: ${nextOffset} to continue.`);
+    }
+    lines.push('', 'Locations:', ...locations.map((location) => formatLocationLine(location)));
+    return lines.join('\n');
+}
+async function reviewLink(client, input) {
+    const result = await client.getGoogleBusinessReviewLink(input);
+    return [
+        `Review link for ${result.businessName}:`,
+        result.reviewLink,
+        `Place ID: ${result.placeId}`,
+        `Account ID: ${result.account_id}`,
+    ].join('\n');
+}
 /**
  * When a review was written, plus when it was last edited if that differs.
  * The list is ordered by last activity (updateTime), so showing only the