@abhinav2203/coderag 0.1.1

package/dist/indexer/indexer.js

@@ -0,0 +1,108 @@
+import path from "node:path";
+import { buildGraphSnapshot } from "../adapters/codeflow-core.js";
+import { IndexingError } from "../errors/index.js";
+import { ManifestStore } from "../store/manifest-store.js";
+import { IndexLock } from "../store/index-lock.js";
+import { buildIndexManifest, buildIndexedDocuments } from "./documents.js";
+const diffNodeIds = (previousManifest, nextManifest) => {
+    if (!previousManifest) {
+        return {
+            removedNodeIds: [],
+            changedNodeIds: Object.keys(nextManifest.nodes)
+        };
+    }
+    const previousIds = new Set(Object.keys(previousManifest.nodes));
+    const nextIds = new Set(Object.keys(nextManifest.nodes));
+    const removedNodeIds = [...previousIds].filter((nodeId) => !nextIds.has(nodeId));
+    const changedNodeIds = Object.entries(nextManifest.nodes)
+        .filter(([nodeId, entry]) => {
+        const previousEntry = previousManifest.nodes[nodeId];
+        return !previousEntry || previousEntry.docHash !== entry.docHash || previousEntry.fileHash !== entry.fileHash;
+    })
+        .map(([nodeId]) => nodeId);
+    return {
+        removedNodeIds,
+        changedNodeIds
+    };
+};
+const buildIndexSummary = (snapshot, manifest, documents) => ({
+    graph: snapshot.graph,
+    manifest,
+    snapshot,
+    indexedNodeCount: Object.keys(documents).length
+});
+/**
+ * Indexes the repository graph and persists the resulting search documents.
+ */
+export class RepoIndexer {
+    config;
+    manifestStore;
+    indexLock;
+    constructor(config) {
+        this.config = config;
+        this.manifestStore = new ManifestStore(config.storageRoot);
+        this.indexLock = new IndexLock(config.storageRoot, config.locking, config.logger);
+    }
+    async loadState() {
+        const [manifest, snapshot, documents] = await Promise.all([
+            this.manifestStore.loadManifest(),
+            this.manifestStore.loadSnapshot(),
+            this.manifestStore.loadDocuments()
+        ]);
+        return {
+            manifest,
+            snapshot,
+            documents
+        };
+    }
+    async waitForUnlockedState() {
+        const waited = await this.indexLock.waitForRelease();
+        return {
+            waited,
+            ...(await this.loadState())
+        };
+    }
+    async index(forceFull = false, docsPath) {
+        const graphProvider = this.config.graphProvider;
+        const embeddingProvider = this.config.embeddingProvider;
+        const vectorStore = this.config.vectorStore;
+        if (!graphProvider || !embeddingProvider || !vectorStore) {
+            throw new IndexingError("CodeRag is missing required indexing dependencies.");
+        }
+        return this.indexLock.withLock("index", async () => {
+            const { manifest: previousManifest } = await this.loadState();
+            const snapshot = await buildGraphSnapshot(this.config.repoPath, graphProvider);
+            const documents = await buildIndexedDocuments(snapshot, embeddingProvider, docsPath);
+            const manifest = await buildIndexManifest(this.config.repoPath, snapshot, documents);
+            const { removedNodeIds, changedNodeIds } = diffNodeIds(previousManifest, manifest);
+            try {
+                if (forceFull || !previousManifest) {
+                    await vectorStore.reset(Object.values(documents));
+                }
+                else {
+                    await vectorStore.deleteByNodeIds(removedNodeIds);
+                    await vectorStore.upsert(changedNodeIds
+                        .map((nodeId) => documents[nodeId])
+                        .filter((document) => Boolean(document)));
+                }
+            }
+            catch (error) {
+                throw new IndexingError("Failed to persist indexed documents to the vector store.", {
+                    repoPath: this.config.repoPath
+                }, { cause: error });
+            }
+            await Promise.all([
+                this.manifestStore.saveManifest(manifest),
+                this.manifestStore.saveSnapshot(snapshot),
+                this.manifestStore.saveDocuments(documents)
+            ]);
+            this.config.logger?.info("Indexed repository", {
+                repoPath: path.resolve(this.config.repoPath),
+                indexedNodeCount: Object.keys(documents).length,
+                fullReindex: forceFull || !previousManifest
+            });
+            return buildIndexSummary(snapshot, manifest, documents);
+        });
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer/indexer.js.map

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

package/dist/llm/context-builder.d.ts

@@ -0,0 +1,7 @@
+import type { BlueprintNode } from "@abhinav2203/codeflow-core/schema";
+import type { ContextPackage, GraphSnapshot, IndexedNodeDocument, RetrievalConfig } from "../types.js";
+import { FileCache } from "../store/file-cache.js";
+/**
+ * Builds the final context package passed to the LLM or returned directly to the caller.
+ */
+export declare const buildContextPackage: (question: string, repoPath: string, snapshot: GraphSnapshot, documents: Record<string, IndexedNodeDocument>, retrieval: RetrievalConfig, fileCache: FileCache, primaryNode: BlueprintNode | undefined, dependencies: BlueprintNode[], dependents: BlueprintNode[], answerMode: ContextPackage["answerMode"]) => Promise<ContextPackage>;

package/dist/llm/context-builder.js

@@ -0,0 +1,93 @@
+import { createRetrievedNodeContext } from "../retrieval/page-index.js";
+const buildGraphSummary = (primaryNode, dependencies, dependents) => {
+    if (!primaryNode) {
+        return "No matching node was retrieved from the current repository index.";
+    }
+    const parts = [`Primary node: ${primaryNode.name}.`];
+    if (dependencies.length > 0) {
+        parts.push(`It depends on: ${dependencies.map((node) => node.name).join(", ")}.`);
+    }
+    if (dependents.length > 0) {
+        parts.push(`It is used by: ${dependents.map((node) => node.name).join(", ")}.`);
+    }
+    return parts.join(" ");
+};
+const truncateContext = (context, maxChars, warnings) => {
+    if (context.fullFileContent.length <= maxChars) {
+        return context;
+    }
+    warnings.push(`Truncated ${context.filePath} to stay within the context budget.`);
+    return {
+        ...context,
+        fullFileContent: context.fullFileContent.slice(0, Math.max(0, maxChars))
+    };
+};
+const fitPrimaryContext = (primaryContext, maxContextChars) => {
+    if (!primaryContext) {
+        return {
+            primaryContext: null,
+            remainingBudget: maxContextChars,
+            warnings: []
+        };
+    }
+    const warnings = [];
+    const fittedPrimaryContext = truncateContext(primaryContext, maxContextChars, warnings);
+    return {
+        primaryContext: fittedPrimaryContext,
+        remainingBudget: Math.max(0, maxContextChars - fittedPrimaryContext.fullFileContent.length),
+        warnings
+    };
+};
+const fitRelatedContexts = (relatedContexts, remainingBudget) => {
+    const warnings = [];
+    const fittedContexts = [];
+    let budget = remainingBudget;
+    for (const context of relatedContexts) {
+        if (budget <= 0) {
+            warnings.push(`Dropped file content for ${context.filePath} because the context budget was exhausted.`);
+            fittedContexts.push({
+                ...context,
+                fullFileContent: ""
+            });
+            continue;
+        }
+        const fittedContext = truncateContext(context, budget, warnings);
+        budget = Math.max(0, budget - fittedContext.fullFileContent.length);
+        fittedContexts.push(fittedContext);
+    }
+    return {
+        relatedContexts: fittedContexts,
+        warnings
+    };
+};
+const buildRelatedContextPromises = (repoPath, fileCache, snapshot, documents, primaryNode, dependencies, dependents) => [
+    ...dependencies
+        .map((node) => documents[node.id])
+        .filter((document) => Boolean(document))
+        .map((document) => createRetrievedNodeContext(repoPath, fileCache, snapshot, document, "calls", primaryNode?.id)),
+    ...dependents
+        .map((node) => documents[node.id])
+        .filter((document) => Boolean(document))
+        .map((document) => createRetrievedNodeContext(repoPath, fileCache, snapshot, document, "called-by", primaryNode?.id))
+];
+/**
+ * Builds the final context package passed to the LLM or returned directly to the caller.
+ */
+export const buildContextPackage = async (question, repoPath, snapshot, documents, retrieval, fileCache, primaryNode, dependencies, dependents, answerMode) => {
+    const primaryDocument = primaryNode ? documents[primaryNode.id] : undefined;
+    const primaryContext = primaryDocument
+        ? await createRetrievedNodeContext(repoPath, fileCache, snapshot, primaryDocument, "primary")
+        : null;
+    const resolvedRelatedContexts = await Promise.all(buildRelatedContextPromises(repoPath, fileCache, snapshot, documents, primaryNode, dependencies, dependents));
+    const primaryResult = fitPrimaryContext(primaryContext, retrieval.maxContextChars);
+    const relatedResult = fitRelatedContexts(resolvedRelatedContexts, primaryResult.remainingBudget);
+    return {
+        question,
+        answerMode,
+        primaryNode: primaryResult.primaryContext,
+        relatedNodes: relatedResult.relatedContexts,
+        graphSummary: buildGraphSummary(primaryNode, dependencies, dependents),
+        warnings: [...primaryResult.warnings, ...relatedResult.warnings]
+    };
+};
+//# sourceMappingURL=context-builder.js.map

package/dist/llm/context-builder.js.map

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

package/dist/llm/prompt.d.ts

@@ -0,0 +1,3 @@
+import type { ContextPackage, LlmRequest } from "../types.js";
+export declare const buildSystemPrompt: () => string;
+export declare const buildMessages: (question: string, context: ContextPackage) => LlmRequest["messages"];

package/dist/llm/prompt.js

@@ -0,0 +1,80 @@
+const PRIMARY_DOC_CHAR_LIMIT = 1_200;
+const PRIMARY_FILE_CHAR_LIMIT = 4_000;
+const RELATED_DOC_CHAR_LIMIT = 320;
+const RELATED_FILE_CHAR_LIMIT = 1_200;
+const WARNING_CHAR_LIMIT = 160;
+const MAX_WARNING_COUNT = 4;
+const truncateText = (value, maxChars) => {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 15)).trimEnd()}\n...[truncated]`;
+};
+const formatCallSiteLines = (lineNumbers) => lineNumbers.length > 0 ? lineNumbers.join(", ") : "none";
+const formatNodeHeader = (node) => [
+    `name=${node.name}`,
+    `relationship=${node.relationship}`,
+    `kind=${node.kind}`,
+    `file=${node.filePath}:${node.startLine}-${node.endLine}`,
+    `callSites=${formatCallSiteLines(node.callSiteLines)}`
+].join(" | ");
+const formatDocSection = (label, value, maxChars) => value.trim().length === 0 ? "" : `${label}:\n${truncateText(value, maxChars)}`;
+const formatFileSection = (value, maxChars) => value.trim().length === 0 ? "" : `File excerpt:\n${truncateText(value, maxChars)}`;
+const joinSections = (sections) => sections.filter(Boolean).join("\n\n");
+const formatPrimaryNode = (node) => joinSections([
+    `Primary node:\n${formatNodeHeader(node)}`,
+    formatDocSection("Primary doc", node.doc, PRIMARY_DOC_CHAR_LIMIT),
+    formatFileSection(node.fullFileContent, PRIMARY_FILE_CHAR_LIMIT)
+]);
+const shouldIncludeRelatedFile = (node, primaryNode, includedFiles) => !includedFiles.has(node.filePath) && node.filePath !== primaryNode?.filePath;
+const formatRelatedNode = (node, primaryNode, includedFiles) => {
+    const includeFile = shouldIncludeRelatedFile(node, primaryNode, includedFiles);
+    if (includeFile) {
+        includedFiles.add(node.filePath);
+    }
+    return joinSections([
+        formatNodeHeader(node),
+        formatDocSection("Related doc", node.doc, RELATED_DOC_CHAR_LIMIT),
+        includeFile ? formatFileSection(node.fullFileContent, RELATED_FILE_CHAR_LIMIT) : ""
+    ]);
+};
+const formatRelatedNodes = (relatedNodes, primaryNode) => {
+    if (relatedNodes.length === 0) {
+        return "Related nodes:\nnone";
+    }
+    const includedFiles = new Set(primaryNode ? [primaryNode.filePath] : []);
+    const entries = relatedNodes.map((node, index) => `${index + 1}. ${formatRelatedNode(node, primaryNode, includedFiles)}`);
+    return `Related nodes:\n${entries.join("\n\n")}`;
+};
+const formatWarnings = (warnings) => {
+    if (warnings.length === 0) {
+        return "";
+    }
+    const entries = warnings
+        .slice(0, MAX_WARNING_COUNT)
+        .map((warning, index) => `${index + 1}. ${truncateText(warning, WARNING_CHAR_LIMIT)}`);
+    return `Warnings:\n${entries.join("\n")}`;
+};
+const summarizeContext = (context) => joinSections([
+    `Graph summary:\n${context.graphSummary}`,
+    context.primaryNode ? formatPrimaryNode(context.primaryNode) : "Primary node:\nnone",
+    formatRelatedNodes(context.relatedNodes, context.primaryNode),
+    formatWarnings(context.warnings)
+]);
+export const buildSystemPrompt = () => [
+    "You are answering questions about a codebase.",
+    "Only use the provided repository context.",
+    "If the context is insufficient, say so plainly.",
+    "Do not invent functions, files, or behavior that is not present in the retrieved context."
+].join(" ");
+export const buildMessages = (question, context) => [
+    {
+        role: "system",
+        content: buildSystemPrompt()
+    },
+    {
+        role: "user",
+        content: `Question:\n${question}\n\n${summarizeContext(context)}`
+    }
+];
+//# sourceMappingURL=prompt.js.map

package/dist/llm/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/llm/prompt.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,KAAK,CAAC;AACrC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IAC/D,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,kBAAkB,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,WAAqB,EAAU,EAAE,CAC5D,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAE3D,MAAM,gBAAgB,GAAG,CAAC,IAA0B,EAAU,EAAE,CAC9D;IACE,QAAQ,IAAI,CAAC,IAAI,EAAE;IACnB,gBAAgB,IAAI,CAAC,YAAY,EAAE;IACnC,QAAQ,IAAI,CAAC,IAAI,EAAE;IACnB,QAAQ,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE;IACzD,aAAa,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;CACvD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEhB,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,QAAgB,EAAU,EAAE,CAClF,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;AAEjF,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE,CACpE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;AAErF,MAAM,YAAY,GAAG,CAAC,QAAkB,EAAU,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CAAC,IAA0B,EAAU,EAAE,CAC/D,YAAY,CAAC;IACX,kBAAkB,gBAAgB,CAAC,IAAI,CAAC,EAAE;IAC1C,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC;IACjE,iBAAiB,CAAC,IAAI,CAAC,eAAe,EAAE,uBAAuB,CAAC;CACjE,CAAC,CAAC;AAEL,MAAM,wBAAwB,GAAG,CAC/B,IAA0B,EAC1B,WAAwC,EACxC,aAA0B,EACjB,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,QAAQ,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CACxB,IAA0B,EAC1B,WAAwC,EACxC,aAA0B,EAClB,EAAE;IACV,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IAC/E,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,YAAY,CAAC;QAClB,gBAAgB,CAAC,IAAI,CAAC;QACtB,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC;QACjE,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE;KACpF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CACzB,YAAoC,EACpC,WAAwC,EAChC,EAAE;IACV,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/C,GAAG,KAAK,GAAG,CAAC,KAAK,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,CACvE,CAAC;IACF,OAAO,mBAAmB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAU,EAAE;IACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ;SACrB,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC;SAC3B,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACzF,OAAO,cAAc,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,OAAuB,EAAU,EAAE,CAC3D,YAAY,CAAC;IACX,mBAAmB,OAAO,CAAC,YAAY,EAAE;IACzC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACpF,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC;IAC7D,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC;CACjC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C;IACE,+CAA+C;IAC/C,2CAA2C;IAC3C,iDAAiD;IACjD,2FAA2F;CAC5F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEd,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,OAAuB,EAA0B,EAAE,CAAC;IAClG;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,iBAAiB,EAAE;KAC7B;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,cAAc,QAAQ,OAAO,gBAAgB,CAAC,OAAO,CAAC,EAAE;KAClE;CACF,CAAC"}

package/dist/llm/transports.d.ts

@@ -0,0 +1,23 @@
+import type { LlmConfig, LlmRequest, LlmResponse, LlmTransport } from "../types.js";
+declare abstract class HttpLlmTransport implements LlmTransport {
+    abstract readonly kind: LlmTransport["kind"];
+    protected readonly config: LlmConfig;
+    constructor(config: LlmConfig);
+    protected postJson(pathname: string, body: unknown): Promise<Response>;
+    abstract generate(request: LlmRequest, onToken?: (token: string) => void): Promise<LlmResponse>;
+}
+/**
+ * Talks to any model server that exposes the OpenAI chat completions contract.
+ */
+export declare class OpenAiCompatibleTransport extends HttpLlmTransport {
+    readonly kind: "openai-compatible";
+    generate(request: LlmRequest, onToken?: (token: string) => void): Promise<LlmResponse>;
+}
+/**
+ * Talks to a custom JSON, NDJSON, or SSE endpoint that accepts the CodeRag payload.
+ */
+export declare class CustomHttpTransport extends HttpLlmTransport {
+    readonly kind: "custom-http";
+    generate(request: LlmRequest, onToken?: (token: string) => void): Promise<LlmResponse>;
+}
+export {};

package/dist/llm/transports.js

@@ -0,0 +1,271 @@
+import { ConfigurationError, TransportError } from "../errors/index.js";
+const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
+const MAX_HTTP_RETRIES = 3;
+const RETRY_BASE_DELAY_MS = 150;
+const buildHeaders = (config) => {
+    const headers = {
+        "content-type": "application/json",
+        ...config.headers
+    };
+    if (config.apiKey) {
+        headers.authorization = `Bearer ${config.apiKey}`;
+    }
+    return headers;
+};
+const waitBeforeRetry = async (attempt) => {
+    const jitterMs = Math.floor(Math.random() * RETRY_BASE_DELAY_MS);
+    const delayMs = RETRY_BASE_DELAY_MS * 2 ** attempt + jitterMs;
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+};
+const shouldRetryStatus = (status) => RETRYABLE_STATUS_CODES.has(status);
+const mergeSystemMessagesIntoConversation = (messages) => {
+    const systemPrompt = messages
+        .filter((message) => message.role === "system")
+        .map((message) => message.content.trim())
+        .filter(Boolean)
+        .join("\n\n");
+    if (!systemPrompt) {
+        return messages;
+    }
+    const nonSystemMessages = messages.filter((message) => message.role !== "system");
+    const firstUserMessageIndex = nonSystemMessages.findIndex((message) => message.role === "user");
+    if (firstUserMessageIndex === -1) {
+        return [{ role: "user", content: systemPrompt }, ...nonSystemMessages];
+    }
+    const firstUserMessage = nonSystemMessages[firstUserMessageIndex];
+    const mergedUserMessage = {
+        ...firstUserMessage,
+        content: `${systemPrompt}\n\n${firstUserMessage.content}`.trim()
+    };
+    return [
+        ...nonSystemMessages.slice(0, firstUserMessageIndex),
+        mergedUserMessage,
+        ...nonSystemMessages.slice(firstUserMessageIndex + 1)
+    ];
+};
+const isUnsupportedSystemRoleError = (error) => {
+    if (!(error instanceof TransportError)) {
+        return false;
+    }
+    const status = error.details?.status;
+    const body = error.details?.body;
+    return status === 400 && typeof body === "string" && body.toLowerCase().includes("system role not supported");
+};
+const buildRequestUrl = (baseUrl, pathname) => {
+    const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+    if (pathname === "/" || pathname.length === 0) {
+        return new URL(normalizedBaseUrl);
+    }
+    const normalizedPath = pathname.replace(/^\/+/, "");
+    return new URL(normalizedPath, normalizedBaseUrl);
+};
+const readResponseText = async (response) => {
+    const text = await response.text();
+    if (!response.ok) {
+        throw new TransportError("LLM server returned an error response.", {
+            status: response.status,
+            body: text
+        });
+    }
+    return text;
+};
+const extractAnswerToken = (payload) => {
+    if (typeof payload.token === "string") {
+        return payload.token;
+    }
+    if (typeof payload.answer === "string") {
+        return payload.answer;
+    }
+    const content = payload.choices?.[0]?.delta?.content;
+    return typeof content === "string" ? content : "";
+};
+const parseSseEvent = (rawEvent) => rawEvent
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line.startsWith("data:"))
+    .map((line) => line.slice("data:".length).trim())
+    .filter((payload) => payload.length > 0 && payload !== "[DONE]");
+const readSseResponse = async (response, onToken) => {
+    if (!response.ok) {
+        await readResponseText(response);
+    }
+    if (!response.body) {
+        throw new TransportError("SSE response did not include a body.");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let answer = "";
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done) {
+            break;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        const events = buffer.split(/\r?\n\r?\n/);
+        buffer = events.pop();
+        for (const event of events) {
+            for (const payload of parseSseEvent(event)) {
+                const token = extractAnswerToken(JSON.parse(payload));
+                if (!token) {
+                    continue;
+                }
+                answer += token;
+                onToken?.(token);
+            }
+        }
+    }
+    if (buffer.trim().length > 0) {
+        for (const payload of parseSseEvent(buffer)) {
+            const token = extractAnswerToken(JSON.parse(payload));
+            if (!token) {
+                continue;
+            }
+            answer += token;
+            onToken?.(token);
+        }
+    }
+    return { answer };
+};
+const readNdjsonResponse = async (response, onToken) => {
+    if (!response.ok) {
+        await readResponseText(response);
+    }
+    if (!response.body) {
+        const text = await readResponseText(response);
+        return { answer: text };
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let answer = "";
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done) {
+            break;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split(/\r?\n/);
+        buffer = lines.pop();
+        for (const line of lines.map((candidate) => candidate.trim()).filter(Boolean)) {
+            const token = extractAnswerToken(JSON.parse(line));
+            if (!token) {
+                continue;
+            }
+            answer += token;
+            onToken?.(token);
+        }
+    }
+    if (buffer.trim().length > 0) {
+        const token = extractAnswerToken(JSON.parse(buffer.trim()));
+        if (token) {
+            answer += token;
+            onToken?.(token);
+        }
+    }
+    return { answer };
+};
+const readJsonAnswer = async (response) => {
+    const text = await readResponseText(response);
+    const parsed = JSON.parse(text);
+    if (typeof parsed.answer === "string") {
+        return { answer: parsed.answer };
+    }
+    const content = parsed.choices?.[0]?.message?.content;
+    if (typeof content === "string") {
+        return { answer: content };
+    }
+    throw new TransportError("LLM response did not contain a supported answer field.");
+};
+class HttpLlmTransport {
+    config;
+    constructor(config) {
+        if (!config.baseUrl) {
+            throw new ConfigurationError("LLM transport requires a baseUrl.");
+        }
+        this.config = config;
+    }
+    async postJson(pathname, body) {
+        let lastResponse;
+        let lastError = new Error("HTTP retry loop exhausted without a response.");
+        for (let attempt = 0; attempt < MAX_HTTP_RETRIES; attempt += 1) {
+            try {
+                const signal = AbortSignal.timeout(this.config.timeoutMs);
+                const response = await fetch(buildRequestUrl(this.config.baseUrl, pathname), {
+                    method: "POST",
+                    headers: buildHeaders(this.config),
+                    body: JSON.stringify(body),
+                    signal
+                });
+                if (!shouldRetryStatus(response.status)) {
+                    return response;
+                }
+                lastResponse = response;
+            }
+            catch (error) {
+                lastError = error;
+            }
+            if (attempt < MAX_HTTP_RETRIES - 1) {
+                await waitBeforeRetry(attempt);
+            }
+        }
+        if (lastResponse) {
+            return lastResponse;
+        }
+        throw new TransportError("Failed to reach the configured LLM server.", {
+            baseUrl: this.config.baseUrl
+        }, { cause: lastError });
+    }
+}
+/**
+ * Talks to any model server that exposes the OpenAI chat completions contract.
+ */
+export class OpenAiCompatibleTransport extends HttpLlmTransport {
+    kind = "openai-compatible";
+    async generate(request, onToken) {
+        if (!this.config.model) {
+            throw new ConfigurationError("OpenAI-compatible transport requires a model.");
+        }
+        const execute = async (messages) => {
+            const response = await this.postJson("/chat/completions", {
+                model: this.config.model,
+                stream: request.stream,
+                messages
+            });
+            return request.stream ? readSseResponse(response, onToken) : readJsonAnswer(response);
+        };
+        try {
+            return await execute(request.messages);
+        }
+        catch (error) {
+            if (!isUnsupportedSystemRoleError(error)) {
+                throw error;
+            }
+            return execute(mergeSystemMessagesIntoConversation(request.messages));
+        }
+    }
+}
+/**
+ * Talks to a custom JSON, NDJSON, or SSE endpoint that accepts the CodeRag payload.
+ */
+export class CustomHttpTransport extends HttpLlmTransport {
+    kind = "custom-http";
+    async generate(request, onToken) {
+        const response = await this.postJson("/", {
+            question: request.question,
+            model: request.model ?? this.config.model,
+            stream: request.stream,
+            context: request.context,
+            messages: request.messages
+        });
+        const format = this.config.customHttpFormat;
+        if (format === "sse") {
+            return readSseResponse(response, onToken);
+        }
+        if (format === "ndjson") {
+            return readNdjsonResponse(response, onToken);
+        }
+        return readJsonAnswer(response);
+    }
+}
+//# sourceMappingURL=transports.js.map

package/dist/llm/transports.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CodeRag } from "../service/coderag.js";
+/**
+ * Creates the stdio MCP server that exposes CodeRag retrieval tools.
+ */
+export declare const createMcpServer: (coderag: CodeRag) => McpServer;
+/**
+ * Connects the CodeRag MCP server to stdio for local tool execution.
+ */
+export declare const serveStdioMcpServer: (coderag: CodeRag) => Promise<void>;