Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

5.9 KB
Raw Blame
// Copyright 2026 The OpenSandbox Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//go:build windows

package runtime

import (
	"context"
	"io"
	"time"

	"github.com/alibaba/opensandbox/execd/pkg/isolation"
	"github.com/alibaba/opensandbox/execd/pkg/vfs"
)

// IsolatedSessionOptions bundles creation parameters (Windows stub).
type IsolatedSessionOptions struct {
	Profile            string
	WorkspacePath      string
	WorkspaceMode      string
	Overlays           []IsolatedOverlayOptions
	ExtraWritable      []string
	Binds              []isolation.BindMount
	ShareNet           *bool
	EnvPassthroughMode string
	EnvPassthroughKeys []string
	Uid                *uint32
	Gid                *uint32
	UidMode            string
	IdleTimeoutSeconds int
}

// IsolatedOverlayOptions describes one overlay mount (Windows stub).
type IsolatedOverlayOptions struct {
	Path    string
	Mode    string
	Persist *bool
}

// StdoutCallback is called per line of stdout (Windows stub).
type StdoutCallback func(line string)

// IsolatedRunner is the isolated session runner (Windows stub).
type IsolatedRunner struct{}

// NewIsolatedRunner returns nil on Windows (isolation not supported).
func NewIsolatedRunner(_ *Controller, _ isolation.Isolator, _ isolation.Config) (*IsolatedRunner, error) {
	return &IsolatedRunner{}, nil
}

// StopGC is a no-op on Windows.
func (r *IsolatedRunner) StopGC() {}

// Close is a no-op on platforms without isolated-session support.
func (r *IsolatedRunner) Close() error { return nil }

// Reset is a no-op on platforms without isolated-session support.
func (r *IsolatedRunner) Reset() error { return nil }

// Available reports false on Windows.
func (r *IsolatedRunner) Available() bool { return false }

// CreateIsolatedSession returns an error on Windows.
func (r *IsolatedRunner) CreateIsolatedSession(_ *IsolatedSessionOptions) (string, error) {
	return "", ErrContextNotFound
}

// GetIsolatedSession returns an error on Windows.
func (r *IsolatedRunner) GetIsolatedSession(_ string) (*IsolatedSessionState, error) {
	return nil, ErrContextNotFound
}

// ListIsolatedSessions returns an empty list on Windows.
func (r *IsolatedRunner) ListIsolatedSessions() []IsolatedSessionSummary {
	return []IsolatedSessionSummary{}
}

// RunInIsolatedSession returns an error on Windows.
func (r *IsolatedRunner) RunInIsolatedSession(_ context.Context, _ string, _ string, _ map[string]string, _ StdoutCallback) error {
	return ErrContextNotFound
}

// RunInIsolatedSessionBackground returns an error on Windows.
func (r *IsolatedRunner) RunInIsolatedSessionBackground(_ string, _ string, _ map[string]string) (string, time.Time, error) {
	return "", time.Time{}, ErrContextNotFound
}

// IsolatedBackgroundRunSnapshot describes a background run (Windows stub —
// kept in sync with the non-Windows build so controller code compiles on both).
type IsolatedBackgroundRunSnapshot struct {
	RunID      string
	SessionID  string
	Running    bool
	ExitCode   *int
	Error      string
	StartedAt  time.Time
	FinishedAt *time.Time
}

// GetIsolatedBackgroundRun returns an error on Windows.
func (r *IsolatedRunner) GetIsolatedBackgroundRun(_ string, _ string) (*IsolatedBackgroundRunSnapshot, error) {
	return nil, ErrContextNotFound
}

// SeekIsolatedBackgroundOutput returns an error on Windows.
func (r *IsolatedRunner) SeekIsolatedBackgroundOutput(_ string, _ string, _ int64) ([]byte, int64, error) {
	return nil, -1, ErrContextNotFound
}

// removeSessionBackgroundRuns is a no-op on Windows.
// (Takes the session ID rather than the !windows-only isolatedSession type.)
func (r *IsolatedRunner) removeSessionBackgroundRuns(_ string) {}

// DeleteIsolatedSession returns an error on Windows.
func (r *IsolatedRunner) DeleteIsolatedSession(_ string) error {
	return ErrContextNotFound
}

// DiffUpper returns an error on Windows.
func (r *IsolatedRunner) DiffUpper(_ string, _ io.Writer) error {
	return nil
}

// CommitUpper returns an error on Windows.
func (r *IsolatedRunner) CommitUpper(_ string) error {
	return nil
}

// GetMergedView returns an error on Windows.
func (r *IsolatedRunner) GetMergedView(_ string) (vfs.FS, error) {
	return nil, ErrContextNotFound
}

// GetMergedViewWithLease returns an error on Windows.
func (r *IsolatedRunner) GetMergedViewWithLease(_ string) (vfs.FS, func(), error) {
	return nil, nil, ErrContextNotFound
}

// Capabilities returns empty capabilities on Windows.
func (r *IsolatedRunner) Capabilities() isolation.Capabilities {
	return isolation.Capabilities{Available: false}
}

// IsolatedSessionState is the session state (Windows stub — kept in sync
// with the non-Windows build so controller code compiles on both.)
type IsolatedSessionState struct {
	Status               string
	CreatedAt            time.Time
	LastRunAt            time.Time
	IdleRemainingSeconds *int

	// Creation-parameter echoes. Never populated on Windows (isolation
	// is unavailable) but kept to match the non-Windows struct layout.
	Profile            string
	Overlays           []IsolatedOverlayOptions
	ExtraWritable      []string
	Binds              []isolation.BindMount
	ShareNet           *bool
	EnvPassthroughMode string
	EnvPassthroughKeys []string
	Uid                *uint32
	Gid                *uint32
	UidMode            string
	IdleTimeoutSeconds int
}

// IsolatedSessionSummary describes a session in a list response (Windows stub).
type IsolatedSessionSummary struct {
	SessionID string
	IsolatedSessionState
}