posterly-mcp-server 0.19.0 → 0.19.2

package/dist/lib/format.js

@@ -0,0 +1,125 @@
+export function mdTitle(title, subtitle) {
+    return [`## ${title}`, subtitle ? `_${subtitle}_` : ''].filter(Boolean).join('\n');
+}
+export function mdTable(headers, rows) {
+    const visibleRows = rows.filter((row) => row.some((cell) => cell !== undefined && cell !== null && cell !== ''));
+    if (visibleRows.length === 0)
+        return '';
+    const header = `| ${headers.map(escapeCell).join(' | ')} |`;
+    const divider = `| ${headers.map(() => '---').join(' | ')} |`;
+    const body = visibleRows.map((row) => `| ${row.map((cell) => escapeCell(formatCell(cell))).join(' | ')} |`);
+    return [header, divider, ...body].join('\n');
+}
+export function mdKeyValue(rows) {
+    return mdTable(['Field', 'Value'], rows);
+}
+export function mdSection(title, body) {
+    if (!body)
+        return '';
+    return [`### ${title}`, body].join('\n');
+}
+export function mdBullets(items) {
+    return items.filter(Boolean).map((item) => `- ${item}`).join('\n');
+}
+export function mdJson(title, value) {
+    return [`### ${title}`, '```json', JSON.stringify(value, null, 2), '```'].join('\n');
+}
+export function mdQuote(text) {
+    return text.split('\n').map((line) => `> ${line}`).join('\n');
+}
+export function mdEmpty(title, detail, nextStep) {
+    return [
+        mdTitle(`No ${title}`),
+        detail,
+        nextStep ? `\n**Next step:** ${nextStep}` : '',
+    ].filter(Boolean).join('\n');
+}
+export function mdSuccess(title, rows, nextStep) {
+    return [
+        mdTitle(`✅ ${title}`),
+        mdKeyValue(rows),
+        nextStep ? `\n**Next step:** ${nextStep}` : '',
+    ].filter(Boolean).join('\n');
+}
+export function mdError(message) {
+    return [
+        mdTitle('⚠️ Posterly tool error'),
+        `**Message:** ${message}`,
+    ].join('\n');
+}
+export function formatNumber(value) {
+    return value == null ? 'n/a' : value.toLocaleString();
+}
+export function formatPercent(value) {
+    return value == null ? 'n/a' : `${value.toLocaleString()}%`;
+}
+export function formatDelta(value) {
+    if (value == null)
+        return 'n/a';
+    return value >= 0 ? `+${value.toLocaleString()}` : value.toLocaleString();
+}
+export function formatDateTime(value) {
+    if (!value)
+        return 'n/a';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toLocaleString();
+}
+export function formatDate(value) {
+    if (!value)
+        return 'n/a';
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric', year: 'numeric' });
+}
+export function formatBytes(value) {
+    if (value == null)
+        return 'n/a';
+    if (value < 1024)
+        return `${value} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let size = value / 1024;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex += 1;
+    }
+    return `${size.toFixed(size >= 10 ? 0 : 1)} ${units[unitIndex]}`;
+}
+export function compactText(value, maxLength = 90) {
+    const text = String(value || '').replace(/\s+/g, ' ').trim();
+    if (!text)
+        return '';
+    return text.length > maxLength ? `${text.slice(0, Math.max(0, maxLength - 1))}…` : text;
+}
+export function statusLabel(status) {
+    const value = String(status || 'unknown').toLowerCase();
+    if (['created', 'success', 'succeeded', 'completed', 'published', 'active'].includes(value))
+        return `✅ ${status}`;
+    if (['scheduled', 'queued', 'pending', 'processing'].includes(value))
+        return `🕒 ${status}`;
+    if (['failed', 'error', 'inactive', 'deleted'].includes(value))
+        return `⚠️ ${status}`;
+    if (['draft', 'paused'].includes(value))
+        return `⏸️ ${status}`;
+    return status || 'unknown';
+}
+export function code(value) {
+    return `\`${formatCell(value).replace(/`/g, '\\`')}\``;
+}
+function formatCell(value) {
+    if (value === null || value === undefined || value === '')
+        return 'n/a';
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    if (typeof value === 'number')
+        return value.toLocaleString();
+    return String(value);
+}
+function escapeCell(value) {
+    return formatCell(value)
+        .replace(/\|/g, '\\|')
+        .replace(/\r?\n/g, '<br>');
+}

package/dist/tools/audit-google-business-profile.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatDateTime, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const auditGoogleBusinessProfileTool = {
     name: 'audit_google_business_profile',
     description: 'Run a live local-profile audit for a connected Google Business Profile location, including completeness, categories, media, attributes, reviews, and recommendations.',
@@ -11,17 +12,19 @@ export const auditGoogleBusinessProfileTool = {
         const result = await client.auditGoogleBusinessProfile(input);
         const audit = result.audit || {};
         const recommendations = Array.isArray(audit.recommendations) ? audit.recommendations : [];
-        const lines = [
-            `Google Business audit: ${audit.businessName || 'Unknown business'}`,
-            `Score: ${audit.overallScore ?? 'n/a'} (${audit.overallGrade || 'n/a'})`,
-            `Fetched: ${result.fetchedAt || 'unknown'}`,
-        ];
-        if (recommendations.length > 0) {
-            lines.push('Top recommendations:');
-            for (const rec of recommendations.slice(0, 5)) {
-                lines.push(`- ${rec.priority || 'medium'}: ${rec.description || rec.title || 'Recommendation'}`);
-            }
-        }
-        return lines.join('\n');
+        return [
+            mdTitle(`Google Business audit: ${audit.businessName || 'Unknown business'}`),
+            mdKeyValue([
+                ['Score', audit.overallScore ?? 'n/a'],
+                ['Grade', audit.overallGrade || 'n/a'],
+                ['Fetched', formatDateTime(result.fetchedAt)],
+            ]),
+            recommendations.length > 0
+                ? mdSection('Top recommendations', mdTable(['Priority', 'Recommendation'], recommendations.slice(0, 5).map((rec) => [
+                    rec.priority || 'medium',
+                    rec.description || rec.title || 'Recommendation',
+                ])))
+                : '',
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/create-oauth-client.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 const scopeSchema = z.enum(['accounts:read', 'accounts:write', 'posts:read', 'posts:write', 'media:write', 'analytics:read']);
 export const createOAuthClientTool = {
     name: 'create_oauth_client',
@@ -15,6 +16,11 @@ export const createOAuthClientTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.createOAuthClient(payload);
-        return `OAuth client created: ${result.client.client_name}\nclient_id: ${result.client.client_id}\nRedirect URIs: ${result.client.allowed_redirect_uris.join(', ')}`;
+        return mdSuccess('OAuth client created', [
+            ['Client', result.client.client_name],
+            ['Client ID', code(result.client.client_id)],
+            ['Redirect URIs', result.client.allowed_redirect_uris.join(', ')],
+            ['Default scopes', result.client.default_scopes.join(', ')],
+        ]);
     },
 };

package/dist/tools/create-post.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
+import { code, formatDateTime, mdKeyValue, mdSuccess, statusLabel } from '../lib/format.js';
 export const instagramSettingsSchema = z.object({
     __type: z.enum(['instagram', 'instagram-standalone']).optional(),
     post_type: z.enum(['post', 'feed', 'story', 'reel', 'carousel']).optional(),
@@ -159,32 +160,24 @@ export const createPostTool = {
         const result = await client.createPost(payload);
         const p = result.post;
         const ws = result.workspace;
-        const when = p.scheduled_at
-            ? new Date(p.scheduled_at).toLocaleString()
-            : 'now';
-        const lines = [
-            'Post created successfully!',
-            `• ID: ${p.id}`,
-            `• Platform: ${p.platform || input.platform || 'unknown'}`,
-            `• Type: ${p.post_type}`,
-            `• Status: ${p.status}`,
-            `• Scheduled: ${when}`,
-        ];
-        if (thread_posts) {
-            lines.push(`• Thread: ${thread_posts.length} posts`);
-        }
-        if (instagram_settings?.collaborators?.length) {
-            lines.push(`• Instagram collaborators: ${instagram_settings.collaborators.length}`);
-        }
-        if (instagram_settings?.first_comment) {
-            lines.push('• Instagram first comment: yes');
-        }
-        if (platform_settings) {
-            lines.push('• Platform settings: yes');
-        }
-        if (ws) {
-            lines.push(`• Workspace: ${ws.name} (${ws.id}) — resolved from ${ws.resolved_from}`);
-        }
-        return lines.join('\n');
+        return [
+            mdSuccess('Post created', [
+                ['Post ID', code(p.id)],
+                ['Platform', p.platform || input.platform || 'unknown'],
+                ['Type', p.post_type],
+                ['Status', statusLabel(p.status)],
+                ['Scheduled', p.scheduled_at ? formatDateTime(p.scheduled_at) : 'now'],
+                ['Thread', thread_posts ? `${thread_posts.length} posts` : undefined],
+                ['Instagram collaborators', instagram_settings?.collaborators?.length],
+                ['Instagram first comment', Boolean(instagram_settings?.first_comment)],
+                ['Platform settings', Boolean(platform_settings)],
+            ], 'Use `get_post` if you want to review the saved post details.'),
+            ws
+                ? mdKeyValue([
+                    ['Workspace', `${ws.name} (${code(ws.id)})`],
+                    ['Workspace resolved from', ws.resolved_from],
+                ])
+                : '',
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/create-posts-batch.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { buildCreatePostPayload, createPostInputSchema } from './create-post.js';
+import { code, formatDateTime, mdSection, mdTable, mdTitle, statusLabel } from '../lib/format.js';
 export const createPostsBatchTool = {
     name: 'create_posts_batch',
     description: 'Create 1-25 scheduled or immediate social posts in one API request. This is a DESTRUCTIVE WRITE that creates content on the user\'s real social accounts — once scheduled_at passes, posts may go public and cannot be un-posted.\n\n' +
@@ -18,21 +19,28 @@ export const createPostsBatchTool = {
     async execute(client, input) {
         const payloads = input.posts.map((post) => buildCreatePostPayload(post));
         const result = await client.createPostsBatch({ posts: payloads });
-        const lines = [
-            'Batch create completed.',
-            `• Total: ${result.total}`,
-            `• Created: ${result.created}`,
-            `• Replayed: ${result.replayed}`,
-            `• Failed: ${result.failed}`,
-        ];
-        for (const item of result.posts.slice(0, 25)) {
+        const createdRows = result.posts.slice(0, 25).map((item) => {
             const post = item.post;
-            const when = post.scheduled_at ? new Date(post.scheduled_at).toLocaleString() : 'now';
-            lines.push(`• [${item.index}] ID ${post.id} ${post.platform || 'unknown'} ${post.post_type || 'post'} ${post.status || 'created'} at ${when}${item.replayed ? ' (replayed)' : ''}`);
-        }
-        for (const error of result.errors.slice(0, 25)) {
-            lines.push(`• [${error.index}] ERROR ${error.status}: ${error.error}`);
-        }
-        return lines.join('\n');
+            return [
+                item.index,
+                code(post.id),
+                post.platform || 'unknown',
+                post.post_type || 'post',
+                statusLabel(post.status || 'created'),
+                post.scheduled_at ? formatDateTime(post.scheduled_at) : 'now',
+                item.replayed ? 'yes' : 'no',
+            ];
+        });
+        const errorRows = result.errors.slice(0, 25).map((error) => [
+            error.index,
+            error.status,
+            error.error,
+        ]);
+        return [
+            mdTitle(result.failed ? '⚠️ Batch create completed with issues' : '✅ Batch create completed'),
+            mdTable(['Total', 'Created', 'Replayed', 'Failed'], [[result.total, result.created, result.replayed, result.failed]]),
+            mdSection('Created posts', mdTable(['Index', 'Post ID', 'Platform', 'Type', 'Status', 'Scheduled', 'Replayed'], createdRows)),
+            mdSection('Errors', mdTable(['Index', 'Status', 'Error'], errorRows)),
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/create-signed-upload.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
+import { code, formatBytes, mdSuccess } from '../lib/format.js';
 export const createSignedUploadTool = {
     name: 'create_signed_upload',
-    description: 'Create a signed direct-upload URL for a larger image or video. Upload the binary to upload_url, then use public_url with create_post.',
+    description: 'Create a signed upload URL for a larger image or video. Upload the binary to upload_url; the API validates actual bytes before storage, then public_url can be used with create_post.',
     inputSchema: z.object({
         filename: z.string().describe('Filename with extension, e.g. launch-video.mp4'),
         content_type: z.string().describe('MIME type, e.g. video/mp4'),
@@ -9,12 +10,14 @@ export const createSignedUploadTool = {
     }),
     async execute(client, input) {
         const signed = await client.getSignedUploadUrl(input.filename, input.content_type, input.size);
-        return [
-            'Signed upload created.',
-            `• Upload URL: ${signed.upload_url}`,
-            `• Token: ${signed.token}`,
-            `• Storage path: ${signed.path}`,
-            `• Public URL after upload: ${signed.public_url}`,
-        ].join('\n');
+        return mdSuccess('Signed upload created', [
+            ['Filename', input.filename],
+            ['Content type', input.content_type],
+            ['Size', formatBytes(input.size)],
+            ['Upload URL', signed.upload_url],
+            ['Token', code(signed.token)],
+            ['Storage path', signed.path],
+            ['Public URL after upload', signed.public_url],
+        ]);
     },
 };

package/dist/tools/create-webhook.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { webhookEventSchema } from './webhook-events.js';
+import { code, mdSuccess } from '../lib/format.js';
 export const createWebhookTool = {
     name: 'create_webhook',
     description: 'Create a webhook subscription for post/account/analytics events. WRITE WITH OUTBOUND SIDE EFFECTS: show the user the target URL, workspace, events, and active state, then get explicit confirmation before calling. The response includes the signing secret once.',
@@ -14,7 +15,11 @@ export const createWebhookTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.createWebhook(payload);
-        const secret = result.secret ? `\nSigning secret: ${result.secret}` : '';
-        return `Webhook created: ${result.webhook.id}\nURL: ${result.webhook.url}\nEvents: ${result.webhook.events.join(', ')}${secret}`;
+        return mdSuccess('Webhook created', [
+            ['Webhook ID', code(result.webhook.id)],
+            ['URL', result.webhook.url],
+            ['Events', result.webhook.events.join(', ')],
+            ['Signing secret', result.secret ? code(result.secret) : undefined],
+        ], 'Store the signing secret now; Posterly only returns it once.');
     },
 };

package/dist/tools/delete-google-business-review-reply.d.ts

@@ -28,5 +28,5 @@ export declare const deleteGoogleBusinessReviewReplyTool: {
         location_id?: string;
         review_name: string;
         confirm: true;
-    }): Promise<any>;
+    }): Promise<string>;
 };

package/dist/tools/delete-google-business-review-reply.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdSuccess } from '../lib/format.js';
 export const deleteGoogleBusinessReviewReplyTool = {
     name: 'delete_google_business_review_reply',
     description: 'Delete the owner reply from a Google Business Profile review. DESTRUCTIVE: confirm the review and location with the user, then pass confirm=true only after explicit confirmation.',
@@ -12,6 +13,8 @@ export const deleteGoogleBusinessReviewReplyTool = {
     async execute(client, input) {
         const { confirm: _confirm, ...payload } = input;
         const result = await client.deleteGoogleBusinessReviewReply(payload);
-        return result.message || 'Google Business review reply deleted successfully.';
+        return mdSuccess('Google Business review reply deleted', [
+            ['Message', result.message || 'Google Business review reply deleted successfully.'],
+        ]);
     },
 };

package/dist/tools/delete-oauth-client.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 export const deleteOAuthClientTool = {
     name: 'delete_oauth_client',
     description: 'Delete a self-serve OAuth developer client. DESTRUCTIVE: prevents new authorizations for that client_id; existing access tokens remain revocable as API keys.',
@@ -8,6 +9,8 @@ export const deleteOAuthClientTool = {
     }),
     async execute(client, input) {
         const result = await client.deleteOAuthClient(input.client_id);
-        return `OAuth client deleted: ${result.client_id}`;
+        return mdSuccess('OAuth client deleted', [
+            ['Client ID', code(result.client_id)],
+        ]);
     },
 };

package/dist/tools/delete-post-group.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdJson, mdTitle } from '../lib/format.js';
 export const deletePostGroupTool = {
     name: 'delete_post_group',
     description: 'Delete every draft/scheduled/failed/paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. DESTRUCTIVE: inspect the group first, list the affected posts, and pass confirm=true only after explicit confirmation.',
@@ -8,6 +9,9 @@ export const deletePostGroupTool = {
     }),
     async execute(client, input) {
         const result = await client.deletePostGroup(input.group_id);
-        return JSON.stringify(result, null, 2);
+        return [
+            mdTitle('✅ Post group delete completed', `Group: ${input.group_id}`),
+            mdJson('Result', result),
+        ].join('\n\n');
     },
 };

package/dist/tools/delete-post.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 export const deletePostTool = {
     name: 'delete_post',
     description: 'Delete a scheduled or draft post. DESTRUCTIVE and IRREVERSIBLE — the post and its caption cannot be recovered. Cannot delete published or currently publishing posts.\n\n' +
@@ -8,6 +9,8 @@ export const deletePostTool = {
     }),
     async execute(client, input) {
         const result = await client.deletePost(input.post_id);
-        return `Post #${result.id} deleted successfully.`;
+        return mdSuccess('Post deleted', [
+            ['Post ID', code(result.id)],
+        ]);
     },
 };

package/dist/tools/delete-webhook.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 export const deleteWebhookTool = {
     name: 'delete_webhook',
     description: 'Delete a webhook subscription. DESTRUCTIVE: list the webhook first, show the user its URL/events/workspace, and get explicit confirmation before calling.',
@@ -8,6 +9,8 @@ export const deleteWebhookTool = {
     }),
     async execute(client, input) {
         const result = await client.deleteWebhook(input.webhook_id);
-        return `Webhook deleted: ${result.id}`;
+        return mdSuccess('Webhook deleted', [
+            ['Webhook ID', code(result.id)],
+        ]);
     },
 };

package/dist/tools/disconnect-account.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdSuccess } from '../lib/format.js';
 export const disconnectAccountTool = {
     name: 'disconnect_account',
     description: 'Disconnect a connected social account from posterly. DESTRUCTIVE and IRREVERSIBLE: removes the account connection, emits account.disconnected webhooks, and may transfer Instagram scheduled posts to a replacement account.\n\n' +
@@ -13,10 +14,11 @@ export const disconnectAccountTool = {
         }
         const result = await client.disconnectAccount(input.account_id);
         const account = result.account || {};
-        return [
-            `Disconnected ${account.platform || 'account'}${account.username ? ` @${account.username}` : ''} (ID: ${account.id || input.account_id}).`,
-            `Transferred posts: ${result.transferred_post_count ?? 0}.`,
-            `Stamped posts: ${result.stamped_post_count ?? 0}.`,
-        ].join('\n');
+        return mdSuccess('Account disconnected', [
+            ['Account', `${account.platform || 'account'}${account.username ? ` @${account.username}` : ''}`],
+            ['Account ID', code(account.id || input.account_id)],
+            ['Transferred posts', result.transferred_post_count ?? 0],
+            ['Stamped posts', result.stamped_post_count ?? 0],
+        ]);
     },
 };

package/dist/tools/find-slot.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatDate, mdEmpty, mdTable, mdTitle } from '../lib/format.js';
 export const findSlotTool = {
     name: 'find_available_slot',
     description: 'Find available time slots for posting. Respects a 1-hour gap between posts and preferred hours (8am–10pm in the given timezone). Returns up to 10 slots. IMPORTANT: pass a timezone explicitly — default is America/New_York and slots will be off if the user is elsewhere. Pass workspace_id to only avoid collisions with posts in that workspace.',
@@ -25,9 +26,15 @@ export const findSlotTool = {
     async execute(client, input) {
         const slots = await client.findAvailableSlots(input);
         if (slots.length === 0) {
-            return 'No available slots found in the next 14 days.';
+            return mdEmpty('available slots', 'No available posting slots were found in the next 14 days.');
         }
-        const lines = slots.map((s, i) => `${i + 1}. ${s.local_time} — ${new Date(s.time).toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric' })}`);
-        return `Available posting slots:\n${lines.join('\n')}`;
+        return [
+            mdTitle(`Available posting slots (${slots.length})`),
+            mdTable(['Option', 'Local time', 'Date'], slots.map((slot, index) => [
+                index + 1,
+                slot.local_time,
+                formatDate(slot.time),
+            ])),
+        ].join('\n\n');
     },
 };

package/dist/tools/generate-image.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { mdBullets, mdKeyValue, mdSection, mdTable, mdTitle } from '../lib/format.js';
 export const generateImageTool = {
     name: 'generate_image',
     description: 'Generate an AI image via Posterly\'s Nano Banana (Gemini) integration. The image is saved to the user\'s media storage and the returned URL can be passed to `create_post` as `media_url`.\n\n' +
@@ -47,24 +48,21 @@ export const generateImageTool = {
     }),
     async execute(client, input) {
         const result = await client.generateImage(input);
-        const lines = [];
-        lines.push(`Generated ${result.images.length} image${result.images.length === 1 ? '' : 's'} via ${result.model}.`);
-        lines.push('');
-        result.images.forEach((img, i) => {
-            lines.push(`${i + 1}. ${img.url}`);
-        });
-        lines.push('');
-        lines.push(`Billed from: ${result.usage.billed_from}${result.credits_used > 0 ? ` (${result.credits_used} credits)` : ''}`);
-        if (result.usage.limit != null) {
-            lines.push(`Plan usage: ${result.usage.used ?? 0}/${result.usage.limit} this ${result.usage.period || 'period'}${result.usage.tier ? ` (${result.usage.tier})` : ''}`);
-        }
-        if (result.warnings?.length) {
-            lines.push('');
-            lines.push('Warnings:');
-            result.warnings.forEach((w) => lines.push(`• ${w}`));
-        }
-        lines.push('');
-        lines.push('Pass any of these URLs to create_post as media_url (or media_urls for a carousel).');
-        return lines.join('\n');
+        return [
+            mdTitle(`✅ Generated ${result.images.length} image${result.images.length === 1 ? '' : 's'}`, `Model: ${result.model}`),
+            mdTable(['#', 'Image URL', 'Filename'], result.images.map((img, index) => [
+                index + 1,
+                img.url,
+                img.filename,
+            ])),
+            mdKeyValue([
+                ['Billed from', result.usage.billed_from],
+                ['Credits used', result.credits_used],
+                ['Plan usage', result.usage.limit != null ? `${result.usage.used ?? 0}/${result.usage.limit} this ${result.usage.period || 'period'}` : undefined],
+                ['Plan tier', result.usage.tier || undefined],
+            ]),
+            result.warnings?.length ? mdSection('Warnings', mdBullets(result.warnings)) : '',
+            '**Next step:** Pass any URL above to `create_post` as `media_url`, or use multiple as `media_urls` for a carousel.',
+        ].filter(Boolean).join('\n\n');
     },
 };

package/dist/tools/generate-video.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { code, mdJson, mdKeyValue, mdTitle, statusLabel } from '../lib/format.js';
 export const generateVideoTool = {
     name: 'generate_video',
     description: 'Queue a Veo AI video generation job. COSTS VEO CREDITS: confirm prompt, model, duration, resolution, aspect ratio, audio choice, and credit cost with the user before calling. Poll get_video_job for status and final video_url.',
@@ -21,14 +22,15 @@ export const generateVideoTool = {
     async execute(client, input) {
         const result = await client.generateVideo(input);
         return [
-            'Video generation job queued',
-            `Job ID: ${result.job_id}`,
-            `Status: ${result.status}`,
-            `Credit cost: ${result.credit_cost} (${result.included_credit_cost || 0} included, ${result.purchased_credit_cost || 0} purchased)`,
-            result.message,
-            '',
-            'Raw response:',
-            JSON.stringify(result, null, 2),
-        ].filter(Boolean).join('\n');
+            mdTitle('🎬 Video generation job queued'),
+            mdKeyValue([
+                ['Job ID', code(result.job_id)],
+                ['Status', statusLabel(result.status)],
+                ['Credit cost', `${result.credit_cost} (${result.included_credit_cost || 0} included, ${result.purchased_credit_cost || 0} purchased)`],
+                ['Message', result.message],
+            ]),
+            '**Next step:** Poll `get_video_job` with the job ID until the video URL is ready.',
+            mdJson('Raw response', result),
+        ].filter(Boolean).join('\n\n');
     },
 };