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 exactly one command within the executor's frozen authority.
	// It honors ctx and Input.Timeout, returns non-zero exit status as Output
	// rather than error, and reserves error for spawn, I/O, or collection failure.
	// On error, Output retains all available execution facts. Neither an error
	// nor missing output proves that the command had no side effects.
	// A backend may return core/tool.Failure only when it can establish a
	// complete unsuccessful outcome; that failure owns its model-visible output.
	// Other errors retain uncertainty, with observed Output carried by the Tool
	// as core/tool.CallError evidence. They are not automatic retry instructions.
	Run(ctx context.Context, in Input) (Output, error)
}

type Input struct {
	Cmd string

	// Timeout bounds the run. 0 = no timeout; ctx cancellation still
	// applies.
	Timeout time.Duration
}

type LocalConfig 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 LocalExecutor struct {
	// contains filtered or unexported fields
}

type Output struct {
	Stdout   []byte
	Stderr   []byte
	ExitCode int
	Duration time.Duration
	// Truncation is an observation, independent of markers in command output.
	// A false value 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
}