subagent

type AcceptanceCheck struct {
	Name                 string `json:"name"`
	Cmd                  string `json:"cmd"`
	ExpectExit           int    `json:"expect_exit"`
	ExpectStdoutContains string `json:"expect_stdout_contains,omitempty"`
	TimeoutSeconds       int    `json:"timeout_seconds,omitempty"`
}

type AcceptanceResult struct {
	Name     string `json:"name"`
	Passed   bool   `json:"passed"`
	ExitCode int    `json:"exit_code"`
	Stdout   string `json:"stdout,omitempty"`
	Stderr   string `json:"stderr,omitempty"`
	Reason   string `json:"reason,omitempty"`
}

type AcceptanceRunner func(ctx context.Context, cmd string, timeout time.Duration, workdir string) (exitCode int, stdout, stderr string, err error)

type AcceptanceScanner interface {
	Scan(cmd string) (blocked bool, err error)
}

type AgentDef struct {
	Name         string
	Command      string
	Args         []string
	Protocol     Protocol
	Model        string
	Env          map[string]string
	SystemPrompt string   // built-in agents only: injected as system prompt
	Tools        []string // built-in agents only: tool whitelist names

	// Claude Code parity fields — all optional.
	Description        string   `yaml:"description,omitempty"`        // when to auto-select this agent
	DisallowedTools    []string `yaml:"disallowedTools,omitempty"`    // tools to deny even if inherited
	MaxTurns           int      `yaml:"maxTurns,omitempty"`           // max agentic turns before stopping
	PermissionMode     string   `yaml:"permissionMode,omitempty"`     // acceptEdits/auto/bypass
	Skills             []string `yaml:"skills,omitempty"`             // skills to preload at startup
	Color              string   `yaml:"color,omitempty"`              // UI color for agent identification
	Effort             string   `yaml:"effort,omitempty"`             // thinking effort: off/minimal/low/medium/high/x-high
	InitialPrompt      string   `yaml:"initialPrompt,omitempty"`      // prepended to first user turn
	Background         bool     `yaml:"background,omitempty"`         // always run as background task
	Memory             string   `yaml:"memory,omitempty"`             // persistent memory: user/project/local
	MCPServers         []string `yaml:"mcpServers,omitempty"`         // MCP servers scoped to this agent
	Hooks              []string `yaml:"hooks,omitempty"`              // lifecycle hooks for this agent
	RequiredMCPServers []string `yaml:"requiredMcpServers,omitempty"` // MCP servers required for agent availability
	Filename           string   `yaml:"-"`                            // original filename (set at load time)
}

type AgentFile struct {
	Name               string     `yaml:"name"`
	Description        string     `yaml:"description"`
	Tools              csvStrings `yaml:"tools,omitempty"`
	DisallowedTools    csvStrings `yaml:"disallowedTools,omitempty"`
	Model              string     `yaml:"model,omitempty"`
	PermissionMode     string     `yaml:"permissionMode,omitempty"`
	MaxTurns           int        `yaml:"maxTurns,omitempty"`
	Skills             csvStrings `yaml:"skills,omitempty"`
	MCPServers         csvStrings `yaml:"mcpServers,omitempty"`
	Hooks              csvStrings `yaml:"hooks,omitempty"`
	Memory             string     `yaml:"memory,omitempty"` // user/project/local
	Color              string     `yaml:"color,omitempty"`
	Effort             string     `yaml:"effort,omitempty"`             // thinking effort level
	InitialPrompt      string     `yaml:"initialPrompt,omitempty"`      // prepended to first turn
	Background         bool       `yaml:"background,omitempty"`         // always run as background
	RequiredMCPServers csvStrings `yaml:"requiredMcpServers,omitempty"` // MCP patterns required
	// Body is the markdown after the frontmatter — the system prompt.
	Body string `yaml:"-"`
}

type AgentPriority int

type AgentRegistry struct {

	// FailedFiles tracks files that couldn't be parsed (for diagnostics).
	FailedFiles []FailedAgentFile
	// contains filtered or unexported fields
}

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

type AuditEntry struct {
	Timestamp time.Time `json:"ts"`
	Tool      string    `json:"tool"`
	Path      string    `json:"path,omitempty"`
	Allowed   bool      `json:"allowed"`
	Reason    string    `json:"reason,omitempty"`
	ArgsLen   int       `json:"args_len"`
}

type AuditWriter interface {
	Write(entry AuditEntry) error
	Path() string
}

type AutonomousConfig struct {
	Contract *Contract
	Driver   StepDriver
	Workdir  string
	// Runner overrides AcceptanceRunner; defaults to DefaultAcceptanceRunner.
	Runner AcceptanceRunner
	// Handoff, if non-nil, receives one StatusReport on handoff/exhaustion.
	// Buffered channel recommended (size 1).
	Handoff chan StatusReport
}

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

type BudgetSnapshot struct {
	CurrentTokens int
	MaxTokens     int
}

type ChildRef struct {
	ID        string
	Goal      string
	Model     string
	Status    string
	StartedAt time.Time
	Cancel    context.CancelFunc
	Result    *Result
	Depth     int
	Role      Role
}

type CompactionTask struct {
	Messages      []providers.Message
	TargetTokens  int
	OverrideModel string
}

type Config struct {
	MaxDepth     int
	MaxChildren  int
	ChildTimeout time.Duration
	CurrentDepth int // fixed parent depth; concurrent children are siblings

	// MaxTasksPerChild is the soft limit on how many tasks can be
	// dispatched in a single SpawnBatch call. When the input exceeds
	// this, SpawnBatchAutoSplit automatically splits into sequential
	// batches. Defaults to MaxChildren when unset (0).
	MaxTasksPerChild int
}

type ContextExport struct {
	SessionID       string        `json:"session_id"`
	Goal            string        `json:"goal"`
	Context         ExportContext `json:"context"`
	OverkillVersion string        `json:"overkill_version"`
}

type ContextRef struct {
	Type  ContextRefKind `json:"type"`
	Value string         `json:"value"`
}

type ContextRefKind string

type Contract struct {
	ID                string              `json:"id"`
	ParentSession     string              `json:"parent_session"`
	Goal              string              `json:"goal"`
	Scope             []string            `json:"scope"`
	OutOfScope        []string            `json:"out_of_scope"`
	Inputs            []ContextRef        `json:"inputs"`
	ExpectedOutputs   []Output            `json:"expected_outputs"`
	IntegrationPoints []Integration       `json:"integration_points,omitempty"`
	Acceptance        []AcceptanceCheck   `json:"acceptance"`
	Budget            ContractBudget      `json:"budget"`
	OnContextFull     OnContextFullAction `json:"on_context_full"`
}

type ContractBudget struct {
	Tokens      int           `json:"tokens"`
	Steps       int           `json:"steps"`
	WallSeconds time.Duration `json:"wall_seconds"`
}

type ContractViolation struct {
	Criterion string `json:"criterion"`
	Reason    string `json:"reason"`
	Evidence  string `json:"evidence,omitempty"`
}

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

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

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

type ExportContext struct {
	FilesModified       []string `json:"files_modified,omitempty"`
	RecentChanges       string   `json:"recent_changes,omitempty"`
	ProjectStructure    string   `json:"project_structure,omitempty"`
	Constraints         string   `json:"constraints,omitempty"`
	Language            string   `json:"language,omitempty"`
	RelatedConversation string   `json:"related_conversation,omitempty"`
}

type ExternalDelegator struct {

	// Registry, when set, provides file-based agent discovery and
	// auto-selection via SelectBest. Populated at boot time.
	Registry *AgentRegistry
	// contains filtered or unexported fields
}

type FailedAgentFile struct {
	Path  string
	Error string
}

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

type FinalReport struct {
	ContractID string              `json:"contract_id"`
	Status     string              `json:"status"` // completed | violated | exhausted | handed_off | failed
	Outputs    []OutputResult      `json:"outputs"`
	Acceptance []AcceptanceResult  `json:"acceptance"`
	Violations []ContractViolation `json:"violations,omitempty"`
	TokensUsed int                 `json:"tokens_used"`
	StepsUsed  int                 `json:"steps_used"`
	Elapsed    time.Duration       `json:"elapsed"`
	Reason     string              `json:"reason,omitempty"`
	LastOutput string              `json:"last_output,omitempty"`
}

type GenericTask struct {
	GoalStr     string
	ContextStr  string
	ToolsetVal  []string
	ModelVal    string
	MaxStepsVal int
}

type HandoffFailureSink interface {
	OnDelegationFailure(parentSession string, contract *Contract, report *FinalReport, err error)
}

type Integration struct {
	Description string `json:"description"`
	Reference   string `json:"reference,omitempty"`
}

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

type ModelHint struct {
	NeedsTools  bool
	NeedsVision bool
}

type ModelResolver func(hint ModelHint) (modelID, provider string)

type OnContextFullAction string

type Output struct {
	Kind OutputKind `json:"kind"`
	Spec string     `json:"spec"`
}

type OutputKind string

type OutputResult struct {
	Spec      string `json:"spec"`
	Kind      string `json:"kind"`
	Satisfied bool   `json:"satisfied"`
}

type PersonalityUpdateTask struct {
	SessionMessages []providers.Message
	CurrentLevel    personality.Level
	AgentName       string
}

type Protocol int

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

type RealWorkerConfig struct {
	Tools     []string // explicit tool capabilities requested by this task
	Goal      string
	Context   string
	MaxSteps  int
	Timeout   time.Duration
	Model     string // from SmartRouter.Route().ModelID or fallback "mimo-v2-pro"
	Provider  string // from SmartRouter.Route().Provider or fallback "xiaomi"
	TaskIndex int    // index assigned by the manager for result tracking
	MaxTokens int    // completion limit override; 0 uses model/provider default
}

type Result struct {
	TaskIndex    int         `json:"task_index"`
	Status       string      `json:"status"`
	Summary      string      `json:"summary"`
	Error        string      `json:"error,omitempty"`
	TokensIn     int64       `json:"tokens_in"`
	TokensOut    int64       `json:"tokens_out"`
	CostUSD      float64     `json:"cost_usd"`
	DurationMs   int64       `json:"duration_ms"`
	ToolTrace    []ToolEntry `json:"tool_trace,omitempty"`
	FilesRead    []string    `json:"files_read,omitempty"`
	FilesWritten []string    `json:"files_written,omitempty"`
	ExitReason   string      `json:"exit_reason"`
}

type Role int

type RollupSummary struct {
	ChildrenCount int
	TotalIn       int64
	TotalOut      int64
	TotalCost     float64
}

type SessionNameTask struct {
	FirstMessage string
	MaxTokens    int
}

type SpawnConfig struct {
	// Agent definition (from registry or built-in).
	Agent AgentDef

	// Prompt messages — the goal/context for this agent run.
	Goal    string
	Context string

	// Whether this is an async/background agent. Async agents
	// auto-deny permission prompts since there's no UI.
	IsAsync bool

	// When true, the agent CAN show permission prompts even if async.
	CanShowPermissionPrompts bool

	// Forked context from the parent conversation.
	ForkContext string

	// Model override from the caller.
	ModelOverride    string
	ProviderOverride string

	// Max turns/steps override.
	MaxStepsOverride int

	// Max tokens override.
	MaxTokensOverride int

	// Timeout override.
	TimeoutOverride time.Duration

	// Tool whitelist for this agent session (agent.Tools if empty).
	AllowedTools []string

	// Worktree path if agent has isolation: "worktree".
	WorktreePath string

	// Parent agent ID for hierarchy tracking.
	ParentAgentID string

	// Task index for result tracking.
	TaskIndex int
}

type StatusReport struct {
	ContractID            string              `json:"contract_id"`
	Done                  []string            `json:"done"`
	Pending               []string            `json:"pending"`
	Violations            []ContractViolation `json:"violations,omitempty"`
	TokensUsed            int                 `json:"tokens_used"`
	StepsUsed             int                 `json:"steps_used"`
	Elapsed               time.Duration       `json:"elapsed"`
	NextRecommendedAction string              `json:"next_recommended_action"`
}

type StepDriver interface {
	// Step performs exactly one unit of work. Implementations should not
	// loop internally — the runner owns the iteration.
	Step(ctx context.Context) StepResult
	// Budget returns a current snapshot of token usage.
	Budget() BudgetSnapshot
	// Compact attempts to reduce context to fit. Implementations should
	// return the post-compaction BudgetSnapshot.
	Compact(ctx context.Context) (BudgetSnapshot, error)
	// CheckOutput returns the list of ExpectedOutputs (by Spec) that have
	// been satisfied so far. Implementations may use simple file-existence
	// checks for OutFile, or model-side heuristics for other kinds.
	CheckOutput(ctx context.Context, outputs []Output) (satisfiedSpecs []string)
}

type StepResult struct {
	// ToolCalls executed during the step (used for step counting).
	ToolCalls int
	// Tokens used (cumulative or delta — runner only inspects the
	// CurrentTokens snapshot from BudgetSnapshot).
	Tokens int
	// Done is true when the underlying agent reports task completion (e.g. a
	// final assistant turn with no further tool calls).
	Done bool
	// Output is the assistant text produced this step (last seen).
	Output string
	// Err, if non-nil, is a per-step error. Tool-level ContractViolations
	// should be returned as an error implementing the violation interface
	// so the runner can surface them in FinalReport.Violations.
	Err error
}

type Task interface {
	Goal() string
	Context() string
	Toolset() []string
	Model() string
	MaxIterations() int
	Validate() error
}

type TaskRouter interface {
	RouteTask(ctx context.Context, goal, contextStr string) (modelID, provider string, ok bool)
}

type Tool interface {
	Name() string
	Execute(ctx context.Context, input json.RawMessage) (json.RawMessage, error)
}

type ToolEntry struct {
	Tool       string `json:"tool"`
	ArgsLen    int    `json:"args_len"`
	Path       string `json:"path,omitempty"`
	Success    bool   `json:"success"`
	Error      string `json:"error,omitempty"`
	InputHash  string `json:"input_hash,omitempty"`
	OutputHash string `json:"output_hash,omitempty"`
}

type ToolWithPath interface {
	IntendedPath(input json.RawMessage) string
}

type VisualDebugTask struct {
	ScreenshotPath string
	ExpectedPath   string
}

type WorkerFactory func(RealWorkerConfig) (WorkerRunner, error)

type WorkerRunner interface {
	Run(context.Context) (*Result, error)
}