opencode-rag-plugin 1.12.17 → 1.14.7

package/dist/core/interfaces.d.ts

@@ -1,3 +1,4 @@
+/** A semantic fragment of a file produced by a {@link Chunker}. */
 export interface Chunk {
     id: string;
     content: string;
@@ -11,48 +12,98 @@ export interface Chunk {
         contentType?: string;
     };
 }
+/** Generates natural-language descriptions for code chunks using an LLM. */
 export interface DescriptionProvider {
+    /** Generate a description for a single chunk. */
     generateDescription(chunk: Chunk): Promise<string>;
-    generateBatchDescriptions(chunks: Chunk[]): Promise<Map<string, string>>;
+    /** Generate descriptions for multiple chunks concurrently. Returns a Map of chunk ID to description. */
+    generateBatchDescriptions(chunks: Chunk[], logDebug?: (msg: string) => void): Promise<Map<string, string>>;
 }
+/** Explains how a search result score was computed, including vector and keyword contributions. */
 export interface SearchExplanation {
+    /** Breakdown of the fused score components. */
     scoreBreakdown: {
+        /** Normalized vector similarity score. */
         vectorScore: number;
+        /** Normalized keyword (TF-IDF) score. */
         keywordScore: number;
+        /** Raw (unnormalized) vector similarity score before fusion. */
         rawVectorScore: number;
+        /** Raw (unnormalized) keyword score before fusion. */
         rawKeywordScore: number;
+        /** Weight applied to keyword score during fusion (0-1). */
         keywordWeight: number;
     };
+    /** Query terms that matched in the keyword index, if hybrid search was used. */
     matchedTerms?: string[];
 }
+/** A single result from a vector or hybrid search query. */
 export interface SearchResult {
+    /** The matched chunk of content. */
     chunk: Chunk;
+    /** Relevance score between 0 and 1. */
     score: number;
+    /** Optional breakdown of how the score was computed. */
     explanation?: SearchExplanation;
 }
+/** Splits a source file into semantic chunks based on AST structure or content heuristics. */
 export interface Chunker {
+    /** Human-readable language name (e.g. "TypeScript", "Python"). */
     readonly language: string;
+    /** File extensions this chunker handles (e.g. [".ts", ".tsx"]). */
     readonly fileExtensions?: string[];
+    /** Split the file content into chunks. */
     chunk(filePath: string, content: string): Promise<Chunk[]>;
 }
+/** Generates vector embeddings for text inputs via a configured model (Ollama, OpenAI, Cohere, etc.). */
 export interface EmbeddingProvider {
+    /** Provider name (e.g. "ollama", "openai", "cohere"). */
     readonly name: string;
+    /** Embed one or more text strings. `purpose` may apply a prefix for query vs. document embeddings. */
     embed(texts: string[], purpose?: "query" | "document"): Promise<number[][]>;
 }
+/** In-memory TF-IDF inverted index for keyword-based search alongside vector search. */
 export interface KeywordIndex {
+    /** Index a set of chunks by tokenizing their content. */
     addChunks(chunks: Chunk[]): void;
+    /** Remove all entries for a given file path from the index. */
     removeByFilePath(filePath: string): void;
+    /** Search the index for the top-K matching chunks. */
     search(query: string, topK: number): SearchResult[];
+    /** Get the terms from a query that matched a specific chunk. */
     getMatchedTerms(query: string, chunkId: string): string[];
+    /** Clear all indexed data. */
     clear(): void;
+    /** Return the total number of indexed chunks. */
     count(): number;
+    /** Persist the index to disk as JSON. */
     save(filePath?: string): Promise<void>;
 }
+/** Persistent vector storage and retrieval backend (LanceDB or in-memory). */
 export interface VectorStore {
+    /** Store a batch of chunks with their embeddings. */
     addChunks(chunks: Chunk[]): Promise<void>;
+    /** Search for the top-K nearest neighbor chunks by embedding similarity. */
     search(embedding: number[], topK: number): Promise<SearchResult[]>;
+    /** Return the total number of stored chunks. */
     count(): Promise<number>;
+    /** Remove all stored data. */
     clear(): Promise<void>;
+    /** Delete all chunks associated with a specific file path. */
     deleteByFilePath(filePath: string): Promise<void>;
+    /** Release any held resources and close the store. */
     close(): Promise<void>;
 }
+/** Callback interface for reporting indexing progress to the UI or CLI. */
+export interface IndexProgress {
+    /** Set the total number of files to be indexed. */
+    setFileCount(count: number): void;
+    /** Called when a new file begins indexing. */
+    startFile(label: string): void;
+    /** Called when a pipeline stage completes for the current file. */
+    finishStage(label: string): void;
+    /** Called when a file is fully processed. */
+    finishFile(label: string): void;
+    /** Called when indexing fails for a file. */
+    failFile(label: string): void;
+}

package/dist/core/manifest.d.ts

@@ -1,26 +1,51 @@
+/** Metadata entry for a single indexed file. */
 export interface ManifestEntry {
+    /** SHA-256 hash of the file content. */
     hash: string;
+    /** Number of chunks produced for this file. */
     chunkCount: number;
+    /** Unix timestamp of when this file was last indexed. */
     indexedAt: number;
+    /** Filesystem modification time at time of indexing. */
     mtime?: number;
+    /** File size in bytes. */
     size?: number;
+    /** Whether the description generation step failed for this file. */
+    descriptionFailed?: boolean;
 }
+/** Current schema version for manifest files. */
 export declare const SCHEMA_VERSION = 1;
+/** Persistent manifest tracking indexing state across sessions. */
 export interface FileManifest {
+    /** Unix timestamp of the last full index pass. */
     lastIndexedAt?: number;
+    /** Schema version for forward-compatibility checks. */
     schemaVersion?: number;
+    /** Map of normalized file path to its manifest entry. */
     files: Record<string, ManifestEntry>;
+    /** Git commit hash at last index, used for incremental re-indexing. */
     lastGitCommit?: string;
 }
+/** Health status of a loaded manifest file. */
 export type ManifestStatus = "ok" | "missing" | "corrupt";
+/** Result of loading a manifest from disk. */
 export interface LoadedManifest {
+    /** The parsed manifest data (empty if missing/corrupt). */
     manifest: FileManifest;
+    /** Filesystem path the manifest was loaded from. */
     path: string;
+    /** Load status indicating health. */
     status: ManifestStatus;
 }
+/** Create a new empty manifest with the current schema version. */
 export declare function createEmptyManifest(): FileManifest;
+/** Resolve the manifest file path within a vector store directory. */
 export declare function manifestPathFor(dbPath: string): string;
+/** Normalize a file path to use forward slashes for cross-platform consistency. */
 export declare function normalizeFilePath(filePath: string): string;
+/** Compute the SHA-256 hex hash of a string. */
 export declare function computeFileHash(content: string): string;
+/** Load a manifest from disk, handling missing or corrupt files gracefully. */
 export declare function loadManifest(dbPath: string): Promise<LoadedManifest>;
+/** Persist a manifest to disk with atomic write (temp file + rename, with Windows fallback). */
 export declare function saveManifest(dbPath: string, manifest: FileManifest): Promise<void>;

package/dist/core/manifest.js

@@ -1,19 +1,25 @@
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
+/** Current schema version for manifest files. */
 export const SCHEMA_VERSION = 1;
+/** Create a new empty manifest with the current schema version. */
 export function createEmptyManifest() {
     return { files: {}, schemaVersion: SCHEMA_VERSION };
 }
+/** Resolve the manifest file path within a vector store directory. */
 export function manifestPathFor(dbPath) {
     return path.join(dbPath, "manifest.json");
 }
+/** Normalize a file path to use forward slashes for cross-platform consistency. */
 export function normalizeFilePath(filePath) {
     return path.resolve(filePath).replace(/\\/g, "/");
 }
+/** Compute the SHA-256 hex hash of a string. */
 export function computeFileHash(content) {
     return createHash("sha256").update(content).digest("hex");
 }
+/** Load a manifest from disk, handling missing or corrupt files gracefully. */
 export async function loadManifest(dbPath) {
     const filePath = manifestPathFor(dbPath);
     try {
@@ -40,12 +46,20 @@ export async function loadManifest(dbPath) {
         return { manifest: createEmptyManifest(), path: filePath, status: "corrupt" };
     }
 }
+/** Persist a manifest to disk with atomic write (temp file + rename, with Windows fallback). */
 export async function saveManifest(dbPath, manifest) {
     const filePath = manifestPathFor(dbPath);
     const tempPath = `${filePath}.tmp`;
     manifest.schemaVersion = SCHEMA_VERSION;
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(tempPath, JSON.stringify(manifest, null, 2), "utf-8");
-    await fs.rename(tempPath, filePath);
+    try {
+        await fs.rename(tempPath, filePath);
+    }
+    catch {
+        // Windows: rename fails with EPERM if destination exists
+        await fs.unlink(filePath).catch(() => { });
+        await fs.rename(tempPath, filePath);
+    }
 }
 //# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"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"}

package/dist/core/provider-defaults.d.ts

@@ -1,9 +1,17 @@
+/** Default configuration parameters for a supported LLM/embedding provider. */
 export interface ProviderDefaults {
+    /** Default base URL for API requests. */
     defaultBaseUrl: string;
+    /** Environment variable name to read the API key from. */
     apiKeyEnvVar: string;
+    /** Whether this provider supports embedding endpoints. */
     supportsEmbedding: boolean;
+    /** Whether this provider supports chat/completion endpoints. */
     supportsChat: boolean;
 }
+/** Registry of known provider default configurations (base URLs, env vars, capability flags). */
 export declare const PROVIDER_DEFAULTS: Record<string, ProviderDefaults>;
+/** Look up default configuration for a named provider. Returns undefined for unknown providers. */
 export declare function getProviderDefault(provider: string): ProviderDefaults | undefined;
+/** Check whether a given provider uses an OpenAI-compatible API format. */
 export declare function isOpenAiCompatible(provider: string): boolean;

package/dist/core/provider-defaults.js

@@ -1,3 +1,4 @@
+/** Registry of known provider default configurations (base URLs, env vars, capability flags). */
 export const PROVIDER_DEFAULTS = {
     ollama: {
         defaultBaseUrl: "http://127.0.0.1:11434",
@@ -72,9 +73,11 @@ export const PROVIDER_DEFAULTS = {
         supportsChat: false,
     },
 };
+/** Look up default configuration for a named provider. Returns undefined for unknown providers. */
 export function getProviderDefault(provider) {
     return PROVIDER_DEFAULTS[provider];
 }
+/** Check whether a given provider uses an OpenAI-compatible API format. */
 export function isOpenAiCompatible(provider) {
     if (provider === "ollama" || provider === "anthropic" || provider === "google" || provider === "cohere") {
         return false;

package/dist/core/provider-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-defaults.js","sourceRoot":"","sources":["../../src/core/provider-defaults.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,MAAM,EAAE;QACN,cAAc,EAAE,wBAAwB;QACxC,YAAY,EAAE,EAAE;QAChB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,2BAA2B;QAC3C,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,qCAAqC;QACrD,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,KAAK,EAAE;QACL,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,OAAO,EAAE;QACP,cAAc,EAAE,2BAA2B;QAC3C,YAAY,EAAE,iBAAiB;QAC/B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,cAAc,EAAE,6BAA6B;QAC7C,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,gCAAgC;QAChD,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,cAAc,EAAE,0BAA0B;QAC1C,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,cAAc,EAAE,uCAAuC;QACvD,YAAY,EAAE,mBAAmB;QACjC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,cAAc,EAAE,8BAA8B;QAC9C,YAAY,EAAE,mBAAmB;QACjC,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,8CAA8C;QAC9D,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,0BAA0B;QAC1C,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,KAAK;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"provider-defaults.js","sourceRoot":"","sources":["../../src/core/provider-defaults.ts"],"names":[],"mappings":"AAYA,iGAAiG;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,MAAM,EAAE;QACN,cAAc,EAAE,wBAAwB;QACxC,YAAY,EAAE,EAAE;QAChB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,2BAA2B;QAC3C,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,qCAAqC;QACrD,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,KAAK,EAAE;QACL,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,OAAO,EAAE;QACP,cAAc,EAAE,2BAA2B;QAC3C,YAAY,EAAE,iBAAiB;QAC/B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,cAAc,EAAE,6BAA6B;QAC7C,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,gCAAgC;QAChD,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,cAAc,EAAE,0BAA0B;QAC1C,YAAY,EAAE,kBAAkB;QAChC,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,cAAc,EAAE,uCAAuC;QACvD,YAAY,EAAE,mBAAmB;QACjC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,cAAc,EAAE,8BAA8B;QAC9C,YAAY,EAAE,mBAAmB;QACjC,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,8CAA8C;QAC9D,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,KAAK;QACxB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,0BAA0B;QAC1C,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,KAAK;KACpB;CACF,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/rag-injection-flag.d.ts

@@ -1,3 +1,6 @@
+/** Type of RAG injection to perform on the next chat message. */
 export type RagInjectionType = "chunks" | "files";
+/** Persist a flag indicating that RAG context should be injected on the next message. */
 export declare function setPendingRagInjection(storePath: string, type: RagInjectionType): void;
+/** Read and remove the pending injection flag. Returns the injection type or undefined if none pending. */
 export declare function consumePendingRagInjection(storePath: string): RagInjectionType | undefined;

package/dist/core/rag-injection-flag.js

@@ -1,9 +1,11 @@
 import { writeFileSync, readFileSync, unlinkSync, existsSync } from "node:fs";
 import { join } from "node:path";
 const FLAG_FILE = ".pending-injection";
+/** Persist a flag indicating that RAG context should be injected on the next message. */
 export function setPendingRagInjection(storePath, type) {
     writeFileSync(join(storePath, FLAG_FILE), type, "utf-8");
 }
+/** Read and remove the pending injection flag. Returns the injection type or undefined if none pending. */
 export function consumePendingRagInjection(storePath) {
     const flagPath = join(storePath, FLAG_FILE);
     if (!existsSync(flagPath))

package/dist/core/rag-injection-flag.js.map

@@ -1 +1 @@
-{"version":3,"file":"rag-injection-flag.js","sourceRoot":"","sources":["../../src/core/rag-injection-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAEvC,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,IAAsB;IAC9E,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAqB,CAAC;QAClE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"rag-injection-flag.js","sourceRoot":"","sources":["../../src/core/rag-injection-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAEvC,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,IAAsB;IAC9E,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAqB,CAAC;QAClE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/core/resolve-api-key.d.ts

@@ -1,2 +1,3 @@
 import type { RagConfig } from "./config.js";
+/** Resolve API keys for embedding, description, and image description providers. Checks config, env vars, and OpenCode provider config. */
 export declare function resolveApiKey(cfg: RagConfig, worktree?: string): void;

package/dist/core/resolve-api-key.js

@@ -1,6 +1,7 @@
 import { readFileSync, existsSync } from "node:fs";
 import path from "node:path";
 import { getProviderDefault } from "./provider-defaults.js";
+/** Resolve API keys for embedding, description, and image description providers. Checks config, env vars, and OpenCode provider config. */
 export function resolveApiKey(cfg, worktree) {
     resolveForSection(cfg.embedding.provider, cfg.embedding, worktree);
     if (cfg.description) {

package/dist/core/resolve-api-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-api-key.js","sourceRoot":"","sources":["../../src/core/resolve-api-key.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-api-key.js","sourceRoot":"","sources":["../../src/core/resolve-api-key.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import type { RagConfig } from "./config.js";
+/** Live-configuration overrides that take precedence over the on-disk config file. */
 export interface RuntimeOverrides {
     retrieval?: {
         topK?: number;
@@ -41,6 +42,9 @@ export interface RuntimeOverrides {
         chunksKeybinding?: string;
     };
 }
+/** Load runtime overrides from the store directory. Returns empty object if none exist. */
 export declare function loadRuntimeOverrides(storePath: string): RuntimeOverrides;
+/** Save a single runtime override value at a dotted path. Creates intermediate objects as needed. */
 export declare function saveRuntimeOverride(storePath: string, path: string[], value: boolean | number | string): void;
+/** Deep-merge runtime overrides into a config object. Returns a new object without mutating the original. */
 export declare function applyRuntimeOverrides(cfg: RagConfig, overrides: RuntimeOverrides): RagConfig;

package/dist/core/runtime-overrides.js

@@ -1,6 +1,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { DEFAULT_CONFIG } from "./config.js";
+/** Load runtime overrides from the store directory. Returns empty object if none exist. */
 export function loadRuntimeOverrides(storePath) {
     const overridePath = join(storePath, "runtime-overrides.json");
     if (!existsSync(overridePath))
@@ -12,6 +13,7 @@ export function loadRuntimeOverrides(storePath) {
         return {};
     }
 }
+/** Save a single runtime override value at a dotted path. Creates intermediate objects as needed. */
 export function saveRuntimeOverride(storePath, path, value) {
     const overridePath = join(storePath, "runtime-overrides.json");
     const overrides = loadRuntimeOverrides(storePath);
@@ -34,10 +36,11 @@ export function saveRuntimeOverride(storePath, path, value) {
         // silently ignore write errors
     }
 }
+/** Deep-merge runtime overrides into a config object. Returns a new object without mutating the original. */
 export function applyRuntimeOverrides(cfg, overrides) {
     if (!overrides || Object.keys(overrides).length === 0)
         return cfg;
-    const merged = JSON.parse(JSON.stringify(cfg));
+    const merged = structuredClone(cfg);
     if (overrides.retrieval) {
         if (overrides.retrieval.topK !== undefined)
             merged.retrieval.topK = overrides.retrieval.topK;

package/dist/core/runtime-overrides.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-overrides.js","sourceRoot":"","sources":["../../src/core/runtime-overrides.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-overrides.js","sourceRoot":"","sources":["../../src/core/runtime-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8C7C,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAqB,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,IAAc,EACd,KAAgC;IAEhC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,MAAM,GAA4B,SAA+C,CAAC;IACtF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,GAAG,CAA4B,CAAC;IAClD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,qBAAqB,CACnC,GAAc,EACd,SAA2B;IAE3B,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAElE,MAAM,MAAM,GAAc,eAAe,CAAC,GAAG,CAAC,CAAC;IAE/C,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;QAC7F,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;QACzG,IAAI,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY;gBAAE,MAAM,CAAC,SAAS,CAAC,YAAY,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;YAC1G,IAAI,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC;YAC7I,IAAI,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,aAAa,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC;QACjK,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACpH,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;YACjI,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC;QAC5I,CAAC;QACD,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU;gBAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;YAC3J,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;YACpI,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;YACvI,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;YAC1I,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAoC,CAAC;QAC3K,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;QACzG,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;QAChG,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC;IACxG,CAAC;IAED,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,SAAS,CAAC,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAClK,MAAM,CAAC,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;QAC7D,CAAC;QACD,IAAI,SAAS,CAAC,WAAW,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAClK,MAAM,CAAC,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC;QAC/D,CAAC;QACD,IAAI,SAAS,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAClK,MAAM,CAAC,WAAW,CAAC,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;QACzD,CAAC;QACD,IAAI,SAAS,CAAC,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAClK,MAAM,CAAC,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,gBAAgB,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,gBAAgB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,gBAAgB;gBAAE,MAAM,CAAC,gBAAgB,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,4BAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9L,MAAM,CAAC,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC;QACvE,CAAC;QACD,IAAI,SAAS,CAAC,gBAAgB,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,gBAAgB;gBAAE,MAAM,CAAC,gBAAgB,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,4BAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9L,MAAM,CAAC,gBAAgB,CAAC,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QACzE,CAAC;QACD,IAAI,SAAS,CAAC,gBAAgB,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,gBAAgB;gBAAE,MAAM,CAAC,gBAAgB,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,4BAA4B,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9L,MAAM,CAAC,gBAAgB,CAAC,KAAK,GAAG,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,GAAG;YACX,GAAG,cAAc,CAAC,GAAG;YACrB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACrB,kBAAkB,EAAE,SAAS,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,GAAG,EAAE,kBAAkB,IAAI,cAAc,CAAC,GAAG,CAAC,kBAAkB;YAC/H,gBAAgB,EAAE,SAAS,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC,GAAG,EAAE,gBAAgB,IAAI,cAAc,CAAC,GAAG,CAAC,gBAAgB;SACxH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/describer/anthropic.d.ts

@@ -1,10 +1,30 @@
 import type { Chunk, DescriptionProvider } from "../core/interfaces.js";
 import type { DescriptionConfig } from "../core/config.js";
+/**
+ * Description provider that uses Anthropic's Messages API to generate natural-language descriptions of code chunks.
+ *
+ * Requires an API key set in the configuration. The system prompt is prepended to each user message within a single
+ * message payload. Supports retry with exponential backoff.
+ */
 export declare class AnthropicDescriptionProvider implements DescriptionProvider {
     private readonly config;
+    /**
+     * @param config - Configuration for the Anthropic provider, including base URL, model, API key, and retry settings.
+     */
     constructor(config: DescriptionConfig);
+    /** @inheritdoc */
     generateDescription(chunk: Chunk): Promise<string>;
-    generateBatchDescriptions(chunks: Chunk[]): Promise<Map<string, string>>;
-    private executeBatch;
+    /** @inheritdoc */
+    generateBatchDescriptions(chunks: Chunk[], logDebug?: (msg: string) => void): Promise<Map<string, string>>;
+    /**
+     * Sends a request to the Anthropic Messages API with retry and exponential backoff.
+     * The system prompt is combined with all user messages into a single message payload, and
+     * the assistant placeholder is appended to elicit a completion.
+     *
+     * @param messages - The user messages to send.
+     * @param timeoutMs - Request timeout in milliseconds.
+     * @returns The trimmed response text from the model.
+     * @throws When all retry attempts are exhausted or the response is empty.
+     */
     private chatRequest;
 }

package/dist/describer/anthropic.js

@@ -1,64 +1,66 @@
 import { postJson } from "../embedder/http.js";
+import { buildUserMessage, sleep } from "./shared.js";
 import pLimit from "p-limit";
+/** HTTP status codes that are safe to retry on. */
 const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+/**
+ * Description provider that uses Anthropic's Messages API to generate natural-language descriptions of code chunks.
+ *
+ * Requires an API key set in the configuration. The system prompt is prepended to each user message within a single
+ * message payload. Supports retry with exponential backoff.
+ */
 export class AnthropicDescriptionProvider {
     config;
+    /**
+     * @param config - Configuration for the Anthropic provider, including base URL, model, API key, and retry settings.
+     */
     constructor(config) {
         this.config = config;
     }
+    /** @inheritdoc */
     async generateDescription(chunk) {
         const messages = [
-            { role: "user", content: buildUserMessage(chunk) },
+            { role: "user", content: buildUserMessage(chunk, this.config.maxContentChars) },
         ];
         return this.chatRequest(messages, this.config.timeoutMs ?? 60000);
     }
-    async generateBatchDescriptions(chunks) {
-        if (chunks.length === 1) {
-            const desc = await this.generateDescription(chunks[0]);
-            return new Map([[chunks[0].id, desc]]);
-        }
-        const batchMaxChunks = this.config.batchMaxChunks ?? 25;
-        const batchConcurrency = this.config.batchConcurrency ?? 3;
-        const batches = [];
-        for (let i = 0; i < chunks.length; i += batchMaxChunks) {
-            batches.push(chunks.slice(i, i + batchMaxChunks));
-        }
+    /** @inheritdoc */
+    async generateBatchDescriptions(chunks, logDebug) {
+        const concurrency = this.config.batchConcurrency ?? 3;
+        const total = chunks.length;
+        console.log(`[describer] Generating descriptions for ${total} chunks (concurrency: ${concurrency})`);
         const result = new Map();
-        const batchLimit = pLimit(batchConcurrency);
-        await Promise.all(batches.map((batch) => batchLimit(async () => {
+        const limit = pLimit(concurrency);
+        let completed = 0;
+        await Promise.all(chunks.map((chunk) => limit(async () => {
+            const userMsg = buildUserMessage(chunk, this.config.maxContentChars);
+            (logDebug ?? console.debug)(`[describer] REQUEST chunk ${chunk.id} (${chunk.metadata.filePath}:${chunk.metadata.startLine}):\n${userMsg}`);
             try {
-                const batchResult = await this.executeBatch(batch);
-                for (const [id, desc] of batchResult) {
-                    result.set(id, desc);
-                }
+                const desc = await this.generateDescription(chunk);
+                result.set(chunk.id, desc);
+                (logDebug ?? console.debug)(`[describer] RESPONSE chunk ${chunk.id}: ${desc}`);
+            }
+            catch (err) {
+                console.warn(`[describer] Failed to describe chunk ${chunk.id} (${chunk.metadata.filePath}:${chunk.metadata.startLine}): ${err instanceof Error ? err.message : String(err)}`);
             }
-            catch {
-                // Batch failed — individual fallback below handles missing chunks
+            completed++;
+            if (completed % 25 === 0 || completed === total) {
+                console.log(`[describer] Progress: ${completed}/${total}`);
             }
         })));
-        const missingChunks = chunks.filter((c) => !result.has(c.id));
-        if (missingChunks.length > 0) {
-            const fallbackLimit = pLimit(batchConcurrency);
-            await Promise.all(missingChunks.map((chunk) => fallbackLimit(async () => {
-                try {
-                    const desc = await this.generateDescription(chunk);
-                    result.set(chunk.id, desc);
-                }
-                catch {
-                    // skip — caller will fall back to content
-                }
-            })));
-        }
+        console.log(`[describer] Descriptions generated: ${result.size}/${total}`);
         return result;
     }
-    async executeBatch(chunks) {
-        const messages = [
-            { role: "user", content: buildBatchUserMessage(chunks) },
-        ];
-        const timeoutMs = this.config.batchTimeoutMs ?? 120000;
-        const responseText = await this.chatRequest(messages, timeoutMs);
-        return parseBatchResponse(responseText, chunks);
-    }
+    /**
+     * Sends a request to the Anthropic Messages API with retry and exponential backoff.
+     * The system prompt is combined with all user messages into a single message payload, and
+     * the assistant placeholder is appended to elicit a completion.
+     *
+     * @param messages - The user messages to send.
+     * @param timeoutMs - Request timeout in milliseconds.
+     * @returns The trimmed response text from the model.
+     * @throws When all retry attempts are exhausted or the response is empty.
+     */
     async chatRequest(messages, timeoutMs) {
         const baseUrl = this.config.baseUrl.replace(/\/+$/, "");
         const apiKey = this.config.apiKey ?? "";
@@ -98,74 +100,4 @@ export class AnthropicDescriptionProvider {
         throw lastError ?? new Error("Anthropic LLM request failed: unknown error");
     }
 }
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function buildUserMessage(chunk) {
-    const parts = [];
-    if (chunk.metadata.filePath) {
-        parts.push(`File: ${chunk.metadata.filePath}`);
-    }
-    if (chunk.metadata.language) {
-        parts.push(`Language: ${chunk.metadata.language}`);
-    }
-    parts.push(`Lines: ${chunk.metadata.startLine}-${chunk.metadata.endLine}`);
-    parts.push("");
-    parts.push("```" + (chunk.metadata.language || ""));
-    parts.push(chunk.content);
-    parts.push("```");
-    return parts.join("\n");
-}
-function buildBatchUserMessage(chunks) {
-    const first = chunks[0];
-    const parts = [];
-    if (first.metadata.filePath) {
-        parts.push(`File: ${first.metadata.filePath}`);
-    }
-    if (first.metadata.language) {
-        parts.push(`Language: ${first.metadata.language}`);
-    }
-    parts.push(`Chunks: ${chunks.length}`);
-    parts.push("");
-    for (let i = 0; i < chunks.length; i++) {
-        const chunk = chunks[i];
-        const lang = chunk.metadata.language || "";
-        parts.push(`=== CHUNK ${i} (lines ${chunk.metadata.startLine}-${chunk.metadata.endLine}) ===`);
-        parts.push("```" + lang);
-        parts.push(chunk.content);
-        parts.push("```");
-        parts.push("");
-    }
-    return parts.join("\n");
-}
-function parseBatchResponse(text, chunks) {
-    const result = new Map();
-    const chunkPattern = /^CHUNK\s+(\d+)\s*[):-]?\s*/i;
-    const lines = text.split("\n");
-    let currentIndex = null;
-    let currentDesc = [];
-    for (const line of lines) {
-        const match = chunkPattern.exec(line.trim());
-        if (match) {
-            if (currentIndex !== null && currentDesc.length > 0) {
-                const desc = currentDesc.join(" ").trim();
-                if (desc.length > 0 && currentIndex >= 0 && currentIndex < chunks.length) {
-                    result.set(chunks[currentIndex].id, desc);
-                }
-            }
-            currentIndex = parseInt(match[1], 10);
-            currentDesc = [line.slice(match[0].length).trim()];
-        }
-        else if (currentIndex !== null) {
-            currentDesc.push(line.trim());
-        }
-    }
-    if (currentIndex !== null && currentDesc.length > 0) {
-        const desc = currentDesc.join(" ").trim();
-        if (desc.length > 0 && currentIndex >= 0 && currentIndex < chunks.length) {
-            result.set(chunks[currentIndex].id, desc);
-        }
-    }
-    return result;
-}
 //# sourceMappingURL=anthropic.js.map