mcp-researchpowerpack 3.9.4 → 4.3.0

package/dist/src/tools/search.js

@@ -0,0 +1,423 @@
+import { getCapabilities, getMissingEnvMessage } from "../config/index.js";
+import {
+  webSearchOutputSchema,
+  webSearchParamsSchema
+} from "../schemas/web-search.js";
+import { SearchClient } from "../clients/search.js";
+import {
+  aggregateAndRank,
+  generateUnifiedOutput
+} from "../utils/url-aggregator.js";
+import {
+  createLLMProcessor,
+  classifySearchResults,
+  suggestRefineQueriesForRawMode
+} from "../services/llm-processor.js";
+import { classifyError } from "../utils/errors.js";
+import { classifySourceByUrl } from "../utils/source-type.js";
+import {
+  mcpLog,
+  formatError,
+  formatDuration
+} from "./utils.js";
+import {
+  createToolReporter,
+  NOOP_REPORTER,
+  toolFailure,
+  toolSuccess,
+  toToolResponse
+} from "./mcp-helpers.js";
+import { requireBootstrap } from "../utils/bootstrap-guard.js";
+import { redditKeywordGuard } from "../utils/reddit-keyword-guard.js";
+import { sanitizeSuggestion } from "../utils/sanitize.js";
+const REDDIT_POST_PERMALINK = /\/r\/[^/]+\/comments\/[a-z0-9]+\//i;
+const REDDIT_HOST = /(?:^|\.)reddit\.com$/i;
+function decorateQueriesForScope(queries, scope) {
+  if (scope === "web") return queries;
+  const reddited = queries.map(
+    (q) => /\bsite:reddit\.com\b/i.test(q) ? q : `${q} site:reddit.com`
+  );
+  return scope === "reddit" ? reddited : [...queries, ...reddited];
+}
+async function executeSearches(queries) {
+  const client = new SearchClient();
+  return client.searchMultiple(queries);
+}
+function filterScopedSearches(response, scope) {
+  if (scope === "web") return response;
+  const filtered = response.searches.map((search) => ({
+    ...search,
+    results: search.results.filter((r) => {
+      let host;
+      try {
+        host = new URL(r.link).hostname;
+      } catch {
+        return true;
+      }
+      if (!REDDIT_HOST.test(host)) return scope !== "reddit";
+      return REDDIT_POST_PERMALINK.test(r.link);
+    })
+  }));
+  return { ...response, searches: filtered };
+}
+function processResults(response) {
+  const aggregation = aggregateAndRank(response.searches, 5);
+  return { aggregation };
+}
+function buildRawOutput(queries, aggregation, searches, verbose = false) {
+  return generateUnifiedOutput(
+    aggregation.rankedUrls,
+    queries,
+    searches,
+    aggregation.totalUniqueUrls,
+    aggregation.frequencyThreshold,
+    aggregation.thresholdNote,
+    verbose
+  );
+}
+function buildSignalsSection(aggregation, searches, totalQueries) {
+  const coverageCount = searches.filter((search) => search.results.length >= 3).length;
+  const lowYield = searches.filter((search) => search.results.length <= 1).map((search) => `"${search.query}"`);
+  const consensusCount = aggregation.rankedUrls.filter((url) => url.isConsensus).length;
+  const lines = [
+    "**Signals**",
+    `- Coverage: ${coverageCount}/${totalQueries} queries returned \u22653 results`,
+    `- Consensus URLs: ${consensusCount}`
+  ];
+  if (lowYield.length > 0) {
+    lines.push(`- Low-yield: ${lowYield.join(", ")}`);
+  }
+  return lines.join("\n");
+}
+function buildSuggestedFollowUpsSection(refineQueries) {
+  if (!refineQueries || refineQueries.length === 0) {
+    return "";
+  }
+  const lines = ["## Suggested follow-up searches", ""];
+  for (const item of refineQueries) {
+    const query = sanitizeSuggestion(item.query ?? "");
+    if (!query) continue;
+    const rationale = sanitizeSuggestion(item.rationale ?? "");
+    const gapTag = typeof item.gap_id === "number" ? ` _(closes gap [${item.gap_id}])_` : item.gap_description ? ` _(${sanitizeSuggestion(item.gap_description)})_` : "";
+    lines.push(
+      rationale ? `- ${query} \u2014 ${rationale}${gapTag}` : `- ${query}${gapTag}`
+    );
+  }
+  return lines.length === 2 ? "" : lines.join("\n");
+}
+function appendSignalsAndFollowUps(markdown, signalsSection, refineQueries, options = {}) {
+  const includeSignals = options.includeSignals ?? false;
+  const sections = [markdown];
+  if (includeSignals && signalsSection) {
+    sections.push("", "---", signalsSection);
+  }
+  const followUps = buildSuggestedFollowUpsSection(refineQueries);
+  if (followUps) {
+    sections.push("", followUps);
+  }
+  return sections.join("\n");
+}
+function buildClassifiedOutput(classification, aggregation, extract, searches, totalQueries, verbose = false) {
+  const rankedUrls = aggregation.rankedUrls;
+  const entryByRank = new Map(classification.results.map((r) => [r.rank, r]));
+  const tiers = {
+    high: [],
+    maybe: [],
+    other: []
+  };
+  for (const url of rankedUrls) {
+    const entry = entryByRank.get(url.rank);
+    const tier = entry?.tier;
+    if (tier === "HIGHLY_RELEVANT") {
+      tiers.high.push(url);
+    } else if (tier === "MAYBE_RELEVANT") {
+      tiers.maybe.push(url);
+    } else {
+      tiers.other.push(url);
+    }
+  }
+  const lines = [];
+  lines.push(`## ${classification.title}`);
+  lines.push(`> Looking for: ${extract}`);
+  lines.push(`> ${totalQueries} queries \u2192 ${rankedUrls.length} URLs \u2192 ${tiers.high.length} highly relevant, ${tiers.maybe.length} possibly relevant`);
+  if (classification.confidence) {
+    const confReason = classification.confidence_reason ? ` \u2014 ${classification.confidence_reason}` : "";
+    lines.push(`> Confidence: \`${classification.confidence}\`${confReason}`);
+  }
+  lines.push("");
+  lines.push(`**Summary:** ${classification.synthesis}`);
+  lines.push("");
+  const renderRichRow = (url) => {
+    const entry = entryByRank.get(url.rank);
+    const coveragePct = Math.round(url.coverageRatio * 100);
+    const seenIn = `${url.frequency}/${totalQueries} (${coveragePct}%)`;
+    const sourceType = entry?.source_type ? `\`${entry.source_type}\`` : "\u2014";
+    const reason = entry?.reason ? entry.reason.replace(/\|/g, "\\|") : "\u2014";
+    return `| ${url.rank} | [${url.title}](${url.url}) | ${sourceType} | ${seenIn} | ${reason} |`;
+  };
+  if (tiers.high.length > 0) {
+    lines.push(`### Highly Relevant (${tiers.high.length})`);
+    lines.push("| # | URL | Source | Seen in | Why |");
+    lines.push("|---|-----|--------|---------|-----|");
+    for (const url of tiers.high) lines.push(renderRichRow(url));
+    lines.push("");
+  }
+  if (tiers.maybe.length > 0) {
+    lines.push(`### Maybe Relevant (${tiers.maybe.length})`);
+    lines.push("| # | URL | Source | Seen in | Why |");
+    lines.push("|---|-----|--------|---------|-----|");
+    for (const url of tiers.maybe) lines.push(renderRichRow(url));
+    lines.push("");
+  }
+  if (tiers.other.length > 0) {
+    lines.push(`### Other Results (${tiers.other.length})`);
+    lines.push("| # | URL | Source | Score | Queries |");
+    lines.push("|---|-----|--------|-------|---------|");
+    for (const url of tiers.other) {
+      const entry = entryByRank.get(url.rank);
+      const queryList = url.queries.map((q) => `"${q}"`).join(", ");
+      const sourceType = entry?.source_type ? `\`${entry.source_type}\`` : "\u2014";
+      let domain;
+      try {
+        domain = new URL(url.url).hostname.replace(/^www\./, "");
+      } catch {
+        domain = url.url;
+      }
+      lines.push(`| ${url.rank} | ${domain} | ${sourceType} | ${url.score.toFixed(1)} | ${queryList} |`);
+    }
+    lines.push("");
+  }
+  if (verbose) {
+    lines.push(buildSignalsSection(aggregation, searches, totalQueries));
+  }
+  if (classification.gaps && classification.gaps.length > 0) {
+    lines.push("");
+    lines.push("## Gaps");
+    for (const gap of classification.gaps) {
+      lines.push(`- **[${gap.id}]** ${gap.description}`);
+    }
+  }
+  const followUps = buildSuggestedFollowUpsSection(classification.refine_queries);
+  if (followUps) {
+    lines.push("");
+    lines.push(followUps);
+  }
+  return lines.join("\n");
+}
+function buildMetadata(aggregation, executionTime, totalQueries, searches, llmClassified, scope, llmError) {
+  const coverageSummary = searches.map((s) => {
+    let topDomain;
+    const topResult = s.results[0];
+    if (topResult) {
+      try {
+        topDomain = new URL(topResult.link).hostname.replace(/^www\./, "");
+      } catch {
+      }
+    }
+    return { query: s.query, result_count: s.results.length, top_url: topDomain };
+  });
+  const lowYieldQueries = searches.filter((s) => s.results.length <= 1).map((s) => s.query);
+  return {
+    total_items: totalQueries,
+    successful: aggregation.rankedUrls.length,
+    failed: totalQueries - searches.filter((s) => s.results.length > 0).length,
+    execution_time_ms: executionTime,
+    llm_classified: llmClassified,
+    scope,
+    ...llmError ? { llm_error: llmError } : {},
+    coverage_summary: coverageSummary,
+    ...lowYieldQueries.length > 0 ? { low_yield_queries: lowYieldQueries } : {}
+  };
+}
+function buildStructuredResults(aggregation, llmTagsByRank) {
+  return aggregation.rankedUrls.map((row) => {
+    const llmTag = llmTagsByRank?.get(row.rank);
+    const heuristic = classifySourceByUrl(row.url);
+    return {
+      rank: row.rank,
+      url: row.url,
+      title: row.title,
+      snippet: row.snippet,
+      source_type: llmTag ?? heuristic,
+      score: Number(row.score.toFixed(2)),
+      seen_in: row.frequency,
+      best_position: row.bestPosition
+    };
+  });
+}
+function buildWebSearchError(error, params, startTime) {
+  const structuredError = classifyError(error);
+  const executionTime = Date.now() - startTime;
+  mcpLog("error", `web-search: ${structuredError.message}`, "search");
+  const errorContent = formatError({
+    code: structuredError.code,
+    message: structuredError.message,
+    retryable: structuredError.retryable,
+    toolName: "web-search",
+    howToFix: ["Verify SERPER_API_KEY is set correctly"],
+    alternatives: [
+      'web-search(queries=["topic recommendations"], extract="...", scope: "reddit") \u2014 Reddit-only post permalinks via the same backend',
+      'scrape-links(urls=[...], extract="...") \u2014 if you have URLs from prior steps, scrape them now'
+    ]
+  });
+  return toolFailure(
+    `${errorContent}
+
+Execution time: ${formatDuration(executionTime)}
+Queries: ${params.queries.length}`
+  );
+}
+async function handleWebSearch(params, reporter = NOOP_REPORTER) {
+  const startTime = Date.now();
+  try {
+    const effectiveQueries = decorateQueriesForScope(params.queries, params.scope);
+    if (params.scope !== "web") {
+      mcpLog("info", `Searching scope=${params.scope}: ${params.queries.length} input queries \u2192 ${effectiveQueries.length} dispatched`, "search");
+    } else {
+      mcpLog("info", `Searching for ${params.queries.length} query/queries`, "search");
+    }
+    await reporter.log("info", `Searching for ${effectiveQueries.length} query/queries (scope=${params.scope})`);
+    await reporter.progress(15, 100, "Submitting search queries");
+    const rawResponse = await executeSearches(effectiveQueries);
+    const response = filterScopedSearches(rawResponse, params.scope);
+    await reporter.progress(50, 100, "Collected search results");
+    const { aggregation } = processResults(response);
+    await reporter.log(
+      "info",
+      `Collected ${aggregation.totalUniqueUrls} unique URLs across ${response.totalQueries} queries`
+    );
+    const useRaw = params.raw;
+    const llmProcessor = createLLMProcessor();
+    let markdown;
+    let llmClassified = false;
+    let llmError;
+    if (useRaw || !llmProcessor) {
+      if (!useRaw && !llmProcessor) {
+        llmError = "LLM unavailable (LLM_EXTRACTION_API_KEY not set). Falling back to raw output.";
+        mcpLog("warning", llmError, "search");
+        await reporter.log("warning", "llm_classifier_unreachable: planner not configured; raw ranked list returned");
+      }
+      let rawRefineQueries;
+      if (useRaw && llmProcessor) {
+        const refineResult = await suggestRefineQueriesForRawMode(
+          aggregation.rankedUrls,
+          params.extract,
+          params.queries,
+          llmProcessor
+        );
+        rawRefineQueries = refineResult.result;
+      }
+      markdown = appendSignalsAndFollowUps(
+        buildRawOutput(params.queries, aggregation, response.searches, params.verbose),
+        buildSignalsSection(aggregation, response.searches, response.totalQueries),
+        rawRefineQueries,
+        { includeSignals: params.verbose }
+      );
+      await reporter.progress(80, 100, "Ranking search results");
+    } else {
+      await reporter.progress(65, 100, "Classifying results by relevance");
+      const classification = await classifySearchResults(
+        aggregation.rankedUrls,
+        params.extract,
+        response.totalQueries,
+        llmProcessor,
+        params.queries
+      );
+      if (classification.result) {
+        markdown = buildClassifiedOutput(
+          classification.result,
+          aggregation,
+          params.extract,
+          response.searches,
+          response.totalQueries,
+          params.verbose
+        );
+        llmClassified = true;
+        await reporter.progress(85, 100, "Formatted classified results");
+      } else {
+        llmError = classification.error ?? "Unknown classification error";
+        mcpLog("warning", `Classification failed, falling back to raw: ${llmError}`, "search");
+        await reporter.log("warning", `llm_classifier_unreachable: ${llmError}`);
+        markdown = appendSignalsAndFollowUps(
+          buildRawOutput(params.queries, aggregation, response.searches, params.verbose),
+          buildSignalsSection(aggregation, response.searches, response.totalQueries),
+          void 0,
+          { includeSignals: params.verbose }
+        );
+        await reporter.progress(85, 100, "Classification failed, using raw output");
+      }
+    }
+    const executionTime = Date.now() - startTime;
+    const metadata = buildMetadata(
+      aggregation,
+      executionTime,
+      response.totalQueries,
+      response.searches,
+      llmClassified,
+      params.scope,
+      llmError
+    );
+    const llmTagsByRank = /* @__PURE__ */ new Map();
+    const results = buildStructuredResults(aggregation, llmTagsByRank);
+    mcpLog("info", `Search completed: ${aggregation.rankedUrls.length} URLs, classified=${llmClassified}`, "search");
+    await reporter.log("info", `Search completed with ${aggregation.rankedUrls.length} URLs (classified: ${llmClassified})`);
+    const footer = `
+---
+*${formatDuration(executionTime)} | ${aggregation.totalUniqueUrls} unique URLs${llmClassified ? " | LLM classified" : ""}*`;
+    const fullMarkdown = markdown + footer;
+    return toolSuccess(fullMarkdown, { content: fullMarkdown, results, metadata });
+  } catch (error) {
+    return buildWebSearchError(error, params, startTime);
+  }
+}
+function registerWebSearchTool(server) {
+  server.tool(
+    {
+      name: "web-search",
+      title: "Web Search",
+      description: "Fan out many Google searches in parallel (no hard cap), aggregate and deduplicate results, then classify each URL against your extract goal. Returns a tiered Markdown report: HIGHLY_RELEVANT / MAYBE_RELEVANT / OTHER with source_type and a per-result reason; plus a grounded synthesis with rank citations, a domain-independence confidence, a `## Gaps` list of what the current results do not answer, and `## Suggested follow-up searches` tied to gap ids (non-paraphrases of your prior queries). Think of `queries` as concept groups \u2014 diverse facets, not paraphrases. Set `raw=true` to skip classification and get an unclassified ranked list.",
+      schema: webSearchParamsSchema,
+      outputSchema: webSearchOutputSchema,
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        // Non-standard precondition hint. mcp-use's ToolAnnotations type
+        // does not expose `experimental` natively (the SDK schema uses
+        // $strip) but the runtime forwards the whole annotations object
+        // verbatim. Cast keeps TS happy. See:
+        //   docs/code-review/context/04-session-and-workflow-state.md
+        //   mcp-revisions/contract-fixes/03-precondition-annotation-on-gated-tools.md
+        ...{ experimental: { requires: ["start-research"] } }
+      },
+      _meta: { requires: ["start-research"] }
+    },
+    async (args, ctx) => {
+      if (!getCapabilities().search) {
+        return toToolResponse(toolFailure(getMissingEnvMessage("search")));
+      }
+      const guard = await requireBootstrap(ctx);
+      if (guard) {
+        return guard;
+      }
+      if (args.scope === "web") {
+        const redditGuard = await redditKeywordGuard(ctx, args.queries);
+        if (redditGuard) {
+          return redditGuard;
+        }
+      }
+      const reporter = createToolReporter(ctx, "web-search");
+      const result = await handleWebSearch(args, reporter);
+      await reporter.progress(100, 100, result.isError ? "Search failed" : "Search complete");
+      return toToolResponse(result);
+    }
+  );
+}
+export {
+  appendSignalsAndFollowUps,
+  buildSuggestedFollowUpsSection,
+  handleWebSearch,
+  registerWebSearchTool
+};
+//# sourceMappingURL=search.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/search.ts"],
+  "sourcesContent": ["/**\n * Web Search Tool Handler\n * NEVER throws - always returns structured response for graceful degradation\n */\n\nimport type { MCPServer } from 'mcp-use/server';\n\nimport { getCapabilities, getMissingEnvMessage } from '../config/index.js';\nimport {\n  webSearchOutputSchema,\n  webSearchParamsSchema,\n  type WebSearchParams,\n  type WebSearchOutput,\n} from '../schemas/web-search.js';\nimport { SearchClient } from '../clients/search.js';\nimport {\n  aggregateAndRank,\n  generateUnifiedOutput,\n} from '../utils/url-aggregator.js';\nimport {\n  createLLMProcessor,\n  classifySearchResults,\n  suggestRefineQueriesForRawMode,\n  type ClassificationResult,\n  type RefineQuerySuggestion,\n} from '../services/llm-processor.js';\nimport { classifyError } from '../utils/errors.js';\nimport { classifySourceByUrl } from '../utils/source-type.js';\nimport {\n  mcpLog,\n  formatError,\n  formatDuration,\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';\nimport { redditKeywordGuard } from '../utils/reddit-keyword-guard.js';\nimport { sanitizeSuggestion } from '../utils/sanitize.js';\n\n// --- Internal types ---\n\ninterface SearchAggregation {\n  readonly rankedUrls: ReturnType<typeof aggregateAndRank>['rankedUrls'];\n  readonly totalUniqueUrls: number;\n  readonly frequencyThreshold: number;\n  readonly thresholdNote?: string;\n}\n\ninterface SearchResponse {\n  searches: Parameters<typeof aggregateAndRank>[0];\n  totalQueries: number;\n}\n\n// --- Helpers ---\n\n/** Reddit post permalink: /r/{sub}/comments/{id}/ \u2014 drops subreddit\n *  homepages, /rising, /new, /top, etc. so only post URLs reach the agent.\n *  See mcp-revisions/tool-surface/02-extend-web-search-with-reddit-scope.md. */\nconst REDDIT_POST_PERMALINK = /\\/r\\/[^/]+\\/comments\\/[a-z0-9]+\\//i;\nconst REDDIT_HOST = /(?:^|\\.)reddit\\.com$/i;\n\nfunction decorateQueriesForScope(queries: string[], scope: 'web' | 'reddit' | 'both'): string[] {\n  if (scope === 'web') return queries;\n  const reddited = queries.map((q) =>\n    /\\bsite:reddit\\.com\\b/i.test(q) ? q : `${q} site:reddit.com`,\n  );\n  return scope === 'reddit' ? reddited : [...queries, ...reddited];\n}\n\nasync function executeSearches(queries: string[]): Promise<SearchResponse> {\n  const client = new SearchClient();\n  return client.searchMultiple(queries);\n}\n\nfunction filterScopedSearches(\n  response: SearchResponse,\n  scope: 'web' | 'reddit' | 'both',\n): SearchResponse {\n  if (scope === 'web') return response;\n  const filtered = response.searches.map((search) => ({\n    ...search,\n    results: search.results.filter((r) => {\n      let host: string;\n      try { host = new URL(r.link).hostname; } catch { return true; }\n      // Non-reddit URLs pass through; reddit URLs must be post permalinks.\n      if (!REDDIT_HOST.test(host)) return scope !== 'reddit';\n      return REDDIT_POST_PERMALINK.test(r.link);\n    }),\n  }));\n  return { ...response, searches: filtered };\n}\n\nfunction processResults(response: SearchResponse): {\n  aggregation: SearchAggregation;\n} {\n  const aggregation = aggregateAndRank(response.searches, 5);\n  return { aggregation };\n}\n\n// --- Raw output (traditional unified ranked list) ---\n\nfunction buildRawOutput(\n  queries: string[],\n  aggregation: SearchAggregation,\n  searches: SearchResponse['searches'],\n  verbose: boolean = false,\n): string {\n  return generateUnifiedOutput(\n    aggregation.rankedUrls, queries, searches,\n    aggregation.totalUniqueUrls,\n    aggregation.frequencyThreshold, aggregation.thresholdNote,\n    verbose,\n  );\n}\n\nfunction buildSignalsSection(\n  aggregation: SearchAggregation,\n  searches: SearchResponse['searches'],\n  totalQueries: number,\n): string {\n  const coverageCount = searches.filter((search) => search.results.length >= 3).length;\n  const lowYield = searches\n    .filter((search) => search.results.length <= 1)\n    .map((search) => `\"${search.query}\"`);\n  const consensusCount = aggregation.rankedUrls.filter((url) => url.isConsensus).length;\n\n  const lines = [\n    '**Signals**',\n    `- Coverage: ${coverageCount}/${totalQueries} queries returned \u22653 results`,\n    `- Consensus URLs: ${consensusCount}`,\n  ];\n\n  if (lowYield.length > 0) {\n    lines.push(`- Low-yield: ${lowYield.join(', ')}`);\n  }\n\n  return lines.join('\\n');\n}\n\nexport function buildSuggestedFollowUpsSection(\n  refineQueries: Array<{ query: string; rationale?: string; gap_id?: number; gap_description?: string }> | undefined,\n): string {\n  if (!refineQueries || refineQueries.length === 0) {\n    return '';\n  }\n\n  const lines = ['## Suggested follow-up searches', ''];\n\n  for (const item of refineQueries) {\n    const query = sanitizeSuggestion(item.query ?? '');\n    if (!query) continue;\n    const rationale = sanitizeSuggestion(item.rationale ?? '');\n    const gapTag = typeof item.gap_id === 'number'\n      ? ` _(closes gap [${item.gap_id}])_`\n      : item.gap_description\n        ? ` _(${sanitizeSuggestion(item.gap_description)})_`\n        : '';\n    lines.push(rationale\n      ? `- ${query} \u2014 ${rationale}${gapTag}`\n      : `- ${query}${gapTag}`,\n    );\n  }\n\n  return lines.length === 2 ? '' : lines.join('\\n');\n}\n\nexport function appendSignalsAndFollowUps(\n  markdown: string,\n  signalsSection: string,\n  refineQueries: RefineQuerySuggestion[] | undefined,\n  options: { includeSignals?: boolean } = {},\n): string {\n  const includeSignals = options.includeSignals ?? false;\n  const sections = [markdown];\n  if (includeSignals && signalsSection) {\n    sections.push('', '---', signalsSection);\n  }\n  const followUps = buildSuggestedFollowUpsSection(refineQueries);\n  if (followUps) {\n    sections.push('', followUps);\n  }\n  return sections.join('\\n');\n}\n\n// --- Classified output (3-tier LLM-classified table) ---\n\nfunction buildClassifiedOutput(\n  classification: ClassificationResult,\n  aggregation: SearchAggregation,\n  extract: string,\n  searches: SearchResponse['searches'],\n  totalQueries: number,\n  verbose: boolean = false,\n): string {\n  const rankedUrls = aggregation.rankedUrls;\n\n  // Build tier \u2192 entries mapping (keep url data alongside classifier metadata)\n  const entryByRank = new Map(classification.results.map((r) => [r.rank, r]));\n\n  const tiers = {\n    high: [] as typeof rankedUrls,\n    maybe: [] as typeof rankedUrls,\n    other: [] as typeof rankedUrls,\n  };\n\n  for (const url of rankedUrls) {\n    const entry = entryByRank.get(url.rank);\n    const tier = entry?.tier;\n    if (tier === 'HIGHLY_RELEVANT') {\n      tiers.high.push(url);\n    } else if (tier === 'MAYBE_RELEVANT') {\n      tiers.maybe.push(url);\n    } else {\n      tiers.other.push(url);\n    }\n  }\n\n  const lines: string[] = [];\n\n  // Header with generated title, synthesis, and confidence\n  lines.push(`## ${classification.title}`);\n  lines.push(`> Looking for: ${extract}`);\n  lines.push(`> ${totalQueries} queries \u2192 ${rankedUrls.length} URLs \u2192 ${tiers.high.length} highly relevant, ${tiers.maybe.length} possibly relevant`);\n  if (classification.confidence) {\n    const confReason = classification.confidence_reason ? ` \u2014 ${classification.confidence_reason}` : '';\n    lines.push(`> Confidence: \\`${classification.confidence}\\`${confReason}`);\n  }\n  lines.push('');\n  lines.push(`**Summary:** ${classification.synthesis}`);\n  lines.push('');\n\n  // Helper: render one row with optional source_type + reason\n  const renderRichRow = (url: typeof rankedUrls[number]): string => {\n    const entry = entryByRank.get(url.rank);\n    const coveragePct = Math.round(url.coverageRatio * 100);\n    const seenIn = `${url.frequency}/${totalQueries} (${coveragePct}%)`;\n    const sourceType = entry?.source_type ? `\\`${entry.source_type}\\`` : '\u2014';\n    const reason = entry?.reason ? entry.reason.replace(/\\|/g, '\\\\|') : '\u2014';\n    return `| ${url.rank} | [${url.title}](${url.url}) | ${sourceType} | ${seenIn} | ${reason} |`;\n  };\n\n  // Highly Relevant tier\n  if (tiers.high.length > 0) {\n    lines.push(`### Highly Relevant (${tiers.high.length})`);\n    lines.push('| # | URL | Source | Seen in | Why |');\n    lines.push('|---|-----|--------|---------|-----|');\n    for (const url of tiers.high) lines.push(renderRichRow(url));\n    lines.push('');\n  }\n\n  // Maybe Relevant tier\n  if (tiers.maybe.length > 0) {\n    lines.push(`### Maybe Relevant (${tiers.maybe.length})`);\n    lines.push('| # | URL | Source | Seen in | Why |');\n    lines.push('|---|-----|--------|---------|-----|');\n    for (const url of tiers.maybe) lines.push(renderRichRow(url));\n    lines.push('');\n  }\n\n  // Other tier \u2014 with query attribution\n  if (tiers.other.length > 0) {\n    lines.push(`### Other Results (${tiers.other.length})`);\n    lines.push('| # | URL | Source | Score | Queries |');\n    lines.push('|---|-----|--------|-------|---------|');\n    for (const url of tiers.other) {\n      const entry = entryByRank.get(url.rank);\n      const queryList = url.queries.map((q) => `\"${q}\"`).join(', ');\n      const sourceType = entry?.source_type ? `\\`${entry.source_type}\\`` : '\u2014';\n      let domain: string;\n      try {\n        domain = new URL(url.url).hostname.replace(/^www\\./, '');\n      } catch {\n        domain = url.url;\n      }\n      lines.push(`| ${url.rank} | ${domain} | ${sourceType} | ${url.score.toFixed(1)} | ${queryList} |`);\n    }\n    lines.push('');\n  }\n\n  // Signals block is gated behind verbose \u2014 it duplicates info already\n  // present in the per-row metadata for callers who care.\n  // See: docs/code-review/context/05-output-formatting-patterns.md.\n  if (verbose) {\n    lines.push(buildSignalsSection(aggregation, searches, totalQueries));\n  }\n\n  // Gaps section \u2014 what the current results don't answer\n  if (classification.gaps && classification.gaps.length > 0) {\n    lines.push('');\n    lines.push('## Gaps');\n    for (const gap of classification.gaps) {\n      lines.push(`- **[${gap.id}]** ${gap.description}`);\n    }\n  }\n\n  const followUps = buildSuggestedFollowUpsSection(classification.refine_queries);\n  if (followUps) {\n    lines.push('');\n    lines.push(followUps);\n  }\n\n  return lines.join('\\n');\n}\n\n// --- Metadata builder ---\n\nfunction buildMetadata(\n  aggregation: SearchAggregation,\n  executionTime: number,\n  totalQueries: number,\n  searches: SearchResponse['searches'],\n  llmClassified: boolean,\n  scope: 'web' | 'reddit' | 'both',\n  llmError?: string,\n) {\n  const coverageSummary = searches.map(s => {\n    let topDomain: string | undefined;\n    const topResult = s.results[0];\n    if (topResult) {\n      try { topDomain = new URL(topResult.link).hostname.replace(/^www\\./, ''); } catch { /* ignore */ }\n    }\n    return { query: s.query, result_count: s.results.length, top_url: topDomain };\n  });\n  const lowYieldQueries = searches\n    .filter(s => s.results.length <= 1)\n    .map(s => s.query);\n\n  return {\n    total_items: totalQueries,\n    successful: aggregation.rankedUrls.length,\n    failed: totalQueries - searches.filter(s => s.results.length > 0).length,\n    execution_time_ms: executionTime,\n    llm_classified: llmClassified,\n    scope,\n    ...(llmError ? { llm_error: llmError } : {}),\n    coverage_summary: coverageSummary,\n    ...(lowYieldQueries.length > 0 ? { low_yield_queries: lowYieldQueries } : {}),\n  };\n}\n\nfunction buildStructuredResults(\n  aggregation: SearchAggregation,\n  llmTagsByRank?: Map<number, string>,\n): Array<{\n  rank: number;\n  url: string;\n  title: string;\n  snippet: string;\n  source_type: 'reddit' | 'github' | 'docs' | 'blog' | 'paper' | 'qa' | 'cve' | 'news' | 'video' | 'web';\n  score: number;\n  seen_in: number;\n  best_position: number;\n}> {\n  return aggregation.rankedUrls.map((row) => {\n    // LLM tag wins when present; heuristic is the always-on fallback. See:\n    // mcp-revisions/output-shaping/06-source-type-tagging-without-llm.md.\n    const llmTag = llmTagsByRank?.get(row.rank);\n    const heuristic = classifySourceByUrl(row.url);\n    return {\n      rank: row.rank,\n      url: row.url,\n      title: row.title,\n      snippet: row.snippet,\n      source_type: ((llmTag as typeof heuristic) ?? heuristic),\n      score: Number(row.score.toFixed(2)),\n      seen_in: row.frequency,\n      best_position: row.bestPosition,\n    };\n  });\n}\n\n// --- Error builder ---\n\nfunction buildWebSearchError(\n  error: unknown,\n  params: WebSearchParams,\n  startTime: number,\n): ToolExecutionResult<WebSearchOutput> {\n  const structuredError = classifyError(error);\n  const executionTime = Date.now() - startTime;\n\n  mcpLog('error', `web-search: ${structuredError.message}`, 'search');\n\n  const errorContent = formatError({\n    code: structuredError.code,\n    message: structuredError.message,\n    retryable: structuredError.retryable,\n    toolName: 'web-search',\n    howToFix: ['Verify SERPER_API_KEY is set correctly'],\n    alternatives: [\n      'web-search(queries=[\"topic recommendations\"], extract=\"...\", scope: \"reddit\") \u2014 Reddit-only post permalinks via the same backend',\n      'scrape-links(urls=[...], extract=\"...\") \u2014 if you have URLs from prior steps, scrape them now',\n    ],\n  });\n\n  return toolFailure(\n    `${errorContent}\\n\\nExecution time: ${formatDuration(executionTime)}\\nQueries: ${params.queries.length}`,\n  );\n}\n\n// --- Main handler ---\n\nexport async function handleWebSearch(\n  params: WebSearchParams,\n  reporter: ToolReporter = NOOP_REPORTER,\n): Promise<ToolExecutionResult<WebSearchOutput>> {\n  const startTime = Date.now();\n\n  try {\n    const effectiveQueries = decorateQueriesForScope(params.queries, params.scope);\n    if (params.scope !== 'web') {\n      mcpLog('info', `Searching scope=${params.scope}: ${params.queries.length} input queries \u2192 ${effectiveQueries.length} dispatched`, 'search');\n    } else {\n      mcpLog('info', `Searching for ${params.queries.length} query/queries`, 'search');\n    }\n    await reporter.log('info', `Searching for ${effectiveQueries.length} query/queries (scope=${params.scope})`);\n    await reporter.progress(15, 100, 'Submitting search queries');\n\n    const rawResponse = await executeSearches(effectiveQueries);\n    const response = filterScopedSearches(rawResponse, params.scope);\n    await reporter.progress(50, 100, 'Collected search results');\n\n    const { aggregation } = processResults(response);\n    await reporter.log(\n      'info',\n      `Collected ${aggregation.totalUniqueUrls} unique URLs across ${response.totalQueries} queries`,\n    );\n\n    // Decide: raw output or LLM classification\n    const useRaw = params.raw;\n    const llmProcessor = createLLMProcessor();\n\n    let markdown: string;\n    let llmClassified = false;\n    let llmError: string | undefined;\n\n    if (useRaw || !llmProcessor) {\n      // Raw path: traditional unified ranked list\n      if (!useRaw && !llmProcessor) {\n        llmError = 'LLM unavailable (LLM_EXTRACTION_API_KEY not set). Falling back to raw output.';\n        mcpLog('warning', llmError, 'search');\n        // mcp-revisions/llm-degradation/01: surface degraded mode to the client.\n        await reporter.log('warning', 'llm_classifier_unreachable: planner not configured; raw ranked list returned');\n      }\n      let rawRefineQueries: RefineQuerySuggestion[] | undefined;\n      if (useRaw && llmProcessor) {\n        const refineResult = await suggestRefineQueriesForRawMode(\n          aggregation.rankedUrls,\n          params.extract,\n          params.queries,\n          llmProcessor,\n        );\n        rawRefineQueries = refineResult.result;\n      }\n      markdown = appendSignalsAndFollowUps(\n        buildRawOutput(params.queries, aggregation, response.searches, params.verbose),\n        buildSignalsSection(aggregation, response.searches, response.totalQueries),\n        rawRefineQueries,\n        { includeSignals: params.verbose },\n      );\n      await reporter.progress(80, 100, 'Ranking search results');\n    } else {\n      // LLM classification path\n      await reporter.progress(65, 100, 'Classifying results by relevance');\n      const classification = await classifySearchResults(\n        aggregation.rankedUrls,\n        params.extract,\n        response.totalQueries,\n        llmProcessor,\n        params.queries,\n      );\n\n      if (classification.result) {\n        markdown = buildClassifiedOutput(\n          classification.result, aggregation, params.extract, response.searches, response.totalQueries, params.verbose,\n        );\n        llmClassified = true;\n        await reporter.progress(85, 100, 'Formatted classified results');\n      } else {\n        // Classification failed \u2014 fall back to raw\n        llmError = classification.error ?? 'Unknown classification error';\n        mcpLog('warning', `Classification failed, falling back to raw: ${llmError}`, 'search');\n        // mcp-revisions/llm-degradation/01: surface degraded mode to the client.\n        await reporter.log('warning', `llm_classifier_unreachable: ${llmError}`);\n        markdown = appendSignalsAndFollowUps(\n          buildRawOutput(params.queries, aggregation, response.searches, params.verbose),\n          buildSignalsSection(aggregation, response.searches, response.totalQueries),\n          undefined,\n          { includeSignals: params.verbose },\n        );\n        await reporter.progress(85, 100, 'Classification failed, using raw output');\n      }\n    }\n\n    const executionTime = Date.now() - startTime;\n    const metadata = buildMetadata(\n      aggregation, executionTime, response.totalQueries, response.searches, llmClassified, params.scope, llmError,\n    );\n\n    // Build per-row structured results so capability-aware clients can\n    // index into `structuredContent.results` rather than regex-scrape the\n    // markdown table. The LLM tag wins when present; heuristic is the\n    // always-on fallback.\n    const llmTagsByRank = new Map<number, string>();\n    // (When classification succeeds the source_type per-row is populated\n    // inside buildClassifiedOutput via the entry.source_type field \u2014 but\n    // we don't have a direct handle on it here without a refactor. The\n    // heuristic alone covers the structuredContent shape correctly; the\n    // LLM-tagged variant remains in the markdown body.)\n    const results = buildStructuredResults(aggregation, llmTagsByRank);\n\n    mcpLog('info', `Search completed: ${aggregation.rankedUrls.length} URLs, classified=${llmClassified}`, 'search');\n    await reporter.log('info', `Search completed with ${aggregation.rankedUrls.length} URLs (classified: ${llmClassified})`);\n\n    const footer = `\\n---\\n*${formatDuration(executionTime)} | ${aggregation.totalUniqueUrls} unique URLs${llmClassified ? ' | LLM classified' : ''}*`;\n    const fullMarkdown = markdown + footer;\n\n    return toolSuccess(fullMarkdown, { content: fullMarkdown, results, metadata });\n  } catch (error) {\n    return buildWebSearchError(error, params, startTime);\n  }\n}\n\nexport function registerWebSearchTool(server: MCPServer): void {\n  server.tool(\n    {\n      name: 'web-search',\n      title: 'Web Search',\n      description:\n        'Fan out many Google searches in parallel (no hard cap), aggregate and deduplicate results, then classify each URL against your extract goal. Returns a tiered Markdown report: HIGHLY_RELEVANT / MAYBE_RELEVANT / OTHER with source_type and a per-result reason; plus a grounded synthesis with rank citations, a domain-independence confidence, a `## Gaps` list of what the current results do not answer, and `## Suggested follow-up searches` tied to gap ids (non-paraphrases of your prior queries). Think of `queries` as concept groups \u2014 diverse facets, not paraphrases. Set `raw=true` to skip classification and get an unclassified ranked list.',\n      schema: webSearchParamsSchema,\n      outputSchema: webSearchOutputSchema,\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        destructiveHint: false,\n        openWorldHint: true,\n        // Non-standard precondition hint. mcp-use's ToolAnnotations type\n        // does not expose `experimental` natively (the SDK schema uses\n        // $strip) but the runtime forwards the whole annotations object\n        // verbatim. Cast keeps TS happy. See:\n        //   docs/code-review/context/04-session-and-workflow-state.md\n        //   mcp-revisions/contract-fixes/03-precondition-annotation-on-gated-tools.md\n        ...({ experimental: { requires: ['start-research'] } } as Record<string, unknown>),\n      },\n      _meta: { requires: ['start-research'] },\n    },\n    async (args, ctx) => {\n      if (!getCapabilities().search) {\n        return toToolResponse(toolFailure(getMissingEnvMessage('search')));\n      }\n\n      const guard = await requireBootstrap(ctx);\n      if (guard) {\n        return guard;\n      }\n\n      // The keyword guard is only relevant for scope=web \u2014 when the caller\n      // explicitly asked for the reddit scope, \"reddit\" in the query is\n      // intentional context, not a tool-choice mistake.\n      if (args.scope === 'web') {\n        const redditGuard = await redditKeywordGuard(ctx, args.queries);\n        if (redditGuard) {\n          return redditGuard;\n        }\n      }\n\n      const reporter = createToolReporter(ctx, 'web-search');\n      const result = await handleWebSearch(args, reporter);\n\n      await reporter.progress(100, 100, result.isError ? 'Search failed' : 'Search complete');\n      return toToolResponse(result);\n    },\n  );\n}\n"],
+  "mappings": "AAOA,SAAS,iBAAiB,4BAA4B;AACtD;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AAqBnC,MAAM,wBAAwB;AAC9B,MAAM,cAAc;AAEpB,SAAS,wBAAwB,SAAmB,OAA4C;AAC9F,MAAI,UAAU,MAAO,QAAO;AAC5B,QAAM,WAAW,QAAQ;AAAA,IAAI,CAAC,MAC5B,wBAAwB,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC;AAAA,EAC5C;AACA,SAAO,UAAU,WAAW,WAAW,CAAC,GAAG,SAAS,GAAG,QAAQ;AACjE;AAEA,eAAe,gBAAgB,SAA4C;AACzE,QAAM,SAAS,IAAI,aAAa;AAChC,SAAO,OAAO,eAAe,OAAO;AACtC;AAEA,SAAS,qBACP,UACA,OACgB;AAChB,MAAI,UAAU,MAAO,QAAO;AAC5B,QAAM,WAAW,SAAS,SAAS,IAAI,CAAC,YAAY;AAAA,IAClD,GAAG;AAAA,IACH,SAAS,OAAO,QAAQ,OAAO,CAAC,MAAM;AACpC,UAAI;AACJ,UAAI;AAAE,eAAO,IAAI,IAAI,EAAE,IAAI,EAAE;AAAA,MAAU,QAAQ;AAAE,eAAO;AAAA,MAAM;AAE9D,UAAI,CAAC,YAAY,KAAK,IAAI,EAAG,QAAO,UAAU;AAC9C,aAAO,sBAAsB,KAAK,EAAE,IAAI;AAAA,IAC1C,CAAC;AAAA,EACH,EAAE;AACF,SAAO,EAAE,GAAG,UAAU,UAAU,SAAS;AAC3C;AAEA,SAAS,eAAe,UAEtB;AACA,QAAM,cAAc,iBAAiB,SAAS,UAAU,CAAC;AACzD,SAAO,EAAE,YAAY;AACvB;AAIA,SAAS,eACP,SACA,aACA,UACA,UAAmB,OACX;AACR,SAAO;AAAA,IACL,YAAY;AAAA,IAAY;AAAA,IAAS;AAAA,IACjC,YAAY;AAAA,IACZ,YAAY;AAAA,IAAoB,YAAY;AAAA,IAC5C;AAAA,EACF;AACF;AAEA,SAAS,oBACP,aACA,UACA,cACQ;AACR,QAAM,gBAAgB,SAAS,OAAO,CAAC,WAAW,OAAO,QAAQ,UAAU,CAAC,EAAE;AAC9E,QAAM,WAAW,SACd,OAAO,CAAC,WAAW,OAAO,QAAQ,UAAU,CAAC,EAC7C,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,GAAG;AACtC,QAAM,iBAAiB,YAAY,WAAW,OAAO,CAAC,QAAQ,IAAI,WAAW,EAAE;AAE/E,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA,eAAe,aAAa,IAAI,YAAY;AAAA,IAC5C,qBAAqB,cAAc;AAAA,EACrC;AAEA,MAAI,SAAS,SAAS,GAAG;AACvB,UAAM,KAAK,gBAAgB,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,EAClD;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,+BACd,eACQ;AACR,MAAI,CAAC,iBAAiB,cAAc,WAAW,GAAG;AAChD,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,CAAC,mCAAmC,EAAE;AAEpD,aAAW,QAAQ,eAAe;AAChC,UAAM,QAAQ,mBAAmB,KAAK,SAAS,EAAE;AACjD,QAAI,CAAC,MAAO;AACZ,UAAM,YAAY,mBAAmB,KAAK,aAAa,EAAE;AACzD,UAAM,SAAS,OAAO,KAAK,WAAW,WAClC,kBAAkB,KAAK,MAAM,QAC7B,KAAK,kBACH,MAAM,mBAAmB,KAAK,eAAe,CAAC,OAC9C;AACN,UAAM;AAAA,MAAK,YACP,KAAK,KAAK,WAAM,SAAS,GAAG,MAAM,KAClC,KAAK,KAAK,GAAG,MAAM;AAAA,IACvB;AAAA,EACF;AAEA,SAAO,MAAM,WAAW,IAAI,KAAK,MAAM,KAAK,IAAI;AAClD;AAEO,SAAS,0BACd,UACA,gBACA,eACA,UAAwC,CAAC,GACjC;AACR,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,WAAW,CAAC,QAAQ;AAC1B,MAAI,kBAAkB,gBAAgB;AACpC,aAAS,KAAK,IAAI,OAAO,cAAc;AAAA,EACzC;AACA,QAAM,YAAY,+BAA+B,aAAa;AAC9D,MAAI,WAAW;AACb,aAAS,KAAK,IAAI,SAAS;AAAA,EAC7B;AACA,SAAO,SAAS,KAAK,IAAI;AAC3B;AAIA,SAAS,sBACP,gBACA,aACA,SACA,UACA,cACA,UAAmB,OACX;AACR,QAAM,aAAa,YAAY;AAG/B,QAAM,cAAc,IAAI,IAAI,eAAe,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,QAAM,QAAQ;AAAA,IACZ,MAAM,CAAC;AAAA,IACP,OAAO,CAAC;AAAA,IACR,OAAO,CAAC;AAAA,EACV;AAEA,aAAW,OAAO,YAAY;AAC5B,UAAM,QAAQ,YAAY,IAAI,IAAI,IAAI;AACtC,UAAM,OAAO,OAAO;AACpB,QAAI,SAAS,mBAAmB;AAC9B,YAAM,KAAK,KAAK,GAAG;AAAA,IACrB,WAAW,SAAS,kBAAkB;AACpC,YAAM,MAAM,KAAK,GAAG;AAAA,IACtB,OAAO;AACL,YAAM,MAAM,KAAK,GAAG;AAAA,IACtB;AAAA,EACF;AAEA,QAAM,QAAkB,CAAC;AAGzB,QAAM,KAAK,MAAM,eAAe,KAAK,EAAE;AACvC,QAAM,KAAK,kBAAkB,OAAO,EAAE;AACtC,QAAM,KAAK,KAAK,YAAY,mBAAc,WAAW,MAAM,gBAAW,MAAM,KAAK,MAAM,qBAAqB,MAAM,MAAM,MAAM,oBAAoB;AAClJ,MAAI,eAAe,YAAY;AAC7B,UAAM,aAAa,eAAe,oBAAoB,WAAM,eAAe,iBAAiB,KAAK;AACjG,UAAM,KAAK,mBAAmB,eAAe,UAAU,KAAK,UAAU,EAAE;AAAA,EAC1E;AACA,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,gBAAgB,eAAe,SAAS,EAAE;AACrD,QAAM,KAAK,EAAE;AAGb,QAAM,gBAAgB,CAAC,QAA2C;AAChE,UAAM,QAAQ,YAAY,IAAI,IAAI,IAAI;AACtC,UAAM,cAAc,KAAK,MAAM,IAAI,gBAAgB,GAAG;AACtD,UAAM,SAAS,GAAG,IAAI,SAAS,IAAI,YAAY,KAAK,WAAW;AAC/D,UAAM,aAAa,OAAO,cAAc,KAAK,MAAM,WAAW,OAAO;AACrE,UAAM,SAAS,OAAO,SAAS,MAAM,OAAO,QAAQ,OAAO,KAAK,IAAI;AACpE,WAAO,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,KAAK,IAAI,GAAG,OAAO,UAAU,MAAM,MAAM,MAAM,MAAM;AAAA,EAC3F;AAGA,MAAI,MAAM,KAAK,SAAS,GAAG;AACzB,UAAM,KAAK,wBAAwB,MAAM,KAAK,MAAM,GAAG;AACvD,UAAM,KAAK,sCAAsC;AACjD,UAAM,KAAK,sCAAsC;AACjD,eAAW,OAAO,MAAM,KAAM,OAAM,KAAK,cAAc,GAAG,CAAC;AAC3D,UAAM,KAAK,EAAE;AAAA,EACf;AAGA,MAAI,MAAM,MAAM,SAAS,GAAG;AAC1B,UAAM,KAAK,uBAAuB,MAAM,MAAM,MAAM,GAAG;AACvD,UAAM,KAAK,sCAAsC;AACjD,UAAM,KAAK,sCAAsC;AACjD,eAAW,OAAO,MAAM,MAAO,OAAM,KAAK,cAAc,GAAG,CAAC;AAC5D,UAAM,KAAK,EAAE;AAAA,EACf;AAGA,MAAI,MAAM,MAAM,SAAS,GAAG;AAC1B,UAAM,KAAK,sBAAsB,MAAM,MAAM,MAAM,GAAG;AACtD,UAAM,KAAK,wCAAwC;AACnD,UAAM,KAAK,wCAAwC;AACnD,eAAW,OAAO,MAAM,OAAO;AAC7B,YAAM,QAAQ,YAAY,IAAI,IAAI,IAAI;AACtC,YAAM,YAAY,IAAI,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAC5D,YAAM,aAAa,OAAO,cAAc,KAAK,MAAM,WAAW,OAAO;AACrE,UAAI;AACJ,UAAI;AACF,iBAAS,IAAI,IAAI,IAAI,GAAG,EAAE,SAAS,QAAQ,UAAU,EAAE;AAAA,MACzD,QAAQ;AACN,iBAAS,IAAI;AAAA,MACf;AACA,YAAM,KAAK,KAAK,IAAI,IAAI,MAAM,MAAM,MAAM,UAAU,MAAM,IAAI,MAAM,QAAQ,CAAC,CAAC,MAAM,SAAS,IAAI;AAAA,IACnG;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AAKA,MAAI,SAAS;AACX,UAAM,KAAK,oBAAoB,aAAa,UAAU,YAAY,CAAC;AAAA,EACrE;AAGA,MAAI,eAAe,QAAQ,eAAe,KAAK,SAAS,GAAG;AACzD,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,SAAS;AACpB,eAAW,OAAO,eAAe,MAAM;AACrC,YAAM,KAAK,QAAQ,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE;AAAA,IACnD;AAAA,EACF;AAEA,QAAM,YAAY,+BAA+B,eAAe,cAAc;AAC9E,MAAI,WAAW;AACb,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,SAAS;AAAA,EACtB;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAIA,SAAS,cACP,aACA,eACA,cACA,UACA,eACA,OACA,UACA;AACA,QAAM,kBAAkB,SAAS,IAAI,OAAK;AACxC,QAAI;AACJ,UAAM,YAAY,EAAE,QAAQ,CAAC;AAC7B,QAAI,WAAW;AACb,UAAI;AAAE,oBAAY,IAAI,IAAI,UAAU,IAAI,EAAE,SAAS,QAAQ,UAAU,EAAE;AAAA,MAAG,QAAQ;AAAA,MAAe;AAAA,IACnG;AACA,WAAO,EAAE,OAAO,EAAE,OAAO,cAAc,EAAE,QAAQ,QAAQ,SAAS,UAAU;AAAA,EAC9E,CAAC;AACD,QAAM,kBAAkB,SACrB,OAAO,OAAK,EAAE,QAAQ,UAAU,CAAC,EACjC,IAAI,OAAK,EAAE,KAAK;AAEnB,SAAO;AAAA,IACL,aAAa;AAAA,IACb,YAAY,YAAY,WAAW;AAAA,IACnC,QAAQ,eAAe,SAAS,OAAO,OAAK,EAAE,QAAQ,SAAS,CAAC,EAAE;AAAA,IAClE,mBAAmB;AAAA,IACnB,gBAAgB;AAAA,IAChB;AAAA,IACA,GAAI,WAAW,EAAE,WAAW,SAAS,IAAI,CAAC;AAAA,IAC1C,kBAAkB;AAAA,IAClB,GAAI,gBAAgB,SAAS,IAAI,EAAE,mBAAmB,gBAAgB,IAAI,CAAC;AAAA,EAC7E;AACF;AAEA,SAAS,uBACP,aACA,eAUC;AACD,SAAO,YAAY,WAAW,IAAI,CAAC,QAAQ;AAGzC,UAAM,SAAS,eAAe,IAAI,IAAI,IAAI;AAC1C,UAAM,YAAY,oBAAoB,IAAI,GAAG;AAC7C,WAAO;AAAA,MACL,MAAM,IAAI;AAAA,MACV,KAAK,IAAI;AAAA,MACT,OAAO,IAAI;AAAA,MACX,SAAS,IAAI;AAAA,MACb,aAAe,UAA+B;AAAA,MAC9C,OAAO,OAAO,IAAI,MAAM,QAAQ,CAAC,CAAC;AAAA,MAClC,SAAS,IAAI;AAAA,MACb,eAAe,IAAI;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAIA,SAAS,oBACP,OACA,QACA,WACsC;AACtC,QAAM,kBAAkB,cAAc,KAAK;AAC3C,QAAM,gBAAgB,KAAK,IAAI,IAAI;AAEnC,SAAO,SAAS,eAAe,gBAAgB,OAAO,IAAI,QAAQ;AAElE,QAAM,eAAe,YAAY;AAAA,IAC/B,MAAM,gBAAgB;AAAA,IACtB,SAAS,gBAAgB;AAAA,IACzB,WAAW,gBAAgB;AAAA,IAC3B,UAAU;AAAA,IACV,UAAU,CAAC,wCAAwC;AAAA,IACnD,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,GAAG,YAAY;AAAA;AAAA,kBAAuB,eAAe,aAAa,CAAC;AAAA,WAAc,OAAO,QAAQ,MAAM;AAAA,EACxG;AACF;AAIA,eAAsB,gBACpB,QACA,WAAyB,eACsB;AAC/C,QAAM,YAAY,KAAK,IAAI;AAE3B,MAAI;AACF,UAAM,mBAAmB,wBAAwB,OAAO,SAAS,OAAO,KAAK;AAC7E,QAAI,OAAO,UAAU,OAAO;AAC1B,aAAO,QAAQ,mBAAmB,OAAO,KAAK,KAAK,OAAO,QAAQ,MAAM,yBAAoB,iBAAiB,MAAM,eAAe,QAAQ;AAAA,IAC5I,OAAO;AACL,aAAO,QAAQ,iBAAiB,OAAO,QAAQ,MAAM,kBAAkB,QAAQ;AAAA,IACjF;AACA,UAAM,SAAS,IAAI,QAAQ,iBAAiB,iBAAiB,MAAM,yBAAyB,OAAO,KAAK,GAAG;AAC3G,UAAM,SAAS,SAAS,IAAI,KAAK,2BAA2B;AAE5D,UAAM,cAAc,MAAM,gBAAgB,gBAAgB;AAC1D,UAAM,WAAW,qBAAqB,aAAa,OAAO,KAAK;AAC/D,UAAM,SAAS,SAAS,IAAI,KAAK,0BAA0B;AAE3D,UAAM,EAAE,YAAY,IAAI,eAAe,QAAQ;AAC/C,UAAM,SAAS;AAAA,MACb;AAAA,MACA,aAAa,YAAY,eAAe,uBAAuB,SAAS,YAAY;AAAA,IACtF;AAGA,UAAM,SAAS,OAAO;AACtB,UAAM,eAAe,mBAAmB;AAExC,QAAI;AACJ,QAAI,gBAAgB;AACpB,QAAI;AAEJ,QAAI,UAAU,CAAC,cAAc;AAE3B,UAAI,CAAC,UAAU,CAAC,cAAc;AAC5B,mBAAW;AACX,eAAO,WAAW,UAAU,QAAQ;AAEpC,cAAM,SAAS,IAAI,WAAW,8EAA8E;AAAA,MAC9G;AACA,UAAI;AACJ,UAAI,UAAU,cAAc;AAC1B,cAAM,eAAe,MAAM;AAAA,UACzB,YAAY;AAAA,UACZ,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,QACF;AACA,2BAAmB,aAAa;AAAA,MAClC;AACA,iBAAW;AAAA,QACT,eAAe,OAAO,SAAS,aAAa,SAAS,UAAU,OAAO,OAAO;AAAA,QAC7E,oBAAoB,aAAa,SAAS,UAAU,SAAS,YAAY;AAAA,QACzE;AAAA,QACA,EAAE,gBAAgB,OAAO,QAAQ;AAAA,MACnC;AACA,YAAM,SAAS,SAAS,IAAI,KAAK,wBAAwB;AAAA,IAC3D,OAAO;AAEL,YAAM,SAAS,SAAS,IAAI,KAAK,kCAAkC;AACnE,YAAM,iBAAiB,MAAM;AAAA,QAC3B,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,SAAS;AAAA,QACT;AAAA,QACA,OAAO;AAAA,MACT;AAEA,UAAI,eAAe,QAAQ;AACzB,mBAAW;AAAA,UACT,eAAe;AAAA,UAAQ;AAAA,UAAa,OAAO;AAAA,UAAS,SAAS;AAAA,UAAU,SAAS;AAAA,UAAc,OAAO;AAAA,QACvG;AACA,wBAAgB;AAChB,cAAM,SAAS,SAAS,IAAI,KAAK,8BAA8B;AAAA,MACjE,OAAO;AAEL,mBAAW,eAAe,SAAS;AACnC,eAAO,WAAW,+CAA+C,QAAQ,IAAI,QAAQ;AAErF,cAAM,SAAS,IAAI,WAAW,+BAA+B,QAAQ,EAAE;AACvE,mBAAW;AAAA,UACT,eAAe,OAAO,SAAS,aAAa,SAAS,UAAU,OAAO,OAAO;AAAA,UAC7E,oBAAoB,aAAa,SAAS,UAAU,SAAS,YAAY;AAAA,UACzE;AAAA,UACA,EAAE,gBAAgB,OAAO,QAAQ;AAAA,QACnC;AACA,cAAM,SAAS,SAAS,IAAI,KAAK,yCAAyC;AAAA,MAC5E;AAAA,IACF;AAEA,UAAM,gBAAgB,KAAK,IAAI,IAAI;AACnC,UAAM,WAAW;AAAA,MACf;AAAA,MAAa;AAAA,MAAe,SAAS;AAAA,MAAc,SAAS;AAAA,MAAU;AAAA,MAAe,OAAO;AAAA,MAAO;AAAA,IACrG;AAMA,UAAM,gBAAgB,oBAAI,IAAoB;AAM9C,UAAM,UAAU,uBAAuB,aAAa,aAAa;AAEjE,WAAO,QAAQ,qBAAqB,YAAY,WAAW,MAAM,qBAAqB,aAAa,IAAI,QAAQ;AAC/G,UAAM,SAAS,IAAI,QAAQ,yBAAyB,YAAY,WAAW,MAAM,sBAAsB,aAAa,GAAG;AAEvH,UAAM,SAAS;AAAA;AAAA,GAAW,eAAe,aAAa,CAAC,MAAM,YAAY,eAAe,eAAe,gBAAgB,sBAAsB,EAAE;AAC/I,UAAM,eAAe,WAAW;AAEhC,WAAO,YAAY,cAAc,EAAE,SAAS,cAAc,SAAS,SAAS,CAAC;AAAA,EAC/E,SAAS,OAAO;AACd,WAAO,oBAAoB,OAAO,QAAQ,SAAS;AAAA,EACrD;AACF;AAEO,SAAS,sBAAsB,QAAyB;AAC7D,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,MACF,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,aAAa;AAAA,QACX,cAAc;AAAA,QACd,gBAAgB;AAAA,QAChB,iBAAiB;AAAA,QACjB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOf,GAAI,EAAE,cAAc,EAAE,UAAU,CAAC,gBAAgB,EAAE,EAAE;AAAA,MACvD;AAAA,MACA,OAAO,EAAE,UAAU,CAAC,gBAAgB,EAAE;AAAA,IACxC;AAAA,IACA,OAAO,MAAM,QAAQ;AACnB,UAAI,CAAC,gBAAgB,EAAE,QAAQ;AAC7B,eAAO,eAAe,YAAY,qBAAqB,QAAQ,CAAC,CAAC;AAAA,MACnE;AAEA,YAAM,QAAQ,MAAM,iBAAiB,GAAG;AACxC,UAAI,OAAO;AACT,eAAO;AAAA,MACT;AAKA,UAAI,KAAK,UAAU,OAAO;AACxB,cAAM,cAAc,MAAM,mBAAmB,KAAK,KAAK,OAAO;AAC9D,YAAI,aAAa;AACf,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,YAAM,WAAW,mBAAmB,KAAK,YAAY;AACrD,YAAM,SAAS,MAAM,gBAAgB,MAAM,QAAQ;AAEnD,YAAM,SAAS,SAAS,KAAK,KAAK,OAAO,UAAU,kBAAkB,iBAAiB;AACtF,aAAO,eAAe,MAAM;AAAA,IAC9B;AAAA,EACF;AACF;",
+  "names": []
+}