codepage-bridge-mcp 0.1.0

package/dist/src/media/types.d.ts

@@ -0,0 +1,14 @@
+export interface McpTextBlock {
+    type: "text";
+    text: string;
+}
+export interface McpImageBlock {
+    type: "image";
+    data: string;
+    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+}
+export type McpContentBlock = McpTextBlock | McpImageBlock;
+export type DecodeBytes = (bytes: Uint8Array) => string;
+export interface BinaryFileReader {
+    readFile(path: string): Promise<Uint8Array>;
+}

package/dist/src/media/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/media/types.js.map

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

package/dist/src/prompts.d.ts

@@ -0,0 +1,8 @@
+export declare const READ_DESCRIPTION = "Read a file from the local filesystem.";
+export declare const EDIT_DESCRIPTION = "Performs exact string replacements in files.";
+export declare const WRITE_DESCRIPTION = "Write a file to the local filesystem.";
+export declare const READ_PROMPT = "Reads a file from the local filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 2000 lines starting from the beginning of the file. Files larger than 256KB will return an error; use offset and limit for larger files\n- When you already know which part of the file you need, only read that part. This can be important for larger files.\n- Results are returned using cat -n format, with line numbers starting at 1\n- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.\n- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: \"1-5\"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.\n- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.\n- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.\n- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.\n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.";
+export declare const EDIT_PROMPT = "Performs exact string replacements in files.\n\nUsage:\n- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file.\n- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: line number + tab. Everything after that is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.\n- The edit will FAIL if `old_string` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.\n- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.";
+export declare const WRITE_PROMPT = "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- Prefer the Edit tool for modifying existing files \u2014 it only sends the diff. Only use this tool to create new files or for complete rewrites.\n- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.";
+export declare const GREP_DESCRIPTION = "A powerful search tool built on regular expressions.";
+export declare const GREP_PROMPT = "A powerful search tool for file contents.\n\nUsage:\n- ALWAYS use Grep for search tasks. NEVER invoke grep or rg as a Bash command.\n- Supports full regular expressions, file glob filters, file type filters, context lines, match-only output, multiline matching, pagination, file lists, and per-file counts.\n- Use output_mode=files_with_matches when you only need file paths; this is the default.\n- Use output_mode=content to see matching lines. Line numbers are included by default.\n- Use output_mode=count to see match counts per file.\n- Results are limited to 250 entries by default; use head_limit and offset for pagination.\n- Every file is decoded according to its nearest project .encoding-rules, so legacy encoded content is searched as Unicode transparently.";

package/dist/src/prompts.js

@@ -0,0 +1,46 @@
+export const READ_DESCRIPTION = 'Read a file from the local filesystem.';
+export const EDIT_DESCRIPTION = 'Performs exact string replacements in files.';
+export const WRITE_DESCRIPTION = 'Write a file to the local filesystem.';
+export const READ_PROMPT = `Reads a file from the local filesystem. You can access any file directly by using this tool.
+Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
+
+Usage:
+- The file_path parameter must be an absolute path, not a relative path
+- By default, it reads up to 2000 lines starting from the beginning of the file. Files larger than 256KB will return an error; use offset and limit for larger files
+- When you already know which part of the file you need, only read that part. This can be important for larger files.
+- Results are returned using cat -n format, with line numbers starting at 1
+- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
+- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
+- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
+- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
+- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
+- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.`;
+export const EDIT_PROMPT = `Performs exact string replacements in files.
+
+Usage:
+- You must use your \`Read\` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file.
+- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: line number + tab. Everything after that is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.
+- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
+- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.
+- The edit will FAIL if \`old_string\` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use \`replace_all\` to change every instance of \`old_string\`.
+- Use \`replace_all\` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.`;
+export const WRITE_PROMPT = `Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
+- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.`;
+export const GREP_DESCRIPTION = 'A powerful search tool built on regular expressions.';
+export const GREP_PROMPT = `A powerful search tool for file contents.
+
+Usage:
+- ALWAYS use Grep for search tasks. NEVER invoke grep or rg as a Bash command.
+- Supports full regular expressions, file glob filters, file type filters, context lines, match-only output, multiline matching, pagination, file lists, and per-file counts.
+- Use output_mode=files_with_matches when you only need file paths; this is the default.
+- Use output_mode=content to see matching lines. Line numbers are included by default.
+- Use output_mode=count to see match counts per file.
+- Results are limited to 250 entries by default; use head_limit and offset for pagination.
+- Every file is decoded according to its nearest project .encoding-rules, so legacy encoded content is searched as Unicode transparently.`;
+//# sourceMappingURL=prompts.js.map

package/dist/src/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,wCAAwC,CAAA;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,8CAA8C,CAAA;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,uCAAuC,CAAA;AAExE,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;8HAamG,CAAA;AAE9H,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;kJAQuH,CAAA;AAElJ,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;kGAOsE,CAAA;AAElG,MAAM,CAAC,MAAM,gBAAgB,GAAG,sDAAsD,CAAA;AACtF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;0IAS+G,CAAA"}

package/dist/src/schemas.d.ts

@@ -0,0 +1,138 @@
+export declare const readInputSchema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["file_path"];
+    readonly properties: {
+        readonly file_path: {
+            readonly type: "string";
+            readonly description: "The absolute path to the file to read";
+        };
+        readonly offset: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "The line number to start reading from. Only provide if the file is too large to read at once";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "The number of lines to read. Only provide if the file is too large to read at once.";
+        };
+        readonly pages: {
+            readonly type: "string";
+            readonly description: "Page range for PDF files (e.g., \"1-5\", \"3\", \"10-20\"). Only applicable to PDF files. Maximum 20 pages per request.";
+        };
+    };
+};
+export declare const editInputSchema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["file_path", "old_string", "new_string"];
+    readonly properties: {
+        readonly file_path: {
+            readonly type: "string";
+            readonly description: "The absolute path to the file to modify";
+        };
+        readonly old_string: {
+            readonly type: "string";
+            readonly description: "The text to replace";
+        };
+        readonly new_string: {
+            readonly type: "string";
+            readonly description: "The text to replace it with (must be different from old_string)";
+        };
+        readonly replace_all: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "Replace all occurrences of old_string (default false)";
+        };
+    };
+};
+export declare const writeInputSchema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["file_path", "content"];
+    readonly properties: {
+        readonly file_path: {
+            readonly type: "string";
+            readonly description: "The absolute path to the file to write (must be absolute, not relative)";
+        };
+        readonly content: {
+            readonly type: "string";
+            readonly description: "The content to write to the file";
+        };
+    };
+};
+export declare const grepInputSchema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["pattern"];
+    readonly properties: {
+        readonly pattern: {
+            readonly type: "string";
+            readonly description: "The regular expression pattern to search for in file contents";
+        };
+        readonly path: {
+            readonly type: "string";
+            readonly description: "File or directory to search. Defaults to the current working directory.";
+        };
+        readonly glob: {
+            readonly type: "string";
+            readonly description: "Glob pattern used to filter files, for example *.js or **/*.ts";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly description: "File type filter such as js, ts, py, rust, go, or java";
+        };
+        readonly output_mode: {
+            readonly type: "string";
+            readonly enum: readonly ["content", "files_with_matches", "count"];
+            readonly description: "Output mode. Defaults to files_with_matches.";
+        };
+        readonly '-i': {
+            readonly type: "boolean";
+            readonly description: "Case-insensitive search";
+        };
+        readonly '-n': {
+            readonly type: "boolean";
+            readonly description: "Show line numbers in content mode. Defaults to true.";
+        };
+        readonly '-o': {
+            readonly type: "boolean";
+            readonly description: "Print only matching non-empty parts of each line";
+        };
+        readonly '-A': {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Show lines after each match";
+        };
+        readonly '-B': {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Show lines before each match";
+        };
+        readonly '-C': {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Show lines before and after each match";
+        };
+        readonly context: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Alias for -C";
+        };
+        readonly multiline: {
+            readonly type: "boolean";
+            readonly description: "Enable multiline matching where dot also matches newlines";
+        };
+        readonly head_limit: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Limit returned lines or entries. Defaults to 250; 0 means unlimited.";
+        };
+        readonly offset: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Skip the first N result lines or entries";
+        };
+    };
+};

package/dist/src/schemas.js

@@ -0,0 +1,81 @@
+export const readInputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['file_path'],
+    properties: {
+        file_path: {
+            type: 'string',
+            description: 'The absolute path to the file to read',
+        },
+        offset: {
+            type: 'integer',
+            minimum: 0,
+            description: 'The line number to start reading from. Only provide if the file is too large to read at once',
+        },
+        limit: {
+            type: 'integer',
+            minimum: 1,
+            description: 'The number of lines to read. Only provide if the file is too large to read at once.',
+        },
+        pages: {
+            type: 'string',
+            description: 'Page range for PDF files (e.g., "1-5", "3", "10-20"). Only applicable to PDF files. Maximum 20 pages per request.',
+        },
+    },
+};
+export const editInputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['file_path', 'old_string', 'new_string'],
+    properties: {
+        file_path: {
+            type: 'string',
+            description: 'The absolute path to the file to modify',
+        },
+        old_string: { type: 'string', description: 'The text to replace' },
+        new_string: {
+            type: 'string',
+            description: 'The text to replace it with (must be different from old_string)',
+        },
+        replace_all: {
+            type: 'boolean',
+            default: false,
+            description: 'Replace all occurrences of old_string (default false)',
+        },
+    },
+};
+export const writeInputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['file_path', 'content'],
+    properties: {
+        file_path: {
+            type: 'string',
+            description: 'The absolute path to the file to write (must be absolute, not relative)',
+        },
+        content: { type: 'string', description: 'The content to write to the file' },
+    },
+};
+export const grepInputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['pattern'],
+    properties: {
+        pattern: { type: 'string', description: 'The regular expression pattern to search for in file contents' },
+        path: { type: 'string', description: 'File or directory to search. Defaults to the current working directory.' },
+        glob: { type: 'string', description: 'Glob pattern used to filter files, for example *.js or **/*.ts' },
+        type: { type: 'string', description: 'File type filter such as js, ts, py, rust, go, or java' },
+        output_mode: { type: 'string', enum: ['content', 'files_with_matches', 'count'], description: 'Output mode. Defaults to files_with_matches.' },
+        '-i': { type: 'boolean', description: 'Case-insensitive search' },
+        '-n': { type: 'boolean', description: 'Show line numbers in content mode. Defaults to true.' },
+        '-o': { type: 'boolean', description: 'Print only matching non-empty parts of each line' },
+        '-A': { type: 'integer', minimum: 0, description: 'Show lines after each match' },
+        '-B': { type: 'integer', minimum: 0, description: 'Show lines before each match' },
+        '-C': { type: 'integer', minimum: 0, description: 'Show lines before and after each match' },
+        context: { type: 'integer', minimum: 0, description: 'Alias for -C' },
+        multiline: { type: 'boolean', description: 'Enable multiline matching where dot also matches newlines' },
+        head_limit: { type: 'integer', minimum: 0, description: 'Limit returned lines or entries. Defaults to 250; 0 means unlimited.' },
+        offset: { type: 'integer', minimum: 0, description: 'Skip the first N result lines or entries' }
+    }
+};
+//# sourceMappingURL=schemas.js.map

package/dist/src/schemas.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare const toolDefinitions: readonly [{
+    readonly name: "Read";
+    readonly title: "Read a file from the local filesystem.";
+    readonly description: "Reads a file from the local filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 2000 lines starting from the beginning of the file. Files larger than 256KB will return an error; use offset and limit for larger files\n- When you already know which part of the file you need, only read that part. This can be important for larger files.\n- Results are returned using cat -n format, with line numbers starting at 1\n- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.\n- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: \"1-5\"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.\n- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.\n- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.\n- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.\n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["file_path"];
+        readonly properties: {
+            readonly file_path: {
+                readonly type: "string";
+                readonly description: "The absolute path to the file to read";
+            };
+            readonly offset: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "The line number to start reading from. Only provide if the file is too large to read at once";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly description: "The number of lines to read. Only provide if the file is too large to read at once.";
+            };
+            readonly pages: {
+                readonly type: "string";
+                readonly description: "Page range for PDF files (e.g., \"1-5\", \"3\", \"10-20\"). Only applicable to PDF files. Maximum 20 pages per request.";
+            };
+        };
+    };
+}, {
+    readonly name: "Edit";
+    readonly title: "Performs exact string replacements in files.";
+    readonly description: "Performs exact string replacements in files.\n\nUsage:\n- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file.\n- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: line number + tab. Everything after that is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.\n- The edit will FAIL if `old_string` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.\n- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["file_path", "old_string", "new_string"];
+        readonly properties: {
+            readonly file_path: {
+                readonly type: "string";
+                readonly description: "The absolute path to the file to modify";
+            };
+            readonly old_string: {
+                readonly type: "string";
+                readonly description: "The text to replace";
+            };
+            readonly new_string: {
+                readonly type: "string";
+                readonly description: "The text to replace it with (must be different from old_string)";
+            };
+            readonly replace_all: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Replace all occurrences of old_string (default false)";
+            };
+        };
+    };
+}, {
+    readonly name: "Write";
+    readonly title: "Write a file to the local filesystem.";
+    readonly description: "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.\n- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["file_path", "content"];
+        readonly properties: {
+            readonly file_path: {
+                readonly type: "string";
+                readonly description: "The absolute path to the file to write (must be absolute, not relative)";
+            };
+            readonly content: {
+                readonly type: "string";
+                readonly description: "The content to write to the file";
+            };
+        };
+    };
+}, {
+    readonly name: "Grep";
+    readonly title: "A powerful search tool built on regular expressions.";
+    readonly description: "A powerful search tool for file contents.\n\nUsage:\n- ALWAYS use Grep for search tasks. NEVER invoke grep or rg as a Bash command.\n- Supports full regular expressions, file glob filters, file type filters, context lines, match-only output, multiline matching, pagination, file lists, and per-file counts.\n- Use output_mode=files_with_matches when you only need file paths; this is the default.\n- Use output_mode=content to see matching lines. Line numbers are included by default.\n- Use output_mode=count to see match counts per file.\n- Results are limited to 250 entries by default; use head_limit and offset for pagination.\n- Every file is decoded according to its nearest project .encoding-rules, so legacy encoded content is searched as Unicode transparently.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["pattern"];
+        readonly properties: {
+            readonly pattern: {
+                readonly type: "string";
+                readonly description: "The regular expression pattern to search for in file contents";
+            };
+            readonly path: {
+                readonly type: "string";
+                readonly description: "File or directory to search. Defaults to the current working directory.";
+            };
+            readonly glob: {
+                readonly type: "string";
+                readonly description: "Glob pattern used to filter files, for example *.js or **/*.ts";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly description: "File type filter such as js, ts, py, rust, go, or java";
+            };
+            readonly output_mode: {
+                readonly type: "string";
+                readonly enum: readonly ["content", "files_with_matches", "count"];
+                readonly description: "Output mode. Defaults to files_with_matches.";
+            };
+            readonly '-i': {
+                readonly type: "boolean";
+                readonly description: "Case-insensitive search";
+            };
+            readonly '-n': {
+                readonly type: "boolean";
+                readonly description: "Show line numbers in content mode. Defaults to true.";
+            };
+            readonly '-o': {
+                readonly type: "boolean";
+                readonly description: "Print only matching non-empty parts of each line";
+            };
+            readonly '-A': {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Show lines after each match";
+            };
+            readonly '-B': {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Show lines before each match";
+            };
+            readonly '-C': {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Show lines before and after each match";
+            };
+            readonly context: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Alias for -C";
+            };
+            readonly multiline: {
+                readonly type: "boolean";
+                readonly description: "Enable multiline matching where dot also matches newlines";
+            };
+            readonly head_limit: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Limit returned lines or entries. Defaults to 250; 0 means unlimited.";
+            };
+            readonly offset: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Skip the first N result lines or entries";
+            };
+        };
+    };
+}];
+export declare function createServer(): Server;
+export declare function main(): Promise<void>;

package/dist/src/server.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'node:url';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { EDIT_DESCRIPTION, EDIT_PROMPT, GREP_DESCRIPTION, GREP_PROMPT, READ_DESCRIPTION, READ_PROMPT, WRITE_DESCRIPTION, WRITE_PROMPT, } from './prompts.js';
+import { editInputSchema, grepInputSchema, readInputSchema, writeInputSchema, } from './schemas.js';
+import { executeEdit, parseEditInput } from './tools/edit.js';
+import { executeGrep, parseGrepInput } from './tools/grep.js';
+import { executeRead, parseReadInput } from './tools/read.js';
+import { executeWrite, parseWriteInput } from './tools/write.js';
+export const toolDefinitions = [
+    {
+        name: 'Read',
+        title: READ_DESCRIPTION,
+        description: READ_PROMPT,
+        inputSchema: readInputSchema,
+    },
+    {
+        name: 'Edit',
+        title: EDIT_DESCRIPTION,
+        description: EDIT_PROMPT,
+        inputSchema: editInputSchema,
+    },
+    {
+        name: 'Write',
+        title: WRITE_DESCRIPTION,
+        description: WRITE_PROMPT,
+        inputSchema: writeInputSchema,
+    }, {
+        name: 'Grep',
+        title: GREP_DESCRIPTION,
+        description: GREP_PROMPT,
+        inputSchema: grepInputSchema,
+    },
+];
+async function dispatch(name, input) {
+    switch (name) {
+        case 'Read':
+            return executeRead(parseReadInput(input));
+        case 'Edit':
+            return executeEdit(parseEditInput(input));
+        case 'Write':
+            return executeWrite(parseWriteInput(input));
+        case 'Grep':
+            return executeGrep(parseGrepInput(input));
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+function toCallToolResult(response) {
+    return {
+        content: response.content,
+        ...(response.isError === undefined ? {} : { isError: response.isError }),
+        ...(response.structuredContent === undefined ? {} : { structuredContent: response.structuredContent }),
+    };
+}
+export function createServer() {
+    const server = new Server({ name: 'codepage-bridge', version: '0.1.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...toolDefinitions] }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            return toCallToolResult(await dispatch(request.params.name, request.params.arguments ?? {}));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `<tool_use_error>${message}</tool_use_error>` }],
+            };
+        }
+    });
+    return server;
+}
+export async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    let closing = false;
+    const close = async () => {
+        if (closing)
+            return;
+        closing = true;
+        await server.close();
+    };
+    process.stdin.on('end', () => void close());
+    process.stdin.on('error', error => {
+        console.error(error);
+        void close();
+    });
+    await server.connect(transport);
+}
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+    main().catch(error => {
+        console.error(error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/toolTypes.d.ts

@@ -0,0 +1,31 @@
+export interface ReadInput {
+    file_path: string;
+    offset?: number;
+    limit?: number;
+    pages?: string;
+}
+export interface EditInput {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+}
+export interface WriteInput {
+    file_path: string;
+    content: string;
+}
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+export type ToolContent = TextContent | ImageContent;
+export interface ToolResponse {
+    content: ToolContent[];
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+}

package/dist/src/toolTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolTypes.js.map

package/dist/src/toolTypes.js.map

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

package/dist/src/tools/edit.d.ts

@@ -0,0 +1,3 @@
+import type { EditInput, ToolResponse } from '../toolTypes.js';
+export declare function parseEditInput(value: unknown): EditInput;
+export declare function executeEdit(input: EditInput): Promise<ToolResponse>;