@omnisocials/mcp-server 1.34.1 → 1.39.0

package/build/types.d.ts

@@ -84,13 +84,23 @@ export interface InboxMessage {
 }
 /** What GET /inbox/next serves (and what `reply_to_inbox` returns as `next`
  * when `include_next` is set). `message` is the unanswered incoming item: its
- * `id` is what hide/delete take, its `conversation_id` is what reply takes.
+ * `id` is what hide/delete take and the `message_id` to pass to reply for a
+ * comment thread, its `conversation_id` is what reply takes as the path.
  * `messages` is the thread oldest first (the most recent 50, plus the target
  * and its parent when they fall outside that window). */
 export interface InboxNextUnanswered {
     conversation: InboxConversation;
     message: InboxMessage;
     messages: InboxMessage[];
+    /** Only Instagram and Facebook DMs have a reply window (Meta's 24 hours
+     * after the customer's last message): `closes_at` is that deadline and
+     * `open` is false once it has passed, in which case reply_to_inbox answers
+     * 422 outside_messaging_window. Every other item: open true, closes_at
+     * null. */
+    reply_window: {
+        open: boolean;
+        closes_at: string | null;
+    };
 }
 /** Response of DELETE /inbox/messages/:id. Replies under the comment are
  * removed with it; their inbox ids are listed in `removed_reply_ids`. */
@@ -138,6 +148,21 @@ export interface ApiInstagramOptionsOut extends ApiPlatformOptionsOut {
     thumb_offset?: number | string;
     cover_url?: string;
 }
+/** One video-cover choice: a frame offset or a custom image. */
+export interface ApiVideoCoverEntry {
+    type: "frame" | "custom";
+    /** Milliseconds into the video (type "frame"). */
+    thumb_offset?: number;
+    /** Public image URL (type "custom"). */
+    cover_url?: string;
+}
+/** Cross-platform video cover as stored on the post (`video_cover`). On
+ * input, a `null` override entry drops that platform's override; the API
+ * never echoes nulls back. */
+export interface ApiVideoCover extends ApiVideoCoverEntry {
+    /** Per-platform overrides keyed by platform id; an override wins for that platform. */
+    overrides?: Record<string, ApiVideoCoverEntry | null>;
+}
 export interface ApiStorySlide {
     /** Zero-based slide position. */
     index?: number;
@@ -179,6 +204,8 @@ export interface ApiPost {
     /** Stories only, after publishing: every slide per platform in publish
      * order. `published_urls` keeps only the first slide's URL. */
     story_slides?: Record<string, ApiStorySlide[]>;
+    /** Video thumbnail (base + per-platform overrides); null when none was chosen. */
+    video_cover?: ApiVideoCover | null;
     /** Set on a retry post: the original failed post's id. */
     retry_of?: string;
     /** Set on the original post: ids of its retry posts. */
@@ -257,6 +284,68 @@ export interface RejectPostResult {
     approval_status: "rejected";
     message?: string;
 }
+/** One approver of a step in GET /posts/:id/approval. */
+export interface PostApprovalApprover {
+    id: string;
+    name: string | null;
+    email: string | null;
+    status: "pending" | "approved" | "rejected";
+    decided_at: string | null;
+    /** The reason this approver gave with a rejection. */
+    comment: string | null;
+}
+export interface PostApprovalStep {
+    order: number;
+    name: string;
+    /** `all` = every approver of the step must approve. `any` = one approval is enough. */
+    require_mode: "all" | "any";
+    status: "pending" | "approved" | "rejected";
+    approvers: PostApprovalApprover[];
+}
+export interface PostApprovalComment {
+    id: string;
+    author: {
+        id: string;
+        name: string | null;
+    } | null;
+    message: string;
+    /** The channel the comment is about (`instagram`, `linkedin_page`, ...). Null = the whole post. */
+    account: string | null;
+    created_at: string;
+}
+/** `data` of GET /posts/:id/approval (backend/routes/api/v1/posts.js).
+ * `status: "none"` = the post has no approval workflow: `workflow`,
+ * `requested_by`, `requested_at`, `current_step` and `rejection` are null and
+ * `steps` and `comments` are empty. */
+export interface PostApproval {
+    post_id: string;
+    status: "none" | "pending" | "approved" | "rejected";
+    /** `id` is null for a one-off approval that was not made from a saved workflow. */
+    workflow: {
+        id: string | null;
+        name: string;
+    } | null;
+    requested_by: {
+        id: string;
+        name: string | null;
+    } | null;
+    requested_at: string | null;
+    /** Order of the step the post waits on. Null when the review is finished. */
+    current_step: number | null;
+    steps: PostApprovalStep[];
+    rejection: {
+        by: {
+            id: string;
+            name: string | null;
+        };
+        reason: string | null;
+        at: string | null;
+        step: number | null;
+    } | null;
+    /** The review thread, oldest first. Includes the entries OmniSocials
+     * writes when a reviewer edits the post. */
+    comments: PostApprovalComment[];
+}
 /** One place from GET /locations/search
  * (@openapi block in backend/routes/api/v1/locations.js). */
 export interface LocationPlace {
@@ -297,6 +386,57 @@ export interface LocationSearchResult {
     };
     needsPermission?: boolean;
 }
+/** One product Pin from GET /pinterest/products
+ * (@openapi block in backend/routes/api/v1/pinterest.js). */
+export interface PinterestProduct {
+    /** Use in `pinterest.product_tags`. */
+    pin_id: string;
+    title?: string | null;
+    description?: string | null;
+    link?: string | null;
+    image_url?: string | null;
+    /** Catalog source only. */
+    price?: number | null;
+    currency?: string | null;
+    availability?: string | null;
+    item_id?: string | null;
+}
+/** GET /pinterest/products envelope: NOT the standard data/error envelope.
+ * Success: `products` + `bookmark` + `source` + `catalog_access` (and, for
+ * the catalog source, `product_groups` + `product_group_id`). When the list
+ * could not be read, `error` is a { code, message } object with code one of
+ * pinterest_not_connected | pinterest_catalog_access_required |
+ * platform_error, and `products` is absent. */
+export interface PinterestProductsResult {
+    products?: PinterestProduct[];
+    bookmark?: string | null;
+    source?: "catalog" | "pins";
+    catalog_access?: boolean;
+    product_groups?: Array<{
+        id: string;
+        name?: string | null;
+    }>;
+    product_group_id?: string | null;
+    error?: string | {
+        code: string;
+        message: string;
+    };
+}
+/** GET /pinterest/products/validate result. `unverified` = the check could
+ * not run; the publish step is then the final check. */
+export interface PinterestProductCheck {
+    valid?: boolean;
+    pin_id?: string | null;
+    title?: string | null;
+    link?: string | null;
+    image_url?: string | null;
+    unverified?: boolean;
+    reason?: string;
+    error?: string | {
+        code: string;
+        message: string;
+    };
+}
 /** One track from GET /audio/search
  * (@openapi block in backend/routes/api/v1/audio.js). */
 export interface InstagramAudioTrack {
@@ -349,14 +489,29 @@ export interface MediaItem {
     size: string;
     status?: string;
     created_at: string;
+    pdf?: {
+        id: string;
+        name: string;
+        url: string;
+        page?: number;
+        total_pages: number;
+        rendered_pages: number;
+        truncated?: boolean;
+        pages?: Array<{
+            url: string;
+            width?: number | null;
+            height?: number | null;
+        }>;
+    };
 }
 /**
  * Extra top-level fields returned by /media/upload* when the uploaded file is a
- * PDF. A PDF is rasterized into one image slide per page (max 20): `data`
- * mirrors the first slide (back-compat), while `slides` + `media_ids` carry the
- * whole carousel in page order. Pass ALL of `media_ids` to create_post. On
- * LinkedIn the slides post as a native swipeable document; elsewhere as an
- * image carousel.
+ * PDF. A PDF is rasterized into one image slide per page (max 20) and the
+ * original file is kept: `data` mirrors the first slide (back-compat), while
+ * `slides` + `media_ids` carry the whole carousel in page order. Pass ALL of
+ * `media_ids` to create_post. On LinkedIn the slides post as a native
+ * swipeable document made from the original PDF (unless the post's
+ * linkedin.document_source is "slides"); elsewhere as an image carousel.
  */
 export interface PdfUploadResult {
     slides: MediaItem[];
@@ -365,6 +520,10 @@ export interface PdfUploadResult {
         total_pages: number;
         rendered_pages: number;
         truncated: boolean;
+        id?: string;
+        name?: string;
+        url?: string;
+        size_bytes?: number;
     };
 }
 export interface Account {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.34.1",
+  "version": "1.39.0",
   "mcpName": "io.github.omnisocials/mcp-server",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
@@ -53,7 +53,7 @@
   },
   "overrides": {
     "zod": "4.4.0",
-    "fast-uri": "^3.1.7",
+    "fast-uri": "^3.1.8",
     "hono": "^4.13.7",
     "qs": "^6.16.0"
   }