@oomkapwn/enquire-mcp 3.7.18 → 3.7.20

package/dist/tools.d.ts

@@ -1,980 +0,0 @@
-import type { Embed, Wikilink } from "./parser.js";
-import type { Vault } from "./vault.js";
-export interface NoteSummary {
-    title: string;
-    path: string;
-    frontmatter: Record<string, unknown>;
-    tags: string[];
-    mtime: string;
-}
-export declare function listNotes(vault: Vault, args: {
-    tag?: string;
-    folder?: string;
-    since_date?: string;
-    limit?: number;
-}): Promise<NoteSummary[]>;
-export interface NoteReadFull {
-    path: string;
-    title: string;
-    content: string;
-    frontmatter: Record<string, unknown>;
-    wikilinks: Wikilink[];
-    embeds: Embed[];
-    tags: string[];
-    mtime: string;
-}
-export interface NoteReadMap {
-    path: string;
-    title: string;
-    format: "map";
-    frontmatter_keys: string[];
-    headings: Array<{
-        level: number;
-        text: string;
-        line: number;
-    }>;
-    wikilinks_count: number;
-    embeds_count: number;
-    tags: string[];
-    mtime: string;
-    byte_size: number;
-}
-export declare function readNote(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    format?: "full" | "map";
-}): Promise<NoteReadFull | NoteReadMap>;
-export declare function resolveWikilink(vault: Vault, args: {
-    wikilink: string;
-    from_note?: string;
-    include_content?: boolean;
-}): Promise<{
-    found: boolean;
-    path: string | null;
-    title: string | null;
-    content: string | null;
-    section: string | null;
-    block: string | null;
-    alias: string | null;
-}>;
-export type SearchMode = "all" | "any" | "phrase";
-export interface SearchHit {
-    path: string;
-    snippet: string;
-    score: number;
-    line: number;
-    matched_terms: string[];
-}
-export interface SearchResponse {
-    query: string;
-    mode: SearchMode;
-    scanned_notes: number;
-    matches: SearchHit[];
-}
-export declare function searchText(vault: Vault, args: {
-    query: string;
-    folder?: string;
-    limit?: number;
-    mode?: SearchMode;
-}): Promise<SearchResponse>;
-export declare function getRecentEdits(vault: Vault, args: {
-    since_minutes?: number;
-    limit?: number;
-    folder?: string;
-}): Promise<NoteSummary[]>;
-export interface BacklinkHit {
-    path: string;
-    title: string;
-    count: number;
-    snippets: string[];
-    link_kind: "wikilink" | "embed" | "mixed";
-}
-export declare function getBacklinks(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    limit?: number;
-    include_embeds?: boolean;
-}): Promise<BacklinkHit[]>;
-export declare function dataviewQuery(vault: Vault, args: {
-    query: string;
-}): Promise<{
-    query: string;
-    rows: Array<Record<string, unknown>>;
-}>;
-export interface UnresolvedWikilink {
-    from_path: string;
-    target: string;
-    raw: string;
-    kind: "wikilink" | "embed";
-    alias: string | null;
-    section: string | null;
-    block: string | null;
-    line: number;
-    snippet: string;
-}
-export declare function getUnresolvedWikilinks(vault: Vault, args: {
-    folder?: string;
-    include_embeds?: boolean;
-    limit?: number;
-}): Promise<UnresolvedWikilink[]>;
-export interface OutboundLink {
-    raw: string;
-    target: string;
-    kind: "wikilink" | "embed";
-    alias: string | null;
-    section: string | null;
-    block: string | null;
-    resolved_path: string | null;
-    resolved_title: string | null;
-}
-export declare function getOutboundLinks(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    include_embeds?: boolean;
-    include_unresolved?: boolean;
-}): Promise<{
-    from_path: string;
-    from_title: string;
-    links: OutboundLink[];
-}>;
-export interface TagSummary {
-    tag: string;
-    count: number;
-    frontmatter_count: number;
-    inline_count: number;
-}
-export declare function listTags(vault: Vault, args: {
-    folder?: string;
-    min_count?: number;
-    limit?: number;
-}): Promise<TagSummary[]>;
-export declare function createNote(vault: Vault, args: {
-    path: string;
-    content: string;
-    frontmatter?: Record<string, unknown>;
-    overwrite?: boolean;
-}): Promise<{
-    path: string;
-    mtime: string;
-    bytes: number;
-}>;
-export declare function appendToNote(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    content: string;
-    separator?: string;
-}): Promise<{
-    path: string;
-    mtime: string;
-    appended_bytes: number;
-}>;
-export interface RenameProposal {
-    path: string;
-    rewrites: number;
-    before: string;
-    after: string;
-}
-export interface RenameNoteResult {
-    from: string;
-    to: string;
-    dry_run: boolean;
-    files_updated: RenameProposal[];
-    total_links_rewritten: number;
-}
-export declare function renameNote(vault: Vault, args: {
-    from: string;
-    to: string;
-    dry_run?: boolean;
-    overwrite?: boolean;
-}): Promise<RenameNoteResult>;
-export interface ArchiveNoteArgs {
-    /** Vault-relative path of the note to archive (with or without `.md`). */
-    path: string;
-    /** Archive folder. Defaults to `Archive/`. Trailing slash optional. */
-    archive_folder?: string;
-    /** Preview the rewrite plan without writing. Default false. */
-    dry_run?: boolean;
-    /** Allow overwriting an existing file at the archive destination. Default false. */
-    overwrite?: boolean;
-}
-export interface ChatThreadAppendArgs {
-    /** Vault-relative path to the note hosting the thread. Created if absent. */
-    note_path: string;
-    /** Role of the message being appended. */
-    role: "user" | "assistant" | "system";
-    /** Message body (markdown allowed). */
-    content: string;
-    /** Optional thread title — used when the note is created from scratch. */
-    thread_title?: string;
-}
-export interface ChatThreadMessage {
-    role: "user" | "assistant" | "system";
-    timestamp: string;
-    content: string;
-    /** 1-based start line in the source note (for jumping to that point). */
-    line_start: number;
-    line_end: number;
-}
-export interface ChatThreadReadResult {
-    note_path: string;
-    thread_title: string | null;
-    messages: ChatThreadMessage[];
-    message_count: number;
-}
-/** Append a message to a note's chat thread. Creates the note (and the
- *  `## Chat: <title>` heading) if absent. Idempotent in the sense that
- *  appending always creates a fresh `### <role> · <timestamp>` block — no
- *  silent overwrites. */
-export declare function chatThreadAppend(vault: Vault, args: ChatThreadAppendArgs): Promise<{
-    note_path: string;
-    line_start: number;
-    line_end: number;
-}>;
-/** Parse a note's chat thread into structured messages. Non-chat content
- *  (anything outside the `## Chat: <title>` block) is ignored. */
-export declare function chatThreadRead(vault: Vault, args: {
-    note_path: string;
-}): Promise<ChatThreadReadResult>;
-export declare function frontmatterGet(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    key?: string;
-}): Promise<{
-    path: string;
-    frontmatter: Record<string, unknown>;
-    value?: unknown;
-}>;
-export interface FrontmatterSetArgs {
-    path?: string;
-    title?: string;
-    /** Keys to set. Setting a key to `null` deletes it. */
-    set: Record<string, unknown>;
-    /** Optional: dry_run shows the diff without writing. */
-    dry_run?: boolean;
-}
-export declare function frontmatterSet(vault: Vault, args: FrontmatterSetArgs): Promise<{
-    path: string;
-    changed_keys: string[];
-    before: Record<string, unknown>;
-    after: Record<string, unknown>;
-    dry_run: boolean;
-}>;
-/** Find every note where frontmatter.<key> matches a predicate. Useful as
- *  a precursor to bulk frontmatter_set: "find all notes with status:draft
- *  and set their status to published".
- *
- *  Predicate semantics:
- *    - `equals: <value>`   — strict equality (JSON.stringify comparison)
- *    - `exists: true`      — key must exist (any value)
- *    - `contains: <value>` — for array values, value must be a member
- *  Exactly one predicate must be set. */
-export interface FrontmatterSearchArgs {
-    key: string;
-    equals?: unknown;
-    exists?: boolean;
-    contains?: unknown;
-    folder?: string;
-    limit?: number;
-}
-export declare function frontmatterSearch(vault: Vault, args: FrontmatterSearchArgs): Promise<{
-    key: string;
-    total_matches: number;
-    matches: Array<{
-        path: string;
-        value: unknown;
-        mtime: string;
-    }>;
-}>;
-export declare function archiveNote(vault: Vault, args: ArchiveNoteArgs): Promise<RenameNoteResult>;
-export interface ReplaceInNotesArgs {
-    /** Literal substring to find. Empty string is rejected. */
-    search: string;
-    /** Replacement text. May be empty (= delete every occurrence). */
-    replace: string;
-    /** Restrict to a subfolder (vault-relative). Default: whole vault. */
-    folder?: string;
-    /** Preview the rewrite plan without touching disk. Default false. */
-    dry_run?: boolean;
-    /** Case-sensitive match (default true). False = case-insensitive substring. */
-    case_sensitive?: boolean;
-}
-export interface ReplaceInNotesFileResult {
-    path: string;
-    occurrences: number;
-}
-export interface ReplaceInNotesResult {
-    search: string;
-    replace: string;
-    case_sensitive: boolean;
-    dry_run: boolean;
-    scope: string;
-    files_scanned: number;
-    files_updated: ReplaceInNotesFileResult[];
-    total_replacements: number;
-    /** v2.0.0-beta.2 P1: when true, the apply pass aborted partway through.
-     *  `files_updated` only contains files that DID write successfully. Files
-     *  in `errors` (if present) failed mid-write — caller should retry just
-     *  those and verify state. Always false on dry_run. */
-    partial: boolean;
-    /** v2.0.0-beta.2 P1: per-file write errors collected during apply. Only
-     *  populated when the apply phase encountered errors (so happy-path
-     *  responses stay narrow). */
-    errors?: Array<{
-        path: string;
-        message: string;
-    }>;
-}
-export declare function replaceInNotes(vault: Vault, args: ReplaceInNotesArgs): Promise<ReplaceInNotesResult>;
-export interface ValidateProposalArgs {
-    /** Vault-relative path the LLM intends to write to (e.g. "Inbox/idea.md"). */
-    path: string;
-    /** Full proposed markdown content including any frontmatter block. */
-    content: string;
-    /** "create" (default) → fail if path exists. "overwrite" / "append" → ok if exists. */
-    mode?: "create" | "overwrite" | "append";
-}
-export interface ValidateProposalResult {
-    ok: boolean;
-    proposed_path: string;
-    mode: "create" | "overwrite" | "append";
-    errors: Array<{
-        kind: string;
-        message: string;
-    }>;
-    warnings: Array<{
-        kind: string;
-        message: string;
-        suggestion?: string;
-    }>;
-    yaml: {
-        parsed: boolean;
-        error: string | null;
-        keys: string[];
-    };
-    wikilinks: Array<{
-        raw: string;
-        target: string;
-        status: "resolved" | "broken" | "ambiguous";
-        resolved_path: string | null;
-        suggestions: string[];
-    }>;
-    tags: Array<{
-        name: string;
-        status: "existing" | "new";
-    }>;
-    collision: {
-        kind: "none" | "path-exists" | "title-exists-elsewhere";
-        existing_path?: string;
-    };
-}
-export declare function validateNoteProposal(vault: Vault, args: ValidateProposalArgs): Promise<ValidateProposalResult>;
-export interface SimilarNote {
-    path: string;
-    title: string;
-    score: number;
-    signals: {
-        tag_jaccard: number;
-        title_3gram: number;
-        shared_outbound: number;
-        co_backlink: number;
-    };
-    shared_tags: string[];
-    mtime: string;
-}
-export declare function findSimilar(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    limit?: number;
-    min_score?: number;
-}): Promise<SimilarNote[]>;
-export interface NoteNeighbors {
-    center: {
-        path: string;
-        title: string;
-        tags: string[];
-        mtime: string;
-    };
-    outbound: Array<{
-        path: string;
-        title: string;
-        tags: string[];
-    }>;
-    inbound: Array<{
-        path: string;
-        title: string;
-        tags: string[];
-        count: number;
-    }>;
-    tag_siblings: Array<{
-        path: string;
-        title: string;
-        shared_tags: string[];
-    }>;
-}
-export declare function getNoteNeighbors(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    max_per_bucket?: number;
-}): Promise<NoteNeighbors>;
-export interface VaultStats {
-    total_notes: number;
-    total_size_bytes: number;
-    avg_note_words: number;
-    recently_modified_7d: number;
-    orphans: number;
-    broken_wikilinks: number;
-    total_tags: number;
-    top_tags: Array<{
-        tag: string;
-        count: number;
-    }>;
-    notes_with_frontmatter: number;
-    generated_at: string;
-}
-export declare function getVaultStats(vault: Vault, args: {
-    top_tags?: number;
-}): Promise<VaultStats>;
-export interface LintWikiArgs {
-    /** Folder to restrict the lint to (default: whole vault). */
-    folder?: string;
-    /** Word count below which a note is considered a "stub". Default 100. */
-    stub_word_threshold?: number;
-    /** A note is "stale" if its frontmatter `last_reviewed` (or mtime if missing)
-     *  is older than this many days. Default 365. */
-    stale_days?: number;
-    /** A capitalised n-gram mentioned by ≥ N distinct notes but not having its
-     *  own page is flagged as a concept candidate. Default 3. */
-    concept_min_mentions?: number;
-    /** Cap on each finding-bucket so the response stays bounded. Default 50. */
-    max_per_bucket?: number;
-}
-export interface LintWikiFinding {
-    kind: "orphan" | "broken-link" | "stub" | "stale" | "concept-without-page";
-    path?: string;
-    message: string;
-    suggestion?: string;
-    details?: Record<string, unknown>;
-}
-export interface LintWikiResult {
-    scope: string;
-    scanned: number;
-    generated_at: string;
-    summary: {
-        orphans: number;
-        broken_links: number;
-        stubs: number;
-        stale: number;
-        concept_candidates: number;
-    };
-    findings: {
-        orphans: LintWikiFinding[];
-        broken_links: LintWikiFinding[];
-        stubs: LintWikiFinding[];
-        stale: LintWikiFinding[];
-        concept_candidates: LintWikiFinding[];
-    };
-}
-export declare function lintWiki(vault: Vault, args: LintWikiArgs): Promise<LintWikiResult>;
-export interface OpenQuestion {
-    question: string;
-    source_path: string;
-    source_title: string;
-    context_heading: string | null;
-    line: number;
-    age_days: number;
-    mtime: string;
-}
-export declare function getOpenQuestions(vault: Vault, args: {
-    folder?: string;
-    limit?: number;
-    pattern?: string;
-}): Promise<OpenQuestion[]>;
-export interface PaperAuditFinding {
-    path: string;
-    title: string;
-    has_frontmatter_citation: boolean;
-    found_in_body: {
-        arxiv: string[];
-        doi: string[];
-        url: string[];
-    };
-    proposed_frontmatter_patch: Record<string, string> | null;
-    message: string;
-}
-export declare function paperAudit(vault: Vault, args: {
-    tag?: string;
-    folder?: string;
-    limit?: number;
-}): Promise<{
-    scanned: number;
-    flagged: PaperAuditFinding[];
-}>;
-export interface PathStep {
-    path: string;
-    title: string;
-    /** Wikilink raw text (`[[…]]` content) used to traverse FROM the previous
-     *  step to this one. Empty on the source step. */
-    via: string;
-}
-export interface FindPathResult {
-    from: string;
-    to: string;
-    found: boolean;
-    path: PathStep[];
-    hops: number;
-    /** Up to 10 same-length alternatives, only when include_alternatives=true. */
-    alternatives?: PathStep[][];
-}
-export declare function findPath(vault: Vault, args: {
-    from?: string;
-    from_title?: string;
-    to?: string;
-    to_title?: string;
-    max_depth?: number;
-    include_alternatives?: boolean;
-    follow_embeds?: boolean;
-}): Promise<FindPathResult>;
-export interface OpenInUiResult {
-    uri: string;
-    vault_name: string;
-    path: string;
-    title: string;
-}
-export declare function openInUi(vault: Vault, args: {
-    path?: string;
-    title?: string;
-    new_pane?: boolean;
-}): Promise<OpenInUiResult>;
-export interface CanvasSummary {
-    path: string;
-    name: string;
-    size_bytes: number;
-    mtime: string;
-    node_count: number;
-    edge_count: number;
-}
-export declare function listCanvases(vault: Vault, args: {
-    folder?: string;
-    limit?: number;
-}): Promise<CanvasSummary[]>;
-export type CanvasNode = {
-    kind: "text";
-    id: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    text: string;
-    color?: string;
-} | {
-    kind: "file";
-    id: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    file: string;
-    file_resolved: string | null;
-    subpath?: string;
-    color?: string;
-} | {
-    kind: "link";
-    id: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    url: string;
-    color?: string;
-} | {
-    kind: "group";
-    id: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    label?: string;
-    color?: string;
-} | {
-    kind: "unknown";
-    id: string;
-    raw_type: string;
-    raw: Record<string, unknown>;
-};
-export interface CanvasEdge {
-    id: string;
-    from_node: string;
-    from_side?: string;
-    to_node: string;
-    to_side?: string;
-    label?: string;
-    color?: string;
-}
-export interface ReadCanvasResult {
-    path: string;
-    name: string;
-    size_bytes: number;
-    mtime: string;
-    nodes: CanvasNode[];
-    edges: CanvasEdge[];
-    /** Convenience summary: # of each node kind. */
-    summary: {
-        text: number;
-        file: number;
-        link: number;
-        group: number;
-        unknown: number;
-    };
-    /** Embedded files that didn't resolve to anything in the vault — broken
-     *  canvas references. Empty when all files resolve cleanly. */
-    broken_file_refs: string[];
-}
-export declare function readCanvas(vault: Vault, args: {
-    path: string;
-}): Promise<ReadCanvasResult>;
-export interface SemanticHit {
-    path: string;
-    title: string;
-    score: number;
-    snippet: string;
-    matched_terms: string[];
-    mtime: string;
-}
-export declare function semanticSearch(vault: Vault, args: {
-    query: string;
-    folder?: string;
-    limit?: number;
-    min_score?: number;
-}): Promise<{
-    query: string;
-    total_docs: number;
-    method: "tfidf-cosine";
-    matches: SemanticHit[];
-}>;
-export interface EmbedHit {
-    path: string;
-    title: string;
-    score: number;
-    snippet: string;
-    chunk_index: number;
-    line_start: number;
-    line_end: number;
-    /** v2.8.0 — content-source kind ("md" | "pdf"). */
-    kind: "md" | "pdf";
-}
-export interface EmbedSearchResponse {
-    query: string;
-    method: "embeddings-cosine";
-    model: string;
-    total_chunks: number;
-    matches: EmbedHit[];
-    /**
-     * v3.1.0 — present + true when retrieval used the agent-supplied
-     * `hypothetical_answer` as the embedding seed (HyDE). Lets clients
-     * audit whether they're seeing raw-query or HyDE-augmented results.
-     */
-    hyde?: boolean;
-}
-/**
- * v2.13.0 — optional HNSW context. When passed, embeddingsSearch routes
- * the k-NN lookup through the in-memory HNSW index (sub-10ms at any
- * scale) instead of the O(n) brute-force cosine in EmbedDb.search().
- * `rowByLabel` is the label → source-row mapping established at HNSW
- * build time (typically labels are `embeddings.id`, set in
- * `EmbedDb.getAllVectors()`).
- */
-export interface HnswSearchContext {
-    index: {
-        searchKnn(q: Float32Array, k: number, opts?: {
-            ef?: number;
-        }): {
-            labels: number[];
-            distances: number[];
-        };
-    };
-    rowByLabel: ReadonlyMap<number, {
-        rel_path: string;
-        chunk_index: number;
-        line_start: number;
-        line_end: number;
-        text_preview: string;
-        kind: "md" | "pdf";
-    }>;
-    ef?: number;
-}
-/**
- * v3.1.0 — pick the text that should be embedded for an embeddings-search
- * call. HyDE-augmented retrieval prefers the agent-supplied
- * `hypothetical_answer` (Gao et al 2023); falls back to the raw query
- * when that's absent / empty / whitespace-only.
- *
- * Pure helper so we can unit-test the decision in isolation (the real
- * `embeddingsSearch` function loads the @huggingface/transformers
- * embedder, which is out of scope for unit tests).
- */
-export declare function pickEmbedTextForHyde(args: {
-    query: string;
-    hypothetical_answer?: string;
-}): {
-    text: string;
-    usedHyde: boolean;
-};
-export declare function embeddingsSearch(vault: Vault, args: {
-    query: string;
-    folder?: string;
-    limit?: number;
-    min_score?: number;
-    model?: string;
-    /**
-     * v3.1.0 — HyDE (Hypothetical Document Embeddings) augmentation.
-     * When set, this string is embedded instead of `query`. The agent
-     * generates a synthetic answer to its own question, embeds *that*,
-     * and retrieves against the answer-shaped vector — typically beats
-     * raw-query retrieval on under-specified queries by +2-5 NDCG@10.
-     * The `query` string is still echoed in the response for caller
-     * audit-trail; it does NOT influence retrieval when `hypothetical_answer`
-     * is present.
-     */
-    hypothetical_answer?: string;
-}, embedFile: string, hnsw?: HnswSearchContext | null): Promise<EmbedSearchResponse>;
-import type { FtsIndex } from "./fts5.js";
-export interface SearchHybridHit {
-    path: string;
-    title: string;
-    /** Fused RRF score (sum of 1/(k+rank) terms across signals). */
-    score: number;
-    /** Snippet from whichever signal produced the best chunk hit. */
-    snippet: string;
-    chunk_index?: number;
-    line_start?: number;
-    line_end?: number;
-    /**
-     * v2.8.0 — content-source kind. Lets agents distinguish markdown notes
-     * from PDF chunks when both are indexed. Defaults to "md" for backward
-     * compatibility (legacy DBs and TF-IDF hits have no kind metadata).
-     */
-    kind: "md" | "pdf";
-    /** Per-signal observability — which signals contributed at what rank/score. */
-    per_signal: {
-        bm25?: {
-            rank: number;
-            score: number;
-        };
-        tfidf?: {
-            rank: number;
-            score: number;
-        };
-        embeddings?: {
-            rank: number;
-            score: number;
-        };
-    };
-    /**
-     * v2.9.0 — cross-encoder reranker score in [0, 1] (sigmoid of the model's
-     * relevance logit). Present only when the server was started with
-     * `--enable-reranker` AND this hit was within the reranker's top-N
-     * candidate set (default 50). Higher = more relevant. Compare across
-     * results within the same response, NOT across queries (the absolute
-     * value depends on the query).
-     */
-    reranker_score?: number;
-}
-export interface SearchHybridResponse {
-    query: string;
-    method: "rrf";
-    k: number;
-    signals_used: ("bm25" | "tfidf" | "embeddings")[];
-    /** v2.0.0-beta.2: per-signal failure reasons. Pre-fix, ranker exceptions
-     *  were silently swallowed (only stderr-logged). The MCP response just
-     *  showed `signals_used: []` with `matches: []` — caller couldn't tell
-     *  "no hits" from "all rankers crashed". Now any catch'ed exception
-     *  surfaces here as a string so agents can reason about reliability.
-     *  v2.9.0 added `reranker` for cross-encoder failure surfacing. */
-    signal_errors?: {
-        bm25?: string;
-        tfidf?: string;
-        embeddings?: string;
-        reranker?: string;
-    };
-    total_candidates: number;
-    matches: SearchHybridHit[];
-}
-export declare function searchHybrid(vault: Vault, args: {
-    query: string;
-    folder?: string;
-    limit?: number;
-    min_signals?: number;
-    embedding_model?: string;
-    /** v2.2.0: "note" (default) returns 1 hit per note, picking the best
-     *  chunk; "block" returns each chunk as a distinct hit so you see the
-     *  multiple-paragraph case where one note covers a topic in two places. */
-    granularity?: "note" | "block";
-    /** v2.3.0: post-RRF graph boost — rerank by counting how many other
-     *  top-K hits link to each one. Default true; set false to disable for
-     *  diagnostic comparison (e.g. measuring whether boost helped). */
-    graph_boost?: boolean;
-}, ctx: {
-    /** FTS5 index, if `--persistent-index` is enabled at server start. */
-    ftsIndex: FtsIndex | null;
-    /** Path to the `.embed.db` (file may or may not exist — checked at call time). */
-    embedFile: string;
-    /**
-     * v2.9.0 — optional cross-encoder reranker config. When set, the top-N
-     * hits from RRF (default 50) are re-scored by a BGE-style cross-encoder
-     * and re-sorted before truncation. Adds ~30-50ms per query on M1 CPU
-     * for a 50-candidate set.
-     *
-     * `alias` resolves to a `RERANKER_MODELS` entry. `topN` defaults to 50.
-     * Lazy-loaded — first call downloads the model from HuggingFace
-     * (~25-110 MB depending on alias). Failures are swallowed and surface
-     * via `signal_errors.reranker` so the whole search doesn't break on a
-     * model load issue.
-     */
-    reranker?: {
-        alias?: string;
-        topN?: number;
-    };
-    /**
-     * v2.9.0 — test-only injection point. When set, this pre-loaded
-     * reranker is used instead of lazy-loading via `loadReranker(alias)`.
-     * Lets unit tests validate the rerank-and-resort plumbing without
-     * pulling in the real ML model. Unused in production callers.
-     */
-    rerankerOverride?: {
-        score(query: string, passages: readonly string[]): Promise<number[]>;
-    };
-    /**
-     * v2.13.0 — optional HNSW context for the embeddings-search arm.
-     * When passed, the embedding-side k-NN goes through the in-memory
-     * HNSW index (sub-10ms at any scale) instead of the O(n) brute-force
-     * cosine in EmbedDb.search(). Built on serve start; lives in
-     * ServerDeps.hnswContext. Null/undefined → brute-force fallback.
-     */
-    hnsw?: HnswSearchContext | null;
-}): Promise<SearchHybridResponse>;
-export interface ContextPackArgs {
-    /** Topic / question to gather context for. */
-    query: string;
-    /** Approximate token budget for the bundle. ~4 chars/token assumption. Default 4000. */
-    budget_tokens?: number;
-    /** Restrict retrieval to this folder. */
-    folder?: string;
-    /** Include backlinks of top-K notes (1-line each)? Default true. */
-    include_backlinks?: boolean;
-    /** Include the last N daily notes? Default 0 (off). Set to 3 for "what was I doing recently". */
-    recent_dailies?: number;
-}
-export interface ContextPackResult {
-    query: string;
-    /** The packed markdown bundle ready to paste into an AI chat. */
-    bundle: string;
-    /** Approximate token count (chars / 4). */
-    estimated_tokens: number;
-    budget_tokens: number;
-    /** Per-section byte counts for observability. */
-    sections: {
-        notes: number;
-        backlinks: number;
-        dailies: number;
-    };
-    /** Top-K hit paths included in the bundle. */
-    included_notes: string[];
-}
-export declare function contextPack(vault: Vault, args: ContextPackArgs, ctx: {
-    ftsIndex: FtsIndex | null;
-    embedFile: string;
-}): Promise<ContextPackResult>;
-export interface PdfSummary {
-    /** Vault-relative path. */
-    path: string;
-    /** Filename minus the `.pdf` extension. */
-    name: string;
-    /** File size in bytes. */
-    size_bytes: number;
-    /** Last-modified ISO timestamp. */
-    mtime: string;
-}
-export declare function listPdfs(vault: Vault, args: {
-    folder?: string;
-    limit?: number;
-}): Promise<PdfSummary[]>;
-export interface ReadPdfArgs {
-    /** Vault-relative path to the .pdf file. */
-    path: string;
-    /** Optional 1-indexed inclusive page range: `[2, 5]` reads pages 2..5. */
-    pages?: [number, number];
-    /** When true, include doc-level metadata (title/author/etc) in the result. Default true. */
-    include_metadata?: boolean;
-}
-export interface ReadPdfPage {
-    page_number: number;
-    text: string;
-    is_empty: boolean;
-    char_count: number;
-}
-export interface ReadPdfResult {
-    path: string;
-    name: string;
-    size_bytes: number;
-    mtime: string;
-    page_count: number;
-    has_text: boolean;
-    pages: ReadPdfPage[];
-    full_text: string;
-    metadata?: {
-        title?: string;
-        author?: string;
-        subject?: string;
-        keywords?: string;
-        creator?: string;
-        producer?: string;
-        creation_date?: string;
-        mod_date?: string;
-    };
-    /** When `pages` slicing was applied, this carries the original page count
-     *  for callers that need to know how much they didn't read. */
-    total_page_count: number;
-}
-export declare function readPdf(vault: Vault, args: ReadPdfArgs): Promise<ReadPdfResult>;
-export interface OcrPdfArgs {
-    /** Vault-relative path to the .pdf file. */
-    path: string;
-    /**
-     * Tesseract language pack(s). Default `'eng'`. Multi-lang via `'+'`,
-     * e.g. `'eng+rus'` for English+Russian mixed scans.
-     */
-    lang?: string;
-    /** Optional 1-indexed inclusive page range, e.g. [2, 5] runs OCR on pages 2..5. */
-    pages?: [number, number];
-    /**
-     * Render scale (DPI multiplier). Higher = better OCR accuracy on small
-     * text but more memory + slower render. Default 2 (~150 DPI). Capped at
-     * 4 server-side.
-     */
-    scale?: number;
-}
-export interface OcrPdfPage {
-    page_number: number;
-    text: string;
-    is_empty: boolean;
-    char_count: number;
-    /** Tesseract's mean confidence for this page, 0-100. */
-    confidence: number;
-}
-export interface OcrPdfResult {
-    path: string;
-    name: string;
-    size_bytes: number;
-    mtime: string;
-    page_count: number;
-    total_page_count: number;
-    has_text: boolean;
-    pages: OcrPdfPage[];
-    full_text: string;
-    /** Mean confidence across pages with text. NaN if all pages empty. */
-    mean_confidence: number;
-    /** Languages used for OCR (whatever the caller passed). */
-    langs: string;
-}
-export declare function ocrPdf(vault: Vault, args: OcrPdfArgs): Promise<OcrPdfResult>;
-//# sourceMappingURL=tools.d.ts.map