@j0hanz/fs-context-mcp 2.0.0

package/dist/__tests__/lib/path-validation-errors.test.js

@@ -0,0 +1,35 @@
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, expect, it } from 'vitest';
+import { ErrorCode } from '../../lib/errors.js';
+import { normalizePath } from '../../lib/path-utils.js';
+import { setAllowedDirectories } from '../../lib/path-validation.js';
+import { toAccessDeniedWithHint, toMcpError, } from '../../lib/path-validation.js';
+afterEach(() => {
+    setAllowedDirectories([]);
+});
+it('toMcpError maps known Node error codes', () => {
+    const error = Object.assign(new Error('Missing'), { code: 'ENOENT' });
+    const result = toMcpError('/missing', error);
+    expect(result.code).toBe(ErrorCode.E_NOT_FOUND);
+    expect(result.message).toContain('/missing');
+    expect(result.details?.originalCode).toBe('ENOENT');
+});
+it('toMcpError falls back for unknown codes', () => {
+    const error = Object.assign(new Error('Boom'), { code: 'EUNKNOWN' });
+    const result = toMcpError('/path', error);
+    expect(result.code).toBe(ErrorCode.E_NOT_FOUND);
+    expect(result.details?.originalCode).toBe('EUNKNOWN');
+    expect(result.details?.originalMessage).toBe('Boom');
+});
+it('toAccessDeniedWithHint includes allowed directories', () => {
+    const allowed = normalizePath(path.join(os.tmpdir(), 'allowed'));
+    setAllowedDirectories([allowed]);
+    const result = toAccessDeniedWithHint('/requested', '/resolved', allowed);
+    expect(result.code).toBe(ErrorCode.E_ACCESS_DENIED);
+    expect(result.message).toContain('Allowed:');
+    expect(result.message).toContain(allowed);
+    expect(result.details?.resolvedPath).toBe('/resolved');
+    expect(result.details?.normalizedResolvedPath).toBe(allowed);
+});
+//# sourceMappingURL=path-validation-errors.test.js.map

package/dist/__tests__/lib/path-validation-errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation-errors.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/path-validation-errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,sBAAsB,EACtB,UAAU,GACX,MAAM,8BAA8B,CAAC;AAEtC,SAAS,CAAC,GAAG,EAAE;IACb,qBAAqB,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEtE,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAE7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC7D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,qBAAqB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAE1E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/path-validation-roots.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=path-validation-roots.test.d.ts.map

package/dist/__tests__/lib/path-validation-roots.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation-roots.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/path-validation-roots.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/path-validation-roots.test.js

@@ -0,0 +1,42 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { afterAll, beforeAll, expect, it } from 'vitest';
+import { normalizePath } from '../../lib/path-utils.js';
+import { getValidRootDirectories } from '../../lib/path-validation.js';
+let testDir = '';
+let testFile = '';
+beforeAll(async () => {
+    testDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-roots-'));
+    testFile = path.join(testDir, 'test.txt');
+    await fs.writeFile(testFile, 'data');
+});
+afterAll(async () => {
+    try {
+        await fs.rm(testDir, { recursive: true, force: true });
+    }
+    catch {
+        // ignore cleanup errors
+    }
+});
+function toRoot(uri) {
+    const root = { uri };
+    return root;
+}
+it('getValidRootDirectories returns only file roots that are directories', async () => {
+    const roots = [
+        toRoot(pathToFileURL(testDir).toString()),
+        toRoot(pathToFileURL(testFile).toString()),
+        toRoot('http://example.com'),
+    ];
+    const result = await getValidRootDirectories(roots);
+    expect(result).toEqual([normalizePath(testDir)]);
+});
+it('getValidRootDirectories ignores invalid root directories', async () => {
+    const missing = path.join(testDir, 'missing');
+    const roots = [toRoot(pathToFileURL(missing).toString())];
+    const result = await getValidRootDirectories(roots);
+    expect(result).toEqual([]);
+});
+//# sourceMappingURL=path-validation-roots.test.js.map

package/dist/__tests__/lib/path-validation-roots.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation-roots.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/path-validation-roots.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,IAAI,OAAO,GAAG,EAAE,CAAC;AACjB,IAAI,QAAQ,GAAG,EAAE,CAAC;AAElB,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACjE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;IAClB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,MAAM,CAAC,GAAW;IACzB,MAAM,IAAI,GAAS,EAAE,GAAG,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;IACpF,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,oBAAoB,CAAC;KAC7B,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC"}

package/dist/__tests__/lib/path-validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=path-validation.test.d.ts.map

package/dist/__tests__/lib/path-validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/path-validation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/path-validation.test.js

@@ -0,0 +1,127 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterAll, beforeAll, expect, it } from 'vitest';
+import { normalizePath } from '../../lib/path-utils.js';
+import { getAllowedDirectories, setAllowedDirectories, validateExistingPath, } from '../../lib/path-validation.js';
+let testDir = '';
+let subDir = '';
+let testFile = '';
+beforeAll(async () => {
+    testDir = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-test-'));
+    subDir = path.join(testDir, 'subdir');
+    await fs.mkdir(subDir);
+    testFile = path.join(subDir, 'test.txt');
+    await fs.writeFile(testFile, 'test content');
+    setAllowedDirectories([normalizePath(testDir)]);
+});
+afterAll(async () => {
+    try {
+        await fs.rm(testDir, { recursive: true, force: true });
+    }
+    catch {
+        // ignore cleanup errors
+    }
+});
+function resetAllowedDirectories() {
+    setAllowedDirectories([normalizePath(testDir)]);
+}
+async function createFileInDir(dirName, fileName) {
+    const dirPath = path.join(testDir, dirName);
+    await fs.mkdir(dirPath, { recursive: true });
+    const filePath = path.join(dirPath, fileName);
+    await fs.writeFile(filePath, 'content');
+    return filePath;
+}
+it('setAllowedDirectories and getAllowedDirectories set and get allowed directories', () => {
+    const dirs = ['/test/dir1', '/test/dir2'];
+    setAllowedDirectories(dirs.map(normalizePath));
+    const result = getAllowedDirectories();
+    expect(result.length).toBe(2);
+    resetAllowedDirectories();
+});
+it('setAllowedDirectories returns empty array when no directories set', () => {
+    setAllowedDirectories([]);
+    expect(getAllowedDirectories()).toEqual([]);
+    resetAllowedDirectories();
+});
+it('validateExistingPath rejects when no allowed directories configured', async () => {
+    setAllowedDirectories([]);
+    await expect(validateExistingPath(testFile)).rejects.toThrow(/no allowed directories configured/i);
+    resetAllowedDirectories();
+});
+it('validateExistingPath allows paths within allowed directories', async () => {
+    const result = await validateExistingPath(testFile);
+    expect(result).toContain('test.txt');
+});
+it('validateExistingPath allows the allowed directory itself', async () => {
+    const result = await validateExistingPath(testDir);
+    expect(result).toBeTruthy();
+});
+it('validateExistingPath allows subdirectories within allowed directories', async () => {
+    const result = await validateExistingPath(subDir);
+    expect(result).toContain('subdir');
+});
+it('validateExistingPath rejects paths outside allowed directories', async () => {
+    await expect(validateExistingPath('/etc/passwd')).rejects.toThrow();
+});
+it('validateExistingPath rejects traversal attempts', async () => {
+    const traversalPath = path.join(testDir, '..', 'etc', 'passwd');
+    await expect(validateExistingPath(traversalPath)).rejects.toThrow();
+});
+it('validateExistingPath rejects non-existent paths', async () => {
+    const nonExistent = path.join(testDir, 'non-existent-file.txt');
+    await expect(validateExistingPath(nonExistent)).rejects.toThrow();
+});
+it('validateExistingPath allows paths when filesystem root is allowed', async () => {
+    const rootDir = path.parse(testDir).root;
+    setAllowedDirectories([normalizePath(rootDir)]);
+    const result = await validateExistingPath(testFile);
+    expect(result).toContain('test.txt');
+    resetAllowedDirectories();
+});
+it('validateExistingPath handles paths with spaces', async () => {
+    const fileInDir = await createFileInDir('dir with spaces', 'file.txt');
+    const result = await validateExistingPath(fileInDir);
+    expect(result).toContain('file.txt');
+    await fs.rm(path.dirname(fileInDir), { recursive: true });
+});
+it('validateExistingPath handles paths with special characters', async () => {
+    const fileInDir = await createFileInDir('special-chars_123', 'test_file-1.txt');
+    const result = await validateExistingPath(fileInDir);
+    expect(result).toContain('test_file-1.txt');
+    await fs.rm(path.dirname(fileInDir), { recursive: true });
+});
+it('validateExistingPath rejects empty path', async () => {
+    await expect(validateExistingPath('')).rejects.toThrow(/empty|whitespace/i);
+});
+it('validateExistingPath rejects whitespace-only path', async () => {
+    await expect(validateExistingPath('   ')).rejects.toThrow(/empty|whitespace/i);
+});
+it('validateExistingPath rejects path with null bytes', async () => {
+    const pathWithNull = path.join(testDir, 'file\0name.txt');
+    await expect(validateExistingPath(pathWithNull)).rejects.toThrow();
+});
+const itWindows = process.platform === 'win32' ? it : it.skip;
+itWindows('validateExistingPath rejects Windows drive-relative paths', async () => {
+    await expect(validateExistingPath('C:')).rejects.toThrow(/drive-relative/i);
+    await expect(validateExistingPath('C:temp')).rejects.toThrow(/drive-relative/i);
+});
+itWindows('validateExistingPath rejects Windows reserved device names with suffixes', async () => {
+    const candidates = [
+        'CON',
+        'CON.txt',
+        'CON.',
+        'CON ',
+        'CON::$DATA',
+        'AUX.txt',
+        'NUL ',
+        'COM1',
+        'LPT1.txt',
+    ];
+    for (const candidate of candidates) {
+        const attempt = path.join(testDir, candidate);
+        await expect(validateExistingPath(attempt)).rejects.toThrow(/reserved device name/i);
+    }
+});
+//# sourceMappingURL=path-validation.test.js.map

package/dist/__tests__/lib/path-validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validation.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/path-validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,IAAI,OAAO,GAAG,EAAE,CAAC;AACjB,IAAI,MAAM,GAAG,EAAE,CAAC;AAChB,IAAI,QAAQ,GAAG,EAAE,CAAC;AAElB,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC7C,qBAAqB,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;IAClB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,uBAAuB;IAC9B,qBAAqB,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;IACzF,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAC1C,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,uBAAuB,EAAE,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC3E,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,uBAAuB,EAAE,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;IACnF,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,MAAM,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC1D,oCAAoC,CACrC,CAAC;IACF,uBAAuB,EAAE,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;IAC5E,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;IACxE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;IACrF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;IAC9E,MAAM,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAChE,MAAM,MAAM,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACzC,qBAAqB,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,uBAAuB,EAAE,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;IAC9D,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,SAAS,GAAG,MAAM,eAAe,CACrC,mBAAmB,EACnB,iBAAiB,CAClB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;IACjE,MAAM,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACvD,mBAAmB,CACpB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC1D,MAAM,MAAM,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACrE,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;AAE9D,SAAS,CACP,2DAA2D,EAC3D,KAAK,IAAI,EAAE;IACT,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC1D,iBAAiB,CAClB,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,SAAS,CACP,0EAA0E,EAC1E,KAAK,IAAI,EAAE;IACT,MAAM,UAAU,GAAG;QACjB,KAAK;QACL,SAAS;QACT,MAAM;QACN,MAAM;QACN,YAAY;QACZ,SAAS;QACT,MAAM;QACN,MAAM;QACN,UAAU;KACX,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACzD,uBAAuB,CACxB,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC"}

package/dist/__tests__/schemas/validators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validators.test.d.ts.map

package/dist/__tests__/schemas/validators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/schemas/validators.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schemas/validators.test.js

@@ -0,0 +1,114 @@
+import { expect, it } from 'vitest';
+import { ErrorCode, McpError } from '../../lib/errors.js';
+import { assertLineRangeOptions } from '../../lib/line-range.js';
+function expectMcpError(fn, options) {
+    try {
+        fn();
+        expect.fail('Expected McpError to be thrown');
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(McpError);
+        const mcpError = error;
+        expect(mcpError.code).toBe(options.code);
+        expect(mcpError.message).toContain(options.messageIncludes);
+    }
+}
+function validateLineRange(params) {
+    const { path, ...options } = params;
+    assertLineRangeOptions(options, path);
+}
+function validateHeadTail(head, tail) {
+    assertLineRangeOptions({ head, tail }, '/test/file.txt');
+}
+const validLineRangeCases = [
+    {
+        name: 'valid lineRange with both lineStart and lineEnd',
+        params: { lineStart: 1, lineEnd: 10, path: '/test/file.txt' },
+    },
+    {
+        name: 'no line options',
+        params: { path: '/test/file.txt' },
+    },
+    {
+        name: 'head option alone',
+        params: { head: 10, path: '/test/file.txt' },
+    },
+    {
+        name: 'tail option alone',
+        params: { tail: 10, path: '/test/file.txt' },
+    },
+    {
+        name: 'lineEnd equal to lineStart',
+        params: { lineStart: 5, lineEnd: 5, path: '/test/file.txt' },
+    },
+];
+for (const testCase of validLineRangeCases) {
+    it(`validateLineRange accepts ${testCase.name}`, () => {
+        expect(() => {
+            validateLineRange(testCase.params);
+        }).not.toThrow();
+    });
+}
+const invalidLineRangeCases = [
+    {
+        name: 'lineStart without lineEnd',
+        params: { lineStart: 5, path: '/test/file.txt' },
+        message: 'lineStart requires lineEnd',
+    },
+    {
+        name: 'lineEnd without lineStart',
+        params: { lineEnd: 10, path: '/test/file.txt' },
+        message: 'lineEnd requires lineStart',
+    },
+    {
+        name: 'lineEnd < lineStart',
+        params: { lineStart: 10, lineEnd: 5, path: '/test/file.txt' },
+        message: 'lineEnd (5) must be >= lineStart (10)',
+    },
+    {
+        name: 'lineRange with head',
+        params: { lineStart: 1, lineEnd: 10, head: 5, path: '/test/file.txt' },
+        message: 'Cannot specify multiple',
+    },
+    {
+        name: 'lineRange with tail',
+        params: { lineStart: 1, lineEnd: 10, tail: 5, path: '/test/file.txt' },
+        message: 'Cannot specify multiple',
+    },
+    {
+        name: 'head with tail',
+        params: { head: 5, tail: 5, path: '/test/file.txt' },
+        message: 'Cannot specify multiple',
+    },
+];
+for (const testCase of invalidLineRangeCases) {
+    it(`validateLineRange rejects ${testCase.name}`, () => {
+        expectMcpError(() => {
+            validateLineRange(testCase.params);
+        }, {
+            code: ErrorCode.E_INVALID_INPUT,
+            messageIncludes: testCase.message,
+        });
+    });
+}
+const validHeadTailCases = [
+    [10, undefined],
+    [undefined, 10],
+    [undefined, undefined],
+];
+for (const [head, tail] of validHeadTailCases) {
+    it('validateHeadTail accepts valid head/tail combination', () => {
+        expect(() => {
+            validateHeadTail(head, tail);
+        }).not.toThrow();
+    });
+}
+it('validateHeadTail rejects both head and tail', () => {
+    expectMcpError(() => {
+        validateHeadTail(5, 5);
+    }, {
+        code: ErrorCode.E_INVALID_INPUT,
+        messageIncludes: 'Cannot specify multiple',
+    });
+});
+//# sourceMappingURL=validators.test.js.map

package/dist/__tests__/schemas/validators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.test.js","sourceRoot":"","sources":["../../../src/__tests__/schemas/validators.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,SAAS,cAAc,CACrB,EAAc,EACd,OAAqD;IAErD,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;QACL,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,KAAiB,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAM1B;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;IACpC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa,EAAE,IAAa;IACpD,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,mBAAmB,GAAG;IAC1B;QACE,IAAI,EAAE,iDAAiD;QACvD,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;KAC9D;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;KACnC;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;KAC7C;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;KAC7C;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;KAC7D;CACF,CAAC;AAEF,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;IAC3C,EAAE,CAAC,6BAA6B,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,EAAE;YACV,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,qBAAqB,GAAG;IAC5B;QACE,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAChD,OAAO,EAAE,4BAA4B;KACtC;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAC/C,OAAO,EAAE,4BAA4B;KACtC;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAC7D,OAAO,EAAE,uCAAuC;KACjD;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACtE,OAAO,EAAE,yBAAyB;KACnC;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACtE,OAAO,EAAE,yBAAyB;KACnC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACpD,OAAO,EAAE,yBAAyB;KACnC;CACF,CAAC;AAEF,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;IAC7C,EAAE,CAAC,6BAA6B,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;QACpD,cAAc,CACZ,GAAG,EAAE;YACH,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC,EACD;YACE,IAAI,EAAE,SAAS,CAAC,eAAe;YAC/B,eAAe,EAAE,QAAQ,CAAC,OAAO;SAClC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,kBAAkB,GAA+C;IACrE,CAAC,EAAE,EAAE,SAAS,CAAC;IACf,CAAC,SAAS,EAAE,EAAE,CAAC;IACf,CAAC,SAAS,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,kBAAkB,EAAE,CAAC;IAC9C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,GAAG,EAAE;YACV,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACrD,cAAc,CACZ,GAAG,EAAE;QACH,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC,EACD;QACE,IAAI,EAAE,SAAS,CAAC,eAAe;QAC/B,eAAe,EAAE,yBAAyB;KAC3C,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/__tests__/security/filesystem-boundary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filesystem-boundary.test.d.ts.map

package/dist/__tests__/security/filesystem-boundary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-boundary.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/security/filesystem-boundary.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/security/filesystem-boundary.test.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fg from 'fast-glob';
+import { expect, it } from 'vitest';
+function getRepoRoot() {
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(currentDir, '../../../../');
+}
+function hasFsImport(source) {
+    return (/from\s+['"]node:fs\/promises['"]/u.test(source) ||
+        /from\s+['"]node:fs['"]/u.test(source));
+}
+function normalizeRelPath(relPath) {
+    return relPath.replace(/\\/gu, '/');
+}
+const ALLOWED_FS_IMPORT_FILES = new Set([
+    'src/server.ts',
+    'src/tools/list-allowed-dirs.ts',
+    'src/lib/path-validation.ts',
+    'src/lib/file-operations.ts',
+    'src/lib/fs-helpers.ts',
+]);
+const ALLOWED_FS_IMPORT_PREFIXES = [
+    'src/lib/path-validation/',
+    'src/lib/file-operations/',
+    'src/lib/fs-helpers/',
+];
+function isAllowedFsImportFile(relPath) {
+    const normalized = normalizeRelPath(relPath);
+    if (ALLOWED_FS_IMPORT_FILES.has(normalized))
+        return true;
+    return ALLOWED_FS_IMPORT_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+}
+async function listSourceFiles(repoRoot) {
+    return await fg(['src/**/*.ts'], {
+        cwd: repoRoot,
+        ignore: ['src/__tests__/**'],
+        onlyFiles: true,
+        dot: false,
+    });
+}
+async function collectFsImportOffenders(repoRoot, sourceFiles, allowFsImport) {
+    const offenders = [];
+    for (const relPath of sourceFiles) {
+        const absPath = path.join(repoRoot, relPath);
+        const content = await fs.readFile(absPath, 'utf-8');
+        if (!hasFsImport(content))
+            continue;
+        if (!allowFsImport(relPath)) {
+            offenders.push(relPath);
+        }
+    }
+    return offenders;
+}
+it('keeps direct node:fs imports inside boundary modules', async () => {
+    const repoRoot = getRepoRoot();
+    const sourceFiles = await listSourceFiles(repoRoot);
+    const offenders = await collectFsImportOffenders(repoRoot, sourceFiles, isAllowedFsImportFile);
+    expect(offenders, `Unexpected node:fs imports detected outside boundary modules. ` +
+        `To keep "validate-before-access" auditable, route filesystem access through ` +
+        `src/lib/file-operations.ts and src/lib/fs-helpers.ts (and validate paths in src/lib/path-validation.ts).`).toEqual([]);
+});
+//# sourceMappingURL=filesystem-boundary.test.js.map

package/dist/__tests__/security/filesystem-boundary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-boundary.test.js","sourceRoot":"","sources":["../../../src/__tests__/security/filesystem-boundary.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,SAAS,WAAW;IAClB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,CACL,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC;QAChD,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS;IAC9C,eAAe;IACf,gCAAgC;IAChC,4BAA4B;IAC5B,4BAA4B;IAC5B,uBAAuB;CACxB,CAAC,CAAC;AACH,MAAM,0BAA0B,GAAG;IACjC,0BAA0B;IAC1B,0BAA0B;IAC1B,qBAAqB;CACtB,CAAC;AAEF,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAChD,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,OAAO,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE;QAC/B,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,CAAC,kBAAkB,CAAC;QAC5B,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,QAAgB,EAChB,WAAqB,EACrB,aAA2C;IAE3C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACpE,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAC9C,QAAQ,EACR,WAAW,EACX,qBAAqB,CACtB,CAAC;IAEF,MAAM,CACJ,SAAS,EACT,gEAAgE;QAC9D,8EAA8E;QAC9E,0GAA0G,CAC7G,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/config/formatting.d.ts

@@ -0,0 +1,7 @@
+export declare function formatBytes(bytes: number): string;
+export declare function joinLines(lines: readonly string[]): string;
+export declare function formatOperationSummary(summary: {
+    truncated?: boolean;
+    truncatedReason?: string;
+}): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/config/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/config/formatting.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAGT"}

package/dist/config/formatting.js

@@ -0,0 +1,18 @@
+const BYTE_UNIT_LABELS = ['B', 'KB', 'MB', 'GB', 'TB'];
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const unitIndex = Math.floor(Math.log(bytes) / Math.log(1024));
+    const unit = BYTE_UNIT_LABELS[unitIndex] ?? 'B';
+    const value = bytes / Math.pow(1024, unitIndex);
+    return `${parseFloat(value.toFixed(2))} ${unit}`;
+}
+export function joinLines(lines) {
+    return lines.join('\n');
+}
+export function formatOperationSummary(summary) {
+    if (!summary.truncated)
+        return '';
+    return `\n[truncated: ${summary.truncatedReason ?? 'limit reached'}]`;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/config/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../src/config/formatting.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEhE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAwB;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAGtC;IACC,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,iBAAiB,OAAO,CAAC,eAAe,IAAI,eAAe,GAAG,CAAC;AACxE,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,111 @@
+export type FileType = 'file' | 'directory' | 'symlink' | 'other';
+export interface FileInfo {
+    readonly name: string;
+    readonly path: string;
+    readonly type: FileType;
+    readonly size: number;
+    readonly created: Date;
+    readonly modified: Date;
+    readonly accessed: Date;
+    readonly permissions: string;
+    readonly isHidden: boolean;
+    readonly mimeType?: string;
+    readonly symlinkTarget?: string;
+}
+export interface DirectoryEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly relativePath: string;
+    readonly type: FileType;
+    readonly size?: number;
+    readonly modified?: Date;
+    readonly symlinkTarget?: string;
+}
+export interface ListDirectoryResult {
+    readonly path: string;
+    readonly entries: readonly DirectoryEntry[];
+    readonly summary: {
+        readonly totalEntries: number;
+        readonly entriesScanned?: number;
+        readonly entriesVisible?: number;
+        readonly totalFiles: number;
+        readonly totalDirectories: number;
+        readonly maxDepthReached: number;
+        readonly truncated: boolean;
+        readonly stoppedReason?: 'maxEntries' | 'aborted';
+        readonly skippedInaccessible: number;
+        readonly symlinksNotFollowed: number;
+    };
+}
+export interface SearchResult {
+    readonly path: string;
+    readonly type: FileType;
+    readonly size?: number;
+    readonly modified?: Date;
+}
+export interface SearchFilesResult {
+    readonly basePath: string;
+    readonly pattern: string;
+    readonly results: readonly SearchResult[];
+    readonly summary: {
+        readonly matched: number;
+        readonly truncated: boolean;
+        readonly skippedInaccessible: number;
+        readonly filesScanned: number;
+        readonly stoppedReason?: 'maxResults' | 'maxFiles' | 'timeout';
+    };
+}
+export interface ContentMatch {
+    readonly file: string;
+    readonly line: number;
+    readonly content: string;
+    readonly contextBefore?: readonly string[];
+    readonly contextAfter?: readonly string[];
+    readonly matchCount: number;
+}
+export interface SearchContentResult {
+    readonly basePath: string;
+    readonly pattern: string;
+    readonly filePattern: string;
+    readonly matches: readonly ContentMatch[];
+    readonly summary: {
+        readonly filesScanned: number;
+        readonly filesMatched: number;
+        readonly matches: number;
+        readonly truncated: boolean;
+        readonly skippedTooLarge: number;
+        readonly skippedBinary: number;
+        readonly skippedInaccessible: number;
+        readonly linesSkippedDueToRegexTimeout: number;
+        readonly stoppedReason?: 'maxResults' | 'maxFiles' | 'timeout';
+    };
+}
+export interface MultipleFileInfoResult {
+    readonly path: string;
+    readonly info?: FileInfo;
+    readonly error?: string;
+}
+export interface GetMultipleFileInfoResult {
+    readonly results: readonly MultipleFileInfoResult[];
+    readonly summary: {
+        readonly total: number;
+        readonly succeeded: number;
+        readonly failed: number;
+        readonly totalSize: number;
+    };
+}
+export declare const ErrorCode: {
+    readonly E_ACCESS_DENIED: "E_ACCESS_DENIED";
+    readonly E_NOT_FOUND: "E_NOT_FOUND";
+    readonly E_NOT_FILE: "E_NOT_FILE";
+    readonly E_NOT_DIRECTORY: "E_NOT_DIRECTORY";
+    readonly E_TOO_LARGE: "E_TOO_LARGE";
+    readonly E_TIMEOUT: "E_TIMEOUT";
+    readonly E_INVALID_PATTERN: "E_INVALID_PATTERN";
+    readonly E_INVALID_INPUT: "E_INVALID_INPUT";
+    readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
+    readonly E_SYMLINK_NOT_ALLOWED: "E_SYMLINK_NOT_ALLOWED";
+    readonly E_UNKNOWN: "E_UNKNOWN";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/config/types.js

@@ -0,0 +1,14 @@
+export const ErrorCode = {
+    E_ACCESS_DENIED: 'E_ACCESS_DENIED',
+    E_NOT_FOUND: 'E_NOT_FOUND',
+    E_NOT_FILE: 'E_NOT_FILE',
+    E_NOT_DIRECTORY: 'E_NOT_DIRECTORY',
+    E_TOO_LARGE: 'E_TOO_LARGE',
+    E_TIMEOUT: 'E_TIMEOUT',
+    E_INVALID_PATTERN: 'E_INVALID_PATTERN',
+    E_INVALID_INPUT: 'E_INVALID_INPUT',
+    E_PERMISSION_DENIED: 'E_PERMISSION_DENIED',
+    E_SYMLINK_NOT_ALLOWED: 'E_SYMLINK_NOT_ALLOWED',
+    E_UNKNOWN: 'E_UNKNOWN',
+};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AA0GA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}