Ephemeral execution microservice
Run Python or Bash. Tear the workspace down.
Accept an execution request over REST, CLI, or MCP. Resolve code from Catalox or an inline manifest. Return structured output. Workspaces never persist.
npm
Install for agents & tooling
Knowledge SDK — install as a devDependency only (not a production runtime).
npm i -D @x12i/runner-docs
The service
Dual-mode
Exactly one of scriptId (Catalox) or inline code — never both.
Ephemeral workspace
Hydrate a temp dir, run with a hard timeout, delete everything.
Payload as file
payload.json at the workspace root — never interpolated into source.
One pipeline
REST, CLI, and MCP all call the same run_execution path.
MCP ready
Stdio for local agents; Streamable HTTP at /mcp on the daemon.
Ops simple
Docker, systemd, VPN bind — health and ready probes included.