opencode-rag-plugin 1.1.0 → 1.2.0

package/dist/opencode/create-read-tool.js

@@ -0,0 +1,248 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { retrieve } from "../retriever/retriever.js";
+import { normalizeReadArgs, resolveWorkspacePath } from "./tool-args.js";
+import { buildReadQuery } from "./read-query.js";
+import { formatReadOutput, formatRelatedFiles } from "./read-format.js";
+import { missingIndexMessage, getNoResultsMessage, retrievalErrorMessage, } from "./read-fallback.js";
+/**
+ * Create the RAG-backed read tool for OpenCode plugin registration.
+ *
+ * The tool accepts read-like arguments (filePath/path/absolutePath,
+ * offset/limit, startLine/endLine, query/reason) and returns
+ * relevant indexed chunks instead of full file contents.
+ */
+export function createRagReadTool(options) {
+    const { worktree, config, embedder, store, sessionLastMessage, sessionRetrievalCache } = options;
+    const openCodeCfg = config.openCode;
+    const maxContextChunks = openCodeCfg.maxContextChunks;
+    const maxReadOutputChars = openCodeCfg.maxReadOutputChars ?? 20000;
+    const noResultsBehavior = openCodeCfg.readNoResultsBehavior ?? "hint";
+    const retrievalTopK = maxContextChunks * 4;
+    const readRelatedFilesMax = openCodeCfg.readRelatedFilesMax ?? 5;
+    return tool({
+        description: "Read file contents from the workspace. Returns relevant indexed code chunks " +
+            "instead of full file contents for token-efficient code understanding. " +
+            "Provide a file path and optionally a query/reason, line range, or both.",
+        args: {
+            filePath: tool.schema.string().optional(),
+            path: tool.schema.string().optional(),
+            absolutePath: tool.schema.string().optional(),
+            offset: tool.schema.number().int().optional(),
+            limit: tool.schema.number().int().optional(),
+            startLine: tool.schema.number().int().optional(),
+            endLine: tool.schema.number().int().optional(),
+            query: tool.schema.string().optional(),
+            reason: tool.schema.string().optional(),
+        },
+        async execute(args, ctx) {
+            try {
+                // 1. Normalize and validate arguments
+                const normalized = normalizeReadArgs(args);
+                // 2. Resolve workspace path
+                const resolvedPath = resolveWorkspacePath(worktree, normalized.filePath);
+                // 3. Build retrieval query (chat-context-aware if available)
+                const sessionID = ctx?.sessionID;
+                const messageText = sessionID ? sessionLastMessage?.get(sessionID) ?? "" : "";
+                // 4. Check if index exists
+                const count = await store.count();
+                if (count === 0) {
+                    return {
+                        title: "Read (OpenCodeRAG)",
+                        output: missingIndexMessage(),
+                        metadata: {
+                            tool: "read",
+                            filePath: resolvedPath,
+                            indexed: false,
+                        },
+                    };
+                }
+                // 5. Get or create cached raw results for this session
+                let rawResults;
+                let retrievalQuery;
+                if (sessionID && sessionRetrievalCache) {
+                    const cached = sessionRetrievalCache.get(sessionID);
+                    if (cached && cached.messageText === messageText) {
+                        // Cache hit — reuse raw results
+                        rawResults = cached.rawResults;
+                        retrievalQuery = messageText.length > 0
+                            ? messageText
+                            : (buildReadQuery({ filePath: resolvedPath }).split("\n")[0] ?? "");
+                    }
+                    else {
+                        // Cache miss or new message — run retrieval
+                        retrievalQuery = buildSessionQuery(messageText, resolvedPath, normalized);
+                        rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK });
+                        sessionRetrievalCache.set(sessionID, { messageText, rawResults: rawResults });
+                    }
+                }
+                else {
+                    // No session/context — direct retrieval
+                    retrievalQuery = buildReadQuery({
+                        query: normalized.query,
+                        filePath: resolvedPath,
+                        startLine: normalized.startLine,
+                        endLine: normalized.endLine,
+                    });
+                    rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK });
+                }
+                // 6. Collect related files from raw results (before filtering)
+                const relatedFiles = collectRelatedFiles(rawResults, resolvedPath, readRelatedFilesMax);
+                if (rawResults.length === 0) {
+                    const output = getNoResultsMessage(noResultsBehavior, resolvedPath);
+                    return {
+                        title: "Read (OpenCodeRAG)",
+                        output,
+                        metadata: {
+                            tool: "read",
+                            filePath: resolvedPath,
+                            chunks: 0,
+                            indexed: true,
+                        },
+                    };
+                }
+                // 7. Filter results to the requested file
+                let filtered = rawResults.filter((r) => r.chunk.metadata.filePath === resolvedPath);
+                // 8. If file has no results, use no-results behavior
+                if (filtered.length === 0) {
+                    let output = getNoResultsMessage(noResultsBehavior, resolvedPath);
+                    if (readRelatedFilesMax > 0 && relatedFiles.length > 0) {
+                        output += "\n\n" + formatRelatedFiles(relatedFiles);
+                    }
+                    return {
+                        title: "Read (OpenCodeRAG)",
+                        output,
+                        metadata: {
+                            tool: "read",
+                            filePath: resolvedPath,
+                            chunks: 0,
+                            indexed: true,
+                        },
+                    };
+                }
+                // 9. Apply line-range overlap filtering
+                const lineFiltered = applyLineRangeFilter(filtered, normalized.startLine, normalized.endLine);
+                // Re-sort by score descending
+                lineFiltered.sort((a, b) => b.score - a.score);
+                // 10. Format output
+                let output = formatReadOutput({
+                    filePath: resolvedPath,
+                    retrievalQuery,
+                    results: lineFiltered,
+                    maxChunks: maxContextChunks,
+                    maxChars: maxReadOutputChars,
+                });
+                // 11. Append related files if enabled
+                if (readRelatedFilesMax > 0 && relatedFiles.length > 0) {
+                    output += "\n\n" + formatRelatedFiles(relatedFiles);
+                }
+                // 12. Return
+                return {
+                    title: `Read (OpenCodeRAG) — ${resolvedPath}`,
+                    output,
+                    metadata: {
+                        tool: "read",
+                        filePath: resolvedPath,
+                        chunks: Math.min(lineFiltered.length, maxContextChunks),
+                        totalResults: lineFiltered.length,
+                        indexed: true,
+                    },
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    title: "Read (OpenCodeRAG)",
+                    output: retrievalErrorMessage(message),
+                    metadata: {
+                        tool: "read",
+                        filePath: undefined,
+                        error: message,
+                    },
+                };
+            }
+        },
+    });
+}
+/**
+ * Filter search results by line-range overlap.
+ *
+ * A chunk overlaps the requested range when:
+ *   chunk.startLine <= requestedEndLine && chunk.endLine >= requestedStartLine
+ *
+ * If only startLine is provided: chunk.endLine >= requestedStartLine
+ * If only endLine is provided: chunk.startLine <= requestedEndLine
+ */
+function applyLineRangeFilter(results, startLine, endLine) {
+    if (startLine === undefined && endLine === undefined) {
+        return results;
+    }
+    return results.filter((r) => {
+        const cs = r.chunk.metadata.startLine;
+        const ce = r.chunk.metadata.endLine;
+        if (startLine !== undefined && endLine !== undefined) {
+            return cs <= endLine && ce >= startLine;
+        }
+        if (startLine !== undefined) {
+            return ce >= startLine;
+        }
+        if (endLine !== undefined) {
+            return cs <= endLine;
+        }
+        return true;
+    });
+}
+/**
+ * Build a retrieval query from the session's user message plus file path hints.
+ *
+ * When message text is available, it becomes the primary semantic query with
+ * the file path as a targeted hint. When no message text exists, falls back
+ * to the standard file-path-based query.
+ */
+function buildSessionQuery(messageText, resolvedPath, normalized) {
+    // Use message text as the semantic query if available
+    if (messageText.length > 0) {
+        // Include file path info so the embedding narrows to that file
+        const parts = [
+            messageText,
+            `Looking for relevant code in file: ${resolvedPath}`,
+        ];
+        if (normalized.startLine !== undefined && normalized.endLine !== undefined) {
+            parts.push(`Focus on lines ${normalized.startLine}-${normalized.endLine}.`);
+        }
+        else if (normalized.startLine !== undefined) {
+            parts.push(`Focus on lines near ${normalized.startLine}.`);
+        }
+        return parts.join("\n");
+    }
+    // Fall back to standard query
+    return buildReadQuery({
+        query: normalized.query,
+        filePath: resolvedPath,
+        startLine: normalized.startLine,
+        endLine: normalized.endLine,
+    });
+}
+/**
+ * Collect unique related files from raw search results, excluding the
+ * requested file. Keeps the best score per file path and returns at most
+ * `maxRelated` entries sorted by score descending.
+ */
+function collectRelatedFiles(rawResults, requestedFile, maxRelated) {
+    if (maxRelated <= 0 || rawResults.length === 0)
+        return [];
+    const bestScore = new Map();
+    for (const r of rawResults) {
+        const fp = r.chunk.metadata.filePath;
+        if (fp === requestedFile)
+            continue;
+        const current = bestScore.get(fp);
+        if (current === undefined || r.score > current) {
+            bestScore.set(fp, r.score);
+        }
+    }
+    return Array.from(bestScore.entries())
+        .map(([filePath, score]) => ({ filePath, score }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxRelated);
+}
+//# sourceMappingURL=create-read-tool.js.map

package/dist/opencode/create-read-tool.js.map

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

package/dist/opencode/read-fallback.d.ts

@@ -0,0 +1,21 @@
+import type { ReadNoResultsBehavior } from "../core/config.js";
+/**
+ * Fallback message when no OpenCodeRAG index exists or the index is empty.
+ */
+export declare function missingIndexMessage(): string;
+/**
+ * Fallback message when the requested file has no indexed chunks.
+ */
+export declare function fileNotIndexedMessage(filePath: string): string;
+/**
+ * Fallback message when no relevant chunks matched the read request.
+ */
+export declare function noRelevantChunksMessage(): string;
+/**
+ * Error message wrapper for retrieval failures.
+ */
+export declare function retrievalErrorMessage(shortError: string): string;
+/**
+ * Dispatch to the correct fallback message based on behavior config.
+ */
+export declare function getNoResultsMessage(behavior: ReadNoResultsBehavior, filePath?: string): string;

package/dist/opencode/read-fallback.js

@@ -0,0 +1,90 @@
+/**
+ * Fallback message when no OpenCodeRAG index exists or the index is empty.
+ */
+export function missingIndexMessage() {
+    return [
+        "OpenCodeRAG read override active.",
+        "Full file read suppressed.",
+        "",
+        "No OpenCodeRAG index was found or the index is empty.",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        "npx tsx src/cli.ts index",
+        "```",
+        "",
+        "Then retry the read request.",
+    ].join("\n");
+}
+/**
+ * Fallback message when the requested file has no indexed chunks.
+ */
+export function fileNotIndexedMessage(filePath) {
+    return [
+        "OpenCodeRAG read override active.",
+        "Full file read suppressed.",
+        "",
+        "No indexed chunks were found for:",
+        `- ${filePath}`,
+        "",
+        "Possible reasons:",
+        "- The file extension is not included.",
+        "- The directory is excluded.",
+        "- The index is stale.",
+        "- The file was created after the last indexing run.",
+        "",
+        "Run:",
+        "",
+        "```bash",
+        "npx tsx src/cli.ts index",
+        "```",
+    ].join("\n");
+}
+/**
+ * Fallback message when no relevant chunks matched the read request.
+ */
+export function noRelevantChunksMessage() {
+    return [
+        "OpenCodeRAG read override active.",
+        "Full file read suppressed.",
+        "",
+        "No relevant chunks were found for this read request.",
+        "",
+        "Try:",
+        "- Ask a more specific question.",
+        "- Run the index again.",
+        "- Request a smaller line range if range fallback is enabled.",
+    ].join("\n");
+}
+/**
+ * Error message wrapper for retrieval failures.
+ */
+export function retrievalErrorMessage(shortError) {
+    return [
+        "OpenCodeRAG retrieval failed.",
+        "Full file read suppressed.",
+        "",
+        "Error:",
+        shortError,
+    ].join("\n");
+}
+/**
+ * Dispatch to the correct fallback message based on behavior config.
+ */
+export function getNoResultsMessage(behavior, filePath) {
+    switch (behavior) {
+        case "error":
+            throw new Error("OpenCodeRAG read: no indexed chunks found." +
+                (filePath ? ` File: ${filePath}` : ""));
+        case "empty":
+            return "OpenCodeRAG read override active. Full file read suppressed. No indexed chunks found.";
+        case "hint":
+        default:
+            if (filePath) {
+                return fileNotIndexedMessage(filePath);
+            }
+            return noRelevantChunksMessage();
+    }
+}
+//# sourceMappingURL=read-fallback.js.map

package/dist/opencode/read-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-fallback.js","sourceRoot":"","sources":["../../src/opencode/read-fallback.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,mCAAmC;QACnC,4BAA4B;QAC5B,EAAE;QACF,uDAAuD;QACvD,EAAE;QACF,MAAM;QACN,EAAE;QACF,SAAS;QACT,0BAA0B;QAC1B,KAAK;QACL,EAAE;QACF,8BAA8B;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO;QACL,mCAAmC;QACnC,4BAA4B;QAC5B,EAAE;QACF,mCAAmC;QACnC,KAAK,QAAQ,EAAE;QACf,EAAE;QACF,mBAAmB;QACnB,uCAAuC;QACvC,8BAA8B;QAC9B,uBAAuB;QACvB,qDAAqD;QACrD,EAAE;QACF,MAAM;QACN,EAAE;QACF,SAAS;QACT,0BAA0B;QAC1B,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,mCAAmC;QACnC,4BAA4B;QAC5B,EAAE;QACF,sDAAsD;QACtD,EAAE;QACF,MAAM;QACN,iCAAiC;QACjC,wBAAwB;QACxB,8DAA8D;KAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO;QACL,+BAA+B;QAC/B,4BAA4B;QAC5B,EAAE;QACF,QAAQ;QACR,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA+B,EAC/B,QAAiB;IAEjB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,MAAM,IAAI,KAAK,CACb,4CAA4C;gBAC1C,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACzC,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,uFAAuF,CAAC;QACjG,KAAK,MAAM,CAAC;QACZ;YACE,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,uBAAuB,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/opencode/read-format.d.ts

@@ -0,0 +1,40 @@
+import type { SearchResult } from "../core/interfaces.js";
+/**
+ * Options for formatting read tool output.
+ */
+export interface FormatReadOutputOptions {
+    /** The requested file path (display-friendly). */
+    filePath: string;
+    /** The retrieval query used. */
+    retrievalQuery: string;
+    /** Search results to format. */
+    results: SearchResult[];
+    /** Maximum results to include. */
+    maxChunks: number;
+    /** Maximum output character count. */
+    maxChars: number;
+}
+/**
+ * Format RAG retrieval results for the read tool output.
+ *
+ * The output:
+ *   - Clearly states full-file reading was suppressed.
+ *   - Includes request metadata (file path, query, chunk count).
+ *   - Formats each chunk with file path, line range, score, and code block.
+ *   - Enforces maxChars limit and appends truncation notice.
+ *
+ * Returns a string ready to return as the tool output.
+ */
+export declare function formatReadOutput(options: FormatReadOutputOptions): string;
+/** A related file entry with path and score. */
+export interface RelatedFileEntry {
+    filePath: string;
+    score: number;
+}
+/**
+ * Format a list of related files as a lightweight suggestion section.
+ *
+ * Only includes file paths and scores — no code content — to keep tokens low.
+ * Format: "Please consider reading other relevant files:\n1. ./path (Score: 0.92)\n..."
+ */
+export declare function formatRelatedFiles(entries: RelatedFileEntry[]): string;

package/dist/opencode/read-format.js

@@ -0,0 +1,86 @@
+/**
+ * Format RAG retrieval results for the read tool output.
+ *
+ * The output:
+ *   - Clearly states full-file reading was suppressed.
+ *   - Includes request metadata (file path, query, chunk count).
+ *   - Formats each chunk with file path, line range, score, and code block.
+ *   - Enforces maxChars limit and appends truncation notice.
+ *
+ * Returns a string ready to return as the tool output.
+ */
+export function formatReadOutput(options) {
+    const { filePath, retrievalQuery, results, maxChunks, maxChars } = options;
+    const header = buildHeader(filePath, retrievalQuery, results.length, maxChunks);
+    let output = header;
+    const limited = results.slice(0, maxChunks);
+    for (let i = 0; i < limited.length; i++) {
+        const r = limited[i];
+        if (!r)
+            continue;
+        const chunkPart = formatChunk(i + 1, r);
+        // Check if adding this chunk would exceed the limit
+        if ((output + "\n" + chunkPart).length > maxChars) {
+            // If we already have some content, append truncation notice
+            const truncationNotice = "\n\n---\nOutput truncated by OpenCodeRAG to stay within maxReadOutputChars.\nUse a more specific query or line range to retrieve narrower context.";
+            if ((output + truncationNotice).length <= maxChars) {
+                output += truncationNotice;
+            }
+            break;
+        }
+        if (i > 0) {
+            output += "\n";
+        }
+        output += chunkPart;
+    }
+    return output;
+}
+function buildHeader(filePath, retrievalQuery, totalResults, maxChunks) {
+    const parts = [
+        "OpenCodeRAG read override active.",
+        "Full file read suppressed. Returning relevant indexed chunks instead.",
+        "",
+        "Requested file:",
+        `- ${filePath}`,
+        "",
+        "Retrieval query:",
+        `- ${retrievalQuery.split("\n")[0]}` +
+            (retrievalQuery.includes("\n") ? "..." : ""),
+        "",
+        `Returned chunks:`,
+        `- ${Math.min(totalResults, maxChunks)} of max ${maxChunks}`,
+        "",
+    ];
+    return parts.join("\n");
+}
+function formatChunk(index, result) {
+    const { chunk, score } = result;
+    const metadata = chunk.metadata;
+    const language = metadata.language || "";
+    const lines = [];
+    lines.push(`## Chunk ${index}`);
+    lines.push(`File: ${metadata.filePath}`);
+    lines.push(`Lines: ${metadata.startLine}-${metadata.endLine}`);
+    lines.push(`Score: ${score.toFixed(4)}`);
+    lines.push("");
+    lines.push("```" + language);
+    lines.push(chunk.content);
+    if (!chunk.content.endsWith("\n")) {
+        // Ensure code block closes on its own line
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+/**
+ * Format a list of related files as a lightweight suggestion section.
+ *
+ * Only includes file paths and scores — no code content — to keep tokens low.
+ * Format: "Please consider reading other relevant files:\n1. ./path (Score: 0.92)\n..."
+ */
+export function formatRelatedFiles(entries) {
+    if (entries.length === 0)
+        return "";
+    const lines = entries.map((entry, i) => `${i + 1}. ${entry.filePath} (Score: ${entry.score.toFixed(2)})`);
+    return `Please consider reading other relevant files:\n${lines.join("\n")}`;
+}
+//# sourceMappingURL=read-format.js.map

package/dist/opencode/read-format.js.map

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

package/dist/opencode/read-query.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Build a retrieval query string for the read tool.
+ *
+ * Combines user intent (optional query/reason) with file path
+ * and optional line range to create a focused retrieval query.
+ */
+export interface QueryBuilderOptions {
+    /** The user's explicit query or reason for reading. */
+    query?: string;
+    /** The normalized absolute file path being read. */
+    filePath: string;
+    /** Optional start line. */
+    startLine?: number;
+    /** Optional end line. */
+    endLine?: number;
+}
+/**
+ * Build a deterministic retrieval query from read arguments.
+ *
+ * Rules:
+ *   - If query is provided: use it as prefix, then append file path instructions.
+ *   - If no query: use a generic "Relevant implementation details" template.
+ *   - If line range exists: append focus instruction.
+ *   - If only startLine: append "at or after" instruction.
+ */
+export declare function buildReadQuery(options: QueryBuilderOptions): string;

package/dist/opencode/read-query.js

@@ -0,0 +1,39 @@
+/**
+ * Build a retrieval query string for the read tool.
+ *
+ * Combines user intent (optional query/reason) with file path
+ * and optional line range to create a focused retrieval query.
+ */
+/**
+ * Build a deterministic retrieval query from read arguments.
+ *
+ * Rules:
+ *   - If query is provided: use it as prefix, then append file path instructions.
+ *   - If no query: use a generic "Relevant implementation details" template.
+ *   - If line range exists: append focus instruction.
+ *   - If only startLine: append "at or after" instruction.
+ */
+export function buildReadQuery(options) {
+    const { query, filePath, startLine, endLine } = options;
+    const parts = [];
+    if (query && query.trim().length > 0) {
+        parts.push(query.trim());
+        parts.push("");
+        parts.push(`File: ${filePath}`);
+        parts.push("Return relevant indexed code chunks from this file with line numbers.");
+    }
+    else {
+        parts.push(`Relevant implementation details in file ${filePath}.`, "Return indexed code chunks with line numbers.");
+    }
+    if (startLine !== undefined && endLine !== undefined) {
+        parts.push(`Focus on chunks overlapping lines ${startLine}-${endLine}.`);
+    }
+    else if (startLine !== undefined) {
+        parts.push(`Focus on chunks at or after line ${startLine}.`);
+    }
+    else if (endLine !== undefined) {
+        parts.push(`Focus on chunks at or before line ${endLine}.`);
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=read-query.js.map

package/dist/opencode/read-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-query.js","sourceRoot":"","sources":["../../src/opencode/read-query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAA4B;IACzD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CACR,uEAAuE,CACxE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,2CAA2C,QAAQ,GAAG,EACtD,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CACR,qCAAqC,SAAS,IAAI,OAAO,GAAG,CAC7D,CAAC;IACJ,CAAC;SAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,oCAAoC,SAAS,GAAG,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,qCAAqC,OAAO,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/opencode/tool-args.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Raw argument variants accepted by the read tool.
+ */
+export interface RawReadArgs {
+    filePath?: string;
+    path?: string;
+    absolutePath?: string;
+    offset?: number;
+    limit?: number;
+    startLine?: number;
+    endLine?: number;
+    query?: string;
+    reason?: string;
+}
+/**
+ * Normalized internal shape for read request handling.
+ */
+export interface NormalizedReadArgs {
+    filePath: string;
+    startLine?: number;
+    endLine?: number;
+    query?: string;
+}
+/**
+ * Normalize raw read tool arguments into a consistent internal shape.
+ *
+ * Accepts:
+ *   - filePath / path / absolutePath
+ *   - offset + limit (converted to startLine + endLine)
+ *   - startLine / endLine (passthrough)
+ *   - query / reason (passthrough)
+ *
+ * Validates:
+ *   - A file path is required.
+ *   - startLine/offset must be >= 1 when provided.
+ *   - endLine must be >= 1 when provided.
+ *   - endLine must be >= startLine when both are provided.
+ */
+export declare function normalizeReadArgs(args: RawReadArgs): NormalizedReadArgs;
+/**
+ * Resolve a file path relative to the workspace root.
+ *
+ * Rules:
+ *   - Absolute paths are normalized.
+ *   - Relative paths are resolved relative to worktree.
+ *   - The resolved path must be inside the workspace.
+ *   - Returns absolute path with forward slashes.
+ *
+ * Throws if the path resolves outside the workspace.
+ */
+export declare function resolveWorkspacePath(worktree: string, inputPath: string): string;