driver

type ExecChunk struct {
	// Text is valid UTF-8. Runtime byte streams must buffer incomplete rune
	// suffixes and replace irrecoverably invalid input before emitting a chunk.
	Text   string
	Stream StdioStream
}

type ExecResult struct {
	ExitCode int
	Stdout   string
	Stderr   string
	Output   string
	Success  bool
}

type ExecSpec struct {
	Command string            `json:"command"`
	Args    []string          `json:"args,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
	Cwd     string            `json:"cwd,omitempty"`
}

type ExecStreamInteractionRequest struct {
	Session *Sandbox
	VMState VMState
	Spec    RuntimeStartSpec
}

type ExecStreamWriter func(ExecChunk)

type GuestDirectoryPublication struct {
	HostSource       string
	GuestDestination string
	ManagedMarker    string
}

type GuestSymlinkProjection struct {
	GuestPath      string
	RelativeTarget string
	ManagedMarkers []string
}

type ManagedRuntimeResource struct {
	Driver         string
	RuntimeID      string
	SandboxID      string
	UpdatedAt      time.Time
	OwnershipValid bool
	Removable      bool
	BlockedReasons []string
	OwnedPaths     []string
}

type MetricValue struct {
	Value   *float64
	Unit    string
	Status  string
	Message string
}

type ProxyState struct {
	ProxyPath  string `json:"proxy_path"`
	GuestHost  string `json:"guest_host"`
	HostPort   int    `json:"host_port"`
	GuestPort  int    `json:"guest_port"`
	JupyterURL string `json:"jupyter_url,omitempty"`
	Token      string `json:"token,omitempty"`
	Enabled    bool   `json:"enabled,omitempty"`
	Exposed    bool   `json:"exposed,omitempty"`
}

type ProxyStateReader func(sandboxID string) (ProxyState, error)

type RuntimeAgentEvent struct {
	Type     string            `json:"type"`
	Message  string            `json:"message,omitempty"`
	Payload  []byte            `json:"payload,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type RuntimeAgentSpec struct {
	Provider  string            `json:"provider,omitempty"`
	Model     string            `json:"model,omitempty"`
	Prompt    string            `json:"prompt,omitempty"`
	SessionID string            `json:"session_id,omitempty"`
	Metadata  map[string]string `json:"metadata,omitempty"`
}

type RuntimeCommandSpec struct {
	Command string            `json:"command"`
	Args    []string          `json:"args,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
	Cwd     string            `json:"cwd,omitempty"`
}

type RuntimeDriverNotCompiledError struct {
	Driver          string
	GOOS            string
	GOARCH          string
	CompiledDrivers []string
}

type RuntimeError struct {
	Code    string `json:"code,omitempty"`
	Message string `json:"message"`
}

type RuntimeInputFrame struct {
	Type    RuntimeInputFrameType `json:"type"`
	Data    []byte                `json:"data,omitempty"`
	Rows    uint32                `json:"rows,omitempty"`
	Cols    uint32                `json:"cols,omitempty"`
	Signal  RuntimeSignal         `json:"signal,omitempty"`
	Message string                `json:"message,omitempty"`
}

type RuntimeInputFrameType string

type RuntimeInteraction interface {
	Send(RuntimeInputFrame) error
	CloseSend() error
	Recv() (RuntimeOutputFrame, error)
	Wait() (RuntimeResult, error)
}

type RuntimeInteractionCapabilities struct {
	NativeExec    bool `json:"native_exec"`
	WrapperStream bool `json:"wrapper_stream"`
	Stdin         bool `json:"stdin"`
	StdinEOF      bool `json:"stdin_eof"`
	TTY           bool `json:"tty"`
	Resize        bool `json:"resize"`
	Signal        bool `json:"signal"`
	Artifacts     bool `json:"artifacts"`
	AgentTurns    bool `json:"agent_turns"`
}

type RuntimeInteractionCapability string

type RuntimeInteractionUnsupportedError struct {
	Driver     string
	Operation  RuntimeOperationKind
	Capability RuntimeInteractionCapability
	Reason     string
}

type RuntimeInteractor interface {
	InteractionCapabilities() RuntimeInteractionCapabilities
	OpenInteraction(context.Context, *Sandbox, VMState, RuntimeStartSpec) (RuntimeInteraction, error)
}

type RuntimeMount struct {
	HostPath  string `json:"hostPath"`
	GuestPath string `json:"guestPath"`
	Type      string `json:"type"`
	ReadOnly  bool   `json:"readOnly"`
}

type RuntimeMountManifest struct {
	Version int            `json:"version"`
	Driver  string         `json:"driver"`
	Mounts  []RuntimeMount `json:"mounts"`
}

type RuntimeOperationKind string

type RuntimeOutputFrame struct {
	Type RuntimeOutputFrameType `json:"type"`
	// Data in stdout and stderr frames is valid UTF-8 text. Runtime byte
	// streams must complete or replace invalid rune fragments before emitting.
	Data      []byte             `json:"data,omitempty"`
	Event     *RuntimeAgentEvent `json:"event,omitempty"`
	Result    *RuntimeResult     `json:"result,omitempty"`
	Error     *RuntimeError      `json:"error,omitempty"`
	StartedAt time.Time          `json:"started_at,omitempty"`
}

type RuntimeOutputFrameType string

type RuntimeResult struct {
	OperationID string            `json:"operation_id,omitempty"`
	ExitCode    int               `json:"exit_code"`
	Success     bool              `json:"success"`
	Error       string            `json:"error,omitempty"`
	StartedAt   time.Time         `json:"started_at,omitempty"`
	CompletedAt time.Time         `json:"completed_at,omitempty"`
	Artifacts   map[string]string `json:"artifacts,omitempty"`
}

type RuntimeSignal string

type RuntimeStartSpec struct {
	OperationID string               `json:"operation_id,omitempty"`
	Kind        RuntimeOperationKind `json:"kind"`
	Origin      string               `json:"origin,omitempty"`
	Command     *RuntimeCommandSpec  `json:"command,omitempty"`
	Agent       *RuntimeAgentSpec    `json:"agent,omitempty"`
	Cwd         string               `json:"cwd,omitempty"`
	Env         map[string]string    `json:"env,omitempty"`
	AttachStdin bool                 `json:"attach_stdin,omitempty"`
	TTY         bool                 `json:"tty,omitempty"`
	Rows        uint32               `json:"rows,omitempty"`
	Cols        uint32               `json:"cols,omitempty"`
	TimeoutMs   int64                `json:"timeout_ms,omitempty"`
	ArtifactDir string               `json:"artifact_dir,omitempty"`
}

type Sandbox struct {
	Summary         SandboxSummary       `json:"summary"`
	Workspace       *SandboxWorkspace    `json:"workspace,omitempty"`
	EnvItems        []SandboxEnvVar      `json:"env_items,omitempty"`
	VolumeMounts    []SandboxVolumeMount `json:"volume_mounts,omitempty"`
	RuntimeEnvItems []SandboxEnvVar      `json:"-"`
}

type SandboxEnvVar struct {
	Name   string `json:"name"`
	Value  string `json:"value,omitempty"`
	Secret bool   `json:"secret,omitempty"`
}

type SandboxRuntime interface {
	EnsureSandbox(context.Context, *Sandbox, VMState, ProxyState) (SandboxVMInfo, error)
	StopSandbox(context.Context, *Sandbox, VMState) (bool, error)
	RemoveSandbox(context.Context, *Sandbox, VMState) error
	Exec(context.Context, *Sandbox, VMState, ExecSpec) (ExecResult, error)
	ExecStream(context.Context, *Sandbox, VMState, ExecSpec, ExecStreamWriter) (ExecResult, error)
}

type SandboxStartTarget struct {
	Driver  string
	Session *Sandbox
	VMState VMState
}

type SandboxStats struct {
	SandboxID        string
	Driver           string
	SampledAt        time.Time
	CPUPercent       MetricValue
	MemoryUsageBytes MetricValue
	MemoryLimitBytes MetricValue
	MemoryPercent    MetricValue
	NetworkRxBytes   MetricValue
	NetworkTxBytes   MetricValue
	BlockReadBytes   MetricValue
	BlockWriteBytes  MetricValue
	UptimeSeconds    MetricValue
}

type SandboxSummary struct {
	ID            string    `json:"id"`
	Driver        string    `json:"driver"`
	GuestImage    string    `json:"guest_image,omitempty"`
	PullPolicy    string    `json:"pull_policy,omitempty"`
	RuntimeRef    string    `json:"runtime_ref,omitempty"`
	WorkspacePath string    `json:"workspace_path"`
	CreatedAt     time.Time `json:"created_at"`
	UpdatedAt     time.Time `json:"updated_at"`
}

type SandboxVMInfo struct {
	BoxID      string
	JupyterURL string
	ProxyState *ProxyState
}

type SandboxVolumeMount struct {
	ID       string `json:"id,omitempty"`
	Type     string `json:"type"`
	Source   string `json:"source"`
	Target   string `json:"target"`
	ReadOnly bool   `json:"read_only,omitempty"`
	VolumeID string `json:"volume_id,omitempty"`
	Driver   string `json:"driver,omitempty"`
	HostPath string `json:"host_path"`
}

type SandboxWorkspace struct {
	Type       string `json:"type"`
	ConfigJSON string `json:"config_json"`
}

type StdioStream string

type VMState struct {
	Driver           string    `json:"driver"`
	Mode             string    `json:"mode,omitempty"`
	BoxName          string    `json:"box_name,omitempty"`
	BoxID            string    `json:"box_id,omitempty"`
	Image            string    `json:"image,omitempty"`
	Registry         string    `json:"registry,omitempty"`
	RuntimeHome      string    `json:"runtime_home,omitempty"`
	StartedAt        time.Time `json:"started_at,omitempty"`
	StartAttemptedAt time.Time `json:"start_attempted_at,omitempty"`
	StoppedAt        time.Time `json:"stopped_at,omitempty"`
	LastError        string    `json:"last_error,omitempty"`
	BootstrapRef     string    `json:"bootstrap_ref,omitempty"`
	// K8sContext and K8sNamespace override which cluster/namespace the k8s
	// driver targets for this sandbox. Empty means "use the daemon's
	// K8S_KUBECONFIG current-context / K8S_NAMESPACE default" (see
	// k8sRuntime.client and k8sRuntime.namespaceFor). Other drivers ignore
	// these fields.
	K8sContext   string `json:"k8s_context,omitempty"`
	K8sNamespace string `json:"k8s_namespace,omitempty"`
}