exectool

Mar 30, 2026

Changes in this version

+ type BootstrappedDefaults struct

+ BaseEnv map[string]string

+ DefaultShell ShellName

+ func BootstrapDefaults(ctx context.Context) (*BootstrappedDefaults, error)

type ExecToolOption

+ func WithBaseEnv(env map[string]string) ExecToolOption

+ func WithDefaultShell(shell ShellName) ExecToolOption

Feb 12, 2026

Changes in this version

type ExecToolOption

+ func WithBlockSymlinks(block bool) ExecToolOption

type ExecutionPolicy

+ func (p *ExecutionPolicy) Clone() *ExecutionPolicy

type RunScriptPolicy

+ func (p *RunScriptPolicy) Clone() *RunScriptPolicy

Feb 10, 2026

Changes in this version

type RunScriptArgs

+ WorkDir string

type ShellCommandArgs

+ WorkDir string

type ShellCommandOut

+ WorkDir string

Feb 9, 2026

Changes in this version

+ type RunScriptOut struct

+ DurationMS int64

+ ExitCode int

+ Path string

+ Stderr string

+ StderrTruncated bool

+ Stdout string

+ StdoutTruncated bool

+ TimedOut bool

+ type ShellCommandOut struct

+ Results []ShellCommandExecResult

+ SessionID string

+ Workdir string

Feb 9, 2026

Changes in this version

type RunScriptPolicy

+ func NormalizeRunScriptPolicy(in RunScriptPolicy) (RunScriptPolicy, error)

Feb 9, 2026

Changes in this version

+ var DefaultExecutionPolicy = ExecutionPolicy

+ var DefaultRunScriptPolicy = func() RunScriptPolicy { ... }()

+ type ExecTool struct

+ func NewExecTool(opts ...ExecToolOption) (*ExecTool, error)

+ func (et *ExecTool) AllowedRoots() []string

+ func (et *ExecTool) RunScript(ctx context.Context, args RunScriptArgs) (*RunScriptResult, error)

+ func (et *ExecTool) RunScriptTool() spec.Tool

+ func (et *ExecTool) SetAllowedRoots(roots []string) error

+ func (et *ExecTool) SetWorkBaseDir(base string) error

+ func (et *ExecTool) ShellCommand(ctx context.Context, args ShellCommandArgs) (*ShellCommandResponse, error)

+ func (et *ExecTool) ShellCommandTool() spec.Tool

+ func (et *ExecTool) Tools() []spec.Tool

+ func (et *ExecTool) WorkBaseDir() string

+ type ExecToolOption func(*ExecTool) error

+ func WithAllowedRoots(roots []string) ExecToolOption

+ func WithBlockedCommands(cmds []string) ExecToolOption

+ func WithExecutionPolicy(p ExecutionPolicy) ExecToolOption

+ func WithMaxSessions(maxSessions int) ExecToolOption

+ func WithRunScriptPolicy(p RunScriptPolicy) ExecToolOption

+ func WithSessionTTL(ttl time.Duration) ExecToolOption

+ func WithWorkBaseDir(base string) ExecToolOption

+ type ExecutionPolicy struct

+ AllowDangerous bool

+ MaxCommandLength int

+ MaxCommands int

+ MaxOutputBytes int64

+ Timeout time.Duration

+ type RunScriptArgs struct

+ Args []string

+ Env map[string]string

+ Path string

+ Workdir string

+ type RunScriptInterpreter struct

+ Args []string

+ Command string

+ Mode RunScriptMode

+ Shell ShellName

+ type RunScriptMode string

+ const RunScriptModeDirect

+ const RunScriptModeInterpreter

+ const RunScriptModeShell

+ type RunScriptPolicy struct

+ AllowedExtensions []string

+ ExecutionPolicy ExecutionPolicy

+ InterpreterByExtension map[string]RunScriptInterpreter

+ MaxArgBytes int

+ MaxArgs int

+ type RunScriptResult struct

+ DurationMS int64

+ ExitCode int

+ Path string

+ Stderr string

+ StderrTruncated bool

+ Stdout string

+ StdoutTruncated bool

+ TimedOut bool

+ type ShellCommandArgs struct

+ Commands []string

+ Env map[string]string

+ ExecuteParallel bool

+ SessionID string

+ Shell ShellName

+ Workdir string

+ type ShellCommandExecResult = executil.ShellCommandExecResult

+ type ShellCommandResponse struct

+ Results []ShellCommandExecResult

+ SessionID string

+ Workdir string

+ type ShellName = executil.ShellName

+ const ShellNameAuto

+ const ShellNameBash

+ const ShellNameCmd

+ const ShellNameDash

+ const ShellNameFish

+ const ShellNameKsh

+ const ShellNamePowershell

+ const ShellNamePwsh

+ const ShellNameSh

+ const ShellNameZsh