mcp-researchpowerpack 3.9.4 → 4.3.0

package/dist/src/tools/reddit.js

@@ -0,0 +1,277 @@
+import {
+  getRedditPostParamsSchema,
+  getRedditPostOutputSchema
+} from "../schemas/reddit.js";
+import { RedditClient } from "../clients/reddit.js";
+import { REDDIT, getCapabilities, getMissingEnvMessage, parseEnv } from "../config/index.js";
+import { classifyError } from "../utils/errors.js";
+import {
+  formatSuccess,
+  formatError,
+  formatBatchHeader
+} from "./utils.js";
+import {
+  createToolReporter,
+  NOOP_REPORTER,
+  toolFailure,
+  toolSuccess,
+  toToolResponse
+} from "./mcp-helpers.js";
+import { requireBootstrap } from "../utils/bootstrap-guard.js";
+function countWords(text) {
+  const plain = text.replace(/[*_~`#>|[\]()!-]/g, "");
+  return plain.split(/\s+/).filter((w) => w.length > 0).length;
+}
+function formatComments(comments, maxWords) {
+  let md = "";
+  let wordsUsed = 0;
+  let shown = 0;
+  for (const c of comments) {
+    const indent = "  ".repeat(c.depth);
+    const op = c.isOP ? " **[OP]**" : "";
+    const score = c.score >= 0 ? `+${c.score}` : `${c.score}`;
+    const authorLine = `${indent}- **u/${c.author}**${op} _(${score})_
+`;
+    const bodyLines = c.body.split("\n").map((line) => `${indent}  ${line}`).join("\n");
+    const commentMd = `${authorLine}${bodyLines}
+
+`;
+    const commentWords = countWords(commentMd);
+    if (wordsUsed + commentWords > maxWords && shown > 0) break;
+    md += commentMd;
+    wordsUsed += commentWords;
+    shown++;
+  }
+  return { md, wordsUsed, shown, truncated: comments.length - shown };
+}
+function formatPost(result, fetchComments, maxWords) {
+  const { post, comments } = result;
+  let md = `## ${post.title}
+
+`;
+  md += `**r/${post.subreddit}** \u2022 u/${post.author} \u2022 \u2B06\uFE0F ${post.score} \u2022 \u{1F4AC} ${post.commentCount} comments
+`;
+  md += `\u{1F517} ${post.url}
+
+`;
+  let wordsUsed = countWords(md);
+  if (post.body) {
+    const bodySection = `### Post Content
+
+${post.body}
+
+`;
+    wordsUsed += countWords(bodySection);
+    md += bodySection;
+  }
+  let commentsShown = 0;
+  let commentsTruncated = 0;
+  if (fetchComments && comments.length > 0) {
+    const remainingWords = Math.max(0, maxWords - wordsUsed);
+    const commentsResult = formatComments(comments, remainingWords);
+    commentsShown = commentsResult.shown;
+    commentsTruncated = commentsResult.truncated;
+    md += `### Top Comments (${commentsResult.shown}/${post.commentCount} shown, ${commentsResult.wordsUsed.toLocaleString()} words)
+
+`;
+    md += commentsResult.md;
+    wordsUsed += commentsResult.wordsUsed;
+    if (commentsResult.truncated > 0) {
+      md += `
+_${commentsResult.truncated} more comments not shown (word budget reached)._
+
+`;
+    }
+  }
+  return { md, wordsUsed, commentsShown, commentsTruncated };
+}
+function validatePostCount(urlCount) {
+  if (urlCount < REDDIT.MIN_POSTS) {
+    return formatError({
+      code: "MIN_POSTS",
+      message: `Minimum ${REDDIT.MIN_POSTS} Reddit posts required. Received: ${urlCount}`,
+      toolName: "get-reddit-post",
+      howToFix: [`Add at least ${REDDIT.MIN_POSTS - urlCount} more Reddit URL(s)`],
+      alternatives: [
+        `web-search(queries=["topic discussion", "topic recommendations"], extract="...", scope: "reddit") \u2014 find more Reddit post permalinks first, then call get-reddit-post with ${REDDIT.MIN_POSTS}+ URLs`
+      ]
+    });
+  }
+  if (urlCount > REDDIT.MAX_POSTS) {
+    return formatError({
+      code: "MAX_POSTS",
+      message: `Maximum ${REDDIT.MAX_POSTS} Reddit posts allowed. Received: ${urlCount}`,
+      toolName: "get-reddit-post",
+      howToFix: [`Remove ${urlCount - REDDIT.MAX_POSTS} URL(s) and retry`]
+    });
+  }
+  return null;
+}
+async function fetchAndProcessPosts(results) {
+  let failed = 0;
+  const failedContents = [];
+  const successContents = [];
+  let successful = 0;
+  let totalWordsUsed = 0;
+  const skippedUrls = [];
+  for (const [url, result] of results) {
+    if (result instanceof Error) {
+      failed++;
+      failedContents.push(`## \u274C Failed: ${url}
+
+_${result.message}_`);
+      continue;
+    }
+    if (totalWordsUsed >= REDDIT.MAX_WORDS_TOTAL) {
+      skippedUrls.push(url);
+      continue;
+    }
+    const formatted = formatPost(result, true, REDDIT.MAX_WORDS_PER_POST);
+    totalWordsUsed += formatted.wordsUsed;
+    successContents.push(formatted.md);
+    successful++;
+  }
+  const contents = [...failedContents, ...successContents];
+  return { successful, failed, llmErrors: 0, llmAvailable: false, contents, totalWordsUsed, skippedUrls };
+}
+function buildRedditStatusExtras(rateLimitHits, llmAvailable, llmErrors) {
+  const extras = [];
+  if (rateLimitHits > 0) extras.push(`\u26A0\uFE0F ${rateLimitHits} rate limit retries`);
+  if (!llmAvailable) {
+    extras.push("\u26A0\uFE0F LLM unavailable (LLM_EXTRACTION_API_KEY not set) \u2014 raw content returned");
+  } else if (llmErrors > 0) {
+    extras.push(`\u26A0\uFE0F ${llmErrors} LLM extraction failures`);
+  }
+  return extras.length > 0 ? `
+${extras.join(" | ")}` : "";
+}
+function formatRedditOutput(urls, processResult, fetchComments, totalBatches, tokensPerUrl, extraStatus) {
+  const batchHeader = formatBatchHeader({
+    title: `Reddit Posts`,
+    totalItems: urls.length,
+    successful: processResult.successful,
+    failed: processResult.failed,
+    ...fetchComments ? { extras: { "Words used": processResult.totalWordsUsed.toLocaleString() } } : {},
+    tokensPerItem: tokensPerUrl,
+    batches: totalBatches
+  });
+  let data = processResult.contents.join("\n\n---\n\n");
+  if (processResult.skippedUrls.length > 0) {
+    data += "\n\n---\n\n";
+    data += `**Word limit reached (${REDDIT.MAX_WORDS_TOTAL.toLocaleString()} words).** The following posts were not included:
+`;
+    for (const url of processResult.skippedUrls) {
+      data += `- ${url}
+`;
+    }
+    data += `
+Call get-reddit-post(urls=[...skipped URLs above...]) with just the skipped URLs.`;
+  }
+  return formatSuccess({
+    title: `Reddit Posts Fetched (${processResult.successful}/${urls.length})`,
+    summary: batchHeader + extraStatus,
+    data
+  });
+}
+function formatGetRedditPostsError(error) {
+  const structuredError = classifyError(error);
+  return formatError({
+    code: structuredError.code,
+    message: structuredError.message,
+    retryable: structuredError.retryable,
+    toolName: "get-reddit-post",
+    howToFix: ["Verify REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are set"],
+    alternatives: [
+      'web-search(queries=["topic reddit discussion", "topic reddit recommendations"], extract="reddit discussions and recommendations") \u2014 search for Reddit content via web search instead',
+      'scrape-links(urls=[...the Reddit URLs...], extract="post content | top comments | recommendations") \u2014 scrape Reddit pages directly as a fallback'
+    ]
+  });
+}
+async function handleGetRedditPosts(urls, clientId, clientSecret, reporter = NOOP_REPORTER) {
+  const startTime = Date.now();
+  try {
+    const validationError = validatePostCount(urls.length);
+    if (validationError) return toolFailure(validationError);
+    const totalBatches = Math.ceil(urls.length / REDDIT.BATCH_SIZE);
+    await reporter.log("info", `Fetching ${urls.length} Reddit post(s)`);
+    await reporter.progress(20, 100, "Fetching Reddit posts");
+    const client = new RedditClient(clientId, clientSecret);
+    const batchResult = await client.batchGetPosts(urls, true);
+    await reporter.progress(55, 100, "Formatting posts and comments");
+    const processResult = await fetchAndProcessPosts(batchResult.results);
+    await reporter.progress(85, 100, "Building output");
+    const extraStatus = buildRedditStatusExtras(
+      batchResult.rateLimitHits,
+      false,
+      0
+    );
+    const content = formatRedditOutput(
+      urls,
+      processResult,
+      true,
+      totalBatches,
+      0,
+      extraStatus
+    );
+    const executionTime = Date.now() - startTime;
+    if (processResult.successful === 0 && processResult.failed > 0) {
+      return toolFailure(content);
+    }
+    return toolSuccess(content, {
+      content,
+      metadata: {
+        total_items: urls.length,
+        successful: processResult.successful,
+        failed: processResult.failed,
+        execution_time_ms: executionTime,
+        rate_limit_hits: batchResult.rateLimitHits
+      }
+    });
+  } catch (error) {
+    return toolFailure(formatGetRedditPostsError(error));
+  }
+}
+function registerGetRedditPostTool(server) {
+  server.tool(
+    {
+      name: "get-reddit-post",
+      title: "Get Reddit Post",
+      description: "Fetch up to 100 Reddit posts with full threaded comment trees. Returns the raw post content and all comments with author, score, and OP markers.",
+      schema: getRedditPostParamsSchema,
+      outputSchema: getRedditPostOutputSchema,
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        // See contract-fixes/03 — non-standard precondition hint.
+        ...{ experimental: { requires: ["start-research"] } }
+      },
+      _meta: { requires: ["start-research"] }
+    },
+    async ({ urls }, ctx) => {
+      if (!getCapabilities().reddit) {
+        return toToolResponse(toolFailure(getMissingEnvMessage("reddit")));
+      }
+      const guard = await requireBootstrap(ctx);
+      if (guard) {
+        return guard;
+      }
+      const env = parseEnv();
+      const reporter = createToolReporter(ctx, "get-reddit-post");
+      const result = await handleGetRedditPosts(
+        urls,
+        env.REDDIT_CLIENT_ID,
+        env.REDDIT_CLIENT_SECRET,
+        reporter
+      );
+      await reporter.progress(100, 100, result.isError ? "Reddit fetch failed" : "Reddit fetch complete");
+      return toToolResponse(result);
+    }
+  );
+}
+export {
+  handleGetRedditPosts,
+  registerGetRedditPostTool
+};
+//# sourceMappingURL=reddit.js.map

package/dist/src/tools/reddit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/reddit.ts"],
+  "sourcesContent": ["/**\n * Reddit Tools \u2014 get-reddit-post\n *\n * NEVER throws - always returns structured response for graceful degradation.\n *\n * Note: search-reddit was deleted in mcp-revisions/tool-surface/01. Reddit\n * discovery now flows through `web-search` with `scope: \"reddit\"`. See\n * mcp-revisions/tool-surface/04 for the rationale on keeping\n * get-reddit-post separate (Reddit threads have a structurally different\n * response shape than HTML pages).\n */\n\nimport type { MCPServer } from 'mcp-use/server';\n\nimport {\n  getRedditPostParamsSchema,\n  getRedditPostOutputSchema,\n  type GetRedditPostOutput,\n} from '../schemas/reddit.js';\nimport { RedditClient, type PostResult, type Comment } from '../clients/reddit.js';\nimport { REDDIT, getCapabilities, getMissingEnvMessage, parseEnv } from '../config/index.js';\nimport { classifyError } from '../utils/errors.js';\nimport {\n  mcpLog,\n  formatSuccess,\n  formatError,\n  formatBatchHeader,\n} from './utils.js';\nimport {\n  createToolReporter,\n  NOOP_REPORTER,\n  toolFailure,\n  toolSuccess,\n  toToolResponse,\n  type ToolExecutionResult,\n  type ToolReporter,\n} from './mcp-helpers.js';\nimport { requireBootstrap } from '../utils/bootstrap-guard.js';\n\n// ============================================================================\n// Formatters\n// ============================================================================\n\nfunction countWords(text: string): number {\n  const plain = text.replace(/[*_~`#>|[\\]()!-]/g, '');\n  return plain.split(/\\s+/).filter(w => w.length > 0).length;\n}\n\ninterface FormattedCommentsResult {\n  md: string;\n  wordsUsed: number;\n  shown: number;\n  truncated: number;\n}\n\nfunction formatComments(comments: Comment[], maxWords: number): FormattedCommentsResult {\n  let md = '';\n  let wordsUsed = 0;\n  let shown = 0;\n\n  for (const c of comments) {\n    const indent = '  '.repeat(c.depth);\n    const op = c.isOP ? ' **[OP]**' : '';\n    const score = c.score >= 0 ? `+${c.score}` : `${c.score}`;\n    const authorLine = `${indent}- **u/${c.author}**${op} _(${score})_\\n`;\n    const bodyLines = c.body.split('\\n').map(line => `${indent}  ${line}`).join('\\n');\n    const commentMd = `${authorLine}${bodyLines}\\n\\n`;\n    const commentWords = countWords(commentMd);\n\n    if (wordsUsed + commentWords > maxWords && shown > 0) break;\n\n    md += commentMd;\n    wordsUsed += commentWords;\n    shown++;\n  }\n\n  return { md, wordsUsed, shown, truncated: comments.length - shown };\n}\n\ninterface FormattedPostResult {\n  md: string;\n  wordsUsed: number;\n  commentsShown: number;\n  commentsTruncated: number;\n}\n\nfunction formatPost(result: PostResult, fetchComments: boolean, maxWords: number): FormattedPostResult {\n  const { post, comments } = result;\n  let md = `## ${post.title}\\n\\n`;\n  md += `**r/${post.subreddit}** \u2022 u/${post.author} \u2022 \u2B06\uFE0F ${post.score} \u2022 \uD83D\uDCAC ${post.commentCount} comments\\n`;\n  md += `\uD83D\uDD17 ${post.url}\\n\\n`;\n\n  let wordsUsed = countWords(md);\n\n  if (post.body) {\n    const bodySection = `### Post Content\\n\\n${post.body}\\n\\n`;\n    wordsUsed += countWords(bodySection);\n    md += bodySection;\n  }\n\n  let commentsShown = 0;\n  let commentsTruncated = 0;\n\n  if (fetchComments && comments.length > 0) {\n    const remainingWords = Math.max(0, maxWords - wordsUsed);\n    const commentsResult = formatComments(comments, remainingWords);\n    commentsShown = commentsResult.shown;\n    commentsTruncated = commentsResult.truncated;\n\n    md += `### Top Comments (${commentsResult.shown}/${post.commentCount} shown, ${commentsResult.wordsUsed.toLocaleString()} words)\\n\\n`;\n    md += commentsResult.md;\n    wordsUsed += commentsResult.wordsUsed;\n\n    if (commentsResult.truncated > 0) {\n      md += `\\n_${commentsResult.truncated} more comments not shown (word budget reached)._\\n\\n`;\n    }\n  }\n\n  return { md, wordsUsed, commentsShown, commentsTruncated };\n}\n\n// ============================================================================\n// Get Reddit Posts Handler\n// ============================================================================\n\n// get-reddit-post no longer uses LLM \u2014 returns raw posts + comments\n\n// --- Internal types ---\n\ninterface PostProcessResult {\n  successful: number;\n  failed: number;\n  llmErrors: number;\n  llmAvailable: boolean;\n  contents: string[];\n  totalWordsUsed: number;\n  skippedUrls: string[];\n}\n\n// --- Helpers ---\n\nfunction validatePostCount(urlCount: number): string | null {\n  if (urlCount < REDDIT.MIN_POSTS) {\n    return formatError({\n      code: 'MIN_POSTS',\n      message: `Minimum ${REDDIT.MIN_POSTS} Reddit posts required. Received: ${urlCount}`,\n      toolName: 'get-reddit-post',\n      howToFix: [`Add at least ${REDDIT.MIN_POSTS - urlCount} more Reddit URL(s)`],\n      alternatives: [\n        `web-search(queries=[\"topic discussion\", \"topic recommendations\"], extract=\"...\", scope: \"reddit\") \u2014 find more Reddit post permalinks first, then call get-reddit-post with ${REDDIT.MIN_POSTS}+ URLs`,\n      ],\n    });\n  }\n  if (urlCount > REDDIT.MAX_POSTS) {\n    return formatError({\n      code: 'MAX_POSTS',\n      message: `Maximum ${REDDIT.MAX_POSTS} Reddit posts allowed. Received: ${urlCount}`,\n      toolName: 'get-reddit-post',\n      howToFix: [`Remove ${urlCount - REDDIT.MAX_POSTS} URL(s) and retry`],\n    });\n  }\n  return null;\n}\n\nasync function fetchAndProcessPosts(\n  results: Map<string, PostResult | Error>,\n): Promise<PostProcessResult> {\n  let failed = 0;\n  const failedContents: string[] = [];\n  const successContents: string[] = [];\n  let successful = 0;\n  let totalWordsUsed = 0;\n  const skippedUrls: string[] = [];\n\n  for (const [url, result] of results) {\n    if (result instanceof Error) {\n      failed++;\n      failedContents.push(`## \u274C Failed: ${url}\\n\\n_${result.message}_`);\n      continue;\n    }\n\n    if (totalWordsUsed >= REDDIT.MAX_WORDS_TOTAL) {\n      skippedUrls.push(url);\n      continue;\n    }\n\n    const formatted = formatPost(result, true, REDDIT.MAX_WORDS_PER_POST);\n    totalWordsUsed += formatted.wordsUsed;\n    successContents.push(formatted.md);\n    successful++;\n  }\n\n  const contents = [...failedContents, ...successContents];\n  return { successful, failed, llmErrors: 0, llmAvailable: false, contents, totalWordsUsed, skippedUrls };\n}\n\nfunction buildRedditStatusExtras(\n  rateLimitHits: number,\n  llmAvailable: boolean,\n  llmErrors: number,\n): string {\n  const extras: string[] = [];\n  if (rateLimitHits > 0) extras.push(`\u26A0\uFE0F ${rateLimitHits} rate limit retries`);\n  if (!llmAvailable) {\n    extras.push('\u26A0\uFE0F LLM unavailable (LLM_EXTRACTION_API_KEY not set) \u2014 raw content returned');\n  } else if (llmErrors > 0) {\n    extras.push(`\u26A0\uFE0F ${llmErrors} LLM extraction failures`);\n  }\n  return extras.length > 0 ? `\\n${extras.join(' | ')}` : '';\n}\n\nfunction formatRedditOutput(\n  urls: string[],\n  processResult: PostProcessResult,\n  fetchComments: boolean,\n  totalBatches: number,\n  tokensPerUrl: number,\n  extraStatus: string,\n): string {\n  const batchHeader = formatBatchHeader({\n    title: `Reddit Posts`,\n    totalItems: urls.length,\n    successful: processResult.successful,\n    failed: processResult.failed,\n    ...(fetchComments ? { extras: { 'Words used': processResult.totalWordsUsed.toLocaleString() } } : {}),\n    tokensPerItem: tokensPerUrl,\n    batches: totalBatches,\n  });\n\n  let data = processResult.contents.join('\\n\\n---\\n\\n');\n\n  if (processResult.skippedUrls.length > 0) {\n    data += '\\n\\n---\\n\\n';\n    data += `**Word limit reached (${REDDIT.MAX_WORDS_TOTAL.toLocaleString()} words).** The following posts were not included:\\n`;\n    for (const url of processResult.skippedUrls) {\n      data += `- ${url}\\n`;\n    }\n    data += `\\nCall get-reddit-post(urls=[...skipped URLs above...]) with just the skipped URLs.`;\n  }\n\n  // No cookie-cutter \"Next Steps\" with literal `[...]` placeholders here\n  // either. See: docs/code-review/context/07-derailment-evidence.md\n  // ([FOOTER-BAD]) and mcp-revisions/output-shaping/05.\n  return formatSuccess({\n    title: `Reddit Posts Fetched (${processResult.successful}/${urls.length})`,\n    summary: batchHeader + extraStatus,\n    data,\n  });\n}\n\nfunction formatGetRedditPostsError(error: unknown): string {\n  const structuredError = classifyError(error);\n  return formatError({\n    code: structuredError.code,\n    message: structuredError.message,\n    retryable: structuredError.retryable,\n    toolName: 'get-reddit-post',\n    howToFix: ['Verify REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are set'],\n    alternatives: [\n      'web-search(queries=[\"topic reddit discussion\", \"topic reddit recommendations\"], extract=\"reddit discussions and recommendations\") \u2014 search for Reddit content via web search instead',\n      'scrape-links(urls=[...the Reddit URLs...], extract=\"post content | top comments | recommendations\") \u2014 scrape Reddit pages directly as a fallback',\n    ],\n  });\n}\n\nexport async function handleGetRedditPosts(\n  urls: string[],\n  clientId: string,\n  clientSecret: string,\n  reporter: ToolReporter = NOOP_REPORTER,\n): Promise<ToolExecutionResult<GetRedditPostOutput>> {\n  const startTime = Date.now();\n  try {\n    const validationError = validatePostCount(urls.length);\n    if (validationError) return toolFailure(validationError);\n\n    const totalBatches = Math.ceil(urls.length / REDDIT.BATCH_SIZE);\n\n    await reporter.log('info', `Fetching ${urls.length} Reddit post(s)`);\n    await reporter.progress(20, 100, 'Fetching Reddit posts');\n    const client = new RedditClient(clientId, clientSecret);\n    const batchResult = await client.batchGetPosts(urls, true);\n    await reporter.progress(55, 100, 'Formatting posts and comments');\n\n    const processResult = await fetchAndProcessPosts(batchResult.results);\n    await reporter.progress(85, 100, 'Building output');\n\n    const extraStatus = buildRedditStatusExtras(\n      batchResult.rateLimitHits, false, 0,\n    );\n    const content = formatRedditOutput(\n      urls, processResult, true, totalBatches, 0, extraStatus,\n    );\n\n    const executionTime = Date.now() - startTime;\n\n    // Contract: zero successful posts in a non-empty batch \u2192 isError:true so\n    // callers that check response.isError can short-circuit. Partial success\n    // still resolves through toolSuccess so the agent sees both rows. See\n    // docs/code-review/context/02-current-tool-surface.md (E6).\n    if (processResult.successful === 0 && processResult.failed > 0) {\n      return toolFailure(content);\n    }\n\n    return toolSuccess(content, {\n      content,\n      metadata: {\n        total_items: urls.length,\n        successful: processResult.successful,\n        failed: processResult.failed,\n        execution_time_ms: executionTime,\n        rate_limit_hits: batchResult.rateLimitHits,\n      },\n    });\n  } catch (error) {\n    return toolFailure(formatGetRedditPostsError(error));\n  }\n}\n\nexport function registerGetRedditPostTool(server: MCPServer): void {\n  server.tool(\n    {\n      name: 'get-reddit-post',\n      title: 'Get Reddit Post',\n      description:\n        'Fetch up to 100 Reddit posts with full threaded comment trees. Returns the raw post content and all comments with author, score, and OP markers.',\n      schema: getRedditPostParamsSchema,\n      outputSchema: getRedditPostOutputSchema,\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        destructiveHint: false,\n        openWorldHint: true,\n        // See contract-fixes/03 \u2014 non-standard precondition hint.\n        ...({ experimental: { requires: ['start-research'] } } as Record<string, unknown>),\n      },\n      _meta: { requires: ['start-research'] },\n    },\n    async ({ urls }, ctx) => {\n      if (!getCapabilities().reddit) {\n        return toToolResponse(toolFailure(getMissingEnvMessage('reddit')));\n      }\n\n      const guard = await requireBootstrap(ctx);\n      if (guard) {\n        return guard;\n      }\n\n      const env = parseEnv();\n      const reporter = createToolReporter(ctx, 'get-reddit-post');\n      const result = await handleGetRedditPosts(\n        urls,\n        env.REDDIT_CLIENT_ID!,\n        env.REDDIT_CLIENT_SECRET!,\n        reporter,\n      );\n\n      await reporter.progress(100, 100, result.isError ? 'Reddit fetch failed' : 'Reddit fetch complete');\n      return toToolResponse(result);\n    },\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/registry.js

@@ -0,0 +1,18 @@
+import { registerDeepResearchPrompt } from "../prompts/deep-research.js";
+import { registerRedditSentimentPrompt } from "../prompts/reddit-sentiment.js";
+import { registerGetRedditPostTool } from "./reddit.js";
+import { registerScrapeLinksTool } from "./scrape.js";
+import { registerWebSearchTool } from "./search.js";
+import { registerStartResearchTool } from "./start-research.js";
+function registerAllTools(server) {
+  registerStartResearchTool(server);
+  registerWebSearchTool(server);
+  registerGetRedditPostTool(server);
+  registerScrapeLinksTool(server);
+  registerDeepResearchPrompt(server);
+  registerRedditSentimentPrompt(server);
+}
+export {
+  registerAllTools
+};
+//# sourceMappingURL=registry.js.map

package/dist/src/tools/registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/registry.ts"],
+  "sourcesContent": ["import type { MCPServer } from 'mcp-use/server';\n\nimport { registerDeepResearchPrompt } from '../prompts/deep-research.js';\nimport { registerRedditSentimentPrompt } from '../prompts/reddit-sentiment.js';\nimport { registerGetRedditPostTool } from './reddit.js';\nimport { registerScrapeLinksTool } from './scrape.js';\nimport { registerWebSearchTool } from './search.js';\nimport { registerStartResearchTool } from './start-research.js';\n\nexport function registerAllTools(server: MCPServer): void {\n  // Tool count is intentionally 4 \u2014 search-reddit was deleted in favor of\n  // web-search with `scope: \"reddit\"`. See:\n  //   docs/code-review/context/02-current-tool-surface.md\n  //   mcp-revisions/tool-surface/01-delete-search-reddit.md\n  //   mcp-revisions/tool-surface/02-extend-web-search-with-reddit-scope.md\n  registerStartResearchTool(server);\n  registerWebSearchTool(server);\n  registerGetRedditPostTool(server);\n  registerScrapeLinksTool(server);\n  registerDeepResearchPrompt(server);\n  registerRedditSentimentPrompt(server);\n}\n"],
+  "mappings": "AAEA,SAAS,kCAAkC;AAC3C,SAAS,qCAAqC;AAC9C,SAAS,iCAAiC;AAC1C,SAAS,+BAA+B;AACxC,SAAS,6BAA6B;AACtC,SAAS,iCAAiC;AAEnC,SAAS,iBAAiB,QAAyB;AAMxD,4BAA0B,MAAM;AAChC,wBAAsB,MAAM;AAC5B,4BAA0B,MAAM;AAChC,0BAAwB,MAAM;AAC9B,6BAA2B,MAAM;AACjC,gCAA8B,MAAM;AACtC;",
+  "names": []
+}