agent

type Agent struct {
	Model     model.Model
	ModelName string
	// FallbackModels is the fallback chain recorded in the trajectory and
	// run.started. Model must then be a *model.Fallback over ModelName
	// followed by these specs; empty means no fallback.
	FallbackModels []string
	// ReasoningEffort is recorded in new trajectories; the Model sends it.
	ReasoningEffort string
	// OpenAIAPI is the openai provider's resolved transport, recorded in
	// trajectories and run.started; the Model uses it.
	OpenAIAPI string
	// Profile is the config profile selected with --profile, recorded in
	// the trajectory and run.started; "" when none.
	Profile string
	// ProviderAPI and ProviderBaseURL describe a config-defined provider,
	// recorded in trajectories and run.started; empty for built-ins.
	ProviderAPI     string
	ProviderBaseURL string
	Tools           *tools.Executor
	// RedactSecrets describes Tools.Redactor by name for the trajectory
	// and run.started; nil when redact_secrets is off.
	RedactSecrets *trajectory.RedactSecretsInfo
	Config        config.AgentConfig
	Out           io.Writer // progress log; nil discards
	Err           io.Writer // warnings; nil discards
	Verbose       bool
	// Streamed means the model already wrote its text to Out as it arrived.
	Streamed bool
	// SkipAgentsMD stops Run from appending the nearest AGENTS.md at or above
	// <root> to the system prompt.
	SkipAgentsMD bool
	// ScopedAgentsMD delivers AGENTS.md files in directories below <root>
	// with the results of the built-in file tools that touch paths there
	// (--scoped-agents-md). SkipAgentsMD turns it off.
	ScopedAgentsMD bool
	// SkillsEnabled records that skills discovery was on for this run; the
	// discovered skills are Tools.Skills.
	SkillsEnabled bool
	// NoCompact turns off context compaction: the full history is always
	// sent, and a context-overflow error ends the run.
	NoCompact bool
	// Hooks run around tool calls the executor permits, and stop hooks
	// before a successful finish; nil runs none.
	Hooks *hooks.Runner
	// Policy is the compiled tool permission policy; nil enforces nothing.
	// It is applied between the executor's Permits check and the hooks, so a
	// denial reuses the error-result path and hooks never override it.
	Policy *permissions.Policy
	// PermissionApprover answers a policy "ask" through the channel the run
	// has (a terminal prompt, ACP session/request_permission, ...). nil
	// resolves asks with the policy's non-interactive decision.
	PermissionApprover func(ctx context.Context, req permissions.Request) permissions.Answer

	// OnStep is called after every step, e.g. to save the trajectory. A
	// non-nil error stops the run.
	OnStep func(*trajectory.Trajectory) error
	// OnEvent receives machine-readable progress events when configured.
	OnEvent func(string, map[string]any)
	// Resume, when non-nil, continues that trajectory instead of starting a
	// fresh run: its messages, accounting totals, and steps are the starting
	// state, and a continuation notice is appended before the first request.
	Resume       *trajectory.Trajectory
	ResumeSource string // audit-only input path for resume provenance
	// FollowUp, with Resume, continues a finished (Submitted or Completed)
	// checkpoint with this new user instruction, or answers a NeedsInput
	// checkpoint's question. It must be empty for an unfinished checkpoint
	// and set for the others.
	FollowUp string
	// Continue marks Resume as the trajectory this process's previous Run
	// returned (an ACP session's earlier turn), not a loaded checkpoint:
	// the checks against changes between invocations are skipped, and
	// FollowUp continues it whatever status that turn ended with.
	Continue bool
	// TaskImages (--image) are attached to the task message of a fresh run,
	// or to the follow-up message with FollowUp. The message text gets one
	// label line per image.
	TaskImages []model.Image
	// OutputSchema, when non-nil, adds the submit_result tool and makes the
	// run succeed only with a result that validates against it.
	OutputSchema *outschema.Schema
	// Snapshots, when non-nil, captures the workspace: a baseline before
	// the first request, before every tool batch that can change files, and
	// at the end of the run (--snapshots).
	Snapshots Snapshotter
	// Worktree, when non-nil, records the --worktree checkout a fresh run
	// works in; it is copied into the new trajectory.
	Worktree *trajectory.WorktreeInfo
	// Review, when non-nil, records the change set a fresh review run was
	// given; it is copied into the new trajectory.
	Review *trajectory.ReviewInfo

	// Subagents runs the opt-in delegate tool's children; Tools.Delegate
	// offers the tool. nil leaves delegate calls failing with an error.
	Subagents *Subagents

	// Workers runs the opt-in worker tool's children; Tools.Workers
	// offers the tool. nil leaves worker calls failing with an error.
	Workers *Workers
	// contains filtered or unexported fields
}

type Snapshotter interface {
	Take(kind string, step int) (trajectory.Snapshot, error)
}

type Subagents struct {
	// Model and ModelName are the children's model; the caller builds it
	// (by default the parent's model spec, without streaming).
	Model     model.Model
	ModelName string
	// MaxSteps caps each child's model calls; 0 means
	// config.DefaultSubagentMaxSteps.
	MaxSteps int
	// Streamed reports whether Model writes text to the terminal itself.
	Streamed bool
}

type Workers struct {
	// Model and ModelName are the workers' model (by default the parent's
	// model spec, without streaming).
	Model     model.Model
	ModelName string
	// MaxSteps caps each worker's model calls; 0 means
	// config.DefaultWorkerMaxSteps.
	MaxSteps int
	// Tools are the configured worker tools; nil means
	// config.DefaultWorkerTools. A worker gets only those the parent has.
	Tools []string
	// RunName prefixes worker branch and worktree names
	// (tinyagent/<RunName>-w<n>); "" generates one per process.
	RunName string
}