subagent

type Activity struct {
	Revision  uint64
	Phase     ActivityPhase
	StartedAt time.Time
	UpdatedAt time.Time
	RunID     string
	Turn      int
	Tools     []ToolActivity
}

type ActivityAction string

type ActivityPhase string

type ActivitySummary struct {
	Action ActivityAction `json:"action"`
	Target string         `json:"target"`
}

type AdmissionEvent struct {
	Outcome         AdmissionOutcome
	Reason          AdmissionReason
	Delivery        Delivery
	DelegationDepth int
}

type AdmissionObserver func(context.Context, AdmissionEvent)

type AdmissionOutcome string

type AdmissionReason string

type AgentEvent struct {
	ChildSessionID string
	Ownership      Ownership
	Task           string
	Event          agent.Event
}

type AgentEventObserver func(context.Context, AgentEvent) error

type AgentIdentity struct {
	Schema           string    `json:"schema"`
	ID               string    `json:"id"`
	Kind             AgentKind `json:"kind"`
	Name             string    `json:"name"`
	DefinitionSchema string    `json:"definition_schema"`
	DefinitionDigest string    `json:"definition_digest"`
	DefinitionSource string    `json:"definition_source"`
}

type AgentKind string

type Config struct {
	Context    context.Context
	Repository *session.Repository
	Parent     *session.Handle
	Tree       *workspace.Tree
	Model      ai.LanguageModel
	// GenerationID identifies the immutable Coding integration snapshot that
	// compiled this manager's builtin execution plan. Custom dispatch will
	// acquire a per-child generation lease in the next slice.
	GenerationID   uint64
	SummaryModel   ai.LanguageModel
	Compaction     *harness.CompactionSettings
	RequestPolicy  func(*ai.Request)
	Lifecycle      Lifecycle
	Options        ExecutionOptions
	AgentObservers []func(context.Context, agent.Event)
	EventObservers []AgentEventObserver
	// AdmissionObserver receives content-free shared-budget decisions. It is
	// observational only and cannot veto or alter a reservation.
	AdmissionObserver AdmissionObserver
	// Share joins this Manager to an existing root execution tree. It is
	// required when Parent is a subagent Session.
	Share *Manager
	// DelegationDepth is the depth expected for children created by this
	// manager. Root conversation Managers use zero.
	DelegationDepth int
}

type Delivery string

type Detail struct {
	Summary    Summary
	Plan       ExecutionPlan
	Transcript []ai.Message
	Activity   Activity
	Result     any
}

type DispatchInput struct {
	Plan     ExecutionPlan
	Request  Request
	Child    *session.Handle
	Observer Observer
	OnEvent  func(context.Context, agent.Event)
}

type Dispatcher interface {
	// AgentIDs returns the bounded model-visible custom IDs captured for this
	// Tool declaration. It is advisory schema metadata only; Compile remains
	// the authorization boundary.
	AgentIDs() []string
	// Compile validates the request against the caller-visible immutable
	// registry and returns a complete, non-legacy execution plan.
	Compile(context.Context, Request) (ExecutionPlan, error)
	// Open creates the child-owned runtime binding after the durable child
	// Session exists. It must not retain a parent-bound controller, Tool, or
	// interaction context.
	Open(context.Context, DispatchInput) (Runner, error)
}

type EffectiveCapability struct {
	WireName string `json:"wire_name"`
	Source   string `json:"source"`
	Risk     string `json:"risk"`
}

type Event struct {
	Progress            bool
	State               State
	Identity            AgentIdentity
	Role                Role
	ChildSessionID      string
	ParentSessionID     string
	ParentInteractionID string
	ParentRunID         string
	ParentToolCallID    string
	RootInteractionID   string
	Delivery            Delivery
	ChildRunID          string
	Model               string
	TaskPreview         string
	Activity            ActivitySummary
	Code                string
	Stop                agent.StopReason
	Turns               int
	ToolCalls           int
	Usage               ai.Usage
	Duration            time.Duration
	Time                time.Time
	// Result is present only on an in-process terminal callback. It is never
	// copied into the parent lifecycle event or telemetry projection.
	Result *Result
}

type Evidence struct {
	Path      string `json:"path"`
	StartLine int    `json:"start_line"`
	EndLine   int    `json:"end_line"`
	Claim     string `json:"claim"`
}

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

type ExecutionOptions struct {
	Limits                       Limits
	MaxDepth                     int
	MaxConcurrent                int
	MaxSpawnedPerRootInteraction int
	MaxAutoFollowUps             int
}

type ExecutionPlan struct {
	Schema             string                `json:"schema"`
	Identity           AgentIdentity         `json:"identity"`
	GenerationID       uint64                `json:"generation_id,omitempty"`
	Delivery           Delivery              `json:"delivery"`
	Model              string                `json:"model"`
	Instructions       string                `json:"instructions"`
	InstructionsDigest string                `json:"instructions_digest"`
	Capabilities       []EffectiveCapability `json:"capabilities"`
	Skills             []string              `json:"skills"`
	PreloadedSkills    []string              `json:"preloaded_skills"`
	ToolSearch         bool                  `json:"tool_search,omitempty"`
	DelegationDepth    int                   `json:"delegation_depth,omitempty"`
	MaxDelegationDepth int                   `json:"max_delegation_depth,omitempty"`
	Ancestry           []string              `json:"ancestry,omitempty"`
	DelegationTargets  []string              `json:"delegation_targets,omitempty"`
	PrivateMCP         []PrivateBinding      `json:"private_mcp,omitempty"`
	PrivateHooks       []PrivateBinding      `json:"private_hooks,omitempty"`
	Limits             Limits                `json:"limits"`
	Output             OutputContract        `json:"output"`
	// Legacy records did not carry an execution snapshot. It is set only while
	// normalizing those durable records for read-only inspection; dispatch must
	// never admit a legacy plan.
	Legacy bool `json:"legacy,omitempty"`
}

type ExploreResult struct {
	Summary  string     `json:"summary"`
	Evidence []Evidence `json:"evidence"`
	Unknowns []string   `json:"unknowns"`
}

type Lifecycle struct {
	BeforeStart func(context.Context, LifecycleStart) string
	BeforeStop  func(context.Context, LifecycleStop) LifecycleStopDecision
}

type LifecycleStart struct {
	ChildSessionID string
	Identity       AgentIdentity
	Role           Role
	Task           string
	Ownership      Ownership
}

type LifecycleStop struct {
	ChildSessionID       string
	Identity             AgentIdentity
	Role                 Role
	Ownership            Ownership
	StopHookActive       bool
	LastAssistantMessage string
}

type LifecycleStopDecision struct {
	Continue bool
	Reason   string
}

type Limits struct {
	MaxTurns              int
	FinalizationTurns     int
	RepeatedToolCallLimit int
	MaxTokens             int
	MaxToolCalls          int
	MaxDuration           time.Duration
	MaxActivityTools      int
	MaxOutputTokens       int
	MaxTaskBytes          int
	MaxResultBytes        int
	MaxResultItems        int
	MaxFieldBytes         int
}

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

type Notification struct {
	ID          string        `json:"id"`
	AgentID     string        `json:"agent_id"`
	Ownership   Ownership     `json:"ownership"`
	Identity    AgentIdentity `json:"identity,omitzero"`
	Role        Role          `json:"role"`
	Outcome     Outcome       `json:"outcome"`
	Code        string        `json:"code"`
	TaskPreview string        `json:"task_preview,omitempty"`
	Result      ai.JSON       `json:"result,omitempty"`
	Usage       ai.Usage      `json:"usage"`
	TerminalAt  time.Time     `json:"terminal_at"`
}

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

type Observer func(context.Context, Event) error

type Outcome string

type OutputContract struct {
	Format OutputFormat    `json:"format"`
	Name   string          `json:"name"`
	Schema json.RawMessage `json:"schema,omitempty"`
	Digest string          `json:"digest"`
}

type OutputFormat string

type OutputValidator interface {
	Validate(string) (any, error)
}

type Ownership struct {
	ParentSessionID     string
	ParentInteractionID string
	ParentRunID         string
	ParentToolCallID    string
	RootInteractionID   string
}

type PlanResult struct {
	Summary      string     `json:"summary"`
	Assumptions  []string   `json:"assumptions"`
	Steps        []PlanStep `json:"steps"`
	Risks        []string   `json:"risks"`
	Verification []string   `json:"verification"`
}

type PlanStep struct {
	Title     string   `json:"title"`
	Files     []string `json:"files"`
	Rationale string   `json:"rationale"`
}

type PrivateBinding struct {
	ID          string `json:"id"`
	Fingerprint string `json:"fingerprint"`
}

type Request struct {
	AgentID   string
	Role      Role
	Task      string
	Ownership Ownership
	Delivery  Delivery
}

type Result struct {
	Identity       AgentIdentity
	Role           Role
	ChildSessionID string
	ChildRunID     string
	Outcome        Outcome
	Code           string
	Stop           agent.StopReason
	Turns          int
	ToolCalls      int
	Usage          ai.Usage
	Duration       time.Duration
	Value          any
}

type ReviewFinding struct {
	Severity       string `json:"severity"`
	Title          string `json:"title"`
	Path           string `json:"path"`
	Line           int    `json:"line"`
	Evidence       string `json:"evidence"`
	Recommendation string `json:"recommendation"`
}

type ReviewResult struct {
	Summary       string          `json:"summary"`
	Findings      []ReviewFinding `json:"findings"`
	ResidualRisks []string        `json:"residual_risks"`
}

type Role string

type Runner interface {
	Run(context.Context, string) (RunnerResult, error)
	// Close releases the child control scope after Manager durably persists its
	// terminal record. It must be idempotent and safe after a failed Run.
	Close(context.Context) error
}

type RunnerResult struct {
	Run       *agent.RunResult
	Value     any
	Text      string
	ToolCalls int
}

type State string

type Summary struct {
	ChildSessionID string
	Ownership      Ownership
	Delivery       Delivery
	Identity       AgentIdentity
	Role           Role
	State          State
	TaskPreview    string
	Model          string
	CreatedAt      time.Time
	Duration       time.Duration
	Turns          int
	ToolCalls      int
	Usage          ai.Usage
	Code           string
}

type ToolActivity struct {
	RunID  string
	Turn   int
	Call   ai.ToolCallPart
	Status ToolStatus
	Update []ai.Part
	Result ai.ToolResultPart
}

type ToolStatus string