Home Docs Blog Product Contact

Execution Kernel

The Execution Kernel is the low-level runtime that sits between the Omni-Agent and the operating system. It manages process spawning, output capture, error detection, and sandbox enforcement.

Responsibilities

  • Process Management — Spawns and monitors child processes for terminal commands
  • Output Capture — Captures stdout and stderr streams in real-time for agent analysis
  • Exit Code Monitoring — Detects non-zero exit codes to trigger self-healing
  • Timeout Enforcement — Kills runaway processes that exceed the configured timeout
  • Sandbox Enforcement — Applies file system and network restrictions

Architecture

The Execution Kernel is implemented in TypeScript/Node.js as part of the VS Code core extension system. It uses Node.js child_process APIs with custom wrappers for sandboxing and monitoring.

// Simplified kernel execution flow
const result = await kernel.execute({
  command: "npm install express",
  cwd: workspace.rootPath,
  timeout: 30000,
  sandbox: true
});

if (result.exitCode !== 0) {
  await agent.heal(result.stderr);
}

Related