posterly-mcp-server 0.44.0 → 0.45.1

package/dist/tools/list-brands.js

@@ -1,30 +1,148 @@
 import { z } from 'zod';
-import { code, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
+import { code, compactText, formatDateTime, mdEmpty, mdKeyValue, mdLearnedVoice, mdSection, mdTable, mdTitle } from '../lib/format.js';
+import { validateArgs } from '../lib/tool-runtime.js';
 export const listBrandsTool = {
     name: 'list_brands',
-    description: 'List brands/clients the caller can access. Returns each brand ID, name, workspace ID, source, and how many social accounts are currently assigned to it.',
+    description: 'Brands (clients) and their saved context. view=brands (default): brands the caller can access with brand ID, name, workspace ID, source, and how many social accounts are assigned (optional workspace_id). view=brand (brand_id): one brand with its workspace, source, and linked legacy brand group. view=accounts (brand_id): the connected social accounts assigned to the brand; use it when a user refers to a brand name rather than an account handle. view=profile (brand_id): voice and tone, audience, keywords, dos and don’ts, visual notes, and other saved brand context.',
     inputSchema: z.object({
+        view: z
+            .enum(['brands', 'brand', 'accounts', 'profile'])
+            .optional()
+            .describe('brands (default), brand, accounts, or profile.'),
+        brand_id: z.string().optional().describe('The brand ID (from view=brands). Required for brand, accounts, and profile.'),
         workspace_id: z
             .string()
             .optional()
-            .describe('Filter to brands in a specific workspace (get IDs via whoami).'),
+            .describe('view=brands: filter to brands in a specific workspace (get IDs via whoami).'),
     }),
-    async execute(client, input) {
-        const brands = await client.listBrands({ workspace_id: input.workspace_id });
-        if (brands.length === 0) {
-            return input.workspace_id
-                ? mdEmpty('brands', 'This workspace does not have any brands or clients yet.')
-                : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the posterly dashboard, then run this again.');
-        }
-        return [
-            mdTitle(`Brands (${brands.length})`),
-            mdTable(['Brand', 'Brand ID', 'Accounts', 'Source', 'Workspace'], brands.map((brand) => [
-                brand.name,
-                code(brand.id),
-                brand.account_count,
-                brand.source,
-                brand.workspace_id ? code(brand.workspace_id) : 'default',
-            ])),
-        ].join('\n\n');
+    /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
+    legacySchemas: {
+        get_brand: z.object({ brand_id: z.string() }),
+        list_brand_accounts: z.object({ brand_id: z.string() }),
+        get_brand_profile: z.object({ brand_id: z.string() }),
+    },
+    async execute(client, input, ctx) {
+        const { mode, args } = validateArgs(ctx, 'list_brands', input);
+        if (mode === 'brand')
+            return brand(client, args);
+        if (mode === 'accounts')
+            return brandAccounts(client, args);
+        if (mode === 'profile')
+            return brandProfile(client, args);
+        return brands(client, args);
     },
 };
+async function brands(client, input) {
+    const brands = await client.listBrands({ workspace_id: input.workspace_id });
+    if (brands.length === 0) {
+        return input.workspace_id
+            ? mdEmpty('brands', 'This workspace does not have any brands or clients yet.')
+            : mdEmpty('brands', 'No brands or clients were found for this API key.', 'Create a brand in the posterly dashboard, then run this again.');
+    }
+    return [
+        mdTitle(`Brands (${brands.length})`),
+        mdTable(['Brand', 'Brand ID', 'Accounts', 'Source', 'Workspace'], brands.map((brand) => [
+            brand.name,
+            code(brand.id),
+            brand.account_count,
+            brand.source,
+            brand.workspace_id ? code(brand.workspace_id) : 'default',
+        ])),
+    ].join('\n\n');
+}
+async function brand(client, input) {
+    const result = await client.getBrand(input.brand_id);
+    const brand = result.brand;
+    return [
+        mdTitle(`Brand: ${brand.name}`),
+        mdKeyValue([
+            ['Brand ID', code(brand.id)],
+            ['Source', brand.source],
+            ['Workspace', brand.workspace_id ? code(brand.workspace_id) : 'n/a'],
+            ['Accounts assigned', brand.account_count ?? 0],
+            ['Workspace client ID', brand.workspace_client_id ? code(brand.workspace_client_id) : undefined],
+            ['Legacy brand group ID', brand.legacy_brand_group_id ? code(brand.legacy_brand_group_id) : undefined],
+            ['Created', formatDateTime(brand.created_at)],
+            ['Updated', formatDateTime(brand.updated_at)],
+        ]),
+    ].join('\n\n');
+}
+async function brandAccounts(client, input) {
+    const accounts = await client.listBrandAccounts(input.brand_id);
+    if (accounts.length === 0) {
+        return mdEmpty('brand accounts', 'No social accounts are currently assigned to this brand.');
+    }
+    return [
+        mdTitle(`Brand accounts (${accounts.length})`),
+        mdTable(['Platform', 'Account', 'Account ID', 'Workspace'], accounts.map((account) => [
+            account.platform,
+            `@${account.username}`,
+            code(account.id),
+            account.workspace_id ? code(account.workspace_id) : 'default',
+        ])),
+    ].join('\n\n');
+}
+async function brandProfile(client, input) {
+    const result = await client.getBrandProfile(input.brand_id);
+    const profile = result.brand_profile;
+    const profileBody = [
+        mdKeyValue([
+            ['Source', profile.source],
+            ['Profile ID', profile.id ? code(profile.id) : undefined],
+            ['Workspace client ID', profile.workspace_client_id ? code(profile.workspace_client_id) : undefined],
+            ['Legacy brand group ID', profile.brand_group_id ? code(profile.brand_group_id) : undefined],
+            ['Logo', profile.logo_url],
+            ['Last refreshed', profile.last_context_refresh_at ? formatDateTime(profile.last_context_refresh_at) : undefined],
+        ]),
+        mdSection('Voice and audience', mdKeyValue([
+            ['Tone of voice', compactText(profile.tone_of_voice, 180)],
+            ['Audience', compactText(profile.audience, 180)],
+            ['Brand values', compactText(profile.brand_values, 180)],
+            ['Brand story', compactText(formatStructuredValue(profile.brand_story), 240)],
+        ])),
+        mdSection('Guidance', mdKeyValue([
+            ['Custom instructions', compactText(profile.custom_instructions, 240)],
+            ['Keywords', formatStructuredValue(profile.keywords)],
+            ['Competitors', formatStructuredValue(profile.competitors)],
+            ['Do / Don’ts', formatStructuredValue(profile.do_donts)],
+            ['Topics to cover', formatStructuredValue(profile.topics_to_cover)],
+            ['Topics to avoid', formatStructuredValue(profile.topics_to_avoid)],
+        ])),
+        mdSection('Creative references', mdKeyValue([
+            ['Visual guidelines', formatStructuredValue(profile.visual_guidelines)],
+            ['Example posts', formatStructuredValue(profile.example_posts)],
+            ['Voice examples', formatStructuredValue(profile.voice_examples)],
+        ])),
+    ].filter(Boolean).join('\n\n');
+    const learnedVoices = (Array.isArray(profile.learned_voice) ? profile.learned_voice : []);
+    const learnedBody = learnedVoices.length
+        ? mdSection('Learned voice (from published captions)', learnedVoices.map((voice) => mdLearnedVoice(voice)).filter(Boolean).join('\n\n'))
+        : '';
+    return [
+        mdTitle(`Brand profile: ${profile.brand_name}`),
+        profileBody || 'No extended brand profile fields have been saved yet.',
+        learnedBody ||
+            '_No learned voice yet. posterly learns each account’s voice automatically once it has enough published posts._',
+    ].filter(Boolean).join('\n\n');
+}
+function formatStructuredValue(value) {
+    if (value == null)
+        return null;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return null;
+        return value
+            .map((item) => formatStructuredValue(item) || JSON.stringify(item))
+            .filter(Boolean)
+            .join(' | ');
+    }
+    if (typeof value === 'object') {
+        const json = JSON.stringify(value);
+        return json === '{}' ? null : json;
+    }
+    return String(value);
+}

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 {};