posterly-mcp-server 0.48.5 → 0.49.1

package/dist/tools/create-post.d.ts

@@ -1293,9 +1293,9 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     workspace_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-    username?: string | undefined;
-    workspace_id?: string | undefined;
     account_id?: string | undefined;
+    workspace_id?: string | undefined;
+    username?: string | undefined;
     caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -1494,9 +1494,9 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-    username?: string | undefined;
-    workspace_id?: string | undefined;
     account_id?: string | undefined;
+    workspace_id?: string | undefined;
+    username?: string | undefined;
     caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -2350,9 +2350,9 @@ export declare const createPostInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     confirm: true;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-    username?: string | undefined;
-    workspace_id?: string | undefined;
     account_id?: string | undefined;
+    workspace_id?: string | undefined;
+    username?: string | undefined;
     caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -2552,9 +2552,9 @@ export declare const createPostInputSchema: z.ZodObject<{
 }, {
     confirm: true;
     platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-    username?: string | undefined;
-    workspace_id?: string | undefined;
     account_id?: string | undefined;
+    workspace_id?: string | undefined;
+    username?: string | undefined;
     caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
@@ -3437,9 +3437,9 @@ export declare const createPostTool: {
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-        username?: string | undefined;
-        workspace_id?: string | undefined;
         account_id?: string | undefined;
+        workspace_id?: string | undefined;
+        username?: string | undefined;
         caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
@@ -3639,9 +3639,9 @@ export declare const createPostTool: {
     }, {
         confirm: true;
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-        username?: string | undefined;
-        workspace_id?: string | undefined;
         account_id?: string | undefined;
+        workspace_id?: string | undefined;
+        username?: string | undefined;
         caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;

package/dist/tools/create-posts-batch.d.ts

@@ -658,9 +658,9 @@ export declare const createPostsBatchTool: {
             workspace_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            username?: string | undefined;
-            workspace_id?: string | undefined;
             account_id?: string | undefined;
+            workspace_id?: string | undefined;
+            username?: string | undefined;
             caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -859,9 +859,9 @@ export declare const createPostsBatchTool: {
             }, z.ZodTypeAny, "passthrough"> | undefined;
         }, {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            username?: string | undefined;
-            workspace_id?: string | undefined;
             account_id?: string | undefined;
+            workspace_id?: string | undefined;
+            username?: string | undefined;
             caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -1064,9 +1064,9 @@ export declare const createPostsBatchTool: {
         confirm: true;
         posts: {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            username?: string | undefined;
-            workspace_id?: string | undefined;
             account_id?: string | undefined;
+            workspace_id?: string | undefined;
+            username?: string | undefined;
             caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
@@ -1268,9 +1268,9 @@ export declare const createPostsBatchTool: {
         confirm: true;
         posts: {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            username?: string | undefined;
-            workspace_id?: string | undefined;
             account_id?: string | undefined;
+            workspace_id?: string | undefined;
+            username?: string | undefined;
             caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;

package/dist/tools/create-webhook.d.ts

@@ -13,15 +13,15 @@ export declare const createWebhookTool: {
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         url: string;
-        description?: string | undefined;
         workspace_id?: string | undefined;
+        description?: string | undefined;
         is_active?: boolean | undefined;
         events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
     }, {
         confirm: true;
         url: string;
-        description?: string | undefined;
         workspace_id?: string | undefined;
+        description?: string | undefined;
         is_active?: boolean | undefined;
         events?: ("webhook.test" | "post.created" | "post.updated" | "post.deleted" | "post.publishing" | "post.published" | "post.failed" | "account.disconnected" | "analytics.synced" | "approval.requested" | "approval.approved" | "approval.changes_requested" | "approval.rejected" | "approval.commented")[] | undefined;
     }>;

package/dist/tools/disconnect-account.d.ts

@@ -7,11 +7,11 @@ export declare const disconnectAccountTool: {
         account_id: z.ZodString;
         confirm: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        confirm: boolean;
         account_id: string;
-    }, {
         confirm: boolean;
+    }, {
         account_id: string;
+        confirm: boolean;
     }>;
     execute(client: PosterlyClient, input: {
         account_id: string;

package/dist/tools/find-slot.d.ts

@@ -11,14 +11,14 @@ export declare const findSlotTool: {
         strategy: z.ZodOptional<z.ZodEnum<["next_free", "best_engagement"]>>;
     }, "strip", z.ZodTypeAny, {
         workspace_id?: string | undefined;
-        account_ids?: string[] | undefined;
         timezone?: string | undefined;
+        account_ids?: string[] | undefined;
         count?: number | undefined;
         strategy?: "next_free" | "best_engagement" | undefined;
     }, {
         workspace_id?: string | undefined;
-        account_ids?: string[] | undefined;
         timezone?: string | undefined;
+        account_ids?: string[] | undefined;
         count?: number | undefined;
         strategy?: "next_free" | "best_engagement" | undefined;
     }>;

package/dist/tools/get-updates.d.ts

@@ -5,19 +5,23 @@ export declare const getUpdatesTool: {
     description: string;
     inputSchema: z.ZodObject<{
         limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
         since: z.ZodOptional<z.ZodString>;
         include_content: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         limit?: number | undefined;
+        offset?: number | undefined;
         since?: string | undefined;
         include_content?: boolean | undefined;
     }, {
         limit?: number | undefined;
+        offset?: number | undefined;
         since?: string | undefined;
         include_content?: boolean | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         limit?: number;
+        offset?: number;
         since?: string;
         include_content?: boolean;
     }): Promise<string>;

package/dist/tools/get-updates.js

@@ -1,9 +1,11 @@
 import { z } from 'zod';
+import { formatPagingNote } from '../lib/format.js';
 export const getUpdatesTool = {
     name: 'get_updates',
-    description: 'Get the latest posterly product updates and news from the updates feed: new features, improvements, and fixes. Requires an active posterly subscription.',
+    description: 'Get the latest posterly product updates and news from the updates feed: new features, improvements, and fixes, newest first. The output says whether more updates exist; page with offset or narrow with since. Requires an active posterly subscription.',
     inputSchema: z.object({
         limit: z.number().int().min(1).max(50).optional().describe('Number of updates to return. Default 10, max 50.'),
+        offset: z.number().int().min(0).optional().describe('How many updates to skip. Use the offset the previous page gives to get the next page.'),
         since: z.string().optional().describe('ISO date. Return updates published on or after this date.'),
         include_content: z.boolean().optional().describe('Include the full markdown body of each update. Defaults to false.'),
     }),
@@ -24,6 +26,16 @@ export const getUpdatesTool = {
                 lines.push('', update.content.trim(), '');
             }
         }
+        lines.push('', formatPagingNote({
+            noun: 'updates',
+            tool: 'get_updates',
+            offset: result.offset ?? input.offset ?? 0,
+            count: result.updates.length,
+            total: result.total,
+            // An API older than has_more: a full page may mean more exist.
+            hasMore: result.has_more ?? result.updates.length >= (input.limit || 10),
+            nextOffset: result.next_offset,
+        }));
         return lines.join('\n');
     },
 };

package/dist/tools/list-accounts.d.ts

@@ -18,14 +18,14 @@ export declare const listAccountsTool: {
         session_id: z.ZodOptional<z.ZodString>;
         debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        workspace_id?: string | undefined;
         account_id?: string | number | undefined;
+        workspace_id?: string | undefined;
         view?: "accounts" | "learned_voice" | "performance_profile" | "connect_session" | undefined;
         session_id?: string | undefined;
         debug?: boolean | undefined;
     }, {
-        workspace_id?: string | undefined;
         account_id?: string | number | undefined;
+        workspace_id?: string | undefined;
         view?: "accounts" | "learned_voice" | "performance_profile" | "connect_session" | undefined;
         session_id?: string | undefined;
         debug?: boolean | undefined;

package/dist/tools/list-activity.d.ts

@@ -9,16 +9,19 @@ export declare const listActivityTool: {
         since: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodEnum<["all", "activity", "publish"]>>;
         limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         workspace_id?: string | undefined;
         post_id?: number | undefined;
         limit?: number | undefined;
+        offset?: number | undefined;
         since?: string | undefined;
         type?: "activity" | "publish" | "all" | undefined;
     }, {
         workspace_id?: string | undefined;
         post_id?: number | undefined;
         limit?: number | undefined;
+        offset?: number | undefined;
         since?: string | undefined;
         type?: "activity" | "publish" | "all" | undefined;
     }>;
@@ -28,5 +31,6 @@ export declare const listActivityTool: {
         since?: string;
         type?: "all" | "activity" | "publish";
         limit?: number;
+        offset?: number;
     }): Promise<string>;
 };

package/dist/tools/list-activity.js

@@ -1,21 +1,25 @@
 import { z } from 'zod';
+import { formatPagingNote } from '../lib/format.js';
 export const listActivityTool = {
     name: 'list_activity',
-    description: 'List recent activity and publish events for posts, including status changes, publish attempts, failures, and retries. Use this as the agent notifications feed.',
+    description: 'List recent activity and publish events for posts, including status changes, publish attempts, failures, and retries, newest first. Use this as the agent notifications feed. The output says whether more events exist; page with offset (offset + limit up to 1000) or narrow with since or post_id before concluding nothing else happened.',
     inputSchema: z.object({
         workspace_id: z.string().optional().describe('Filter to a workspace ID from whoami.'),
         post_id: z.number().int().positive().optional().describe('Filter to one post ID.'),
         since: z.string().optional().describe('ISO datetime. Return events created at or after this time.'),
         type: z.enum(['all', 'activity', 'publish']).optional().describe('Event source filter. Defaults to all.'),
         limit: z.number().int().min(1).max(100).optional().describe('Number of items to return. Default 50, max 100.'),
+        offset: z.number().int().min(0).optional().describe('How many events to skip. Use the offset the previous page gives to get the next page.'),
     }),
     async execute(client, input) {
         const result = await client.listActivity(input);
         if (result.items.length === 0) {
-            return 'No activity found matching your filters.';
+            return (input.offset ?? 0) > 0
+                ? `No activity on this page: offset ${input.offset} is past the last matching event.`
+                : 'No activity found matching your filters.';
         }
         const lines = [
-            `Activity (${result.items.length} of ${result.total}):`,
+            `Activity (${result.items.length} on this page):`,
         ];
         for (const item of result.items) {
             const when = item.created_at ? new Date(item.created_at).toLocaleString() : 'unknown time';
@@ -30,6 +34,15 @@ export const listActivityTool = {
                 lines.push(`- [${when}] post #${item.post_id || '?'} ${label}`);
             }
         }
+        lines.push('', formatPagingNote({
+            noun: 'events',
+            tool: 'list_activity',
+            offset: result.offset ?? input.offset ?? 0,
+            count: result.items.length,
+            // An API older than has_more: a full page may mean more exist.
+            hasMore: result.has_more ?? result.items.length >= (result.limit || 50),
+            nextOffset: result.next_offset,
+        }));
         return lines.join('\n');
     },
 };

package/dist/tools/list-analytics.d.ts

@@ -29,7 +29,7 @@ export declare const listAnalyticsTool: {
         checkpoint: z.ZodOptional<z.ZodEnum<["1h", "6h", "24h", "72h", "7d"]>>;
         presentation: z.ZodOptional<z.ZodEnum<["compact", "table", "json"]>>;
     }, "strip", z.ZodTypeAny, {
-        view: "accounts" | "posts" | "insights";
+        view: "posts" | "accounts" | "insights";
         account_id?: string | number | undefined;
         post_id?: number | undefined;
         checkpoint?: "1h" | "6h" | "24h" | "72h" | "7d" | undefined;
@@ -39,7 +39,7 @@ export declare const listAnalyticsTool: {
         to?: string | undefined;
         presentation?: "compact" | "table" | "json" | undefined;
     }, {
-        view: "accounts" | "posts" | "insights";
+        view: "posts" | "accounts" | "insights";
         account_id?: string | number | undefined;
         post_id?: number | undefined;
         checkpoint?: "1h" | "6h" | "24h" | "72h" | "7d" | undefined;

package/dist/tools/list-analytics.js

@@ -4,7 +4,7 @@ import { validateArgs } from '../lib/tool-runtime.js';
 const presentationSchema = z.enum(['compact', 'table', 'json']).optional();
 export const listAnalyticsTool = {
     name: 'list_analytics',
-    description: 'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
+    description: 'Analytics for connected social accounts (Instagram, X, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
     inputSchema: z.object({
         view: z.enum(['accounts', 'posts', 'insights']).describe('accounts, posts, or insights.'),
         account_id: z

package/dist/tools/list-comments.d.ts

@@ -25,8 +25,8 @@ export declare const listCommentsTool: {
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         filter?: "all" | "unread" | "flagged" | undefined;
@@ -34,8 +34,8 @@ export declare const listCommentsTool: {
         comment_id?: string | undefined;
     }, {
         platform?: "instagram" | "facebook" | "threads" | "linkedin" | undefined;
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         filter?: "all" | "unread" | "flagged" | undefined;

package/dist/tools/list-conversations.d.ts

@@ -25,8 +25,8 @@ export declare const listConversationsTool: {
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         platform?: "instagram" | "facebook" | "threads" | undefined;
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         filter?: "all" | "unread" | "starred" | "archived" | undefined;
@@ -34,8 +34,8 @@ export declare const listConversationsTool: {
         conversation_id?: string | undefined;
     }, {
         platform?: "instagram" | "facebook" | "threads" | undefined;
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         filter?: "all" | "unread" | "starred" | "archived" | undefined;

package/dist/tools/list-google-business-media.d.ts

@@ -8,12 +8,12 @@ export declare const listGoogleBusinessMediaTool: {
         account_id: z.ZodOptional<z.ZodNumber>;
         location_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         location_id?: string | undefined;
     }, {
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         location_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {

package/dist/tools/list-google-business-reviews.d.ts

@@ -24,8 +24,8 @@ export declare const listGoogleBusinessReviewsTool: {
         limit: z.ZodOptional<z.ZodNumber>;
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         location_id?: string | undefined;
@@ -33,8 +33,8 @@ export declare const listGoogleBusinessReviewsTool: {
         unanswered?: boolean | undefined;
         view?: "reviews" | "review_link" | undefined;
     }, {
-        workspace_id?: string | undefined;
         account_id?: number | undefined;
+        workspace_id?: string | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         location_id?: string | undefined;
@@ -49,12 +49,12 @@ export declare const listGoogleBusinessReviewsTool: {
             account_id: z.ZodOptional<z.ZodNumber>;
             location_id: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }, {
-            workspace_id?: string | undefined;
             account_id?: number | undefined;
+            workspace_id?: string | undefined;
             location_id?: string | undefined;
         }>;
     };

package/dist/tools/list-media.d.ts

@@ -5,16 +5,20 @@ export declare const listMediaTool: {
     description: string;
     inputSchema: z.ZodObject<{
         limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
         drop_session_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         limit?: number | undefined;
+        offset?: number | undefined;
         drop_session_id?: string | undefined;
     }, {
         limit?: number | undefined;
+        offset?: number | undefined;
         drop_session_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         limit?: number;
+        offset?: number;
         drop_session_id?: string;
     }): Promise<string>;
 };

package/dist/tools/list-media.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
+import { formatPagingNote } from '../lib/format.js';
 export const listMediaTool = {
     name: 'list_media',
-    description: 'List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files the human uploaded on /drop/<token>. Use public_url with validate_post / create_post.',
+    description: 'List the newest media assets for the authenticated user. After create_media_drop, pass drop_session_id to see files the human uploaded on /drop/<token>. Use public_url with validate_post / create_post. The output says whether every matching file is shown; page with offset (offset + limit up to 1000) when it is not.',
     inputSchema: z.object({
         limit: z
             .number()
@@ -10,6 +11,12 @@ export const listMediaTool = {
             .max(50)
             .optional()
             .describe('Number of assets to return (default 10, max 50)'),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('How many assets to skip. Use the offset the previous page gives to get the next page.'),
         drop_session_id: z
             .string()
             .optional()
@@ -18,9 +25,13 @@ export const listMediaTool = {
     async execute(client, input) {
         const result = await client.listMedia({
             limit: input.limit,
+            offset: input.offset,
             dropSessionId: input.drop_session_id,
         });
         if (result.media.length === 0) {
+            if ((input.offset ?? 0) > 0 && result.total > 0) {
+                return `No media on this page: offset ${input.offset} is past the last of the ${result.total} matching files.`;
+            }
             return 'No media found. If you just sent a drop URL, wait for the user to finish uploading, then call list_media again.';
         }
         const lines = result.media.map((item) => {
@@ -28,10 +39,20 @@ export const listMediaTool = {
             const drop = item.drop_session_id ? ` drop=${item.drop_session_id}` : '';
             return `• ${item.filename} (${item.mime || 'unknown'}, ${size})${drop}\n  public_url: ${item.public_url}`;
         });
+        const offset = result.offset ?? input.offset ?? 0;
         return [
             `Media (${result.media.length} of ${result.total}):`,
             ...lines,
             '',
+            formatPagingNote({
+                noun: 'files',
+                tool: 'list_media',
+                offset,
+                count: result.media.length,
+                total: result.total,
+                hasMore: result.has_more ?? offset + result.media.length < result.total,
+                nextOffset: result.next_offset,
+            }),
             'Pass public_url to validate_post / create_post. Do not invent URLs.',
         ].join('\n');
     },

package/dist/tools/list-platforms.d.ts

@@ -23,17 +23,17 @@ export declare const listPlatformsTool: {
         debug: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        account_id?: string | undefined;
         workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
-        account_id?: string | undefined;
         view?: "platforms" | "schema" | "connect_link" | undefined;
         debug?: boolean | undefined;
         target?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
     }, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
+        account_id?: string | undefined;
         workspace_id?: string | undefined;
         include_planned?: boolean | undefined;
-        account_id?: string | undefined;
         view?: "platforms" | "schema" | "connect_link" | undefined;
         debug?: boolean | undefined;
         target?: "meta" | "instagram_direct" | "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | "linkedin_page" | "facebook_instagram" | "facebook_pages" | "linkedin-company" | "linkedin-page" | "linkedin_company" | "linkedin_personal" | "meta_business" | "x_twitter" | undefined;
@@ -46,12 +46,12 @@ export declare const listPlatformsTool: {
             include_planned: z.ZodOptional<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            include_planned?: boolean | undefined;
             account_id?: string | undefined;
+            include_planned?: boolean | undefined;
         }, {
             platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "medium" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "reddit" | "skool" | "whop" | "gmb" | "google-business" | "google_business_profile" | undefined;
-            include_planned?: boolean | undefined;
             account_id?: string | undefined;
+            include_planned?: boolean | undefined;
         }>;
         get_connect_link: z.ZodObject<{
             platform: z.ZodOptional<z.ZodEnum<["bluesky", "devto", "discord", "facebook", "facebook_instagram", "facebook_pages", "gmb", "google-business", "google_business", "google_business_profile", "hashnode", "instagram", "instagram-standalone", "instagram_direct", "lemmy", "linkedin", "linkedin-company", "linkedin-page", "linkedin_company", "linkedin_page", "linkedin_personal", "mastodon", "medium", "meta", "meta_business", "pinterest", "reddit", "skool", "slack", "telegram", "threads", "tiktok", "twitter", "whop", "wordpress", "x", "x_twitter", "youtube"]>>;

package/dist/tools/list-post-suggestions.d.ts

@@ -7,18 +7,22 @@ export declare const listPostSuggestionsTool: {
         account_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         status: z.ZodOptional<z.ZodEnum<["pending", "scheduled", "dismissed"]>>;
         limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         status?: "pending" | "scheduled" | "dismissed" | undefined;
         account_id?: string | number | undefined;
         limit?: number | undefined;
+        offset?: number | undefined;
     }, {
         status?: "pending" | "scheduled" | "dismissed" | undefined;
         account_id?: string | number | undefined;
         limit?: number | undefined;
+        offset?: number | undefined;
     }>;
     execute(client: PosterlyClient, input: {
         account_id?: string | number;
         status?: "pending" | "scheduled" | "dismissed";
         limit?: number;
+        offset?: number;
     }): Promise<string>;
 };

package/dist/tools/list-post-suggestions.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText } from '../lib/format.js';
+import { formatPagingNote, mdTitle, mdSection, mdKeyValue, mdEmpty, truncateText } from '../lib/format.js';
 export const listPostSuggestionsTool = {
     name: 'list_post_suggestions',
-    description: "List proactive post suggestions: evidence-based weekly drafts posterly writes in each account's learned voice, each with a rationale tying it back to what has performed well for that account. Filter by account_id and status (pending, scheduled, dismissed; default pending). Read-only; requires a Pro plan or higher. Use dismiss_suggestion to hide one.",
+    description: "List proactive post suggestions: evidence-based weekly drafts posterly writes in each account's learned voice, each with a rationale tying it back to what has performed well for that account. Filter by account_id and status (pending, scheduled, dismissed; default pending). The output says whether every matching suggestion is shown; page with offset until it does. Read-only; requires a Pro plan or higher. Use dismiss_suggestion to hide one.",
     inputSchema: z.object({
         account_id: z
             .union([z.string(), z.number()])
@@ -13,9 +13,11 @@ export const listPostSuggestionsTool = {
             .optional()
             .describe('Suggestion status to list (default pending).'),
         limit: z.number().int().min(1).max(100).optional().describe('Max suggestions to return (default 20).'),
+        offset: z.number().int().min(0).optional().describe('How many suggestions to skip. Use the offset the previous page gives to get the next page.'),
     }),
     async execute(client, input) {
-        const { suggestions } = await client.listPostSuggestions(input);
+        const page = await client.listPostSuggestions(input);
+        const { suggestions } = page;
         if (!suggestions.length) {
             return mdEmpty('post suggestions', 'No proactive post suggestions match these filters. posterly generates fresh drafts weekly for accounts with a learned voice.');
         }
@@ -31,6 +33,16 @@ export const listPostSuggestionsTool = {
                 ['Rationale', suggestion.rationale ? truncateText(suggestion.rationale, 240) : undefined],
             ]));
         });
-        return [mdTitle(`Post suggestions (${suggestions.length})`), ...blocks].join('\n\n');
+        const note = formatPagingNote({
+            noun: 'suggestions',
+            tool: 'list_post_suggestions',
+            offset: page.offset ?? input.offset ?? 0,
+            count: suggestions.length,
+            total: page.total,
+            // An API older than has_more: a full page may mean more exist.
+            hasMore: page.has_more ?? suggestions.length >= (input.limit || 20),
+            nextOffset: page.next_offset,
+        });
+        return [mdTitle(`Post suggestions (${suggestions.length})`), ...blocks, note].join('\n\n');
     },
 };