shell

type Approvals ¶ added in v0.10.0

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

func NewApprovals() *Approvals

type EnvironmentPolicy ¶ added in v0.12.19

type EnvironmentPolicy struct {
	Allow   []string
	Deny    []string
	Replace map[string]string
}

EnvironmentPolicy filters the environment inherited by model-generated commands. Allow takes precedence over Deny. Replace is applied last and can intentionally reintroduce an otherwise denied variable.

func DefaultEnvironmentPolicy() EnvironmentPolicy

func (p EnvironmentPolicy) Filter(environ []string) []string

type ExecExit ¶ added in v0.11.4

type ExecExit struct {
	SessionID   int
	Command     string
	Description string
	Output      string
	Notice      string
	Failed      bool
	Elapsed     time.Duration
}

ExecExit reports the exit of a backgrounded exec_command session that no tool call was waiting on, so the host can deliver it as a notification instead of leaving the model to poll.

type ExecManager ¶ added in v0.10.0

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

func NewExecManager(onExit func(ExecExit)) *ExecManager

func (m *ExecManager) BackgroundSession(id int) (ExecSessionInfo, bool)

func (m *ExecManager) BackgroundSessions() []ExecSessionInfo

func (m *ExecManager) Close()

func (m *ExecManager) StopBackgroundSession(id int) error

type ExecSessionInfo ¶ added in v0.16.4

type ExecSessionInfo struct {
	ID          int
	Command     string
	Description string
	Output      string
	Started     time.Time
}

ExecSessionInfo is a read-only snapshot of a command that exec_command returned while it continued running in the background.

type Options ¶ added in v0.12.19

type Options struct {
	// ScratchDir receives complete shell transcripts when inline capture is
	// exceeded. Empty disables transcript persistence while retaining head/tail.
	ScratchDir string

	// Environment extends DefaultEnvironmentPolicy. Allow can explicitly keep
	// a default-denied key; Deny adds patterns; Replace sets final values.
	// The WINGMAN_ENV_ALLOW variable ("KEY1,PREFIX_*") also extends Allow, so
	// denied keys can be restored without embedding code changes.
	Environment *EnvironmentPolicy
}

Options controls the host capabilities exposed to model-generated commands.