claude-code-workflow 6.3.53 → 7.0.0

package/ccw/dist/tools/read-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA0B/D,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyKD,eAAO,MAAM,MAAM,EAAE,UA2DpB,CAAC;AAGF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CA8H9F"}
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI/D,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAUjC,eAAO,MAAM,MAAM,EAAE,UA8BpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CA+C9F"}

package/ccw/dist/tools/read-file.js

@@ -1,327 +1,89 @@
 /**
- * Read File Tool - Read files with multi-file, directory, and regex support
+ * Read File Tool - Single file precise reading with optional line pagination
  *
  * Features:
- * - Read single or multiple files
- * - Read all files in a directory (with depth control)
- * - Filter files by glob/regex pattern
- * - Content search with regex
- * - Compact output format
+ * - Read a single file with full content
+ * - Line-based pagination with offset/limit
+ * - Binary file detection
  */
 import { z } from 'zod';
-import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
-import { join, relative, extname } from 'path';
+import { existsSync, statSync } from 'fs';
+import { relative } from 'path';
 import { validatePath, getProjectRoot } from '../utils/path-validator.js';
-// Max content per file (truncate if larger)
-const MAX_CONTENT_LENGTH = 5000;
-// Max files to return
-const MAX_FILES = 50;
-// Max total content length
-const MAX_TOTAL_CONTENT = 50000;
-// Define Zod schema for validation
+import { MAX_CONTENT_LENGTH, readFileContent, } from '../utils/file-reader.js';
 const ParamsSchema = z.object({
-    paths: z.union([z.string(), z.array(z.string())]).describe('File path(s) or directory'),
-    pattern: z.string().optional().describe('Glob pattern to filter files (e.g., "*.ts", "**/*.js")'),
-    contentPattern: z.string().optional().describe('Regex to search within file content'),
-    maxDepth: z.number().default(3).describe('Max directory depth to traverse'),
-    includeContent: z.boolean().default(true).describe('Include file content in result'),
-    maxFiles: z.number().default(MAX_FILES).describe('Max number of files to return'),
-    offset: z.number().min(0).optional().describe('Line offset to start reading from (0-based, for single file only)'),
-    limit: z.number().min(1).optional().describe('Number of lines to read (for single file only)'),
+    path: z.string().describe('Single file path to read'),
+    offset: z.number().min(0).optional().describe('Line offset to start reading from (0-based)'),
+    limit: z.number().min(1).optional().describe('Number of lines to read'),
 });
-// Common binary extensions to skip
-const BINARY_EXTENSIONS = new Set([
-    '.png', '.jpg', '.jpeg', '.gif', '.bmp', '.ico', '.webp', '.svg',
-    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
-    '.zip', '.tar', '.gz', '.rar', '.7z',
-    '.exe', '.dll', '.so', '.dylib',
-    '.mp3', '.mp4', '.wav', '.avi', '.mov',
-    '.woff', '.woff2', '.ttf', '.eot', '.otf',
-    '.pyc', '.class', '.o', '.obj',
-]);
-/**
- * Check if file is likely binary
- */
-function isBinaryFile(filePath) {
-    const ext = extname(filePath).toLowerCase();
-    return BINARY_EXTENSIONS.has(ext);
-}
-/**
- * Convert glob pattern to regex
- */
-function globToRegex(pattern) {
-    const escaped = pattern
-        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
-        .replace(/\*/g, '.*')
-        .replace(/\?/g, '.');
-    return new RegExp(`^${escaped}$`, 'i');
-}
-/**
- * Check if filename matches glob pattern
- */
-function matchesPattern(filename, pattern) {
-    const regex = globToRegex(pattern);
-    return regex.test(filename);
-}
-/**
- * Recursively collect files from directory
- */
-function collectFiles(dir, pattern, maxDepth, currentDepth = 0) {
-    if (currentDepth > maxDepth)
-        return [];
-    const files = [];
-    try {
-        const entries = readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            // Skip hidden files/dirs and node_modules
-            if (entry.name.startsWith('.') || entry.name === 'node_modules')
-                continue;
-            const fullPath = join(dir, entry.name);
-            if (entry.isDirectory()) {
-                files.push(...collectFiles(fullPath, pattern, maxDepth, currentDepth + 1));
-            }
-            else if (entry.isFile()) {
-                if (!pattern || matchesPattern(entry.name, pattern)) {
-                    files.push(fullPath);
-                }
-            }
-        }
-    }
-    catch {
-        // Skip directories we can't read
-    }
-    return files;
-}
-/**
- * Read file content with truncation and optional line-based pagination
- */
-function readFileContent(filePath, options) {
-    const { maxLength, offset, limit } = options;
-    if (isBinaryFile(filePath)) {
-        return { content: '[Binary file]', truncated: false };
-    }
-    try {
-        const content = readFileSync(filePath, 'utf8');
-        const lines = content.split('\n');
-        const totalLines = lines.length;
-        // If offset/limit specified, use line-based pagination
-        if (offset !== undefined || limit !== undefined) {
-            const startLine = Math.min(offset ?? 0, totalLines);
-            const endLine = limit !== undefined ? Math.min(startLine + limit, totalLines) : totalLines;
-            const selectedLines = lines.slice(startLine, endLine);
-            const selectedContent = selectedLines.join('\n');
-            const actualEnd = endLine;
-            const hasMore = actualEnd < totalLines;
-            let finalContent = selectedContent;
-            if (selectedContent.length > maxLength) {
-                finalContent = selectedContent.substring(0, maxLength) + `\n... (+${selectedContent.length - maxLength} chars)`;
-            }
-            // Calculate actual line range (handle empty selection)
-            const actualLineEnd = selectedLines.length > 0 ? startLine + selectedLines.length - 1 : startLine;
-            return {
-                content: finalContent,
-                truncated: hasMore || selectedContent.length > maxLength,
-                totalLines,
-                lineRange: { start: startLine, end: actualLineEnd },
-            };
-        }
-        // Default behavior: truncate by character length
-        if (content.length > maxLength) {
-            return {
-                content: content.substring(0, maxLength) + `\n... (+${content.length - maxLength} chars)`,
-                truncated: true,
-                totalLines,
-            };
-        }
-        return { content, truncated: false, totalLines };
-    }
-    catch (error) {
-        return { content: `[Error: ${error.message}]`, truncated: false };
-    }
-}
-/**
- * Find regex matches in content
- */
-function findMatches(content, pattern) {
-    try {
-        const regex = new RegExp(pattern, 'gm');
-        const matches = [];
-        let match;
-        while ((match = regex.exec(content)) !== null && matches.length < 10) {
-            // Get line containing match
-            const lineStart = content.lastIndexOf('\n', match.index) + 1;
-            const lineEnd = content.indexOf('\n', match.index);
-            const line = content.substring(lineStart, lineEnd === -1 ? undefined : lineEnd).trim();
-            matches.push(line.substring(0, 200)); // Truncate long lines
-        }
-        return matches;
-    }
-    catch {
-        return [];
-    }
-}
-// Tool schema for MCP
 export const schema = {
     name: 'read_file',
-    description: `Read files with multi-file, directory, regex support, and line-based pagination.
+    description: `Read a single file with optional line-based pagination.
 
 Usage:
-  read_file(paths="file.ts")                              # Single file (full content)
-  read_file(paths="file.ts", offset=100, limit=50)        # Lines 100-149 (0-based)
-  read_file(paths=["a.ts", "b.ts"])                       # Multiple files
-  read_file(paths="src/", pattern="*.ts")                 # Directory with pattern
-  read_file(paths="src/", contentPattern="TODO")          # Search content
+  read_file(path="file.ts")                        # Full content
+  read_file(path="file.ts", offset=100, limit=50)  # Lines 100-149 (0-based)
 
 Supports both absolute and relative paths. Relative paths are resolved from project root.
-Returns compact file list with optional content. Use offset/limit for large file pagination.`,
+Use offset/limit for large file pagination.`,
     inputSchema: {
         type: 'object',
         properties: {
-            paths: {
-                oneOf: [
-                    { type: 'string', description: 'Single file or directory path' },
-                    { type: 'array', items: { type: 'string' }, description: 'Array of file paths' }
-                ],
-                description: 'File path(s) or directory to read',
-            },
-            pattern: {
-                type: 'string',
-                description: 'Glob pattern to filter files (e.g., "*.ts", "*.{js,ts}")',
-            },
-            contentPattern: {
+            path: {
                 type: 'string',
-                description: 'Regex pattern to search within file content',
-            },
-            maxDepth: {
-                type: 'number',
-                description: 'Max directory depth to traverse (default: 3)',
-                default: 3,
-            },
-            includeContent: {
-                type: 'boolean',
-                description: 'Include file content in result (default: true)',
-                default: true,
-            },
-            maxFiles: {
-                type: 'number',
-                description: `Max number of files to return (default: ${MAX_FILES})`,
-                default: MAX_FILES,
+                description: 'Single file path to read',
             },
             offset: {
                 type: 'number',
-                description: 'Line offset to start reading from (0-based, for single file only)',
+                description: 'Line offset to start reading from (0-based)',
                 minimum: 0,
             },
             limit: {
                 type: 'number',
-                description: 'Number of lines to read (for single file only)',
+                description: 'Number of lines to read',
                 minimum: 1,
             },
         },
-        required: ['paths'],
+        required: ['path'],
     },
 };
-// Handler function
 export async function handler(params) {
     const parsed = ParamsSchema.safeParse(params);
     if (!parsed.success) {
         return { success: false, error: `Invalid params: ${parsed.error.message}` };
     }
-    const { paths, pattern, contentPattern, maxDepth, includeContent, maxFiles, offset, limit, } = parsed.data;
+    const { path: filePath, offset, limit } = parsed.data;
     const cwd = getProjectRoot();
-    // Normalize paths to array
-    const inputPaths = Array.isArray(paths) ? paths : [paths];
-    // Collect all files to read
-    const allFiles = [];
-    for (const inputPath of inputPaths) {
-        const resolvedPath = await validatePath(inputPath);
-        if (!existsSync(resolvedPath)) {
-            continue; // Skip non-existent paths
-        }
-        const stat = statSync(resolvedPath);
-        if (stat.isDirectory()) {
-            // Collect files from directory
-            const dirFiles = collectFiles(resolvedPath, pattern, maxDepth);
-            allFiles.push(...dirFiles);
-        }
-        else if (stat.isFile()) {
-            // Add single file (check pattern if provided)
-            if (!pattern || matchesPattern(relative(cwd, resolvedPath), pattern)) {
-                allFiles.push(resolvedPath);
-            }
-        }
-    }
-    // Limit files
-    const limitedFiles = allFiles.slice(0, maxFiles);
-    const totalFiles = allFiles.length;
-    // Process files
-    const files = [];
-    let totalContent = 0;
-    // Only apply offset/limit for single file mode
-    const isSingleFile = limitedFiles.length === 1;
-    const useLinePagination = isSingleFile && (offset !== undefined || limit !== undefined);
-    for (const filePath of limitedFiles) {
-        if (totalContent >= MAX_TOTAL_CONTENT)
-            break;
-        const stat = statSync(filePath);
-        const entry = {
-            path: relative(cwd, filePath) || filePath,
-            size: stat.size,
-        };
-        if (includeContent) {
-            const remainingSpace = MAX_TOTAL_CONTENT - totalContent;
-            const maxLen = Math.min(MAX_CONTENT_LENGTH, remainingSpace);
-            // Pass offset/limit only for single file mode
-            const readOptions = { maxLength: maxLen };
-            if (useLinePagination) {
-                if (offset !== undefined)
-                    readOptions.offset = offset;
-                if (limit !== undefined)
-                    readOptions.limit = limit;
-            }
-            const { content, truncated, totalLines, lineRange } = readFileContent(filePath, readOptions);
-            // If contentPattern provided, only include files with matches
-            if (contentPattern) {
-                const matches = findMatches(content, contentPattern);
-                if (matches.length > 0) {
-                    entry.matches = matches;
-                    entry.content = content;
-                    entry.truncated = truncated;
-                    entry.totalLines = totalLines;
-                    entry.lineRange = lineRange;
-                    totalContent += content.length;
-                }
-                else {
-                    continue; // Skip files without matches
-                }
-            }
-            else {
-                entry.content = content;
-                entry.truncated = truncated;
-                entry.totalLines = totalLines;
-                entry.lineRange = lineRange;
-                totalContent += content.length;
-            }
-        }
-        files.push(entry);
+    const resolvedPath = await validatePath(filePath);
+    if (!existsSync(resolvedPath)) {
+        return { success: false, error: `File not found: ${filePath}` };
     }
-    // Build message
-    let message = `Read ${files.length} file(s)`;
-    if (totalFiles > maxFiles) {
-        message += ` (showing ${maxFiles} of ${totalFiles})`;
+    const stat = statSync(resolvedPath);
+    if (!stat.isFile()) {
+        return { success: false, error: `Not a file: ${filePath}. Use read_many_files for directories.` };
     }
-    if (useLinePagination && files.length > 0 && files[0].lineRange) {
-        const { start, end } = files[0].lineRange;
-        message += ` [lines ${start}-${end} of ${files[0].totalLines}]`;
-    }
-    if (contentPattern) {
-        message += ` matching "${contentPattern}"`;
+    const { content, truncated, totalLines, lineRange } = readFileContent(resolvedPath, {
+        maxLength: MAX_CONTENT_LENGTH,
+        offset,
+        limit,
+    });
+    const entry = {
+        path: relative(cwd, resolvedPath) || filePath,
+        size: stat.size,
+        content,
+        truncated,
+        totalLines,
+        lineRange,
+    };
+    let message = `Read 1 file`;
+    if (lineRange) {
+        message += ` [lines ${lineRange.start}-${lineRange.end} of ${totalLines}]`;
     }
     return {
         success: true,
         result: {
-            files,
-            totalFiles,
+            files: [entry],
+            totalFiles: 1,
             message,
         },
     };

package/ccw/dist/tools/read-file.js.map

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

package/ccw/dist/tools/read-many-files.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Read Many Files Tool - Multi-file batch reading with directory traversal and content search
+ *
+ * Features:
+ * - Read multiple files at once
+ * - Read all files in a directory (with depth control)
+ * - Filter files by glob pattern
+ * - Content search with regex
+ * - Compact output format
+ */
+import type { ToolSchema, ToolResult } from '../types/tool.js';
+import { type ReadResult } from '../utils/file-reader.js';
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<ToolResult<ReadResult>>;
+//# sourceMappingURL=read-many-files.d.ts.map

package/ccw/dist/tools/read-many-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-many-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-many-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI/D,OAAO,EASL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAajC,eAAO,MAAM,MAAM,EAAE,UA+CpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CA0G9F"}

package/ccw/dist/tools/read-many-files.js

@@ -0,0 +1,166 @@
+/**
+ * Read Many Files Tool - Multi-file batch reading with directory traversal and content search
+ *
+ * Features:
+ * - Read multiple files at once
+ * - Read all files in a directory (with depth control)
+ * - Filter files by glob pattern
+ * - Content search with regex
+ * - Compact output format
+ */
+import { z } from 'zod';
+import { existsSync, statSync } from 'fs';
+import { relative } from 'path';
+import { validatePath, getProjectRoot } from '../utils/path-validator.js';
+import { MAX_CONTENT_LENGTH, MAX_FILES, MAX_TOTAL_CONTENT, collectFiles, matchesPattern, readFileContent, findMatches, } from '../utils/file-reader.js';
+const ParamsSchema = z.object({
+    paths: z.union([z.string(), z.array(z.string())]).describe('File path(s) or directory'),
+    pattern: z.string().optional().describe('Glob pattern to filter files (e.g., "*.ts", "**/*.js")'),
+    contentPattern: z.string().optional().describe('Regex to search within file content'),
+    maxDepth: z.number().default(3).describe('Max directory depth to traverse'),
+    includeContent: z.boolean().default(true).describe('Include file content in result'),
+    maxFiles: z.number().default(MAX_FILES).describe('Max number of files to return'),
+});
+export const schema = {
+    name: 'read_many_files',
+    description: `Read multiple files, directories, or search file content with regex.
+
+Usage:
+  read_many_files(paths=["a.ts", "b.ts"])                  # Multiple files
+  read_many_files(paths="src/", pattern="*.ts")             # Directory with glob filter
+  read_many_files(paths="src/", contentPattern="TODO")      # Search content with regex
+  read_many_files(paths="src/", pattern="*.ts", includeContent=false)  # List files only
+
+Supports both absolute and relative paths. Relative paths are resolved from project root.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            paths: {
+                oneOf: [
+                    { type: 'string', description: 'Single file or directory path' },
+                    { type: 'array', items: { type: 'string' }, description: 'Array of file paths' },
+                ],
+                description: 'File path(s) or directory to read',
+            },
+            pattern: {
+                type: 'string',
+                description: 'Glob pattern to filter files (e.g., "*.ts", "*.{js,ts}")',
+            },
+            contentPattern: {
+                type: 'string',
+                description: 'Regex pattern to search within file content. Empty string "" returns all content. Dangerous patterns automatically fall back to returning all content for safety.',
+            },
+            maxDepth: {
+                type: 'number',
+                description: 'Max directory depth to traverse (default: 3)',
+                default: 3,
+            },
+            includeContent: {
+                type: 'boolean',
+                description: 'Include file content in result (default: true)',
+                default: true,
+            },
+            maxFiles: {
+                type: 'number',
+                description: `Max number of files to return (default: ${MAX_FILES})`,
+                default: MAX_FILES,
+            },
+        },
+        required: ['paths'],
+    },
+};
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const { paths, pattern, contentPattern, maxDepth, includeContent, maxFiles } = parsed.data;
+    const cwd = getProjectRoot();
+    // Normalize paths to array
+    const inputPaths = Array.isArray(paths) ? paths : [paths];
+    // Collect all files to read
+    const allFiles = [];
+    for (const inputPath of inputPaths) {
+        const resolvedPath = await validatePath(inputPath);
+        if (!existsSync(resolvedPath)) {
+            continue;
+        }
+        const stat = statSync(resolvedPath);
+        if (stat.isDirectory()) {
+            const dirFiles = collectFiles(resolvedPath, pattern, maxDepth);
+            allFiles.push(...dirFiles);
+        }
+        else if (stat.isFile()) {
+            if (!pattern || matchesPattern(relative(cwd, resolvedPath), pattern)) {
+                allFiles.push(resolvedPath);
+            }
+        }
+    }
+    // Limit files
+    const limitedFiles = allFiles.slice(0, maxFiles);
+    const totalFiles = allFiles.length;
+    // Process files
+    const files = [];
+    let totalContent = 0;
+    for (const filePath of limitedFiles) {
+        if (totalContent >= MAX_TOTAL_CONTENT)
+            break;
+        const stat = statSync(filePath);
+        const entry = {
+            path: relative(cwd, filePath) || filePath,
+            size: stat.size,
+        };
+        if (includeContent) {
+            const remainingSpace = MAX_TOTAL_CONTENT - totalContent;
+            const maxLen = Math.min(MAX_CONTENT_LENGTH, remainingSpace);
+            const { content, truncated, totalLines, lineRange } = readFileContent(filePath, { maxLength: maxLen });
+            if (contentPattern) {
+                const matches = findMatches(content, contentPattern);
+                if (matches === null) {
+                    // Empty/dangerous pattern: include all content
+                    entry.content = content;
+                    entry.truncated = truncated;
+                    entry.totalLines = totalLines;
+                    entry.lineRange = lineRange;
+                    totalContent += content.length;
+                }
+                else if (matches.length > 0) {
+                    entry.matches = matches;
+                    entry.content = content;
+                    entry.truncated = truncated;
+                    entry.totalLines = totalLines;
+                    entry.lineRange = lineRange;
+                    totalContent += content.length;
+                }
+                else {
+                    // No matches: skip file
+                    continue;
+                }
+            }
+            else {
+                entry.content = content;
+                entry.truncated = truncated;
+                entry.totalLines = totalLines;
+                entry.lineRange = lineRange;
+                totalContent += content.length;
+            }
+        }
+        files.push(entry);
+    }
+    let message = `Read ${files.length} file(s)`;
+    if (totalFiles > maxFiles) {
+        message += ` (showing ${maxFiles} of ${totalFiles})`;
+    }
+    if (contentPattern) {
+        message += ` matching "${contentPattern}"`;
+    }
+    return {
+        success: true,
+        result: {
+            files,
+            totalFiles,
+            message,
+        },
+    };
+}
+//# sourceMappingURL=read-many-files.js.map

package/ccw/dist/tools/read-many-files.js.map

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

package/ccw/dist/tools/read-outline.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read Outline Tool - Parse code files into structured symbol outlines.
+ *
+ * Uses web-tree-sitter for AST-level parsing. Returns function/class/method
+ * signatures with line offsets directly usable by read_file(offset, limit).
+ *
+ * Supported: TypeScript, TSX, JavaScript, Python, Go, Rust, Java, C#, C, C++
+ */
+import type { ToolSchema, ToolResult } from '../types/tool.js';
+import type { OutlineResult } from '../utils/outline-parser.js';
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<ToolResult<OutlineResult>>;
+//# sourceMappingURL=read-outline.d.ts.map

package/ccw/dist/tools/read-outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-outline.d.ts","sourceRoot":"","sources":["../../src/tools/read-outline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAUhE,eAAO,MAAM,MAAM,EAAE,UAqBpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAqDjG"}