@caplab/read 0.1.0

package/dist/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/path/guard.js

@@ -0,0 +1,55 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+export 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/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/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/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/path/normalizer.js

@@ -0,0 +1,10 @@
+import * as path from 'node:path';
+export function normalizePath(inputPath) {
+    const normalized = path.normalize(inputPath);
+    // Convert backslashes to forward slashes for consistency
+    return normalized.split(path.sep).join('/');
+}
+export function isAbsolute(inputPath) {
+    return path.isAbsolute(inputPath);
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/path/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../../src/path/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,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,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

package/dist/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/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"}

package/dist/path/resolver.js

@@ -0,0 +1,35 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+export async function validateWorkspaceRoot(workspaceRoot) {
+    try {
+        const stat = await fs.stat(workspaceRoot);
+        if (!stat.isDirectory()) {
+            return null;
+        }
+        const resolvedRoot = path.resolve(workspaceRoot);
+        return {
+            workspaceRoot: resolvedRoot,
+            maxBytes: 262144,
+            maxLines: 2000,
+            maxFiles: 20,
+            maxTotalBytes: 1048576,
+            maxEntries: 1000,
+            maxSearchResults: 200,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function resolvePath(inputPath, workspaceRoot) {
+    if (path.isAbsolute(inputPath)) {
+        return path.resolve(inputPath);
+    }
+    return path.resolve(workspaceRoot, inputPath);
+}
+export function getRelativePath(absolutePath, workspaceRoot) {
+    const relative = path.relative(workspaceRoot, absolutePath);
+    // Normalize to forward slashes for consistency
+    return relative.split(path.sep).join('/');
+}
+//# sourceMappingURL=resolver.js.map

package/dist/path/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/path/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGvC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,aAAqB;IAC/D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAEjD,OAAO;YACL,aAAa,EAAE,YAAY;YAC3B,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,EAAE;YACZ,aAAa,EAAE,OAAO;YACtB,UAAU,EAAE,IAAI;YAChB,gBAAgB,EAAE,GAAG;SACtB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,aAAqB;IAClE,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,aAAqB;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5D,+CAA+C;IAC/C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/read/encoding.d.ts

@@ -0,0 +1,5 @@
+export declare function detectFileEncoding(filePath: string, requestedEncoding?: 'utf-8' | 'utf-16le' | 'utf-16be' | 'auto'): Promise<{
+    encoding: 'utf-8' | 'utf-16le' | 'utf-16be' | 'unknown';
+    error?: string;
+}>;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/read/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/read/encoding.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAC7D,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBtF"}

package/dist/read/encoding.js

@@ -0,0 +1,26 @@
+import { detectEncoding } from '../fs/binary.js';
+export async function detectFileEncoding(filePath, requestedEncoding) {
+    if (requestedEncoding && requestedEncoding !== 'auto') {
+        // Validate that the requested encoding is supported
+        if (requestedEncoding !== 'utf-8' && requestedEncoding !== 'utf-16le' && requestedEncoding !== 'utf-16be') {
+            return {
+                encoding: 'unknown',
+                error: 'unsupported_encoding',
+            };
+        }
+        return {
+            encoding: requestedEncoding,
+        };
+    }
+    const detection = await detectEncoding(filePath);
+    if (detection.encoding === 'unknown') {
+        return {
+            encoding: 'unknown',
+            error: 'unsupported_encoding',
+        };
+    }
+    return {
+        encoding: detection.encoding,
+    };
+}
+//# sourceMappingURL=encoding.js.map

package/dist/read/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/read/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,iBAA8D;IAE9D,IAAI,iBAAiB,IAAI,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACtD,oDAAoD;QACpD,IAAI,iBAAiB,KAAK,OAAO,IAAI,iBAAiB,KAAK,UAAU,IAAI,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC1G,OAAO;gBACL,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,sBAAsB;aAC9B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,iBAAiB;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,sBAAsB;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,SAAS,CAAC,QAAQ;KAC7B,CAAC;AACJ,CAAC"}

package/dist/read/multi-file.d.ts

@@ -0,0 +1,4 @@
+import type { MultiFileResult, ReadMultipleFilesOptions } from '../types/public.js';
+import type { WorkspaceConfig } from '../types/internal.js';
+export declare function readMultipleFiles(paths: string[], workspaceConfig: WorkspaceConfig, options?: ReadMultipleFilesOptions): Promise<MultiFileResult>;
+//# sourceMappingURL=multi-file.d.ts.map

package/dist/read/multi-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-file.d.ts","sourceRoot":"","sources":["../../src/read/multi-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAkB,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAc5D,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EAAE,EACf,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CA0Q1B"}

package/dist/read/multi-file.js

@@ -0,0 +1,257 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { readFileWithBudget } from '../fs/reader.js';
+import { validatePathBoundary } from '../path/guard.js';
+import { getRelativePath } from '../path/resolver.js';
+export async function readMultipleFiles(paths, workspaceConfig, options = {}) {
+    const maxFiles = options.maxFiles ?? workspaceConfig.maxFiles;
+    const maxBytes = options.maxBytes ?? workspaceConfig.maxBytes;
+    const maxTotalBytes = options.maxTotalBytes ?? workspaceConfig.maxTotalBytes;
+    const maxConcurrency = options.maxConcurrency ?? 5;
+    // Validate maxConcurrency to prevent deadlock
+    if (!Number.isFinite(maxConcurrency) || maxConcurrency <= 0) {
+        throw new Error('maxConcurrency must be a positive finite number');
+    }
+    const results = [];
+    let totalBytesRead = 0;
+    let totalBytesSkipped = 0;
+    // Phase 1: Stat all files in input order (sequential, deterministic)
+    const fileStats = [];
+    for (const inputPath of paths) {
+        const absolutePath = path.resolve(workspaceConfig.workspaceRoot, inputPath);
+        const relativePath = getRelativePath(absolutePath, workspaceConfig.workspaceRoot);
+        // Check path boundary
+        const boundaryCheck = await validatePathBoundary(absolutePath, workspaceConfig.workspaceRoot);
+        if (!boundaryCheck.valid) {
+            if (boundaryCheck.error === 'not_found') {
+                fileStats.push({
+                    path: absolutePath,
+                    relativePath,
+                    size: 0,
+                    exists: false,
+                    accessible: false,
+                    outsideWorkspace: false,
+                });
+            }
+            else if (boundaryCheck.error === 'permission_denied') {
+                fileStats.push({
+                    path: absolutePath,
+                    relativePath,
+                    size: 0,
+                    exists: true,
+                    accessible: false,
+                    outsideWorkspace: false,
+                });
+            }
+            else {
+                // Outside workspace
+                fileStats.push({
+                    path: absolutePath,
+                    relativePath,
+                    size: 0,
+                    exists: false,
+                    accessible: false,
+                    outsideWorkspace: true,
+                });
+            }
+            continue;
+        }
+        try {
+            const stats = await fs.stat(absolutePath);
+            fileStats.push({
+                path: absolutePath,
+                relativePath,
+                size: stats.size,
+                exists: true,
+                accessible: true,
+                outsideWorkspace: false,
+            });
+        }
+        catch (error) {
+            const isNotFound = error.code === 'ENOENT';
+            const isPermissionDenied = error.code === 'EACCES' || error.code === 'EPERM';
+            fileStats.push({
+                path: absolutePath,
+                relativePath,
+                size: 0,
+                exists: !isNotFound,
+                accessible: !isPermissionDenied,
+                outsideWorkspace: false,
+            });
+        }
+    }
+    // Phase 2: Apply maxFiles limit after stat-phase failures
+    let admittedFiles = fileStats.filter(f => f.exists && f.accessible);
+    const maxFilesSkipped = fileStats.filter(f => f.exists && f.accessible).slice(maxFiles);
+    admittedFiles = admittedFiles.slice(0, maxFiles);
+    // Phase 3: Reserve budget based on min(stat.size, effectiveMaxBytes)
+    let budgetReserved = 0;
+    const admittedWithBudget = [];
+    const budgetSkipped = [];
+    for (const fileInfo of admittedFiles) {
+        const effectiveMaxBytes = Math.min(fileInfo.size, maxBytes);
+        if (budgetReserved + effectiveMaxBytes <= maxTotalBytes) {
+            budgetReserved += effectiveMaxBytes;
+            admittedWithBudget.push(fileInfo);
+        }
+        else {
+            budgetSkipped.push(fileInfo);
+        }
+    }
+    // Phase 4: Read admitted files with bounded parallelism
+    const readPromises = [];
+    const activePromises = [];
+    let index = 0;
+    const processNext = async () => {
+        while (index < admittedWithBudget.length || activePromises.length > 0) {
+            // Fill up to maxConcurrency
+            while (index < admittedWithBudget.length && activePromises.length < maxConcurrency) {
+                const fileInfo = admittedWithBudget[index++];
+                const promise = (async () => {
+                    try {
+                        const result = await readFileWithBudget(fileInfo.path, maxBytes, workspaceConfig.maxLines, 'auto', workspaceConfig.workspaceRoot);
+                        results.push({
+                            path: fileInfo.path,
+                            relativePath: fileInfo.relativePath,
+                            result,
+                        });
+                        if (result.success) {
+                            totalBytesRead += result.bytesRead;
+                        }
+                    }
+                    catch (error) {
+                        // Re-throw unexpected errors (e.g., RangeError from invalid API usage)
+                        if (error instanceof RangeError || error instanceof TypeError) {
+                            throw error;
+                        }
+                        // Only map known I/O errors to permission_denied
+                        results.push({
+                            path: fileInfo.path,
+                            relativePath: fileInfo.relativePath,
+                            result: {
+                                success: false,
+                                error: 'permission_denied',
+                                path: fileInfo.path,
+                                relativePath: fileInfo.relativePath,
+                            },
+                        });
+                    }
+                })();
+                activePromises.push(promise);
+                readPromises.push(promise);
+                // Remove from active when done
+                promise.then(() => {
+                    const idx = activePromises.indexOf(promise);
+                    if (idx !== -1) {
+                        activePromises.splice(idx, 1);
+                    }
+                }).catch(() => {
+                    // Ignore errors here - they're already handled in the worker
+                    const idx = activePromises.indexOf(promise);
+                    if (idx !== -1) {
+                        activePromises.splice(idx, 1);
+                    }
+                });
+            }
+            // Wait for at least one to complete if we're at capacity
+            if (activePromises.length >= maxConcurrency) {
+                await Promise.race(activePromises);
+            }
+            else if (index >= admittedWithBudget.length && activePromises.length > 0) {
+                // No more to enqueue, wait for remaining
+                await Promise.all(activePromises);
+            }
+            else {
+                // Break if nothing to do
+                if (index >= admittedWithBudget.length && activePromises.length === 0) {
+                    break;
+                }
+                // Small delay to avoid busy-wait
+                await new Promise(resolve => setImmediate(resolve));
+            }
+        }
+    };
+    await processNext();
+    await Promise.all(readPromises);
+    // Add stat-phase failures
+    for (const fileInfo of fileStats) {
+        if (fileInfo.outsideWorkspace) {
+            results.push({
+                path: fileInfo.path,
+                relativePath: fileInfo.relativePath,
+                result: {
+                    success: false,
+                    error: 'path_outside_workspace',
+                    path: fileInfo.path,
+                    relativePath: fileInfo.relativePath,
+                },
+            });
+        }
+        else if (!fileInfo.exists) {
+            results.push({
+                path: fileInfo.path,
+                relativePath: fileInfo.relativePath,
+                result: {
+                    success: false,
+                    error: 'file_not_found',
+                    path: fileInfo.path,
+                    relativePath: fileInfo.relativePath,
+                },
+            });
+        }
+        else if (!fileInfo.accessible) {
+            results.push({
+                path: fileInfo.path,
+                relativePath: fileInfo.relativePath,
+                result: {
+                    success: false,
+                    error: 'permission_denied',
+                    path: fileInfo.path,
+                    relativePath: fileInfo.relativePath,
+                },
+            });
+        }
+    }
+    // Add maxFiles skipped files
+    for (const fileInfo of maxFilesSkipped) {
+        results.push({
+            path: fileInfo.path,
+            relativePath: fileInfo.relativePath,
+            result: {
+                success: false,
+                error: 'skipped_due_to_max_files',
+                path: fileInfo.path,
+                relativePath: fileInfo.relativePath,
+            },
+        });
+    }
+    // Add budget-skipped files
+    for (const fileInfo of budgetSkipped) {
+        const effectiveMaxBytes = Math.min(fileInfo.size, maxBytes);
+        totalBytesSkipped += effectiveMaxBytes;
+        results.push({
+            path: fileInfo.path,
+            relativePath: fileInfo.relativePath,
+            result: {
+                success: false,
+                error: 'skipped_due_to_budget',
+                path: fileInfo.path,
+                relativePath: fileInfo.relativePath,
+            },
+        });
+    }
+    // Sort results to preserve input order
+    const pathToIndex = new Map(paths.map((p, i) => [path.resolve(workspaceConfig.workspaceRoot, p), i]));
+    results.sort((a, b) => {
+        const indexA = pathToIndex.get(a.path) ?? Infinity;
+        const indexB = pathToIndex.get(b.path) ?? Infinity;
+        return indexA - indexB;
+    });
+    return {
+        success: true,
+        results,
+        totalBytesRead,
+        totalBytesSkipped,
+    };
+}
+//# sourceMappingURL=multi-file.js.map

package/dist/read/multi-file.js.map

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

package/dist/search/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceConfig } from '../types/internal.js';
+export declare function fileSearch(query: string, workspaceConfig: WorkspaceConfig, options?: any): AsyncGenerator<any, void, unknown>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/search/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/search/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,eAAe,EAChC,OAAO,CAAC,EAAE,GAAG,GACZ,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAqBpC"}

package/dist/search/adapter.js

@@ -0,0 +1,31 @@
+import { grepSearch } from '@caplab/grep-search';
+export function fileSearch(query, workspaceConfig, options) {
+    // Use allowlist of safe options to prevent workspace boundary escape
+    const safeOptions = {
+        query,
+        cwd: workspaceConfig.workspaceRoot,
+    };
+    // Only forward specific safe options, not cwd or other boundary-related options
+    if (options?.regex !== undefined)
+        safeOptions.regex = options.regex;
+    if (options?.caseSensitive !== undefined)
+        safeOptions.caseSensitive = options.caseSensitive;
+    if (options?.wholeWord !== undefined)
+        safeOptions.wholeWord = options.wholeWord;
+    if (options?.multiline !== undefined)
+        safeOptions.multiline = options.multiline;
+    if (options?.extensions !== undefined)
+        safeOptions.extensions = options.extensions;
+    if (options?.ignore !== undefined)
+        safeOptions.ignore = options.ignore;
+    if (options?.beforeContext !== undefined)
+        safeOptions.beforeContext = options.beforeContext;
+    if (options?.afterContext !== undefined)
+        safeOptions.afterContext = options.afterContext;
+    if (options?.maxDepth !== undefined)
+        safeOptions.maxDepth = options.maxDepth;
+    // Always apply default maxResults from workspaceConfig
+    safeOptions.maxResults = options?.maxResults ?? workspaceConfig.maxSearchResults;
+    return grepSearch(safeOptions);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/search/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/search/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,eAAgC,EAChC,OAAa;IAEb,qEAAqE;IACrE,MAAM,WAAW,GAAQ;QACvB,KAAK;QACL,GAAG,EAAE,eAAe,CAAC,aAAa;KACnC,CAAC;IAEF,gFAAgF;IAChF,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACpE,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS;QAAE,WAAW,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5F,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChF,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,WAAW,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAChF,IAAI,OAAO,EAAE,UAAU,KAAK,SAAS;QAAE,WAAW,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACnF,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvE,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS;QAAE,WAAW,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5F,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS;QAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACzF,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS;QAAE,WAAW,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7E,uDAAuD;IACvD,WAAW,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,eAAe,CAAC,gBAAgB,CAAC;IAEjF,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC"}

package/dist/types/internal.d.ts

@@ -0,0 +1,24 @@
+export interface WorkspaceConfig {
+    workspaceRoot: string;
+    maxBytes: number;
+    maxLines: number;
+    maxFiles: number;
+    maxTotalBytes: number;
+    maxEntries: number;
+    maxSearchResults: number;
+}
+export interface FileStat {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+}
+export interface EncodingDetectionResult {
+    encoding: 'utf-8' | 'utf-16le' | 'utf-16be' | 'unknown';
+    bom: boolean;
+}
+export interface AdmissionResult {
+    admitted: boolean;
+    reason?: 'budget_exhausted' | 'max_files_exceeded' | 'stat_failed';
+    reservedBytes: number;
+}
+//# sourceMappingURL=internal.d.ts.map

package/dist/types/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACxD,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,aAAa,CAAC;IACnE,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/internal.js

@@ -0,0 +1,3 @@
+// Internal implementation types
+export {};
+//# sourceMappingURL=internal.js.map

package/dist/types/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"AAAA,gCAAgC"}

package/dist/types/public.d.ts

@@ -0,0 +1,87 @@
+export interface WorkspaceReaderOptions {
+    workspaceRoot: string;
+    maxBytes?: number;
+    maxLines?: number;
+    maxFiles?: number;
+    maxTotalBytes?: number;
+    maxEntries?: number;
+    maxSearchResults?: number;
+}
+export interface ListDirectoryOptions {
+    maxDepth?: number;
+    includeHidden?: boolean;
+    include?: string[];
+    exclude?: string[];
+    maxEntries?: number;
+}
+export type DirectoryResult = {
+    success: true;
+    entries: DirectoryEntry[];
+    truncated: boolean;
+} | {
+    success: false;
+    error: "path_not_found" | "permission_denied" | "path_outside_workspace";
+    path: string;
+};
+export interface DirectoryEntry {
+    path: string;
+    relativePath: string;
+    type: "file" | "directory";
+    size?: number;
+}
+export interface ReadFileOptions {
+    maxBytes?: number;
+    maxLines?: number;
+    encoding?: "utf-8" | "utf-16le" | "utf-16be" | "auto";
+}
+export type FileReadResult = {
+    success: true;
+    path: string;
+    relativePath: string;
+    content: string;
+    encoding: string;
+    truncatedBytes: boolean;
+    truncatedLines: boolean;
+    bytesRead: number;
+    linesRead: number;
+} | {
+    success: false;
+    error: "file_not_found" | "permission_denied" | "binary_file" | "unsupported_encoding" | "path_outside_workspace" | "skipped_due_to_budget" | "skipped_due_to_max_files";
+    path: string;
+    relativePath: string;
+};
+export interface ReadMultipleFilesOptions {
+    maxFiles?: number;
+    maxBytes?: number;
+    maxTotalBytes?: number;
+    maxConcurrency?: number;
+}
+export interface MultiFileResult {
+    success: true;
+    results: Array<{
+        path: string;
+        relativePath: string;
+        result: FileReadResult;
+    }>;
+    totalBytesRead: number;
+    totalBytesSkipped: number;
+}
+export interface FileSearchOptions {
+    regex?: boolean;
+    wholeWord?: boolean;
+    caseSensitive?: boolean;
+    multiline?: boolean;
+    extensions?: string[];
+    ignore?: string[];
+    maxDepth?: number;
+    beforeContext?: number;
+    afterContext?: number;
+    maxResults?: number;
+}
+export interface WorkspaceReader {
+    listDirectory(path: string, options?: ListDirectoryOptions): Promise<DirectoryResult>;
+    readFile(path: string, options?: ReadFileOptions): Promise<FileReadResult>;
+    readMultipleFiles(paths: string[], options?: ReadMultipleFilesOptions): Promise<MultiFileResult>;
+    fileSearch(query: string, options?: FileSearchOptions): AsyncGenerator<import("@caplab/grep-search").SearchMatch, void, unknown>;
+}
+//# sourceMappingURL=public.d.ts.map

package/dist/types/public.d.ts.map

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