nodebench-mcp 2.28.0 → 2.31.0

package/dist/sandboxApi.js.map

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

package/dist/tools/contextSandboxTools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Context Sandbox Tools — Context window protection via FTS5 indexing.
+ *
+ * Inspired by claude-context-mode (mksglu): raw output stays in a SQLite
+ * sandbox and only summaries/search results enter the agent's context window.
+ *
+ * 5 tools in the `context_sandbox` domain:
+ * - sandbox_ingest: Index arbitrary text/content into FTS5, return a compact reference
+ * - sandbox_search: BM25-ranked search across all sandboxed content
+ * - sandbox_execute: Run a shell command, index output, return summary only
+ * - sandbox_batch: Batch multiple commands + queries in one call
+ * - sandbox_stats: Token savings tracking per source/session
+ */
+import type { McpTool } from "../types.js";
+export declare const contextSandboxTools: McpTool[];

package/dist/tools/contextSandboxTools.js

@@ -0,0 +1,469 @@
+/**
+ * Context Sandbox Tools — Context window protection via FTS5 indexing.
+ *
+ * Inspired by claude-context-mode (mksglu): raw output stays in a SQLite
+ * sandbox and only summaries/search results enter the agent's context window.
+ *
+ * 5 tools in the `context_sandbox` domain:
+ * - sandbox_ingest: Index arbitrary text/content into FTS5, return a compact reference
+ * - sandbox_search: BM25-ranked search across all sandboxed content
+ * - sandbox_execute: Run a shell command, index output, return summary only
+ * - sandbox_batch: Batch multiple commands + queries in one call
+ * - sandbox_stats: Token savings tracking per source/session
+ */
+import { getDb, genId } from "../db.js";
+import { execSync } from "child_process";
+// ── Session-level stats ─────────────────────────────────────────────────
+const sessionStats = {
+    startedAt: Date.now(),
+    calls: {},
+    bytesIndexed: 0,
+    bytesReturned: 0,
+};
+function trackCall(tool, indexed, returned) {
+    sessionStats.calls[tool] = (sessionStats.calls[tool] || 0) + 1;
+    sessionStats.bytesIndexed += indexed;
+    sessionStats.bytesReturned += returned;
+}
+// ── FTS5 schema (lazy init) ─────────────────────────────────────────────
+let _initialized = false;
+function ensureSandboxTables() {
+    if (_initialized)
+        return;
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS sandbox_chunks (
+      id          INTEGER PRIMARY KEY AUTOINCREMENT,
+      source_id   TEXT NOT NULL,
+      source_label TEXT NOT NULL,
+      title       TEXT NOT NULL,
+      content     TEXT NOT NULL,
+      byte_size   INTEGER NOT NULL DEFAULT 0,
+      created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_sandbox_chunks_source ON sandbox_chunks(source_id);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS sandbox_fts USING fts5(
+      title,
+      content,
+      source_label,
+      content='sandbox_chunks',
+      content_rowid='id',
+      tokenize='porter unicode61'
+    );
+
+    CREATE TRIGGER IF NOT EXISTS sandbox_fts_insert AFTER INSERT ON sandbox_chunks BEGIN
+      INSERT INTO sandbox_fts(rowid, title, content, source_label)
+      VALUES (new.id, new.title, new.content, new.source_label);
+    END;
+
+    CREATE TRIGGER IF NOT EXISTS sandbox_fts_delete AFTER DELETE ON sandbox_chunks BEGIN
+      INSERT INTO sandbox_fts(sandbox_fts, rowid, title, content, source_label)
+      VALUES ('delete', old.id, old.title, old.content, old.source_label);
+    END;
+  `);
+    _initialized = true;
+}
+function chunkText(text, label, maxChunkSize = 2048) {
+    const lines = text.split("\n");
+    const chunks = [];
+    let current = [];
+    let currentTitle = `${label} (part 1)`;
+    let partNum = 1;
+    for (const line of lines) {
+        // Heading-based splitting
+        if (/^#{1,3}\s/.test(line) && current.length > 0) {
+            chunks.push({ title: currentTitle, content: current.join("\n") });
+            partNum++;
+            currentTitle = line.replace(/^#+\s*/, "").slice(0, 100) || `${label} (part ${partNum})`;
+            current = [line];
+            continue;
+        }
+        current.push(line);
+        // Size-based splitting
+        if (current.join("\n").length >= maxChunkSize) {
+            chunks.push({ title: currentTitle, content: current.join("\n") });
+            partNum++;
+            currentTitle = `${label} (part ${partNum})`;
+            current = [];
+        }
+    }
+    if (current.length > 0) {
+        chunks.push({ title: currentTitle, content: current.join("\n") });
+    }
+    return chunks.length > 0 ? chunks : [{ title: label, content: text }];
+}
+// ── Index content ───────────────────────────────────────────────────────
+function indexContent(label, text) {
+    ensureSandboxTables();
+    const db = getDb();
+    const sourceId = genId("sbx");
+    const chunks = chunkText(text, label);
+    const totalBytes = Buffer.byteLength(text);
+    const insert = db.prepare(`INSERT INTO sandbox_chunks (source_id, source_label, title, content, byte_size)
+     VALUES (?, ?, ?, ?, ?)`);
+    const tx = db.transaction(() => {
+        for (const chunk of chunks) {
+            insert.run(sourceId, label, chunk.title, chunk.content, Buffer.byteLength(chunk.content));
+        }
+    });
+    tx();
+    return { sourceId, chunkCount: chunks.length, totalBytes };
+}
+function searchSandbox(query, sourceLabel, limit = 5) {
+    ensureSandboxTables();
+    const db = getDb();
+    // Sanitize query for FTS5
+    const safeQuery = query.replace(/[^\w\s]/g, " ").trim();
+    if (!safeQuery)
+        return [];
+    let sql;
+    const params = [];
+    if (sourceLabel) {
+        sql = `SELECT title, snippet(sandbox_fts, 1, '>>>', '<<<', '...', 40) as snippet,
+           source_label, rank
+           FROM sandbox_fts
+           WHERE sandbox_fts MATCH ? AND source_label = ?
+           ORDER BY rank
+           LIMIT ?`;
+        params.push(safeQuery, sourceLabel, limit);
+    }
+    else {
+        sql = `SELECT title, snippet(sandbox_fts, 1, '>>>', '<<<', '...', 40) as snippet,
+           source_label, rank
+           FROM sandbox_fts
+           WHERE sandbox_fts MATCH ?
+           ORDER BY rank
+           LIMIT ?`;
+        params.push(safeQuery, limit);
+    }
+    try {
+        const rows = db.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            title: r.title,
+            snippet: r.snippet,
+            sourceLabel: r.source_label,
+            rank: r.rank,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ── Execute shell command ───────────────────────────────────────────────
+function executeCommand(command, timeoutMs = 30000) {
+    try {
+        const stdout = execSync(command, {
+            timeout: timeoutMs,
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+            encoding: "utf-8",
+            shell: "bash",
+        });
+        return { stdout: stdout ?? "", stderr: "", exitCode: 0 };
+    }
+    catch (err) {
+        return {
+            stdout: err.stdout ?? "",
+            stderr: err.stderr ?? "",
+            exitCode: err.status ?? 1,
+        };
+    }
+}
+// ═════════════════════════════════════════════════════════════════════════
+// TOOLS
+// ═════════════════════════════════════════════════════════════════════════
+export const contextSandboxTools = [
+    // ── Tool 1: sandbox_ingest ──────────────────────────────────────────
+    {
+        name: "sandbox_ingest",
+        description: "Index arbitrary text into the context sandbox (FTS5). Raw content stays in SQLite — only a compact reference enters context. Use for large outputs, API responses, file contents, or any data you want searchable without flooding the context window.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                label: {
+                    type: "string",
+                    description: "Label for the indexed content (e.g., 'API response', 'build output', 'README')",
+                },
+                content: {
+                    type: "string",
+                    description: "The raw content to index. Will be chunked by headings or size and stored in FTS5.",
+                },
+            },
+            required: ["label", "content"],
+        },
+        handler: async (args) => {
+            const label = String(args.label ?? "");
+            const content = String(args.content ?? "");
+            if (!label || !content)
+                return { error: "label and content are required" };
+            const { sourceId, chunkCount, totalBytes } = indexContent(label, content);
+            const returnedBytes = 120; // approx size of this response
+            trackCall("sandbox_ingest", totalBytes, returnedBytes);
+            return {
+                indexed: true,
+                sourceId,
+                label,
+                chunks: chunkCount,
+                bytesIndexed: totalBytes,
+                bytesInContext: returnedBytes,
+                savingsRatio: totalBytes > 0 ? `${(totalBytes / Math.max(returnedBytes, 1)).toFixed(0)}x` : "N/A",
+                _hint: `Indexed ${chunkCount} chunks (${(totalBytes / 1024).toFixed(1)}KB). Use sandbox_search to query this content. Label: "${label}".`,
+            };
+        },
+    },
+    // ── Tool 2: sandbox_search ──────────────────────────────────────────
+    {
+        name: "sandbox_search",
+        description: "BM25-ranked full-text search across all sandboxed content. Pass multiple queries as an array to batch all questions in one call. Use after sandbox_ingest or sandbox_execute to retrieve relevant snippets without pulling raw data into context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                queries: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Array of search queries. Batch ALL questions in one call for efficiency.",
+                },
+                source: {
+                    type: "string",
+                    description: "Filter to a specific source label (partial match). Optional.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Results per query (default: 5)",
+                },
+            },
+            required: ["queries"],
+        },
+        handler: async (args) => {
+            const queries = Array.isArray(args.queries) ? args.queries.map(String) : [];
+            if (queries.length === 0)
+                return { error: "queries array is required" };
+            const source = args.source ? String(args.source) : undefined;
+            const limit = typeof args.limit === "number" ? args.limit : 5;
+            const results = {};
+            let totalResultBytes = 0;
+            for (const q of queries) {
+                const hits = searchSandbox(q, source, limit);
+                results[q] = hits;
+                totalResultBytes += JSON.stringify(hits).length;
+            }
+            trackCall("sandbox_search", 0, totalResultBytes);
+            return {
+                queryCount: queries.length,
+                results,
+                _hint: `Searched ${queries.length} queries across sandbox. Results are BM25-ranked snippets — not full documents.`,
+            };
+        },
+    },
+    // ── Tool 3: sandbox_execute ─────────────────────────────────────────
+    {
+        name: "sandbox_execute",
+        description: "Run a shell command, automatically index the output into the sandbox, and return only a summary. The raw stdout/stderr stays in SQLite — only line counts and a preview enter context. Use instead of raw shell execution for commands that produce large output (build logs, test results, file listings, git logs).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                command: {
+                    type: "string",
+                    description: "Shell command to execute (runs in bash)",
+                },
+                label: {
+                    type: "string",
+                    description: "Label for the indexed output (default: derived from command)",
+                },
+                timeout: {
+                    type: "number",
+                    description: "Timeout in milliseconds (default: 30000, max: 120000)",
+                },
+                queries: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: search queries to run against the output immediately. Saves a follow-up sandbox_search call.",
+                },
+            },
+            required: ["command"],
+        },
+        handler: async (args) => {
+            const command = String(args.command ?? "");
+            if (!command)
+                return { error: "command is required" };
+            const label = String(args.label || command.slice(0, 60));
+            const timeout = Math.min(typeof args.timeout === "number" ? args.timeout : 30000, 120000);
+            const { stdout, stderr, exitCode } = executeCommand(command, timeout);
+            const fullOutput = [stdout, stderr].filter(Boolean).join("\n--- stderr ---\n");
+            const totalBytes = Buffer.byteLength(fullOutput);
+            // Index into sandbox
+            const { sourceId, chunkCount } = indexContent(label, fullOutput);
+            // Build summary
+            const lines = fullOutput.split("\n");
+            const preview = lines.slice(0, 5).join("\n");
+            const tail = lines.length > 10 ? lines.slice(-3).join("\n") : "";
+            // Optional immediate search
+            let searchResults;
+            const queries = Array.isArray(args.queries) ? args.queries.map(String) : [];
+            if (queries.length > 0) {
+                searchResults = {};
+                for (const q of queries) {
+                    searchResults[q] = searchSandbox(q, label, 5);
+                }
+            }
+            const returnedBytes = 300; // approx
+            trackCall("sandbox_execute", totalBytes, returnedBytes);
+            return {
+                exitCode,
+                lineCount: lines.length,
+                bytesProduced: totalBytes,
+                bytesInContext: returnedBytes,
+                savingsRatio: totalBytes > 0 ? `${(totalBytes / Math.max(returnedBytes, 1)).toFixed(0)}x` : "N/A",
+                sourceId,
+                chunks: chunkCount,
+                label,
+                preview: preview.slice(0, 500),
+                ...(tail ? { tail: tail.slice(0, 300) } : {}),
+                ...(searchResults ? { searchResults } : {}),
+                _hint: `Command produced ${lines.length} lines (${(totalBytes / 1024).toFixed(1)}KB). ${totalBytes > 1024 ? `Saved ~${(totalBytes / 1024).toFixed(0)}KB from context.` : ""} Use sandbox_search(queries: [...], source: "${label}") for details.`,
+            };
+        },
+    },
+    // ── Tool 4: sandbox_batch ───────────────────────────────────────────
+    {
+        name: "sandbox_batch",
+        description: "Execute multiple commands, index all outputs, and run multiple search queries — all in ONE call. This is the highest-efficiency tool: one sandbox_batch replaces N sandbox_execute calls + M sandbox_search calls. Use for research phases, multi-file analysis, or any task requiring multiple data sources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                commands: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            label: { type: "string", description: "Section header for this command's output" },
+                            command: { type: "string", description: "Shell command to execute" },
+                        },
+                        required: ["label", "command"],
+                    },
+                    description: "Commands to execute. Each runs sequentially, output is indexed with the label.",
+                },
+                queries: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Search queries to run after all commands complete. Results come from ALL indexed content.",
+                },
+                timeout: {
+                    type: "number",
+                    description: "Per-command timeout in ms (default: 30000)",
+                },
+            },
+            required: ["commands", "queries"],
+        },
+        handler: async (args) => {
+            const commands = Array.isArray(args.commands) ? args.commands : [];
+            const queries = Array.isArray(args.queries) ? args.queries.map(String) : [];
+            if (commands.length === 0)
+                return { error: "commands array is required" };
+            if (queries.length === 0)
+                return { error: "queries array is required" };
+            const timeout = Math.min(typeof args.timeout === "number" ? args.timeout : 30000, 120000);
+            let totalBytesIndexed = 0;
+            const commandSummaries = [];
+            // Execute and index all commands
+            for (const cmd of commands) {
+                const label = String(cmd.label ?? "");
+                const command = String(cmd.command ?? "");
+                if (!command)
+                    continue;
+                const { stdout, stderr, exitCode } = executeCommand(command, timeout);
+                const fullOutput = [stdout, stderr].filter(Boolean).join("\n--- stderr ---\n");
+                const bytes = Buffer.byteLength(fullOutput);
+                totalBytesIndexed += bytes;
+                indexContent(label || command.slice(0, 60), fullOutput);
+                commandSummaries.push({
+                    label: label || command.slice(0, 40),
+                    exitCode,
+                    lines: fullOutput.split("\n").length,
+                    bytes,
+                });
+            }
+            // Search across all indexed content
+            const searchResults = {};
+            for (const q of queries) {
+                searchResults[q] = searchSandbox(q, undefined, 5);
+            }
+            const returnedBytes = JSON.stringify({ commandSummaries, searchResults }).length;
+            trackCall("sandbox_batch", totalBytesIndexed, Math.min(returnedBytes, 2000));
+            return {
+                commandsExecuted: commandSummaries.length,
+                commandSummaries,
+                totalBytesIndexed,
+                bytesInContext: Math.min(returnedBytes, 2000),
+                savingsRatio: totalBytesIndexed > 0
+                    ? `${(totalBytesIndexed / Math.max(returnedBytes, 1)).toFixed(0)}x`
+                    : "N/A",
+                queryCount: queries.length,
+                searchResults,
+                _hint: `Batch complete: ${commandSummaries.length} commands indexed (${(totalBytesIndexed / 1024).toFixed(1)}KB total), ${queries.length} queries searched. Use sandbox_search for follow-up queries.`,
+            };
+        },
+    },
+    // ── Tool 5: sandbox_stats ───────────────────────────────────────────
+    {
+        name: "sandbox_stats",
+        description: "Show context savings for the current session — per-tool breakdown, total bytes indexed vs returned, savings ratio, and estimated token savings. Use to quantify how much context window space the sandbox has preserved.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        handler: async () => {
+            ensureSandboxTables();
+            const db = getDb();
+            // Get total indexed content stats
+            let totalChunks = 0;
+            let totalStoredBytes = 0;
+            let sourceCount = 0;
+            try {
+                const stats = db.prepare("SELECT COUNT(*) as chunks, COALESCE(SUM(byte_size), 0) as bytes, COUNT(DISTINCT source_id) as sources FROM sandbox_chunks").get();
+                totalChunks = stats.chunks;
+                totalStoredBytes = stats.bytes;
+                sourceCount = stats.sources;
+            }
+            catch { /* table may not exist */ }
+            const sessionDurationMs = Date.now() - sessionStats.startedAt;
+            const totalIndexed = sessionStats.bytesIndexed;
+            const totalReturned = sessionStats.bytesReturned;
+            const savingsRatio = totalReturned > 0
+                ? (totalIndexed / totalReturned).toFixed(1)
+                : "N/A";
+            const estimatedTokensSaved = Math.round((totalIndexed - totalReturned) / 4); // ~4 bytes per token
+            const perTool = Object.entries(sessionStats.calls).map(([tool, calls]) => ({
+                tool,
+                calls,
+            }));
+            return {
+                session: {
+                    durationMs: sessionDurationMs,
+                    durationFormatted: `${(sessionDurationMs / 60000).toFixed(1)} min`,
+                },
+                savings: {
+                    totalBytesIndexed: totalIndexed,
+                    totalBytesReturned: totalReturned,
+                    bytesKeptInSandbox: totalIndexed - totalReturned,
+                    savingsRatio: `${savingsRatio}x`,
+                    contextReduction: totalIndexed > 0
+                        ? `${(((totalIndexed - totalReturned) / totalIndexed) * 100).toFixed(0)}%`
+                        : "0%",
+                    estimatedTokensSaved,
+                },
+                storage: {
+                    totalChunks,
+                    totalStoredBytes,
+                    sourceCount,
+                },
+                perTool,
+                _hint: totalIndexed > 1024
+                    ? `Sandbox saved ~${(totalIndexed / 1024).toFixed(0)}KB from context (${savingsRatio}x compression). ~${estimatedTokensSaved.toLocaleString()} tokens preserved.`
+                    : "No significant data sandboxed yet. Use sandbox_execute or sandbox_ingest to start saving context.",
+            };
+        },
+    },
+];
+//# sourceMappingURL=contextSandboxTools.js.map

package/dist/tools/contextSandboxTools.js.map

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

package/dist/tools/contextTools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Engine Context Tools — MCP tools for querying accumulated engine knowledge.
+ *
+ * 4 tools in the `engine_context` domain:
+ * - get_engine_context_health: Overall health of accumulated knowledge
+ * - get_workflow_history: Past runs with scores for a given workflow
+ * - archive_content: Save content to archive (prevents repetition)
+ * - search_content_archive: FTS5 search past content by theme/title
+ */
+import type { McpTool } from "../types.js";
+export declare const contextTools: McpTool[];