@crypto512/jicon-mcp 2.2.0 → 2.3.0

package/dist/utils/sandbox/helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sandbox Helpers
+ *
+ * Data manipulation helper functions injected into the QuickJS sandbox.
+ * These are defined as JavaScript code strings that get evaluated in the sandbox.
+ */
+/**
+ * JavaScript code for all helper functions.
+ * This gets evaluated in the sandbox to define global helper functions.
+ */
+export declare const HELPER_FUNCTIONS_JS = "\n// ============================================================================\n// Aggregation Helpers\n// ============================================================================\n\n/**\n * Group array items by a key or function\n * @param {Array} array - Array to group\n * @param {string|Function} keyOrFn - Field name or function returning group key\n * @returns {Object} Object with keys as group names and values as arrays\n */\nfunction groupBy(array, keyOrFn) {\n  if (!Array.isArray(array)) return {};\n  const result = {};\n  for (const item of array) {\n    const key = typeof keyOrFn === 'function'\n      ? keyOrFn(item)\n      : get(item, keyOrFn);\n    const keyStr = String(key ?? 'undefined');\n    if (!result[keyStr]) {\n      result[keyStr] = [];\n    }\n    result[keyStr].push(item);\n  }\n  return result;\n}\n\n/**\n * Sum numeric values in array\n * @param {Array} array - Array to sum\n * @param {string} [field] - Optional field path to extract numbers from\n * @returns {number}\n */\nfunction sum(array, field) {\n  if (!Array.isArray(array)) return 0;\n  return array.reduce((acc, item) => {\n    const value = field ? get(item, field) : item;\n    const num = typeof value === 'number' ? value : parseFloat(value);\n    return acc + (isNaN(num) ? 0 : num);\n  }, 0);\n}\n\n/**\n * Calculate average of numeric values\n * @param {Array} array - Array to average\n * @param {string} [field] - Optional field path\n * @returns {number}\n */\nfunction avg(array, field) {\n  if (!Array.isArray(array) || array.length === 0) return 0;\n  return sum(array, field) / array.length;\n}\n\n/**\n * Find minimum value\n * @param {Array} array - Array to search\n * @param {string} [field] - Optional field path\n * @returns {*}\n */\nfunction min(array, field) {\n  if (!Array.isArray(array) || array.length === 0) return undefined;\n  let minVal = undefined;\n  for (const item of array) {\n    const value = field ? get(item, field) : item;\n    if (minVal === undefined || value < minVal) {\n      minVal = value;\n    }\n  }\n  return minVal;\n}\n\n/**\n * Find maximum value\n * @param {Array} array - Array to search\n * @param {string} [field] - Optional field path\n * @returns {*}\n */\nfunction max(array, field) {\n  if (!Array.isArray(array) || array.length === 0) return undefined;\n  let maxVal = undefined;\n  for (const item of array) {\n    const value = field ? get(item, field) : item;\n    if (maxVal === undefined || value > maxVal) {\n      maxVal = value;\n    }\n  }\n  return maxVal;\n}\n\n/**\n * Count array items\n * @param {Array} array - Array to count\n * @returns {number}\n */\nfunction count(array) {\n  if (!Array.isArray(array)) return 0;\n  return array.length;\n}\n\n/**\n * Get unique values from array\n * @param {Array} array - Array to dedupe\n * @param {string} [field] - Optional field path\n * @returns {Array}\n */\nfunction unique(array, field) {\n  if (!Array.isArray(array)) return [];\n  const seen = new Set();\n  const result = [];\n  for (const item of array) {\n    const value = field ? get(item, field) : item;\n    const key = JSON.stringify(value);\n    if (!seen.has(key)) {\n      seen.add(key);\n      result.push(value);\n    }\n  }\n  return result;\n}\n\n// ============================================================================\n// Object Access Helpers\n// ============================================================================\n\n/**\n * Get nested value using dot notation path\n * @param {Object} obj - Object to access\n * @param {string} path - Dot notation path (e.g., \"priority.name\")\n * @returns {*}\n */\nfunction get(obj, path) {\n  if (obj == null || typeof path !== 'string') return undefined;\n  const parts = path.split('.');\n  let current = obj;\n  for (const part of parts) {\n    if (current == null) return undefined;\n    // Handle array index notation (e.g., \"items.0.name\")\n    const index = parseInt(part, 10);\n    if (!isNaN(index) && Array.isArray(current)) {\n      current = current[index];\n    } else {\n      current = current[part];\n    }\n  }\n  return current;\n}\n\n/**\n * Create object with only specified keys\n * @param {Object} obj - Source object\n * @param {Array<string>} keys - Keys to include\n * @returns {Object}\n */\nfunction pick(obj, keys) {\n  if (obj == null || !Array.isArray(keys)) return {};\n  const result = {};\n  for (const key of keys) {\n    if (key in obj) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Create object without specified keys\n * @param {Object} obj - Source object\n * @param {Array<string>} keys - Keys to exclude\n * @returns {Object}\n */\nfunction omit(obj, keys) {\n  if (obj == null) return {};\n  const keysSet = new Set(keys || []);\n  const result = {};\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key) && !keysSet.has(key)) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n}\n\n// ============================================================================\n// Date Helpers\n// ============================================================================\n\n/**\n * Parse date string to timestamp (milliseconds)\n * @param {string|number|Date} value - Date value to parse\n * @returns {number|null}\n */\nfunction parseDate(value) {\n  if (value == null) return null;\n  if (typeof value === 'number') return value;\n  const ts = Date.parse(value);\n  return isNaN(ts) ? null : ts;\n}\n\n/**\n * Format timestamp to string\n * @param {number|string|Date} ts - Timestamp or date\n * @param {string} [format] - Format string (simplified: 'iso', 'date', 'time', or 'datetime')\n * @returns {string}\n */\nfunction formatDate(ts, format) {\n  const date = new Date(typeof ts === 'number' ? ts : Date.parse(ts));\n  if (isNaN(date.getTime())) return '';\n\n  switch (format) {\n    case 'date':\n      return date.toISOString().split('T')[0];\n    case 'time':\n      return date.toISOString().split('T')[1].split('.')[0];\n    case 'datetime':\n      return date.toISOString().replace('T', ' ').split('.')[0];\n    case 'iso':\n    default:\n      return date.toISOString();\n  }\n}\n\n/**\n * Calculate days between two dates\n * @param {string|number|Date} date1 - First date\n * @param {string|number|Date} date2 - Second date\n * @returns {number}\n */\nfunction daysBetween(date1, date2) {\n  const ts1 = parseDate(date1);\n  const ts2 = parseDate(date2);\n  if (ts1 == null || ts2 == null) return 0;\n  const msPerDay = 24 * 60 * 60 * 1000;\n  return Math.round(Math.abs(ts2 - ts1) / msPerDay);\n}\n";
+/**
+ * Get the JavaScript code for helper functions
+ */
+export declare function getHelperFunctionsCode(): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/sandbox/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/sandbox/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,47MA0O/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/utils/sandbox/helpers.js

@@ -0,0 +1,252 @@
+/**
+ * Sandbox Helpers
+ *
+ * Data manipulation helper functions injected into the QuickJS sandbox.
+ * These are defined as JavaScript code strings that get evaluated in the sandbox.
+ */
+/**
+ * JavaScript code for all helper functions.
+ * This gets evaluated in the sandbox to define global helper functions.
+ */
+export const HELPER_FUNCTIONS_JS = `
+// ============================================================================
+// Aggregation Helpers
+// ============================================================================
+
+/**
+ * Group array items by a key or function
+ * @param {Array} array - Array to group
+ * @param {string|Function} keyOrFn - Field name or function returning group key
+ * @returns {Object} Object with keys as group names and values as arrays
+ */
+function groupBy(array, keyOrFn) {
+  if (!Array.isArray(array)) return {};
+  const result = {};
+  for (const item of array) {
+    const key = typeof keyOrFn === 'function'
+      ? keyOrFn(item)
+      : get(item, keyOrFn);
+    const keyStr = String(key ?? 'undefined');
+    if (!result[keyStr]) {
+      result[keyStr] = [];
+    }
+    result[keyStr].push(item);
+  }
+  return result;
+}
+
+/**
+ * Sum numeric values in array
+ * @param {Array} array - Array to sum
+ * @param {string} [field] - Optional field path to extract numbers from
+ * @returns {number}
+ */
+function sum(array, field) {
+  if (!Array.isArray(array)) return 0;
+  return array.reduce((acc, item) => {
+    const value = field ? get(item, field) : item;
+    const num = typeof value === 'number' ? value : parseFloat(value);
+    return acc + (isNaN(num) ? 0 : num);
+  }, 0);
+}
+
+/**
+ * Calculate average of numeric values
+ * @param {Array} array - Array to average
+ * @param {string} [field] - Optional field path
+ * @returns {number}
+ */
+function avg(array, field) {
+  if (!Array.isArray(array) || array.length === 0) return 0;
+  return sum(array, field) / array.length;
+}
+
+/**
+ * Find minimum value
+ * @param {Array} array - Array to search
+ * @param {string} [field] - Optional field path
+ * @returns {*}
+ */
+function min(array, field) {
+  if (!Array.isArray(array) || array.length === 0) return undefined;
+  let minVal = undefined;
+  for (const item of array) {
+    const value = field ? get(item, field) : item;
+    if (minVal === undefined || value < minVal) {
+      minVal = value;
+    }
+  }
+  return minVal;
+}
+
+/**
+ * Find maximum value
+ * @param {Array} array - Array to search
+ * @param {string} [field] - Optional field path
+ * @returns {*}
+ */
+function max(array, field) {
+  if (!Array.isArray(array) || array.length === 0) return undefined;
+  let maxVal = undefined;
+  for (const item of array) {
+    const value = field ? get(item, field) : item;
+    if (maxVal === undefined || value > maxVal) {
+      maxVal = value;
+    }
+  }
+  return maxVal;
+}
+
+/**
+ * Count array items
+ * @param {Array} array - Array to count
+ * @returns {number}
+ */
+function count(array) {
+  if (!Array.isArray(array)) return 0;
+  return array.length;
+}
+
+/**
+ * Get unique values from array
+ * @param {Array} array - Array to dedupe
+ * @param {string} [field] - Optional field path
+ * @returns {Array}
+ */
+function unique(array, field) {
+  if (!Array.isArray(array)) return [];
+  const seen = new Set();
+  const result = [];
+  for (const item of array) {
+    const value = field ? get(item, field) : item;
+    const key = JSON.stringify(value);
+    if (!seen.has(key)) {
+      seen.add(key);
+      result.push(value);
+    }
+  }
+  return result;
+}
+
+// ============================================================================
+// Object Access Helpers
+// ============================================================================
+
+/**
+ * Get nested value using dot notation path
+ * @param {Object} obj - Object to access
+ * @param {string} path - Dot notation path (e.g., "priority.name")
+ * @returns {*}
+ */
+function get(obj, path) {
+  if (obj == null || typeof path !== 'string') return undefined;
+  const parts = path.split('.');
+  let current = obj;
+  for (const part of parts) {
+    if (current == null) return undefined;
+    // Handle array index notation (e.g., "items.0.name")
+    const index = parseInt(part, 10);
+    if (!isNaN(index) && Array.isArray(current)) {
+      current = current[index];
+    } else {
+      current = current[part];
+    }
+  }
+  return current;
+}
+
+/**
+ * Create object with only specified keys
+ * @param {Object} obj - Source object
+ * @param {Array<string>} keys - Keys to include
+ * @returns {Object}
+ */
+function pick(obj, keys) {
+  if (obj == null || !Array.isArray(keys)) return {};
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+/**
+ * Create object without specified keys
+ * @param {Object} obj - Source object
+ * @param {Array<string>} keys - Keys to exclude
+ * @returns {Object}
+ */
+function omit(obj, keys) {
+  if (obj == null) return {};
+  const keysSet = new Set(keys || []);
+  const result = {};
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key) && !keysSet.has(key)) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+// ============================================================================
+// Date Helpers
+// ============================================================================
+
+/**
+ * Parse date string to timestamp (milliseconds)
+ * @param {string|number|Date} value - Date value to parse
+ * @returns {number|null}
+ */
+function parseDate(value) {
+  if (value == null) return null;
+  if (typeof value === 'number') return value;
+  const ts = Date.parse(value);
+  return isNaN(ts) ? null : ts;
+}
+
+/**
+ * Format timestamp to string
+ * @param {number|string|Date} ts - Timestamp or date
+ * @param {string} [format] - Format string (simplified: 'iso', 'date', 'time', or 'datetime')
+ * @returns {string}
+ */
+function formatDate(ts, format) {
+  const date = new Date(typeof ts === 'number' ? ts : Date.parse(ts));
+  if (isNaN(date.getTime())) return '';
+
+  switch (format) {
+    case 'date':
+      return date.toISOString().split('T')[0];
+    case 'time':
+      return date.toISOString().split('T')[1].split('.')[0];
+    case 'datetime':
+      return date.toISOString().replace('T', ' ').split('.')[0];
+    case 'iso':
+    default:
+      return date.toISOString();
+  }
+}
+
+/**
+ * Calculate days between two dates
+ * @param {string|number|Date} date1 - First date
+ * @param {string|number|Date} date2 - Second date
+ * @returns {number}
+ */
+function daysBetween(date1, date2) {
+  const ts1 = parseDate(date1);
+  const ts2 = parseDate(date2);
+  if (ts1 == null || ts2 == null) return 0;
+  const msPerDay = 24 * 60 * 60 * 1000;
+  return Math.round(Math.abs(ts2 - ts1) / msPerDay);
+}
+`;
+/**
+ * Get the JavaScript code for helper functions
+ */
+export function getHelperFunctionsCode() {
+    return HELPER_FUNCTIONS_JS;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/sandbox/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/sandbox/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0OlC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/utils/sandbox/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sandbox Executor
+ *
+ * Main entry point for executing LLM-generated JavaScript transformations
+ * in a secure QuickJS WebAssembly sandbox.
+ */
+import type { TransformInput, TransformResult, TransformError, TransformContext } from "./types.js";
+export type { TransformInput, TransformResult, TransformError, TransformContext, SandboxLimits, TableConfig, ListConfig, TableColumn, LinkConfig, StyleConfig, ConditionalFormat, FilterCondition, } from "./types.js";
+export { BufferTransformInputSchema, type BufferTransformInput } from "./schema.js";
+/**
+ * Execute JavaScript code in a QuickJS sandbox
+ *
+ * @param input - Transform input (inputs, code, limits)
+ * @param context - Transform context (URLs for link generation)
+ * @param inputData - Pre-loaded input data (buffer contents as parsed JSON)
+ * @returns Transform result or error
+ */
+export declare function executeTransform(input: TransformInput, context: TransformContext, inputData: Record<string, unknown>): Promise<TransformResult | TransformError>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAsCpF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,eAAe,GAAG,cAAc,CAAC,CA8K3C"}

package/dist/utils/sandbox/index.js

@@ -0,0 +1,269 @@
+/**
+ * Sandbox Executor
+ *
+ * Main entry point for executing LLM-generated JavaScript transformations
+ * in a secure QuickJS WebAssembly sandbox.
+ */
+import { getQuickJS } from "quickjs-emscripten";
+import { getHelperFunctionsCode } from "./helpers.js";
+import { getFormatterFunctionsCode } from "./formatters.js";
+export { BufferTransformInputSchema } from "./schema.js";
+/** Default execution timeout in milliseconds */
+const DEFAULT_TIMEOUT_MS = 5000;
+/** Default memory limit in bytes (50MB) */
+const DEFAULT_MEMORY_LIMIT = 50 * 1024 * 1024;
+/** Maximum string length for JSON serialization */
+const MAX_JSON_LENGTH = 10 * 1024 * 1024; // 10MB
+/**
+ * Create a transform error
+ */
+function createError(message, code, details) {
+    return {
+        error: true,
+        message,
+        code,
+        details,
+    };
+}
+/**
+ * Serialize a value for injection into sandbox
+ */
+function serializeForSandbox(value) {
+    const json = JSON.stringify(value);
+    if (json.length > MAX_JSON_LENGTH) {
+        throw new Error(`Value too large to serialize (${json.length} bytes)`);
+    }
+    return json;
+}
+/**
+ * Execute JavaScript code in a QuickJS sandbox
+ *
+ * @param input - Transform input (inputs, code, limits)
+ * @param context - Transform context (URLs for link generation)
+ * @param inputData - Pre-loaded input data (buffer contents as parsed JSON)
+ * @returns Transform result or error
+ */
+export async function executeTransform(input, context, inputData) {
+    const QuickJS = await getQuickJS();
+    // Get limits with defaults
+    const timeout = input.limits?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const memoryLimit = input.limits?.memory ?? DEFAULT_MEMORY_LIMIT;
+    // Create runtime with memory limit
+    const runtime = QuickJS.newRuntime();
+    runtime.setMemoryLimit(memoryLimit);
+    // Set up interrupt handler for timeout
+    const startTime = Date.now();
+    let interrupted = false;
+    runtime.setInterruptHandler(() => {
+        if (Date.now() - startTime > timeout) {
+            interrupted = true;
+            return true; // Interrupt execution
+        }
+        return false;
+    });
+    // Create context
+    const ctx = runtime.newContext();
+    try {
+        // Inject helper functions
+        const helperCode = getHelperFunctionsCode();
+        const helperResult = ctx.evalCode(helperCode);
+        if (helperResult.error) {
+            const errorValue = ctx.dump(helperResult.error);
+            helperResult.error.dispose();
+            return createError(`Failed to initialize helpers: ${errorValue}`, "RUNTIME_ERROR");
+        }
+        helperResult.value.dispose();
+        // Inject formatter functions
+        const formatterCode = getFormatterFunctionsCode();
+        const formatterResult = ctx.evalCode(formatterCode);
+        if (formatterResult.error) {
+            const errorValue = ctx.dump(formatterResult.error);
+            formatterResult.error.dispose();
+            return createError(`Failed to initialize formatters: ${errorValue}`, "RUNTIME_ERROR");
+        }
+        formatterResult.value.dispose();
+        // Inject context variables (URLs)
+        if (context.jiraUrl) {
+            const jiraUrlResult = ctx.evalCode(`const JIRA_URL = ${JSON.stringify(context.jiraUrl)};`);
+            if (jiraUrlResult.error) {
+                jiraUrlResult.error.dispose();
+            }
+            else {
+                jiraUrlResult.value.dispose();
+            }
+        }
+        else {
+            const jiraUrlResult = ctx.evalCode(`const JIRA_URL = undefined;`);
+            if (jiraUrlResult.error) {
+                jiraUrlResult.error.dispose();
+            }
+            else {
+                jiraUrlResult.value.dispose();
+            }
+        }
+        if (context.confluenceUrl) {
+            const confUrlResult = ctx.evalCode(`const CONFLUENCE_URL = ${JSON.stringify(context.confluenceUrl)};`);
+            if (confUrlResult.error) {
+                confUrlResult.error.dispose();
+            }
+            else {
+                confUrlResult.value.dispose();
+            }
+        }
+        else {
+            const confUrlResult = ctx.evalCode(`const CONFLUENCE_URL = undefined;`);
+            if (confUrlResult.error) {
+                confUrlResult.error.dispose();
+            }
+            else {
+                confUrlResult.value.dispose();
+            }
+        }
+        // Inject input data as globals
+        for (const [name, data] of Object.entries(inputData)) {
+            // Validate variable name
+            if (!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)) {
+                return createError(`Invalid input name: "${name}". Must be a valid JavaScript identifier.`, "INVALID_INPUT", { name });
+            }
+            try {
+                const serialized = serializeForSandbox(data);
+                const injectCode = `const ${name} = ${serialized};`;
+                const injectResult = ctx.evalCode(injectCode);
+                if (injectResult.error) {
+                    const errorValue = ctx.dump(injectResult.error);
+                    injectResult.error.dispose();
+                    return createError(`Failed to inject input "${name}": ${errorValue}`, "INVALID_INPUT", { name });
+                }
+                injectResult.value.dispose();
+            }
+            catch (e) {
+                return createError(`Failed to serialize input "${name}": ${e.message}`, "INVALID_INPUT", { name });
+            }
+        }
+        // Wrap user code in IIFE
+        const wrappedCode = `(function() {\n${input.code}\n})()`;
+        // Execute user code
+        const result = ctx.evalCode(wrappedCode);
+        // Check for timeout
+        if (interrupted) {
+            if (result.error)
+                result.error.dispose();
+            else if (result.value)
+                result.value.dispose();
+            return createError(`Execution timeout: code took longer than ${timeout}ms`, "TIMEOUT", { timeout });
+        }
+        // Check for runtime error
+        if (result.error) {
+            const errorValue = ctx.dump(result.error);
+            result.error.dispose();
+            // Try to extract line/column info
+            let details = {};
+            if (typeof errorValue === "object" && errorValue !== null) {
+                const errObj = errorValue;
+                if ("stack" in errObj) {
+                    details.stack = String(errObj.stack);
+                    // Try to parse line number from stack
+                    const lineMatch = String(errObj.stack).match(/:(\d+):(\d+)/);
+                    if (lineMatch) {
+                        details.line = parseInt(lineMatch[1], 10) - 1; // Adjust for IIFE wrapper
+                        details.column = parseInt(lineMatch[2], 10);
+                    }
+                }
+            }
+            return createError(`Runtime error: ${typeof errorValue === "object" ? JSON.stringify(errorValue) : errorValue}`, "RUNTIME_ERROR", details);
+        }
+        // Extract return value
+        const returnValue = ctx.dump(result.value);
+        result.value.dispose();
+        // Process return value
+        return processReturnValue(returnValue);
+    }
+    finally {
+        // Clean up
+        ctx.dispose();
+        runtime.dispose();
+    }
+}
+/**
+ * Check if value is a marked XHTML object
+ */
+function isXhtmlMarked(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "__xhtml" in value &&
+        value.__xhtml === true);
+}
+/**
+ * Check if value is a marked Markdown object
+ */
+function isMarkdownMarked(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "__markdown" in value &&
+        value.__markdown === true);
+}
+/**
+ * Process the return value from sandbox execution
+ * Determines if it's XHTML, Markdown, single output, or multiple outputs
+ */
+function processReturnValue(value) {
+    // Handle undefined/null
+    if (value === undefined || value === null) {
+        return createError("Code must return a value. Use 'return' to specify the output.", "INVALID_RETURN");
+    }
+    // Check for XHTML marker (from toTable/toList)
+    if (isXhtmlMarked(value)) {
+        return {
+            contentType: "xhtml",
+            xhtmlContent: value.content,
+        };
+    }
+    // Check for Markdown marker (from toMarkdownTable/toMarkdownList)
+    if (isMarkdownMarked(value)) {
+        return {
+            contentType: "markdown",
+            markdownContent: value.content,
+        };
+    }
+    // Check for multiple outputs (object with at least one __xhtml or __markdown value)
+    // We only split into multiple outputs when there are format markers to avoid
+    // misinterpreting regular objects (like groupBy results) as multiple outputs
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        const keys = Object.keys(obj);
+        // Check if any values are XHTML or Markdown objects
+        const hasFormatted = keys.some((k) => isXhtmlMarked(obj[k]) || isMarkdownMarked(obj[k]));
+        if (hasFormatted) {
+            // Multiple outputs - return as multipleOutputs
+            const outputs = {};
+            for (const [key, val] of Object.entries(obj)) {
+                if (isXhtmlMarked(val)) {
+                    outputs[key] = {
+                        contentType: "xhtml",
+                        content: val.content,
+                    };
+                }
+                else if (isMarkdownMarked(val)) {
+                    outputs[key] = {
+                        contentType: "markdown",
+                        content: val.content,
+                    };
+                }
+                else {
+                    outputs[key] = { contentType: "json", content: val };
+                }
+            }
+            return {
+                contentType: "json",
+                multipleOutputs: outputs,
+            };
+        }
+    }
+    // Single JSON output (array or object)
+    return {
+        contentType: "json",
+        jsonContent: value,
+        itemCount: Array.isArray(value) ? value.length : undefined,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/sandbox/index.js.map

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

package/dist/utils/sandbox/schema.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Sandbox Schemas
+ *
+ * Zod validation schemas for buffer_transform tool input.
+ */
+import { z } from "zod";
+/**
+ * Schema for execution limits
+ */
+export declare const SandboxLimitsSchema: z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    memory: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout?: number | undefined;
+    memory?: number | undefined;
+}, {
+    timeout?: number | undefined;
+    memory?: number | undefined;
+}>;
+/**
+ * Schema for buffer_transform tool input
+ */
+export declare const BufferTransformInputSchema: z.ZodObject<{
+    inputs: z.ZodRecord<z.ZodString, z.ZodString>;
+    code: z.ZodString;
+    limits: z.ZodOptional<z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        memory: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        timeout?: number | undefined;
+        memory?: number | undefined;
+    }, {
+        timeout?: number | undefined;
+        memory?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    inputs: Record<string, string>;
+    limits?: {
+        timeout?: number | undefined;
+        memory?: number | undefined;
+    } | undefined;
+}, {
+    code: string;
+    inputs: Record<string, string>;
+    limits?: {
+        timeout?: number | undefined;
+        memory?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * Type for validated input
+ */
+export type BufferTransformInput = z.infer<typeof BufferTransformInputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/sandbox/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/sandbox/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAa9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}