tools

type AgentInfo struct {
	Name        string
	Description string
}

type ApplyPatchTool struct{}

type ApprovalDecision struct {
	Disposition ApprovalDisposition
}

type ApprovalDisposition string

type ApprovalHandler func(ApprovalRequest) (ApprovalDecision, error)

type ApprovalRequest struct {
	ToolName string
	Command  string
	Reason   string
}

type ArgumentDecoder interface {
	Decode(string, ResolvedTool) (json.RawMessage, error)
}

type DelegateSubAgentError struct {
	Code      string `json:"code"`
	Message   string `json:"message"`
	Retryable bool   `json:"retryable"`
}

type DelegateSubAgentHandler func(context.Context, DelegateSubAgentRequest, *ExecutionContext) (DelegateSubAgentResult, error)

type DelegateSubAgentRequest struct {
	Agent           string                `json:"agent"`
	Task            string                `json:"task"`
	Scope           DelegateSubAgentScope `json:"scope"`
	Timeout         string                `json:"timeout"`
	Isolation       string                `json:"isolation"`
	Output          string                `json:"output"`
	RunInBackground bool                  `json:"run_in_background"`
	ResumeSessionID string                `json:"resume_session_id,omitempty"`
}

type DelegateSubAgentResult struct {
	OK                  bool                   `json:"ok"`
	Status              string                 `json:"status,omitempty"`
	InvocationID        string                 `json:"invocation_id"`
	Agent               string                 `json:"agent"`
	TaskID              string                 `json:"task_id,omitempty"`
	ResultReadTool      string                 `json:"result_read_tool,omitempty"`
	StopTool            string                 `json:"stop_tool,omitempty"`
	Summary             string                 `json:"summary,omitempty"`
	Content             string                 `json:"content,omitempty"`
	Error               *DelegateSubAgentError `json:"error,omitempty"`
	Transcript          []TranscriptMessage    `json:"transcript,omitempty"`
	TranscriptSessionID string                 `json:"transcript_session_id,omitempty"`
	Task                string                 `json:"task,omitempty"`
	ModifiedFiles       []string               `json:"modified_files,omitempty"`
	Worktree            *WorktreeInfo          `json:"worktree,omitempty"`
	// ToolCalls carries structured tool call records from the subagent session.
	// Populated by the executor for TUI restoration; excluded from JSON via
	// json:"-" so it never reaches the parent LLM context.
	ToolCalls []SubAgentToolCallRecord `json:"-"`
}

type DelegateSubAgentScope struct {
	Paths   []string `json:"paths"`
	Symbols []string `json:"symbols"`
}

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

type DiffFile struct {
	Path       string     `json:"path"`
	NewPath    string     `json:"new_path,omitempty"`
	ChangeType string     `json:"change_type"` // add, delete, modify, move
	Added      int        `json:"added"`
	Removed    int        `json:"removed"`
	Hunks      []DiffHunk `json:"hunks"`
	Truncated  bool       `json:"truncated"`
}

type DiffHunk struct {
	OldStart int      `json:"old_start"`
	OldLines int      `json:"old_lines"`
	NewStart int      `json:"new_start"`
	NewLines int      `json:"new_lines"`
	Lines    []string `json:"lines"`
}

type DiffPreview struct {
	Files        []DiffFile `json:"files"`
	TotalFiles   int        `json:"total_files"`
	TotalAdded   int        `json:"total_added"`
	TotalRemoved int        `json:"total_removed"`
	Truncated    bool       `json:"truncated"`
}

type ExecuteRequest struct {
	Name    string
	RawArgs string
	Mode    planpkg.AgentMode
	Context *ExecutionContext
}

type ExecuteResult struct {
	Name   string
	Spec   ToolSpec
	Output string
}

type ExecutionContext struct {
	Workspace                 string
	WritableRoots             []string
	ApprovalPolicy            string
	ApprovalMode              string
	AwayPolicy                string
	SandboxEnabled            bool
	SystemSandboxMode         string
	SkipShellApproval         bool
	SandboxEscalationApproved bool
	LeaseID                   string
	RunID                     string
	FSRead                    []string
	FSWrite                   []string
	ExecAllowlist             []sandboxpkg.ExecRule
	NetworkAllowlist          []sandboxpkg.NetworkRule
	Lease                     *sandboxpkg.Lease
	LeaseKeyring              map[string][]byte

	Approval    ApprovalHandler
	Session     *session.Session
	TaskManager runtimepkg.TaskManager
	// Extensions is an optional passthrough hook for callers that need extension context.
	// It stays untyped here to keep tools/extension packages decoupled.
	Extensions       any
	Mode             planpkg.AgentMode
	Stdin            io.Reader
	Stdout           io.Writer
	AllowedTools     map[string]struct{}
	DeniedTools      map[string]struct{}
	DelegateSubAgent DelegateSubAgentHandler
}

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

type GitDiffTool struct{}

type GitStatusTool struct{}

type ListFilesTool struct{}

type OutputNormalizer interface {
	Normalize(string, ResolvedTool) string
}

type PermissionEngine interface {
	Check(context.Context, ResolvedTool, *ExecutionContext) error
}

type ReadFileTool struct{}

type RegisterOptions struct {
	Source       RegistrationSource
	ExtensionID  string
	OriginalName string
	// AllowOriginalNameShadowBuiltin permits extension registrations to reuse an
	// existing builtin original tool name. This is only intended for bridge
	// aliases whose tool key is source-aware and unique.
	AllowOriginalNameShadowBuiltin bool
}

type RegistrationMeta struct {
	ToolKey          string
	StableToolKey    string
	OriginalToolName string
	Source           RegistrationSource
	ExtensionID      string
	ConflictPolicy   string
}

type RegistrationSource string

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

type RegistryError struct {
	Code             RegistryErrorCode
	Message          string
	ToolKey          string
	OriginalToolName string
	Source           RegistrationSource
	ExtensionID      string
	ConflictWith     RegistrationMeta
	Cause            error
}

type RegistryErrorCode string

type ReplaceInFileTool struct{}

type ResolvedTool struct {
	Definition llm.ToolDefinition
	Spec       ToolSpec
	Tool       Tool
}

type RunShellTool struct{}

type RunTestsTool struct{}

type SafetyClass string

type SearchTextTool struct{}

type SubAgentToolCallRecord struct {
	ToolName    string   `json:"ToolName"`
	ToolCallID  string   `json:"ToolCallID"`
	CompactBody string   `json:"CompactBody"`
	Status      string   `json:"Status"`
	DetailLines []string `json:"DetailLines,omitempty"`
}

type SystemSandboxBackendCapabilities struct {
	Name                   string
	Known                  bool
	ShellNetworkIsolation  bool
	WorkerNetworkIsolation bool
}

type SystemSandboxRuntimeStatus struct {
	SandboxEnabled         bool
	RequestedMode          string
	Mode                   string
	GOOS                   string
	BackendEnabled         bool
	BackendName            string
	RequiredCapable        bool
	CapabilityLevel        string
	ShellNetworkIsolation  bool
	WorkerNetworkIsolation bool
	Fallback               bool
	Message                string
}

type TaskOutputTool struct{}

type TaskStopTool struct{}

type Tool interface {
	Definition() llm.ToolDefinition
	Run(context.Context, json.RawMessage, *ExecutionContext) (string, error)
}

type ToolErrorCode string

type ToolExecError struct {
	Code      ToolErrorCode
	Message   string
	Retryable bool
	Cause     error
}

type ToolSpec struct {
	Name            string
	ReadOnly        bool
	ConcurrencySafe bool
	Destructive     bool
	SafetyClass     SafetyClass
	StrictArgs      bool
	SearchHint      string
	AllowedModes    []planpkg.AgentMode
	DefaultTimeoutS int
	MaxTimeoutS     int
	MaxResultChars  int
}

type ToolSpecProvider interface {
	Spec() ToolSpec
}

type TranscriptMessage struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type UpdatePlanTool struct{}

type WebFetchTool struct {
	HTTPClient *http.Client
}

type WebSearchTool struct {
	BaseURL    string
	HTTPClient *http.Client
}

type WorktreeInfo struct {
	Path   string `json:"path,omitempty"`
	Branch string `json:"branch,omitempty"`
	State  string `json:"state,omitempty"` // "changed" | "unknown"
}

type WriteFileTool struct{}