import type { ToolDef } from "./index.js";
/**
 * Live documentation tools (`search_docs` + `get_doc`).
 *
 * Unlike the marketing/troubleshooting skills (embedded at build time, stale
 * until the next npm release), these fetch the PUBLIC docs site live, so the
 * answer always reflects the currently published documentation:
 *
 *  - docs.sealmetrics.com publishes an `llms.txt` index (title + URL + one-line
 *    description per page) and a plain-text mirror of every page under
 *    `/docs-raw/<path>.txt`. Both are static GitHub Pages assets with CORS `*`.
 *  - `search_docs` downloads the index (cached in memory for a few minutes),
 *    ranks pages against the query and returns the matches.
 *  - `get_doc` fetches one page's raw text mirror.
 *
 * Registered in ALL_TOOLS, so they inherit the read-only gate (hidden without
 * an api_key) and are available on both the stdio and remote transports (no
 * API scopes involved — the handlers never touch `client`).
 */
export declare const DOCS_BASE_URL = "https://docs.sealmetrics.com";
export interface DocsIndexEntry {
    title: string;
    /** Site-relative page path, e.g. "getting-started/quick-start". */
    path: string;
    url: string;
    rawUrl: string;
    description: string;
    section: string;
}
/**
 * Parse the llms.txt index. Expected shape (one entry per page):
 *
 *   ### Section Title
 *   - [Page Title](https://docs.sealmetrics.com/some/path): One-line description.
 *     Raw: https://docs.sealmetrics.com/docs-raw/some/path.txt
 */
export declare function parseLlmsIndex(text: string): DocsIndexEntry[];
/** Test hook: drop the in-memory llms.txt cache. */
export declare function clearDocsIndexCache(): void;
export declare function scoreEntry(entry: DocsIndexEntry, query: string, tokens: string[]): number;
export declare function searchIndex(entries: DocsIndexEntry[], query: string, limit: number): DocsIndexEntry[];
/**
 * Accepts "getting-started/quick-start", "/getting-started/quick-start", a full
 * docs URL, or the raw-mirror URL, and normalizes to the site-relative path.
 */
export declare function normalizeDocPath(input: string): string;
export declare const searchDocsTool: ToolDef;
export declare const getDocTool: ToolDef;
//# sourceMappingURL=docs.d.ts.map