mcp-resend 1.0.0-1

package/dist/tools/docs/metrics.js

@@ -0,0 +1,174 @@
+/**
+ * Metrics tracking for documentation search.
+ * Collects search performance metrics and outputs them as JSON lines to stderr.
+ */
+/** Rolling window of recent searches (max 100) */
+const searchHistory = [];
+/** Maximum entries in rolling window */
+const MAX_HISTORY_SIZE = 100;
+/** Flag to track if embeddings were loaded from cache */
+let embeddingsCacheHit = false;
+/**
+ * Output a metric as a JSON line to stderr.
+ *
+ * @param metric - The metric to output
+ */
+function emitMetric(metric) {
+    console.error(JSON.stringify(metric));
+}
+/**
+ * Record a successful search and emit metric.
+ *
+ * @param latencyMs - Search latency in milliseconds
+ * @param resultCount - Number of results returned
+ * @param searchType - Type of search performed
+ * @param cacheHit - Whether embeddings were cached
+ */
+export function recordSearch(latencyMs, resultCount, searchType, cacheHit) {
+    const entry = {
+        timestamp: Date.now(),
+        latencyMs,
+        resultCount,
+        searchType,
+        cacheHit,
+        success: true,
+    };
+    // Add to rolling window
+    searchHistory.push(entry);
+    if (searchHistory.length > MAX_HISTORY_SIZE) {
+        searchHistory.shift();
+    }
+    // Emit metric
+    emitMetric({
+        _type: "metric",
+        name: "search_completed",
+        timestamp: new Date().toISOString(),
+        search_latency_ms: latencyMs,
+        result_count: resultCount,
+        search_type: searchType,
+        cache_hit: cacheHit,
+    });
+}
+/**
+ * Record a search error and emit metric.
+ *
+ * @param latencyMs - Time until error in milliseconds
+ * @param errorCode - Error code from DocsErrorCode
+ * @param context - Additional error context
+ */
+export function recordSearchError(latencyMs, errorCode, context) {
+    const entry = {
+        timestamp: Date.now(),
+        latencyMs,
+        resultCount: 0,
+        searchType: "semantic",
+        cacheHit: embeddingsCacheHit,
+        success: false,
+    };
+    // Add to rolling window
+    searchHistory.push(entry);
+    if (searchHistory.length > MAX_HISTORY_SIZE) {
+        searchHistory.shift();
+    }
+    // Emit metric
+    emitMetric({
+        _type: "metric",
+        name: "search_error",
+        timestamp: new Date().toISOString(),
+        search_latency_ms: latencyMs,
+        error_code: errorCode,
+        context,
+    });
+}
+/**
+ * Record model loaded event.
+ *
+ * @param latencyMs - Model load time in milliseconds
+ */
+export function recordModelLoaded(latencyMs) {
+    emitMetric({
+        _type: "metric",
+        name: "model_loaded",
+        timestamp: new Date().toISOString(),
+        search_latency_ms: latencyMs,
+    });
+}
+/**
+ * Record embeddings loaded event.
+ *
+ * @param latencyMs - Embeddings load time in milliseconds
+ * @param cacheHit - Whether loaded from cache
+ * @param chunkCount - Number of chunks loaded
+ */
+export function recordEmbeddingsLoaded(latencyMs, cacheHit, chunkCount) {
+    embeddingsCacheHit = cacheHit;
+    emitMetric({
+        _type: "metric",
+        name: "embeddings_loaded",
+        timestamp: new Date().toISOString(),
+        search_latency_ms: latencyMs,
+        cache_hit: cacheHit,
+        context: { chunk_count: chunkCount },
+    });
+}
+/**
+ * Check if embeddings are cached (for cache_hit metric).
+ *
+ * @param isCached - Whether embeddings are currently cached
+ */
+export function setEmbeddingsCacheStatus(isCached) {
+    embeddingsCacheHit = isCached;
+}
+/**
+ * Get aggregated statistics from the rolling window.
+ *
+ * @returns Statistics object with averages and counts
+ */
+export function getSearchStats() {
+    if (searchHistory.length === 0) {
+        return {
+            totalSearches: 0,
+            successfulSearches: 0,
+            failedSearches: 0,
+            averageLatencyMs: 0,
+            averageResultCount: 0,
+            searchTypeDistribution: {},
+            cacheHitRate: 0,
+        };
+    }
+    const successful = searchHistory.filter((e) => e.success);
+    const failed = searchHistory.filter((e) => !e.success);
+    const cacheHits = searchHistory.filter((e) => e.cacheHit);
+    const totalLatency = searchHistory.reduce((sum, e) => sum + e.latencyMs, 0);
+    const totalResults = successful.reduce((sum, e) => sum + e.resultCount, 0);
+    const typeDistribution = {};
+    for (const entry of searchHistory) {
+        typeDistribution[entry.searchType] = (typeDistribution[entry.searchType] || 0) + 1;
+    }
+    return {
+        totalSearches: searchHistory.length,
+        successfulSearches: successful.length,
+        failedSearches: failed.length,
+        averageLatencyMs: Math.round(totalLatency / searchHistory.length),
+        averageResultCount: successful.length > 0 ? Math.round((totalResults / successful.length) * 10) / 10 : 0,
+        searchTypeDistribution: typeDistribution,
+        cacheHitRate: Math.round((cacheHits.length / searchHistory.length) * 100) / 100,
+    };
+}
+/**
+ * Clear metrics history.
+ * Primarily for testing purposes.
+ */
+export function clearMetricsHistory() {
+    searchHistory.length = 0;
+    embeddingsCacheHit = false;
+}
+/**
+ * Get the current rolling window size.
+ *
+ * @returns Number of entries in the rolling window
+ */
+export function getHistorySize() {
+    return searchHistory.length;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/tools/docs/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/tools/docs/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiDH,kDAAkD;AAClD,MAAM,aAAa,GAAkB,EAAE,CAAC;AAExC,wCAAwC;AACxC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,yDAAyD;AACzD,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B;;;;GAIG;AACH,SAAS,UAAU,CAAC,MAAqB;IACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,WAAmB,EACnB,UAA6C,EAC7C,QAAiB;IAEjB,MAAM,KAAK,GAAgB;QACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,WAAW;QACX,UAAU;QACV,QAAQ;QACR,OAAO,EAAE,IAAI;KACd,CAAC;IAEF,wBAAwB;IACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,aAAa,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC5C,aAAa,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,cAAc;IACd,UAAU,CAAC;QACT,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,iBAAiB,EAAE,SAAS;QAC5B,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,SAAiB,EACjB,OAAiC;IAEjC,MAAM,KAAK,GAAgB;QACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,wBAAwB;IACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,aAAa,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC5C,aAAa,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,cAAc;IACd,UAAU,CAAC;QACT,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,iBAAiB,EAAE,SAAS;QAC5B,UAAU,EAAE,SAAS;QACrB,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,UAAU,CAAC;QACT,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,iBAAiB,EAAE,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,QAAiB,EACjB,UAAkB;IAElB,kBAAkB,GAAG,QAAQ,CAAC;IAE9B,UAAU,CAAC;QACT,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,mBAAmB;QACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,iBAAiB,EAAE,SAAS;QAC5B,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;KACrC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAiB;IACxD,kBAAkB,GAAG,QAAQ,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAS5B,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;YACjB,gBAAgB,EAAE,CAAC;YACnB,kBAAkB,EAAE,CAAC;YACrB,sBAAsB,EAAE,EAAE;YAC1B,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE1D,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE3E,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,OAAO;QACL,aAAa,EAAE,aAAa,CAAC,MAAM;QACnC,kBAAkB,EAAE,UAAU,CAAC,MAAM;QACrC,cAAc,EAAE,MAAM,CAAC,MAAM;QAC7B,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC;QACjE,kBAAkB,EAChB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACtF,sBAAsB,EAAE,gBAAgB;QACxC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;KAChF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,kBAAkB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,CAAC,MAAM,CAAC;AAC9B,CAAC"}

package/dist/tools/docs/search-docs-tool.d.ts

@@ -0,0 +1,54 @@
+/**
+ * MCP Tool implementation for searching Resend documentation.
+ * Provides semantic search with keyword fallback for documentation queries.
+ */
+/**
+ * Get the MCP tool definition for search_resend_documentation.
+ * Includes annotations for tool behavior hints.
+ *
+ * @returns Tool definition object
+ */
+export declare function getDefinition(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+                minLength: number;
+                maxLength: number;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+/**
+ * Execute a documentation search.
+ *
+ * @param args - Raw arguments from MCP call
+ * @returns MCP tool response with search results or error
+ */
+export declare function execute(args: unknown): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=search-docs-tool.d.ts.map

package/dist/tools/docs/search-docs-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/search-docs-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH;;;;;GAKG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC5B;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACpD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CA0ID"}

package/dist/tools/docs/search-docs-tool.js

@@ -0,0 +1,231 @@
+/**
+ * MCP Tool implementation for searching Resend documentation.
+ * Provides semantic search with keyword fallback for documentation queries.
+ */
+import { z } from "zod";
+import { semanticSearch, keywordSearch, truncateToTokenBudget } from "./vector-search.js";
+import { isEmbeddingsLoaded, getFreshnessWarning } from "./embeddings-loader.js";
+import { toDocsError, formatErrorResponse } from "./errors.js";
+import { recordSearch, recordSearchError, setEmbeddingsCacheStatus } from "./metrics.js";
+// NOTE: Use console.error for logging - stdout is reserved for MCP protocol
+const log = (message) => console.error(`[docs-search] ${message}`);
+/** Minimum relevance threshold for semantic search results */
+const SEMANTIC_RELEVANCE_THRESHOLD = 0.3;
+/** Maximum total tokens across all results */
+const MAX_TOTAL_TOKENS = 2800;
+/** Default number of results to return */
+const DEFAULT_LIMIT = 3;
+/** Minimum query length */
+const MIN_QUERY_LENGTH = 3;
+/** Maximum query length */
+const MAX_QUERY_LENGTH = 500;
+/** Maximum results allowed */
+const MAX_LIMIT = 10;
+/**
+ * Zod schema for input validation.
+ */
+const inputSchema = z.object({
+    query: z
+        .string()
+        .min(MIN_QUERY_LENGTH, `Query must be at least ${MIN_QUERY_LENGTH} characters`)
+        .max(MAX_QUERY_LENGTH, `Query must be at most ${MAX_QUERY_LENGTH} characters`)
+        .describe("Search query or question about Resend API usage"),
+    limit: z
+        .number()
+        .int()
+        .min(1, "Limit must be at least 1")
+        .max(MAX_LIMIT, `Limit must be at most ${MAX_LIMIT}`)
+        .default(DEFAULT_LIMIT)
+        .describe("Maximum number of results to return (1-10, default: 3)"),
+});
+/**
+ * Get the MCP tool definition for search_resend_documentation.
+ * Includes annotations for tool behavior hints.
+ *
+ * @returns Tool definition object
+ */
+export function getDefinition() {
+    return {
+        name: "search_resend_documentation",
+        description: "Search Resend API documentation using semantic search. Returns relevant documentation " +
+            "excerpts for API usage, code examples, error handling, and best practices. Use this " +
+            "when you need information about sending emails, managing domains, contacts, audiences, " +
+            "templates, or any other Resend API features.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query or question about Resend API usage",
+                    minLength: MIN_QUERY_LENGTH,
+                    maxLength: MAX_QUERY_LENGTH,
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (1-10, default: 3)",
+                    minimum: 1,
+                    maximum: MAX_LIMIT,
+                    default: DEFAULT_LIMIT,
+                },
+            },
+            required: ["query"],
+        },
+        annotations: {
+            // Tool behavior hints for MCP clients
+            title: "Search Resend Documentation",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    };
+}
+/**
+ * Execute a documentation search.
+ *
+ * @param args - Raw arguments from MCP call
+ * @returns MCP tool response with search results or error
+ */
+export async function execute(args) {
+    const startTime = Date.now();
+    // Validate input
+    const parseResult = inputSchema.safeParse(args);
+    if (!parseResult.success) {
+        const errorMessage = parseResult.error.errors
+            .map((e) => `${e.path.join(".")}: ${e.message}`)
+            .join("; ");
+        const latencyMs = Date.now() - startTime;
+        recordSearchError(latencyMs, "VALIDATION_ERROR", { errors: parseResult.error.errors });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: true,
+                        code: "VALIDATION_ERROR",
+                        message: `Invalid input: ${errorMessage}`,
+                        hint: "Provide a 'query' string (3-500 chars) and optional 'limit' (1-10)",
+                        recoverable: false,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const input = parseResult.data;
+    log(`Searching documentation: "${input.query}" (limit: ${input.limit})`);
+    // Track cache status for metrics
+    const wasCached = isEmbeddingsLoaded();
+    setEmbeddingsCacheStatus(wasCached);
+    try {
+        // Try semantic search first
+        let results = await semanticSearch(input.query, input.limit);
+        let searchType = "semantic";
+        // Check if best semantic result meets quality threshold
+        // Fall back to keyword search if no results OR best result is below threshold
+        const bestScore = results[0]?.score ?? 0;
+        if (results.length === 0 || bestScore < SEMANTIC_RELEVANCE_THRESHOLD) {
+            // Fall back to keyword search
+            log(`Semantic search returned low relevance results (best: ${bestScore.toFixed(3)}), falling back to keyword search`);
+            const keywordResults = await keywordSearch(input.query, input.limit);
+            if (keywordResults.length > 0) {
+                // Use keyword results, mark as keyword search type
+                results = keywordResults;
+                searchType = "keyword";
+            }
+            else if (results.length === 0) {
+                // No results from either search
+                const latencyMs = Date.now() - startTime;
+                recordSearch(latencyMs, 0, "keyword", wasCached);
+                const noResultsResponse = {
+                    query: input.query,
+                    searchType: "keyword",
+                    resultCount: 0,
+                    totalTokens: 0,
+                    results: [],
+                };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(noResultsResponse, null, 2),
+                        },
+                    ],
+                };
+            }
+            // If keyword search returned nothing but we have some semantic results,
+            // keep the semantic results even if below threshold
+        }
+        // Apply token budget
+        const searchResults = applyTokenBudget(results, MAX_TOTAL_TOKENS);
+        // Calculate total tokens
+        const totalTokens = searchResults.reduce((sum, r) => sum + r.tokenCount, 0);
+        // Record successful search metrics
+        const latencyMs = Date.now() - startTime;
+        recordSearch(latencyMs, searchResults.length, searchType, wasCached);
+        // Check for freshness warning
+        const freshnessWarning = getFreshnessWarning();
+        // Build response
+        const response = {
+            query: input.query,
+            searchType,
+            resultCount: searchResults.length,
+            totalTokens,
+            results: searchResults,
+        };
+        // Add freshness warning if present
+        if (freshnessWarning) {
+            response.warning = freshnessWarning;
+        }
+        log(`Search complete: ${searchResults.length} results, ${totalTokens} tokens, type: ${searchType}, latency: ${latencyMs}ms`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        // Convert to structured DocsError
+        const docsError = toDocsError(error);
+        log(`Search error [${docsError.code}]: ${docsError.message}`);
+        // Record error metrics
+        recordSearchError(latencyMs, docsError.code, { message: docsError.message });
+        return {
+            content: [{ type: "text", text: JSON.stringify(formatErrorResponse(docsError), null, 2) }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Apply token budget to search results.
+ * Truncates results to fit within the total token limit.
+ *
+ * @param results - Scored chunks from search
+ * @param maxTotalTokens - Maximum total tokens allowed
+ * @returns Array of SearchResult objects within budget
+ */
+function applyTokenBudget(results, maxTotalTokens) {
+    const searchResults = [];
+    let remainingTokens = maxTotalTokens;
+    for (const result of results) {
+        if (remainingTokens <= 0) {
+            break;
+        }
+        let excerpt = result.content;
+        let tokenCount = result.tokenCount;
+        // Truncate if needed to fit remaining budget
+        if (tokenCount > remainingTokens) {
+            excerpt = truncateToTokenBudget(excerpt, remainingTokens);
+            tokenCount = remainingTokens;
+        }
+        searchResults.push({
+            section: result.section,
+            excerpt,
+            relevance: Math.round(result.score * 1000) / 1000, // Round to 3 decimal places
+            tokenCount,
+            sourceUrl: result.sourceUrl,
+        });
+        remainingTokens -= tokenCount;
+    }
+    return searchResults;
+}
+//# sourceMappingURL=search-docs-tool.js.map

package/dist/tools/docs/search-docs-tool.js.map

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

package/dist/tools/docs/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Runtime types for the documentation search tool.
+ * These types are used during search execution, distinct from the build-time types
+ * in scripts/types.ts used for embedding generation.
+ */
+/**
+ * A search result returned to the user.
+ * Contains the relevant excerpt and metadata about the match.
+ */
+export interface SearchResult {
+    /** Section header or title of the matched documentation */
+    section: string;
+    /** Relevant excerpt from the documentation (may be truncated) */
+    excerpt: string;
+    /** Relevance score (0-1 for semantic, simple match for keyword) */
+    relevance: number;
+    /** Estimated token count of the excerpt */
+    tokenCount: number;
+    /** Optional source URL for the documentation */
+    sourceUrl?: string;
+}
+/**
+ * Internal representation of a chunk with its similarity score.
+ * Used during search ranking before transforming to SearchResult.
+ */
+export interface ScoredChunk {
+    /** Unique identifier for the chunk */
+    id: string;
+    /** Section header or title */
+    section: string;
+    /** Full content of the chunk */
+    content: string;
+    /** Token count of the chunk */
+    tokenCount: number;
+    /** Similarity score (cosine similarity for semantic search) */
+    score: number;
+    /** Optional source URL */
+    sourceUrl?: string;
+}
+/**
+ * Successful search response structure.
+ */
+export interface SearchResponse {
+    /** The search query that was executed */
+    query: string;
+    /** Type of search performed */
+    searchType: "semantic" | "keyword" | "hybrid";
+    /** Number of results returned */
+    resultCount: number;
+    /** Total tokens across all results */
+    totalTokens: number;
+    /** The search results */
+    results: SearchResult[];
+}
+/**
+ * Error response structure for search failures.
+ */
+export interface SearchErrorResponse {
+    /** Error indicator */
+    error: true;
+    /** Error message */
+    message: string;
+    /** Optional hint for resolving the error */
+    hint?: string;
+}
+/**
+ * Union type for search responses.
+ */
+export type SearchResponseType = SearchResponse | SearchErrorResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/docs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,EAAE,IAAI,CAAC;IACZ,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,mBAAmB,CAAC"}

package/dist/tools/docs/types.js

@@ -0,0 +1,7 @@
+/**
+ * Runtime types for the documentation search tool.
+ * These types are used during search execution, distinct from the build-time types
+ * in scripts/types.ts used for embedding generation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/docs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/docs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/docs/vector-search.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Core vector search functionality for documentation.
+ * Provides semantic search using embeddings and keyword search as fallback.
+ */
+import type { ScoredChunk } from "./types.js";
+/**
+ * Type definition for the transformer pipeline.
+ * We use dynamic import to load @xenova/transformers.
+ */
+type Pipeline = (texts: string[], options?: {
+    pooling: string;
+    normalize: boolean;
+}) => Promise<{
+    data: Float32Array;
+}>;
+/**
+ * Load the embedding model (Xenova/all-MiniLM-L6-v2).
+ * Lazy loads on first call and caches for subsequent use.
+ * Includes timeout and retry logic for robustness.
+ *
+ * @returns Promise resolving to the embedding pipeline function
+ */
+export declare function loadEmbedder(): Promise<Pipeline>;
+/**
+ * Generate embedding vector for a query string.
+ *
+ * @param query - The text to embed
+ * @returns Promise resolving to 384-dimensional embedding vector
+ */
+export declare function embedQuery(query: string): Promise<number[]>;
+/**
+ * Compute cosine similarity between two vectors.
+ * Assumes vectors are already normalized (which they are from the model).
+ *
+ * @param a - First vector
+ * @param b - Second vector
+ * @returns Cosine similarity score between -1 and 1
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Perform semantic search using vector embeddings.
+ *
+ * @param query - The search query
+ * @param limit - Maximum number of results to return
+ * @param maxTokensPerResult - Optional max tokens per result for truncation
+ * @returns Promise resolving to array of scored chunks
+ */
+export declare function semanticSearch(query: string, limit: number, maxTokensPerResult?: number): Promise<ScoredChunk[]>;
+/**
+ * Perform keyword-based search as fallback.
+ * Uses simple case-insensitive substring matching with basic relevance scoring.
+ *
+ * @param query - The search query
+ * @param limit - Maximum number of results to return
+ * @returns Promise resolving to array of scored chunks
+ */
+export declare function keywordSearch(query: string, limit: number): Promise<ScoredChunk[]>;
+/**
+ * Truncate content to fit within a token budget.
+ * Uses approximate token estimation (4 chars per token).
+ *
+ * @param content - The content to truncate
+ * @param maxTokens - Maximum tokens allowed
+ * @returns Truncated content with ellipsis if needed
+ */
+export declare function truncateToTokenBudget(content: string, maxTokens: number): string;
+/**
+ * Get statistics about the loaded embeddings.
+ * Useful for debugging and status reporting.
+ *
+ * @returns Object with embeddings statistics, or null if not loaded
+ */
+export declare function getEmbeddingsStats(): Promise<{
+    chunkCount: number;
+    dimensions: number;
+    model: string;
+    generatedAt: string;
+} | null>;
+export {};
+//# sourceMappingURL=vector-search.d.ts.map

package/dist/tools/docs/vector-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/vector-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C;;;GAGG;AACH,KAAK,QAAQ,GAAG,CACd,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,KAC9C,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAuDrC;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAkEtD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUjE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAejE;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAqCxB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAgExB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAyBhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC,CAYR"}