Trust by default

Every agent runs
isolated by default.

AI agents that read your files and run shell commands cannot run in your app process. Actana ships isolation as the default — not the upgrade. Two sandbox flavors, OTP-rotated tokens, MCP-bridged tools, full NDJSON audit log.

Pi sandbox · default

Docker container, full isolation

~2-3s startup. Asset round-trip supported. MCP server bridging via mcporter. Multi-file skill bundles with executables. Default for production.

  • → Process-level + filesystem isolation
  • → File round-trip into $WORKSPACE_DIR/assets/
  • → Pi builtins + extensions
  • → Symlinks stripped at extract
SDK sandbox · dev

Native Node, fast startup

~200ms startup. Process-level isolation. 23 built-in tools. Single-file skills. For dev / fast inner loop where assets aren't needed.

  • → Native runtime
  • → In-memory skill activation
  • → Faster iteration
  • → Pluggable per-task
Provisioning lifecycle

Nine deterministic phases.

Provisioning, OTP rotation, queue acquisition, container creation, bootstrap, materialization, execution, result upload, cleanup. Every phase emits a structured log line.

OTP-only

No long-lived secrets

Each provision generates three single-use tokens (setup / run / upload). The sandbox never sees a long-lived credential.

MCP bridged

Native MCP support

mcporter generates tool shims so agents call MCP tools as if they were native. No MCP plumbing exposed to end users.

NDJSON audit

Live = archive

Every sandbox run produces stream.jsonl, result.json, steps.json. Same shape live as in Logs. Watch it now or replay later.

Asset limits

20 files · 25 MB · 50 MB total

Whitelisted extensions. Filenames sanitized to [a-zA-Z0-9._-]. Duplicates suffixed automatically.

Per-run isolation

Files are forever traceable

Every workflow execution gets its own files folder. Outputs are pinned to the run that produced them.

30s timeout

Deterministic limits

Default 30s execution timeout (configurable via MAX_EXECUTION_TIME_SEC). Container force-removed on completion.

If you can't audit it, you can't ship it.