posterly-mcp-server 0.46.0 → 0.47.1

package/dist/tools/update-post.js

@@ -29,6 +29,31 @@ const instagramSettingsSchema = z.object({
     reel_thumb_offset: z.number().nonnegative().optional(),
     is_ai_generated: z.boolean().optional().describe('Label the parent Instagram media container as AI-generated. For carousels, set on the parent only.'),
     audio_id: z.string().optional().describe('Licensed Instagram audio ID for Reels. Meta-linked Facebook Login accounts only.'),
+    caption_addon: z.union([
+        z.object({
+            type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+            kind: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+            options: z.array(z.string()).max(4).optional(),
+            extended_duration: z.boolean().optional(),
+            poll_attachment: z.object({
+                option_a: z.string().optional(),
+                option_b: z.string().optional(),
+                option_c: z.string().optional(),
+                option_d: z.string().optional(),
+                options: z.array(z.string()).max(4).optional(),
+            }).optional(),
+        }),
+        z.null(),
+    ]).optional().describe('Optional Instagram caption add-on. type is none, poll, or comment_prompt. A poll needs 2 to 4 options of 1 to 25 characters (an emoji counts as one) and the caption is the question. A comment prompt uses the caption as the prompt. Facebook Login only. Not available on Stories. At most one add-on per post. Pass null or type none to clear it.'),
+    poll_attachment: z.object({
+        option_a: z.string().optional(),
+        option_b: z.string().optional(),
+        option_c: z.string().optional(),
+        option_d: z.string().optional(),
+        options: z.array(z.string()).max(4).optional(),
+    }).optional().describe('Instagram poll choices. option_a and option_b are required, option_c and option_d are optional, and option_d requires option_c. Mutually exclusive with a comment prompt. The caption is the question. Serialised JSON must be 200 characters or fewer.'),
+    is_comment_prompt_used: z.boolean().optional().describe('Set true to attach an Instagram comment prompt. The caption is the prompt. Mutually exclusive with a poll. Facebook Login only. Not available on Stories.'),
+    is_poll_duration_extended: z.boolean().optional().describe('Set true only together with a poll, to request the longer Instagram poll duration.'),
 });
 const platformSettingsSchema = z.object({
     __type: z.string().optional(),
@@ -104,11 +129,22 @@ const platformSettingsSchema = z.object({
     paid_partnership: z.boolean().optional(),
     is_ai_generated: z.boolean().optional(),
     audio_id: z.string().optional(),
+    caption_addon: z.union([
+        z.object({
+            type: z.enum(['none', 'poll', 'comment_prompt']).optional(),
+            options: z.array(z.string()).max(4).optional(),
+            extended_duration: z.boolean().optional(),
+        }),
+        z.null(),
+    ]).optional(),
+    poll_attachment: z.record(z.string(), z.unknown()).optional(),
+    is_comment_prompt_used: z.boolean().optional(),
+    is_poll_duration_extended: z.boolean().optional(),
     ai_generated: z.boolean().optional(),
 }).passthrough();
 export const updatePostTool = {
     name: 'update_post',
-    description: 'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own.\n\n' +
+    description: 'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own. approval_action (request, approve, request_changes, or reject): change client approval. Only a workspace owner or admin may do this. The actor is the API key user, never a brand guest. request emails the brand reviewers. approve, request_changes, and reject are team-side decisions. request_changes needs approval_note. Optional approval_axis is asset or caption; omit it for both. Send approval_action on its own.\n\n' +
         'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media, status) and the PROPOSED change, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each change needs its own confirmation.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to update'),
@@ -146,6 +182,18 @@ export const updatePostTool = {
             .optional()
             .describe('Set an external release ID instead of editing the post. Send with post_id and optional group_id only.'),
         group_id: z.string().min(1).max(160).optional().describe('With release_id only: an external group/campaign ID.'),
+        approval_action: z
+            .enum(['request', 'approve', 'request_changes', 'reject'])
+            .optional()
+            .describe('Change client approval instead of editing the post. Owner or admin only. The actor is the API key user, never a brand guest. Send on its own.'),
+        approval_axis: z
+            .enum(['asset', 'caption'])
+            .optional()
+            .describe('With approval_action approve, request_changes, or reject: which axis to decide. Omit for both. Not allowed with request.'),
+        approval_note: z
+            .string()
+            .optional()
+            .describe('Note stored with the approval change. Required for request_changes.'),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of the proposed change.'),
     }),
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
@@ -169,6 +217,9 @@ export const updatePostTool = {
             return updateStatus(client, args);
         if (mode === 'release_id')
             return updateReleaseId(client, args);
+        if (mode === 'approval') {
+            return updateApproval(client, args);
+        }
         return editPost(client, args);
     },
 };
@@ -209,6 +260,17 @@ async function updateStatus(client, input) {
     const transition = result.transition || {};
     return `Post #${input.post_id} status changed from ${transition.old_status || 'unknown'} to ${transition.new_status || input.status}.`;
 }
+async function updateApproval(client, input) {
+    if (input.confirm !== true) {
+        throw new Error('Refusing to change client approval without confirm=true after explicit user confirmation. Only a workspace owner or admin can do this, and the actor is the API key user, never a brand guest.');
+    }
+    const result = await client.setPostApproval(input.post_id, {
+        action: input.approval_action,
+        axis: input.approval_axis,
+        note: input.approval_note,
+    });
+    return JSON.stringify(result, null, 2);
+}
 async function updateReleaseId(client, input) {
     const result = await client.updatePostReleaseId(input.post_id, {
         release_id: input.release_id,