sand

type Box struct {
	// ID is an opaque identifier for the sandbox
	ID string
	// ContainerID is the ID of the container
	ContainerID string
	// HostOriginDir is the origin of the sandbox, from which we clone its contents
	HostOriginDir string
	// SandboxWorkDir is the host OS filesystem path containing the sandbox's c-o-w clone of hostOriginDir.
	SandboxWorkDir string
	// ImageName is the name of the container image
	ImageName string
	// DNSDomain is the dns domain for the sandbox's network
	DNSDomain string
	// EnvFile is the host filesystem path to the env file to use when executing commands in the container
	EnvFile string
	// Mounts defines bind mounts that should be attached when creating the container.
	Mounts []MountSpec
	// SandboxWorkDirError and SandboxContainerError are the most recently updated error states of the sandbox
	// work dir and container instance. In-memory only. Updated once either at
	// server startup or sandbox creation time, and then updated periodically thereafter.
	// Empty string implies things are ok.
	// TODO: Make sandbox operations conditional on these values, so that e.g. you don't try to start
	// a sandbox container instance if the sandbox's work dir is not available.
	SandboxWorkDirError   string
	SandboxContainerError string
	// ContainerHooks run after the container has started to perform any bootstrap logic.
	ContainerHooks []ContainerStartupHook `json:"-"`
	Keys           *sshimmer.Keys
	// contains filtered or unexported fields
}

type Boxer struct {
	// contains filtered or unexported fields
}

type ClaudeWorkspaceCloner struct {
	// contains filtered or unexported fields
}

type CloneRequest struct {
	ID          string
	HostWorkDir string
	EnvFile     string
}

type CloneResult struct {
	SandboxWorkDir string
	Mounts         []MountSpec
	ContainerHooks []ContainerStartupHook
}

type ContainerOps interface {
	Create(ctx context.Context, opts *options.CreateContainer, image string, args []string) (string, error)
	Start(ctx context.Context, opts *options.StartContainer, containerID string) (string, error)
	Stop(ctx context.Context, opts *options.StopContainer, containerID string) (string, error)
	Delete(ctx context.Context, opts *options.DeleteContainer, containerID string) (string, error)
	Exec(ctx context.Context, opts *options.ExecContainer, containerID, cmd string, env []string, args ...string) (string, error)
	ExecStream(ctx context.Context, opts *options.ExecContainer, containerID, cmd string, env []string, stdin io.Reader, stdout, stderr io.Writer) (func() error, error)
	Inspect(ctx context.Context, containerID string) ([]types.Container, error)
}

type ContainerStartupHook interface {
	Name() string
	OnStart(ctx context.Context, b *Box) error
}

type CreateSandboxOpts struct {
	ID           string `json:"id,omitempty"`
	CloneFromDir string `json:"cloneFromDir,omitempty"`
	ImageName    string `json:"imageName,omitempty"`
	EnvFile      string `json:"envFile,omitempty"`
	Cloner       string `json:"cloner,omitempty"`
}

type DefaultWorkspaceCloner struct {
	// contains filtered or unexported fields
}

type FileOps interface {
	MkdirAll(path string, perm os.FileMode) error
	Copy(ctx context.Context, src, dst string) error
	Stat(path string) (os.FileInfo, error)
	Lstat(path string) (os.FileInfo, error)
	Readlink(path string) (string, error)
	Create(path string) (*os.File, error)
	RemoveAll(path string) error
	WriteFile(path string, data []byte, perm os.FileMode) error
}

type GitOps interface {
	AddRemote(ctx context.Context, dir, name, url string) error
	RemoveRemote(ctx context.Context, dir, name string) error
	Fetch(ctx context.Context, dir, remote string) error
	TopLevel(ctx context.Context, dir string) string
}

type HostMCP struct {
	ChromeDevToolsPort int
	ChromeUserDataDir  string // e.g. /tmp/chrome-profile-stable
	// contains filtered or unexported fields
}

type ImageOps interface {
	List(ctx context.Context) ([]types.ImageEntry, error)
	Pull(ctx context.Context, image string) (func() error, error)
}

type MountSpec struct {
	Source   string
	Target   string
	ReadOnly bool
}

type Mux struct {
	AppBaseDir string
	SocketPath string
	// contains filtered or unexported fields
}

type MuxClient struct {
	Mux *Mux
	// contains filtered or unexported fields
}

type OpenCodeWorkspaceCloner struct {
	// contains filtered or unexported fields
}

type UserMessenger interface {
	Message(ctx context.Context, msg string)
}

type WorkspaceCloner interface {
	Prepare(ctx context.Context, req CloneRequest) (*CloneResult, error)
	// BUG: Hydrate isn't getting called anywhere, so extra container startup hooks aren't getting registered or invoked.
	Hydrate(ctx context.Context, box *Box) error
}