Common Errors

Error: VALIDATION_ERROR - Identifier 'eval' is not allowed

if (!result.success && result.error?.code === 'VALIDATION_ERROR') {
  console.log('Validation failed:', result.error.message);
  // Review and fix the code
}

Error: TIMEOUT - Execution exceeded 5000ms timeout

const enclave = new Enclave({
  timeout: 30000, // Increase to 30s
});

Error: MAX_TOOL_CALLS - Exceeded limit of 50 tool calls

// Bad: Many individual calls
for (const id of ids) {
  await callTool('users:get', { id });
}

// Better: Batch call
await callTool('users:getMany', { ids });

Error: MAX_ITERATIONS - Exceeded limit of 10000 iterations

Error: TOOL_ERROR - Tool 'users:get' failed: User not found

toolHandler: async (name, args) => {
  try {
    return await executeToolSafely(name, args);
  } catch (error) {
    // Return structured error instead of throwing
    return { error: true, message: error.message };
  }
}

Error: MEMORY_LIMIT_EXCEEDED - Used 64MB (limit: 32MB)

const enclave = new Enclave({
  memoryLimit: 64 * 1024 * 1024, // 64MB
  sidecar: { enabled: true }, // For large data
});

Error: SCORING_BLOCKED - Score 75 exceeds threshold 70

const preset = createAgentScriptPreset({
  allowedGlobals: ['callTool', 'Math', 'JSON', 'context'],
});

// Bad: while loop
while (hasMore) { /* ... */ }

// Good: for loop
for (let i = 0; i < maxIterations && hasMore; i++) { /* ... */ }

// Bad: function declaration
function process(item) { return item.value; }

// Good: arrow in array method
items.map(item => item.value);

const enclave = new Enclave({
  verboseErrors: true,
});

import { JSAstValidator, createAgentScriptPreset } from '@enclave-vm/ast';

const validator = new JSAstValidator(createAgentScriptPreset());
const result = await validator.validate(code);

if (!result.valid) {
  console.log('Validation issues:');
  for (const issue of result.issues) {
    console.log(`  ${issue.rule}: ${issue.message}`);
    if (issue.location) {
      console.log(`    at line ${issue.location.line}, column ${issue.location.column}`);
    }
  }
}

const result = await enclave.run(code);

console.log('Execution stats:', {
  duration: result.stats.duration,
  toolCalls: result.stats.toolCallCount,
  iterations: result.stats.iterationCount,
  memory: result.stats.memoryUsage,
});