@ontosdk/mcp 1.0.3 → 1.1.1

package/dist/index.d.ts

@@ -1,6 +1,124 @@
-export { readUrl, readUrlInputSchema, type ReadUrlInput } from './tools/read.js';
-export { scoreUrl, scoreUrlInputSchema, type ScoreUrlInput } from './tools/score.js';
-export { readAndScore, readAndScoreInputSchema, type ReadAndScoreInput, } from './tools/read-and-score.js';
-export { callOntoApi, OntoApiError } from './lib/api-client.js';
-export type { ReadResponse, ScoreResponse, ReadAndScoreResponse, Recommendation, } from './lib/types.js';
-export { version } from './lib/version.js';
+import { z } from 'zod';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+
+declare const readUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    fresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    fresh: boolean;
+}, {
+    url: string;
+    fresh?: boolean | undefined;
+}>;
+type ReadUrlInput = z.infer<typeof readUrlInputSchema>;
+declare function readUrl(input: ReadUrlInput): Promise<CallToolResult>;
+
+interface ReadResponse {
+    status: 'success';
+    url: string;
+    markdown: string;
+    metadata: {
+        title: string;
+        description: string;
+        language?: string;
+    };
+    stats: {
+        raw_html_size_kb: number;
+        markdown_size_kb: number;
+        reduction_percent: number;
+        extraction_time_ms: number;
+    };
+    cache: {
+        hit: boolean;
+        ttl_seconds: number;
+    };
+}
+interface Recommendation {
+    title?: string;
+    description?: string;
+    priority?: 'High' | 'Medium' | 'Low' | string;
+    [key: string]: unknown;
+}
+interface ScoreResponse {
+    status: 'success';
+    url: string;
+    aio_score: number;
+    grade: string;
+    hallucination_risk: 'low' | 'medium' | 'high';
+    insights: Record<string, boolean>;
+    penalties: string[];
+    benefits: string[];
+    recommendations: Recommendation[];
+    stats: {
+        raw_size: string;
+        efficiency: string;
+        extraction_time_ms: number;
+    };
+    bot_preview?: unknown;
+}
+interface ReadAndScoreResponse {
+    status: 'success';
+    url: string;
+    markdown: string;
+    metadata: {
+        title: string;
+        description: string;
+        language?: string;
+    };
+    aio_score: number;
+    grade: string;
+    hallucination_risk: 'low' | 'medium' | 'high';
+    insights: Record<string, boolean>;
+    penalties: string[];
+    benefits: string[];
+    recommendations: Recommendation[];
+    stats: {
+        raw_html_size_kb: number;
+        markdown_size_kb: number;
+        reduction_percent: number;
+        extraction_time_ms: number;
+    };
+    cache: {
+        hit: boolean;
+        ttl_seconds: number;
+    };
+}
+
+declare const scoreUrlInputSchema: z.ZodObject<{
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+}, {
+    url: string;
+}>;
+type ScoreUrlInput = z.infer<typeof scoreUrlInputSchema>;
+declare function scoreUrl(input: ScoreUrlInput): Promise<CallToolResult>;
+
+declare const readAndScoreInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    fresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    fresh: boolean;
+}, {
+    url: string;
+    fresh?: boolean | undefined;
+}>;
+type ReadAndScoreInput = z.infer<typeof readAndScoreInputSchema>;
+declare function readAndScore(input: ReadAndScoreInput): Promise<CallToolResult>;
+
+declare class OntoApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+interface CallOptions {
+    body: unknown;
+    signal?: AbortSignal;
+}
+declare function callOntoApi<T>(endpoint: string, options: CallOptions): Promise<T>;
+
+declare const version = "1.1.1";
+
+export { OntoApiError, type ReadAndScoreInput, type ReadAndScoreResponse, type ReadResponse, type ReadUrlInput, type Recommendation, type ScoreResponse, type ScoreUrlInput, callOntoApi, readAndScore, readAndScoreInputSchema, readUrl, readUrlInputSchema, scoreUrl, scoreUrlInputSchema, version };

package/dist/index.js

@@ -1,9 +1,284 @@
-/* Programmatic exports for embedding the Onto tools in custom MCP setups.
- * Most users should run the bin via `npx @ontosdk/mcp`; this file is for
- * power users wiring tools into their own Server instance. */
-export { readUrl, readUrlInputSchema } from './tools/read.js';
-export { scoreUrl, scoreUrlInputSchema } from './tools/score.js';
-export { readAndScore, readAndScoreInputSchema, } from './tools/read-and-score.js';
-export { callOntoApi, OntoApiError } from './lib/api-client.js';
-export { version } from './lib/version.js';
+// src/tools/read.ts
+import { z } from "zod";
+
+// src/lib/version.ts
+var version = "1.1.1";
+
+// src/lib/api-client.ts
+var DEFAULT_BASE = "https://api.buildonto.dev";
+var REQUEST_TIMEOUT_MS = 15e3;
+var OntoApiError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "OntoApiError";
+  }
+  status;
+  code;
+};
+async function callOntoApi(endpoint, options) {
+  const apiKey = process.env.ONTO_API_KEY;
+  if (!apiKey) {
+    throw new OntoApiError(
+      "ONTO_API_KEY environment variable is not set. Get a key at https://app.buildonto.dev/read/keys",
+      0,
+      "NO_API_KEY"
+    );
+  }
+  const base = process.env.ONTO_API_BASE ?? DEFAULT_BASE;
+  const url = `${base}${endpoint}`;
+  const timeout = AbortSignal.timeout(REQUEST_TIMEOUT_MS);
+  const signal = options.signal ? AbortSignal.any([options.signal, timeout]) : timeout;
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": `@ontosdk/mcp/${version}`
+      },
+      body: JSON.stringify(options.body),
+      signal
+    });
+  } catch (err) {
+    if (err instanceof DOMException && err.name === "TimeoutError") {
+      throw new OntoApiError(
+        `Onto API request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s. The target site may be slow or unreachable.`,
+        0,
+        "TIMEOUT"
+      );
+    }
+    throw new OntoApiError(
+      `Failed to reach Onto API at ${base}: ${err.message}`,
+      0,
+      "NETWORK_ERROR"
+    );
+  }
+  const rawBody = await response.text();
+  if (!response.ok) {
+    let parsed = {};
+    try {
+      parsed = JSON.parse(rawBody);
+    } catch {
+    }
+    const message = humanizeError(response.status, parsed);
+    throw new OntoApiError(message, response.status, parsed.error);
+  }
+  try {
+    return JSON.parse(rawBody);
+  } catch (err) {
+    throw new OntoApiError(
+      `Onto API returned invalid JSON: ${err.message}`,
+      response.status,
+      "INVALID_RESPONSE"
+    );
+  }
+}
+function humanizeError(status, body) {
+  if (status === 401) {
+    return "Invalid Onto API key. Verify your key at https://app.buildonto.dev/read/keys";
+  }
+  if (status === 402) {
+    return body.message ?? "Monthly plan quota exceeded and credit balance is empty. Top up credits at https://app.buildonto.dev/read/billing";
+  }
+  if (status === 403) {
+    if (body.error === "ROBOTS_BLOCKED") {
+      return body.message ?? "The target site blocks AI crawlers via robots.txt.";
+    }
+    return body.message ?? "Forbidden.";
+  }
+  if (status === 429) {
+    return body.message ?? "Onto API rate limit exceeded. Upgrade your tier at https://app.buildonto.dev/read/billing or wait for the monthly reset.";
+  }
+  if (status >= 500) {
+    return body.message ?? `Onto API server error (${status}). Try again in a moment.`;
+  }
+  return body.message ?? `Onto API returned ${status}.`;
+}
+
+// src/lib/errors.ts
+function formatToolError(error) {
+  if (error instanceof OntoApiError) {
+    return {
+      content: [{ type: "text", text: error.message }],
+      isError: true
+    };
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Onto MCP error: ${message}
+
+Troubleshooting:
+- Verify ONTO_API_KEY is set and valid (https://app.buildonto.dev/read/keys)
+- Check the target URL is publicly accessible
+- Check your monthly quota at https://app.buildonto.dev/read/usage`
+      }
+    ],
+    isError: true
+  };
+}
+
+// src/tools/read.ts
+var readUrlInputSchema = z.object({
+  url: z.string().url(),
+  fresh: z.boolean().optional().default(false)
+});
+async function readUrl(input) {
+  try {
+    const result = await callOntoApi("/v1/read", {
+      body: { url: input.url, fresh: input.fresh }
+    });
+    const metaLines = [
+      `- URL: ${result.url}`,
+      `- Title: ${result.metadata.title || "(none)"}`,
+      `- Original size: ${result.stats.raw_html_size_kb} KB`,
+      `- Cleaned size: ${result.stats.markdown_size_kb} KB`,
+      `- Reduction: ${result.stats.reduction_percent}%`,
+      `- Extraction time: ${result.stats.extraction_time_ms} ms`,
+      `- Cache: ${result.cache.hit ? "HIT" : "MISS"}`
+    ].join("\n");
+    return {
+      content: [
+        { type: "text", text: result.markdown },
+        {
+          type: "text",
+          text: `
+
+---
+
+**Source metadata (from Onto):**
+${metaLines}`
+        }
+      ]
+    };
+  } catch (error) {
+    return formatToolError(error);
+  }
+}
+
+// src/tools/score.ts
+import { z as z2 } from "zod";
+var scoreUrlInputSchema = z2.object({
+  url: z2.string().url()
+});
+async function scoreUrl(input) {
+  try {
+    const result = await callOntoApi("/v1/score", {
+      body: { url: input.url }
+    });
+    return {
+      content: [{ type: "text", text: formatScoreSummary(result) }]
+    };
+  } catch (error) {
+    return formatToolError(error);
+  }
+}
+function formatScoreSummary(result) {
+  const lines = [
+    `**AIO Score:** ${result.aio_score}/100 (${result.grade})`,
+    `**Hallucination risk:** ${result.hallucination_risk}`,
+    `**URL:** ${result.url}`,
+    ""
+  ];
+  if (result.benefits.length > 0) {
+    lines.push("**What works well:**");
+    for (const item of result.benefits) lines.push(`- ${item}`);
+    lines.push("");
+  }
+  if (result.penalties.length > 0) {
+    lines.push("**What hurts AI readability:**");
+    for (const item of result.penalties) lines.push(`- ${item}`);
+    lines.push("");
+  }
+  const insightEntries = Object.entries(result.insights ?? {});
+  if (insightEntries.length > 0) {
+    lines.push("**Insights:**");
+    for (const [key, value] of insightEntries) {
+      lines.push(`- ${key}: ${value ? "yes" : "no"}`);
+    }
+    lines.push("");
+  }
+  if (result.recommendations.length > 0) {
+    lines.push("**Recommendations:**");
+    for (const rec of result.recommendations) {
+      lines.push(describeRecommendation(rec));
+    }
+    lines.push("");
+  }
+  lines.push("**Stats:**");
+  lines.push(`- Raw size: ${result.stats.raw_size}`);
+  lines.push(`- Efficiency: ${result.stats.efficiency}`);
+  lines.push(`- Extraction time: ${result.stats.extraction_time_ms} ms`);
+  return lines.join("\n");
+}
+function describeRecommendation(rec) {
+  if (typeof rec === "string") return `- ${rec}`;
+  if (rec.title) {
+    const head = rec.priority ? `**${rec.title}** _(priority: ${rec.priority})_` : `**${rec.title}**`;
+    return rec.description ? `- ${head} \u2014 ${rec.description}` : `- ${head}`;
+  }
+  if (rec.description) return `- ${rec.description}`;
+  return `- ${JSON.stringify(rec)}`;
+}
+
+// src/tools/read-and-score.ts
+import { z as z3 } from "zod";
+var readAndScoreInputSchema = z3.object({
+  url: z3.string().url(),
+  fresh: z3.boolean().optional().default(false)
+});
+async function readAndScore(input) {
+  try {
+    const result = await callOntoApi("/v1/read-and-score", {
+      body: { url: input.url, fresh: input.fresh }
+    });
+    const trustHint = trustLine(result.aio_score, result.hallucination_risk);
+    const summaryLines = [
+      `**Source quality assessment (from Onto):**`,
+      `- AIO Score: ${result.aio_score}/100 (${result.grade})`,
+      `- Hallucination risk: ${result.hallucination_risk}`,
+      `- Reduction: ${result.stats.reduction_percent}% (${result.stats.raw_html_size_kb} KB \u2192 ${result.stats.markdown_size_kb} KB)`,
+      `- Cache: ${result.cache.hit ? "HIT" : "MISS"}`,
+      "",
+      trustHint
+    ];
+    return {
+      content: [
+        { type: "text", text: result.markdown },
+        { type: "text", text: `
+
+---
+
+${summaryLines.join("\n")}` }
+      ]
+    };
+  } catch (error) {
+    return formatToolError(error);
+  }
+}
+function trustLine(score, risk) {
+  if (risk === "high" || score < 40) {
+    return "Trust signal: low \u2014 this source is poorly structured for AI consumption. Verify any facts before relying on them.";
+  }
+  if (risk === "medium" || score < 70) {
+    return "Trust signal: medium \u2014 source is partially AI-readable. Cross-check critical claims.";
+  }
+  return "Trust signal: high \u2014 source is well-structured for AI consumption.";
+}
+export {
+  OntoApiError,
+  callOntoApi,
+  readAndScore,
+  readAndScoreInputSchema,
+  readUrl,
+  readUrlInputSchema,
+  scoreUrl,
+  scoreUrlInputSchema,
+  version
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;8DAE8D;AAE9D,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAsB,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,YAAY,EACZ,uBAAuB,GAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"sources":["../src/tools/read.ts","../src/lib/version.ts","../src/lib/api-client.ts","../src/lib/errors.ts","../src/tools/score.ts","../src/tools/read-and-score.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { callOntoApi } from '../lib/api-client.js';\nimport { formatToolError } from '../lib/errors.js';\nimport type { ReadResponse } from '../lib/types.js';\n\nexport const readUrlInputSchema = z.object({\n  url: z.string().url(),\n  fresh: z.boolean().optional().default(false),\n});\n\nexport type ReadUrlInput = z.infer<typeof readUrlInputSchema>;\n\nexport async function readUrl(input: ReadUrlInput): Promise<CallToolResult> {\n  try {\n    const result = await callOntoApi<ReadResponse>('/v1/read', {\n      body: { url: input.url, fresh: input.fresh },\n    });\n\n    const metaLines = [\n      `- URL: ${result.url}`,\n      `- Title: ${result.metadata.title || '(none)'}`,\n      `- Original size: ${result.stats.raw_html_size_kb} KB`,\n      `- Cleaned size: ${result.stats.markdown_size_kb} KB`,\n      `- Reduction: ${result.stats.reduction_percent}%`,\n      `- Extraction time: ${result.stats.extraction_time_ms} ms`,\n      `- Cache: ${result.cache.hit ? 'HIT' : 'MISS'}`,\n    ].join('\\n');\n\n    return {\n      content: [\n        { type: 'text' as const, text: result.markdown },\n        {\n          type: 'text' as const,\n          text: `\\n\\n---\\n\\n**Source metadata (from Onto):**\\n${metaLines}`,\n        },\n      ],\n    };\n  } catch (error) {\n    return formatToolError(error);\n  }\n}\n","export const version = '1.1.1';\n","/* Thin HTTP wrapper around the Onto Read API. Reads ONTO_API_KEY at call time\n * (not module-load) so server.ts can fail with a clean error message first. */\n\nimport { version as PACKAGE_VERSION } from './version.js';\nimport type { ApiErrorBody } from './types.js';\n\nconst DEFAULT_BASE = 'https://api.buildonto.dev';\nconst REQUEST_TIMEOUT_MS = 15_000;\n\nexport class OntoApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly code?: string,\n  ) {\n    super(message);\n    this.name = 'OntoApiError';\n  }\n}\n\ninterface CallOptions {\n  body: unknown;\n  signal?: AbortSignal;\n}\n\nexport async function callOntoApi<T>(endpoint: string, options: CallOptions): Promise<T> {\n  const apiKey = process.env.ONTO_API_KEY;\n  if (!apiKey) {\n    throw new OntoApiError(\n      'ONTO_API_KEY environment variable is not set. Get a key at https://app.buildonto.dev/read/keys',\n      0,\n      'NO_API_KEY',\n    );\n  }\n\n  const base = process.env.ONTO_API_BASE ?? DEFAULT_BASE;\n  const url = `${base}${endpoint}`;\n\n  const timeout = AbortSignal.timeout(REQUEST_TIMEOUT_MS);\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, timeout])\n    : timeout;\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${apiKey}`,\n        'Content-Type': 'application/json',\n        'User-Agent': `@ontosdk/mcp/${PACKAGE_VERSION}`,\n      },\n      body: JSON.stringify(options.body),\n      signal,\n    });\n  } catch (err) {\n    if (err instanceof DOMException && err.name === 'TimeoutError') {\n      throw new OntoApiError(\n        `Onto API request timed out after ${REQUEST_TIMEOUT_MS / 1000}s. The target site may be slow or unreachable.`,\n        0,\n        'TIMEOUT',\n      );\n    }\n    throw new OntoApiError(\n      `Failed to reach Onto API at ${base}: ${(err as Error).message}`,\n      0,\n      'NETWORK_ERROR',\n    );\n  }\n\n  const rawBody = await response.text();\n\n  if (!response.ok) {\n    let parsed: Partial<ApiErrorBody> = {};\n    try {\n      parsed = JSON.parse(rawBody) as Partial<ApiErrorBody>;\n    } catch {\n      // Body wasn't JSON; fall through with status-code-only error\n    }\n\n    const message = humanizeError(response.status, parsed);\n    throw new OntoApiError(message, response.status, parsed.error);\n  }\n\n  try {\n    return JSON.parse(rawBody) as T;\n  } catch (err) {\n    throw new OntoApiError(\n      `Onto API returned invalid JSON: ${(err as Error).message}`,\n      response.status,\n      'INVALID_RESPONSE',\n    );\n  }\n}\n\nfunction humanizeError(status: number, body: Partial<ApiErrorBody>): string {\n  if (status === 401) {\n    return 'Invalid Onto API key. Verify your key at https://app.buildonto.dev/read/keys';\n  }\n  if (status === 402) {\n    return (\n      body.message ??\n      'Monthly plan quota exceeded and credit balance is empty. Top up credits at https://app.buildonto.dev/read/billing'\n    );\n  }\n  if (status === 403) {\n    if (body.error === 'ROBOTS_BLOCKED') {\n      return body.message ?? 'The target site blocks AI crawlers via robots.txt.';\n    }\n    return body.message ?? 'Forbidden.';\n  }\n  if (status === 429) {\n    return (\n      body.message ??\n      'Onto API rate limit exceeded. Upgrade your tier at https://app.buildonto.dev/read/billing or wait for the monthly reset.'\n    );\n  }\n  if (status >= 500) {\n    return body.message ?? `Onto API server error (${status}). Try again in a moment.`;\n  }\n  return body.message ?? `Onto API returned ${status}.`;\n}\n","/* Format errors as MCP tool responses. We don't throw McpError for\n * tool-call failures — the AI host shows tool errors to the user as\n * unhelpful internal-error messages. Returning isError: true with a\n * text body lets the model see what went wrong and recover. */\n\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { OntoApiError } from './api-client.js';\n\nexport function formatToolError(error: unknown): CallToolResult {\n  if (error instanceof OntoApiError) {\n    return {\n      content: [{ type: 'text', text: error.message }],\n      isError: true,\n    };\n  }\n\n  const message = error instanceof Error ? error.message : String(error);\n  return {\n    content: [\n      {\n        type: 'text',\n        text: `Onto MCP error: ${message}\\n\\nTroubleshooting:\\n- Verify ONTO_API_KEY is set and valid (https://app.buildonto.dev/read/keys)\\n- Check the target URL is publicly accessible\\n- Check your monthly quota at https://app.buildonto.dev/read/usage`,\n      },\n    ],\n    isError: true,\n  };\n}\n","import { z } from 'zod';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { callOntoApi } from '../lib/api-client.js';\nimport { formatToolError } from '../lib/errors.js';\nimport type { ScoreResponse, Recommendation } from '../lib/types.js';\n\nexport const scoreUrlInputSchema = z.object({\n  url: z.string().url(),\n});\n\nexport type ScoreUrlInput = z.infer<typeof scoreUrlInputSchema>;\n\nexport async function scoreUrl(input: ScoreUrlInput): Promise<CallToolResult> {\n  try {\n    const result = await callOntoApi<ScoreResponse>('/v1/score', {\n      body: { url: input.url },\n    });\n\n    return {\n      content: [{ type: 'text' as const, text: formatScoreSummary(result) }],\n    };\n  } catch (error) {\n    return formatToolError(error);\n  }\n}\n\nexport function formatScoreSummary(result: ScoreResponse): string {\n  const lines: string[] = [\n    `**AIO Score:** ${result.aio_score}/100 (${result.grade})`,\n    `**Hallucination risk:** ${result.hallucination_risk}`,\n    `**URL:** ${result.url}`,\n    '',\n  ];\n\n  if (result.benefits.length > 0) {\n    lines.push('**What works well:**');\n    for (const item of result.benefits) lines.push(`- ${item}`);\n    lines.push('');\n  }\n\n  if (result.penalties.length > 0) {\n    lines.push('**What hurts AI readability:**');\n    for (const item of result.penalties) lines.push(`- ${item}`);\n    lines.push('');\n  }\n\n  const insightEntries = Object.entries(result.insights ?? {});\n  if (insightEntries.length > 0) {\n    lines.push('**Insights:**');\n    for (const [key, value] of insightEntries) {\n      lines.push(`- ${key}: ${value ? 'yes' : 'no'}`);\n    }\n    lines.push('');\n  }\n\n  if (result.recommendations.length > 0) {\n    lines.push('**Recommendations:**');\n    for (const rec of result.recommendations) {\n      lines.push(describeRecommendation(rec));\n    }\n    lines.push('');\n  }\n\n  lines.push('**Stats:**');\n  lines.push(`- Raw size: ${result.stats.raw_size}`);\n  lines.push(`- Efficiency: ${result.stats.efficiency}`);\n  lines.push(`- Extraction time: ${result.stats.extraction_time_ms} ms`);\n\n  return lines.join('\\n');\n}\n\nfunction describeRecommendation(rec: Recommendation): string {\n  if (typeof rec === 'string') return `- ${rec}`;\n  if (rec.title) {\n    const head = rec.priority ? `**${rec.title}** _(priority: ${rec.priority})_` : `**${rec.title}**`;\n    return rec.description ? `- ${head} — ${rec.description}` : `- ${head}`;\n  }\n  if (rec.description) return `- ${rec.description}`;\n  return `- ${JSON.stringify(rec)}`;\n}\n","import { z } from 'zod';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { callOntoApi } from '../lib/api-client.js';\nimport { formatToolError } from '../lib/errors.js';\nimport type { ReadAndScoreResponse } from '../lib/types.js';\n\nexport const readAndScoreInputSchema = z.object({\n  url: z.string().url(),\n  fresh: z.boolean().optional().default(false),\n});\n\nexport type ReadAndScoreInput = z.infer<typeof readAndScoreInputSchema>;\n\nexport async function readAndScore(input: ReadAndScoreInput): Promise<CallToolResult> {\n  try {\n    const result = await callOntoApi<ReadAndScoreResponse>('/v1/read-and-score', {\n      body: { url: input.url, fresh: input.fresh },\n    });\n\n    const trustHint = trustLine(result.aio_score, result.hallucination_risk);\n    const summaryLines = [\n      `**Source quality assessment (from Onto):**`,\n      `- AIO Score: ${result.aio_score}/100 (${result.grade})`,\n      `- Hallucination risk: ${result.hallucination_risk}`,\n      `- Reduction: ${result.stats.reduction_percent}% (${result.stats.raw_html_size_kb} KB → ${result.stats.markdown_size_kb} KB)`,\n      `- Cache: ${result.cache.hit ? 'HIT' : 'MISS'}`,\n      '',\n      trustHint,\n    ];\n\n    return {\n      content: [\n        { type: 'text' as const, text: result.markdown },\n        { type: 'text' as const, text: `\\n\\n---\\n\\n${summaryLines.join('\\n')}` },\n      ],\n    };\n  } catch (error) {\n    return formatToolError(error);\n  }\n}\n\nfunction trustLine(score: number, risk: 'low' | 'medium' | 'high'): string {\n  if (risk === 'high' || score < 40) {\n    return 'Trust signal: low — this source is poorly structured for AI consumption. Verify any facts before relying on them.';\n  }\n  if (risk === 'medium' || score < 70) {\n    return 'Trust signal: medium — source is partially AI-readable. Cross-check critical claims.';\n  }\n  return 'Trust signal: high — source is well-structured for AI consumption.';\n}\n"],"mappings":";AAAA,SAAS,SAAS;;;ACAX,IAAM,UAAU;;;ACMvB,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAEpB,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YACE,SACgB,QACA,MAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAAA,EACA;AAKpB;AAOA,eAAsB,YAAe,UAAkB,SAAkC;AACvF,QAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,OAAO,QAAQ,IAAI,iBAAiB;AAC1C,QAAM,MAAM,GAAG,IAAI,GAAG,QAAQ;AAE9B,QAAM,UAAU,YAAY,QAAQ,kBAAkB;AACtD,QAAM,SAAS,QAAQ,SACnB,YAAY,IAAI,CAAC,QAAQ,QAAQ,OAAO,CAAC,IACzC;AAEJ,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,MAAM,KAAK;AAAA,MAC1B,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,MAAM;AAAA,QAC/B,gBAAgB;AAAA,QAChB,cAAc,gBAAgB,OAAe;AAAA,MAC/C;AAAA,MACA,MAAM,KAAK,UAAU,QAAQ,IAAI;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,QAAI,eAAe,gBAAgB,IAAI,SAAS,gBAAgB;AAC9D,YAAM,IAAI;AAAA,QACR,oCAAoC,qBAAqB,GAAI;AAAA,QAC7D;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,UAAM,IAAI;AAAA,MACR,+BAA+B,IAAI,KAAM,IAAc,OAAO;AAAA,MAC9D;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,SAAS,KAAK;AAEpC,MAAI,CAAC,SAAS,IAAI;AAChB,QAAI,SAAgC,CAAC;AACrC,QAAI;AACF,eAAS,KAAK,MAAM,OAAO;AAAA,IAC7B,QAAQ;AAAA,IAER;AAEA,UAAM,UAAU,cAAc,SAAS,QAAQ,MAAM;AACrD,UAAM,IAAI,aAAa,SAAS,SAAS,QAAQ,OAAO,KAAK;AAAA,EAC/D;AAEA,MAAI;AACF,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SAAS,KAAK;AACZ,UAAM,IAAI;AAAA,MACR,mCAAoC,IAAc,OAAO;AAAA,MACzD,SAAS;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,cAAc,QAAgB,MAAqC;AAC1E,MAAI,WAAW,KAAK;AAClB,WAAO;AAAA,EACT;AACA,MAAI,WAAW,KAAK;AAClB,WACE,KAAK,WACL;AAAA,EAEJ;AACA,MAAI,WAAW,KAAK;AAClB,QAAI,KAAK,UAAU,kBAAkB;AACnC,aAAO,KAAK,WAAW;AAAA,IACzB;AACA,WAAO,KAAK,WAAW;AAAA,EACzB;AACA,MAAI,WAAW,KAAK;AAClB,WACE,KAAK,WACL;AAAA,EAEJ;AACA,MAAI,UAAU,KAAK;AACjB,WAAO,KAAK,WAAW,0BAA0B,MAAM;AAAA,EACzD;AACA,SAAO,KAAK,WAAW,qBAAqB,MAAM;AACpD;;;ACjHO,SAAS,gBAAgB,OAAgC;AAC9D,MAAI,iBAAiB,cAAc;AACjC,WAAO;AAAA,MACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,MAAM,QAAQ,CAAC;AAAA,MAC/C,SAAS;AAAA,IACX;AAAA,EACF;AAEA,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,SAAO;AAAA,IACL,SAAS;AAAA,MACP;AAAA,QACE,MAAM;AAAA,QACN,MAAM,mBAAmB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAClC;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX;AACF;;;AHpBO,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,EACpB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,KAAK;AAC7C,CAAC;AAID,eAAsB,QAAQ,OAA8C;AAC1E,MAAI;AACF,UAAM,SAAS,MAAM,YAA0B,YAAY;AAAA,MACzD,MAAM,EAAE,KAAK,MAAM,KAAK,OAAO,MAAM,MAAM;AAAA,IAC7C,CAAC;AAED,UAAM,YAAY;AAAA,MAChB,UAAU,OAAO,GAAG;AAAA,MACpB,YAAY,OAAO,SAAS,SAAS,QAAQ;AAAA,MAC7C,oBAAoB,OAAO,MAAM,gBAAgB;AAAA,MACjD,mBAAmB,OAAO,MAAM,gBAAgB;AAAA,MAChD,gBAAgB,OAAO,MAAM,iBAAiB;AAAA,MAC9C,sBAAsB,OAAO,MAAM,kBAAkB;AAAA,MACrD,YAAY,OAAO,MAAM,MAAM,QAAQ,MAAM;AAAA,IAC/C,EAAE,KAAK,IAAI;AAEX,WAAO;AAAA,MACL,SAAS;AAAA,QACP,EAAE,MAAM,QAAiB,MAAM,OAAO,SAAS;AAAA,QAC/C;AAAA,UACE,MAAM;AAAA,UACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAAgD,SAAS;AAAA,QACjE;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,WAAO,gBAAgB,KAAK;AAAA,EAC9B;AACF;;;AIzCA,SAAS,KAAAA,UAAS;AAMX,IAAM,sBAAsBC,GAAE,OAAO;AAAA,EAC1C,KAAKA,GAAE,OAAO,EAAE,IAAI;AACtB,CAAC;AAID,eAAsB,SAAS,OAA+C;AAC5E,MAAI;AACF,UAAM,SAAS,MAAM,YAA2B,aAAa;AAAA,MAC3D,MAAM,EAAE,KAAK,MAAM,IAAI;AAAA,IACzB,CAAC;AAED,WAAO;AAAA,MACL,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,mBAAmB,MAAM,EAAE,CAAC;AAAA,IACvE;AAAA,EACF,SAAS,OAAO;AACd,WAAO,gBAAgB,KAAK;AAAA,EAC9B;AACF;AAEO,SAAS,mBAAmB,QAA+B;AAChE,QAAM,QAAkB;AAAA,IACtB,kBAAkB,OAAO,SAAS,SAAS,OAAO,KAAK;AAAA,IACvD,2BAA2B,OAAO,kBAAkB;AAAA,IACpD,YAAY,OAAO,GAAG;AAAA,IACtB;AAAA,EACF;AAEA,MAAI,OAAO,SAAS,SAAS,GAAG;AAC9B,UAAM,KAAK,sBAAsB;AACjC,eAAW,QAAQ,OAAO,SAAU,OAAM,KAAK,KAAK,IAAI,EAAE;AAC1D,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,MAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,UAAM,KAAK,gCAAgC;AAC3C,eAAW,QAAQ,OAAO,UAAW,OAAM,KAAK,KAAK,IAAI,EAAE;AAC3D,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,QAAM,iBAAiB,OAAO,QAAQ,OAAO,YAAY,CAAC,CAAC;AAC3D,MAAI,eAAe,SAAS,GAAG;AAC7B,UAAM,KAAK,eAAe;AAC1B,eAAW,CAAC,KAAK,KAAK,KAAK,gBAAgB;AACzC,YAAM,KAAK,KAAK,GAAG,KAAK,QAAQ,QAAQ,IAAI,EAAE;AAAA,IAChD;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,MAAI,OAAO,gBAAgB,SAAS,GAAG;AACrC,UAAM,KAAK,sBAAsB;AACjC,eAAW,OAAO,OAAO,iBAAiB;AACxC,YAAM,KAAK,uBAAuB,GAAG,CAAC;AAAA,IACxC;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,QAAM,KAAK,YAAY;AACvB,QAAM,KAAK,eAAe,OAAO,MAAM,QAAQ,EAAE;AACjD,QAAM,KAAK,iBAAiB,OAAO,MAAM,UAAU,EAAE;AACrD,QAAM,KAAK,sBAAsB,OAAO,MAAM,kBAAkB,KAAK;AAErE,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,uBAAuB,KAA6B;AAC3D,MAAI,OAAO,QAAQ,SAAU,QAAO,KAAK,GAAG;AAC5C,MAAI,IAAI,OAAO;AACb,UAAM,OAAO,IAAI,WAAW,KAAK,IAAI,KAAK,kBAAkB,IAAI,QAAQ,OAAO,KAAK,IAAI,KAAK;AAC7F,WAAO,IAAI,cAAc,KAAK,IAAI,WAAM,IAAI,WAAW,KAAK,KAAK,IAAI;AAAA,EACvE;AACA,MAAI,IAAI,YAAa,QAAO,KAAK,IAAI,WAAW;AAChD,SAAO,KAAK,KAAK,UAAU,GAAG,CAAC;AACjC;;;AC/EA,SAAS,KAAAC,UAAS;AAMX,IAAM,0BAA0BC,GAAE,OAAO;AAAA,EAC9C,KAAKA,GAAE,OAAO,EAAE,IAAI;AAAA,EACpB,OAAOA,GAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,KAAK;AAC7C,CAAC;AAID,eAAsB,aAAa,OAAmD;AACpF,MAAI;AACF,UAAM,SAAS,MAAM,YAAkC,sBAAsB;AAAA,MAC3E,MAAM,EAAE,KAAK,MAAM,KAAK,OAAO,MAAM,MAAM;AAAA,IAC7C,CAAC;AAED,UAAM,YAAY,UAAU,OAAO,WAAW,OAAO,kBAAkB;AACvE,UAAM,eAAe;AAAA,MACnB;AAAA,MACA,gBAAgB,OAAO,SAAS,SAAS,OAAO,KAAK;AAAA,MACrD,yBAAyB,OAAO,kBAAkB;AAAA,MAClD,gBAAgB,OAAO,MAAM,iBAAiB,MAAM,OAAO,MAAM,gBAAgB,cAAS,OAAO,MAAM,gBAAgB;AAAA,MACvH,YAAY,OAAO,MAAM,MAAM,QAAQ,MAAM;AAAA,MAC7C;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,QACP,EAAE,MAAM,QAAiB,MAAM,OAAO,SAAS;AAAA,QAC/C,EAAE,MAAM,QAAiB,MAAM;AAAA;AAAA;AAAA;AAAA,EAAc,aAAa,KAAK,IAAI,CAAC,GAAG;AAAA,MACzE;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,WAAO,gBAAgB,KAAK;AAAA,EAC9B;AACF;AAEA,SAAS,UAAU,OAAe,MAAyC;AACzE,MAAI,SAAS,UAAU,QAAQ,IAAI;AACjC,WAAO;AAAA,EACT;AACA,MAAI,SAAS,YAAY,QAAQ,IAAI;AACnC,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":["z","z","z","z"]}