@cyanheads/bluesky-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/bsky-get-author-feed.tool.js

@@ -0,0 +1,217 @@
+/**
+ * @fileoverview Get a Bluesky user's recent posts ordered newest-first.
+ * @module mcp-server/tools/definitions/bsky-get-author-feed
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+/** Embed uses passthrough so all sub-fields flow through structuredContent while format() renders the key data. */
+const EmbedSchema = z
+    .object({})
+    .passthrough()
+    .describe('Media or link embed attached to this post. ' +
+    'type: "images" | "external" | "record" | "video" | "unknown". ' +
+    'images: array of { url, alt, aspectRatio? }. ' +
+    'external: { uri, title, description, thumb? }. ' +
+    'record: { uri, cid, text?, authorHandle? }. ' +
+    'video: { playlist?, thumbnail?, presentation?, aspectRatio? }. ' +
+    'unknown: { raw }.');
+const PostSchema = z
+    .object({
+    uri: z
+        .string()
+        .describe('AT-URI of the post, e.g. "at://did:plc:xxx/app.bsky.feed.post/yyy". Use with bsky_get_post_thread.'),
+    cid: z.string().describe('Content Identifier (CID) of the post record.'),
+    text: z.string().describe('Full text content of the post.'),
+    author: z
+        .object({
+        did: z
+            .string()
+            .describe('Permanent DID of the author, e.g. "did:plc:z72i7hdynmk6r22z27h6tvur".'),
+        handle: z
+            .string()
+            .describe('Human-readable handle of the author, e.g. "alice.bsky.social".'),
+        displayName: z.string().optional().describe('Display name set by the author.'),
+        avatar: z.string().optional().describe('URL of the author avatar image.'),
+    })
+        .describe('Author of this post.'),
+    replyCount: z.number().optional().describe('Number of replies to this post.'),
+    repostCount: z.number().optional().describe('Number of reposts.'),
+    likeCount: z.number().optional().describe('Number of likes.'),
+    quoteCount: z.number().optional().describe('Number of quote posts.'),
+    indexedAt: z.string().optional().describe('ISO 8601 timestamp when this post was indexed.'),
+    createdAt: z.string().optional().describe('ISO 8601 timestamp when this post was created.'),
+    labels: z
+        .array(z
+        .object({
+        val: z
+            .string()
+            .describe('Label value (content warning or moderation tag, e.g. "porn", "spam").'),
+    })
+        .describe('A moderation label.'))
+        .optional()
+        .describe('Moderation labels on this post.'),
+    embed: EmbedSchema.optional().describe('Media or link embed attached to this post, if any.'),
+    replyToUri: z
+        .string()
+        .optional()
+        .describe('AT-URI of the post this is a reply to, if applicable.'),
+})
+    .describe('A single post from the author feed.');
+export const bskyGetAuthorFeed = tool('bsky_get_author_feed', {
+    title: 'Get Bluesky Author Feed',
+    description: "Get a Bluesky user's recent posts ordered newest-first. Filter by post type: " +
+        '"posts_with_replies" (everything), "posts_no_replies" (original posts only), ' +
+        '"posts_with_media" (posts with images or links), or "posts_and_author_threads" ' +
+        '(posts the author started). Returns posts with full text, engagement counts, embeds, ' +
+        'and AT-URIs for drilling into threads via bsky_get_post_thread. Supports cursor pagination.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        actor: z
+            .string()
+            .max(253)
+            .describe('Handle (e.g. "alice.bsky.social") or DID of the author whose feed to fetch.'),
+        filter: z
+            .enum([
+            'posts_with_replies',
+            'posts_no_replies',
+            'posts_with_media',
+            'posts_and_author_threads',
+        ])
+            .default('posts_no_replies')
+            .describe('Filter for post types: "posts_no_replies" for original posts only, "posts_with_replies" for everything, ' +
+            '"posts_with_media" for posts with images/links, "posts_and_author_threads" for threads the author started.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe('Maximum number of posts to return (1–100). Default 25.'),
+        cursor: z
+            .string()
+            .max(2048)
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Omit for the first page.'),
+    }),
+    output: z.object({
+        posts: z.array(PostSchema).describe('Posts from this author, ordered newest-first.'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque cursor for the next page. Absent on the last page.'),
+    }),
+    errors: [
+        {
+            reason: 'actor_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The actor handle or DID does not resolve to an existing account.',
+            recovery: 'Verify the handle or DID, or use bsky_search_actors to find the correct actor.',
+        },
+    ],
+    enrichment: {
+        totalReturned: z.number().describe('Number of posts in this response page.'),
+    },
+    async handler(input, ctx) {
+        ctx.log.info('Fetching Bluesky author feed', {
+            actor: input.actor,
+            filter: input.filter,
+            limit: input.limit,
+        });
+        let result;
+        try {
+            result = await getBlueskyService().getAuthorFeed({
+                actor: input.actor,
+                filter: input.filter,
+                limit: input.limit,
+                ...(input.cursor ? { cursor: input.cursor } : {}),
+            }, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError) {
+                const body = err.data?.responseBody ?? '';
+                if (err.data &&
+                    (body.includes('not found') || body.includes('Not Found') || body.includes('NotFound'))) {
+                    throw ctx.fail('actor_not_found', `Actor not found: "${input.actor}"`, ctx.recoveryFor('actor_not_found'));
+                }
+            }
+            throw err;
+        }
+        ctx.enrich({ totalReturned: result.feed.length });
+        if (result.feed.length === 0) {
+            ctx.enrich.notice(`No posts found for actor "${input.actor}" with filter "${input.filter}".`);
+        }
+        return { posts: result.feed, ...(result.cursor ? { cursor: result.cursor } : {}) };
+    },
+    format: (result) => {
+        if (result.posts.length === 0) {
+            return [{ type: 'text', text: 'No posts found for this actor.' }];
+        }
+        const lines = result.posts.map((p) => {
+            const parts = [];
+            const author = p.author.displayName
+                ? `${p.author.displayName} (@${p.author.handle})`
+                : `@${p.author.handle}`;
+            parts.push(`### ${author}`);
+            parts.push(`**AT-URI:** \`${p.uri}\` | **CID:** \`${p.cid}\``);
+            parts.push(`**Author DID:** \`${p.author.did}\``);
+            parts.push(p.text);
+            const meta = [];
+            if (p.likeCount != null)
+                meta.push(`${p.likeCount} likes`);
+            if (p.repostCount != null)
+                meta.push(`${p.repostCount} reposts`);
+            if (p.replyCount != null)
+                meta.push(`${p.replyCount} replies`);
+            if (p.quoteCount != null)
+                meta.push(`${p.quoteCount} quotes`);
+            if (meta.length)
+                parts.push(`*${meta.join(' · ')}*`);
+            if (p.createdAt)
+                parts.push(`*Created: ${p.createdAt}*`);
+            if (p.indexedAt)
+                parts.push(`*Indexed: ${p.indexedAt}*`);
+            if (p.embed) {
+                const embed = p.embed;
+                const embedType = embed.type;
+                if (embedType === 'images') {
+                    const images = embed.images;
+                    if (images?.length) {
+                        parts.push(`📷 ${images.length} image(s): ${images.map((img) => `${img.url} [${img.alt}]`).join(', ')}`);
+                    }
+                }
+                else if (embedType === 'external') {
+                    parts.push(`🔗 [${embed.title}](${embed.uri}): ${embed.description}`);
+                }
+                else if (embedType === 'record') {
+                    parts.push(`💬 Quoted post AT-URI: \`${embed.uri}\``);
+                    if (embed.text)
+                        parts.push(`   > ${embed.text}`);
+                }
+                else if (embedType === 'video') {
+                    const vid = embed;
+                    const label = vid.presentation === 'gif' ? '🎞 GIF' : '🎬 Video';
+                    if (vid.thumbnail)
+                        parts.push(`${label}: ${vid.thumbnail}`);
+                    else
+                        parts.push(label);
+                }
+            }
+            if (p.replyToUri)
+                parts.push(`↩ Reply to \`${p.replyToUri}\``);
+            if (p.author.avatar)
+                parts.push(`**Avatar:** ${p.author.avatar}`);
+            if (p.labels?.length)
+                parts.push(`**Labels:** ${p.labels.map((l) => l.val).join(', ')}`);
+            return parts.join('\n');
+        });
+        const output = lines.join('\n\n---\n\n');
+        return [
+            {
+                type: 'text',
+                text: result.cursor ? `${output}\n\n---\n*cursor: \`${result.cursor}\`*` : output,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=bsky-get-author-feed.tool.js.map

package/dist/mcp-server/tools/definitions/bsky-get-author-feed.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-author-feed.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-author-feed.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/bsky-get-follows.tool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Fetch social graph edges for a Bluesky account — followers or following.
+ * @module mcp-server/tools/definitions/bsky-get-follows
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const bskyGetFollows: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    actor: z.ZodString;
+    direction: z.ZodEnum<{
+        followers: "followers";
+        following: "following";
+    }>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    actors: z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
+        followersCount: z.ZodOptional<z.ZodNumber>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    subject: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        followersCount: z.ZodOptional<z.ZodNumber>;
+        followsCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "actor_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The actor handle or DID does not resolve to an existing account.";
+    readonly recovery: "Verify the actor handle or DID, or use bsky_search_actors to confirm the handle.";
+}], {
+    readonly totalReturned: z.ZodNumber;
+}>;
+//# sourceMappingURL=bsky-get-follows.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bsky-get-follows.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-follows.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-follows.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AA2B3E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqJzB,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-get-follows.tool.js

@@ -0,0 +1,165 @@
+/**
+ * @fileoverview Fetch social graph edges for a Bluesky account — followers or following.
+ * @module mcp-server/tools/definitions/bsky-get-follows
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+const ActorSchema = z
+    .object({
+    did: z.string().describe('Decentralized Identifier of the actor.'),
+    handle: z.string().describe('Human-readable handle, e.g. "alice.bsky.social".'),
+    displayName: z.string().optional().describe('Display name set by the user.'),
+    description: z.string().optional().describe('Biography / about text.'),
+    avatar: z.string().optional().describe('Avatar image URL.'),
+    followersCount: z.number().optional().describe('Number of followers.'),
+    labels: z
+        .array(z
+        .object({
+        val: z
+            .string()
+            .describe('Label value (content warning or moderation tag, e.g. "porn", "spam").'),
+    })
+        .describe('A moderation label.'))
+        .optional()
+        .describe('Moderation labels.'),
+})
+    .describe('A Bluesky actor in the social graph.');
+export const bskyGetFollows = tool('bsky_get_follows', {
+    title: 'Get Bluesky Social Graph',
+    description: 'Fetch the social graph edges for a Bluesky account — who follows them, or who they follow. ' +
+        'Returns paginated actor profiles (handle, DID, displayName, bio, follower count) plus a summary ' +
+        'of the subject account. Accounts with large social graphs return only the first page; use ' +
+        'cursor pagination to walk through the full list.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        actor: z
+            .string()
+            .max(253)
+            .describe('Handle (e.g. "alice.bsky.social") or DID of the account to query.'),
+        direction: z
+            .enum(['followers', 'following'])
+            .describe('"followers" returns accounts that follow this actor. "following" returns accounts this actor follows.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe('Maximum number of actors to return per page (1–100). Default 25.'),
+        cursor: z
+            .string()
+            .max(2048)
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Omit for the first page.'),
+    }),
+    output: z.object({
+        actors: z.array(ActorSchema).describe('Actors in the requested direction of the social graph.'),
+        subject: z
+            .object({
+            did: z.string().describe('Permanent DID of the queried account.'),
+            handle: z.string().describe('Human-readable handle of the queried account.'),
+            displayName: z.string().optional().describe('Subject display name.'),
+            followersCount: z.number().optional().describe("Subject's follower count."),
+            followsCount: z.number().optional().describe("Subject's following count."),
+        })
+            .describe('Profile summary of the queried actor.'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque cursor for the next page. Absent on the last page.'),
+    }),
+    errors: [
+        {
+            reason: 'actor_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The actor handle or DID does not resolve to an existing account.',
+            recovery: 'Verify the actor handle or DID, or use bsky_search_actors to confirm the handle.',
+        },
+    ],
+    enrichment: {
+        totalReturned: z.number().describe('Number of actors in this response page.'),
+    },
+    async handler(input, ctx) {
+        ctx.log.info('Fetching Bluesky social graph', {
+            actor: input.actor,
+            direction: input.direction,
+            limit: input.limit,
+        });
+        const params = {
+            actor: input.actor,
+            limit: input.limit,
+            ...(input.cursor ? { cursor: input.cursor } : {}),
+        };
+        let result;
+        try {
+            result =
+                input.direction === 'followers'
+                    ? await getBlueskyService().getFollowers(params, ctx)
+                    : await getBlueskyService().getFollows(params, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError) {
+                const body = err.data?.responseBody ?? '';
+                if (err.data &&
+                    (body.includes('not found') || body.includes('Not Found') || body.includes('NotFound'))) {
+                    throw ctx.fail('actor_not_found', `Actor not found: "${input.actor}"`, ctx.recoveryFor('actor_not_found'));
+                }
+            }
+            throw err;
+        }
+        ctx.enrich({ totalReturned: result.actors.length });
+        if (result.actors.length === 0) {
+            ctx.enrich.notice(`No ${input.direction} found for actor "${input.actor}".`);
+        }
+        const { followersCount, followsCount, did, handle, displayName } = result.subject;
+        return {
+            actors: result.actors,
+            subject: {
+                did,
+                handle,
+                ...(displayName ? { displayName } : {}),
+                ...(followersCount != null ? { followersCount } : {}),
+                ...(followsCount != null ? { followsCount } : {}),
+            },
+            ...(result.cursor ? { cursor: result.cursor } : {}),
+        };
+    },
+    format: (result) => {
+        const subjectLabel = result.subject.displayName
+            ? `${result.subject.displayName} (@${result.subject.handle})`
+            : `@${result.subject.handle}`;
+        const header = [`## Subject: ${subjectLabel}`];
+        header.push(`**DID:** \`${result.subject.did}\``);
+        if (result.subject.followersCount != null)
+            header.push(`Followers: ${result.subject.followersCount.toLocaleString()}`);
+        if (result.subject.followsCount != null)
+            header.push(`Following: ${result.subject.followsCount.toLocaleString()}`);
+        if (result.actors.length === 0) {
+            return [{ type: 'text', text: `${header.join('\n')}\n\n*No accounts found.*` }];
+        }
+        const actorLines = result.actors.map((a) => {
+            const parts = [`### @${a.handle}`];
+            parts.push(`**DID:** \`${a.did}\``);
+            if (a.displayName)
+                parts.push(`**Name:** ${a.displayName}`);
+            if (a.description)
+                parts.push(a.description);
+            if (a.followersCount != null)
+                parts.push(`**Followers:** ${a.followersCount.toLocaleString()}`);
+            if (a.labels?.length)
+                parts.push(`**Labels:** ${a.labels.map((l) => l.val).join(', ')}`);
+            if (a.avatar)
+                parts.push(`**Avatar:** ${a.avatar}`);
+            return parts.join('\n');
+        });
+        const footer = result.cursor ? `\n\n---\n*cursor: \`${result.cursor}\`*` : '';
+        return [
+            {
+                type: 'text',
+                text: `${header.join('\n')}\n\n---\n\n${actorLines.join('\n\n')}${footer}`,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=bsky-get-follows.tool.js.map

package/dist/mcp-server/tools/definitions/bsky-get-follows.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-follows.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-follows.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtE,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,CAAC,uEAAuE,CAAC;KACrF,CAAC;SACD,QAAQ,CAAC,qBAAqB,CAAC,CACnC;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,CAAC;CAClC,CAAC;KACD,QAAQ,CAAC,sCAAsC,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,EAAE;IACrD,KAAK,EAAE,0BAA0B;IACjC,WAAW,EACT,6FAA6F;QAC7F,kGAAkG;QAClG,4FAA4F;QAC5F,kDAAkD;IACpD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,mEAAmE,CAAC;QAChF,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;aAChC,QAAQ,CACP,uGAAuG,CACxG;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC/F,OAAO,EAAE,CAAC;aACP,MAAM,CAAC;YACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACjE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACpE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC3E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC3E,CAAC;aACD,QAAQ,CAAC,uCAAuC,CAAC;QACpD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;KACzE,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,kEAAkE;YACxE,QAAQ,EAAE,kFAAkF;SAC7F;KACF;IAED,UAAU,EAAE;QACV,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC9E;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE;YAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QACF,IAAI,MAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM;gBACJ,KAAK,CAAC,SAAS,KAAK,WAAW;oBAC7B,CAAC,CAAC,MAAM,iBAAiB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC;oBACrD,CAAC,CAAC,MAAM,iBAAiB,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAI,GAAG,CAAC,IAA8C,EAAE,YAAY,IAAI,EAAE,CAAC;gBACrF,IACE,GAAG,CAAC,IAAI;oBACR,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EACvF,CAAC;oBACD,MAAM,GAAG,CAAC,IAAI,CACZ,iBAAiB,EACjB,qBAAqB,KAAK,CAAC,KAAK,GAAG,EACnC,GAAG,CAAC,WAAW,CAAC,iBAAiB,CAAC,CACnC,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,SAAS,qBAAqB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAClF,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE;gBACP,GAAG;gBACH,MAAM;gBACN,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD;YACD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW;YAC7C,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG;YAC7D,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,MAAM,GAAa,CAAC,eAAe,YAAY,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI;YACvC,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI;YACrC,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAE5E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI;gBAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzF,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;aAC3E;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-get-post-thread.tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Fetch a full Bluesky post conversation thread by AT-URI.
+ * @module mcp-server/tools/definitions/bsky-get-post-thread
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const bskyGetPostThread: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    uri: z.ZodString;
+    depth: z.ZodDefault<z.ZodNumber>;
+    parent_height: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    thread: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "invalid_at_uri";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The uri parameter is not a valid AT-URI (at://<did>/<collection>/<rkey>).";
+    readonly recovery: "AT-URIs come from the \"uri\" field of posts returned by bsky_search_posts or bsky_get_author_feed.";
+}, {
+    readonly reason: "post_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The AT-URI is valid format but the post was deleted or never existed.";
+    readonly recovery: "Verify the AT-URI or use bsky_search_posts to find the correct post.";
+}], undefined>;
+//# sourceMappingURL=bsky-get-post-thread.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bsky-get-post-thread.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-post-thread.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-post-thread.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAoD3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;cAmI5B,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-get-post-thread.tool.js

@@ -0,0 +1,166 @@
+/**
+ * @fileoverview Fetch a full Bluesky post conversation thread by AT-URI.
+ * @module mcp-server/tools/definitions/bsky-get-post-thread
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+/** @internal Recursively format a thread tree into readable markdown lines. */
+function formatThreadNode(node, depth, lines) {
+    const indent = '  '.repeat(depth);
+    if (node.notFound) {
+        lines.push(`${indent}*[Post not found or deleted]*`);
+        return;
+    }
+    if (node.truncated) {
+        lines.push(`${indent}*[More replies — use a deeper depth to load them]*`);
+        return;
+    }
+    const p = node.post;
+    const author = p.author.displayName
+        ? `${p.author.displayName} (@${p.author.handle})`
+        : `@${p.author.handle}`;
+    lines.push(`${indent}### ${author}`);
+    lines.push(`${indent}**AT-URI:** \`${p.uri}\``);
+    lines.push(`${indent}${p.text}`);
+    const meta = [];
+    if (p.likeCount != null)
+        meta.push(`${p.likeCount} likes`);
+    if (p.repostCount != null)
+        meta.push(`${p.repostCount} reposts`);
+    if (p.replyCount != null)
+        meta.push(`${p.replyCount} replies`);
+    if (meta.length)
+        lines.push(`${indent}*${meta.join(' · ')}*`);
+    if (p.createdAt)
+        lines.push(`${indent}*${p.createdAt}*`);
+    if (p.labels?.length)
+        lines.push(`${indent}**Labels:** ${p.labels.map((l) => l.val).join(', ')}`);
+    if (node.replies?.length) {
+        lines.push(`${indent}---`);
+        for (const reply of node.replies) {
+            formatThreadNode(reply, depth + 1, lines);
+        }
+    }
+}
+/**
+ * Thread node schema — uses passthrough so all post fields (uri, cid, text, author, engagement counts,
+ * createdAt, labels, embed, replyToUri) and thread structure (parent, replies, truncated, notFound)
+ * flow through structuredContent without format-parity constraints on the recursive tree shape.
+ */
+const ThreadNodeSchema = z
+    .object({})
+    .passthrough()
+    .describe('Recursive thread node. Each node has: ' +
+    'post: { uri, cid, text, author: { did, handle, displayName?, avatar? }, replyCount?, repostCount?, likeCount?, quoteCount?, indexedAt?, createdAt?, labels?, embed?, replyToUri? }. ' +
+    'parent?: parent thread node. replies?: array of child thread nodes. ' +
+    'truncated?: true when the API cut off deeper replies. notFound?: true when the post was deleted.');
+export const bskyGetPostThread = tool('bsky_get_post_thread', {
+    title: 'Get Bluesky Post Thread',
+    description: 'Fetch the full conversation for a post by AT-URI — the parent chain upward and the reply tree downward. ' +
+        'Enter the thread at any point and traverse the full discussion. ' +
+        'AT-URIs have the format "at://<did>/<collection>/<rkey>" and are returned by bsky_search_posts and ' +
+        'bsky_get_author_feed in the "uri" field of each post. ' +
+        'Returns the root post, parent chain, and nested replies with per-post author and engagement data. ' +
+        '"truncated: true" on a reply node means there are more replies below — increase depth to load them.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        uri: z
+            .string()
+            .max(2048)
+            .describe('AT-URI of the post to fetch, e.g. "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/abc123". ' +
+            'Obtain from bsky_search_posts or bsky_get_author_feed.'),
+        depth: z
+            .number()
+            .int()
+            .min(0)
+            .max(1000)
+            .default(6)
+            .describe('How many levels of replies to include in the reply tree. Default 6.'),
+        parent_height: z
+            .number()
+            .int()
+            .min(0)
+            .max(1000)
+            .default(80)
+            .describe('How many parent posts to include in the parent chain above the target post. Default 80.'),
+    }),
+    output: z.object({
+        thread: ThreadNodeSchema.describe('The conversation thread rooted at the requested post.'),
+    }),
+    errors: [
+        {
+            reason: 'invalid_at_uri',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The uri parameter is not a valid AT-URI (at://<did>/<collection>/<rkey>).',
+            recovery: 'AT-URIs come from the "uri" field of posts returned by bsky_search_posts or bsky_get_author_feed.',
+        },
+        {
+            reason: 'post_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The AT-URI is valid format but the post was deleted or never existed.',
+            recovery: 'Verify the AT-URI or use bsky_search_posts to find the correct post.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching Bluesky post thread', { uri: input.uri, depth: input.depth });
+        // Validate AT-URI format before hitting the API
+        if (!input.uri.startsWith('at://')) {
+            throw ctx.fail('invalid_at_uri', `Invalid AT-URI: "${input.uri}" must start with "at://"`, ctx.recoveryFor('invalid_at_uri'));
+        }
+        let thread;
+        try {
+            thread = await getBlueskyService().getPostThread({ uri: input.uri, depth: input.depth, parentHeight: input.parent_height }, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError) {
+                const body = err.data?.responseBody ?? '';
+                if (err.data &&
+                    (body.includes('NotFound') ||
+                        body.includes('not found') ||
+                        body.includes('Not Found') ||
+                        body.includes('Post not found'))) {
+                    throw ctx.fail('post_not_found', `Post not found: "${input.uri}"`, ctx.recoveryFor('post_not_found'));
+                }
+            }
+            throw err;
+        }
+        return { thread };
+    },
+    format: (result) => {
+        const thread = result.thread;
+        if (!thread || thread.notFound) {
+            return [{ type: 'text', text: '*Post not found or deleted.*' }];
+        }
+        const lines = ['# Thread'];
+        // Render parent chain first (walking up)
+        if (thread.parent) {
+            lines.push('## Parent chain');
+            const parents = [];
+            let cur = thread.parent;
+            while (cur) {
+                parents.unshift(cur);
+                cur = cur.parent;
+            }
+            for (const p of parents) {
+                const { replies: _r, ...pWithoutReplies } = p;
+                formatThreadNode(pWithoutReplies, 0, lines);
+                lines.push('');
+            }
+            lines.push('---');
+        }
+        lines.push('## This post');
+        const { parent: _p, ...threadWithoutParent } = thread;
+        formatThreadNode(threadWithoutParent, 0, lines);
+        if (thread.replies?.length) {
+            lines.push('');
+            lines.push('## Replies');
+            for (const reply of thread.replies) {
+                formatThreadNode(reply, 0, lines);
+                lines.push('');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=bsky-get-post-thread.tool.js.map