@caplab/read 0.1.0

package/dist/cjs/fs/directory.js

@@ -0,0 +1,163 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDirectory = listDirectory;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const normalizer_js_1 = require("../path/normalizer.js");
+function minimatch(str, pattern) {
+    // Simple glob pattern matcher supporting * and ?
+    const regexPattern = pattern
+        .replace(/\./g, '\\.')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(str);
+}
+async function listDirectory(dirPath, workspaceRoot, options = {}) {
+    try {
+        const stats = await fs.stat(dirPath);
+        if (!stats.isDirectory()) {
+            return {
+                success: false,
+                error: 'path_not_found',
+                path: dirPath,
+            };
+        }
+        const entries = [];
+        const maxDepth = options.maxDepth ?? Infinity;
+        const includeHidden = options.includeHidden ?? false;
+        const includePatterns = options.include ?? [];
+        const excludePatterns = options.exclude ?? [];
+        const maxEntries = options.maxEntries ?? 1000;
+        async function collectEntries(currentPath, currentDepth) {
+            if (currentDepth > maxDepth) {
+                return;
+            }
+            try {
+                const dirents = await fs.readdir(currentPath, { withFileTypes: true });
+                for (const dirent of dirents) {
+                    const fullPath = path.join(currentPath, dirent.name);
+                    const relativePath = path.relative(workspaceRoot, fullPath);
+                    const normalizedRelativePath = (0, normalizer_js_1.normalizePath)(relativePath);
+                    // Skip hidden files unless includeHidden is true
+                    if (!includeHidden && dirent.name.startsWith('.')) {
+                        continue;
+                    }
+                    // Apply exclude patterns (apply to both files and directories)
+                    if (excludePatterns.length > 0) {
+                        const matchesExclude = excludePatterns.some(pattern => minimatch(normalizedRelativePath, pattern));
+                        if (matchesExclude) {
+                            continue;
+                        }
+                    }
+                    // For files, apply include patterns
+                    if (dirent.isFile()) {
+                        if (includePatterns.length > 0) {
+                            const matchesInclude = includePatterns.some(pattern => minimatch(normalizedRelativePath, pattern));
+                            if (!matchesInclude) {
+                                continue;
+                            }
+                        }
+                        const entry = {
+                            path: (0, normalizer_js_1.normalizePath)(fullPath),
+                            relativePath: normalizedRelativePath,
+                            type: 'file',
+                        };
+                        // Get size for files
+                        try {
+                            const fileStats = await fs.stat(fullPath);
+                            entry.size = fileStats.size;
+                        }
+                        catch {
+                            // Ignore stat errors
+                        }
+                        entries.push(entry);
+                    }
+                    // Always recurse into directories to find nested files
+                    if (dirent.isDirectory()) {
+                        // Add directory entry if it matches include patterns or if no include patterns
+                        if (includePatterns.length === 0 || includePatterns.some(pattern => minimatch(normalizedRelativePath, pattern))) {
+                            const entry = {
+                                path: (0, normalizer_js_1.normalizePath)(fullPath),
+                                relativePath: normalizedRelativePath,
+                                type: 'directory',
+                            };
+                            entries.push(entry);
+                        }
+                        await collectEntries(fullPath, currentDepth + 1);
+                    }
+                }
+            }
+            catch (error) {
+                if (error.code === 'EACCES' || error.code === 'EPERM') {
+                    // Skip directories we can't access
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        await collectEntries(dirPath, 0);
+        // Sort by normalized path (deterministic)
+        entries.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+        // Cap to maxEntries
+        const truncated = entries.length > maxEntries;
+        const finalEntries = entries.slice(0, maxEntries);
+        return {
+            success: true,
+            entries: finalEntries,
+            truncated,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                success: false,
+                error: 'path_not_found',
+                path: dirPath,
+            };
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return {
+                success: false,
+                error: 'permission_denied',
+                path: dirPath,
+            };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/cjs/fs/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../../src/fs/directory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,sCAiIC;AAhJD,qDAAuC;AACvC,gDAAkC;AAElC,yDAAsD;AAEtD,SAAS,SAAS,CAAC,GAAW,EAAE,OAAe;IAC7C,iDAAiD;IACjD,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,aAAqB,EACrB,UAAgC,EAAE;IAElC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;QACrD,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAE9C,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,YAAoB;YACrE,IAAI,YAAY,GAAG,QAAQ,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAEvE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;oBAC5D,MAAM,sBAAsB,GAAG,IAAA,6BAAa,EAAC,YAAY,CAAC,CAAC;oBAE3D,iDAAiD;oBACjD,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBAClD,SAAS;oBACX,CAAC;oBAED,+DAA+D;oBAC/D,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC/B,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC;wBACnG,IAAI,cAAc,EAAE,CAAC;4BACnB,SAAS;wBACX,CAAC;oBACH,CAAC;oBAED,oCAAoC;oBACpC,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;wBACpB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC/B,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC;4BACnG,IAAI,CAAC,cAAc,EAAE,CAAC;gCACpB,SAAS;4BACX,CAAC;wBACH,CAAC;wBAED,MAAM,KAAK,GAAmB;4BAC5B,IAAI,EAAE,IAAA,6BAAa,EAAC,QAAQ,CAAC;4BAC7B,YAAY,EAAE,sBAAsB;4BACpC,IAAI,EAAE,MAAM;yBACb,CAAC;wBAEF,qBAAqB;wBACrB,IAAI,CAAC;4BACH,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;4BAC1C,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;wBAC9B,CAAC;wBAAC,MAAM,CAAC;4BACP,qBAAqB;wBACvB,CAAC;wBAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACtB,CAAC;oBAED,uDAAuD;oBACvD,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;wBACzB,+EAA+E;wBAC/E,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;4BAChH,MAAM,KAAK,GAAmB;gCAC5B,IAAI,EAAE,IAAA,6BAAa,EAAC,QAAQ,CAAC;gCAC7B,YAAY,EAAE,sBAAsB;gCACpC,IAAI,EAAE,WAAW;6BAClB,CAAC;4BACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACtB,CAAC;wBAED,MAAM,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACtD,mCAAmC;gBACrC,CAAC;qBAAM,CAAC;oBACN,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEjC,0CAA0C;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAErE,oBAAoB;QACpB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC;QAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,YAAY;YACrB,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cjs/fs/reader.d.ts

@@ -0,0 +1,3 @@
+import type { FileReadResult } from '../types/public.js';
+export declare function readFileWithBudget(filePath: string, maxBytes: number, maxLines: number, encoding?: 'utf-8' | 'utf-16le' | 'utf-16be' | 'auto', workspaceRoot?: string): Promise<FileReadResult>;
+//# sourceMappingURL=reader.d.ts.map

package/dist/cjs/fs/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/fs/reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,EACrD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,CA8GzB"}

package/dist/cjs/fs/reader.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFileWithBudget = readFileWithBudget;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const binary_js_1 = require("./binary.js");
+async function readFileWithBudget(filePath, maxBytes, maxLines, encoding, workspaceRoot) {
+    const getRelativePath = () => {
+        if (workspaceRoot) {
+            const relative = path.relative(workspaceRoot, filePath);
+            // Normalize to forward slashes for consistency
+            return relative.split(path.sep).join('/');
+        }
+        return path.basename(filePath);
+    };
+    try {
+        const stats = await fs.stat(filePath);
+        if (!stats.isFile()) {
+            return {
+                success: false,
+                error: 'file_not_found',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Detect encoding if auto
+        let finalEncoding;
+        if (encoding === 'auto' || !encoding) {
+            const detection = await (0, binary_js_1.detectEncoding)(filePath);
+            if (detection.encoding === 'unknown') {
+                return {
+                    success: false,
+                    error: 'unsupported_encoding',
+                    path: filePath,
+                    relativePath: getRelativePath(),
+                };
+            }
+            finalEncoding = detection.encoding;
+        }
+        else {
+            finalEncoding = encoding;
+        }
+        // Check if binary
+        const isBinary = await (0, binary_js_1.isBinaryFile)(filePath, finalEncoding);
+        if (isBinary) {
+            return {
+                success: false,
+                error: 'binary_file',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Read file with budgets
+        const handle = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(maxBytes);
+        const { bytesRead } = await handle.read(buffer, 0, maxBytes, 0);
+        await handle.close();
+        const data = buffer.subarray(0, bytesRead);
+        // Use fatal: true when reading full file to catch encoding errors
+        // Use fatal: false when truncated to handle multibyte sequence cuts
+        const decoder = new TextDecoder(finalEncoding, { fatal: bytesRead === stats.size });
+        let content;
+        try {
+            content = decoder.decode(data);
+        }
+        catch (decodeError) {
+            return {
+                success: false,
+                error: 'unsupported_encoding',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Count lines and apply line limit
+        const lines = content.split('\n');
+        const truncatedLines = lines.length > maxLines;
+        const finalContent = truncatedLines ? lines.slice(0, maxLines).join('\n') : content;
+        const linesRead = Math.min(lines.length, maxLines);
+        const truncatedBytes = bytesRead === maxBytes && stats.size > maxBytes;
+        return {
+            success: true,
+            path: filePath,
+            relativePath: getRelativePath(),
+            content: finalContent,
+            encoding: finalEncoding,
+            truncatedBytes,
+            truncatedLines,
+            bytesRead,
+            linesRead,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                success: false,
+                error: 'file_not_found',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return {
+                success: false,
+                error: 'permission_denied',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/cjs/fs/reader.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export type { WorkspaceReaderOptions, ListDirectoryOptions, DirectoryResult, DirectoryEntry, ReadFileOptions, FileReadResult, ReadMultipleFilesOptions, MultiFileResult, FileSearchOptions, WorkspaceReader, } from "./types/public.js";
+export { createWorkspaceReader } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// Public API exports for @caplab/read
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkspaceReader = void 0;
+var factory_js_1 = require("./factory.js");
+Object.defineProperty(exports, "createWorkspaceReader", { enumerable: true, get: function () { return factory_js_1.createWorkspaceReader; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AAetC,2CAAqD;AAA5C,mHAAA,qBAAqB,OAAA"}

package/dist/cjs/output/formatter.d.ts

@@ -0,0 +1,4 @@
+import type { FileReadResult, DirectoryEntry } from '../types/public.js';
+export declare function formatFileReadResult(path: string, relativePath: string, content: string, encoding: string, truncatedBytes: boolean, truncatedLines: boolean, bytesRead: number, linesRead: number): FileReadResult;
+export declare function formatDirectoryEntry(path: string, relativePath: string, type: 'file' | 'directory', size?: number): DirectoryEntry;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/cjs/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/output/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,CAYhB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAOhB"}

package/dist/cjs/output/formatter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFileReadResult = formatFileReadResult;
+exports.formatDirectoryEntry = formatDirectoryEntry;
+function formatFileReadResult(path, relativePath, content, encoding, truncatedBytes, truncatedLines, bytesRead, linesRead) {
+    return {
+        success: true,
+        path,
+        relativePath,
+        content,
+        encoding,
+        truncatedBytes,
+        truncatedLines,
+        bytesRead,
+        linesRead,
+    };
+}
+function formatDirectoryEntry(path, relativePath, type, size) {
+    return {
+        path,
+        relativePath,
+        type,
+        size,
+    };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/cjs/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/output/formatter.ts"],"names":[],"mappings":";;AAEA,oDAqBC;AAED,oDAYC;AAnCD,SAAgB,oBAAoB,CAClC,IAAY,EACZ,YAAoB,EACpB,OAAe,EACf,QAAgB,EAChB,cAAuB,EACvB,cAAuB,EACvB,SAAiB,EACjB,SAAiB;IAEjB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,cAAc;QACd,cAAc;QACd,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAClC,IAAY,EACZ,YAAoB,EACpB,IAA0B,EAC1B,IAAa;IAEb,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/cjs/output/truncation.d.ts

@@ -0,0 +1,5 @@
+export declare function markTruncation(content: string, maxBytes: number, maxLines: number, bytesRead: number, fileSize: number): {
+    truncatedBytes: boolean;
+    truncatedLines: boolean;
+};
+//# sourceMappingURL=truncation.d.ts.map

package/dist/cjs/output/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../../src/output/truncation.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAOtD"}

package/dist/cjs/output/truncation.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markTruncation = markTruncation;
+function markTruncation(content, maxBytes, maxLines, bytesRead, fileSize) {
+    const truncatedBytes = bytesRead === maxBytes && fileSize > maxBytes;
+    const lines = content.split('\n');
+    const truncatedLines = lines.length > maxLines;
+    return { truncatedBytes, truncatedLines };
+}
+//# sourceMappingURL=truncation.js.map

package/dist/cjs/output/truncation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../../src/output/truncation.ts"],"names":[],"mappings":";;AAAA,wCAaC;AAbD,SAAgB,cAAc,CAC5B,OAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,SAAiB,EACjB,QAAgB;IAEhB,MAAM,cAAc,GAAG,SAAS,KAAK,QAAQ,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAErE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IAE/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/path/guard.d.ts

@@ -0,0 +1,5 @@
+export declare function validatePathBoundary(absolutePath: string, workspaceRoot: string): Promise<{
+    valid: boolean;
+    error?: 'not_found' | 'permission_denied';
+}>;
+//# sourceMappingURL=guard.d.ts.map

package/dist/cjs/path/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/path/guard.ts"],"names":[],"mappings":"AAGA,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAAA;CAAE,CAAC,CA4D9J"}

package/dist/cjs/path/guard.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePathBoundary = validatePathBoundary;
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs/promises"));
+async function validatePathBoundary(absolutePath, workspaceRoot) {
+    // First check if the resolved path is within the workspace root
+    // This must happen before checking if the path exists
+    const resolvedPath = path.resolve(absolutePath);
+    const resolvedRoot = path.resolve(workspaceRoot);
+    // On Windows, check if paths are on different drives
+    if (process.platform === 'win32') {
+        const pathDrive = resolvedPath.split(path.sep)[0];
+        const rootDrive = resolvedRoot.split(path.sep)[0];
+        if (pathDrive.toLowerCase() !== rootDrive.toLowerCase()) {
+            return { valid: false, error: undefined };
+        }
+    }
+    const relativePath = path.relative(resolvedRoot, resolvedPath);
+    // If relative path starts with '..', it's outside the workspace
+    if (relativePath.startsWith('..')) {
+        return { valid: false, error: undefined };
+    }
+    try {
+        // Check if path exists to distinguish error types
+        await fs.stat(absolutePath);
+        // Resolve symlinks to prevent escape via symlinks
+        const realPath = await fs.realpath(absolutePath);
+        const realWorkspaceRoot = await fs.realpath(workspaceRoot);
+        const realResolvedPath = path.resolve(realPath);
+        const realResolvedRoot = path.resolve(realWorkspaceRoot);
+        // On Windows, check if resolved paths are on different drives
+        if (process.platform === 'win32') {
+            const realPathDrive = realResolvedPath.split(path.sep)[0];
+            const realRootDrive = realResolvedRoot.split(path.sep)[0];
+            if (realPathDrive.toLowerCase() !== realRootDrive.toLowerCase()) {
+                return { valid: false, error: undefined };
+            }
+        }
+        // Check if the resolved path is within the workspace root (after symlink resolution)
+        const realRelativePath = path.relative(realResolvedRoot, realResolvedPath);
+        // If relative path starts with '..', it's outside the workspace
+        if (realRelativePath.startsWith('..')) {
+            return { valid: false, error: undefined };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return { valid: false, error: 'not_found' };
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return { valid: false, error: 'permission_denied' };
+        }
+        return { valid: false, error: undefined };
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/cjs/path/guard.js.map

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

package/dist/cjs/path/normalizer.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizePath(inputPath: string): string;
+export declare function isAbsolute(inputPath: string): boolean;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/cjs/path/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/path/normalizer.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/cjs/path/normalizer.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePath = normalizePath;
+exports.isAbsolute = isAbsolute;
+const path = __importStar(require("node:path"));
+function normalizePath(inputPath) {
+    const normalized = path.normalize(inputPath);
+    // Convert backslashes to forward slashes for consistency
+    return normalized.split(path.sep).join('/');
+}
+function isAbsolute(inputPath) {
+    return path.isAbsolute(inputPath);
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/cjs/path/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../../../src/path/normalizer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,sCAIC;AAED,gCAEC;AAVD,gDAAkC;AAElC,SAAgB,aAAa,CAAC,SAAiB;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,yDAAyD;IACzD,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,UAAU,CAAC,SAAiB;IAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/dist/cjs/path/resolver.d.ts

@@ -0,0 +1,5 @@
+import type { WorkspaceConfig } from '../types/internal.js';
+export declare function validateWorkspaceRoot(workspaceRoot: string): Promise<WorkspaceConfig | null>;
+export declare function resolvePath(inputPath: string, workspaceRoot: string): string;
+export declare function getRelativePath(absolutePath: string, workspaceRoot: string): string;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/cjs/path/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/path/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAqBlG;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAInF"}