posterly-mcp-server 0.45.0 → 0.45.1

package/dist/tools/get-mcp-status.js

@@ -1,182 +0,0 @@
-import { z } from 'zod';
-import { POSTERLY_MCP_VERSION } from '../lib/version.js';
-import { resolvePosterlyBaseUrl } from '../lib/api-client.js';
-import { code, mdKeyValue, mdTitle } from '../lib/format.js';
-const NPM_LATEST_URL = 'https://registry.npmjs.org/posterly-mcp-server/latest';
-export const getMcpStatusTool = {
-    name: 'get_mcp_status',
-    description: 'Report the posterly MCP server version, latest npm version, MCP endpoint health, API key health, and update guidance. Safe to call before POSTERLY_API_KEY is configured.',
-    inputSchema: z.object({}),
-    async execute(client) {
-        const apiOrigin = client.getBaseUrl();
-        const [latest, apiProbe, authProbe] = await Promise.all([
-            fetchLatestNpmVersion(),
-            probeHostedMcp(apiOrigin),
-            client.hasApiKey() ? client.probeWhoami() : Promise.resolve(null),
-        ]);
-        const updateStatus = describeUpdateStatus(POSTERLY_MCP_VERSION, latest.version, latest.error);
-        const versionMatch = apiProbe.version ? yesNo(apiProbe.version === POSTERLY_MCP_VERSION) : 'unknown';
-        const rows = [
-            ['Connection type', 'local app process (stdio)'],
-            ['Current server version', POSTERLY_MCP_VERSION],
-            ['Latest npm version', latest.version || 'unknown'],
-            ['Update status', updateStatus],
-            ['posterly API origin', code(apiOrigin)],
-            ['MCP endpoint health', formatApiProbe(apiProbe)],
-            ['Hosted MCP version', apiProbe.version || 'unknown'],
-            ['Version match', versionMatch],
-            ['API key configured', client.hasApiKey()],
-            ['API auth check', formatAuthProbe(authProbe)],
-        ];
-        if (authProbe?.ok && authProbe.whoami) {
-            rows.push(['User', authProbe.whoami.user.email || code(authProbe.whoami.user.id)], ['Default workspace', `${authProbe.whoami.default_workspace.name} (${code(authProbe.whoami.default_workspace.id)})`], ['API scopes', authProbe.whoami.api_key.scopes.join(', ') || 'none']);
-        }
-        return [
-            mdTitle('posterly MCP status'),
-            mdKeyValue(rows),
-            latest.error ? `**Latest check:** ${latest.error}` : '',
-            apiProbe.error ? `**MCP endpoint check:** ${apiProbe.error}` : '',
-            authProbe && !authProbe.ok ? `**API auth check:** ${authProbe.error || 'API key validation failed'}` : '',
-            nextStep({ hasApiKey: client.hasApiKey(), updateStatus, apiProbe, authProbe }),
-        ].filter(Boolean).join('\n\n');
-    },
-};
-async function probeHostedMcp(apiOrigin) {
-    const startedAt = Date.now();
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 2500);
-    try {
-        const res = await fetch(`${resolvePosterlyBaseUrl(apiOrigin)}/api/mcp`, {
-            headers: { Accept: 'application/json' },
-            signal: controller.signal,
-        });
-        const text = await res.text();
-        const data = parseJson(text);
-        if (!res.ok) {
-            return {
-                ok: false,
-                status: res.status,
-                error: formatError(data, text, res.statusText),
-                durationMs: Date.now() - startedAt,
-            };
-        }
-        const version = typeof data?.serverInfo?.version === 'string' ? data.serverInfo.version : undefined;
-        return {
-            ok: Boolean(version),
-            status: res.status,
-            version,
-            error: version ? undefined : 'Hosted MCP response did not include serverInfo.version',
-            durationMs: Date.now() - startedAt,
-        };
-    }
-    catch (err) {
-        return {
-            ok: false,
-            error: err?.name === 'AbortError' ? 'timed out after 2500ms' : err?.message || String(err),
-            durationMs: Date.now() - startedAt,
-        };
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-async function fetchLatestNpmVersion() {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 2500);
-    try {
-        const res = await fetch(NPM_LATEST_URL, {
-            headers: { Accept: 'application/json' },
-            signal: controller.signal,
-        });
-        if (!res.ok) {
-            return { error: `npm registry returned HTTP ${res.status}` };
-        }
-        const data = await res.json();
-        return typeof data.version === 'string'
-            ? { version: data.version }
-            : { error: 'npm registry response did not include a version' };
-    }
-    catch (err) {
-        const reason = err?.name === 'AbortError' ? 'timed out' : err?.message || String(err);
-        return { error: `could not check npm latest: ${reason}` };
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-function describeUpdateStatus(current, latest, error) {
-    if (!latest)
-        return error ? 'unknown' : 'unknown';
-    const comparison = compareSemver(current, latest);
-    if (comparison < 0) {
-        return `update available: restart the MCP client or run ${code('npx -y posterly-mcp-server@latest')}`;
-    }
-    if (comparison > 0) {
-        return 'running newer than npm latest; npm may not have been published yet';
-    }
-    return 'current';
-}
-function formatApiProbe(probe) {
-    if (probe.ok)
-        return `ok (HTTP ${probe.status}, ${probe.durationMs}ms)`;
-    const status = probe.status ? `HTTP ${probe.status}` : 'network';
-    return `failed (${status}, ${probe.durationMs}ms)`;
-}
-function formatAuthProbe(probe) {
-    if (!probe)
-        return 'skipped (POSTERLY_API_KEY not configured)';
-    if (probe.ok)
-        return `valid (HTTP ${probe.status}, ${probe.durationMs}ms)`;
-    const status = probe.status ? `HTTP ${probe.status}` : 'network';
-    return `failed (${status}, ${probe.durationMs}ms)`;
-}
-function nextStep(input) {
-    const { hasApiKey, updateStatus, apiProbe, authProbe } = input;
-    if (updateStatus.startsWith('update available')) {
-        return '**Next step:** Restart your MCP client so it pulls `posterly-mcp-server@latest`, then call `get_mcp_status` again.';
-    }
-    if (!apiProbe.ok) {
-        return '**Next step:** Check `POSTERLY_URL` / `POSTERLY_API_BASE_URL`, DNS, and network access to the hosted MCP endpoint, then call `get_mcp_status` again.';
-    }
-    if (!hasApiKey) {
-        return '**Next step:** Add `POSTERLY_API_KEY` after activating API and MCP access, then call `whoami`.';
-    }
-    if (authProbe && !authProbe.ok) {
-        return '**Next step:** Create or reinstall a valid posterly API key, then restart the MCP client and call `get_mcp_status` again.';
-    }
-    return '**Next step:** Call `whoami` to confirm the user, workspace, and scopes before scheduling posts.';
-}
-function yesNo(value) {
-    return value ? 'yes' : 'no';
-}
-function parseJson(text) {
-    try {
-        return text ? JSON.parse(text) : {};
-    }
-    catch {
-        return null;
-    }
-}
-function formatError(data, fallback, statusText) {
-    if (data && typeof data === 'object') {
-        return data.error || data.message || data.code || statusText || 'API request failed';
-    }
-    return fallback || statusText || 'API request failed';
-}
-function compareSemver(a, b) {
-    const left = parts(a);
-    const right = parts(b);
-    for (let i = 0; i < 3; i += 1) {
-        if (left[i] !== right[i])
-            return left[i] > right[i] ? 1 : -1;
-    }
-    return 0;
-}
-function parts(value) {
-    const nums = value.split(/[.-]/).slice(0, 3).map((part) => Number.parseInt(part, 10));
-    return [
-        Number.isFinite(nums[0]) ? nums[0] : 0,
-        Number.isFinite(nums[1]) ? nums[1] : 0,
-        Number.isFinite(nums[2]) ? nums[2] : 0,
-    ];
-}

package/dist/tools/get-performance-profile.d.ts

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-export declare const getPerformanceProfileTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        account_id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-    }, "strip", z.ZodTypeAny, {
-        account_id: string | number;
-    }, {
-        account_id: string | number;
-    }>;
-    execute(client: PosterlyClient, input: {
-        account_id: string | number;
-    }): Promise<string>;
-};

package/dist/tools/get-performance-profile.js

@@ -1,39 +0,0 @@
-import { z } from 'zod';
-import { mdTitle, mdSection, mdKeyValue, mdBullets, mdQuote, mdEmpty, formatPercent, formatDateTime } from '../lib/format.js';
-export const getPerformanceProfileTool = {
-    name: 'get_performance_profile',
-    description: "Get the performance profile posterly has derived for a connected account from the last 90 days of per-post analytics. Returns coaching stats (format, timing, caption-length patterns), an engagement-rate trend, and a narrative summary. Keyed by social account ID (from list_accounts or list_brand_accounts). Returns nothing until the account has a derived profile; Google Business Profile and other platforms without per-post analytics never get one. Read-only; requires a Pro plan or higher.",
-    inputSchema: z.object({
-        account_id: z
-            .union([z.string(), z.number()])
-            .describe('The social account ID to inspect (from list_accounts or list_brand_accounts).'),
-    }),
-    async execute(client, input) {
-        const { performance_profile, reason } = await client.getAccountPerformanceProfile(input.account_id);
-        if (!performance_profile) {
-            const detail = reason === 'platform_not_measurable'
-                ? 'This platform does not produce per-post analytics, so posterly cannot build a performance profile for it.'
-                : reason === 'feature_not_available'
-                    ? 'Performance profiles require a Pro plan or higher.'
-                    : 'posterly has not built a performance profile for this account yet. It needs about 90 days of tracked posts to learn from.';
-            return mdEmpty('performance profile yet', detail);
-        }
-        const label = performance_profile.username
-            ? `@${performance_profile.username}${performance_profile.platform ? ` (${performance_profile.platform})` : ''}`
-            : `account ${performance_profile.social_account_id}`;
-        const rate = performance_profile.engagement_rate_avg != null
-            ? formatPercent(performance_profile.engagement_rate_avg * 100)
-            : 'n/a';
-        return [
-            mdTitle('Account performance profile', `${label} · last ${performance_profile.window_days ?? 90} days`),
-            performance_profile.narrative_summary ? mdSection('Summary', mdQuote(performance_profile.narrative_summary)) : '',
-            performance_profile.bullets.length ? mdSection('What is working', mdBullets(performance_profile.bullets)) : '',
-            mdSection('Stats', mdKeyValue([
-                ['Posts sampled', performance_profile.sample_size],
-                ['Avg engagement rate', rate],
-                ['Engagement trend', performance_profile.engagement_rate_trend],
-                ['Derived at', formatDateTime(performance_profile.derived_at)],
-            ])),
-        ].filter(Boolean).join('\n\n');
-    },
-};

package/dist/tools/get-platform-schema.d.ts

@@ -1,24 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-export declare const getPlatformSchemaTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        account_id: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "lemmy", "linkedin", "mastodon", "medium", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "youtube"]>>;
-        include_planned: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
-        include_planned?: boolean | undefined;
-        account_id?: string | undefined;
-    }, {
-        platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "slack" | "mastodon" | "devto" | "hashnode" | "wordpress" | "lemmy" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
-        include_planned?: boolean | undefined;
-        account_id?: string | undefined;
-    }>;
-    execute(client: PosterlyClient, input: {
-        account_id?: string;
-        platform?: string;
-        include_planned?: boolean;
-    }): Promise<string>;
-};

package/dist/tools/get-platform-schema.js

@@ -1,48 +0,0 @@
-import { z } from 'zod';
-import { ALL_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
-export const getPlatformSchemaTool = {
-    name: 'get_platform_schema',
-    description: 'Get the platform schema for a specific connected account or platform. For Instagram, pass account_id before native tags/collaborators so connection-specific capabilities are returned.',
-    inputSchema: z.object({
-        account_id: z
-            .string()
-            .optional()
-            .describe('Connected account ID from list_accounts. Preferred because it returns account context.'),
-        platform: z
-            .enum(ALL_PLATFORM_INPUTS)
-            .optional()
-            .describe(`Platform ID such as ${SUPPORTED_PLATFORM_IDS.join(', ')}. Set include_planned to inspect planned providers.`),
-        include_planned: z.boolean().optional(),
-    }),
-    async execute(client, input) {
-        const result = await client.getPlatformSchema(input);
-        const schema = result.schema || result.platform || result.platforms?.[0];
-        if (!schema)
-            return JSON.stringify(result, null, 2);
-        const fields = schema.settings_schema?.fields || [];
-        const helpers = schema.helper_tools || [];
-        const accountLine = result.account
-            ? `Account: ${result.account.username || result.account.id} (${result.account.platform})\n`
-            : '';
-        const instagramTaggingLine = result.account?.instagram_tagging
-            ? `Instagram tagging capabilities: ${JSON.stringify(result.account.instagram_tagging)}`
-            : '';
-        return [
-            `${schema.label} (${schema.id}) schema`,
-            accountLine.trim(),
-            instagramTaggingLine,
-            `Status: ${schema.status}`,
-            `Post types: ${schema.post_types.join(', ') || 'n/a'}`,
-            `Content limit: ${schema.content_limit ?? 'n/a'}`,
-            `Media: ${JSON.stringify(schema.media)}`,
-            `Analytics: ${schema.analytics_supported ? 'yes' : 'no'}`,
-            fields.length
-                ? `Settings:\n${fields.map((field) => `• ${field.key}${field.required ? ' (required)' : ''}: ${field.description}`).join('\n')}`
-                : 'Settings: none',
-            helpers.length
-                ? `Helpers:\n${helpers.map((helper) => `• ${helper.name}: ${helper.description}`).join('\n')}`
-                : 'Helpers: none',
-            `Example settings: ${JSON.stringify(schema.settings_schema?.example || {})}`,
-        ].filter(Boolean).join('\n');
-    },
-};

package/dist/tools/get-post-analytics.d.ts

@@ -1,39 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-declare const presentationSchema: z.ZodOptional<z.ZodEnum<["compact", "table", "json"]>>;
-type AnalyticsPresentation = z.infer<typeof presentationSchema>;
-export declare const getPostAnalyticsTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        account_id: z.ZodNumber;
-        from: z.ZodOptional<z.ZodString>;
-        to: z.ZodOptional<z.ZodString>;
-        limit: z.ZodOptional<z.ZodNumber>;
-        offset: z.ZodOptional<z.ZodNumber>;
-        presentation: z.ZodOptional<z.ZodEnum<["compact", "table", "json"]>>;
-    }, "strip", z.ZodTypeAny, {
-        account_id: number;
-        limit?: number | undefined;
-        offset?: number | undefined;
-        from?: string | undefined;
-        to?: string | undefined;
-        presentation?: "compact" | "table" | "json" | undefined;
-    }, {
-        account_id: number;
-        limit?: number | undefined;
-        offset?: number | undefined;
-        from?: string | undefined;
-        to?: string | undefined;
-        presentation?: "compact" | "table" | "json" | undefined;
-    }>;
-    execute(client: PosterlyClient, input: {
-        account_id: number;
-        from?: string;
-        to?: string;
-        limit?: number;
-        offset?: number;
-        presentation?: AnalyticsPresentation;
-    }): Promise<string>;
-};
-export {};

package/dist/tools/get-post-analytics.js

@@ -1,222 +0,0 @@
-import { z } from 'zod';
-const presentationSchema = z.enum(['compact', 'table', 'json']).optional();
-export const getPostAnalyticsTool = {
-    name: 'get_post_analytics',
-    description: 'Get per-post engagement metrics (likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, watch time) for a connected social account. Supports Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads. Returns the most recent posts first. presentation controls output: compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
-    inputSchema: z.object({
-        account_id: z
-            .number()
-            .describe('The social account ID (from list_accounts)'),
-        from: z
-            .string()
-            .optional()
-            .describe('Start date (ISO date, e.g. 2026-03-19). Defaults to 30 days ago.'),
-        to: z
-            .string()
-            .optional()
-            .describe('End date (ISO date). Defaults to today.'),
-        limit: z
-            .number()
-            .min(1)
-            .max(200)
-            .optional()
-            .describe('Number of posts to return (default 50, max 200)'),
-        offset: z.number().min(0).optional().describe('Pagination offset'),
-        presentation: presentationSchema.describe('Output style: compact bullets, Markdown table, or raw JSON for client-side chart/card rendering.'),
-    }),
-    async execute(client, input) {
-        const result = await client.getPostAnalytics(input);
-        return formatPostAnalytics(result, input.presentation || 'compact');
-    },
-};
-function formatPostAnalytics(result, presentation) {
-    const { account, range, posts, total } = result;
-    if (posts.length === 0) {
-        return `No analytics found for ${accountLabel(account.username)} (${account.platform}) between ${range.from} and ${range.to}.`;
-    }
-    const totals = posts.reduce((acc, post) => {
-        acc.likes += post.likes || 0;
-        acc.comments += post.comments || 0;
-        acc.reach += post.reach || 0;
-        acc.impressions += post.impressions || 0;
-        acc.shares += post.shares || 0;
-        acc.reposts += post.reposts || 0;
-        acc.quotes += post.quotes || 0;
-        acc.saves += post.saved || 0;
-        return acc;
-    }, { likes: 0, comments: 0, reach: 0, impressions: 0, shares: 0, reposts: 0, quotes: 0, saves: 0 });
-    const isThreads = account.platform === 'threads';
-    if (presentation === 'json') {
-        return JSON.stringify({
-            type: 'post_analytics',
-            account,
-            range,
-            returned: {
-                count: posts.length,
-                total,
-            },
-            totals,
-            posts,
-        }, null, 2);
-    }
-    if (presentation === 'table') {
-        if (isThreads) {
-            return [
-                `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-                `_Threads · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-                '',
-                '**Returned totals**',
-                markdownTable(['Views', 'Likes', 'Replies', 'Reposts', 'Quotes', 'Shares'], [[
-                        formatNumber(totals.impressions),
-                        formatNumber(totals.likes),
-                        formatNumber(totals.comments),
-                        formatNumber(totals.reposts),
-                        formatNumber(totals.quotes),
-                        formatNumber(totals.shares),
-                    ]]),
-                '',
-                '**Posts**',
-                markdownTable(['Posted', 'Post', 'Caption', 'Views', 'Likes', 'Replies', 'Reposts', 'Quotes', 'Shares'], posts.map((post) => [
-                    dateTime(post.posted_at),
-                    post.id ? String(post.id) : post.platform_media_id,
-                    compact(post.caption_snippet, 70) || '(no caption)',
-                    formatNumber(post.impressions),
-                    formatNumber(post.likes),
-                    formatNumber(post.comments),
-                    formatNumber(post.reposts),
-                    formatNumber(post.quotes),
-                    formatNumber(post.shares),
-                ])),
-            ].join('\n');
-        }
-        return [
-            `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-            `_${account.platform} · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-            '',
-            '**Returned totals**',
-            markdownTable(['Likes', 'Comments', 'Reach', 'Impressions', 'Shares', 'Saves'], [[
-                    formatNumber(totals.likes),
-                    formatNumber(totals.comments),
-                    formatNumber(totals.reach),
-                    formatNumber(totals.impressions),
-                    formatNumber(totals.shares),
-                    formatNumber(totals.saves),
-                ]]),
-            '',
-            '**Posts**',
-            markdownTable(['Posted', 'Post', 'Caption', 'Reach', 'Likes', 'Comments', 'Extras'], posts.map((post) => [
-                dateTime(post.posted_at),
-                post.id ? String(post.id) : post.platform_media_id,
-                compact(post.caption_snippet, 70) || '(no caption)',
-                formatNumber(post.reach),
-                formatNumber(post.likes),
-                formatNumber(post.comments),
-                postExtras(account.platform, post),
-            ])),
-        ].join('\n');
-    }
-    const lines = [
-        `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-        `_${account.platform} · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-        '',
-        '**Returned totals**',
-        `- **Likes:** ${formatNumber(totals.likes)}`,
-        `- **Comments:** ${formatNumber(totals.comments)}`,
-        `- **Reach:** ${formatNumber(totals.reach)}`,
-        `- **Impressions:** ${formatNumber(totals.impressions)}`,
-        `- **Shares:** ${formatNumber(totals.shares)}`,
-        `- **Saves:** ${formatNumber(totals.saves)}`,
-        '',
-        '**Posts**',
-    ];
-    if (isThreads) {
-        const threadLines = [
-            `**📈 Post analytics for ${accountLabel(account.username)} (${account.id})**`,
-            `_Threads · ${range.from} → ${range.to} · showing ${posts.length} of ${total}_`,
-            '',
-            '**Returned totals**',
-            `- **Views:** ${formatNumber(totals.impressions)}`,
-            `- **Likes:** ${formatNumber(totals.likes)}`,
-            `- **Replies:** ${formatNumber(totals.comments)}`,
-            `- **Reposts:** ${formatNumber(totals.reposts)}`,
-            `- **Quotes:** ${formatNumber(totals.quotes)}`,
-            `- **Shares:** ${formatNumber(totals.shares)}`,
-            '',
-            '**Posts**',
-        ];
-        posts.forEach((post, index) => {
-            threadLines.push(`${index + 1}. **${compact(post.caption_snippet, 70) || '(no caption)'}**`);
-            threadLines.push(`   Posted: ${dateTime(post.posted_at)}`);
-            threadLines.push(`   Post ID: ${post.id ? String(post.id) : post.platform_media_id}`);
-            threadLines.push(`   Views: ${formatNumber(post.impressions)}`);
-            threadLines.push(`   Likes: ${formatNumber(post.likes)}`);
-            threadLines.push(`   Replies: ${formatNumber(post.comments)}`);
-            threadLines.push(`   Reposts: ${formatNumber(post.reposts)}`);
-            threadLines.push(`   Quotes: ${formatNumber(post.quotes)}`);
-            threadLines.push(`   Shares: ${formatNumber(post.shares)}`);
-            if (post.permalink)
-                threadLines.push(`   Permalink: ${post.permalink}`);
-        });
-        return threadLines.join('\n');
-    }
-    posts.forEach((post, index) => {
-        lines.push(`${index + 1}. **${compact(post.caption_snippet, 70) || '(no caption)'}**`);
-        lines.push(`   Posted: ${dateTime(post.posted_at)}`);
-        lines.push(`   Post ID: ${post.id ? String(post.id) : post.platform_media_id}`);
-        lines.push(`   Reach: ${formatNumber(post.reach)}`);
-        lines.push(`   Likes: ${formatNumber(post.likes)}`);
-        lines.push(`   Comments: ${formatNumber(post.comments)}`);
-        lines.push(`   Extras: ${postExtras(account.platform, post)}`);
-    });
-    return lines.join('\n');
-}
-function postExtras(platform, post) {
-    const metrics = [];
-    if (post.impressions)
-        metrics.push(`${formatNumber(post.impressions)} impressions`);
-    if (post.saved)
-        metrics.push(`${formatNumber(post.saved)} saved`);
-    if (platform !== 'threads' && post.shares)
-        metrics.push(`${formatNumber(post.shares)} shares`);
-    if (post.plays)
-        metrics.push(`${formatNumber(post.plays)} plays`);
-    if (platform === 'youtube' && post.total_watch_time_ms)
-        metrics.push(`${formatNumber(Math.round(post.total_watch_time_ms / 60000))} watch minutes`);
-    if (platform === 'youtube' && post.avg_watch_time_ms)
-        metrics.push(`${formatNumber(Math.round(post.avg_watch_time_ms / 1000))}s avg view`);
-    if (post.url_link_clicks)
-        metrics.push(platform === 'pinterest' ? `${formatNumber(post.url_link_clicks)} outbound clicks` : `${formatNumber(post.url_link_clicks)} link clicks`);
-    if (post.user_profile_clicks)
-        metrics.push(platform === 'pinterest' ? `${formatNumber(post.user_profile_clicks)} pin clicks` : `${formatNumber(post.user_profile_clicks)} profile clicks`);
-    if (post.permalink)
-        metrics.push(post.permalink);
-    return metrics.join(' · ') || 'n/a';
-}
-function accountLabel(username) {
-    if (!username)
-        return 'account';
-    return username.startsWith('@') || /\s/.test(username) ? username : `@${username}`;
-}
-function dateTime(value) {
-    if (!value)
-        return 'n/a';
-    const date = new Date(value);
-    return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
-}
-function compact(value, maxLength) {
-    const text = String(value || '').replace(/\s+/g, ' ').trim();
-    return text.length > maxLength ? `${text.slice(0, Math.max(0, maxLength - 1))}…` : text;
-}
-function formatNumber(value) {
-    return value == null ? 'n/a' : value.toLocaleString();
-}
-function markdownTable(headers, rows) {
-    return [
-        `| ${headers.map(escapeCell).join(' | ')} |`,
-        `| ${headers.map(() => '---').join(' | ')} |`,
-        ...rows.map((row) => `| ${row.map(escapeCell).join(' | ')} |`),
-    ].join('\n');
-}
-function escapeCell(value) {
-    return String(value).replace(/\|/g, '\\|').replace(/\r?\n/g, '<br>');
-}

package/dist/tools/get-post-insights.d.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-export declare const getPostInsightsTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        account_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-        post_id: z.ZodOptional<z.ZodNumber>;
-        checkpoint: z.ZodOptional<z.ZodEnum<["1h", "6h", "24h", "72h", "7d"]>>;
-        limit: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        account_id?: string | number | undefined;
-        post_id?: number | undefined;
-        checkpoint?: "1h" | "6h" | "24h" | "72h" | "7d" | undefined;
-        limit?: number | undefined;
-    }, {
-        account_id?: string | number | undefined;
-        post_id?: number | undefined;
-        checkpoint?: "1h" | "6h" | "24h" | "72h" | "7d" | undefined;
-        limit?: number | undefined;
-    }>;
-    execute(client: PosterlyClient, input: {
-        account_id?: string | number;
-        post_id?: number;
-        checkpoint?: "1h" | "6h" | "24h" | "72h" | "7d";
-        limit?: number;
-    }): Promise<string>;
-};

package/dist/tools/get-post-insights.js

@@ -1,39 +0,0 @@
-import { z } from 'zod';
-import { mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText, formatDateTime } from '../lib/format.js';
-export const getPostInsightsTool = {
-    name: 'get_post_insights',
-    description: 'List per-post feedback insights from the posterly performance feedback loop: for recently published posts, the performance tier (great/good/mixed/poor), a diagnosis, a suggested next action, metrics, and the baseline it was compared against. Filter by account_id, post_id, and checkpoint (1h, 6h, 24h, 72h, 7d). Read-only; requires a Pro plan or higher.',
-    inputSchema: z.object({
-        account_id: z
-            .union([z.string(), z.number()])
-            .optional()
-            .describe('Filter to one social account ID (from list_accounts).'),
-        post_id: z.number().int().positive().optional().describe('Filter to one post ID.'),
-        checkpoint: z
-            .enum(['1h', '6h', '24h', '72h', '7d'])
-            .optional()
-            .describe('Filter to one checkpoint after publish.'),
-        limit: z.number().int().min(1).max(100).optional().describe('Max insights to return (default 20).'),
-    }),
-    async execute(client, input) {
-        const { insights } = await client.getPostInsights(input);
-        if (!insights.length) {
-            return mdEmpty('feedback insights', 'No per-post feedback insights are available for these filters yet. Insights appear as posts hit their 1h, 6h, 24h, 72h, and 7d checkpoints.');
-        }
-        const blocks = insights.map((insight) => {
-            const heading = `${insight.title || 'Insight'} (${insight.performance_tier}, ${insight.checkpoint})`;
-            return mdSection(heading, mdKeyValue([
-                ['Post ID', insight.post_id],
-                ['Platform', insight.platform],
-                ['Account', insight.username ? `@${insight.username}` : String(insight.social_account_id)],
-                ['Diagnosis', truncateText(insight.diagnosis, 220)],
-                ['Next action', truncateText(insight.next_action, 220)],
-                ['Impact score', insight.impact_score],
-                ['Confidence', insight.confidence],
-                ['Published', formatDateTime(insight.published_at)],
-                ['Permalink', insight.permalink || undefined],
-            ]));
-        });
-        return [mdTitle(`Post feedback insights (${insights.length})`), ...blocks].join('\n\n');
-    },
-};

package/dist/tools/get-post-missing.d.ts

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-import type { PosterlyClient } from '../lib/api-client.js';
-export declare const getPostMissingTool: {
-    name: string;
-    description: string;
-    inputSchema: z.ZodObject<{
-        post_id: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        post_id: number;
-    }, {
-        post_id: number;
-    }>;
-    execute(client: PosterlyClient, input: {
-        post_id: number;
-    }): Promise<string>;
-};