postproxy-mcp 1.0.1 → 1.1.0

package/src/types/index.ts

@@ -21,6 +21,20 @@ export interface Profile {
   avatar_url?: string;
 }
 
+export interface ThreadChild {
+  body: string;
+  media?: string[];
+}
+
+export interface MediaAttachment {
+  id: string;
+  status: "pending" | "processed" | "failed";
+  error_message: string | null;
+  content_type: string;
+  source_url: string | null;
+  url: string | null;
+}
+
 export interface CreatePostParams {
   content: string;
   profile_group_id?: number; // Not used by API, kept for compatibility
@@ -30,17 +44,20 @@ export interface CreatePostParams {
   idempotency_key?: string;
   draft?: boolean; // If true, creates a draft post that won't publish automatically
   platforms?: PlatformParams; // Platform-specific parameters
+  thread?: ThreadChild[]; // Thread posts (supported on X and Threads)
 }
 
 export interface CreatePostResponse {
   id: string;
   body?: string; // API returns "body" field
   content?: string; // Some responses use "content"
-  status: "draft" | "pending" | "processing" | "processed" | "scheduled";
+  status: "draft" | "pending" | "processing" | "processed" | "scheduled" | "media_processing_failed";
   draft: boolean;
   scheduled_at: string | null;
   created_at: string;
+  media?: MediaAttachment[];
   platforms: PlatformOutcome[];
+  thread?: Array<{ id: string; body: string; media?: MediaAttachment[] }>;
 }
 
 export interface PlatformOutcome {
@@ -62,24 +79,28 @@ export interface PostDetails {
   id: string;
   body?: string; // API returns "body" field
   content?: string; // Some responses use "content"
-  status: "draft" | "pending" | "processing" | "processed" | "scheduled";
+  status: "draft" | "pending" | "processing" | "processed" | "scheduled" | "media_processing_failed";
   draft: boolean;
   scheduled_at: string | null;
   created_at: string;
   updated_at?: string;
+  media?: MediaAttachment[];
   platforms: PlatformOutcome[];
+  thread?: Array<{ id: string; body: string; media?: MediaAttachment[] }>;
 }
 
 export interface Post {
   id: string;
   body?: string; // API returns "body" field
   content?: string; // Some responses use "content"
-  status: "draft" | "pending" | "processing" | "processed" | "scheduled";
+  status: "draft" | "pending" | "processing" | "processed" | "scheduled" | "media_processing_failed";
   draft: boolean;
   scheduled_at: string | null;
   created_at: string;
   updated_at?: string;
+  media?: MediaAttachment[];
   platforms: PlatformOutcome[];
+  thread?: Array<{ id: string; body: string; media?: MediaAttachment[] }>;
 }
 
 /**
@@ -102,21 +123,23 @@ export interface YouTubeParams {
   title?: string; // Video title
   privacy_status?: "public" | "unlisted" | "private"; // Video visibility
   cover_url?: string; // Custom thumbnail URL
+  made_for_kids?: boolean; // Whether the video is made for kids
 }
 
 /**
  * Platform-specific parameters for TikTok
  */
 export interface TikTokParams {
+  format?: "video" | "image"; // Content format (video is default)
   privacy_status?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
-  photo_cover_index?: number; // Index (0-based) of photo to use as cover
-  auto_add_music?: boolean; // Enable automatic music
-  made_with_ai?: boolean; // Mark content as AI-generated
-  disable_comment?: boolean; // Disable comments on the post
-  disable_duet?: boolean; // Disable duets
-  disable_stitch?: boolean; // Disable stitches
-  brand_content_toggle?: boolean; // Mark video as paid partnership promoting a third-party business
-  brand_organic_toggle?: boolean; // Mark video as paid partnership promoting your own brand
+  photo_cover_index?: number; // Index (0-based) of photo to use as cover (image format)
+  auto_add_music?: boolean; // Enable automatic music (image format)
+  made_with_ai?: boolean; // Mark content as AI-generated (video format)
+  disable_comment?: boolean; // Disable comments
+  disable_duet?: boolean; // Disable duets (video format)
+  disable_stitch?: boolean; // Disable stitches (video format)
+  brand_content_toggle?: boolean; // Mark as paid partnership promoting a third-party business
+  brand_organic_toggle?: boolean; // Mark as paid partnership promoting your own brand
 }
 
 /**

package/src/utils/validation.ts

@@ -89,10 +89,14 @@ export const YouTubeParamsSchema = z.object({
     errorMap: () => ({ message: "YouTube privacy_status must be 'public', 'unlisted', or 'private'" }),
   }).optional(),
   cover_url: URLSchema.optional(),
+  made_for_kids: z.boolean().optional(),
 }).strict();
 
 // TikTok parameters validation
 export const TikTokParamsSchema = z.object({
+  format: z.enum(["video", "image"], {
+    errorMap: () => ({ message: "TikTok format must be 'video' or 'image'" }),
+  }).optional(),
   privacy_status: z.enum([
     "PUBLIC_TO_EVERYONE",
     "MUTUAL_FOLLOW_FRIENDS",
@@ -142,6 +146,14 @@ export const PlatformParamsSchema = z.object({
   threads: ThreadsParamsSchema.optional(),
 }).strict().optional();
 
+/**
+ * Schema for thread child posts
+ */
+export const ThreadChildSchema = z.object({
+  body: z.string().min(1, "Thread child body cannot be empty"),
+  media: z.array(MediaItemSchema).optional(),
+});
+
 /**
  * Schema for post.publish parameters
  */
@@ -154,6 +166,7 @@ export const PostPublishSchema = z.object({
   require_confirmation: z.boolean().optional(),
   draft: z.boolean().optional(),
   platforms: PlatformParamsSchema,
+  thread: z.array(ThreadChildSchema).optional(),
 });
 
 /**

package/worker/index.ts

@@ -36,15 +36,26 @@ interface PlatformOutcome {
   insights?: any;
 }
 
+interface MediaAttachment {
+  id: string;
+  status: "pending" | "processed" | "failed";
+  error_message: string | null;
+  content_type: string;
+  source_url: string | null;
+  url: string | null;
+}
+
 interface Post {
   id: string;
   body?: string;
   content?: string;
-  status: "draft" | "pending" | "processing" | "processed" | "scheduled";
+  status: "draft" | "pending" | "processing" | "processed" | "scheduled" | "media_processing_failed";
   draft: boolean;
   scheduled_at: string | null;
   created_at: string;
+  media?: MediaAttachment[];
   platforms: PlatformOutcome[];
+  thread?: Array<{ id: string; body: string; media?: MediaAttachment[] }>;
 }
 
 export default class PostProxyMCP extends WorkerEntrypoint<Env> {
@@ -177,7 +188,8 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
     schedule?: string,
     draft?: boolean,
     platformParams?: Record<string, Record<string, any>>,
-    idempotencyKey?: string
+    idempotencyKey?: string,
+    threadChildren?: Array<{ body: string; media?: string[] }>
   ): Promise<any> {
     const baseUrl = this.env.POSTPROXY_BASE_URL.replace(/\/$/, "");
     const url = `${baseUrl}/posts`;
@@ -224,6 +236,11 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
       formData.append("platforms", JSON.stringify(platformParams));
     }
 
+    // Add thread children
+    if (threadChildren && threadChildren.length > 0) {
+      formData.append("thread", JSON.stringify(threadChildren));
+    }
+
     // Build headers
     const headers: Record<string, string> = {
       Authorization: `Bearer ${this.getApiKey()}`,
@@ -290,7 +307,10 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
    */
   private determineOverallStatus(
     post: Post
-  ): "pending" | "processing" | "complete" | "failed" | "draft" {
+  ): "pending" | "processing" | "complete" | "failed" | "draft" | "media_processing_failed" {
+    if (post.status === "media_processing_failed") {
+      return "media_processing_failed";
+    }
     if (post.status === "draft" || post.draft === true) {
       return "draft";
     }
@@ -382,6 +402,7 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
    * @param draft {boolean} If true, creates a draft post that won't publish automatically
    * @param platforms {string} Optional JSON string of platform-specific parameters
    * @param media_files {string} Optional JSON array of file objects with {filename, data (base64), content_type?}
+   * @param thread {string} Optional JSON array of thread child posts [{body, media?}]. Supported on X and Threads only.
    * @return {Promise<string>} Post creation result as JSON
    */
   async postPublish(
@@ -393,7 +414,8 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
     require_confirmation?: boolean,
     draft?: boolean,
     platforms?: string,
-    media_files?: string
+    media_files?: string,
+    thread?: string
   ): Promise<string> {
     this.getApiKey(); // Validate API key is present
 
@@ -432,6 +454,27 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
       }
     }
 
+    // Parse thread JSON if provided
+    let threadChildren: Array<{ body: string; media?: string[] }> | undefined;
+    if (thread) {
+      try {
+        threadChildren = JSON.parse(thread);
+        if (!Array.isArray(threadChildren)) {
+          throw new Error("thread must be an array");
+        }
+        for (const child of threadChildren) {
+          if (!child.body) {
+            throw new Error("Each thread child must have a 'body' property");
+          }
+        }
+      } catch (e: any) {
+        if (e.message.includes("thread")) {
+          throw e;
+        }
+        throw new Error("Invalid thread parameter: must be valid JSON array");
+      }
+    }
+
     // Validate input
     if (!content || content.trim() === "") {
       throw new Error("Content cannot be empty");
@@ -452,6 +495,7 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
             schedule_time: schedule,
             draft: draft || false,
             platforms: platformParams || {},
+            thread: threadChildren || [],
           },
         },
         null,
@@ -503,7 +547,8 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
         schedule,
         draft,
         platformParams,
-        finalIdempotencyKey
+        finalIdempotencyKey,
+        threadChildren
       );
     } else {
       // Create post with JSON (URLs only)
@@ -527,6 +572,10 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
         apiPayload.platforms = platformParams;
       }
 
+      if (threadChildren && threadChildren.length > 0) {
+        apiPayload.thread = threadChildren;
+      }
+
       const extraHeaders: Record<string, string> = {
         "Idempotency-Key": finalIdempotencyKey,
       };
@@ -579,17 +628,23 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
 
     const overallStatus = this.determineOverallStatus(postDetails);
 
-    return JSON.stringify(
-      {
-        job_id: job_id,
-        overall_status: overallStatus,
-        draft: postDetails.draft || false,
-        status: postDetails.status,
-        platforms,
-      },
-      null,
-      2
-    );
+    const result: any = {
+      job_id: job_id,
+      overall_status: overallStatus,
+      draft: postDetails.draft || false,
+      status: postDetails.status,
+      platforms,
+    };
+
+    if (postDetails.media && postDetails.media.length > 0) {
+      result.media = postDetails.media;
+    }
+
+    if (postDetails.thread && postDetails.thread.length > 0) {
+      result.thread = postDetails.thread;
+    }
+
+    return JSON.stringify(result, null, 2);
   }
 
   /**
@@ -748,7 +803,7 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
       },
       {
         name: "postPublish",
-        description: "Publish a post to specified targets",
+        description: "Publish a post to specified targets. Supports threads (X and Threads only).",
         inputSchema: {
           type: "object",
           properties: {
@@ -759,8 +814,9 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
             idempotency_key: { type: "string", description: "Optional idempotency key for deduplication" },
             require_confirmation: { type: "boolean", description: "If true, return summary without publishing" },
             draft: { type: "boolean", description: "If true, creates a draft post" },
-            platforms: { type: "string", description: "Optional JSON string of platform-specific parameters" },
+            platforms: { type: "string", description: "Optional JSON string of platform-specific parameters. YouTube supports: title, privacy_status, cover_url, made_for_kids. TikTok supports: format (video|image), privacy_status, and more." },
             media_files: { type: "string", description: "Optional JSON array of file objects for direct upload. Each object must have 'filename' and 'data' (base64-encoded file content), optionally 'content_type'. Example: [{\"filename\":\"photo.jpg\",\"data\":\"base64...\"}]" },
+            thread: { type: "string", description: "Optional JSON array of thread child posts. Supported on X and Threads only. Each object must have 'body' (string), optionally 'media' (array of URLs). Example: [{\"body\":\"Reply 1\"},{\"body\":\"Reply 2\",\"media\":[\"https://...\"]}]" },
           },
           required: ["content", "targets"],
         },
@@ -890,7 +946,8 @@ export default class PostProxyMCP extends WorkerEntrypoint<Env> {
                 args.require_confirmation,
                 args.draft,
                 args.platforms,
-                args.media_files
+                args.media_files,
+                args.thread
               );
               break;
             case "postStatus":