Skip to main content
Version: v0.2 (Next)

Tools, MCP & Skill Runtimes

ActonOS provides an extensible, multi-protocol execution engine organized into 3 distinct extension tiers: Tier 1 (Native Tools & MCP Servers), Tier 2 (Unified WASM Plugins), and Tier 3 (Skill-as-a-Folder Scripts).

1. Tier 1: Native Built-in Tools & MCP Servers​

Native Tools​

Pre-compiled directly into the actond static binary for maximum speed:

  • native_web_search: Query DuckDuckGo, Brave Search, or Tavily for current web information.
  • native_browser_headless: Chromium web automation via chromedp (DOM extraction, JavaScript rendering, full-page screenshots).
  • native_workspace_read & native_workspace_write: Sandboxed file operations under /workspace.
  • native_exec: Execute shell commands inside the isolated Bubblewrap/Subshell sandbox.
  • native_sql_query: Query structured application databases and workspace SQLite files.

Model Context Protocol (MCP) Integration​

ActonOS acts as a native MCP Host implementing the open standard by Anthropic:

  • stdio: Spawns local CLI binaries or containerized processes communicating over stdin/stdout JSON-RPC.
  • http / sse: Connects to remote or network-accessible MCP endpoints over Server-Sent Events.
  • Sensitive environment variables are stored in the Hardware Vault under mcp.env.<id>.

2. Tier 2: Unified WASM Plugins (WASMLoader)​

High-performance, polyglot extensions compiled to WebAssembly (wasip1 / wasm32-wasi) running on the pure-Go Wazero JIT runtime:

  • Sandboxed Execution: Isolated linear memory instances with zero host file system access except through host syscalls.
  • Egress Firewall: Network requests are strictly constrained to hostnames whitelisted in manifest.permissions.net_outbound.
  • Capabilities: Unifies Agent Tools, Chat Channels, and SaaS Connectors into standardized .actonpkg packages.

3. Tier 3: Skill-as-a-Folder Architecture​

Users and developers can author custom lightweight skills simply by creating a directory inside /data/skills/:

/data/skills/my_custom_skill/
β”œβ”€β”€ skill.json      # Tool schema & parameter definitions
└── run.sh          # Executable script (or run.py)

Hot-Reloading with fsnotify​

The ActonOS skill watcher monitors /data/skills/. Creating, editing, or deleting a skill directory triggers an automatic registration update without requiring a daemon restart.