postfast-mcp 0.1.24 → 0.3.0

package/dist/core/tools/accounts.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { dataListOutputSchema } from '../shared.js';
+export const accountTools = [
+    {
+        name: 'list_accounts',
+        binding: 'both',
+        title: 'List Accounts',
+        description: 'List all social media accounts connected to the workspace. Each account includes connectionStatus (CONNECTED or DISABLED) and disabledReason (null unless DISABLED), plus followerCount (latest stored snapshot, a string; absent for platforms without follower data), followerCountUpdatedAt, and inboxCapable (whether the account can appear in the social inbox, i.e. comment ingestion is supported). A DISABLED account will not publish until the user reconnects it — pre-check before scheduling. For a follower trend over time, use get_follower_history.',
+        inputSchema: {},
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        run: (port, _args, workspaceId) => port.listAccounts(workspaceId),
+    },
+    {
+        name: 'list_pinterest_boards',
+        binding: 'both',
+        title: 'List Pinterest Boards',
+        description: 'List Pinterest boards for a connected Pinterest account (pass its socialMediaId). Use a returned board’s boardId field as controls.pinterestBoardId in create_posts.',
+        inputSchema: {
+            socialMediaId: z.uuid().describe('Pinterest account id (from list_accounts)'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.listPinterestBoards(args.socialMediaId, workspaceId),
+    },
+    {
+        name: 'list_youtube_playlists',
+        binding: 'both',
+        title: 'List YouTube Playlists',
+        description: 'List YouTube playlists for a connected YouTube account (pass its socialMediaId). Use a returned playlist’s playlistId field as controls.youtubePlaylistId in create_posts.',
+        inputSchema: {
+            socialMediaId: z.uuid().describe('YouTube account id (from list_accounts)'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.listYoutubePlaylists(args.socialMediaId, workspaceId),
+    },
+    {
+        name: 'list_gbp_locations',
+        binding: 'both',
+        title: 'List Google Business Profile Locations',
+        description: 'List Google Business Profile locations for a connected GBP account (pass its socialMediaId). Use a returned location’s locationId field as controls.gbpLocationId in create_posts.',
+        inputSchema: {
+            socialMediaId: z.uuid().describe('GBP account id (from list_accounts)'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.listGbpLocations(args.socialMediaId, workspaceId),
+    },
+    {
+        name: 'get_follower_history',
+        binding: 'both',
+        title: 'Get Follower History',
+        description: 'Daily follower-count snapshots for one connected account (pass its socialMediaId from list_accounts). Returns currentFollowerCount, delta (current − first snapshot in range), trackingStartedAt (when PostFast began recording this account), and a series of { capturedAt, followerCount } points. All counts are strings (bigint); currentFollowerCount, delta, and trackingStartedAt may be absent until the account has its first snapshot. Optional from/to bound the range (ISO 8601; default last 90 days, capped at 365). Snapshots are forward-only — no data before trackingStartedAt. Coverage: Facebook Pages, Instagram, YouTube, Pinterest, Threads, Bluesky, Telegram, LinkedIn company pages, and TikTok. Not available: X, personal Facebook.',
+        inputSchema: {
+            socialMediaId: z.uuid().describe('Account id (from list_accounts)'),
+            from: z
+                .string()
+                .optional()
+                .describe('Range start (ISO 8601, e.g. 2026-03-01T00:00:00.000Z). Defaults to 90 days ago.'),
+            to: z
+                .string()
+                .optional()
+                .describe('Range end (ISO 8601). Defaults to now; range is capped at 365 days.'),
+        },
+        outputSchema: {
+            socialMediaId: z.string().optional(),
+            series: z.array(z.unknown()).optional(),
+            currentFollowerCount: z.string().optional(),
+            delta: z.string().optional(),
+            trackingStartedAt: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        run: (port, args, workspaceId) => port.getFollowerHistory(args, workspaceId),
+    },
+    {
+        name: 'search_places',
+        binding: 'both',
+        title: 'Search Places',
+        description: 'Search for a place to geotag a post. Pass free text (min 2 chars, e.g. a venue name or address); returns matching places, each with an id that works as BOTH controls.facebookPlaceId (Facebook feed posts) and controls.instagramLocationId (Instagram single-media posts). Only Facebook Pages that carry location data are returned.',
+        inputSchema: {
+            query: z.string().min(2).describe('Place search text, min 2 characters (e.g. "eiffel tower")'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.searchPlaces(args.query, workspaceId),
+    },
+    {
+        name: 'generate_connect_link',
+        binding: 'both',
+        title: 'Generate Connect Link',
+        description: 'Generate a shareable link for external clients to connect their social accounts to the workspace.',
+        inputSchema: {
+            expiryDays: z
+                .number()
+                .int()
+                .min(1)
+                .max(30)
+                .default(7)
+                .describe('Link expiry in days (1-30, default 7)'),
+            sendEmail: z.boolean().default(false).describe('Send the link via email'),
+            email: z
+                .email()
+                .optional()
+                .describe('Recipient email (required when sendEmail is true)'),
+        },
+        outputSchema: { connectUrl: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.generateConnectLink(args, workspaceId),
+    },
+];
+//# sourceMappingURL=accounts.js.map

package/dist/core/tools/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/core/tools/accounts.ts"],"names":[],"mappings":"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"}

package/dist/core/tools/inbox.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDef } from '../tool-def.js';
+/**
+ * Social inbox — a COMMENTS inbox (comments on the workspace's own posts;
+ * never described as DMs/messages). Coverage: TikTok (Business connections),
+ * Instagram, Facebook Pages, Threads. Reply capability is server-computed per
+ * conversation (canReply / maxReplyLength / windowState / disabledReason) —
+ * descriptions steer models to render from those fields, never platform rules.
+ * Every def carries portMethod so bindings whose adapter predates this wave
+ * skip these tools instead of shipping broken ones.
+ */
+export declare const inboxTools: ToolDef[];

package/dist/core/tools/inbox.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+import { INBOX_CONVERSATION_STATUSES, INBOX_ITEM_STATE_ACTIONS, PLATFORMS, dataListOutputSchema, } from '../shared.js';
+/**
+ * Social inbox — a COMMENTS inbox (comments on the workspace's own posts;
+ * never described as DMs/messages). Coverage: TikTok (Business connections),
+ * Instagram, Facebook Pages, Threads. Reply capability is server-computed per
+ * conversation (canReply / maxReplyLength / windowState / disabledReason) —
+ * descriptions steer models to render from those fields, never platform rules.
+ * Every def carries portMethod so bindings whose adapter predates this wave
+ * skip these tools instead of shipping broken ones.
+ */
+export const inboxTools = [
+    {
+        name: 'list_inbox_conversations',
+        binding: 'both',
+        title: 'List Inbox Conversations',
+        description: "List comment conversations from the social inbox — comments on your connected accounts' posts, grouped per post, newest activity first. Covers TikTok (Business connections), Instagram, Facebook Pages, and Threads; comments arrive within seconds of being posted and only from connect/launch onward (no history backfill). Each conversation carries a server-computed reply capability — canReply, maxReplyLength, windowState, disabledReason — plus unreadCount, status (OPEN | SNOOZED | CLOSED), and assignedToUserId. ALWAYS derive whether and how long you can reply from those fields; never assume platform rules.",
+        inputSchema: {
+            page: z.number().int().min(0).default(0).describe('Page number (0-based)'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(20)
+                .describe('Conversations per page (max 50)'),
+            platforms: z.array(z.enum(PLATFORMS)).optional().describe('Filter by platforms'),
+            socialMediaIds: z
+                .array(z.uuid())
+                .optional()
+                .describe('Filter by specific social media account ids (from list_accounts)'),
+            statuses: z
+                .array(z.enum(INBOX_CONVERSATION_STATUSES))
+                .optional()
+                .describe('Filter by conversation statuses'),
+            unreadOnly: z
+                .boolean()
+                .optional()
+                .describe('Only conversations with unread comments'),
+            assignedToUserId: z
+                .uuid()
+                .optional()
+                .describe('Only conversations assigned to this workspace member'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        portMethod: 'listInboxConversations',
+        run: (port, args, workspaceId) => port.listInboxConversations(args, workspaceId),
+    },
+    {
+        name: 'get_inbox_conversation',
+        binding: 'both',
+        title: 'Get Inbox Conversation',
+        description: 'Fetch one inbox conversation by id, including its server-computed reply capability (canReply, maxReplyLength, windowState, disabledReason) — derive reply ability from these fields, never from hardcoded platform rules. Returns null when the conversation does not exist in the workspace.',
+        inputSchema: {
+            id: z.uuid().describe('Conversation id (from list_inbox_conversations)'),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        portMethod: 'getInboxConversation',
+        run: (port, args, workspaceId) => port.getInboxConversation(args.id, workspaceId),
+    },
+    {
+        name: 'list_inbox_items',
+        binding: 'both',
+        title: 'List Inbox Items',
+        description: 'List the items of one inbox conversation — the comments and the replies sent to them — oldest first by default (order=DESC for newest first). Items carry direction (INBOUND | OUTBOUND), state (VISIBLE | HIDDEN | DELETED), author info, and on Instagram comments canPrivateReply (eligibility for send_inbox_private_reply). Replies sent from PostFast appear exactly once — no duplicates when the platform reports them back.',
+        inputSchema: {
+            conversationId: z
+                .uuid()
+                .describe('Conversation id (from list_inbox_conversations)'),
+            page: z.number().int().min(0).default(0).describe('Page number (0-based)'),
+            limit: z.number().int().min(1).max(50).default(20).describe('Items per page (max 50)'),
+            order: z
+                .enum(['ASC', 'DESC'])
+                .optional()
+                .describe('Sort by comment time. Default ASC (oldest first); DESC for newest first.'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        portMethod: 'listInboxItems',
+        run: (port, args, workspaceId) => port.listInboxItems(args, workspaceId),
+    },
+    {
+        name: 'get_inbox_unread_count',
+        binding: 'both',
+        title: 'Get Inbox Unread Count',
+        description: 'Total unread comment count across all inbox conversations in the workspace (the sum of per-conversation unreadCount). Use mark_inbox_conversation_read after presenting a conversation to the user.',
+        inputSchema: {},
+        outputSchema: { unreadCount: z.number().optional() },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        portMethod: 'getInboxUnreadCount',
+        run: (port, _args, workspaceId) => port.getInboxUnreadCount(workspaceId),
+    },
+    {
+        name: 'reply_to_inbox_item',
+        binding: 'both',
+        title: 'Reply to Inbox Comment',
+        description: "Reply publicly UNDER a specific comment — pass the comment item's id (from list_inbox_items), not the conversation id. BEFORE replying, check the conversation's canReply and maxReplyLength and stay within them; the caps are per platform (TikTok 150, Instagram 2,200, Facebook 8,000, Threads 500 characters) but the server-computed fields are authoritative — never assume. Failures return inbox.* codes (e.g. replyTooLong, replyNotSupported, rateLimited).",
+        inputSchema: {
+            itemId: z.uuid().describe('The comment item id to reply under (from list_inbox_items)'),
+            text: z.string().min(1).describe("Reply text. Must fit the conversation's maxReplyLength."),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        portMethod: 'replyToInboxItem',
+        run: (port, args, workspaceId) => port.replyToInboxItem(args, workspaceId),
+    },
+    {
+        name: 'send_inbox_private_reply',
+        binding: 'both',
+        title: 'Send Instagram Private Reply',
+        description: "Instagram only: send ONE private reply to a comment — it arrives as a direct message to the commenter and may land in their Message Requests folder. Allowed once per comment, within 7 days of the comment, up to 1,000 bytes (emoji and non-Latin text count multi-byte — roughly 1,000 characters, less with emoji). Check the item's canPrivateReply first (from list_inbox_items). A second attempt on the same comment fails with inbox.privateReplyAlreadySent; other failures include privateReplyWindowExpired and privateReplyNotSupported.",
+        inputSchema: {
+            itemId: z
+                .uuid()
+                .describe('The Instagram comment item id to reply privately to (canPrivateReply must be true)'),
+            text: z.string().min(1).describe('Private reply text (max 1,000 bytes)'),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        portMethod: 'sendInboxPrivateReply',
+        run: (port, args, workspaceId) => port.sendInboxPrivateReply(args, workspaceId),
+    },
+    {
+        name: 'set_inbox_item_state',
+        binding: 'both',
+        title: 'Moderate Inbox Comment',
+        description: 'Moderate a comment on the platform: HIDE hides it from the public, UNHIDE restores it, DELETE removes the comment on the platform — cannot be undone. Hide/unhide work on TikTok, Instagram, Facebook, and Threads; DELETE is not supported on Threads (inbox.deleteNotSupported). State changes made on the platform itself sync back to the inbox automatically.',
+        inputSchema: {
+            itemId: z.uuid().describe('The comment item id (from list_inbox_items)'),
+            action: z
+                .enum(INBOX_ITEM_STATE_ACTIONS)
+                .describe('HIDE, UNHIDE, or DELETE (DELETE is irreversible)'),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+        portMethod: 'setInboxItemState',
+        run: (port, args, workspaceId) => port.setInboxItemState(args, workspaceId),
+    },
+    {
+        name: 'mark_inbox_conversation_read',
+        binding: 'both',
+        title: 'Mark Inbox Conversation Read',
+        description: "Mark one conversation read (zeroes its unreadCount). Do this after presenting a conversation's comments to the user. Internal to PostFast — nothing changes on the platform.",
+        inputSchema: {
+            conversationId: z
+                .uuid()
+                .describe('Conversation id (from list_inbox_conversations)'),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
+        portMethod: 'markInboxConversationRead',
+        run: (port, args, workspaceId) => port.markInboxConversationRead(args.conversationId, workspaceId),
+    },
+    {
+        name: 'set_inbox_conversation_status',
+        binding: 'both',
+        title: 'Set Inbox Conversation Status',
+        description: 'Triage a conversation: set its status to OPEN, SNOOZED, or CLOSED. Internal to PostFast — nothing changes on the platform.',
+        inputSchema: {
+            conversationId: z
+                .uuid()
+                .describe('Conversation id (from list_inbox_conversations)'),
+            status: z.enum(INBOX_CONVERSATION_STATUSES).describe('New conversation status'),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
+        portMethod: 'setInboxConversationStatus',
+        run: (port, args, workspaceId) => port.setInboxConversationStatus(args, workspaceId),
+    },
+    {
+        name: 'assign_inbox_conversation',
+        binding: 'both',
+        title: 'Assign Inbox Conversation',
+        description: 'Assign a conversation to a workspace member for follow-up, or omit assigneeUserId to unassign. The assignee must be a member of the workspace (inbox.assigneeNotMember otherwise). Internal to PostFast — nothing changes on the platform.',
+        inputSchema: {
+            conversationId: z
+                .uuid()
+                .describe('Conversation id (from list_inbox_conversations)'),
+            assigneeUserId: z
+                .uuid()
+                .optional()
+                .describe('Workspace member user id to assign. Omit to unassign.'),
+        },
+        outputSchema: { id: z.string().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
+        portMethod: 'assignInboxConversation',
+        run: (port, args, workspaceId) => port.assignInboxConversation(args, workspaceId),
+    },
+];
+//# sourceMappingURL=inbox.js.map

package/dist/core/tools/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../src/core/tools/inbox.ts"],"names":[],"mappings":"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"}

package/dist/core/tools/index.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDef } from '../tool-def.js';
+/**
+ * Every PostFast tool, in registration order. The order filtered to a binding
+ * must stay a superset-append of the published order — clients and their
+ * prompts see it, so existing tools keep their positions and new waves go
+ * at the end.
+ */
+export declare const ALL_TOOLS: ToolDef[];

package/dist/core/tools/index.js

@@ -0,0 +1,19 @@
+import { accountTools } from './accounts.js';
+import { inboxTools } from './inbox.js';
+import { postTools } from './posts.js';
+import { uploadTools } from './uploads.js';
+import { workspaceTools } from './workspaces.js';
+/**
+ * Every PostFast tool, in registration order. The order filtered to a binding
+ * must stay a superset-append of the published order — clients and their
+ * prompts see it, so existing tools keep their positions and new waves go
+ * at the end.
+ */
+export const ALL_TOOLS = [
+    ...postTools,
+    ...accountTools,
+    ...workspaceTools,
+    ...uploadTools,
+    ...inboxTools,
+];
+//# sourceMappingURL=index.js.map

package/dist/core/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,WAAW;IACd,GAAG,UAAU;CACd,CAAC"}

package/dist/core/tools/posts.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDef } from '../tool-def.js';
+export declare const postTools: ToolDef[];

package/dist/core/tools/posts.js

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+import { CREATE_APPROVAL_STATUSES, CREATE_STATUSES, PLATFORMS, POST_STATUSES, SET_APPROVAL_STATUSES, dataListOutputSchema, jsonParse, } from '../shared.js';
+/** The upload tools available on each binding, for prose that names them. */
+const UPLOAD_TOOLS = {
+    stdio: 'upload_media / get_upload_urls',
+    remote: 'upload_from_url / upload_media',
+};
+const mediaItemSchema = (binding) => z.object({
+    key: z
+        .string()
+        .describe(`Media key from ${UPLOAD_TOOLS[binding]} (e.g. image/<uuid>.jpg)`),
+    type: z.enum(['IMAGE', 'VIDEO']),
+    sortOrder: z.number().int().min(0),
+    coverImageKey: z
+        .string()
+        .optional()
+        .describe('Media key of a custom cover/thumbnail for video posts. Supported on Instagram Reels, Facebook Reels, Pinterest video pins.'),
+    coverTimestamp: z
+        .string()
+        .optional()
+        .describe('Video cover timestamp in milliseconds (e.g. "5000" = 5s). Fallback when coverImageKey is also provided.'),
+});
+const postItemSchema = (binding) => z.object({
+    content: z.string().describe('Post text content'),
+    firstComment: z
+        .string()
+        .optional()
+        .describe('First comment posted automatically after publishing. Supported on X, Instagram, Facebook, YouTube, Threads, and TikTok (TikTok: Business accounts only, max 150 chars, comments must be enabled).'),
+    mediaItems: z
+        .array(mediaItemSchema(binding))
+        .optional()
+        .describe('Media attachments'),
+    scheduledAt: z
+        .string()
+        .optional()
+        .describe('Schedule time (ISO 8601). Required when status is SCHEDULED.'),
+    socialMediaId: z.uuid().describe('Target social account id (from list_accounts)'),
+});
+/** Platform-specific controls — shared across every post in the batch. */
+const controlsSchema = z.object({
+    // X/Twitter
+    xRetweetUrl: z.string().optional(),
+    // TikTok
+    tiktokPrivacy: z
+        .enum(['PUBLIC', 'MUTUAL_FRIENDS', 'FOLLOWER_OF_CREATOR', 'ONLY_ME'])
+        .optional()
+        .describe('Deprecated. TikTok videos use the account default privacy (no per-post control) and photos default to public; use a draft for private posts.'),
+    tiktokIsDraft: z.boolean().optional(),
+    tiktokAllowComments: z.boolean().optional(),
+    tiktokAllowDuet: z.boolean().optional(),
+    tiktokAllowStitch: z.boolean().optional(),
+    tiktokBrandOrganic: z.boolean().optional(),
+    tiktokBrandContent: z.boolean().optional(),
+    tiktokAutoAddMusic: z.boolean().optional(),
+    tiktokIsAigc: z.boolean().optional().describe('Declare video as AI-generated content'),
+    tiktokTitle: z
+        .string()
+        .max(90)
+        .optional()
+        .describe('Title for TikTok photo posts (max 90 chars; photo posts only). When set, the full post content becomes the description; without it, content auto-splits on the first newline into title + description.'),
+    // Instagram
+    instagramPostToGrid: z.boolean().optional(),
+    instagramPublishType: z.enum(['TIMELINE', 'STORY', 'REEL']).optional(),
+    instagramCollaborators: z.array(z.string()).optional(),
+    instagramLocationId: z
+        .string()
+        .optional()
+        .describe('Geotag a single-media IG post — a numeric Facebook Page id with location data from search_places (same id as facebookPlaceId). Image/video/reel/story only, NOT carousels.'),
+    instagramLocationName: z
+        .string()
+        .max(255)
+        .optional()
+        .describe('Display-only place label from search_places (stored for your portal; never sent to Meta)'),
+    // YouTube
+    youtubePrivacy: z.enum(['PUBLIC', 'PRIVATE', 'UNLISTED']).optional(),
+    youtubeTags: z.array(z.string()).optional(),
+    youtubeCategoryId: z.string().optional(),
+    youtubeIsShort: z.boolean().optional(),
+    youtubeMadeForKids: z.boolean().optional(),
+    youtubeTitle: z.string().optional(),
+    youtubePlaylistId: z
+        .string()
+        .optional()
+        .describe('YouTube playlist id — the playlistId field from list_youtube_playlists'),
+    youtubeThumbnailKey: z
+        .string()
+        .optional()
+        .describe('Media key for a custom YouTube thumbnail (image, max 2MB, min 640px wide, 1280x720 recommended)'),
+    // Facebook
+    facebookContentType: z.enum(['POST', 'REEL', 'STORY']).optional(),
+    facebookAllowComments: z.boolean().optional(),
+    facebookPrivacy: z
+        .enum(['PUBLIC', 'FRIENDS_OF_FRIENDS', 'FRIENDS', 'SELF'])
+        .optional(),
+    facebookCarouselMainLink: z.string().optional(),
+    facebookCarouselShowEndCard: z.boolean().optional(),
+    facebookReelsCollaborators: z.array(z.string()).optional(),
+    facebookTargetCountries: z
+        .array(z.string().length(2))
+        .max(25)
+        .optional()
+        .describe('Limit who can see a Facebook FEED post by country — ISO 3166-1 alpha-2 codes (case-insensitive), max 25. Audience gating (hidden from everyone else), feed posts only — not Reels/Stories/video.'),
+    facebookPlaceId: z
+        .string()
+        .optional()
+        .describe('Geotag a Facebook FEED post — a numeric Facebook Page id with location data from search_places (same id as instagramLocationId). Feed posts only (text/photo/carousel) — not Reels/Stories/video.'),
+    facebookPlaceName: z
+        .string()
+        .max(255)
+        .optional()
+        .describe('Display-only place label from search_places (stored for your portal; never sent to Meta)'),
+    // Google Business Profile
+    gbpLocationId: z
+        .string()
+        .optional()
+        .describe('GBP location resource name — the locationId field from list_gbp_locations'),
+    gbpTopicType: z.enum(['STANDARD', 'EVENT', 'OFFER']).optional().describe('Post type'),
+    gbpCallToActionType: z
+        .enum(['BOOK', 'ORDER', 'LEARN_MORE', 'SIGN_UP', 'CALL', 'SHOP'])
+        .optional(),
+    gbpCallToActionUrl: z
+        .string()
+        .optional()
+        .describe('CTA button URL (not needed for CALL, ignored for OFFER)'),
+    gbpEventTitle: z.string().optional().describe('Title for EVENT/OFFER posts (max 58 chars)'),
+    gbpEventStartDate: z.string().optional().describe('Start date for EVENT/OFFER (ISO 8601)'),
+    gbpEventEndDate: z.string().optional().describe('End date for EVENT/OFFER (ISO 8601)'),
+    gbpOfferCouponCode: z.string().optional().describe('Coupon code (OFFER only)'),
+    gbpOfferRedeemUrl: z.string().optional().describe('Redemption URL (OFFER only)'),
+    gbpOfferTerms: z.string().optional().describe('Terms and conditions (OFFER only)'),
+    // Pinterest
+    pinterestBoardId: z
+        .string()
+        .optional()
+        .describe("Pinterest board id — the boardId field from list_pinterest_boards (NOT the account's socialMediaId)"),
+    pinterestLink: z.string().optional(),
+    // LinkedIn
+    linkedinAttachmentKey: z.string().optional(),
+    linkedinAttachmentTitle: z.string().optional(),
+});
+export const postTools = [
+    {
+        name: 'list_posts',
+        binding: 'both',
+        title: 'List Posts',
+        description: 'List social media posts with optional filters for specific IDs, platform, status, and date range. Failed or missed posts carry a lastError { message, code }; codes include MISSED_DISCONNECTED (the account was disconnected when the post was due — reconnect, then retry) and MISSED_NOT_PUBLISHED (passed its scheduled time plus a 2h grace window without publishing).',
+        inputSchema: {
+            page: z.number().int().min(0).default(0).describe('Page number (0-based)'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(20)
+                .describe('Posts per page (max 50)'),
+            ids: z
+                .array(z.uuid())
+                .max(100)
+                .optional()
+                .describe('Fetch only these post ids (workspace-scoped; max 100; AND-ed with other filters)'),
+            platforms: z.array(z.enum(PLATFORMS)).optional().describe('Filter by platforms'),
+            statuses: z
+                .array(z.enum(POST_STATUSES))
+                .optional()
+                .describe('Filter by post statuses'),
+            from: z
+                .string()
+                .optional()
+                .describe('Start date filter (ISO 8601, e.g. 2026-01-01T00:00:00.000Z)'),
+            to: z
+                .string()
+                .optional()
+                .describe('End date filter (ISO 8601, e.g. 2026-01-31T23:59:59.999Z)'),
+        },
+        outputSchema: {
+            data: z.array(z.unknown()).optional(),
+            totalCount: z.unknown().optional(),
+            pageInfo: z.unknown().optional(),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        run: (port, args, workspaceId) => port.listPosts(args, workspaceId),
+    },
+    {
+        name: 'create_posts',
+        binding: 'both',
+        title: 'Create Posts',
+        description: (binding) => 'Create and schedule social media posts (batch up to 15). Each post targets one social account (socialMediaId from list_accounts). SCHEDULED requires scheduledAt on every post; DRAFT must omit scheduledAt. Scheduling to a disconnected account (connectionStatus DISABLED in list_accounts) is rejected with HTTP 400 "socialMediaDisconnected" — pre-check connectionStatus before calling. Saving as DRAFT to a disconnected account is allowed. TikTok, Instagram, YouTube, Pinterest, and Google Business Profile require at least one media item EVEN FOR DRAFTS — attach media first (ask the user for an image/video, or generate+upload one, if none was provided). Attach media via the key returned by ' +
+            `${UPLOAD_TOOLS[binding]}.`,
+        inputSchema: (binding) => ({
+            posts: jsonParse(z
+                .array(postItemSchema(binding))
+                .min(1)
+                .max(15)
+                .describe('Array of posts to create (1-15)')),
+            status: z
+                .enum(CREATE_STATUSES)
+                .default('SCHEDULED')
+                .describe('Post status. SCHEDULED requires scheduledAt on every post.'),
+            approvalStatus: z
+                .enum(CREATE_APPROVAL_STATUSES)
+                .default('APPROVED')
+                .describe('Approval workflow status'),
+            controls: jsonParse(controlsSchema
+                .optional()
+                .describe('Platform-specific controls (shared across all posts in the batch)')),
+        }),
+        outputSchema: { postIds: z.array(z.string()).optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.createPosts(args, workspaceId),
+    },
+    {
+        name: 'approve_posts',
+        binding: 'remote',
+        title: 'Approve Posts',
+        description: 'Set the approval status of one or more posts (approval workflow). Typically used to move posts to APPROVED so they can publish, or to PENDING_APPROVAL / REJECTED / NEEDS_WORK.',
+        inputSchema: {
+            postIds: z.array(z.uuid()).min(1).describe('Post ids to update'),
+            approvalStatus: z.enum(SET_APPROVAL_STATUSES).describe('New approval status'),
+        },
+        outputSchema: { success: z.boolean().optional() },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.approvePosts(args, workspaceId),
+    },
+    {
+        name: 'delete_post',
+        binding: 'both',
+        title: 'Delete Post',
+        description: 'Delete a social media post by id.',
+        inputSchema: {
+            id: z.uuid().describe('Post id to delete'),
+        },
+        outputSchema: { deleted: z.boolean().optional() },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        run: (port, args, workspaceId) => port.deletePost(args.id, workspaceId),
+    },
+    {
+        name: 'get_post_analytics',
+        binding: 'both',
+        title: 'Get Post Analytics',
+        description: 'Fetch published posts with their latest performance metrics (impressions, reach, likes, comments, shares). Only returns published posts that have a platform post ID. LinkedIn personal accounts are excluded. Supported: Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (company pages), Pinterest (Business accounts). Metric counts are returned as strings. Pinterest extras include pin_clicks, outbound_clicks, saves_90d, save_rate_90d (saves are 90-day rolling because Pinterest API does not expose lifetime totals); video pins additionally surface mrc_views, views_10s, avg_watch_time, v50_watch_time, video_starts, quartile_95_views. Video posts also include normalized watch-time on latestMetric: avgWatchTimeSeconds, totalWatchTimeSeconds, videoViews (Facebook, Instagram Reels, YouTube, Pinterest, LinkedIn company pages, TikTok). Instagram posts also include on latestMetric: saveRate (saves / reach as a percentage, rounded to 2 decimals — on IG feed posts, reels, and carousels with metrics) and reelsSkipRate (Instagram Reels only — percentage of viewers who skipped the reel in the first 3 seconds, as reported by Instagram, rounded to 2 decimals; may be absent on low-view reels or until metrics refresh). TikTok also exposes total_time_watched, average_time_watched, and full_video_watched_rate in metric.extras.',
+        inputSchema: {
+            startDate: z
+                .string()
+                .describe('Start of date range (ISO 8601, e.g. 2026-01-01T00:00:00.000Z)'),
+            endDate: z
+                .string()
+                .describe('End of date range (ISO 8601, e.g. 2026-01-31T23:59:59.999Z)'),
+            platforms: z.array(z.enum(PLATFORMS)).optional().describe('Filter by platforms'),
+            socialMediaIds: z
+                .array(z.uuid())
+                .optional()
+                .describe('Filter by specific social media account ids'),
+        },
+        outputSchema: dataListOutputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        run: (port, args, workspaceId) => port.getPostAnalytics(args, workspaceId),
+    },
+];
+//# sourceMappingURL=posts.js.map