Support Windows-based sandbox runtime

[jwx0925]

Summary

OpenSandbox currently supports running the server on Linux, macOS, or Windows with WSL2, and the built-in runtime backends are Docker and Kubernetes. However, the built-in sandbox environments appear to target Linux container workloads only.

It would be useful to support Windows-based sandboxes as a first-class runtime option.

Current Situation

From the current documentation and implementation:

• server/README.md documents Docker and Kubernetes as runtime backends.
• server/README.md mentions Windows with WSL2 as a supported host environment for running the server.
• Built-in sandbox images such as sandboxes/code-interpreter are based on Ubuntu/Linux.
• There is some Windows-related compatibility code in execd, but this seems to be host/runtime compatibility rather than support for Windows guest sandboxes.

Because of this, it is unclear whether Windows sandbox workloads are intentionally unsupported, planned, or simply undocumented.

Motivation

Windows-based sandboxes would help with workloads such as:

• Running Windows-only tools or binaries
• Testing agent workflows against native Windows environments
• Supporting desktop automation scenarios that require Windows
• Validating cross-platform behavior for generated code or installers

Proposal

Please consider adding official support, or at least clarifying the roadmap/status, for one or more of the following:

• Windows container-based sandboxes
• Windows VM-based sandboxes
• A pluggable Windows runtime/provider implementation
• Documentation describing why Windows guest sandboxes are not currently supported and what would be required to add them

Questions

1. Is Windows sandbox runtime support currently out of scope, planned, or under discussion?
2. If it is feasible, which direction is preferred:
   • Windows containers
   • Windows VMs
   • custom provider/runtime extension
3. Are there architectural constraints in the current Docker/Kubernetes runtime model that make Windows guest support difficult?

Expected Outcome

At minimum, it would help to have:

• an explicit statement in the docs about whether Windows guest sandboxes are supported
• a roadmap note or design guidance for users who need Windows sandbox environments

Thanks.