@speakeasy-api/docs-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @speakeasy-api/docs-mcp-server
+
+MCP server runtime exposing hybrid search over documentation via HTTP and stdio transports.
+
+**Beta.** Part of the [Speakeasy Docs MCP](https://github.com/speakeasy-api/docs-mcp) monorepo.
+
+## Installation
+
+```bash
+npm install -g @speakeasy-api/docs-mcp-server
+```
+
+## CLI Usage
+
+```bash
+# HTTP transport
+docs-mcp-server --index-dir ./dist/.lancedb --transport http --port 20310
+
+# Stdio transport (for MCP host integration)
+docs-mcp-server --index-dir ./dist/.lancedb --transport stdio
+```
+
+## Programmatic Usage
+
+```typescript
+import { McpDocsServer } from '@speakeasy-api/docs-mcp-server';
+
+const server = new McpDocsServer({
+  dbPath: './dist/.lancedb',
+});
+
+server.start();
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_docs` | Hybrid search with dynamically generated parameters and JSON Schema enum validation. Supports cursor pagination. |
+| `get_doc` | Retrieve a specific chunk with optional neighboring context. |
+
+Tool names, descriptions, and parameters are dynamically generated from the `metadata.json` produced during indexing.
+
+## License
+
+[AGPL-3.0](https://github.com/speakeasy-api/docs-mcp/blob/main/LICENSE)

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+import { readFile, stat } from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { Command } from "commander";
+import { z } from "zod/v4";
+import { DocsIndex, LanceDbSearchEngine, createEmbeddingProvider, normalizeMetadata } from "@speakeasy-api/docs-mcp-core";
+import { McpDocsServer } from "./server.js";
+import { startStdioServer } from "./stdio.js";
+import { startHttpServer } from "./http.js";
+const require = createRequire(import.meta.url);
+const { version: SERVER_VERSION } = require("../package.json");
+const TaxonomyFieldSchema = z.object({
+    description: z.string().optional(),
+    values: z.array(z.string())
+}).passthrough();
+const MetadataDocumentSchema = z.object({
+    metadata_version: z.string(),
+    corpus_description: z.string(),
+    taxonomy: z.record(z.string(), TaxonomyFieldSchema),
+    stats: z.object({
+        total_chunks: z.number().int(),
+        total_files: z.number().int(),
+        indexed_at: z.string(),
+        source_commit: z.string().nullable().optional()
+    }).passthrough(),
+    embedding: z.object({
+        provider: z.string(),
+        model: z.string(),
+        dimensions: z.number().int()
+    }).nullable(),
+    index: z.object({
+        path: z.string(),
+        table: z.string()
+    }).optional()
+}).passthrough();
+const program = new Command();
+program
+    .name("docs-mcp-server")
+    .description("Run @speakeasy-api/docs-mcp-server over MCP stdio transport")
+    .requiredOption("--index-dir <path>", "Directory containing chunks.json and metadata.json")
+    .option("--name <value>", "MCP server name", "@speakeasy-api/docs-mcp-server")
+    .option("--tool-prefix <value>", "Tool name prefix (e.g. 'acme' produces acme_search_docs)")
+    .option("--version <value>", "MCP server version", SERVER_VERSION)
+    .option("--query-embedding-provider <provider>", "Query embedding provider: auto | none | hash | openai", parseQueryEmbeddingProvider, "auto")
+    .option("--query-embedding-model <value>", "Query embedding model override")
+    .option("--query-embedding-dimensions <number>", "Query embedding dimensions", parseNumberOption)
+    .option("--query-embedding-api-key <value>", "Query embedding API key (or set OPENAI_API_KEY)")
+    .option("--query-embedding-base-url <value>", "Query embedding API base URL")
+    .option("--query-embedding-batch-size <number>", "Query embedding batch size", parseIntOption)
+    .option("--proximity-weight <number>", "Lexical phrase blend weight", parseNumberOption)
+    .option("--phrase-slop <number>", "Phrase query slop (0-5)", parseNumberOption)
+    .option("--vector-weight <number>", "Vector rank blend weight", parseNumberOption)
+    .option("--allow-chunks-fallback", "Allow fallback to chunks.json when .lancedb is missing", false)
+    .option("--transport <type>", "Transport type: stdio or http", "stdio")
+    .option("--port <number>", "HTTP server port (only used with --transport http)", parseIntOption, 20310)
+    .action(async (options) => {
+    const indexDir = path.resolve(options.indexDir);
+    const metadataPath = path.join(indexDir, "metadata.json");
+    const chunksPath = path.join(indexDir, "chunks.json");
+    const metadataRaw = await readFile(metadataPath, "utf8");
+    let metadataDocument;
+    try {
+        metadataDocument = MetadataDocumentSchema.parse(JSON.parse(metadataRaw));
+    }
+    catch (error) {
+        const detail = error instanceof z.ZodError ? z.prettifyError(error) : String(error);
+        throw new Error(`Invalid metadata.json at '${metadataPath}':\n${detail}`, { cause: error });
+    }
+    const metadata = normalizeMetadata(metadataDocument);
+    const metadataKeys = Object.keys(metadata.taxonomy);
+    const indexConfig = parseIndexConfig(metadataDocument);
+    const queryEmbeddingProvider = resolveQueryEmbeddingProvider(options, metadata.embedding);
+    const loadInput = {
+        lancedbPath: path.resolve(indexDir, indexConfig.path),
+        tableName: indexConfig.table,
+        chunksPath,
+        metadataKeys,
+        allowChunksFallback: options.allowChunksFallback
+    };
+    if (queryEmbeddingProvider !== undefined) {
+        loadInput.queryEmbeddingProvider = queryEmbeddingProvider;
+    }
+    if (options.proximityWeight !== undefined) {
+        loadInput.proximityWeight = options.proximityWeight;
+    }
+    if (options.phraseSlop !== undefined) {
+        loadInput.phraseSlop = options.phraseSlop;
+    }
+    if (options.vectorWeight !== undefined) {
+        loadInput.vectorWeight = options.vectorWeight;
+    }
+    const index = await loadSearchEngine(loadInput);
+    const rrfWeights = parseRrfWeightsFromEnv();
+    const app = new McpDocsServer({
+        index,
+        metadata,
+        ...(options.toolPrefix ? { toolPrefix: options.toolPrefix } : {}),
+        ...(rrfWeights ? { rrfWeights } : {})
+    });
+    const serverName = options.name === "@speakeasy-api/docs-mcp-server" && options.toolPrefix
+        ? `${options.toolPrefix}-docs-server`
+        : options.name;
+    if (options.transport === "http") {
+        await startHttpServer(app, {
+            name: serverName,
+            version: options.version,
+            port: options.port
+        });
+    }
+    else {
+        await startStdioServer(app, {
+            name: serverName,
+            version: options.version
+        });
+    }
+});
+void program.parseAsync(process.argv);
+async function loadSearchEngine(input) {
+    if (await exists(input.lancedbPath)) {
+        const openInput = {
+            dbPath: input.lancedbPath,
+            tableName: input.tableName,
+            metadataKeys: input.metadataKeys,
+            onWarning: (message) => console.warn(`warn: ${message}`)
+        };
+        if (input.queryEmbeddingProvider !== undefined) {
+            openInput.queryEmbeddingProvider = input.queryEmbeddingProvider;
+        }
+        if (input.proximityWeight !== undefined) {
+            openInput.proximityWeight = input.proximityWeight;
+        }
+        if (input.phraseSlop !== undefined) {
+            openInput.phraseSlop = input.phraseSlop;
+        }
+        if (input.vectorWeight !== undefined) {
+            openInput.vectorWeight = input.vectorWeight;
+        }
+        return LanceDbSearchEngine.open(openInput);
+    }
+    if (!input.allowChunksFallback) {
+        throw new Error(`LanceDB index not found at '${input.lancedbPath}'. Re-run docs-mcp build or pass --allow-chunks-fallback to use chunks.json fallback.`);
+    }
+    console.warn(`warn: LanceDB index not found at '${input.lancedbPath}'; falling back to chunks.json in-memory search`);
+    const chunksRaw = await readFile(input.chunksPath, "utf8");
+    const chunks = JSON.parse(chunksRaw);
+    return new DocsIndex(chunks);
+}
+function parseIndexConfig(metadata) {
+    const index = metadata.index;
+    if (!index || typeof index !== "object") {
+        return {
+            path: ".lancedb",
+            table: "chunks"
+        };
+    }
+    const record = index;
+    return {
+        path: toNonEmptyString(record.path) ?? ".lancedb",
+        table: toNonEmptyString(record.table) ?? "chunks"
+    };
+}
+function resolveQueryEmbeddingProvider(options, metadataEmbedding) {
+    const selectedProvider = selectEmbeddingProvider(options.queryEmbeddingProvider, metadataEmbedding);
+    if (!selectedProvider || selectedProvider === "none") {
+        return undefined;
+    }
+    const input = {
+        provider: selectedProvider
+    };
+    const model = options.queryEmbeddingModel ?? metadataEmbedding?.model;
+    if (model !== undefined) {
+        input.model = model;
+    }
+    const dimensions = options.queryEmbeddingDimensions ?? metadataEmbedding?.dimensions;
+    if (dimensions !== undefined) {
+        input.dimensions = dimensions;
+    }
+    const apiKey = options.queryEmbeddingApiKey ?? process.env.OPENAI_API_KEY;
+    if (apiKey !== undefined) {
+        input.apiKey = apiKey;
+    }
+    if (options.queryEmbeddingBaseUrl !== undefined) {
+        input.baseUrl = options.queryEmbeddingBaseUrl;
+    }
+    if (options.queryEmbeddingBatchSize !== undefined) {
+        input.batchSize = options.queryEmbeddingBatchSize;
+    }
+    try {
+        return createEmbeddingProvider(input);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`warn: query embedding disabled: ${message}`);
+        return undefined;
+    }
+}
+function selectEmbeddingProvider(option, metadataEmbedding) {
+    if (option !== "auto") {
+        return option;
+    }
+    const provider = metadataEmbedding?.provider?.trim().toLowerCase();
+    if (!provider || provider === "none") {
+        return undefined;
+    }
+    if (provider === "hash" || provider === "openai") {
+        return provider;
+    }
+    console.warn(`warn: embedding provider '${metadataEmbedding?.provider}' is not supported at runtime; falling back to FTS-only search`);
+    return undefined;
+}
+function parseQueryEmbeddingProvider(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "auto" ||
+        normalized === "none" ||
+        normalized === "hash" ||
+        normalized === "openai") {
+        return normalized;
+    }
+    throw new Error(`unsupported query embedding provider '${value}'. Expected one of: auto, none, hash, openai`);
+}
+function parseNumberOption(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`invalid numeric value '${value}'`);
+    }
+    return parsed;
+}
+function parseIntOption(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`invalid integer value '${value}'`);
+    }
+    return parsed;
+}
+function parseRrfWeightsFromEnv() {
+    const vector = parseOptionalEnvFloat("RRF_WEIGHT_VECTOR");
+    const match = parseOptionalEnvFloat("RRF_WEIGHT_MATCH");
+    const phrase = parseOptionalEnvFloat("RRF_WEIGHT_PHRASE");
+    if (vector === undefined && match === undefined && phrase === undefined) {
+        return undefined;
+    }
+    const weights = {};
+    if (vector !== undefined) {
+        weights.vector = vector;
+    }
+    if (match !== undefined) {
+        weights.match = match;
+    }
+    if (phrase !== undefined) {
+        weights.phrase = phrase;
+    }
+    return weights;
+}
+function parseOptionalEnvFloat(name) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === "") {
+        return undefined;
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed)) {
+        console.warn(`warn: ignoring invalid ${name} value '${raw}'`);
+        return undefined;
+    }
+    return parsed;
+}
+function toNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+async function exists(targetPath) {
+    try {
+        await stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+import http from "node:http";
+import type { McpDocsServer } from "./server.js";
+export interface StartHttpServerOptions {
+    name?: string;
+    version?: string;
+    port?: number;
+}
+export interface HttpServerHandle {
+    httpServer: http.Server;
+    port: number;
+}
+export declare function startHttpServer(app: McpDocsServer, options?: StartHttpServerOptions): Promise<HttpServerHandle>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AA2CD,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CA2B3B"}

package/dist/http.js

@@ -0,0 +1,191 @@
+import http from "node:http";
+import { createRequire } from "node:module";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require("../package.json");
+/**
+ * Create a fresh MCP Server wired to the given app and return it connected to a
+ * new stateless StreamableHTTPServerTransport.  In stateless mode every request
+ * gets its own server+transport pair (the SDK examples demonstrate this pattern
+ * in `simpleStatelessStreamableHttp.ts`).
+ */
+function createPerRequestServer(app, options) {
+    const server = new Server({
+        name: options.name ?? "@speakeasy-api/docs-mcp-server",
+        version: options.version ?? PKG_VERSION
+    }, {
+        capabilities: {
+            tools: {}
+        }
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = app.getTools().map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        }));
+        return { tools };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const result = await app.callTool(request.params.name, request.params.arguments ?? {});
+        return result;
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- exactOptionalPropertyTypes workaround
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    return { server, transport };
+}
+export async function startHttpServer(app, options = {}) {
+    const port = options.port ?? 20310;
+    const httpServer = http.createServer(async (req, res) => {
+        try {
+            await handleRequest(req, res, app, options);
+        }
+        catch (error) {
+            console.error("Unhandled error in request handler:", error);
+            if (!res.headersSent) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: { code: -32603, message: "Internal server error" },
+                    id: null
+                }));
+            }
+            else if (!res.writableEnded) {
+                res.end();
+            }
+        }
+    });
+    const actualPort = await listenOnAvailablePort(httpServer, port);
+    console.error(`MCP HTTP server listening on http://localhost:${actualPort}/mcp`);
+    return { httpServer, port: actualPort };
+}
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "POST, OPTIONS",
+    "Access-Control-Allow-Headers": "*",
+    "Access-Control-Max-Age": "86400"
+};
+function setCorsHeaders(res) {
+    for (const [key, value] of Object.entries(CORS_HEADERS)) {
+        res.setHeader(key, value);
+    }
+}
+async function handleRequest(req, res, app, options) {
+    // Only the pathname matters; the base URL is arbitrary.
+    const url = new URL(req.url ?? "/", "http://localhost");
+    if (url.pathname !== "/mcp") {
+        res.writeHead(405, { "Content-Type": "text/plain" });
+        res.end("Method Not Allowed");
+        return;
+    }
+    setCorsHeaders(res);
+    if (req.method === "OPTIONS") {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    if (req.method === "GET" || req.method === "DELETE") {
+        res.writeHead(405, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: { code: -32000, message: "Method not allowed." },
+            id: null
+        }));
+        return;
+    }
+    // Parse JSON body before handing off to the transport
+    let parsed;
+    try {
+        const body = await readBody(req);
+        parsed = JSON.parse(body);
+    }
+    catch {
+        res.writeHead(400, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: { code: -32700, message: "Parse error" },
+            id: null
+        }));
+        return;
+    }
+    const { server, transport } = createPerRequestServer(app, options);
+    try {
+        await server.connect(transport);
+        await transport.handleRequest(req, res, parsed);
+        res.on("close", () => {
+            transport.close();
+            server.close();
+        });
+    }
+    catch (error) {
+        console.error("Error handling MCP request:", error);
+        if (!res.headersSent) {
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: "Internal server error" },
+                id: null
+            }));
+        }
+        transport.close();
+        server.close();
+    }
+}
+const MAX_PORT_ATTEMPTS = 10;
+/**
+ * Try to listen on `startPort`. If the port is busy (EADDRINUSE), try
+ * startPort+1, startPort+2, etc. up to MAX_PORT_ATTEMPTS.
+ * Port 0 is passed through directly (OS picks an ephemeral port).
+ */
+function listenOnAvailablePort(server, startPort) {
+    if (startPort === 0) {
+        return new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(0, () => {
+                server.removeListener("error", reject);
+                const addr = server.address();
+                resolve(typeof addr === "object" && addr ? addr.port : 0);
+            });
+        });
+    }
+    let attempt = 0;
+    return new Promise((resolve, reject) => {
+        const tryPort = (port) => {
+            server.once("error", (err) => {
+                if (err.code === "EADDRINUSE" && attempt < MAX_PORT_ATTEMPTS) {
+                    attempt++;
+                    tryPort(port + 1);
+                }
+                else {
+                    reject(err);
+                }
+            });
+            server.listen(port, () => {
+                server.removeAllListeners("error");
+                resolve(port);
+            });
+        };
+        tryPort(startPort);
+    });
+}
+const MAX_BODY_BYTES = 50 * 1024 * 1024; // 50 MB
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalLength = 0;
+        req.on("data", (chunk) => {
+            totalLength += chunk.length;
+            if (totalLength > MAX_BODY_BYTES) {
+                req.destroy();
+                reject(new Error("Request body too large"));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks).toString()));
+        req.on("error", reject);
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./server.js";
+export * from "./stdio.js";
+export * from "./http.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./server.js";
+export * from "./stdio.js";
+export * from "./http.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,4 @@
+import type { CorpusMetadata } from "@speakeasy-api/docs-mcp-core";
+export declare function buildSearchDocsSchema(metadata: CorpusMetadata): Record<string, unknown>;
+export declare function buildGetDocSchema(): Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCvF;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB3D"}

package/dist/schema.js

@@ -0,0 +1,53 @@
+export function buildSearchDocsSchema(metadata) {
+    const properties = {
+        query: {
+            type: "string",
+            description: "The search query (e.g., 'how to paginate', 'RateLimitError')."
+        },
+        limit: {
+            type: "integer",
+            description: "Maximum number of results to return. Default is 10.",
+            minimum: 1,
+            maximum: 50,
+            default: 10
+        },
+        cursor: {
+            type: "string",
+            description: "Opaque pagination token returned from a previous search. Omit for the first page."
+        }
+    };
+    for (const [key, field] of Object.entries(metadata.taxonomy)) {
+        properties[key] = {
+            type: "string",
+            description: field.description ?? `Filter results by ${key}.`,
+            enum: field.values
+        };
+    }
+    return {
+        type: "object",
+        additionalProperties: false,
+        properties,
+        required: ["query"]
+    };
+}
+export function buildGetDocSchema() {
+    return {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            chunk_id: {
+                type: "string",
+                description: "The exact ID of the chunk to retrieve, as returned by search_docs (e.g., 'guides/retries.md#backoff-strategy')."
+            },
+            context: {
+                type: "integer",
+                description: "Number of adjacent chunks to include before and after the target chunk. Default is 0.",
+                minimum: 0,
+                maximum: 5,
+                default: 0
+            }
+        },
+        required: ["chunk_id"]
+    };
+}
+//# sourceMappingURL=schema.js.map