import type { BaseDirsConfigError } from '../utils/base-dirs.js';
import type { ContentFormat } from '../utils/raw-data-utils.js';
import type { GroupingMode } from '../vectordb/index.js';
/**
 * Fields shared by both `RAGServerConfig` shapes (legacy single-root and
 * multi-root). Extracted so the union below only needs to describe the
 * `baseDir` / `baseDirs` axis.
 */
interface RAGServerConfigBase {
    /** LanceDB database path */
    dbPath: string;
    /** Transformers.js model path */
    modelName: string;
    /** Model cache directory */
    cacheDir: string;
    /** Maximum file size (100MB) */
    maxFileSize: number;
    /** Compute device (cpu, webgpu, dml, etc) */
    device?: string;
    /** Embedding quantization dtype (fp32, fp16, q8, int8, ...). Unset → fp32. */
    dtype?: string;
    /** Maximum distance threshold for quality filtering (optional) */
    maxDistance?: number;
    /** Grouping mode for quality filtering (optional) */
    grouping?: GroupingMode;
    /** Hybrid search weight for BM25 (0.0 = vector only, 1.0 = BM25 only, default 0.6) */
    hybridWeight?: number;
    /** Maximum number of files to keep in search results (optional) */
    maxFiles?: number;
    /** Minimum chunk length in characters (optional, default: 50) */
    chunkMinLength?: number;
    /**
     * Normal-path (resolve()) roots, index-aligned with the realpath'd `baseDirs`
     * security boundary; used for user-facing `list_files` scan/display so paths
     * match the resolve()-stored DB keys. From `BaseDirsConfig.rawBaseDirs` (see
     * it for the path policy). Optional: legacy `{ baseDir }` callers fall back to
     * `baseDirs`.
     */
    rawBaseDirs?: readonly string[];
    /** Configuration validation warnings to surface to users via MCP annotations */
    configWarnings?: string[];
    /**
     * Structured base-dirs resolution error. When present, the server is in
     * degraded mode: `status` remains callable so the user can diagnose the
     * problem via MCP, while root-dependent tools surface the error before
     * doing DB or filesystem work. See `resolveBaseDirs` for the error
     * semantics.
     */
    configError?: BaseDirsConfigError;
}
/**
 * RAGServer configuration.
 *
 * Accepts either a single `baseDir` (legacy shape — preserved so existing
 * direct callers and tests that pass `{ baseDir }` continue to work) or
 * `baseDirs` (multi-root shape produced by `resolveBaseDirs`). Exactly one
 * of the two MUST be supplied. The constructor normalizes both into a single
 * `baseDirs: string[]` internally and derives the legacy `baseDir` accessor
 * as `baseDirs[0]`.
 */
export type RAGServerConfig = (RAGServerConfigBase & {
    /** Document base directory (legacy single-root shape). */
    baseDir: string;
    baseDirs?: undefined;
}) | (RAGServerConfigBase & {
    /** One or more allowed document base directories (multi-root shape). */
    baseDirs: string[];
    baseDir?: undefined;
});
/**
 * query_documents tool input
 */
export interface QueryDocumentsInput {
    /** Natural language query */
    query: string;
    /** Number of results to retrieve (default 10) */
    limit?: number;
    /** Path prefix scope (one or a list); the parser normalizes to `string[]`. */
    scope?: string | string[];
}
/**
 * ingest_file tool input
 */
export interface IngestFileInput {
    /** File path */
    filePath: string;
    /**
     * When true and `filePath` is a PDF, the visual enrichment path runs
     * (VLM captioning of figure-heavy pages). For non-PDF files this flag is
     * silently coerced to the default text-only path. The runtime check at the
     * handler boundary stays in place because MCP arguments arrive as `unknown`
     * from the SDK.
     */
    visual?: boolean;
    /**
     * Visual-quality profile when `visual` is true. Some MCP clients send the
     * empty string for unspecified optional parameters, so the boundary
     * handler also accepts `""` and normalizes it to `'fast'`. The internal
     * `QualityProfile` type stays narrow (`'fast' | 'quality'`); `""` does
     * not propagate past `handleIngestFile`.
     */
    visualQuality?: 'fast' | 'quality' | '';
}
/**
 * ingest_data tool input metadata
 */
interface IngestDataMetadata {
    /** Source identifier: URL ("https://...") or custom ID ("clipboard://2024-12-30") */
    source: string;
    /** Content format */
    format: ContentFormat;
}
/**
 * ingest_data tool input
 */
export interface IngestDataInput {
    /** Content to ingest (text, HTML, or Markdown) */
    content: string;
    /** Content metadata */
    metadata: IngestDataMetadata;
}
/**
 * delete_file tool input
 * Either filePath or source must be provided
 */
export interface DeleteFileInput {
    /** File path (for files ingested via ingest_file) */
    filePath?: string;
    /** Source identifier (for data ingested via ingest_data) */
    source?: string;
}
/**
 * delete_file tool output
 */
export interface DeleteFileResult {
    /** Resolved file path used for the delete operation */
    filePath: string;
    /** True when the delete operation completed (idempotent; not "something was removed") */
    deleted: true;
    /** Number of vector chunks removed from the database */
    removedChunks: number;
    /** True when ingested chunks and/or raw-data artifacts existed before delete */
    existed: boolean;
    /** Timestamp */
    timestamp: string;
}
/**
 * ingest_file tool output
 */
export interface IngestResult {
    /** File path */
    filePath: string;
    /** Chunk count */
    chunkCount: number;
    /** Timestamp */
    timestamp: string;
    /** Document title extracted from file content (display-only, not used for scoring) */
    fileTitle: string | null;
}
/**
 * list_files tool output — entry for a file found under one of the effective
 * base directories.
 *
 * `baseDir` identifies the producing root (one of `ListFilesResult.baseDirs`).
 * Always present, including in single-root configurations — the field is
 * additive over the legacy shape, so existing clients that ignore it continue
 * to work.
 */
export type FileEntry = {
    filePath: string;
    baseDir: string;
    ingested: true;
    chunkCount: number;
    timestamp: string;
} | {
    filePath: string;
    baseDir: string;
    ingested: false;
};
/**
 * list_files tool output — entry for content ingested via ingest_data,
 * or an orphaned DB entry whose file no longer exists on disk
 */
export type SourceEntry = {
    source: string;
    chunkCount: number;
    timestamp: string;
} | {
    filePath: string;
    chunkCount: number;
    timestamp: string;
};
/**
 * list_files tool output.
 *
 * Multi-root contract:
 * - `baseDirs`: all effective roots (normal resolve() form, nested-root pruned).
 * - `baseDir`: the first effective root (`baseDirs[0]`). Preserved as a
 *   legacy field so clients written against the single-root shape continue to
 *   work.
 * - `files`: union across roots, each annotated with its producing `baseDir`.
 *   Exact duplicate paths across roots are de-duplicated (first occurrence
 *   wins, preserving root iteration order).
 * - `sources`: raw-data entries (from `ingest_data`) and orphaned DB entries
 *   whose files no longer exist on disk. Sources are not produced by any
 *   root, so they carry no `baseDir` annotation.
 */
export interface ListFilesResult {
    baseDir: string;
    baseDirs: string[];
    files: FileEntry[];
    sources: SourceEntry[];
}
/**
 * query_documents tool output
 */
export interface QueryResult {
    /** File path */
    filePath: string;
    /** Chunk index */
    chunkIndex: number;
    /** Text */
    text: string;
    /** Similarity score */
    score: number;
    /** Original source (only for raw-data files, e.g., URLs ingested via ingest_data) */
    source?: string;
    /** Document title extracted from file content (display-only, not used for scoring) */
    fileTitle: string | null;
}
/**
 * read_chunk_neighbors tool input.
 * Exactly one of filePath / source must be provided (XOR).
 */
export interface ReadChunkNeighborsInput {
    /** File path (for files ingested via ingest_file). Absolute path required. */
    filePath?: string;
    /** Source identifier (for data ingested via ingest_data). */
    source?: string;
    /** Target chunk index (zero-based, required, non-negative integer). */
    chunkIndex: number;
    /** Number of chunks before the target to include (default 2, non-negative integer). */
    before?: number;
    /** Number of chunks after the target to include (default 2, non-negative integer). */
    after?: number;
}
/**
 * read_chunk_neighbors tool output item.
 * Core fields are {filePath, chunkIndex, text}. `isTarget` is true only for
 * the requested target when it exists, and `source` is present only on
 * raw-data rows.
 * fileTitle mirrors QueryResult for drop-in consistency with query_documents results.
 */
export interface ReadChunkNeighborsResultItem {
    /** File path */
    filePath: string;
    /** Chunk index */
    chunkIndex: number;
    /** Text */
    text: string;
    /** True iff this chunk's chunkIndex matches the requested target. */
    isTarget: boolean;
    /** Original source (only for raw-data files, e.g., URLs ingested via ingest_data). */
    source?: string;
    /** Document title extracted from file content (display-only, not used for scoring) */
    fileTitle: string | null;
}
export {};
//# sourceMappingURL=types.d.ts.map