@thenavidm/threads-mcp-cli 1.1.0

package/dist/tools/posts.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Publishing.
+ *
+ * `create_post` is the one-call path and what most work should use. The staged
+ * pair underneath it — `stage_post` and `publish_staged` — exposes the
+ * unpublished container directly, because it is the only draft state Threads
+ * 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;
+}>)[];

package/dist/tools/posts.js

@@ -0,0 +1,312 @@
+/**
+ * Publishing.
+ *
+ * `create_post` is the one-call path and what most work should use. The staged
+ * pair underneath it — `stage_post` and `publish_staged` — exposes the
+ * unpublished container directly, because it is the only draft state Threads
+ * 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";
+import { accountArg, confirmArg, defineTool, snippet } from "./kit.js";
+import { createContainer, publish, publishCarousel, publishChain, publishContainer, validate, } from "../content/containers.js";
+import { assertCarouselSize } from "../content/media.js";
+import { deleteSucceeded } from "../api/client.js";
+import { requireMediaId } from "../api/identity.js";
+import { measure } from "../content/text.js";
+const replyControl = z
+    .enum(["everyone", "accounts_you_follow", "mentioned_only", "parent_post_author_only", "followers_only"])
+    .optional()
+    .describe("Who may reply. Defaults to everyone.");
+const mediaArgs = {
+    image_url: z
+        .string()
+        .optional()
+        .describe("Public HTTPS URL of a JPEG or PNG, 8MB or less. Threads fetches it itself; there is no upload endpoint."),
+    video_url: z
+        .string()
+        .optional()
+        .describe("Public HTTPS URL of an MP4 or MOV, up to 1GB and 5 minutes."),
+    alt_text: z.string().optional().describe("Alt text for the attached image or video."),
+};
+const composeArgs = {
+    text: z.string().optional().describe("Post body. 500 characters, and emoji count as UTF-8 bytes."),
+    ...mediaArgs,
+    link_attachment: z
+        .string()
+        .optional()
+        .describe("A URL to render as a preview card. Text-only posts only; it cannot be combined with media."),
+    topic_tag: z
+        .string()
+        .optional()
+        .describe("One topic tag, without the #. 1-50 characters, no periods or ampersands."),
+    reply_to_id: z.string().optional().describe("Numeric id of the post this replies to."),
+    quote_post_id: z.string().optional().describe("Numeric id of a post to quote."),
+    reply_control: replyControl,
+    allowlisted_country_codes: z
+        .array(z.string())
+        .optional()
+        .describe("Restrict who can see this post to these ISO 3166-1 alpha-2 country codes. Needs a profile Meta has made eligible; whoami reports whether this one is."),
+    enable_reply_approvals: z
+        .boolean()
+        .optional()
+        .describe("Hold replies for approval before they appear. Read the queue with get_pending_replies."),
+};
+export const createPost = defineTool({
+    name: "create_post",
+    title: "Publish a post",
+    description: "Publish one post to Threads: creates the media container, waits for it to finish processing, then publishes. Public the moment it runs, and Threads has no edit endpoint, so this needs confirm: true. For anything over 500 characters use create_thread instead.",
+    schema: { ...composeArgs, ...accountArg, ...confirmArg },
+    risk: "destructive",
+    summary: (args) => `post to Threads: "${snippet(args.text)}"`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const post = await publish(ctx.client, account, {
+            text: args.text,
+            image_url: args.image_url,
+            video_url: args.video_url,
+            alt_text: args.alt_text,
+            link_attachment: args.link_attachment,
+            topic_tag: args.topic_tag,
+            reply_to_id: args.reply_to_id ? requireMediaId(args.reply_to_id) : undefined,
+            quote_post_id: args.quote_post_id ? requireMediaId(args.quote_post_id) : undefined,
+            reply_control: args.reply_control,
+            allowlisted_country_codes: args.allowlisted_country_codes,
+            enable_reply_approvals: args.enable_reply_approvals,
+        });
+        return post;
+    },
+});
+export const createThread = defineTool({
+    name: "create_thread",
+    title: "Publish a chain of posts",
+    description: "Publish several posts as a thread, each replying to the one before. Threads has no thread endpoint: a thread is a chain of ordinary posts, so it can half-publish. Every part is length-checked before the first one goes out, and if a later part still fails the error names exactly how far it got. Public and irreversible, so this needs confirm: true.",
+    schema: {
+        posts: z
+            .array(z.string())
+            .min(1)
+            .max(25)
+            .describe("The parts, in order. Each is capped at 500 characters and validated before anything is published."),
+        ...mediaArgs,
+        link_attachment: composeArgs.link_attachment,
+        topic_tag: composeArgs.topic_tag,
+        reply_to_id: z
+            .string()
+            .optional()
+            .describe("Start the thread as a reply to this post, rather than as a new one."),
+        reply_control: replyControl,
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `post a ${args.posts.length}-part Threads thread starting "${snippet(args.posts[0])}"`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        // Media, the link card, the tag and the reply control apply to the first
+        // post only. Repeating them down the chain would attach the same image to
+        // every part, which is never what anyone means.
+        const parts = args.posts.map((text, index) => index === 0
+            ? {
+                text,
+                image_url: args.image_url,
+                video_url: args.video_url,
+                alt_text: args.alt_text,
+                link_attachment: args.link_attachment,
+                topic_tag: args.topic_tag,
+                reply_control: args.reply_control,
+            }
+            : { text });
+        const { posts, warnings } = await publishChain(ctx.client, account, parts, args.reply_to_id ? requireMediaId(args.reply_to_id) : undefined);
+        return {
+            parts: posts.length,
+            root: posts[0]?.permalink ?? posts[0]?.id,
+            posts: posts.map((p, i) => ({ part: i + 1, id: p.id, permalink: p.permalink })),
+            ...(warnings.length ? { warnings } : {}),
+        };
+    },
+});
+export const createCarousel = defineTool({
+    name: "create_carousel",
+    title: "Publish a carousel",
+    description: "Publish 2 to 20 images or videos as one carousel post. Each item is staged separately and they transcode in parallel, then a parent container binds them together. Counts as a single post against the daily quota. Public and irreversible, so this needs confirm: true.",
+    schema: {
+        items: z
+            .array(z.object({
+            image_url: z.string().optional(),
+            video_url: z.string().optional(),
+            alt_text: z.string().optional(),
+        }))
+            .min(2)
+            .max(20)
+            .describe("2 to 20 items, each with an image_url or a video_url."),
+        text: z.string().optional().describe("Caption for the carousel. 500 characters."),
+        topic_tag: composeArgs.topic_tag,
+        reply_control: replyControl,
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `post a ${args.items.length}-item Threads carousel: "${snippet(args.text)}"`,
+    handler: async (args, ctx) => {
+        assertCarouselSize(args.items.length);
+        const account = ctx.account(args.account);
+        return publishCarousel(ctx.client, account, args.items, {
+            text: args.text,
+            topic_tag: args.topic_tag,
+            reply_control: args.reply_control,
+        });
+    },
+});
+export const stagePost = defineTool({
+    name: "stage_post",
+    title: "Stage a post without publishing it",
+    description: "Build a media container without publishing. Nothing appears anywhere: the container is invisible, holds for 24 hours, and is published later with publish_staged. This is the only draft state Threads has, and the right way to show a human a post before it goes public. Nothing is public, so no confirmation is needed.",
+    schema: { ...composeArgs, ...accountArg },
+    risk: "write",
+    summary: (args) => `stage a Threads post: "${snippet(args.text)}"`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const options = {
+            text: args.text,
+            image_url: args.image_url,
+            video_url: args.video_url,
+            alt_text: args.alt_text,
+            link_attachment: args.link_attachment,
+            topic_tag: args.topic_tag,
+            reply_to_id: args.reply_to_id ? requireMediaId(args.reply_to_id) : undefined,
+            quote_post_id: args.quote_post_id ? requireMediaId(args.quote_post_id) : undefined,
+            reply_control: args.reply_control,
+            allowlisted_country_codes: args.allowlisted_country_codes,
+            enable_reply_approvals: args.enable_reply_approvals,
+        };
+        const warnings = validate(options);
+        const containerId = await createContainer(ctx.client, account, options);
+        return {
+            container_id: containerId,
+            published: false,
+            expires_in_hours: 24,
+            characters: args.text ? measure(args.text).graphemes : 0,
+            next: `Call publish_staged with container_id ${containerId} to make it live.`,
+            ...(warnings.length ? { warnings } : {}),
+        };
+    },
+});
+export const publishStaged = defineTool({
+    name: "publish_staged",
+    title: "Publish a staged container",
+    description: "Publish a container created by stage_post, waiting for processing first. This is what makes it public, so it needs confirm: true.",
+    schema: {
+        container_id: z.string().describe("The container id returned by stage_post."),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `publish staged Threads container ${args.container_id}`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        return publishContainer(ctx.client, account, args.container_id);
+    },
+});
+export const getContainerStatus = defineTool({
+    name: "get_container_status",
+    title: "Check a staged container",
+    description: "The processing status of a container: IN_PROGRESS, FINISHED, ERROR or EXPIRED, with the failure reason when there is one. Useful when a video is taking a long time, or to check whether a staged post is still within its 24-hour window.",
+    schema: {
+        container_id: z.string(),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const status = (await ctx.client.call(account, `/${args.container_id}`, {
+            params: { fields: "status,error_message" },
+        }));
+        return {
+            container_id: args.container_id,
+            status: status.status ?? "UNKNOWN",
+            ...(status.error_message ? { error_message: status.error_message } : {}),
+            ...(status.status === "ERROR"
+                ? {
+                    hint: "Container errors are nearly always the media URL. It has to be publicly reachable over HTTPS, return an image or video content type, and not redirect to a login page.",
+                }
+                : {}),
+        };
+    },
+});
+export const quotePost = defineTool({
+    name: "quote_post",
+    title: "Quote another post",
+    description: "Publish a post that quotes an existing Threads post. Public and irreversible, so this needs confirm: true.",
+    schema: {
+        text: z.string().describe("Your commentary. 500 characters."),
+        quoted_post_id: z.string().describe("Numeric id of the post being quoted."),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `quote Threads post ${args.quoted_post_id}: "${snippet(args.text)}"`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        return publish(ctx.client, account, {
+            text: args.text,
+            quote_post_id: requireMediaId(args.quoted_post_id),
+        });
+    },
+});
+export const repost = defineTool({
+    name: "repost",
+    title: "Repost a post",
+    description: "Repost an existing Threads post to your own profile. This is visible to your followers immediately and the API has no un-repost call, so it needs confirm: true.",
+    schema: {
+        id: z.string().describe("Numeric id of the post to repost."),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `repost Threads post ${args.id}`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        const response = (await ctx.client.call(account, `/${id}/repost`, { method: "POST" }));
+        return {
+            repost_id: response.id ?? null,
+            original: id,
+            note: "Threads has no un-repost endpoint. Undo this in the app.",
+        };
+    },
+});
+export const deletePost = defineTool({
+    name: "delete_post",
+    title: "Delete one of your posts",
+    description: "Permanently delete one of your own Threads posts. There is no undo, no archive, and no edit endpoint to reach for instead: replies and likes go with it. Deletions are also capped at 100 per rolling 24 hours. Needs confirm: true.",
+    schema: {
+        id: z.string().describe("Numeric id of the post to delete."),
+        ...accountArg,
+        ...confirmArg,
+    },
+    risk: "destructive",
+    summary: (args) => `permanently delete Threads post ${args.id}`,
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        // Meta's delete is an HTTP DELETE. Sending POST here returns a success-
+        // shaped response for a request that deleted nothing.
+        const response = await ctx.client.call(account, `/${id}`, { method: "DELETE" });
+        return {
+            deleted: deleteSucceeded(response) ? id : null,
+            ...(deleteSucceeded(response) ? {} : { warning: "Threads did not confirm the deletion.", response }),
+        };
+    },
+});
+export const POST_TOOLS = [
+    createPost,
+    createThread,
+    createCarousel,
+    stagePost,
+    publishStaged,
+    getContainerStatus,
+    quotePost,
+    repost,
+    deletePost,
+];
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"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"}

package/dist/tools/read.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reading your own posts.
+ *
+ * `since_hours` pages until it reaches a time window rather than a count,
+ * 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;
+}>)[];

package/dist/tools/read.js

@@ -0,0 +1,95 @@
+/**
+ * Reading your own posts.
+ *
+ * `since_hours` pages until it reaches a time window rather than a count,
+ * 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";
+import { accountArg, clamp, defineTool, pageArgs } from "./kit.js";
+import { POST_FIELDS } from "../api/client.js";
+import { cursorOf, dataOf, renderList, renderPost } from "../format/posts.js";
+import { requireMediaId } from "../api/identity.js";
+export const getPosts = defineTool({
+    name: "get_posts",
+    title: "Read your recent posts",
+    description: "Your own Threads posts, newest first, with ids and permalinks. The numeric id on each result is what every other tool wants: Threads has no way to convert a permalink back into an id, so this is where ids come from.",
+    schema: {
+        since_hours: z
+            .number()
+            .optional()
+            .describe("Read back this many hours, paging as needed, rather than a fixed number of posts."),
+        since: z.string().optional().describe("ISO date or Unix timestamp to start from."),
+        until: z.string().optional().describe("ISO date or Unix timestamp to stop at."),
+        ...pageArgs,
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const pageSize = clamp(args.limit, 25);
+        const cutoff = args.since_hours ? Date.now() - args.since_hours * 3_600_000 : undefined;
+        const collected = [];
+        let cursor = args.cursor;
+        let reachedCutoff = false;
+        // Without a window this is one page. With one, page until the timestamps
+        // cross it, capped so a busy account cannot spin here forever.
+        const maxPages = cutoff ? 10 : 1;
+        for (let page = 0; page < maxPages; page++) {
+            const response = (await ctx.client.call(account, `/${userId}/threads`, {
+                params: {
+                    fields: POST_FIELDS,
+                    limit: cutoff ? 100 : pageSize,
+                    after: cursor,
+                    since: args.since,
+                    until: args.until,
+                },
+            }));
+            const items = dataOf(response);
+            if (!items.length)
+                break;
+            for (const item of items) {
+                if (cutoff) {
+                    const at = new Date(String(item.timestamp)).getTime();
+                    if (!Number.isNaN(at) && at < cutoff) {
+                        reachedCutoff = true;
+                        break;
+                    }
+                }
+                collected.push(item);
+            }
+            cursor = cursorOf(response);
+            if (reachedCutoff || !cursor)
+                break;
+        }
+        return renderList(collected, {
+            source: "posts",
+            cursor: reachedCutoff ? undefined : cursor,
+            meta: {
+                account: account.username,
+                ...(args.since_hours ? { since_hours: args.since_hours } : {}),
+            },
+        });
+    },
+});
+export const getPost = defineTool({
+    name: "get_post",
+    title: "Read one post",
+    description: "One Threads post by its numeric id, with its full field set: text, media, permalink, topic tag, link attachment, quoted post and whether it has replies.",
+    schema: {
+        id: z.string().describe("Numeric post id."),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        const post = (await ctx.client.call(account, `/${id}`, {
+            params: { fields: `${POST_FIELDS},allowlisted_country_codes` },
+        }));
+        return renderPost(post, 0);
+    },
+});
+export const READ_TOOLS = [getPosts, getPost];
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"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"}