@massa-ai/core 1.2.1

package/dist/tools/read_file.js

@@ -0,0 +1,580 @@
+/**
+ * @massa-ai/core - Read File Tool
+ *
+ * Optimized file reading with:
+ * - Automatic compression for large files
+ * - Intelligent caching
+ * - Symbol metadata integration
+ * - Multi-range support
+ * - Language detection
+ */
+import { estimateTokens, sanitizeFilePath } from "@massa-ai/shared";
+import { logger } from "@massa-ai/shared";
+import { CodeCompressor } from "../services/compression/code-compressor.js";
+import { serializeToolResponse } from "./serialize.js";
+import { eventBus } from "../services/events/event-bus.js";
+import { workspaceManager } from "../services/workspace/workspace-manager.js";
+import fs from "fs/promises";
+import path from "path";
+/**
+ * N9: per-read line ceiling on user-facing read_file output. Default 500;
+ * override via `MASSA_AI_READ_FILE_MAX_LINES`. Invalid/negative/zero
+ * values fall back to 500 (treat invalid as unset). When the requested
+ * range exceeds the cap, `selectedContent` is sliced and `source_clipped:
+ * true` is emitted in the same response. The true total line count is
+ * always surfaced as `lineRange.actual.total` so `omitted = total - shown`
+ * is derivable. Internal enrichment paths (SymbolGraphService.readSnippet
+ * /readContext used by go_to_definition) are NOT capped — see
+ * symbol-graph.service.ts for the exclusion comment.
+ */
+const MASSA_AI_READ_FILE_MAX_LINES = (() => {
+    const v = Number(process.env.MASSA_AI_READ_FILE_MAX_LINES);
+    return Number.isFinite(v) && v > 0 ? Math.floor(v) : 500;
+})();
+export class ReadFileTool {
+    name = "read_file";
+    description = "Read file with automatic compression, caching, and symbol metadata. " +
+        "Use with search results for 60% token savings.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "File path (absolute or relative to project root)",
+            },
+            projectId: {
+                type: "string",
+                description: "Project ID for symbol metadata (optional)",
+            },
+            offset: {
+                type: "number",
+                description: "Start line number (1-indexed)",
+            },
+            limit: {
+                type: "number",
+                description: "Number of lines to read",
+            },
+            lineStart: {
+                type: "number",
+                description: "Start line (alternative to offset)",
+            },
+            lineEnd: {
+                type: "number",
+                description: "End line (alternative to limit)",
+            },
+            compress: {
+                type: "boolean",
+                description: "Auto-compress content > 100 lines (default: true)",
+                default: true,
+            },
+            targetRatio: {
+                type: "number",
+                description: "Compression target ratio (0.3 = 70% reduction)",
+                default: 0.3,
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format",
+                default: "json",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+            includeSymbols: {
+                type: "boolean",
+                description: "Include symbol metadata from graph (default: true)",
+                default: true,
+            },
+            includeImports: {
+                type: "boolean",
+                description: "Extract and show import statements (default: true)",
+                default: true,
+            },
+        },
+        required: ["filePath"],
+    };
+    compressor;
+    symbolGraph;
+    fileCache = new Map();
+    projectRootCache = new Map();
+    CACHE_TTL = 60000; // 1 minute
+    ROOT_CACHE_TTL = 300000; // 5 minutes
+    /**
+     * Maximum entries retained in each in-memory cache. Without a cap, an
+     * adversarial caller cycling distinct cache keys grows the map for the
+     * process lifetime. Map preserves INSERTION order in JS; we promote a key
+     * to most-recently-used on GET via delete+set, and evict the oldest key on
+     * SET while over the cap. Mirrors WebController's WEB_CACHE_MAX_ENTRIES.
+     */
+    FILE_CACHE_MAX_ENTRIES = 512;
+    constructor(symbolGraph) {
+        this.compressor = new CodeCompressor();
+        this.symbolGraph = symbolGraph;
+        // The API keeps one ReadFileTool instance for the process lifetime. A
+        // guarded reset/reindex may legitimately move the same projectId to a new
+        // canonical root, so refresh the cached root as soon as ETL announces the
+        // new run. Without this, relative reads keep resolving against the prior
+        // workspace path until the API restarts.
+        eventBus.subscribe("indexing:started", ({ projectId, projectPath }) => {
+            this.projectRootCache.delete(projectId);
+            this.evictOldest(this.projectRootCache);
+            this.projectRootCache.set(projectId, projectPath);
+        });
+    }
+    async handle(params) {
+        const p = params;
+        const shouldCompress = p.compress !== false;
+        const targetRatio = p.targetRatio || 0.3;
+        const format = p.format || "json";
+        const { fields } = p;
+        const includeSymbols = p.includeSymbols !== false;
+        const includeImports = p.includeImports !== false;
+        try {
+            // Resolve file path (async — looks up project root when projectId provided).
+            // Returns null when the path is ambiguous (relative + no projectId) — we must
+            // NOT guess against process.cwd(), so surface a distinct error here rather
+            // than letting the generic "Failed to read file" catch swallow it.
+            const resolved = await this.resolveFilePath(p.filePath, p.projectId);
+            if (resolved === null) {
+                return {
+                    success: false,
+                    error: "Relative filePath requires a projectId (to resolve against the workspace) or an absolute path.",
+                };
+            }
+            const filePath = resolved;
+            // ── Wave 5 FR-12 / AD-W5-006: filesystem-side path containment. Absolute
+            // paths must resolve under one of: the project root (projectPath arg /
+            // workspace lookup), cwd, or an explicit allowlist env
+            // MASSA_AI_READ_FILE_ROOTS (colon-separated). Outside → teaching
+            // error listing valid roots only (no host path enumeration). Project
+            // root + cwd are ALWAYS allowed. sanitizeFilePath strips ../ traversal
+            // tokens before the containment check so a crafted relative path can't
+            // escape. Does not regress the 500-line cap (N9) — applied later.
+            const containment = await this.checkPathContainment(filePath, p.projectId);
+            if (!containment.allowed) {
+                return {
+                    success: false,
+                    error: containment.error,
+                };
+            }
+            // Keep original relative path for symbol DB queries (DB stores relative paths)
+            const relativePath = p.filePath;
+            // Calculate line range
+            const range = this.calculateRange(p);
+            // Read file with cache
+            const { content, metadata } = await this.readFileWithCache(filePath, {
+                includeSymbols,
+                includeImports,
+                projectId: p.projectId,
+                relativePath,
+            });
+            // Extract requested lines
+            const lines = content.split("\n");
+            const totalLines = lines.length;
+            const adjustedRange = this.adjustRange(range, totalLines);
+            let selectedContent = this.extractLines(lines, adjustedRange);
+            let selectedLineCount = selectedContent.split("\n").length;
+            // N9: cap user-facing read_file output at MASSA_AI_READ_FILE_MAX_LINES
+            // (default 500). When the adjusted range exceeds the cap, slice the
+            // content and emit `source_clipped: true` in the same response so the
+            // caller knows lines were omitted. `lineRange.actual.total` keeps the
+            // true total line count so `omitted = total - shown` is derivable.
+            let source_clipped = false;
+            if (selectedLineCount > MASSA_AI_READ_FILE_MAX_LINES) {
+                const cappedLines = lines.slice(adjustedRange.start - 1, adjustedRange.start - 1 + MASSA_AI_READ_FILE_MAX_LINES);
+                selectedContent = cappedLines.join("\n");
+                selectedLineCount = selectedContent.split("\n").length;
+                source_clipped = true;
+            }
+            // Determine if compression is needed
+            const shouldAutoCompress = shouldCompress &&
+                selectedLineCount > 100 &&
+                targetRatio < 1;
+            const result = {
+                filePath: p.filePath,
+                absolutePath: filePath,
+                lineRange: {
+                    requested: {
+                        start: range.start,
+                        end: range.end === Infinity ? null : range.end,
+                    },
+                    actual: {
+                        start: adjustedRange.start,
+                        end: source_clipped
+                            ? adjustedRange.start + selectedLineCount - 1
+                            : adjustedRange.end,
+                        total: totalLines,
+                    },
+                    selected: selectedLineCount,
+                },
+                source_clipped,
+                metadata: {
+                    totalLines,
+                    language: metadata.language,
+                    ...(metadata.symbols && { symbols: metadata.symbols }),
+                    ...(metadata.imports && { imports: metadata.imports }),
+                },
+                compressed: shouldAutoCompress,
+                recommendations: [],
+            };
+            if (shouldAutoCompress) {
+                // Auto-compress
+                const compressed = await this.compressor.compress(selectedContent, "code_structure");
+                const originalTokens = estimateTokens(selectedContent, "code");
+                const compressedTokens = estimateTokens(compressed.compressed, "code");
+                const actualRatio = compressedTokens / originalTokens;
+                result.content = compressed.compressed;
+                result.tokens = {
+                    original: originalTokens,
+                    compressed: compressedTokens,
+                    saved: originalTokens - compressedTokens,
+                    savingsPercent: Math.round((1 - actualRatio) * 100),
+                };
+                result.compressionRatio = actualRatio;
+                result.recommendations.push(`✓ Auto-compressed ${selectedLineCount} lines (${result.tokens.savingsPercent}% reduction)`);
+            }
+            else {
+                result.content = selectedContent;
+                result.tokens = {
+                    original: estimateTokens(selectedContent, "code"),
+                    compressed: estimateTokens(selectedContent, "code"),
+                    saved: 0,
+                    savingsPercent: 0,
+                };
+                // Add recommendations for large files
+                if (selectedLineCount > 100) {
+                    result.recommendations.push("💡 Content > 100 lines. Consider compress=true for token savings");
+                }
+            }
+            // Add usage tips
+            if (range.start === 1 && range.end === Infinity) {
+                result.recommendations.push("💡 Use lineStart/lineEnd or offset/limit to read specific sections (60% token savings)");
+            }
+            // Add related files tip if symbols found
+            if (metadata.symbols && metadata.symbols.definitions > 0) {
+                result.recommendations.push(`💡 Use get_references() to find usages of ${metadata.symbols.definitions} symbols in this file`);
+            }
+            return serializeToolResponse(result, { format, fields });
+        }
+        catch (error) {
+            logger.error("Failed to read file", error, {
+                filePath: p.filePath,
+            });
+            return {
+                success: false,
+                error: `Failed to read file: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Resolve a filePath to an absolute path.
+     *
+     * Resolution rules:
+     *  - Absolute path → returned verbatim (still normalized via path.resolve, but base-independent).
+     *  - `projectId` present → resolved against the workspace `project_path`. If the
+     *    workspace lookup fails (no root), this returns null (ambiguous).
+     *  - No `projectId` AND relative `filePath` → returns null. We deliberately do NOT
+     *    fall back to `path.resolve(filePath)` against process.cwd(), because a
+   relative
+     *    path arriving without a projectId is ambiguous and historically read from
+     *    the
+     *    server's cwd (COVERAGE finding #3). Callers must provide an absolute path or
+     *    a projectId.
+     *
+     * Returns null to signal an ambiguous/unsatisfiable path so `handle()` can map it
+     * to a distinct, clear error instead of the generic "Failed to read file" catch.
+     */
+    async resolveFilePath(filePath, projectId) {
+        if (path.isAbsolute(filePath)) {
+            return path.resolve(filePath);
+        }
+        if (projectId) {
+            const root = await this.getProjectRoot(projectId);
+            if (root) {
+                // Wave 5 FR-12: strip ../ traversal tokens from relative paths before
+                // resolving under the project root. sanitizeFilePath removes ../ and
+                // ..\ segments so a crafted relative path can't escape the root.
+                const cleaned = sanitizeFilePath(filePath);
+                return path.resolve(root, cleaned);
+            }
+            return null;
+        }
+        // Relative path with no projectId — do not guess against cwd.
+        return null;
+    }
+    /**
+     * Wave 5 FR-12 / AD-W5-006: filesystem-side path containment.
+     *
+     * An absolute path is allowed iff it resolves under one of:
+     *   1. the project root (workspace lookup for projectId, when provided)
+     *   2. process.cwd()
+     *   3. an entry in MASSA_AI_READ_FILE_ROOTS (colon-separated env)
+     *
+     * Project root + cwd are ALWAYS allowed. Outside → teaching error listing
+     * valid roots only (no host path enumeration). The check uses path.relative
+     * to detect traversal out of a root (a result starting with ".." or an
+     * absolute path on another drive means outside).
+     *
+     * The env allowlist is read at CALL TIME (not config-load time) so test
+     * suites and runtime operators can set it without restarting the process.
+     * config.readFile.extraRoots mirrors the same env for introspection.
+     *
+     * Returns { allowed: true } on success, or { allowed: false, error } with a
+     * Wave-4-N6-style teaching error listing the valid roots.
+     */
+    async checkPathContainment(absoluteFilePath, projectId) {
+        // Collect valid roots. Project root is included only when actually
+        // resolvable (workspace lookup succeeds); cwd is always available.
+        const roots = [];
+        if (projectId) {
+            const root = await this.getProjectRoot(projectId);
+            if (root)
+                roots.push(path.resolve(root));
+        }
+        roots.push(path.resolve(process.cwd()));
+        // Read the env allowlist at call time so tests/operators can set it
+        // without restarting the process. Colon-separated (POSIX-style).
+        const envRoots = (process.env.MASSA_AI_READ_FILE_ROOTS ?? "")
+            .split(":")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        for (const extra of envRoots) {
+            roots.push(path.resolve(extra));
+        }
+        const target = path.resolve(absoluteFilePath);
+        for (const root of roots) {
+            const rel = path.relative(root, target);
+            // Inside iff rel does not start with ".." and is not absolute (cross-drive).
+            if (rel !== "" && !rel.startsWith("..") && !path.isAbsolute(rel)) {
+                return { allowed: true };
+            }
+            // Exact root match (rel === "") is also inside.
+            if (rel === "")
+                return { allowed: true };
+        }
+        // Outside all roots → teaching error listing valid roots only.
+        const validRootsList = roots.map((r) => `  - ${r}`).join("\n");
+        return {
+            allowed: false,
+            error: `read_file path containment: "${target}" is outside the allowed roots.\n` +
+                `Valid roots (project root + cwd + MASSA_AI_READ_FILE_ROOTS):\n${validRootsList}\n` +
+                `Provide a filePath that resolves under one of these roots.`,
+        };
+    }
+    async getProjectRoot(projectId) {
+        const cached = this.projectRootCache.get(projectId);
+        if (cached !== undefined) {
+            // LRU touch: promote this key to most-recently-used.
+            this.projectRootCache.delete(projectId);
+            this.projectRootCache.set(projectId, cached);
+            return cached;
+        }
+        try {
+            const workspace = await workspaceManager.getWorkspace(projectId);
+            if (workspace?.project_path) {
+                this.evictOldest(this.projectRootCache);
+                this.projectRootCache.set(projectId, workspace.project_path);
+                return workspace.project_path;
+            }
+        }
+        catch (error) {
+            logger.warn("Failed to look up project root", { projectId, error: error.message });
+        }
+        return null;
+    }
+    /**
+     * Evict the oldest (first-inserted) entries from a cache Map until it is
+     * under FILE_CACHE_MAX_ENTRIES. Called BEFORE the new insert so the cap is
+     * honored post-insert with a single iteration.
+     */
+    evictOldest(cache) {
+        while (cache.size >= this.FILE_CACHE_MAX_ENTRIES) {
+            const oldest = cache.keys().next().value;
+            if (oldest === undefined)
+                break;
+            cache.delete(oldest);
+        }
+    }
+    calculateRange(params) {
+        // Priority: lineStart/lineEnd > offset/limit > entire file
+        if (params.lineStart !== undefined && params.lineEnd !== undefined) {
+            return {
+                start: Math.max(1, params.lineStart),
+                end: params.lineEnd,
+            };
+        }
+        if (params.offset !== undefined) {
+            const offset = Math.max(1, params.offset);
+            const limit = params.limit || 1000;
+            return {
+                start: offset,
+                end: offset + limit - 1,
+            };
+        }
+        return {
+            start: 1,
+            end: Infinity,
+        };
+    }
+    adjustRange(range, totalLines) {
+        const start = Math.max(1, Math.min(range.start, totalLines));
+        const end = range.end === Infinity
+            ? totalLines
+            : Math.min(range.end, totalLines);
+        return { start, end };
+    }
+    async readFileWithCache(filePath, options) {
+        // Cache key MUST include every option that changes metadata extraction.
+        // Keying on filePath alone returned stale, options-baked metadata for a
+        // later read of the same file with different includeSymbols/includeImports/
+        // projectId/relativePath (the only e2e red — 08.search F33). Deliberately
+        // exclude offset/limit/lineStart/lineEnd/compress/targetRatio/format: those
+        // are applied AFTER the cache in handle(), and coalescing them across reads
+        // is the cache's purpose.
+        const cacheKey = JSON.stringify({
+            filePath,
+            includeSymbols: options.includeSymbols ?? false,
+            includeImports: options.includeImports ?? false,
+            projectId: options.projectId ?? null,
+            relativePath: options.relativePath ?? null,
+        });
+        const cached = this.fileCache.get(cacheKey);
+        // Check cache validity
+        if (cached && Date.now() - cached.timestamp < this.CACHE_TTL) {
+            logger.debug("File cache hit", { filePath });
+            // LRU touch: promote this key to most-recently-used so hot files survive
+            // eviction. delete+set reorders the key to the end (newest).
+            this.fileCache.delete(cacheKey);
+            this.fileCache.set(cacheKey, cached);
+            // Legacy/edge entries may have undefined metadata. Re-extract once and
+            // WRITE IT BACK into the cache entry so subsequent hits are served from
+            // cache instead of re-extracting on every request.
+            if (!cached.metadata) {
+                const metadata = await this.extractMetadata(cached.content, filePath, options);
+                this.fileCache.set(cacheKey, { ...cached, metadata });
+                return { content: cached.content, metadata };
+            }
+            return {
+                content: cached.content,
+                metadata: cached.metadata,
+            };
+        }
+        // Read file
+        const content = await fs.readFile(filePath, "utf-8");
+        const metadata = await this.extractMetadata(content, filePath, options);
+        // Update cache (evict oldest if at cap).
+        this.evictOldest(this.fileCache);
+        this.fileCache.set(cacheKey, {
+            content,
+            timestamp: Date.now(),
+            metadata,
+        });
+        logger.debug("File read and cached", { filePath });
+        return { content, metadata };
+    }
+    async extractMetadata(content, filePath, options) {
+        const lines = content.split("\n");
+        const language = this.detectLanguage(filePath);
+        const metadata = {
+            totalLines: lines.length,
+            language,
+        };
+        // Extract imports if requested
+        if (options.includeImports && language) {
+            metadata.imports = this.extractImports(lines, language);
+        }
+        // Get symbol metadata if symbol graph available
+        if (options.includeSymbols && this.symbolGraph && options.projectId) {
+            try {
+                // Symbol DB stores relative paths — use original relative path for queries
+                const queryPath = options.relativePath || filePath;
+                const { definitions } = await this.symbolGraph.listDefinitions(options.projectId, {
+                    file: queryPath,
+                    limit: 100,
+                });
+                metadata.symbols = {
+                    definitions: definitions.length,
+                    references: 0, // Would need separate query
+                };
+            }
+            catch (error) {
+                logger.debug("Failed to get symbol metadata", { filePath, error });
+            }
+        }
+        return metadata;
+    }
+    extractLines(lines, range) {
+        const start = range.start - 1; // Convert to 0-indexed
+        const end = range.end;
+        const selectedLines = lines.slice(start, end);
+        // Add line numbers for context
+        return selectedLines
+            .map((line, index) => {
+            const lineNum = start + index + 1;
+            return `${lineNum.toString().padStart(6, " ")}: ${line}`;
+        })
+            .join("\n");
+    }
+    detectLanguage(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        const languageMap = {
+            ".ts": "TypeScript",
+            ".tsx": "TypeScript",
+            ".js": "JavaScript",
+            ".jsx": "JavaScript",
+            ".vue": "Vue",
+            ".py": "Python",
+            ".go": "Go",
+            ".rs": "Rust",
+            ".java": "Java",
+            ".cpp": "C++",
+            ".c": "C",
+            ".h": "C",
+            ".hpp": "C++",
+            ".cs": "C#",
+            ".rb": "Ruby",
+            ".php": "PHP",
+            ".swift": "Swift",
+            ".kt": "Kotlin",
+            ".kts": "Kotlin",
+            ".scala": "Scala",
+            ".md": "Markdown",
+            ".json": "JSON",
+            ".yaml": "YAML",
+            ".yml": "YAML",
+            ".xml": "XML",
+            ".html": "HTML",
+            ".css": "CSS",
+            ".scss": "SCSS",
+            ".sql": "SQL",
+            ".sh": "Shell",
+            ".bash": "Shell",
+        };
+        return languageMap[ext];
+    }
+    extractImports(lines, language) {
+        const imports = [];
+        const importPatterns = {
+            TypeScript: /^(import\s+.*?from\s+['"]|import\s+['"])/,
+            JavaScript: /^(import\s+.*?from\s+['"]|import\s+['"]|require\s*\(\s*['"])/,
+            Python: /^(import\s+|from\s+\S+\s+import)/,
+            Go: /^import\s+/,
+            Java: /^import\s+/,
+            Rust: /^use\s+/,
+        };
+        const pattern = importPatterns[language];
+        if (!pattern)
+            return imports;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (pattern.test(trimmed)) {
+                imports.push(trimmed);
+            }
+        }
+        return imports;
+    }
+}
+//# sourceMappingURL=read_file.js.map

package/dist/tools/read_file.js.map

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

package/dist/tools/restore_checkpoint.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Restore Checkpoint Tool
+ *
+ * MCP tool for restoring a previously saved task checkpoint.
+ * Returns the saved state along with integrity checks
+ * (missing memories, file conflicts).
+ *
+ * Thin layer — delegates to CheckpointManager service.
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class RestoreCheckpointTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            checkpointId: {
+                type: string;
+                description: string;
+            };
+            taskId: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    private checkpointManager;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=restore_checkpoint.d.ts.map

package/dist/tools/restore_checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore_checkpoint.d.ts","sourceRoot":"","sources":["../../src/tools/restore_checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAc9D,qBAAa,qBAAsB,YAAW,YAAY;IACxD,IAAI,SAAwB;IAC5B,WAAW,SAI+C;IAC1D,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BT;IAEF,OAAO,CAAC,iBAAiB,CAAoB;;IAMvC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA0ErD"}