@j0hanz/fs-context-mcp 2.0.6 → 2.1.0

package/dist/lib/strict-stdio-transport.js

@@ -0,0 +1,158 @@
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function getMethod(value) {
+    if (!isObject(value))
+        return undefined;
+    const { method } = value;
+    return typeof method === 'string' ? method : undefined;
+}
+function parseId(value) {
+    if (!isObject(value) || !('id' in value)) {
+        return { value: null, isValid: false };
+    }
+    const { id } = value;
+    if (typeof id === 'string' || typeof id === 'number' || id === null) {
+        return { value: id, isValid: true };
+    }
+    return { value: null, isValid: false };
+}
+function isRequest(value) {
+    if (!isObject(value))
+        return false;
+    const { id } = value;
+    return typeof id === 'string' || typeof id === 'number';
+}
+/**
+ * Strict stdio transport wrapper that:
+ * - Rejects JSON-RPC batch payloads (arrays) with a JSON-RPC error
+ * - Enforces lifecycle: `initialize` must be the first request
+ *
+ * This addresses interoperability issues where some clients send malformed input
+ * (batches) or where SDKs do not strictly enforce initialization ordering.
+ */
+export class StrictStdioServerTransport {
+    stdin;
+    stdout;
+    started = false;
+    buffer = '';
+    seenInitializeRequest = false;
+    onmessage;
+    onerror;
+    onclose;
+    constructor(stdin, stdout) {
+        this.stdin = stdin ?? process.stdin;
+        this.stdout = stdout ?? process.stdout;
+    }
+    start() {
+        if (this.started) {
+            throw new Error('StrictStdioServerTransport already started');
+        }
+        this.started = true;
+        this.stdin.on('data', this.onData);
+        this.stdin.on('error', this.onError);
+        return Promise.resolve();
+    }
+    close() {
+        this.stdin.off('data', this.onData);
+        this.stdin.off('error', this.onError);
+        this.buffer = '';
+        this.onclose?.();
+        return Promise.resolve();
+    }
+    async send(message) {
+        const json = `${JSON.stringify(message)}\n`;
+        await new Promise((resolve) => {
+            if (this.stdout.write(json, 'utf8')) {
+                resolve();
+            }
+            else {
+                this.stdout.once('drain', () => {
+                    resolve();
+                });
+            }
+        });
+    }
+    onData = (chunk) => {
+        this.buffer +=
+            typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+        this.processBuffer();
+    };
+    onError = (error) => {
+        this.onerror?.(error);
+    };
+    async sendJsonRpcError(id, code, message, extra) {
+        const payload = {
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code,
+                message,
+                ...(extra?.data !== undefined ? { data: extra.data } : {}),
+            },
+        };
+        try {
+            await this.send(payload);
+        }
+        catch (sendError) {
+            this.onerror?.(sendError instanceof Error ? sendError : new Error(String(sendError)));
+        }
+    }
+    processBuffer() {
+        while (this.buffer.length > 0) {
+            const newlineIndex = this.buffer.indexOf('\n');
+            if (newlineIndex < 0)
+                return;
+            const rawLine = this.buffer.slice(0, newlineIndex);
+            this.buffer = this.buffer.slice(newlineIndex + 1);
+            const line = rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine;
+            if (line.trim().length === 0)
+                continue;
+            void this.processLine(line);
+        }
+    }
+    async processLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await this.sendJsonRpcError(null, -32700, 'Parse error', { data: message });
+            return;
+        }
+        await this.handleIncomingMessage(parsed);
+    }
+    async handleIncomingMessage(message) {
+        // JSON-RPC batching is not supported in MCP 2025-06-18+.
+        if (Array.isArray(message)) {
+            await this.sendJsonRpcError(null, -32600, 'Invalid Request');
+            return;
+        }
+        if (!isObject(message)) {
+            await this.sendJsonRpcError(null, -32600, 'Invalid Request');
+            return;
+        }
+        const method = getMethod(message);
+        if (!method) {
+            await this.sendJsonRpcError(parseId(message).value, -32600, 'Invalid Request');
+            return;
+        }
+        if (!this.seenInitializeRequest) {
+            if (method !== 'initialize') {
+                if (isRequest(message)) {
+                    const { value: id } = parseId(message);
+                    const responseId = typeof id === 'string' || typeof id === 'number' ? id : null;
+                    await this.sendJsonRpcError(responseId, -32000, 'Bad Request: Server not initialized');
+                }
+                // For notifications before initialize, we cannot respond; ignore.
+                return;
+            }
+            // `initialize` must be first; mark after we accept it.
+            this.seenInitializeRequest = true;
+        }
+        // Forward valid messages to the SDK server.
+        this.onmessage?.(message);
+    }
+}
+//# sourceMappingURL=strict-stdio-transport.js.map

package/dist/lib/strict-stdio-transport.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ResourceStore } from './lib/resource-store.js';
+export declare function registerInstructionResource(server: McpServer, instructions: string): void;
+export declare function registerResultResources(server: McpServer, store: ResourceStore): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,IAAI,CAmBN;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,GACnB,IAAI,CA6BN"}

package/dist/resources.js

@@ -0,0 +1,43 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ErrorCode, McpError } from './lib/errors.js';
+const RESULT_TEMPLATE = new ResourceTemplate('fs-context://result/{id}', {
+    list: undefined,
+});
+export function registerInstructionResource(server, instructions) {
+    server.registerResource('fs-context-instructions', 'internal://instructions', {
+        title: 'Server Instructions',
+        description: 'Guidance for using the fs-context MCP tools effectively.',
+        mimeType: 'text/markdown',
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'text/markdown',
+                text: instructions,
+            },
+        ],
+    }));
+}
+export function registerResultResources(server, store) {
+    server.registerResource('fs-context-result', RESULT_TEMPLATE, {
+        title: 'Cached Tool Result',
+        description: 'Ephemeral cached tool output exposed as an MCP resource. Not guaranteed to be listed via resources/list.',
+        mimeType: 'text/plain',
+    }, (uri, variables) => {
+        const { id } = variables;
+        if (typeof id !== 'string' || id.length === 0) {
+            throw new McpError(ErrorCode.E_INVALID_INPUT, 'Missing resource id');
+        }
+        const entry = store.getText(uri.toString());
+        return {
+            contents: [
+                {
+                    uri: entry.uri,
+                    mimeType: entry.mimeType,
+                    text: entry.text,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGtD,MAAM,eAAe,GAAG,IAAI,gBAAgB,CAAC,0BAA0B,EAAE;IACvE,IAAI,EAAE,SAAS;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,MAAiB,EACjB,YAAoB;IAEpB,MAAM,CAAC,gBAAgB,CACrB,yBAAyB,EACzB,yBAAyB,EACzB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,eAAe;KAC1B,EACD,CAAC,GAAG,EAAsB,EAAE,CAAC,CAAC;QAC5B,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,YAAY;aACnB;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,KAAoB;IAEpB,MAAM,CAAC,gBAAgB,CACrB,mBAAmB,EACnB,eAAe,EACf;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,0GAA0G;QAC5G,QAAQ,EAAE,YAAY;KACvB,EACD,CAAC,GAAG,EAAE,SAAS,EAAsB,EAAE;QACrC,MAAM,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC;QACzB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE5C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/schemas.d.ts

@@ -1,4 +1,16 @@
 import { z } from 'zod';
+declare const TreeEntryTypeSchema: z.ZodEnum<{
+    file: "file";
+    directory: "directory";
+    symlink: "symlink";
+    other: "other";
+}>;
+interface TreeEntry {
+    name: string;
+    type: z.infer<typeof TreeEntryTypeSchema>;
+    relativePath: string;
+    children?: TreeEntry[] | undefined;
+}
 export declare const ListDirectoryInputSchema: z.ZodObject<{
     path: z.ZodOptional<z.ZodString>;
     includeHidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -10,6 +22,13 @@ export declare const SearchFilesInputSchema: z.ZodObject<{
     maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     includeIgnored: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strict>;
+export declare const TreeInputSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxEntries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeHidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeIgnored: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strict>;
 export declare const SearchContentInputSchema: z.ZodObject<{
     path: z.ZodOptional<z.ZodString>;
     pattern: z.ZodString;
@@ -18,10 +37,14 @@ export declare const SearchContentInputSchema: z.ZodObject<{
 export declare const ReadFileInputSchema: z.ZodObject<{
     path: z.ZodString;
     head: z.ZodOptional<z.ZodInt>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const ReadMultipleFilesInputSchema: z.ZodObject<{
     paths: z.ZodArray<z.ZodString>;
     head: z.ZodOptional<z.ZodInt>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const GetFileInfoInputSchema: z.ZodObject<{
     path: z.ZodString;
@@ -63,32 +86,49 @@ export declare const ListDirectoryOutputSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const SearchFilesOutputSchema: z.ZodObject<{
+    totalMatches: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    resourceUri: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     ok: z.ZodBoolean;
     results: z.ZodOptional<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         size: z.ZodOptional<z.ZodNumber>;
         modified: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const SearchContentOutputSchema: z.ZodObject<{
     totalMatches: z.ZodOptional<z.ZodNumber>;
     truncated: z.ZodOptional<z.ZodBoolean>;
+    resourceUri: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodString>;
         suggestion: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const SearchContentOutputSchema: z.ZodObject<{
     ok: z.ZodBoolean;
     matches: z.ZodOptional<z.ZodArray<z.ZodObject<{
         file: z.ZodString;
         line: z.ZodNumber;
         content: z.ZodString;
+        matchCount: z.ZodNumber;
         contextBefore: z.ZodOptional<z.ZodArray<z.ZodString>>;
         contextAfter: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
-    totalMatches: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const TreeOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    root: z.ZodOptional<z.ZodString>;
+    tree: z.ZodOptional<z.ZodType<TreeEntry, unknown, z.core.$ZodTypeInternals<TreeEntry, unknown>>>;
+    ascii: z.ZodOptional<z.ZodString>;
     truncated: z.ZodOptional<z.ZodBoolean>;
+    totalEntries: z.ZodOptional<z.ZodNumber>;
     error: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
@@ -97,11 +137,22 @@ export declare const SearchContentOutputSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const ReadFileOutputSchema: z.ZodObject<{
-    ok: z.ZodBoolean;
-    path: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodString>;
     truncated: z.ZodOptional<z.ZodBoolean>;
+    resourceUri: z.ZodOptional<z.ZodString>;
     totalLines: z.ZodOptional<z.ZodNumber>;
+    readMode: z.ZodOptional<z.ZodEnum<{
+        head: "head";
+        full: "full";
+        range: "range";
+    }>>;
+    head: z.ZodOptional<z.ZodNumber>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    linesRead: z.ZodOptional<z.ZodNumber>;
+    hasMoreLines: z.ZodOptional<z.ZodBoolean>;
+    ok: z.ZodBoolean;
+    path: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
@@ -112,9 +163,21 @@ export declare const ReadFileOutputSchema: z.ZodObject<{
 export declare const ReadMultipleFilesOutputSchema: z.ZodObject<{
     ok: z.ZodBoolean;
     results: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
         content: z.ZodOptional<z.ZodString>;
         truncated: z.ZodOptional<z.ZodBoolean>;
+        resourceUri: z.ZodOptional<z.ZodString>;
+        totalLines: z.ZodOptional<z.ZodNumber>;
+        readMode: z.ZodOptional<z.ZodEnum<{
+            head: "head";
+            full: "full";
+            range: "range";
+        }>>;
+        head: z.ZodOptional<z.ZodNumber>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        linesRead: z.ZodOptional<z.ZodNumber>;
+        hasMoreLines: z.ZodOptional<z.ZodBoolean>;
+        path: z.ZodString;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     summary: z.ZodOptional<z.ZodObject<{
@@ -141,11 +204,12 @@ export declare const GetFileInfoOutputSchema: z.ZodObject<{
             other: "other";
         }>;
         size: z.ZodNumber;
-        created: z.ZodOptional<z.ZodString>;
+        tokenEstimate: z.ZodOptional<z.ZodNumber>;
+        created: z.ZodString;
         modified: z.ZodString;
-        accessed: z.ZodOptional<z.ZodString>;
+        accessed: z.ZodString;
         permissions: z.ZodString;
-        isHidden: z.ZodOptional<z.ZodBoolean>;
+        isHidden: z.ZodBoolean;
         mimeType: z.ZodOptional<z.ZodString>;
         symlinkTarget: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -170,11 +234,12 @@ export declare const GetMultipleFileInfoOutputSchema: z.ZodObject<{
                 other: "other";
             }>;
             size: z.ZodNumber;
-            created: z.ZodOptional<z.ZodString>;
+            tokenEstimate: z.ZodOptional<z.ZodNumber>;
+            created: z.ZodString;
             modified: z.ZodString;
-            accessed: z.ZodOptional<z.ZodString>;
+            accessed: z.ZodString;
             permissions: z.ZodString;
-            isHidden: z.ZodOptional<z.ZodBoolean>;
+            isHidden: z.ZodBoolean;
             mimeType: z.ZodOptional<z.ZodString>;
             symlinkTarget: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
@@ -192,4 +257,5 @@ export declare const GetMultipleFileInfoOutputSchema: z.ZodObject<{
         suggestion: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export {};
 //# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqDxB,eAAO,MAAM,wBAAwB;;;kBAanC,CAAC;AAEH,eAAO,MAAM,iCAAiC,iCAEX,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;kBA+CjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;kBAoBnC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;kBAW9B,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;kBAUvC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;kBAQjC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;kBASzC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;iBAI7C,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;iBAgBpC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAclC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAgBpC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAO/B,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;iBAcxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa1C,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,mBAAmB;;;;;EAAoD,CAAC;AAE9E,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CACpC;AAuGD,eAAO,MAAM,wBAAwB;;;kBAanC,CAAC;AAEH,eAAO,MAAM,iCAAiC,iCAEX,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;kBA+CjC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;kBAoC1B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;kBAoBnC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;kBAiBC,CAAC;AAElC,eAAO,MAAM,4BAA4B;;;;;kBAgBR,CAAC;AAElC,eAAO,MAAM,sBAAsB;;kBAQjC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;kBASzC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;iBAI7C,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;iBAgBpC,CAAC;AASH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;iBAWlC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;iBAcpC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAQ3B,CAAC;AAeH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAOH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa1C,CAAC"}

package/dist/schemas.js

@@ -12,6 +12,13 @@ function isSafeGlobPattern(value) {
     return true;
 }
 const FileTypeSchema = z.enum(['file', 'directory', 'symlink', 'other']);
+const TreeEntryTypeSchema = z.enum(['file', 'directory', 'symlink', 'other']);
+const TreeEntrySchema = z.lazy(() => z.object({
+    name: z.string(),
+    type: TreeEntryTypeSchema,
+    relativePath: z.string(),
+    children: z.array(TreeEntrySchema).optional(),
+}));
 const ErrorSchema = z.object({
     code: z.string().describe('Error code (e.g., E_NOT_FOUND)'),
     message: z.string().describe('Human-readable error message'),
@@ -24,16 +31,52 @@ const HeadLinesSchema = z
     .max(100000, 'head cannot exceed 100,000 lines')
     .optional()
     .describe('Read only the first N lines');
+const LineNumberSchema = z
+    .number()
+    .int({ error: 'line numbers must be integers' })
+    .min(1, 'line numbers must be at least 1');
+const validateReadRange = (value, ctx) => {
+    const hasHead = value.head !== undefined;
+    const hasStart = value.startLine !== undefined;
+    const hasEnd = value.endLine !== undefined;
+    if (hasHead && (hasStart || hasEnd)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['head'],
+            message: 'head cannot be used together with startLine/endLine',
+        });
+    }
+    if (hasEnd && !hasStart) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['endLine'],
+            message: 'endLine requires startLine',
+        });
+    }
+    if (value.startLine !== undefined &&
+        value.endLine !== undefined &&
+        value.endLine < value.startLine) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['endLine'],
+            message: 'endLine must be greater than or equal to startLine',
+        });
+    }
+};
 const FileInfoSchema = z.object({
     name: z.string(),
     path: z.string(),
     type: FileTypeSchema,
     size: z.number(),
-    created: z.string().optional(),
+    tokenEstimate: z
+        .number()
+        .optional()
+        .describe('Approximate token count estimate (rule of thumb: ceil(size/4))'),
+    created: z.string(),
     modified: z.string(),
-    accessed: z.string().optional(),
+    accessed: z.string(),
     permissions: z.string(),
-    isHidden: z.boolean().optional(),
+    isHidden: z.boolean(),
     mimeType: z.string().optional(),
     symlinkTarget: z.string().optional(),
 });
@@ -42,6 +85,11 @@ const OperationSummarySchema = z.object({
     succeeded: z.number(),
     failed: z.number(),
 });
+const ReadRangeInputSchema = z.strictObject({
+    head: HeadLinesSchema,
+    startLine: LineNumberSchema.optional(),
+    endLine: LineNumberSchema.optional(),
+});
 export const ListDirectoryInputSchema = z.strictObject({
     path: z
         .string()
@@ -96,6 +144,39 @@ export const SearchFilesInputSchema = z.strictObject({
         .describe('Include normally ignored directories (node_modules, dist, .git, etc). ' +
         'Set to true when debugging in dependencies.'),
 });
+export const TreeInputSchema = z.strictObject({
+    path: z
+        .string()
+        .optional()
+        .describe('Base directory to render as a tree (leave empty for workspace root). Examples: "src", "lib"'),
+    maxDepth: z
+        .number()
+        .int({ error: 'maxDepth must be an integer' })
+        .min(0, 'maxDepth must be at least 0')
+        .max(50, 'maxDepth cannot exceed 50')
+        .optional()
+        .default(5)
+        .describe('Maximum depth to recurse (0 = just the root)'),
+    maxEntries: z
+        .number()
+        .int({ error: 'maxEntries must be an integer' })
+        .min(1, 'maxEntries must be at least 1')
+        .max(20000, 'maxEntries cannot exceed 20,000')
+        .optional()
+        .default(1000)
+        .describe('Maximum number of entries to return before truncating'),
+    includeHidden: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include hidden files and directories'),
+    includeIgnored: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Include normally ignored directories (node_modules, dist, .git, etc). ' +
+        'When true, also disables root .gitignore filtering.'),
+});
 export const SearchContentInputSchema = z.strictObject({
     path: z
         .string()
@@ -113,15 +194,17 @@ export const SearchContentInputSchema = z.strictObject({
         .default(false)
         .describe('Include hidden files and directories'),
 });
-export const ReadFileInputSchema = z.strictObject({
+export const ReadFileInputSchema = ReadRangeInputSchema.extend({
     path: z
         .string()
         .min(1, 'Path cannot be empty')
         .describe('Path to the file to read. ' +
         'Examples: "README.md", "src/index.ts", "package.json"'),
     head: HeadLinesSchema.describe('Read only the first N lines of the file (useful for previewing large files)'),
-});
-export const ReadMultipleFilesInputSchema = z.strictObject({
+    startLine: LineNumberSchema.optional().describe('1-based line number to start reading from (inclusive). Useful for reading context around a match.'),
+    endLine: LineNumberSchema.optional().describe('1-based line number to stop reading at (inclusive). Requires startLine.'),
+}).superRefine(validateReadRange);
+export const ReadMultipleFilesInputSchema = ReadRangeInputSchema.extend({
     paths: z
         .array(z.string().min(1, 'Path cannot be empty'))
         .min(1, 'At least one path is required')
@@ -129,7 +212,9 @@ export const ReadMultipleFilesInputSchema = z.strictObject({
         .describe('Array of file paths to read. ' +
         'Examples: ["README.md", "package.json"], ["src/index.ts", "src/server.ts"]'),
     head: HeadLinesSchema.describe('Read only the first N lines of each file'),
-});
+    startLine: LineNumberSchema.optional().describe('1-based line number to start reading from (inclusive), applied to each file.'),
+    endLine: LineNumberSchema.optional().describe('1-based line number to stop reading at (inclusive), applied to each file. Requires startLine.'),
+}).superRefine(validateReadRange);
 export const GetFileInfoInputSchema = z.strictObject({
     path: z
         .string()
@@ -165,7 +250,13 @@ export const ListDirectoryOutputSchema = z.object({
     totalEntries: z.number().optional(),
     error: ErrorSchema.optional(),
 });
-export const SearchFilesOutputSchema = z.object({
+const SearchSummarySchema = z.object({
+    totalMatches: z.number().optional(),
+    truncated: z.boolean().optional(),
+    resourceUri: z.string().optional(),
+    error: ErrorSchema.optional(),
+});
+export const SearchFilesOutputSchema = SearchSummarySchema.extend({
     ok: z.boolean(),
     results: z
         .array(z.object({
@@ -174,43 +265,53 @@ export const SearchFilesOutputSchema = z.object({
         modified: z.string().optional(),
     }))
         .optional(),
-    totalMatches: z.number().optional(),
-    truncated: z.boolean().optional(),
-    error: ErrorSchema.optional(),
 });
-export const SearchContentOutputSchema = z.object({
+export const SearchContentOutputSchema = SearchSummarySchema.extend({
     ok: z.boolean(),
     matches: z
         .array(z.object({
         file: z.string().describe('Relative path from search base'),
         line: z.number(),
         content: z.string(),
+        matchCount: z.number(),
         contextBefore: z.array(z.string()).optional(),
         contextAfter: z.array(z.string()).optional(),
     }))
         .optional(),
-    totalMatches: z.number().optional(),
+});
+export const TreeOutputSchema = z.object({
+    ok: z.boolean(),
+    root: z.string().optional(),
+    tree: TreeEntrySchema.optional(),
+    ascii: z.string().optional(),
     truncated: z.boolean().optional(),
+    totalEntries: z.number().optional(),
     error: ErrorSchema.optional(),
 });
-export const ReadFileOutputSchema = z.object({
-    ok: z.boolean(),
-    path: z.string().optional(),
+const ReadResultSchema = z.object({
     content: z.string().optional(),
     truncated: z.boolean().optional(),
+    resourceUri: z.string().optional(),
     totalLines: z.number().optional(),
+    readMode: z.enum(['full', 'head', 'range']).optional(),
+    head: z.number().optional(),
+    startLine: z.number().optional(),
+    endLine: z.number().optional(),
+    linesRead: z.number().optional(),
+    hasMoreLines: z.boolean().optional(),
+});
+export const ReadFileOutputSchema = ReadResultSchema.extend({
+    ok: z.boolean(),
+    path: z.string().optional(),
     error: ErrorSchema.optional(),
 });
+const ReadMultipleFileResultSchema = ReadResultSchema.extend({
+    path: z.string(),
+    error: z.string().optional(),
+});
 export const ReadMultipleFilesOutputSchema = z.object({
     ok: z.boolean(),
-    results: z
-        .array(z.object({
-        path: z.string(),
-        content: z.string().optional(),
-        truncated: z.boolean().optional(),
-        error: z.string().optional(),
-    }))
-        .optional(),
+    results: z.array(ReadMultipleFileResultSchema).optional(),
     summary: OperationSummarySchema.optional(),
     error: ErrorSchema.optional(),
 });