@papicandela/mcx-core 0.2.7 → 0.2.9

package/dist/index.js

@@ -6537,13 +6537,129 @@ class BunWorkerSandbox {
         throw new Error('waitFor timeout after ' + timeout + 'ms');
       };
 
+      /**
+       * Get lines around a specific line number (1-indexed).
+       * @param file - File object with .lines array
+       * @param line - Line number (1-indexed)
+       * @param ctx - Context lines before/after (default 10)
+       */
+      globalThis.around = (file, line, ctx = 10) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        if (line < 1 || line > lines.length) return [];
+        const idx = line - 1;
+        return lines.slice(Math.max(0, idx - ctx), Math.min(lines.length, idx + ctx + 1));
+      };
+
+      /**
+       * Get specific line range (1-indexed, inclusive).
+       * @param file - File object with .lines array
+       * @param start - Start line number (1-indexed)
+       * @param end - End line number (1-indexed, inclusive)
+       */
+      globalThis.lines = (file, start, end) => {
+        const fileLines = file?.lines;
+        if (!Array.isArray(fileLines)) return [];
+        if (start < 1) start = 1;
+        if (end > fileLines.length) end = fileLines.length;
+        return fileLines.slice(start - 1, end);
+      };
+
+      /**
+       * Extract code block containing a line (detects by indentation).
+       * @param file - File object with .lines array
+       * @param line - Line number (1-indexed)
+       */
+      globalThis.block = (file, line) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const idx = line - 1;
+        if (idx < 0 || idx >= lines.length) return [];
+
+        const targetIndent = lines[idx].search(/\\S/);
+        if (targetIndent < 0) return [lines[idx]];
+
+        // Find block start (line with less indentation)
+        let start = idx;
+        for (let i = idx - 1; i >= 0; i--) {
+          const lineIndent = lines[i].search(/\\S/);
+          if (lineIndent >= 0 && lineIndent < targetIndent) { start = i; break; }
+        }
+
+        // Find block end
+        const startIndent = lines[start].search(/\\S/);
+        let end = idx;
+        for (let i = idx + 1; i < lines.length; i++) {
+          const lineIndent = lines[i].search(/\\S/);
+          if (lineIndent >= 0 && lineIndent <= startIndent && lines[i].trim()) { end = i - 1; break; }
+          end = i;
+        }
+
+        return lines.slice(start, end + 1);
+      };
+
+      /**
+       * Grep with context lines.
+       * @param file - File object with .lines array
+       * @param pattern - String or regex pattern
+       * @param ctx - Context lines (default 3)
+       */
+      globalThis.grep = (file, pattern, ctx = 3) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const regex = typeof pattern === 'string' ? new RegExp(pattern, 'i') : pattern;
+        const results = [];
+
+        for (let i = 0; i < lines.length; i++) {
+          if (regex.test(lines[i])) {
+            results.push({
+              line: i + 1,
+              match: lines[i],
+              context: lines.slice(Math.max(0, i - ctx), i + ctx + 1)
+            });
+          }
+        }
+        return results;
+      };
+
+      /**
+       * Extract outline (function/class signatures).
+       * @param file - File object with .lines array
+       */
+      globalThis.outline = (file) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const signatures = [];
+        const patterns = [
+          /^(export\\s+)?(async\\s+)?function\\s+\\w+/,
+          /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?\\(/,
+          /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?function/,
+          /^(export\\s+)?class\\s+\\w+/,
+          /^(export\\s+)?interface\\s+\\w+/,
+          /^(export\\s+)?type\\s+\\w+/,
+          /^\\s+(async\\s+)?\\w+\\s*\\([^)]*\\)\\s*[:{]/,
+        ];
+
+        for (let i = 0; i < lines.length; i++) {
+          const line = lines[i];
+          for (const pat of patterns) {
+            if (pat.test(line)) {
+              signatures.push({ line: i + 1, text: line.trim().slice(0, 80) });
+              break;
+            }
+          }
+        }
+        return signatures;
+      };
+
       // SECURITY: Reserved keys that must not be overwritten by user-provided variables/globals
       const RESERVED_KEYS = new Set([
         'onmessage', 'postMessage', 'close', 'terminate', 'self',
         'constructor', 'prototype', '__proto__',
         'pendingCalls', 'callId', 'logs', 'console', 'adapters',
         'fetch', 'XMLHttpRequest', 'WebSocket', 'EventSource',
-        'pick', 'table', 'count', 'sum', 'first', 'safeStr', 'poll', 'waitFor'
+        'pick', 'table', 'count', 'sum', 'first', 'safeStr', 'poll', 'waitFor',
+        'around', 'lines', 'block', 'grep', 'outline'
       ]);
 
       self.onmessage = async (event) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papicandela/mcx-core",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "MCX Core - MCP Code Execution Framework",
   "author": "papicandela",
   "license": "MIT",

package/src/sandbox/bun-worker.ts

@@ -334,13 +334,129 @@ export class BunWorkerSandbox implements ISandbox {
         throw new Error('waitFor timeout after ' + timeout + 'ms');
       };
 
+      /**
+       * Get lines around a specific line number (1-indexed).
+       * @param file - File object with .lines array
+       * @param line - Line number (1-indexed)
+       * @param ctx - Context lines before/after (default 10)
+       */
+      globalThis.around = (file, line, ctx = 10) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        if (line < 1 || line > lines.length) return [];
+        const idx = line - 1;
+        return lines.slice(Math.max(0, idx - ctx), Math.min(lines.length, idx + ctx + 1));
+      };
+
+      /**
+       * Get specific line range (1-indexed, inclusive).
+       * @param file - File object with .lines array
+       * @param start - Start line number (1-indexed)
+       * @param end - End line number (1-indexed, inclusive)
+       */
+      globalThis.lines = (file, start, end) => {
+        const fileLines = file?.lines;
+        if (!Array.isArray(fileLines)) return [];
+        if (start < 1) start = 1;
+        if (end > fileLines.length) end = fileLines.length;
+        return fileLines.slice(start - 1, end);
+      };
+
+      /**
+       * Extract code block containing a line (detects by indentation).
+       * @param file - File object with .lines array
+       * @param line - Line number (1-indexed)
+       */
+      globalThis.block = (file, line) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const idx = line - 1;
+        if (idx < 0 || idx >= lines.length) return [];
+
+        const targetIndent = lines[idx].search(/\\S/);
+        if (targetIndent < 0) return [lines[idx]];
+
+        // Find block start (line with less indentation)
+        let start = idx;
+        for (let i = idx - 1; i >= 0; i--) {
+          const lineIndent = lines[i].search(/\\S/);
+          if (lineIndent >= 0 && lineIndent < targetIndent) { start = i; break; }
+        }
+
+        // Find block end
+        const startIndent = lines[start].search(/\\S/);
+        let end = idx;
+        for (let i = idx + 1; i < lines.length; i++) {
+          const lineIndent = lines[i].search(/\\S/);
+          if (lineIndent >= 0 && lineIndent <= startIndent && lines[i].trim()) { end = i - 1; break; }
+          end = i;
+        }
+
+        return lines.slice(start, end + 1);
+      };
+
+      /**
+       * Grep with context lines.
+       * @param file - File object with .lines array
+       * @param pattern - String or regex pattern
+       * @param ctx - Context lines (default 3)
+       */
+      globalThis.grep = (file, pattern, ctx = 3) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const regex = typeof pattern === 'string' ? new RegExp(pattern, 'i') : pattern;
+        const results = [];
+
+        for (let i = 0; i < lines.length; i++) {
+          if (regex.test(lines[i])) {
+            results.push({
+              line: i + 1,
+              match: lines[i],
+              context: lines.slice(Math.max(0, i - ctx), i + ctx + 1)
+            });
+          }
+        }
+        return results;
+      };
+
+      /**
+       * Extract outline (function/class signatures).
+       * @param file - File object with .lines array
+       */
+      globalThis.outline = (file) => {
+        const lines = file?.lines;
+        if (!Array.isArray(lines)) return [];
+        const signatures = [];
+        const patterns = [
+          /^(export\\s+)?(async\\s+)?function\\s+\\w+/,
+          /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?\\(/,
+          /^(export\\s+)?(const|let|var)\\s+\\w+\\s*=\\s*(async\\s+)?function/,
+          /^(export\\s+)?class\\s+\\w+/,
+          /^(export\\s+)?interface\\s+\\w+/,
+          /^(export\\s+)?type\\s+\\w+/,
+          /^\\s+(async\\s+)?\\w+\\s*\\([^)]*\\)\\s*[:{]/,
+        ];
+
+        for (let i = 0; i < lines.length; i++) {
+          const line = lines[i];
+          for (const pat of patterns) {
+            if (pat.test(line)) {
+              signatures.push({ line: i + 1, text: line.trim().slice(0, 80) });
+              break;
+            }
+          }
+        }
+        return signatures;
+      };
+
       // SECURITY: Reserved keys that must not be overwritten by user-provided variables/globals
       const RESERVED_KEYS = new Set([
         'onmessage', 'postMessage', 'close', 'terminate', 'self',
         'constructor', 'prototype', '__proto__',
         'pendingCalls', 'callId', 'logs', 'console', 'adapters',
         'fetch', 'XMLHttpRequest', 'WebSocket', 'EventSource',
-        'pick', 'table', 'count', 'sum', 'first', 'safeStr', 'poll', 'waitFor'
+        'pick', 'table', 'count', 'sum', 'first', 'safeStr', 'poll', 'waitFor',
+        'around', 'lines', 'block', 'grep', 'outline'
       ]);
 
       self.onmessage = async (event) => {