mcp-resend 1.0.0-1

package/dist/tools/docs/embeddings-loader.js

@@ -0,0 +1,218 @@
+/**
+ * Lazy loader for pre-computed embeddings.
+ * Loads embeddings from data/embeddings.json on first access and caches them.
+ * Uses ES module path resolution for compatibility with both dev (tsx) and production (node).
+ */
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createDocsError, DocsErrorCode } from "./errors.js";
+// NOTE: Use console.error for logging - stdout is reserved for MCP protocol
+const log = (message) => console.error(`[docs-search] ${message}`);
+/** Expected schema version - must match build-embeddings.ts INDEX_VERSION */
+export const EXPECTED_SCHEMA_VERSION = "1.0.0";
+/** Expected embedding dimensions for Xenova/all-MiniLM-L6-v2 */
+export const EXPECTED_DIMENSIONS = 384;
+/** Maximum age in days before showing a warning */
+const FRESHNESS_WARNING_DAYS = 14;
+/** Maximum age in days before returning an error hint */
+const FRESHNESS_ERROR_DAYS = 30;
+/** Cached embeddings index, null if not yet loaded */
+let cachedEmbeddings = null;
+/** Loading promise to prevent concurrent loads */
+let loadingPromise = null;
+/** Freshness warning message if embeddings are stale */
+let freshnessWarning = null;
+/**
+ * Resolve the path to the embeddings.json file.
+ * Uses import.meta.url for ES module path resolution.
+ *
+ * In development (tsx): src/tools/docs/embeddings-loader.ts -> data/embeddings.json
+ * In production (node): dist/tools/docs/embeddings-loader.js -> data/embeddings.json
+ *
+ * Both resolve to the same data/ directory at project root.
+ */
+function getEmbeddingsPath() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    // From src/tools/docs/ or dist/tools/docs/, go up 3 levels to project root
+    return join(currentDir, "..", "..", "..", "data", "embeddings.json");
+}
+/**
+ * Validate the schema version of loaded embeddings.
+ *
+ * @param index - The loaded embeddings index
+ * @throws DocsError if version mismatch
+ */
+function validateSchemaVersion(index) {
+    if (!index.version) {
+        throw createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, "Embeddings file missing version field");
+    }
+    // For now, only accept exact version match
+    // Future: implement semver compatibility checking
+    if (index.version !== EXPECTED_SCHEMA_VERSION) {
+        throw createDocsError(DocsErrorCode.EMBEDDINGS_VERSION_MISMATCH, `Embeddings version mismatch: expected ${EXPECTED_SCHEMA_VERSION}, got ${index.version}`);
+    }
+}
+/**
+ * Check embeddings freshness and set warning if stale.
+ *
+ * @param index - The loaded embeddings index
+ * @returns Warning message if stale, null otherwise
+ */
+function checkFreshness(index) {
+    if (!index.generatedAt) {
+        return "Embeddings file missing generatedAt timestamp";
+    }
+    const generatedDate = new Date(index.generatedAt);
+    const now = new Date();
+    const ageMs = now.getTime() - generatedDate.getTime();
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    if (ageDays > FRESHNESS_ERROR_DAYS) {
+        return `Embeddings are ${Math.floor(ageDays)} days old (generated: ${index.generatedAt}). Consider running 'npm run build:embeddings' to update.`;
+    }
+    if (ageDays > FRESHNESS_WARNING_DAYS) {
+        return `Embeddings are ${Math.floor(ageDays)} days old. Consider refreshing soon.`;
+    }
+    return null;
+}
+/**
+ * Validate embedding dimensions match expected model output.
+ *
+ * @param index - The loaded embeddings index
+ * @throws DocsError if dimension mismatch
+ */
+function validateDimensions(index) {
+    if (index.dimensions !== EXPECTED_DIMENSIONS) {
+        throw createDocsError(DocsErrorCode.DIMENSION_MISMATCH, `Embeddings dimension mismatch: expected ${EXPECTED_DIMENSIONS}, got ${index.dimensions}. ` +
+            "This may indicate the embeddings were generated with a different model.");
+    }
+    // Also validate first chunk's actual embedding length
+    if (index.chunks.length > 0) {
+        const firstChunk = index.chunks[0];
+        if (firstChunk.embedding && firstChunk.embedding.length !== index.dimensions) {
+            throw createDocsError(DocsErrorCode.DIMENSION_MISMATCH, `Chunk embedding dimension mismatch: header says ${index.dimensions}, actual is ${firstChunk.embedding.length}`);
+        }
+    }
+}
+/**
+ * Load embeddings from disk.
+ * This is the internal loader, called once and cached.
+ * Performs schema version validation and freshness checks.
+ */
+async function loadFromDisk() {
+    const embeddingsPath = getEmbeddingsPath();
+    log(`Loading embeddings from: ${embeddingsPath}`);
+    const startTime = Date.now();
+    try {
+        const content = await readFile(embeddingsPath, "utf-8");
+        let index;
+        try {
+            index = JSON.parse(content);
+        }
+        catch (parseError) {
+            throw createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, `Failed to parse embeddings JSON: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+        }
+        const loadTime = Date.now() - startTime;
+        log(`Loaded ${index.chunks.length} chunks (${index.dimensions}D vectors) in ${loadTime}ms`);
+        // Validate schema version
+        validateSchemaVersion(index);
+        // Validate dimensions
+        validateDimensions(index);
+        // Validate basic structure
+        if (!index.chunks || !Array.isArray(index.chunks)) {
+            throw createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, "Invalid embeddings format: missing chunks array");
+        }
+        if (index.chunks.length === 0) {
+            throw createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, "Invalid embeddings format: empty chunks array");
+        }
+        // Validate first chunk has expected fields
+        const firstChunk = index.chunks[0];
+        if (!firstChunk.embedding || !Array.isArray(firstChunk.embedding)) {
+            throw createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, "Invalid embeddings format: chunk missing embedding array");
+        }
+        // Check freshness and store warning
+        freshnessWarning = checkFreshness(index);
+        if (freshnessWarning) {
+            log(`Freshness warning: ${freshnessWarning}`);
+        }
+        return index;
+    }
+    catch (error) {
+        // Re-throw DocsError as-is
+        if (error && typeof error === "object" && "code" in error) {
+            throw error;
+        }
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            throw createDocsError(DocsErrorCode.EMBEDDINGS_NOT_FOUND, `Embeddings file not found at ${embeddingsPath}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Load embeddings asynchronously with caching.
+ * Safe to call multiple times; will return cached data after first load.
+ * Concurrent calls will share the same loading promise.
+ *
+ * @returns Promise resolving to the embeddings index
+ * @throws Error if embeddings file is missing or invalid
+ */
+export async function loadEmbeddings() {
+    // Return cached if available
+    if (cachedEmbeddings !== null) {
+        return cachedEmbeddings;
+    }
+    // If already loading, wait for that promise
+    if (loadingPromise !== null) {
+        return loadingPromise;
+    }
+    // Start loading and cache the promise
+    loadingPromise = loadFromDisk()
+        .then((index) => {
+        cachedEmbeddings = index;
+        loadingPromise = null;
+        return index;
+    })
+        .catch((error) => {
+        loadingPromise = null;
+        throw error;
+    });
+    return loadingPromise;
+}
+/**
+ * Get cached embeddings synchronously.
+ * Returns null if embeddings haven't been loaded yet.
+ * Use loadEmbeddings() for guaranteed access.
+ *
+ * @returns The cached embeddings index, or null if not loaded
+ */
+export function getLoadedEmbeddings() {
+    return cachedEmbeddings;
+}
+/**
+ * Clear the embeddings cache.
+ * Primarily for testing purposes.
+ */
+export function clearEmbeddingsCache() {
+    cachedEmbeddings = null;
+    loadingPromise = null;
+    freshnessWarning = null;
+    log("Embeddings cache cleared");
+}
+/**
+ * Get the freshness warning message if embeddings are stale.
+ * Returns null if embeddings are fresh or not yet loaded.
+ *
+ * @returns Freshness warning message, or null
+ */
+export function getFreshnessWarning() {
+    return freshnessWarning;
+}
+/**
+ * Check if embeddings are currently loaded.
+ *
+ * @returns true if embeddings are cached
+ */
+export function isEmbeddingsLoaded() {
+    return cachedEmbeddings !== null;
+}
+//# sourceMappingURL=embeddings-loader.js.map

package/dist/tools/docs/embeddings-loader.js.map

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

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

@@ -0,0 +1,75 @@
+/**
+ * Structured error definitions for the documentation search tool.
+ * Provides consistent error codes, messages, hints, and recoverability flags.
+ */
+/**
+ * Error codes for documentation search failures.
+ */
+export declare enum DocsErrorCode {
+    /** Embeddings file not found at expected path */
+    EMBEDDINGS_NOT_FOUND = "EMBEDDINGS_NOT_FOUND",
+    /** Embeddings file exists but is corrupted or malformed */
+    EMBEDDINGS_CORRUPT = "EMBEDDINGS_CORRUPT",
+    /** Embeddings file version does not match expected schema version */
+    EMBEDDINGS_VERSION_MISMATCH = "EMBEDDINGS_VERSION_MISMATCH",
+    /** Failed to load the embedding model */
+    MODEL_LOAD_FAILURE = "MODEL_LOAD_FAILURE",
+    /** Network request timed out */
+    NETWORK_TIMEOUT = "NETWORK_TIMEOUT",
+    /** Vector dimensions do not match between query and stored embeddings */
+    DIMENSION_MISMATCH = "DIMENSION_MISMATCH",
+    /** General search failure */
+    SEARCH_FAILED = "SEARCH_FAILED",
+    /** Embeddings are stale and should be regenerated */
+    EMBEDDINGS_STALE = "EMBEDDINGS_STALE"
+}
+/**
+ * Structured error with code, message, hint, and recoverability.
+ */
+export interface DocsError {
+    /** Machine-readable error code */
+    code: DocsErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Actionable hint for resolving the error */
+    hint: string;
+    /** Whether the error is potentially recoverable with retry */
+    recoverable: boolean;
+}
+/**
+ * Create a structured DocsError from an error code and message.
+ *
+ * @param code - The error code
+ * @param message - Custom error message describing the specific failure
+ * @returns A structured DocsError object
+ */
+export declare function createDocsError(code: DocsErrorCode, message: string): DocsError;
+/**
+ * Type guard to check if an error is a DocsError.
+ *
+ * @param error - The error to check
+ * @returns True if the error is a DocsError
+ */
+export declare function isDocsError(error: unknown): error is DocsError;
+/**
+ * Convert an unknown error to a DocsError.
+ * Attempts to classify the error based on its message.
+ *
+ * @param error - The error to convert
+ * @returns A structured DocsError
+ */
+export declare function toDocsError(error: unknown): DocsError;
+/**
+ * Format a DocsError for MCP response output.
+ *
+ * @param error - The DocsError to format
+ * @returns Formatted error object suitable for JSON serialization
+ */
+export declare function formatErrorResponse(error: DocsError): {
+    error: true;
+    code: string;
+    message: string;
+    hint: string;
+    recoverable: boolean;
+};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,iDAAiD;IACjD,oBAAoB,yBAAyB;IAC7C,2DAA2D;IAC3D,kBAAkB,uBAAuB;IACzC,qEAAqE;IACrE,2BAA2B,gCAAgC;IAC3D,yCAAyC;IACzC,kBAAkB,uBAAuB;IACzC,gCAAgC;IAChC,eAAe,oBAAoB;IACnC,yEAAyE;IACzE,kBAAkB,uBAAuB;IACzC,6BAA6B;IAC7B,aAAa,kBAAkB;IAC/B,qDAAqD;IACrD,gBAAgB,qBAAqB;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;CACtB;AAwCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAQ/E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAU9D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAmCrD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG;IACrD,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB,CAQA"}

package/dist/tools/docs/errors.js

@@ -0,0 +1,145 @@
+/**
+ * Structured error definitions for the documentation search tool.
+ * Provides consistent error codes, messages, hints, and recoverability flags.
+ */
+/**
+ * Error codes for documentation search failures.
+ */
+export var DocsErrorCode;
+(function (DocsErrorCode) {
+    /** Embeddings file not found at expected path */
+    DocsErrorCode["EMBEDDINGS_NOT_FOUND"] = "EMBEDDINGS_NOT_FOUND";
+    /** Embeddings file exists but is corrupted or malformed */
+    DocsErrorCode["EMBEDDINGS_CORRUPT"] = "EMBEDDINGS_CORRUPT";
+    /** Embeddings file version does not match expected schema version */
+    DocsErrorCode["EMBEDDINGS_VERSION_MISMATCH"] = "EMBEDDINGS_VERSION_MISMATCH";
+    /** Failed to load the embedding model */
+    DocsErrorCode["MODEL_LOAD_FAILURE"] = "MODEL_LOAD_FAILURE";
+    /** Network request timed out */
+    DocsErrorCode["NETWORK_TIMEOUT"] = "NETWORK_TIMEOUT";
+    /** Vector dimensions do not match between query and stored embeddings */
+    DocsErrorCode["DIMENSION_MISMATCH"] = "DIMENSION_MISMATCH";
+    /** General search failure */
+    DocsErrorCode["SEARCH_FAILED"] = "SEARCH_FAILED";
+    /** Embeddings are stale and should be regenerated */
+    DocsErrorCode["EMBEDDINGS_STALE"] = "EMBEDDINGS_STALE";
+})(DocsErrorCode || (DocsErrorCode = {}));
+/**
+ * Error definitions with their hints and recoverability.
+ */
+const ERROR_DEFINITIONS = {
+    [DocsErrorCode.EMBEDDINGS_NOT_FOUND]: {
+        hint: "Run 'npm run build:embeddings' to generate the embeddings index.",
+        recoverable: false,
+    },
+    [DocsErrorCode.EMBEDDINGS_CORRUPT]: {
+        hint: "Run 'npm run build:embeddings:force' to regenerate the embeddings index.",
+        recoverable: false,
+    },
+    [DocsErrorCode.EMBEDDINGS_VERSION_MISMATCH]: {
+        hint: "Run 'npm run build:embeddings:force' to regenerate with the current schema version.",
+        recoverable: false,
+    },
+    [DocsErrorCode.MODEL_LOAD_FAILURE]: {
+        hint: "Check network connectivity. The model is downloaded on first use. Retry may help.",
+        recoverable: true,
+    },
+    [DocsErrorCode.NETWORK_TIMEOUT]: {
+        hint: "Network request timed out. Check your connection and retry.",
+        recoverable: true,
+    },
+    [DocsErrorCode.DIMENSION_MISMATCH]: {
+        hint: "Embeddings were generated with a different model. Run 'npm run build:embeddings:force' to regenerate.",
+        recoverable: false,
+    },
+    [DocsErrorCode.SEARCH_FAILED]: {
+        hint: "Check server logs for details. If the issue persists, try regenerating embeddings.",
+        recoverable: true,
+    },
+    [DocsErrorCode.EMBEDDINGS_STALE]: {
+        hint: "Embeddings are outdated. Run 'npm run build:embeddings' to update.",
+        recoverable: false,
+    },
+};
+/**
+ * Create a structured DocsError from an error code and message.
+ *
+ * @param code - The error code
+ * @param message - Custom error message describing the specific failure
+ * @returns A structured DocsError object
+ */
+export function createDocsError(code, message) {
+    const definition = ERROR_DEFINITIONS[code];
+    return {
+        code,
+        message,
+        hint: definition.hint,
+        recoverable: definition.recoverable,
+    };
+}
+/**
+ * Type guard to check if an error is a DocsError.
+ *
+ * @param error - The error to check
+ * @returns True if the error is a DocsError
+ */
+export function isDocsError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        "message" in error &&
+        "hint" in error &&
+        "recoverable" in error &&
+        Object.values(DocsErrorCode).includes(error.code));
+}
+/**
+ * Convert an unknown error to a DocsError.
+ * Attempts to classify the error based on its message.
+ *
+ * @param error - The error to convert
+ * @returns A structured DocsError
+ */
+export function toDocsError(error) {
+    // Already a DocsError
+    if (isDocsError(error)) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    // Classify based on message content
+    if (message.includes("ENOENT") || message.includes("not found")) {
+        return createDocsError(DocsErrorCode.EMBEDDINGS_NOT_FOUND, message);
+    }
+    if (message.includes("Invalid embeddings format") || message.includes("JSON")) {
+        return createDocsError(DocsErrorCode.EMBEDDINGS_CORRUPT, message);
+    }
+    if (message.includes("version") || message.includes("schema")) {
+        return createDocsError(DocsErrorCode.EMBEDDINGS_VERSION_MISMATCH, message);
+    }
+    if (message.includes("dimension") || message.includes("Vector dimension mismatch")) {
+        return createDocsError(DocsErrorCode.DIMENSION_MISMATCH, message);
+    }
+    if (message.includes("model") || message.includes("pipeline") || message.includes("transformers")) {
+        return createDocsError(DocsErrorCode.MODEL_LOAD_FAILURE, message);
+    }
+    if (message.includes("timeout") || message.includes("ETIMEDOUT")) {
+        return createDocsError(DocsErrorCode.NETWORK_TIMEOUT, message);
+    }
+    // Default to generic search failure
+    return createDocsError(DocsErrorCode.SEARCH_FAILED, message);
+}
+/**
+ * Format a DocsError for MCP response output.
+ *
+ * @param error - The DocsError to format
+ * @returns Formatted error object suitable for JSON serialization
+ */
+export function formatErrorResponse(error) {
+    return {
+        error: true,
+        code: error.code,
+        message: error.message,
+        hint: error.hint,
+        recoverable: error.recoverable,
+    };
+}
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Documentation search tool module exports.
+ * Provides semantic search functionality for Resend API documentation.
+ */
+export { getDefinition as getSearchDocsDefinition, execute as executeSearchDocs, } from "./search-docs-tool.js";
+export type { SearchResult, SearchResponse, SearchErrorResponse, SearchResponseType, ScoredChunk, } from "./types.js";
+export { DocsErrorCode, createDocsError, isDocsError, toDocsError, formatErrorResponse, type DocsError, } from "./errors.js";
+export { recordSearch, recordSearchError, recordModelLoaded, recordEmbeddingsLoaded, setEmbeddingsCacheStatus, getSearchStats, clearMetricsHistory, getHistorySize, type SearchMetrics, type MetricType, } from "./metrics.js";
+export { loadEmbeddings, getLoadedEmbeddings, clearEmbeddingsCache, isEmbeddingsLoaded, getFreshnessWarning, EXPECTED_SCHEMA_VERSION, EXPECTED_DIMENSIONS, } from "./embeddings-loader.js";
+export { semanticSearch, keywordSearch, cosineSimilarity, truncateToTokenBudget, getEmbeddingsStats, loadEmbedder, } from "./vector-search.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,aAAa,IAAI,uBAAuB,EACxC,OAAO,IAAI,iBAAiB,GAC7B,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/tools/docs/index.js

@@ -0,0 +1,14 @@
+/**
+ * Documentation search tool module exports.
+ * Provides semantic search functionality for Resend API documentation.
+ */
+// Tool implementation
+export { getDefinition as getSearchDocsDefinition, execute as executeSearchDocs, } from "./search-docs-tool.js";
+// Error handling
+export { DocsErrorCode, createDocsError, isDocsError, toDocsError, formatErrorResponse, } from "./errors.js";
+// Metrics
+export { recordSearch, recordSearchError, recordModelLoaded, recordEmbeddingsLoaded, setEmbeddingsCacheStatus, getSearchStats, clearMetricsHistory, getHistorySize, } from "./metrics.js";
+// Utilities for testing/debugging
+export { loadEmbeddings, getLoadedEmbeddings, clearEmbeddingsCache, isEmbeddingsLoaded, getFreshnessWarning, EXPECTED_SCHEMA_VERSION, EXPECTED_DIMENSIONS, } from "./embeddings-loader.js";
+export { semanticSearch, keywordSearch, cosineSimilarity, truncateToTokenBudget, getEmbeddingsStats, loadEmbedder, } from "./vector-search.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/docs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,OAAO,EACL,aAAa,IAAI,uBAAuB,EACxC,OAAO,IAAI,iBAAiB,GAC7B,MAAM,uBAAuB,CAAC;AAW/B,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,WAAW,EACX,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,cAAc,GAGf,MAAM,cAAc,CAAC;AAEtB,kCAAkC;AAClC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,94 @@
+/**
+ * Metrics tracking for documentation search.
+ * Collects search performance metrics and outputs them as JSON lines to stderr.
+ */
+/**
+ * Metric types for documentation search.
+ */
+export type MetricType = "search_completed" | "search_error" | "model_loaded" | "embeddings_loaded";
+/**
+ * Search metrics data structure.
+ */
+export interface SearchMetrics {
+    /** Metric type identifier */
+    _type: "metric";
+    /** Name of the metric */
+    name: MetricType;
+    /** Timestamp in ISO format */
+    timestamp: string;
+    /** Search latency in milliseconds */
+    search_latency_ms?: number;
+    /** Number of results returned */
+    result_count?: number;
+    /** Type of search performed */
+    search_type?: "semantic" | "keyword" | "hybrid";
+    /** Whether embeddings were cached */
+    cache_hit?: boolean;
+    /** Error code if search failed */
+    error_code?: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+/**
+ * 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 declare function recordSearch(latencyMs: number, resultCount: number, searchType: "semantic" | "keyword" | "hybrid", cacheHit: boolean): void;
+/**
+ * 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 declare function recordSearchError(latencyMs: number, errorCode: string, context?: Record<string, unknown>): void;
+/**
+ * Record model loaded event.
+ *
+ * @param latencyMs - Model load time in milliseconds
+ */
+export declare function recordModelLoaded(latencyMs: number): void;
+/**
+ * Record embeddings loaded event.
+ *
+ * @param latencyMs - Embeddings load time in milliseconds
+ * @param cacheHit - Whether loaded from cache
+ * @param chunkCount - Number of chunks loaded
+ */
+export declare function recordEmbeddingsLoaded(latencyMs: number, cacheHit: boolean, chunkCount: number): void;
+/**
+ * Check if embeddings are cached (for cache_hit metric).
+ *
+ * @param isCached - Whether embeddings are currently cached
+ */
+export declare function setEmbeddingsCacheStatus(isCached: boolean): void;
+/**
+ * Get aggregated statistics from the rolling window.
+ *
+ * @returns Statistics object with averages and counts
+ */
+export declare function getSearchStats(): {
+    totalSearches: number;
+    successfulSearches: number;
+    failedSearches: number;
+    averageLatencyMs: number;
+    averageResultCount: number;
+    searchTypeDistribution: Record<string, number>;
+    cacheHitRate: number;
+};
+/**
+ * Clear metrics history.
+ * Primarily for testing purposes.
+ */
+export declare function clearMetricsHistory(): void;
+/**
+ * Get the current rolling window size.
+ *
+ * @returns Number of entries in the rolling window
+ */
+export declare function getHistorySize(): number;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAgCD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,EAC7C,QAAQ,EAAE,OAAO,GAChB,IAAI,CA0BN;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAyBN;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB,CAmCA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}