@omnisocials/mcp-server 1.39.0 → 1.48.0

package/build/types.d.ts

@@ -11,6 +11,12 @@ export interface ApiResponse<T = unknown> {
         credits_balance?: number | null;
         enforced?: boolean;
         enforce_from?: string;
+        platform?: string;
+        media_url?: string;
+        ratio?: string;
+        target?: string;
+        action?: "cropped" | "kept" | "crop_failed";
+        crop_url?: string;
     }>;
     pagination?: {
         next_cursor: string | null;
@@ -115,6 +121,17 @@ export type ApiPostMediaEntry = string | {
     id?: string | number;
     url?: string;
     alt?: string;
+    /** Image fit of this channel's copy: 'crop' = url is a crop of crop.of. */
+    fit?: "crop" | "keep";
+    crop?: {
+        of: string;
+        id?: string;
+        ratio: string;
+        focus: {
+            x: number;
+            y: number;
+        } | null;
+    };
     [k: string]: unknown;
 };
 /** A thread part as echoed back by the API (X / Bluesky / Mastodon / Threads). */
@@ -180,6 +197,10 @@ export interface ApiPost {
     status: string;
     /** "post" | "story" | "reel" */
     type?: string;
+    /** The comment-to-DM automations bound to this post (get_post on a post
+     * that goes to Instagram or Facebook, create/update when the request
+     * carried it); null = none. */
+    comment_dm_automation?: PostCommentDmAutomation | null;
     /** Per-platform captions keyed by platform id plus "default". Legacy
      * servers returned a plain string. */
     content?: Record<string, string> | string;
@@ -247,6 +268,12 @@ export interface ApiPost {
     bluesky?: ApiPlatformOptionsOut;
     mastodon?: ApiPlatformOptionsOut;
     threads?: ApiPlatformOptionsOut;
+    /** Telegram options (silent, pin, buttons, poll ...) and, once sent,
+     * `result` with the message ids and the links. */
+    telegram?: ApiPlatformOptionsOut;
+    /** Discord options (silent, thread_name, buttons, poll ...) and, once
+     * sent, `result` with the message id and the link. */
+    discord?: ApiPlatformOptionsOut;
     /** platform → user-friendly error message; only failed platforms appear.
      * null while draft/scheduled/processing or when every platform succeeded. */
     errors?: Record<string, string> | null;
@@ -412,6 +439,8 @@ export interface PinterestProductsResult {
     bookmark?: string | null;
     source?: "catalog" | "pins";
     catalog_access?: boolean;
+    /** The connection has catalog access but the account has no catalog yet. */
+    no_catalog?: boolean;
     product_groups?: Array<{
         id: string;
         name?: string | null;
@@ -487,6 +516,8 @@ export interface MediaItem {
     filename: string;
     folder_id?: string | null;
     size: string;
+    width?: number | null;
+    height?: number | null;
     status?: string;
     created_at: string;
     pdf?: {
@@ -549,6 +580,29 @@ export interface Account {
     }[];
     platform_details?: {
         subscription_type?: string;
+        /** Telegram: "channel", "supergroup" or "group". */
+        chat_type?: string | null;
+        /** Telegram chat id (a negative number as a string). */
+        chat_id?: string | null;
+        /** Telegram: subscribers of a channel, members of a group. */
+        subscribers?: number | null;
+        /** Telegram: t.me link of a public chat, else the chat's private link.
+         * Discord: discord.com/channels link to the channel. */
+        url?: string | null;
+        /** Discord: the server id. */
+        guild_id?: string | null;
+        /** Discord: the server name (Continue with Discord, or a pasted URL in a server the OmniSocials bot is in). */
+        guild_name?: string | null;
+        /** Discord: the channel id. */
+        channel_id?: string | null;
+        /** Discord: the channel name without the # (read by the OmniSocials bot, or given by the person); null when unknown. */
+        channel_name?: string | null;
+        /** Discord: text, voice, announcement, stage, forum or media, as the bot read it; null when it cannot see the channel. */
+        channel_type?: "text" | "voice" | "announcement" | "stage" | "forum" | "media" | null;
+        /** Discord: the webhook's name, shown as the sender of every post. */
+        webhook_name?: string | null;
+        /** Discord: "oauth" (Continue with Discord) or "url" (a pasted webhook URL). */
+        connect_method?: string | null;
     };
 }
 export interface Webhook {
@@ -577,6 +631,186 @@ export interface HashtagSet {
     created_at: string;
     updated_at: string;
 }
+/** The channel an automation runs on: the Instagram account, the Facebook Page or the X account. */
+export type AutomationPlatform = "instagram" | "facebook" | "x";
+/** The channels a post-bound automation (`comment_dm_automation`) can run on: X has no comment trigger. */
+export type CommentDmPlatform = "instagram" | "facebook";
+/** `story_reply` is Instagram only: Facebook has no story replies. X has `dm` only. */
+export type AutomationTriggerKind = "comment" | "dm" | "story_reply";
+/**
+ * `queued` = the answer waits for a free slot under the send cap (X 15 per 15
+ * minutes and 450 a day, Instagram and Facebook 180 an hour), or for X's
+ * reset time after X answered 429, and goes out within the hour, else it
+ * becomes `skipped` with `rate_limited`. `opted_out` = the person replied
+ * STOP on X (the stop list of that X account).
+ */
+export type AutomationEventOutcome = "sent" | "skipped" | "failed" | "pending" | "queued" | "opted_out";
+export type AutomationScope = "post" | "next_post" | "any";
+export type AutomationMatch = "word" | "contains" | "any";
+export interface AutomationPost {
+    /** `omnisocials` = a post of this workspace, `instagram` / `facebook` = read from that platform */
+    source: "omnisocials" | "instagram" | "facebook";
+    id: string;
+    caption: string;
+    thumbnail_url: string | null;
+    permalink: string | null;
+    media_type: string | null;
+    status?: string;
+    post_date_time?: string | null;
+    /** omnisocials source only: the post is live on the automation's platform */
+    live?: boolean;
+    timestamp?: string | null;
+}
+export interface Automation {
+    id: string;
+    type: "comment_to_dm";
+    platform: AutomationPlatform;
+    status: "active" | "paused" | "completed";
+    name: string | null;
+    /** The OmniSocials post the automation listens on (scope post), else null */
+    post_id: string | null;
+    /** The Instagram media id, set once the post is live (null on Facebook) */
+    instagram_media_id: string | null;
+    /** The Facebook Page post id ({page-id}_{post-id}), set once the post is live (null on Instagram) */
+    facebook_post_id: string | null;
+    post: AutomationPost | null;
+    trigger: {
+        kinds: AutomationTriggerKind[];
+        scope: AutomationScope | null;
+        keywords: string[];
+        match: AutomationMatch;
+    };
+    actions: {
+        dm: {
+            text: string;
+        };
+        public_reply: {
+            enabled: boolean;
+            variations: string[];
+        };
+    };
+    limits: {
+        max_sends: number | null;
+        stop_at: string | null;
+    };
+    stats: {
+        matched: number;
+        sent: number;
+        skipped: number;
+        failed: number;
+        last_event_at: string | null;
+    };
+    created_at: string;
+    updated_at: string;
+}
+/** The body of POST /automations; every section is optional on PATCH. */
+export interface AutomationInput {
+    name?: string | null;
+    /**
+     * Default instagram; cannot change on PATCH (400 platform_immutable). `x`
+     * takes trigger.kinds ["dm"] only, needs X DMs on for an active automation
+     * (409 x_dms_off; `status: "paused"` always saves) and has no post fields.
+     */
+    platform?: AutomationPlatform;
+    post_id?: string;
+    instagram_media_id?: string;
+    /** A Page post published outside OmniSocials; implies platform facebook */
+    facebook_post_id?: string;
+    trigger?: {
+        kinds?: AutomationTriggerKind[];
+        scope?: AutomationScope;
+        keywords?: string[];
+        match?: AutomationMatch;
+    };
+    actions?: {
+        dm: {
+            text: string;
+        };
+        public_reply?: {
+            enabled?: boolean;
+            variations?: string[];
+        };
+    };
+    limits?: {
+        max_sends?: number | null;
+        stop_at?: string | null;
+    };
+    status?: "active" | "paused";
+}
+/** `comment_dm_automation` on a post: the automations bound to that post. */
+export interface CommentDmAutomationInput {
+    /** One automation per listed channel; default Instagram when the post goes there, else Facebook */
+    platforms?: CommentDmPlatform[];
+    trigger?: {
+        keywords?: string[];
+        match?: AutomationMatch;
+    };
+    actions: {
+        dm: {
+            text: string;
+        };
+        public_reply?: {
+            enabled?: boolean;
+            variations?: string[];
+        };
+    };
+    limits?: {
+        max_sends?: number | null;
+        stop_at?: string | null;
+    };
+}
+/** `comment_dm_automation` on a post: the first automation's fields (Instagram
+ * first), plus the channels and the id of each automation. */
+export interface PostCommentDmAutomation extends Automation {
+    platforms?: CommentDmPlatform[];
+    automations?: Array<{
+        id: string;
+        platform: CommentDmPlatform;
+        status: Automation["status"];
+    }>;
+}
+export interface AutomationEvent {
+    id: string;
+    automation_id: string;
+    kind: AutomationTriggerKind;
+    outcome: AutomationEventOutcome;
+    /**
+     * `skipped`: already_sent, limit_reached, stopped, window_passed,
+     * rate_limited (the send cap stayed full for an hour), cannot_message,
+     * already_replied, dm_window_passed, dms_closed (X: the person does not
+     * accept DMs from the account), no_credits (credits ran out before the
+     * answer), opted_out (the person replied STOP before, also while the
+     * answer waited), automation_off (paused or finished while the answer
+     * waited). `failed`: the platform's error text. A `queued` row carries
+     * the reason it waits, an `opted_out` row the reason `opted_out`.
+     */
+    reason: string | null;
+    reason_label: string | null;
+    /** `username` = the Instagram or X @handle, or the person's name on Facebook */
+    person: {
+        id: string;
+        username: string | null;
+    };
+    trigger_id: string | null;
+    /** The comment; a DM's text only with the inbox:read scope */
+    trigger_text: string | null;
+    /** The DM that was sent */
+    message: string | null;
+    public_reply: string | null;
+    platform_message_id: string | null;
+    created_at: string;
+    sent_at: string | null;
+}
+export interface AutomationEventsResult {
+    data: AutomationEvent[];
+    counts: Record<string, number>;
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        has_more: boolean;
+    };
+}
 /** Per-platform stats block inside AnalyticsOverview.platform_breakdown.
  * Shape from backend/routes/api/v1/analytics.js (overview route). */
 export interface AnalyticsPlatformBreakdown {
@@ -618,6 +852,16 @@ export interface MediaCompatibility {
 /** POST /media/check response — the compatibility block is spread top-level
  * next to `file` and `connected_platforms`; there is no `data` key
  * (backend/routes/api/v1/media.js check route). */
+export interface MediaFitRow {
+    platform: string;
+    display_name: string;
+    fits: boolean;
+    ratio: string;
+    shown: "whole" | "cut";
+    target: string | null;
+    default_action: "crop" | "keep" | null;
+    message: string | null;
+}
 export interface MediaCheckResult {
     error?: {
         code: string;
@@ -627,11 +871,15 @@ export interface MediaCheckResult {
         size_bytes: number | null;
         mime: string | null;
         size_known: boolean;
+        width?: number | null;
+        height?: number | null;
     };
     connected_platforms?: string[];
     compatible?: boolean;
     warnings?: MediaCompatWarning[];
     summary?: string | null;
+    /** How each connected channel with a fit rule shows this image as a feed post. */
+    fit?: MediaFitRow[];
 }
 /** One folder from GET /folders — formatFolder in
  * backend/routes/api/v1/folders.js (:15-23). */
@@ -709,6 +957,11 @@ export interface PostAnalyticsStorySlide {
 export interface PostAnalyticsPlatformEntry {
     platform: string;
     platform_post_id: string;
+    /** Numbers and strings, plus objects this type leaves out: breakdowns
+     * (`reactions`, `impression_sources`, ...) and, on TikTok and Facebook
+     * videos, `retention_curve` (RetentionCurve in client.ts). `hold_rate_3s`
+     * is the % of viewers still watching at second 3 (TikTok, Facebook Reels,
+     * Instagram Reels as 100 - skip_rate). */
     metrics: Record<string, number | string>;
     thread_parts: number;
     collected_at: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnisocials/mcp-server",
-  "version": "1.39.0",
+  "version": "1.48.0",
   "mcpName": "io.github.omnisocials/mcp-server",
   "description": "MCP server for OmniSocials API - manage social media posts, media, accounts, analytics, and webhooks",
   "type": "module",
@@ -45,14 +45,14 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "@modelcontextprotocol/sdk": "^1.32.1"
   },
   "devDependencies": {
     "@types/node": "^25.3.3",
     "typescript": "^5.8.2"
   },
   "overrides": {
-    "zod": "4.4.0",
+    "zod": "4.6.7",
     "fast-uri": "^3.1.8",
     "hono": "^4.13.7",
     "qs": "^6.16.0"