Skip to content

SDK reference

The SDKs share one runtime model:

  • mvm executes sandboxes and enforces local runtime policy.
  • Workload IR is the shared build/deploy contract.
  • Runtime recordings and static decorators both lower into the same build path.
LanguageCurrent statusUse today
PythonPartial runtime SDK plus declarative workload SDK.Local runtime scripts and static declarations.
TypeScript/Node.jsPartial runtime SDK plus declarative workload SDK.Local runtime scripts and static declarations.
RustBuild-time SDK and lower-level IR contract.Tooling, generators, and typed declarations.

The language SDKs should converge on:

  • Sandbox.create(...)
  • sandbox.commands.run(...)
  • sandbox.files.read/write/list/remove(...)
  • sandbox.logs(...)
  • sandbox.ports.forward(...)
  • sandbox.snapshot(...)
  • sandbox.cold() / sandbox.resume()
  • sandbox.stop() / sandbox.destroy()
  • explicit audit/run identifiers in returned results

Methods not implemented in a language SDK should stay documented as planned, not implied by examples.