shell

type Config struct {
	Executor Executor
	// Description replaces the neutral default with the host's actual shell
	// semantics and tool-use policy. Empty selects the neutral description.
	Description string
}

type Executor interface {
	// Run executes one command, honoring ctx and Input.Timeout. A non-zero exit
	// status is Output, not an error. An error reports spawn, I/O, or
	// collection failure and leaves side effects uncertain; Output still
	// carries every available observation. Return core/tool.Failure only for an
	// established unsuccessful outcome, since it owns its model-visible output.
	Run(ctx context.Context, in Input) (Output, error)
}

type Input struct {
	Cmd string

	// Timeout zero means no timeout beyond ctx.
	Timeout time.Duration
}

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

type LocalExecutorConfig struct {
	Directory string
	Shell     string
	// MaxBytesPerStream caps captured stdout and stderr independently.
	// Zero selects 30 KiB per stream; truncation markers are additional bytes.
	MaxBytesPerStream int
}

type Output struct {
	Stdout   []byte
	Stderr   []byte
	ExitCode int
	Duration time.Duration
	// Truncation is observed by the executor, independent of markers in the
	// output. False does not prove complete collection when Run returns an error.
	StdoutTruncated bool
	StderrTruncated bool

	// CancellationObserved reports that cancellation or timeout was observed
	// before returning; it does not establish why the process exited.
	CancellationObserved bool
}

type Request struct {
	Command   string `` /* 128-byte string literal not displayed */
	TimeoutMS int    `` /* 168-byte string literal not displayed */
}

type Response struct {
	Stdout               content.Content `json:"stdout"`
	Stderr               content.Content `json:"stderr"`
	StdoutTruncated      bool            `json:"stdout_truncated,omitzero"`
	StderrTruncated      bool            `json:"stderr_truncated,omitzero"`
	ExitCode             int             `json:"exit_code"`
	CancellationObserved bool            `json:"cancellation_observed,omitzero"`
	Duration             string          `json:"duration"`
}

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