agent

type AgentMention struct {
	Name string
}

type Engine interface {
	HandleTurn(ctx context.Context, req TurnRequest) (<-chan TurnEvent, error)
}

type Event struct {
	Type          EventType
	SessionID     corepkg.SessionID
	UserInput     string
	Content       string
	ToolName      string
	ToolCallID    string
	ToolArguments string
	ToolResult    string
	Error         string
	Plan          planpkg.State
	Usage         llm.Usage
	AgentID       string // non-empty when emitted by a subagent
	InvocationID  string // non-empty when emitted by a subagent, globally unique per invocation

	// EventThinkingProgress fields — reasoning progress without exposing content.
	ReasoningCharCount int
	ReasoningActive    bool
}

type EventType string

type Observer interface {
	HandleEvent(Event)
}

type ObserverFunc func(Event)

type Options struct {
	Workspace       string
	Config          config.Config
	Client          llm.Client
	Store           SessionStore
	Registry        ToolRegistry
	Executor        ToolExecutor
	PolicyGateway   PolicyGateway
	Engine          Engine
	TaskManager     runtimepkg.TaskManager
	Runtime         RuntimeGateway
	Extensions      extensionspkg.Manager
	SkillManager    *skills.Manager
	SubAgentManager *subagentspkg.Manager
	AuditStore      storagepkg.AuditStore
	PromptStore     storagepkg.PromptHistoryWriter
	Observer        Observer
	Approval        tools.ApprovalHandler
	Stdin           io.Reader
	Stdout          io.Writer
}

type PolicyGateway interface {
	DecideTool(context.Context, ToolDecisionInput) (ToolDecision, error)
}

type PromptActiveSkill struct {
	Name         string
	Description  string
	WhenToUse    string
	Instructions string
	Args         map[string]string
	ToolPolicy   string
	Tools        []string
}

type PromptInput struct {
	Workspace                    string
	ApprovalPolicy               string
	ApprovalMode                 string
	AwayPolicy                   string
	SandboxEnabled               bool
	SystemSandbox                string
	SystemSandboxBackend         string
	SystemSandboxRequiredCapable bool
	SystemSandboxCapabilityLevel string
	SystemSandboxShellNetwork    bool
	SystemSandboxWorkerNetwork   bool
	SystemSandboxFallback        bool
	SystemSandboxStatus          string
	Model                        string
	Mode                         string
	Platform                     string
	Now                          time.Time
	Skills                       []PromptSkill
	SubAgents                    []PromptSubAgent
	Tools                        []string
	SubAgentRuntime              *PromptSubAgentRuntime
	SubAgentDefinition           string
	Plan                         planpkg.State
	ActiveSkill                  *PromptActiveSkill
	Instruction                  string
}

type PromptSkill struct {
	Name        string
	Description string
	Enabled     bool
}

type PromptSubAgent struct {
	Name        string
	Description string
	WhenToUse   string
	Mode        string
}

type PromptSubAgentRuntime struct {
	Name         string
	Task         string
	ScopePaths   []string
	ScopeSymbols []string
	AllowedTools []string
	Isolation    string
	ResultPolicy string
}

type RunPromptInput struct {
	UserMessage                     llm.Message
	Assets                          map[llm.AssetID]llm.ImageAsset
	DisplayText                     string
	PersistDisplayTextAsUserMessage bool
	SubAgent                        *SubAgentPromptInput
}

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

type RuntimeGateway interface {
	RunSync(ctx context.Context, request RuntimeTaskRequest) (RuntimeTaskExecution, error)
	RunAsync(ctx context.Context, request RuntimeTaskRequest) (RuntimeTaskLaunch, error)
}

type RuntimeTaskExecution struct {
	TaskID         corepkg.TaskID
	Result         runtimepkg.TaskResult
	ExecutionError error
}

type RuntimeTaskLaunch struct {
	TaskID corepkg.TaskID
}

type RuntimeTaskRequest struct {
	SessionID          corepkg.SessionID
	TraceID            corepkg.TraceID
	Name               string
	Kind               string
	ParentTaskID       corepkg.TaskID
	Background         bool
	Timeout            time.Duration
	Metadata           map[string]string
	Execute            func(context.Context) ([]byte, error)
	OnTaskStateChanged func(runtimepkg.Task)
}

type SessionStore interface {
	Save(session *session.Session) error
	Load(id string) (*session.Session, error)
}

type StopSummaryInput struct {
	SessionID         corepkg.SessionID
	Reason            string
	ExecutedTools     []string
	TaskReport        *TaskReport
	IncludeTaskReport bool
	RecentToolLimit   int
}

type SubAgentCompletionNotification struct {
	ParentSession  *session.Session
	TaskID         string
	Agent          string
	InvocationID   string
	Status         string // "completed" or "failed"
	Summary        string
	ErrorCode      string
	ErrorMessage   string
	WorktreePath   string
	WorktreeBranch string
	WorktreeState  string
}

type SubAgentConfigOverrides struct {
	Workspace     string
	WritableRoots []string
}

type SubAgentExecutionInput struct {
	Request      tools.DelegateSubAgentRequest
	Preflight    subagentspkg.PreflightResult
	InvocationID string
	Agent        string
	RunMode      planpkg.AgentMode
	ExecCtx      *tools.ExecutionContext
	Observer     Observer                 // optional: receives streaming events from the child runner
	Store        SessionStore             // optional: used to persist child session transcript
	Overrides    *SubAgentConfigOverrides // optional: overrides for child runner config
}

type SubAgentExecutor interface {
	Execute(ctx context.Context, input SubAgentExecutionInput) (tools.DelegateSubAgentResult, error)
}

type SubAgentNotifier interface {
	NotifyCompletion(notification SubAgentCompletionNotification)
	DrainPending() []SubAgentCompletionNotification
}

type SubAgentPromptInput struct {
	Name           string
	Task           string
	ScopePaths     []string
	ScopeSymbols   []string
	AllowedTools   []string
	Isolation      string
	ResultPolicy   string
	DefinitionBody string
}

type TaskReport struct {
	Executed                     []string `json:"executed,omitempty"`
	Denied                       []string `json:"denied,omitempty"`
	PendingApproval              []string `json:"pending_approval,omitempty"`
	SkippedDueToDeniedDependency []string `json:"skipped_due_to_denied_dependency,omitempty"`
	SkippedDueToDependency       []string `json:"skipped_due_to_dependency,omitempty"`
	SystemSandboxFallback        []string `json:"system_sandbox_fallback,omitempty"`
	StrategyAdjustments          []string `json:"strategy_adjustments,omitempty"`
	RetryReasons                 []string `json:"retry_reasons,omitempty"`
	NoProgressTurns              int      `json:"no_progress_turns,omitempty"`
	Escalations                  []string `json:"escalations,omitempty"`
}

type ToolDecision struct {
	Decision   corepkg.Decision
	ReasonCode string
	Reason     string
	RiskLevel  corepkg.RiskLevel
}

type ToolDecisionInput struct {
	ToolName             string
	ToolArguments        string
	AllowedTools         map[string]struct{}
	DeniedTools          map[string]struct{}
	ApprovalPolicy       string
	SafetyClass          tools.SafetyClass
	SandboxEnabled       bool
	SandboxMode          string
	SandboxBackend       string
	SandboxCapability    string
	SandboxRequiredCapab bool
	SandboxShellNetwork  bool
	SandboxWorkerNetwork bool
}

type ToolExecutor interface {
	ExecuteForMode(ctx context.Context, mode planpkg.AgentMode, name, rawArgs string, execCtx *tools.ExecutionContext) (string, error)
}

type ToolRegistry interface {
	DefinitionsForMode(mode planpkg.AgentMode) []llm.ToolDefinition
	DefinitionsForModeWithFilters(mode planpkg.AgentMode, allowlist, denylist []string) []llm.ToolDefinition
}

type ToolSequenceObservation struct {
	Signature        string
	RepeatCount      int
	NameOnlyRepeat   int
	ReachedThreshold bool
	UniqueToolNames  []string
	MatchMode        string
}

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

type TurnEvent struct {
	EventID   corepkg.EventID
	SessionID corepkg.SessionID
	TaskID    corepkg.TaskID
	TraceID   corepkg.TraceID
	TurnID    string
	Sequence  uint64
	Type      TurnEventType
	Timestamp time.Time
	Payload   map[string]any
	ErrorCode string
	Retryable bool

	// Compatibility fields for current runner adapter flow.
	Answer string
	Error  error
}

type TurnEventType string

type TurnRequest struct {
	Session *session.Session
	Input   RunPromptInput
	Mode    string
	Out     io.Writer
	TraceID corepkg.TraceID
}