boxshclient

type BackendConfig struct {
	// BinaryPath is the path to the boxsh binary. If empty, uses managed binary.
	BinaryPath string

	// AnnaHome is the Anna home directory (used for binary resolution).
	AnnaHome string

	// UserRoot is the writable root mounted into the sandbox.
	UserRoot string

	// Sandbox contains the sandbox network configuration.
	Sandbox NetworkConfig

	// WorkDir is the working directory for tool execution.
	// This is resolved relative to the user root.
	WorkDir string

	// SessionBaseDir is the base directory for ephemeral session directories.
	// Defaults to AnnaHome/cache/sandbox/sessions.
	SessionBaseDir string

	// ReadOnlyDirs are mounted read-only into the sandbox so helper binaries
	// and user PATH directories remain available from shell commands.
	ReadOnlyDirs []string
}

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

type DirEntry struct {
	Name  string `json:"name"`
	IsDir bool   `json:"is_dir"`
	Size  int64  `json:"size"`
}

type EditParams struct {
	FilePath string     `json:"path"`
	Edits    []EditSpec `json:"edits"`
}

type EditResult struct {
	Path         string `json:"path"`
	Replacements int    `json:"replacements"`
	Diff         string `json:"diff,omitempty"`
}

type EditSpec struct {
	OldText string `json:"oldText"`
	NewText string `json:"newText"`
}

type ExecParams struct {
	Command string `json:"command"`
	Timeout int    `json:"timeout,omitempty"`
}

type ExecResult struct {
	Stdout   string `json:"stdout"`
	Stderr   string `json:"stderr"`
	ExitCode int    `json:"exit_code"`
}

type ListParams struct {
	DirPath string `json:"dir_path,omitempty"`
}

type ListResult struct {
	Entries []DirEntry `json:"entries"`
}

type NetworkConfig struct {
	Mode      string
	Allowlist []string
}

type NormalizeResult struct {
	// Content is the main text output for the tool.
	Content string

	// IsError indicates if this is an error result.
	IsError bool

	// Metadata contains additional information (exit codes, timing, etc.).
	Metadata map[string]any
}

type Normalizer struct {
	// MaxOutputLen limits the length of normalized output before truncation.
	// 0 means use default (50KB as per tools.TruncateTail).
	MaxOutputLen int

	// IncludeTimestamps determines whether to include timing info in output.
	IncludeTimestamps bool
}

type RPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    any    `json:"data,omitempty"`
}

type ReadParams struct {
	FilePath string `json:"path"`
	Offset   int    `json:"offset,omitempty"`
	Limit    int    `json:"limit,omitempty"`
}

type ReadResult struct {
	Content    string `json:"content"`
	TotalLines int    `json:"total_lines"`
	Truncated  bool   `json:"truncated"`
}

type Request struct {
	JSONRPC string          `json:"jsonrpc"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params,omitempty"`
	ID      uint64          `json:"id,omitempty"`
}

type Response struct {
	JSONRPC string          `json:"jsonrpc"`
	Result  json.RawMessage `json:"result,omitempty"`
	Error   *RPCError       `json:"error,omitempty"`
	ID      uint64          `json:"id"`
}

type SessionConfig struct {
	// Src is the source workspace (read-only lower layer).
	Src string
	// Dst is the destination overlay root exposed inside the sandbox.
	Dst string
	// Cwd is the working directory inside the sandbox.
	Cwd string
	// ReadOnlyDirs are additional host directories bound read-only into the
	// sandbox so executables from PATH remain usable.
	ReadOnlyDirs []string
	// Network mode: disabled, allow_all, or whitelist.
	NetworkMode string
	// NetworkAllowlist is kept for config compatibility. Current boxsh only
	// supports allow-all or fully disabled networking.
	NetworkAllowlist []string
}

type SessionInfo struct {
	// Src is the source workspace (read-only lower layer).
	Src string

	// Dst is the ephemeral destination upperdir (read-write layer).
	Dst string

	// Cwd is the working directory inside the sandbox.
	Cwd string

	// NetworkMode is the effective network mode.
	NetworkMode string

	// NetworkAllowlist contains allowed hosts/CIDRs for whitelist mode.
	NetworkAllowlist []string
}

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

type SessionMeta struct {
	Src       string    `json:"src"`
	CreatedAt time.Time `json:"created_at"`
}

type SessionOptions struct {
	// UserRoot is the writable root mounted into the sandbox.
	UserRoot string

	// WorkDir is the working directory for tool execution.
	WorkDir string

	// Sandbox contains the network policy configuration.
	Sandbox NetworkConfig
}

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

type StatParams struct {
	Path string `json:"path"`
}

type StatResult struct {
	Exists  bool   `json:"exists"`
	IsDir   bool   `json:"is_dir"`
	Size    int64  `json:"size"`
	ModTime string `json:"mod_time"`
}

type WriteParams struct {
	FilePath string `json:"path"`
	Content  string `json:"content"`
}

type WriteResult struct {
	BytesWritten int    `json:"bytes_written"`
	Path         string `json:"path"`
}