codesearch-mcp 0.0.18-alpha → 0.2.0-alpha

package/dist/src/config-store.d.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 export declare const CONFIG_DIR: string;
 export declare const CONFIG_FILE: string;
 export declare const SCHEMA_FILE: string;
+export declare const ENV_FILE: string;
 declare const jsonSchema: z.ZodObject<{
     db: z.ZodOptional<z.ZodObject<{
         host: z.ZodOptional<z.ZodString>;
@@ -10,28 +11,44 @@ declare const jsonSchema: z.ZodObject<{
         password: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    ollama: z.ZodOptional<z.ZodObject<{
-        host: z.ZodOptional<z.ZodString>;
+    embedding: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodEnum<{
+            "openai-compatible": "openai-compatible";
+            voyage: "voyage";
+            infinity: "infinity";
+        }>>;
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodOptional<z.ZodNumber>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     indexing: z.ZodOptional<z.ZodObject<{
         chunkSize: z.ZodOptional<z.ZodNumber>;
         chunkOverlap: z.ZodOptional<z.ZodNumber>;
         embedBatchSize: z.ZodOptional<z.ZodNumber>;
         astBatchSize: z.ZodOptional<z.ZodNumber>;
+        chunkStrategy: z.ZodOptional<z.ZodEnum<{
+            ast: "ast";
+            character: "character";
+        }>>;
     }, z.core.$strip>>;
     search: z.ZodOptional<z.ZodObject<{
         similarityThreshold: z.ZodOptional<z.ZodNumber>;
         defaultLimit: z.ZodOptional<z.ZodNumber>;
         maxLimit: z.ZodOptional<z.ZodNumber>;
-        autoTranslate: z.ZodOptional<z.ZodBoolean>;
-        translateModel: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     reranker: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
+        provider: z.ZodOptional<z.ZodEnum<{
+            "openai-compatible": "openai-compatible";
+        }>>;
+        baseURL: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
         overfetch: z.ZodOptional<z.ZodNumber>;
+        candidateFloor: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     logging: z.ZodOptional<z.ZodObject<{
         level: z.ZodOptional<z.ZodEnum<{
@@ -41,6 +58,7 @@ declare const jsonSchema: z.ZodObject<{
             warn: "warn";
         }>>;
         dir: z.ZodOptional<z.ZodString>;
+        searchMetrics: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     workspaceRoot: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -52,33 +70,71 @@ export declare const ALL_KEYS: string[];
  * `resolvedSchema` in `src/config.ts`, whose `.default(...)` calls reference
  * these values — so the runtime default and the dashboard-displayed default
  * cannot diverge. `as const` keeps the literal types so those `.default()`
- * lookups stay type-safe. Keys omitted here have no static default (required
- * fields like db.host, or values derived at runtime like db.name → rag_<user>
- * and reranker.url → ${ollama.host}/api/rerank).
+ * lookups stay type-safe. Keys omitted here have no static default: required
+ * fields (db.host/user/password) and values derived at runtime — db.name →
+ * rag_<user>, and the provider-dependent URLs (embedding.baseURL,
+ * reranker.baseURL, reranker.url), which are computed in the `Config`
+ * constructor per provider rather than through a schema `.default(...)`.
  */
 export declare const CONFIG_DEFAULTS: {
     readonly 'db.port': 5433;
-    readonly 'ollama.host': "http://localhost:11434";
-    readonly 'ollama.model': string;
+    readonly 'embedding.provider': "infinity";
+    readonly 'embedding.apiKey': "";
+    readonly 'embedding.model': "jinaai/jina-embeddings-v2-base-code";
+    readonly 'embedding.batchSize': 32;
     readonly 'indexing.chunkSize': 1500;
     readonly 'indexing.chunkOverlap': 200;
     readonly 'indexing.embedBatchSize': 5;
     readonly 'indexing.astBatchSize': 3000;
+    readonly 'indexing.chunkStrategy': "ast";
     readonly 'search.similarityThreshold': 0.6;
     readonly 'search.defaultLimit': 5;
     readonly 'search.maxLimit': 20;
-    readonly 'search.autoTranslate': false;
-    readonly 'search.translateModel': "llama3.2";
-    readonly 'reranker.enabled': false;
-    readonly 'reranker.model': "";
-    readonly 'reranker.overfetch': 3;
+    readonly 'reranker.enabled': true;
+    readonly 'reranker.provider': "openai-compatible";
+    readonly 'reranker.apiKey': "";
+    readonly 'reranker.model': "mixedbread-ai/mxbai-rerank-xsmall-v1";
+    readonly 'reranker.overfetch': 5;
+    readonly 'reranker.candidateFloor': 80;
     readonly 'logging.level': "error";
+    readonly 'logging.searchMetrics': false;
 };
 export declare function readConfigJson(): JsonConfig | null;
 /**
- * Validate a parsed config object against the Zod schema. Unknown keys (e.g.
- * the "$schema" editor reference) are stripped. Throws with a caller-friendly
- * message on validation failure. Pure — no file I/O.
+ * Detect a raw (pre-migration) config object that still selects the removed
+ * `ollama` embedding provider — explicitly, via a legacy top-level `ollama`
+ * block, or implicitly (no `provider` set, but `baseURL`/`model` point at
+ * Ollama's defaults) — and throw a `ConfigError` with migration guidance
+ * instead of letting it validate under a silently reinterpreted provider.
+ * Runs before `migrateRawConfig` so a legacy `ollama.*` block is never
+ * converted into an `embedding` block first. Pure — never mutates `raw`.
+ */
+export declare function detectFormerOllamaConfig(raw: unknown): void;
+/**
+ * Migrate a legacy raw config object to the current shape, in place of a
+ * versioned migration system. Pure — returns a new object, never mutates input.
+ *
+ * - Removed translation keys (`search.autoTranslate`, `search.translateModel`)
+ *   are dropped so they neither validate-fail nor take effect.
+ * - Legacy `reranker.provider: 'ollama'` (a dead value — Ollama has no rerank
+ *   API) is rewritten to `openai-compatible`, and a stale `/api/rerank` URL is
+ *   dropped so it re-derives to `/rerank`. Otherwise the tightened enum would
+ *   fail validation on existing configs and lock the user out.
+ *
+ * A legacy top-level `ollama` block reaches here only when `detectFormerOllamaConfig`
+ * did not already reject it (i.e. an `embedding` block is also present); it is
+ * dropped rather than merged. Exported for unit testing.
+ */
+export declare function migrateRawConfig(raw: unknown): unknown;
+/**
+ * Validate a raw (pre-migration) config object against the Zod schema: first
+ * `detectFormerOllamaConfig` (a `ConfigError` on a former-Ollama config takes
+ * priority over both migration and the regular Zod enum rejection), then
+ * `migrateRawConfig`, then the schema itself. Unknown keys (e.g. the "$schema"
+ * editor reference) are stripped. Throws with a caller-friendly message on
+ * validation failure. The single entry point for both `readConfigJson` and
+ * `PUT /api/config`, so both apply identical rules with an identical message.
+ * Pure — no file I/O.
  */
 export declare function parseConfig(raw: unknown, source?: string): JsonConfig;
 /** Build the JSON Schema object generated from the Zod config schema. Pure. */

package/dist/src/config-store.js

@@ -33,8 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_DEFAULTS = exports.ALL_KEYS = exports.SCHEMA_FILE = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
+exports.CONFIG_DEFAULTS = exports.ALL_KEYS = exports.ENV_FILE = exports.SCHEMA_FILE = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
 exports.readConfigJson = readConfigJson;
+exports.detectFormerOllamaConfig = detectFormerOllamaConfig;
+exports.migrateRawConfig = migrateRawConfig;
 exports.parseConfig = parseConfig;
 exports.buildJsonSchema = buildJsonSchema;
 exports.writeConfigJson = writeConfigJson;
@@ -47,9 +49,11 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const zod_1 = require("zod");
 const constants_1 = require("./constants");
+const config_error_1 = require("./config-error");
 exports.CONFIG_DIR = path.join(os.homedir(), '.config', 'codesearch-mcp');
 exports.CONFIG_FILE = path.join(exports.CONFIG_DIR, 'config.json');
 exports.SCHEMA_FILE = path.join(exports.CONFIG_DIR, 'config.schema.json');
+exports.ENV_FILE = path.join(exports.CONFIG_DIR, '.env');
 // Relative $schema reference written into config.json so editors resolve the
 // sibling schema file for autocomplete / inline validation.
 const SCHEMA_REF = './config.schema.json';
@@ -63,32 +67,40 @@ const jsonSchema = zod_1.z.object({
         password: zod_1.z.string().describe('PostgreSQL password').optional(),
         name: zod_1.z.string().describe('Database name; defaults to rag_<os-username>, auto-created on first run').optional(),
     }).optional(),
-    ollama: zod_1.z.object({
-        host: zod_1.z.string().describe('Ollama API URL (default http://localhost:11434)').optional(),
-        model: zod_1.z.string().describe('Embedding model (default bge-m3)').optional(),
+    embedding: zod_1.z.object({
+        provider: zod_1.z.enum(['openai-compatible', 'voyage', 'infinity']).describe('Embedding backend (default infinity)').optional(),
+        baseURL: zod_1.z.string().describe('Backend base URL. Infinity/TEI/vLLM/Ollama-via-openai-compatible: http://localhost:7997 (Infinity default) · OpenAI: https://api.openai.com/v1 · Voyage: https://api.voyageai.com/v1').optional(),
+        apiKey: zod_1.z.string().describe('API key. Use env:VAR_NAME to read from ~/.config/codesearch-mcp/.env or the environment (recommended). Empty for local servers.').optional(),
+        model: zod_1.z.string().describe('Embedding model (default jinaai/jina-embeddings-v2-base-code)').optional(),
+        dimensions: zod_1.z.number().int().describe('Vector width override; required for models whose native width exceeds 2000 (Matryoshka reduction). Omit to derive from the model/registry/probe.').optional(),
+        batchSize: zod_1.z.number().int().describe('Texts per batch embedding request (default 32)').optional(),
     }).optional(),
     indexing: zod_1.z.object({
         chunkSize: zod_1.z.number().int().describe('Max chars per chunk (default 1500)').optional(),
         chunkOverlap: zod_1.z.number().int().describe('Overlap between chunks (default 200)').optional(),
-        embedBatchSize: zod_1.z.number().int().describe('Parallel embeddings per batch (default 5)').optional(),
+        embedBatchSize: zod_1.z.number().int().describe('Rows per DB-insert batch when writing chunks (default 5). Embedding request size is embedding.batchSize.').optional(),
         astBatchSize: zod_1.z.number().int().describe('Max files per ts-morph batch; larger projects skip dependency resolution (default 3000)').optional(),
+        chunkStrategy: zod_1.z.enum(['ast', 'character']).describe('How TS/JS files are chunked: ast = symbol-aligned boundaries, character = fixed-size recursive splitter (default ast)').optional(),
     }).optional(),
     search: zod_1.z.object({
         similarityThreshold: zod_1.z.number().min(0).max(1).describe('Max cosine distance 0–1; lower = stricter (default 0.6)').optional(),
         defaultLimit: zod_1.z.number().int().describe('Default result count (default 5)').optional(),
         maxLimit: zod_1.z.number().int().describe('Hard cap on results (default 20)').optional(),
-        autoTranslate: zod_1.z.boolean().describe('Translate non-English queries before embedding').optional(),
-        translateModel: zod_1.z.string().describe('Ollama model for translation (default llama3.2)').optional(),
     }).optional(),
     reranker: zod_1.z.object({
         enabled: zod_1.z.boolean().describe('Enable cross-encoder reranking; requires reranker.model').optional(),
+        provider: zod_1.z.enum(['openai-compatible']).describe('Rerank backend. Only openai-compatible /rerank servers (Infinity, TEI, vLLM).').optional(),
+        baseURL: zod_1.z.string().describe('Rerank server base URL (defaults to embedding.baseURL — Infinity serves both).').optional(),
+        apiKey: zod_1.z.string().describe('API key, or env:VAR_NAME. Empty for local servers.').optional(),
         model: zod_1.z.string().describe('Reranker model name (e.g. qllama/bge-reranker-v2-m3)').optional(),
-        url: zod_1.z.string().describe('Full URL of the rerank endpoint (default ${ollama.host}/api/rerank)').optional(),
-        overfetch: zod_1.z.number().int().min(1).max(20).describe('Candidate multiplier before reranking (limit × N, default 3)').optional(),
+        url: zod_1.z.string().describe('Full URL of the rerank endpoint (default derived from provider + baseURL)').optional(),
+        overfetch: zod_1.z.number().int().min(1).max(20).describe('Candidate multiplier before reranking (limit × N, default 5)').optional(),
+        candidateFloor: zod_1.z.number().int().min(1).describe('Minimum candidate pool fed to the reranker regardless of limit; fetchLimit = min(max(limit × overfetch, candidateFloor), 200) (default 80)').optional(),
     }).optional(),
     logging: zod_1.z.object({
         level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).describe('File log level (default error)').optional(),
         dir: zod_1.z.string().describe('Base log directory; "false" to disable file logging').optional(),
+        searchMetrics: zod_1.z.boolean().describe('Emit one structured search-tuning line (info level) per search, independent of level (default false)').optional(),
     }).optional(),
     workspaceRoot: zod_1.z.string().describe('Full path to the directory containing all your projects').optional(),
 });
@@ -98,23 +110,31 @@ const FIELD_TYPES = {
     'db.user': 'string',
     'db.password': 'string',
     'db.name': 'string',
-    'ollama.host': 'string',
-    'ollama.model': 'string',
+    'embedding.provider': 'string',
+    'embedding.baseURL': 'string',
+    'embedding.apiKey': 'string',
+    'embedding.model': 'string',
+    'embedding.dimensions': 'number',
+    'embedding.batchSize': 'number',
     'indexing.chunkSize': 'number',
     'indexing.chunkOverlap': 'number',
     'indexing.embedBatchSize': 'number',
     'indexing.astBatchSize': 'number',
+    'indexing.chunkStrategy': 'string',
     'search.similarityThreshold': 'number',
     'search.defaultLimit': 'number',
     'search.maxLimit': 'number',
-    'search.autoTranslate': 'boolean',
-    'search.translateModel': 'string',
     'reranker.enabled': 'boolean',
+    'reranker.provider': 'string',
+    'reranker.baseURL': 'string',
+    'reranker.apiKey': 'string',
     'reranker.model': 'string',
     'reranker.url': 'string',
     'reranker.overfetch': 'number',
+    'reranker.candidateFloor': 'number',
     'logging.level': 'string',
     'logging.dir': 'string',
+    'logging.searchMetrics': 'boolean',
     'workspaceRoot': 'string',
 };
 exports.ALL_KEYS = Object.keys(FIELD_TYPES);
@@ -124,27 +144,34 @@ exports.ALL_KEYS = Object.keys(FIELD_TYPES);
  * `resolvedSchema` in `src/config.ts`, whose `.default(...)` calls reference
  * these values — so the runtime default and the dashboard-displayed default
  * cannot diverge. `as const` keeps the literal types so those `.default()`
- * lookups stay type-safe. Keys omitted here have no static default (required
- * fields like db.host, or values derived at runtime like db.name → rag_<user>
- * and reranker.url → ${ollama.host}/api/rerank).
+ * lookups stay type-safe. Keys omitted here have no static default: required
+ * fields (db.host/user/password) and values derived at runtime — db.name →
+ * rag_<user>, and the provider-dependent URLs (embedding.baseURL,
+ * reranker.baseURL, reranker.url), which are computed in the `Config`
+ * constructor per provider rather than through a schema `.default(...)`.
  */
 exports.CONFIG_DEFAULTS = {
     'db.port': 5433,
-    'ollama.host': 'http://localhost:11434',
-    'ollama.model': constants_1.DEFAULT_EMBED_MODEL,
+    'embedding.provider': 'infinity',
+    'embedding.apiKey': '',
+    'embedding.model': constants_1.DEFAULT_EMBED_MODEL,
+    'embedding.batchSize': 32,
     'indexing.chunkSize': 1500,
     'indexing.chunkOverlap': 200,
     'indexing.embedBatchSize': 5,
     'indexing.astBatchSize': 3000,
+    'indexing.chunkStrategy': 'ast',
     'search.similarityThreshold': 0.6,
     'search.defaultLimit': 5,
     'search.maxLimit': 20,
-    'search.autoTranslate': false,
-    'search.translateModel': 'llama3.2',
-    'reranker.enabled': false,
-    'reranker.model': '',
-    'reranker.overfetch': 3,
+    'reranker.enabled': true,
+    'reranker.provider': 'openai-compatible',
+    'reranker.apiKey': '',
+    'reranker.model': 'mixedbread-ai/mxbai-rerank-xsmall-v1',
+    'reranker.overfetch': 5,
+    'reranker.candidateFloor': 80,
     'logging.level': 'error',
+    'logging.searchMetrics': false,
 };
 function readConfigJson() {
     if (!fs.existsSync(exports.CONFIG_FILE))
@@ -166,13 +193,101 @@ function readConfigJson() {
     }
     return parseConfig(parsed, exports.CONFIG_FILE);
 }
+const OLLAMA_MIGRATION_REMEDY = 'The "ollama" embedding provider has been removed. Point Ollama through the ' +
+    '"openai-compatible" provider instead — set embedding.provider to "openai-compatible" ' +
+    'and embedding.baseURL to "http://localhost:11434/v1" — via `rag-config edit` (or by ' +
+    'editing the config file directly) or by re-running `rag-setup`. After switching, rebuild ' +
+    'the index with `rag-index --reindex`.';
+/** Strip a trailing `:tag` (Docker-style) from a model name, if present. */
+function stripModelTag(model) {
+    return model.replace(/:[^:]*$/, '');
+}
+/**
+ * Detect a raw (pre-migration) config object that still selects the removed
+ * `ollama` embedding provider — explicitly, via a legacy top-level `ollama`
+ * block, or implicitly (no `provider` set, but `baseURL`/`model` point at
+ * Ollama's defaults) — and throw a `ConfigError` with migration guidance
+ * instead of letting it validate under a silently reinterpreted provider.
+ * Runs before `migrateRawConfig` so a legacy `ollama.*` block is never
+ * converted into an `embedding` block first. Pure — never mutates `raw`.
+ */
+function detectFormerOllamaConfig(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return;
+    const obj = raw;
+    const embedding = obj.embedding;
+    if (embedding != null && typeof embedding === 'object') {
+        const e = embedding;
+        if (e.provider === 'ollama') {
+            throw new config_error_1.ConfigError(`Config selects the "ollama" embedding provider, which is no longer supported. ${OLLAMA_MIGRATION_REMEDY}`);
+        }
+        if (e.provider === undefined) {
+            if (typeof e.baseURL === 'string') {
+                let port;
+                try {
+                    port = new URL(e.baseURL).port;
+                }
+                catch { /* unparsable — not a signal */ }
+                if (port === '11434') {
+                    throw new config_error_1.ConfigError(`Config's embedding.baseURL targets Ollama's default port (11434) with no embedding.provider set. ${OLLAMA_MIGRATION_REMEDY}`);
+                }
+            }
+            if (typeof e.model === 'string' && constants_1.FORMER_OLLAMA_MODELS.includes(stripModelTag(e.model))) {
+                throw new config_error_1.ConfigError(`Config's embedding.model ("${e.model}") was formerly registered for Ollama, with no embedding.provider set. ${OLLAMA_MIGRATION_REMEDY}`);
+            }
+        }
+        return;
+    }
+    if (obj.ollama != null && typeof obj.ollama === 'object') {
+        throw new config_error_1.ConfigError(`Config has a legacy "ollama" configuration block. ${OLLAMA_MIGRATION_REMEDY}`);
+    }
+}
+/**
+ * Migrate a legacy raw config object to the current shape, in place of a
+ * versioned migration system. Pure — returns a new object, never mutates input.
+ *
+ * - Removed translation keys (`search.autoTranslate`, `search.translateModel`)
+ *   are dropped so they neither validate-fail nor take effect.
+ * - Legacy `reranker.provider: 'ollama'` (a dead value — Ollama has no rerank
+ *   API) is rewritten to `openai-compatible`, and a stale `/api/rerank` URL is
+ *   dropped so it re-derives to `/rerank`. Otherwise the tightened enum would
+ *   fail validation on existing configs and lock the user out.
+ *
+ * A legacy top-level `ollama` block reaches here only when `detectFormerOllamaConfig`
+ * did not already reject it (i.e. an `embedding` block is also present); it is
+ * dropped rather than merged. Exported for unit testing.
+ */
+function migrateRawConfig(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return raw;
+    const obj = JSON.parse(JSON.stringify(raw));
+    delete obj.ollama;
+    if (obj.search && typeof obj.search === 'object') {
+        delete obj.search.autoTranslate;
+        delete obj.search.translateModel;
+    }
+    if (obj.reranker && typeof obj.reranker === 'object') {
+        if (obj.reranker.provider === 'ollama')
+            obj.reranker.provider = 'openai-compatible';
+        if (typeof obj.reranker.url === 'string' && /\/api\/rerank\/?(\?.*)?$/.test(obj.reranker.url))
+            delete obj.reranker.url;
+    }
+    return obj;
+}
 /**
- * Validate a parsed config object against the Zod schema. Unknown keys (e.g.
- * the "$schema" editor reference) are stripped. Throws with a caller-friendly
- * message on validation failure. Pure — no file I/O.
+ * Validate a raw (pre-migration) config object against the Zod schema: first
+ * `detectFormerOllamaConfig` (a `ConfigError` on a former-Ollama config takes
+ * priority over both migration and the regular Zod enum rejection), then
+ * `migrateRawConfig`, then the schema itself. Unknown keys (e.g. the "$schema"
+ * editor reference) are stripped. Throws with a caller-friendly message on
+ * validation failure. The single entry point for both `readConfigJson` and
+ * `PUT /api/config`, so both apply identical rules with an identical message.
+ * Pure — no file I/O.
  */
 function parseConfig(raw, source = exports.CONFIG_FILE) {
-    const result = jsonSchema.safeParse(raw);
+    detectFormerOllamaConfig(raw);
+    const migrated = migrateRawConfig(raw);
+    const result = jsonSchema.safeParse(migrated);
     if (!result.success) {
         const issues = result.error.issues.map(i => `  ${i.path.join('.')}: ${i.message}`).join('\n');
         throw new Error(`Invalid config in ${source}:\n${issues}\n` +

package/dist/src/config.d.ts

@@ -1,6 +1,13 @@
-export declare class ConfigError extends Error {
-    constructor(message: string);
-}
+import { ConfigError } from './config-error';
+export { ConfigError };
+/**
+ * Resolve a config value that may reference an environment variable. A value of
+ * the form `env:VAR_NAME` resolves to `process.env.VAR_NAME`; any other string
+ * (including empty) is returned verbatim. A referenced-but-unset variable throws
+ * a clear error naming the variable and the `.env` file. Pure aside from the
+ * injected env map. See `src/app.ts` for how `.env` is loaded into the process.
+ */
+export declare function resolveEnvRef(value: string, env?: NodeJS.ProcessEnv): string;
 export declare class Config {
     private readonly data;
     get db(): {
@@ -10,29 +17,47 @@ export declare class Config {
         password: string;
         database: string;
     };
-    get ollama(): {
-        host: string;
+    /**
+     * Embedding config. `apiKey` is returned **raw** (possibly an `env:VAR` ref) —
+     * callers resolve it lazily via `resolveEnvRef` at the moment they build a
+     * request, so an unset referenced variable fails only when the key is actually
+     * needed (during embed/search) rather than crashing container construction and
+     * locking the user out of `rag-web`/`rag-mcp`.
+     */
+    get embedding(): {
+        provider: "openai-compatible" | "voyage" | "infinity";
+        baseURL: string;
+        apiKey: string;
+        model: string;
+        dimensions: number | null;
+        batchSize: number;
+    };
+    /** Reranker config. `apiKey` is raw — resolve lazily with `resolveEnvRef`. */
+    get reranker(): {
+        enabled: boolean;
+        provider: "openai-compatible";
+        baseURL: string;
+        apiKey: string;
         model: string;
-        rerankerModel: string;
-        rerankerUrl: string;
+        url: string;
+        overfetch: number;
+        candidateFloor: number;
     };
     get indexer(): {
         chunkSize: number;
         chunkOverlap: number;
         batchSize: number;
         astBatchSize: number;
+        chunkStrategy: "ast" | "character";
     };
     get search(): {
         similarityThreshold: number;
         defaultLimit: number;
         maxLimit: number;
-        autoTranslate: boolean;
-        translateModel: string;
-        rerankerEnabled: boolean;
-        rerankerOverfetch: number;
     };
     get logging(): {
         level: "error" | "debug" | "info" | "warn";
+        searchMetrics: boolean;
         dir?: string | undefined;
     };
     get workspaceRoot(): string;