opencode-rag-plugin 1.21.2 → 1.22.1

package/dist/cli/commands/ui.js

@@ -32,7 +32,11 @@ export function registerUiCommand(program) {
             const port = parseInt(options.port ?? String(config.ui?.port ?? 3210), 10);
             const openBrowser = options.open !== false && (config.ui?.openBrowser ?? true);
             const { startWebUi } = await import("../../web/server.js");
-            const server = await startWebUi(storePath, port, cwd, config.embedding.vectorDimension ?? 384, config);
+            const { findConfigFile } = await import("../../core/config.js");
+            const configPath = options.config
+                ? path.resolve(cwd, options.config)
+                : findConfigFile(cwd);
+            const server = await startWebUi(storePath, port, cwd, config.embedding.vectorDimension ?? 384, config, configPath);
             const url = `http://127.0.0.1:${server.port}/?token=${server.token}`;
             logCliInfo(logFilePath, "ui", `\n${c.heading("OpenCodeRAG Web UI")}`);
             logCliInfo(logFilePath, "ui", `  ${c.label("URL:")} ${c.value(url)}`);

package/dist/content/reader.d.ts

@@ -3,7 +3,7 @@
  */
 import type { RagConfig } from "../core/config.js";
 import { type FileManifest } from "../core/manifest.js";
-import { type ExcludeMatcher } from "../core/exclude.js";
+import { type ExcludeMatcher, type IncludedMatcher } from "../core/exclude.js";
 import { DescriptionCache } from "../core/desc-cache.js";
 import { type ImageVisionProvider } from "../chunker/image.js";
 /** Metadata and extracted content for a single workspace file discovered during scanning. */
@@ -28,7 +28,7 @@ interface Logger {
  * Recursively walk a directory tree and collect paths matching the given extension set,
  * respecting exclusion lists and configurable limits for max directories and results.
  */
-export declare function walkFiles(dir: string, extensions: Set<string>, excludeDirs: ExcludeMatcher, excludeFiles?: ExcludeMatcher, rootDir?: string, logger?: Logger, dirCount?: {
+export declare function walkFiles(dir: string, extensions: Set<string>, excludeDirs: ExcludeMatcher, excludeFiles?: ExcludeMatcher, includeDirs?: IncludedMatcher, rootDir?: string, logger?: Logger, dirCount?: {
     value: number;
 }, maxDirs?: number, maxResults?: number): Promise<string[]>;
 /**

package/dist/content/reader.js

@@ -5,7 +5,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import pLimit from "p-limit";
 import { computeFileHash, computeDescriptionConfigHash, normalizeFilePath } from "../core/manifest.js";
-import { createExcludeMatcher } from "../core/exclude.js";
+import { createExcludeMatcher, createIncludeMatcher } from "../core/exclude.js";
 import { DescriptionCache } from "../core/desc-cache.js";
 import { createImageVisionProvider, } from "../chunker/image.js";
 import * as pdfExtractor from "./pdf.js";
@@ -17,13 +17,14 @@ import * as imageExtractor from "./image.js";
  * Recursively walk a directory tree and collect paths matching the given extension set,
  * respecting exclusion lists and configurable limits for max directories and results.
  */
-export async function walkFiles(dir, extensions, excludeDirs, excludeFiles, rootDir = dir, logger, dirCount, maxDirs = 10_000, maxResults = 100_000) {
+export async function walkFiles(dir, extensions, excludeDirs, excludeFiles, includeDirs, rootDir = dir, logger, dirCount, maxDirs = 10_000, maxResults = 100_000) {
     const results = [];
     const entries = await fs.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
         const fullPath = path.join(dir, entry.name);
         if (entry.isDirectory()) {
-            if (excludeDirs.excluded(path.relative(rootDir, fullPath)))
+            const rel = path.relative(rootDir, fullPath);
+            if ((includeDirs && !includeDirs.included(rel)) || excludeDirs.excluded(rel))
                 continue;
             if (dirCount) {
                 dirCount.value++;
@@ -39,7 +40,7 @@ export async function walkFiles(dir, extensions, excludeDirs, excludeFiles, root
                 logger?.warn(`Exceeded ${maxResults} matching files — truncating walk at ${fullPath}`);
                 return results;
             }
-            results.push(...(await walkFiles(fullPath, extensions, excludeDirs, excludeFiles, rootDir, logger, dirCount, maxDirs, maxResults)));
+            results.push(...(await walkFiles(fullPath, extensions, excludeDirs, excludeFiles, includeDirs, rootDir, logger, dirCount, maxDirs, maxResults)));
         }
         else if (entry.isFile()) {
             if (results.length >= maxResults) {
@@ -104,6 +105,7 @@ export async function scanWorkspaceFiles(cwd, config, logger, manifest, filterPa
     }
     const excludeDirMatcher = createExcludeMatcher(config.indexing.excludeDirs);
     const excludeFileMatcher = createExcludeMatcher(config.indexing.excludeFiles ?? []);
+    const includeDirMatcher = createIncludeMatcher(config.indexing.includeDirs ?? []);
     let files;
     if (filterPaths && filterPaths.length > 0) {
         files = filterPaths
@@ -116,14 +118,14 @@ export async function scanWorkspaceFiles(cwd, config, logger, manifest, filterPa
             const rel = path.relative(cwd, fp);
             if (rel.startsWith(".."))
                 return false;
-            return !excludeDirMatcher.excluded(rel) && !excludeFileMatcher.excluded(rel);
+            return includeDirMatcher.included(rel) && !excludeDirMatcher.excluded(rel) && !excludeFileMatcher.excluded(rel);
         });
     }
     else {
         logger?.info("Walking directory tree...");
         const walkStart = Date.now();
         const dirCount = { value: 0 };
-        files = await walkFiles(cwd, extensions, excludeDirMatcher, excludeFileMatcher, cwd, logger, dirCount);
+        files = await walkFiles(cwd, extensions, excludeDirMatcher, excludeFileMatcher, includeDirMatcher, cwd, logger, dirCount);
         const walkSec = ((Date.now() - walkStart) / 1000).toFixed(1);
         logger?.info(`Found ${files.length} matching files in ${walkSec}s (${dirCount.value} dirs traversed)`);
     }

package/dist/core/config.d.ts

@@ -183,6 +183,8 @@ export interface TuiConfig {
     fileListKeybinding: string;
     /** Keybinding to toggle the chunk viewer panel. */
     chunksKeybinding: string;
+    /** Keybinding to open the RAG settings dialog. Must be distinguishable by the terminal (see docs). */
+    settingsKeybinding: string;
 }
 /** Configuration for the standalone MCP (Model Context Protocol) server. */
 export interface McpConfig {
@@ -265,6 +267,21 @@ export interface RagConfig {
          * patterns are anchored to the workspace root.
          */
         excludeFiles?: string[];
+        /**
+         * Workspace-relative folder paths to **restrict indexing to**.
+         *
+         * When non-empty, only files inside these folders (and their
+         * subfolders) are indexed; files directly in the workspace root are
+         * NOT indexed. `excludeDirs`/`excludeFiles` still apply inside the
+         * included folders. Empty or omitted = whole workspace (default).
+         *
+         * Semantics:
+         * - Entries are **anchored to the workspace root** (unlike
+         *   `excludeDirs`, plain names do NOT match at any depth).
+         * - Supports globs (`docs/**`, `src/{a,b}`); use `/` as separator
+         *   (converted automatically). Matching is case-insensitive.
+         */
+        includeDirs?: string[];
         /** Number of overlapping lines between adjacent chunks. */
         chunkOverlap: number;
         /** Minimum file size in bytes to index (0 = no minimum). */
@@ -415,3 +432,15 @@ export declare function loadConfig(filePath: string, validate?: boolean): RagCon
  * @param dimension - The vector dimension to persist.
  */
 export declare function persistProbedDimension(configPath: string, dimension: number): void;
+/**
+ * Set a value at a dotted path inside the config JSON file, creating
+ * intermediate objects as needed, and write it back with 2-space
+ * indentation. Reads/writes the raw file, so comments or formatting of
+ * unrelated keys are preserved as parsed (the file is re-serialized).
+ *
+ * @param configPath - Absolute path to the config JSON file.
+ * @param path       - Dotted path segments, e.g. `["indexing", "includeDirs"]`.
+ * @param value      - Value to write at the target path.
+ * @returns `true` when the file was updated, `false` on any error.
+ */
+export declare function updateConfigValue(configPath: string, path: string[], value: unknown): boolean;

package/dist/core/config.js

@@ -294,6 +294,7 @@ export const DEFAULT_CONFIG = {
     tui: {
         fileListKeybinding: "ctrl+enter",
         chunksKeybinding: "ctrl+alt+enter",
+        settingsKeybinding: "ctrl+shift+r",
     },
     logging: {
         level: "info",
@@ -617,4 +618,37 @@ export function persistProbedDimension(configPath, dimension) {
         // best-effort
     }
 }
+/**
+ * Set a value at a dotted path inside the config JSON file, creating
+ * intermediate objects as needed, and write it back with 2-space
+ * indentation. Reads/writes the raw file, so comments or formatting of
+ * unrelated keys are preserved as parsed (the file is re-serialized).
+ *
+ * @param configPath - Absolute path to the config JSON file.
+ * @param path       - Dotted path segments, e.g. `["indexing", "includeDirs"]`.
+ * @param value      - Value to write at the target path.
+ * @returns `true` when the file was updated, `false` on any error.
+ */
+export function updateConfigValue(configPath, path, value) {
+    try {
+        let raw = readFileSync(configPath, "utf-8");
+        if (raw.charCodeAt(0) === 0xfeff)
+            raw = raw.slice(1);
+        const data = JSON.parse(raw);
+        let target = data;
+        for (let i = 0; i < path.length - 1; i++) {
+            const key = path[i];
+            if (!target[key] || typeof target[key] !== "object") {
+                target[key] = {};
+            }
+            target = target[key];
+        }
+        target[path[path.length - 1]] = value;
+        writeFileSync(configPath, JSON.stringify(data, null, 2), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=config.js.map

package/dist/core/exclude.d.ts

@@ -1,4 +1,18 @@
 export interface ExcludeMatcher {
     excluded(relPath: string): boolean;
 }
+export interface IncludedMatcher {
+    included(relPath: string): boolean;
+}
 export declare function createExcludeMatcher(patterns: string[]): ExcludeMatcher;
+/**
+ * Create a matcher for `indexing.includeDirs`.
+ *
+ * Semantics differ from {@link createExcludeMatcher}: every pattern is
+ * **anchored to the workspace root** — it is matched as a glob against each
+ * ancestor prefix of the path, so `docs` includes `<root>/docs` and all its
+ * contents, but never a nested `docs` elsewhere in the tree. The workspace
+ * root itself (`""`) is always included so a walk can descend into it.
+ * Empty pattern lists include everything.
+ */
+export declare function createIncludeMatcher(patterns: string[]): IncludedMatcher;

package/dist/core/exclude.js

@@ -42,4 +42,41 @@ export function createExcludeMatcher(patterns) {
     }
     return { excluded };
 }
+/**
+ * Create a matcher for `indexing.includeDirs`.
+ *
+ * Semantics differ from {@link createExcludeMatcher}: every pattern is
+ * **anchored to the workspace root** — it is matched as a glob against each
+ * ancestor prefix of the path, so `docs` includes `<root>/docs` and all its
+ * contents, but never a nested `docs` elsewhere in the tree. The workspace
+ * root itself (`""`) is always included so a walk can descend into it.
+ * Empty pattern lists include everything.
+ */
+export function createIncludeMatcher(patterns) {
+    const matchers = [];
+    for (const pattern of patterns) {
+        const pat = pattern.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+        if (!pat)
+            continue;
+        matchers.push(new Minimatch(pat, { nocase: true, dot: true }));
+    }
+    if (matchers.length === 0) {
+        return { included: () => true };
+    }
+    function included(relPath) {
+        const normalized = relPath.replace(/\\/g, "/");
+        if (!normalized)
+            return true;
+        let prefix = "";
+        for (const seg of normalized.split("/")) {
+            prefix = prefix ? `${prefix}/${seg}` : seg;
+            for (const mm of matchers) {
+                if (mm.match(prefix) || mm.match(`${prefix}/`))
+                    return true;
+            }
+        }
+        return false;
+    }
+    return { included };
+}
 //# sourceMappingURL=exclude.js.map

package/dist/core/runtime-overrides.d.ts

@@ -49,6 +49,7 @@ export interface RuntimeOverrides {
     tui?: {
         fileListKeybinding?: string;
         chunksKeybinding?: string;
+        settingsKeybinding?: string;
     };
 }
 /** Load runtime overrides from the store directory. Returns empty object if none exist. */

package/dist/core/runtime-overrides.js

@@ -149,6 +149,7 @@ export function applyRuntimeOverrides(cfg, overrides) {
             ...(merged.tui ?? {}),
             fileListKeybinding: overrides.tui.fileListKeybinding ?? merged.tui?.fileListKeybinding ?? DEFAULT_CONFIG.tui.fileListKeybinding,
             chunksKeybinding: overrides.tui.chunksKeybinding ?? merged.tui?.chunksKeybinding ?? DEFAULT_CONFIG.tui.chunksKeybinding,
+            settingsKeybinding: overrides.tui.settingsKeybinding ?? merged.tui?.settingsKeybinding ?? DEFAULT_CONFIG.tui.settingsKeybinding,
         };
     }
     return merged;

package/dist/indexer/watch.d.ts

@@ -28,7 +28,9 @@ export declare function createWatchPassScheduler(runPass: (filterPaths?: string[
 /**
  * Build a predicate that returns `true` for paths that should be ignored by
  * a file watcher (store directory, manifest file, and configured exclude
- * directories).
+ * directories). When `indexing.includeDirs` is non-empty, any path outside
+ * the included folders is ignored as well, so out-of-scope changes never
+ * trigger re-index passes.
  *
  * @param cwd       - Workspace root directory.
  * @param config    - RAG configuration containing `indexing.excludeDirs`.

package/dist/indexer/watch.js

@@ -3,7 +3,7 @@
  */
 import path from "node:path";
 import { manifestPathFor } from "../core/manifest.js";
-import { createExcludeMatcher } from "../core/exclude.js";
+import { createExcludeMatcher, createIncludeMatcher } from "../core/exclude.js";
 /**
  * Create a scheduler that debounces calls to a re-index pass. While a pass is
  * running, subsequent notifications queue a single rerun. Useful for watching
@@ -108,7 +108,9 @@ export function createWatchPassScheduler(runPass, onError, debounceMs = 300) {
 /**
  * Build a predicate that returns `true` for paths that should be ignored by
  * a file watcher (store directory, manifest file, and configured exclude
- * directories).
+ * directories). When `indexing.includeDirs` is non-empty, any path outside
+ * the included folders is ignored as well, so out-of-scope changes never
+ * trigger re-index passes.
  *
  * @param cwd       - Workspace root directory.
  * @param config    - RAG configuration containing `indexing.excludeDirs`.
@@ -120,6 +122,7 @@ export function createWatchIgnore(cwd, config, storePath) {
     const manifestPath = manifestPathFor(storePath);
     const dirMatcher = createExcludeMatcher(config.indexing.excludeDirs);
     const fileMatcher = createExcludeMatcher(config.indexing.excludeFiles ?? []);
+    const includeMatcher = createIncludeMatcher(config.indexing.includeDirs ?? []);
     // Prefix check with a trailing separator so sibling dirs like
     // `<storePath>2` are NOT ignored; case-insensitive on win32 so a
     // differently-cased store path cannot cause self-triggering watch loops.
@@ -136,7 +139,7 @@ export function createWatchIgnore(cwd, config, storePath) {
         const relative = path.relative(cwd, resolved);
         if (!relative || relative.startsWith(".."))
             return false;
-        return dirMatcher.excluded(relative) || fileMatcher.excluded(relative);
+        return !includeMatcher.included(relative) || dirMatcher.excluded(relative) || fileMatcher.excluded(relative);
     };
 }
 //# sourceMappingURL=watch.js.map

package/dist/retriever/context-optimizer.js

@@ -122,8 +122,7 @@ function dedupeSimilar(results, threshold) {
                 if (sim > threshold) {
                     const [keepIdx, removeIdx] = kept[i].score >= kept[j].score ? [i, j] : [j, i];
                     const removedId = kept[removeIdx].chunk.id;
-                    kept.splice(removeIdx, 1);
-                    kept[keepIdx] = {
+                    const keeper = {
                         ...kept[keepIdx],
                         optimized: {
                             ...kept[keepIdx].optimized,
@@ -133,6 +132,14 @@ function dedupeSimilar(results, threshold) {
                             ],
                         },
                     };
+                    if (removeIdx < keepIdx) {
+                        kept.splice(removeIdx, 1);
+                        kept[keepIdx - 1] = keeper;
+                    }
+                    else {
+                        kept[keepIdx] = keeper;
+                        kept.splice(removeIdx, 1);
+                    }
                     changed = true;
                     break;
                 }

package/dist/tui.js

@@ -8,7 +8,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadRuntimeOverrides, saveRuntimeOverride } from "./core/runtime-overrides.js";
 import { PROVIDER_DEFAULTS } from "./core/provider-defaults.js";
-import { loadConfig } from "./core/config.js";
+import { loadConfig, updateConfigValue } from "./core/config.js";
 import { setPendingRagInjection } from "./core/rag-injection-flag.js";
 /** Cached plugin version string from package.json. */
 let _version;
@@ -162,6 +162,7 @@ function renderSidebar(theme, version, status, tuiConfig, tokenStats) {
             : `Watcher idle \u00B7 last ${formatRelativeTime(watcher.lastRunAt)}`;
     const fileListKey = tuiConfig?.fileListKeybinding ?? "ctrl+enter";
     const chunksKey = tuiConfig?.chunksKeybinding ?? "ctrl+alt+enter";
+    const settingsKey = tuiConfig?.settingsKeybinding ?? "ctrl+shift+r";
     return box({
         width: "100%",
         flexDirection: "column",
@@ -186,7 +187,7 @@ function renderSidebar(theme, version, status, tuiConfig, tokenStats) {
         text({ fg: theme.text }, [statusLine]),
         text({ fg: theme.textMuted }, [timeLine]),
         text({ fg: watcher.running ? theme.accent : theme.textMuted }, [watcherLine]),
-        text({ fg: theme.textMuted }, ["Ctrl+Shift+R → Settings"]),
+        text({ fg: theme.textMuted }, [`${formatKeybinding(settingsKey)} → Settings`]),
         text({ fg: theme.textMuted }, [`${formatKeybinding(fileListKey)} → Add File List`]),
         text({ fg: theme.textMuted }, [`${formatKeybinding(chunksKey)} → Add Chunks`]),
         ...(tokenStats && tokenStats.queries > 0 ? [
@@ -275,26 +276,6 @@ function resolveProviderBaseUrl(provider) {
  * Write a single config value at a dotted path into the opencode-rag.json file.
  * Creates intermediate objects as needed.
  */
-function saveConfigValue(configPath, path, value) {
-    try {
-        let raw = readFileSync(configPath, "utf-8");
-        if (raw.charCodeAt(0) === 0xfeff)
-            raw = raw.slice(1);
-        const data = JSON.parse(raw);
-        let target = data;
-        for (let i = 0; i < path.length - 1; i++) {
-            const key = path[i];
-            if (!target[key] || typeof target[key] !== "object") {
-                target[key] = {};
-            }
-            target = target[key];
-        }
-        target[path[path.length - 1]] = value;
-        writeFileSync(configPath, JSON.stringify(data, null, 2), "utf-8");
-    }
-    catch {
-    }
-}
 /**
  * Mirror the watcher status file that the server plugin maintains, so the
  * sidebar reflects a watcher toggle from the settings dialog immediately:
@@ -334,12 +315,12 @@ function saveModelSelection(storePath, configPath, selectionValue, path, provide
     const ragProvider = providerIdToRagProvider(providerId);
     const baseUrl = provider ? resolveProviderBaseUrl(provider) : "";
     saveRuntimeOverride(storePath, [section, "provider"], ragProvider);
-    saveConfigValue(configPath, [section, "provider"], ragProvider);
+    updateConfigValue(configPath, [section, "provider"], ragProvider);
     saveRuntimeOverride(storePath, [section, "model"], modelId);
-    saveConfigValue(configPath, [section, "model"], modelId);
+    updateConfigValue(configPath, [section, "model"], modelId);
     if (baseUrl) {
         saveRuntimeOverride(storePath, [section, "baseUrl"], baseUrl);
-        saveConfigValue(configPath, [section, "baseUrl"], baseUrl);
+        updateConfigValue(configPath, [section, "baseUrl"], baseUrl);
     }
     const apiKey = provider?.options?.apiKey ?? "";
     if (apiKey) {
@@ -609,6 +590,12 @@ function buildSettingCategories(cfg, ro, providers) {
             label: "Keybindings",
             description: "Configure keyboard shortcuts",
             entries: [
+                {
+                    path: ["tui", "settingsKeybinding"],
+                    label: "Open settings",
+                    type: "string",
+                    currentValue: tuiRo.settingsKeybinding ?? tuiCfg.settingsKeybinding ?? "ctrl+shift+r",
+                },
                 {
                     path: ["tui", "fileListKeybinding"],
                     label: "Add file list",
@@ -704,7 +691,7 @@ async function openSettingsDialog(api) {
                 else if (entry.type === "boolean") {
                     const newVal = !entry.currentValue;
                     saveRuntimeOverride(storePath, entry.path, newVal);
-                    saveConfigValue(configPath, entry.path, newVal);
+                    updateConfigValue(configPath, entry.path, newVal);
                     api.ui.toast({
                         variant: "success",
                         title: "Settings",
@@ -730,7 +717,7 @@ async function openSettingsDialog(api) {
                             const num = parseFloat(input);
                             if (!isNaN(num)) {
                                 saveRuntimeOverride(storePath, entry.path, num);
-                                saveConfigValue(configPath, entry.path, num);
+                                updateConfigValue(configPath, entry.path, num);
                                 api.ui.toast({
                                     variant: "success",
                                     title: "Settings",
@@ -763,7 +750,7 @@ async function openSettingsDialog(api) {
                                     return;
                                 }
                                 saveRuntimeOverride(storePath, entry.path, parsed);
-                                saveConfigValue(configPath, entry.path, parsed);
+                                updateConfigValue(configPath, entry.path, parsed);
                                 api.ui.toast({
                                     variant: "success",
                                     title: "Settings",
@@ -792,7 +779,7 @@ async function openSettingsDialog(api) {
                         value: String(entry.currentValue),
                         onConfirm: (input) => {
                             saveRuntimeOverride(storePath, entry.path, input);
-                            saveConfigValue(configPath, entry.path, input);
+                            updateConfigValue(configPath, entry.path, input);
                             api.ui.toast({
                                 variant: "success",
                                 title: "Settings",
@@ -828,7 +815,7 @@ async function openSettingsDialog(api) {
                             }
                             else if (input) {
                                 saveRuntimeOverride(storePath, entry.path, input);
-                                saveConfigValue(configPath, entry.path, input);
+                                updateConfigValue(configPath, entry.path, input);
                                 entry.currentValue = input;
                             }
                             api.onSettingsChanged?.();
@@ -971,10 +958,11 @@ const plugin = {
                 // ignore
             }
         }
-        // Register keybinding for settings dialog
+        // Register keybinding for settings dialog (configurable)
         try {
+            const settingsKey = tuiConfig?.settingsKeybinding ?? "ctrl+shift+r";
             api.keymap.registerLayer({
-                bindings: [{ key: "ctrl+shift+r", cmd: "opencode-rag:settings" }],
+                bindings: [{ key: settingsKey, cmd: "opencode-rag:settings" }],
                 commands: [
                     {
                         name: "opencode-rag:settings",

package/dist/web/api.d.ts

@@ -4,7 +4,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { LanceDbStore } from "../vectorstore/lancedb.js";
 import { KeywordIndex } from "../retriever/keyword-index.js";
-import type { RagConfig } from "../core/config.js";
+import { type RagConfig } from "../core/config.js";
 import { type EmbeddingProvider } from "../core/interfaces.js";
 /** Internal shape for a JSON API response: an HTTP status code and a serialisable body. */
 interface ApiResponse {
@@ -26,9 +26,12 @@ interface ApiResponse {
  * @param storePath    - Filesystem path to the store directory (used by eval endpoints).
  * @param cwd          - Optional workspace root for resolving file paths.
  * @param cfg          - Active RAG configuration (used by quirk endpoints).
+ * @param getEmbedder  - Lazily-created embedder for /api/retrieve and reindex passes.
+ * @param token        - Per-run auth token required on every request.
+ * @param configPath   - Path to the opencode-rag.json config file, used by PUT /api/config.
  * @returns An async handler that returns `true` when a route matched or `false` otherwise.
  */
-export declare function createApiHandler(store: LanceDbStore, keywordIndex: KeywordIndex, storePath: string, cwd?: string, cfg?: RagConfig, getEmbedder?: () => Promise<EmbeddingProvider>, token?: string): (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
+export declare function createApiHandler(store: LanceDbStore, keywordIndex: KeywordIndex, storePath: string, cwd?: string, cfg?: RagConfig, getEmbedder?: () => Promise<EmbeddingProvider>, token?: string, configPath?: string): (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
 /**
  * Perform token-usage analysis for a single evaluation session.
  *