@thenavidm/threads-mcp-cli 1.1.2 → 2.0.1

package/dist/tools/posts.d.ts

@@ -7,164 +7,13 @@
  * has: invisible, valid for 24 hours, publishable later by id. That is exactly
  * what an agent needs when a human wants to see something before it is public.
  */
-import { z } from "zod";
-export declare const createPost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const createThread: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    posts: z.ZodArray<z.ZodString, "many">;
-}>;
-export declare const createCarousel: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    items: z.ZodArray<z.ZodObject<{
-        image_url: z.ZodOptional<z.ZodString>;
-        video_url: z.ZodOptional<z.ZodString>;
-        alt_text: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }>, "many">;
-    text: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-}>;
-export declare const stagePost: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const publishStaged: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}>;
-export declare const getContainerStatus: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}>;
-export declare const quotePost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    text: z.ZodString;
-    quoted_post_id: z.ZodString;
-}>;
-export declare const repost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const deletePost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const POST_TOOLS: (import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    posts: z.ZodArray<z.ZodString, "many">;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    items: z.ZodArray<z.ZodObject<{
-        image_url: z.ZodOptional<z.ZodString>;
-        video_url: z.ZodOptional<z.ZodString>;
-        alt_text: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }, {
-        alt_text?: string | undefined;
-        image_url?: string | undefined;
-        video_url?: string | undefined;
-    }>, "many">;
-    text: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    link_attachment: z.ZodOptional<z.ZodString>;
-    topic_tag: z.ZodOptional<z.ZodString>;
-    reply_to_id: z.ZodOptional<z.ZodString>;
-    quote_post_id: z.ZodOptional<z.ZodString>;
-    reply_control: z.ZodOptional<z.ZodEnum<["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"]>>;
-    allowlisted_country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    enable_reply_approvals: z.ZodOptional<z.ZodBoolean>;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    container_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    text: z.ZodString;
-    quoted_post_id: z.ZodString;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>)[];
+export declare const createPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const createThread: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const createCarousel: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const stagePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const publishStaged: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getContainerStatus: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const quotePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const repost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const deletePost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const POST_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];

package/dist/tools/read.d.ts

@@ -5,27 +5,6 @@
  * because "what did I post this week" is a question about time and turning it
  * into a guess at a post count is how you end up missing half of it.
  */
-import { z } from "zod";
-export declare const getPosts: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-    since: z.ZodOptional<z.ZodString>;
-    until: z.ZodOptional<z.ZodString>;
-}>;
-export declare const getPost: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>;
-export declare const READ_TOOLS: (import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-    since: z.ZodOptional<z.ZodString>;
-    until: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-}>)[];
+export declare const getPosts: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const READ_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];

package/dist/tools/replies.d.ts

@@ -11,82 +11,11 @@
  * The third is the one an agent actually wants when asked "what needs
  * answering", and it is the one nothing surfaces by default.
  */
-import { z } from "zod";
-export declare const replyToPost: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    text: z.ZodString;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-}>;
-export declare const getReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getConversation: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getAllReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-}>;
-export declare const hideReply: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    hide: z.ZodOptional<z.ZodBoolean>;
-}>;
-export declare const getPendingReplies: import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-}>;
-export declare const managePendingReply: import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    action: z.ZodEnum<["approve", "ignore"]>;
-}>;
-export declare const REPLY_TOOLS: (import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    text: z.ZodString;
-    image_url: z.ZodOptional<z.ZodString>;
-    video_url: z.ZodOptional<z.ZodString>;
-    alt_text: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    reverse: z.ZodOptional<z.ZodBoolean>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-    since_hours: z.ZodOptional<z.ZodNumber>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    hide: z.ZodOptional<z.ZodBoolean>;
-}> | import("./kit.js").ToolSpec<{
-    account: z.ZodOptional<z.ZodString>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    cursor: z.ZodOptional<z.ZodString>;
-}> | import("./kit.js").ToolSpec<{
-    confirm: z.ZodOptional<z.ZodBoolean>;
-    account: z.ZodOptional<z.ZodString>;
-    reply_id: z.ZodString;
-    action: z.ZodEnum<["approve", "ignore"]>;
-}>)[];
+export declare const replyToPost: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getConversation: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getAllReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const hideReply: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const getPendingReplies: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const managePendingReply: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>;
+export declare const REPLY_TOOLS: import("@thenavidm/slipway").Tool<import("./kit.js").ToolContext>[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenavidm/threads-mcp-cli",
-  "version": "1.1.2",
+  "version": "2.0.1",
   "description": "Threads MCP server and CLI for Claude Code and AI agents. 30 tools for posting, chained threads, carousels, replies and reply approvals, insights, keyword search and profile discovery.",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,7 @@
     "threads-mcp-cli": "dist/npx.js"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "build": "tsc",
@@ -23,12 +23,12 @@
     "build:mcpb": "bash desktop-extension/build.sh"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.18.0",
-    "zod": "^3.23.8",
-    "zod-to-json-schema": "^3.24.1"
+    "@thenavidm/slipway": "^0.1.17",
+    "zod": "^4.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "ajv": "^8.20.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0"
   },
@@ -52,7 +52,12 @@
     "claude",
     "claude-code",
     "ai-agents",
-    "llm-tools"
+    "llm-tools",
+    "cli",
+    "social-media",
+    "codex",
+    "slipway",
+    "meta-threads"
   ],
   "files": [
     "dist",

package/dist/cli.d.ts

@@ -1,59 +0,0 @@
-/**
- * The CLI adapter.
- *
- * `register()` in tools/kit.ts turns a `ToolSpec` into an MCP tool. This turns
- * the same spec into a shell command, from the same `ALL_TOOLS` array, through
- * the same handler and the same `WriteGuard`. Nothing is described twice, so a
- * tool added tomorrow is a command tomorrow and the two surfaces cannot drift.
- *
- * The command IS the tool name. `create_post` runs as `create-post`, and the
- * underscore form works too. Inventing a prettier command tree would mean a
- * hand-written mapping, which is exactly the drift this avoids, and it would
- * force anyone reading the SKILL.md to learn two vocabularies for one action.
- *
- * Zod is the only schema: every flag, its placeholder, its help text and its
- * validation come from the shape the MCP tool already declares.
- */
-import { type ZodRawShape } from "zod";
-/** How a value reaches the parser, once the Zod wrappers are peeled off. */
-type FlagKind = "string" | "number" | "boolean" | "enum" | "json";
-type Flag = {
-    /** The schema key, e.g. `reply_control`. */
-    key: string;
-    /** The long flag, e.g. `--reply-control`. */
-    flag: string;
-    kind: FlagKind;
-    required: boolean;
-    repeatable: boolean;
-    choices?: string[];
-    help: string;
-};
-export declare function flagsFor(shape: ZodRawShape): Flag[];
-/**
- * Parse argv against a tool's flags.
- *
- * Zod does the real validation afterwards, so this only has to get the values
- * into the right JavaScript types and catch the mistakes Zod would report in
- * terms of a schema the person at the terminal never sees.
- */
-export declare function parseArgs(argv: string[], flags: Flag[]): Record<string, unknown>;
-/** Exit codes, so a script can branch without parsing the message. */
-export declare const EXIT: {
-    readonly ok: 0;
-    readonly usage: 2;
-    readonly notFound: 3;
-    readonly auth: 4;
-    readonly api: 5;
-    readonly rateLimited: 7;
-    readonly config: 10;
-};
-/** Map a thrown error onto one of those, from the shape the API gave back. */
-export declare function exitCodeFor(error: unknown): number;
-/**
- * `--select id,post.title` keeps only the named fields. Dotted paths descend,
- * arrays are traversed element-wise. This is what makes a long feed affordable.
- */
-export declare function selectFields(data: unknown, paths: string[]): unknown;
-export declare function isCliCommand(argv: string[]): boolean;
-export declare function runCli(argv: string[]): Promise<number>;
-export {};