Skip to content

ADR 0001: One engine in Rust, thin adapters

Status: Accepted ยท 2026-11-17

Context

Wayloop must be fast, deterministic and usable from many places: a terminal, Python, Node, any agent through MCP, Claude Code and Codex plugins, GitHub workflows.

Decision

All decision logic lives in one Rust crate without I/O (wayloop-core). The CLI, the Python SDK (PyO3), the TypeScript SDK (napi-rs), the MCP server and the plugins are adapters: they translate requests and responses, and never decide. Contracts are JSON with versioned schemas.

Consequences

  • One behaviour everywhere: a bug is fixed once.
  • A slower start than a Python-only tool. The contracts are defined before the code, so the adapters can be written in parallel.
  • Adapters that need new behaviour ask the core for it.