tools

type AllowedAgentArg struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace,omitempty"`
}

type AutoMergePullRequestArgs struct {
	// TaskName is the name of the child task to read workspace config from.
	TaskName string `json:"task_name"`
	// PRNumber is the GitHub PR number to merge.
	PRNumber int `json:"pr_number"`
	// MergeMethod is the merge method: "merge", "squash", "rebase". Defaults to "squash".
	MergeMethod string `json:"merge_method,omitempty"`
	// CommitTitle is the custom merge commit title.
	CommitTitle string `json:"commit_title,omitempty"`
	// CommitMessage is the custom merge commit message.
	CommitMessage string `json:"commit_message,omitempty"`
	// Timeout is the maximum time to wait for CI checks (e.g. "30m"). Defaults to "30m".
	Timeout string `json:"timeout,omitempty"`
}

type AutoMergePullRequestResult struct {
	Merged        bool   `json:"merged"`
	ChecksPassed  bool   `json:"checks_passed"`
	SHA           string `json:"sha,omitempty"`
	Message       string `json:"message"`
	Outcome       string `json:"outcome"`
	ChecksDetails string `json:"checks_details,omitempty"`
}

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

type BrokeredDelegateTaskTransactionExchangeConfig struct {
	TTS                 contexttoken.TTSConfig
	Exchanger           contexttoken.Exchanger
	SubjectTokenType    string
	ChildScope          string
	ResolveSubjectToken DelegateTaskSubjectTokenResolver
}

type CICheckResult struct {
	Passed  bool
	Failed  bool
	Pending bool
	Details string
}

type CancelTaskArgs struct {
	TaskName  string `json:"task_name"`
	Namespace string `json:"namespace,omitempty"`
	Reason    string `json:"reason,omitempty"`
}

type CancelTaskResult struct {
	TaskName string `json:"taskName"`
	Status   string `json:"status"`
}

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

type ChatCancelTaskTool struct{}

type ChatCreateAgentTool struct{}

type ChatDeleteAgentTool struct{}

type ChatToolError struct {
	Type       string `json:"errorType"`
	Message    string `json:"error"`
	Suggestion string `json:"suggestion"`
}

type ChatToolResult struct {
	Success    bool   `json:"success"`
	Data       any    `json:"data,omitempty"`
	Error      string `json:"error,omitempty"`
	ErrorType  string `json:"errorType,omitempty"`
	Suggestion string `json:"suggestion,omitempty"`
}

type CheckMessagesArgs struct {
	MarkRead *bool `json:"mark_read,omitempty"`
}

type CheckMessagesTool struct{}

type CheckPRReviewMarkerArgs struct {
	TaskName string `json:"task_name,omitempty"`
	RepoURL  string `json:"repo_url,omitempty"`
	PRNumber int    `json:"pr_number"`
	HeadSHA  string `json:"head_sha,omitempty"`
}

type CheckPRReviewMarkerResult struct {
	Found    bool   `json:"found"`
	PRNumber int    `json:"pr_number"`
	HeadSHA  string `json:"head_sha,omitempty"`
	Marker   string `json:"marker,omitempty"`
	Source   string `json:"source,omitempty"`
	HTMLURL  string `json:"html_url,omitempty"`
	Author   string `json:"author,omitempty"`
	Message  string `json:"message"`
}

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

type CheckPullRequestCIArgs struct {
	// TaskName is the child task whose workspace config has the repo and git credentials.
	TaskName string `json:"task_name,omitempty"`
	// RepoURL is an explicit GitHub repository URL. When provided with task context, it must match that task's repository scope.
	RepoURL string `json:"repo_url,omitempty"`
	// PRNumber is the GitHub PR number to inspect.
	PRNumber int `json:"pr_number"`
	// WaitTimeout is the optional maximum time to wait for pending checks (e.g. "30m").
	// When empty, the tool performs one immediate status check.
	WaitTimeout string `json:"wait_timeout,omitempty"`
	// PollInterval is the optional delay between polls while waiting (e.g. "30s").
	// Defaults to 30s when wait_timeout is set.
	PollInterval string `json:"poll_interval,omitempty"`
}

type CheckPullRequestCIResult struct {
	Status        string `json:"status"`
	PRNumber      int    `json:"pr_number"`
	HeadSHA       string `json:"head_sha,omitempty"`
	ChecksPassed  bool   `json:"checks_passed"`
	ChecksFailed  bool   `json:"checks_failed"`
	ChecksPending bool   `json:"checks_pending"`
	ChecksDetails string `json:"checks_details,omitempty"`
	WaitTimedOut  bool   `json:"wait_timed_out,omitempty"`
	Attempts      int    `json:"attempts,omitempty"`
	Message       string `json:"message"`
}

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

type CheckTaskProgressTool struct{}

type CodeExecArgs struct {
	Language string `json:"language"`
	Code     string `json:"code"`
	Timeout  int    `json:"timeout,omitempty"` // Timeout in seconds
}

type CodeExecResult struct {
	Output          string `json:"output"`
	Error           string `json:"error,omitempty"`
	ExitCode        int    `json:"exit_code"`
	TimedOut        bool   `json:"timed_out,omitempty"`
	OutputTruncated bool   `json:"output_truncated,omitempty"`
	ErrorTruncated  bool   `json:"error_truncated,omitempty"`
}

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

type CodeExecutionRequest struct {
	Backend          string
	Language         string
	Code             string
	Timeout          time.Duration
	WorkDir          string
	DenyPatterns     []denyPattern
	OutputLimitBytes int64
	ResourceAudit    map[string]string
	Tenant           string
	Provider         string
	ProviderType     string
	RunID            string
	InputHash        string
}

type CodeExecutor interface {
	Execute(ctx context.Context, req CodeExecutionRequest) CodeExecResult
}

type CommentOnIssueArgs struct {
	// TaskName is the name of a task whose workspace config provides the repo and git credentials.
	TaskName string `json:"task_name"`
	// RepoURL is a direct GitHub repo URL (falls back to ORKA_GIT_REPO env var).
	RepoURL string `json:"repo_url"`
	// IssueNumber is the GitHub issue number to comment on.
	IssueNumber int `json:"issue_number"`
	// Body is the comment text (Markdown supported).
	Body string `json:"body"`
}

type CommentOnIssueResult struct {
	CommentID int    `json:"comment_id"`
	HTMLURL   string `json:"html_url"`
	Status    string `json:"status"`
}

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

type CoordinationArgs struct {
	Enabled               bool              `json:"enabled"`
	MaxDepth              int32             `json:"maxDepth,omitempty"`
	MaxConcurrentChildren int32             `json:"maxConcurrentChildren,omitempty"`
	AllowedAgents         []AllowedAgentArg `json:"allowedAgents,omitempty"`
}

type CreateAITaskTool struct{}

type CreateAgentArgs struct {
	Role         string            `json:"role"`
	SystemPrompt string            `json:"systemPrompt"`
	Model        *ModelArgs        `json:"model,omitempty"`
	ProviderRef  string            `json:"providerRef,omitempty"`
	Tools        []string          `json:"tools,omitempty"`
	Skills       []string          `json:"skills,omitempty"`
	Coordination *CoordinationArgs `json:"coordination,omitempty"`
	Runtime      *RuntimeArgs      `json:"runtime,omitempty"`
}

type CreateAgentResult struct {
	AgentName string `json:"agentName"`
	Namespace string `json:"namespace"`
	Status    string `json:"status"`
}

type CreateAgentTaskTool struct{}

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

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

type CreatePRMonitorTool struct{}

type CreatePullRequestArgs struct {
	// TaskName is the name of the completed child task whose branch to use.
	// The tool reads the task's workspace config to determine repo and git secret.
	TaskName string `json:"task_name"`
	// HeadBranch is the remote branch that contains the changes.
	HeadBranch string `json:"head_branch"`
	// BaseBranch is the target branch to merge into (e.g. "main").
	BaseBranch string `json:"base_branch"`
	// Title is the pull request title.
	Title string `json:"title"`
	// Body is the pull request body (Markdown).
	Body string `json:"body"`
}

type CreatePullRequestResult struct {
	PRURL    string `json:"pr_url"`
	PRNumber int    `json:"pr_number"`
	Status   string `json:"status"`
}

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

type CreateToolCRDTool struct{}

type DelegateTaskArgs struct {
	Agent          string         `json:"agent"`
	Prompt         string         `json:"prompt"`
	Namespace      string         `json:"namespace,omitempty"`
	AgentNamespace string         `json:"agentNamespace,omitempty"`
	TaskNamespace  string         `json:"taskNamespace,omitempty"`
	Priority       *int32         `json:"priority,omitempty"`
	Timeout        string         `json:"timeout,omitempty"`
	Workspace      *WorkspaceArgs `json:"workspace,omitempty"`
	MaxTurns       *int32         `json:"maxTurns,omitempty"`
	AllowBash      *bool          `json:"allowBash,omitempty"`

	// PriorTask references a previously completed task whose diff should be
	// applied to the workspace before this task begins. Optional.
	PriorTask string `json:"prior_task,omitempty"`

	// Feedback provides review feedback to include in the task prompt.
	// Used with prior_task for iterative code review workflows. Optional.
	Feedback string `json:"feedback,omitempty"`

	// AutoRetry marks this task for structured failure reporting.
	// When enabled, wait_for_tasks includes retry metadata (attempt count,
	// max retries, error message) in the failure result so the coordinator
	// can make informed retry decisions. Does NOT automatically re-create tasks.
	AutoRetry bool `json:"auto_retry,omitempty"`

	// MaxRetries is the maximum retry budget for coordinator reference (default: 2).
	// Only used when auto_retry is true.
	MaxRetries *int `json:"max_retries,omitempty"`
}

type DelegateTaskResult struct {
	TaskName      string `json:"taskName"`
	TaskUID       string `json:"taskUID,omitempty"`
	ParentTaskUID string `json:"parentTaskUID,omitempty"`
	Status        string `json:"status"`
}

type DelegateTaskSubjectTokenResolver func(context.Context, *corev1alpha1.Task, string) (string, error)

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

type DeleteAgentArgs struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace,omitempty"`
}

type DeleteAgentResult struct {
	Name   string `json:"name"`
	Status string `json:"status"`
}

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

type DeleteSessionTool struct{}

type DeleteToolTool struct{}

type FailureDetails struct {
	Message    string `json:"message"`
	RetryCount int    `json:"retryCount"`
	MaxRetries int    `json:"maxRetries"`
}

type FetchTaskOutputTool struct{}

type FileChange struct {
	Filename  string `json:"filename"`
	Status    string `json:"status"`
	Additions int    `json:"additions"`
	Deletions int    `json:"deletions"`
	Patch     string `json:"patch"`
}

type FileReadArgs struct {
	Path     string `json:"path"`
	Offset   int64  `json:"offset,omitempty"`
	Limit    int64  `json:"limit,omitempty"`
	Encoding string `json:"encoding,omitempty"`
}

type FileReadResult struct {
	Content   string `json:"content"`
	Path      string `json:"path"`
	Size      int64  `json:"size"`
	Truncated bool   `json:"truncated"`
}

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

type FileWriteArgs struct {
	Path       string `json:"path"`
	Content    string `json:"content"`
	Mode       string `json:"mode,omitempty"`
	CreateDirs bool   `json:"create_dirs,omitempty"`
}

type FileWriteResult struct {
	Path    string `json:"path"`
	Size    int    `json:"size"`
	Mode    string `json:"mode"`
	Created bool   `json:"created"`
}

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

type GetIssueArgs struct {
	// TaskName is the name of the task to read workspace config from (optional).
	TaskName string `json:"task_name"`
	// RepoURL is a direct GitHub repo URL (optional; falls back to ORKA_GIT_REPO).
	RepoURL string `json:"repo_url"`
	// IssueNumber is the GitHub issue number (required).
	IssueNumber int `json:"issue_number"`
}

type GetIssueResult struct {
	Number       int            `json:"number"`
	Title        string         `json:"title"`
	Body         string         `json:"body"`
	Author       string         `json:"author"`
	Labels       []string       `json:"labels"`
	Assignees    []string       `json:"assignees"`
	State        string         `json:"state"`
	CreatedAt    string         `json:"created_at"`
	HTMLURL      string         `json:"html_url"`
	CommentCount int            `json:"comment_count"`
	Comments     []IssueComment `json:"comments"`
}

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

type GitHubPullRequest struct {
	HTMLURL string
	Number  int
	Status  string
}

type InProcessCodeExecutor struct{}

type IssueComment struct {
	Author    string `json:"author"`
	Body      string `json:"body"`
	CreatedAt string `json:"created_at"`
}

type IssueSummary struct {
	Number    int      `json:"number"`
	Title     string   `json:"title"`
	Body      string   `json:"body"`
	Author    string   `json:"author"`
	Labels    []string `json:"labels"`
	CreatedAt string   `json:"created_at"`
	HTMLURL   string   `json:"html_url"`
}

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

type ListAgentsTool struct{}

type ListIssuesArgs struct {
	// TaskName is the name of a task whose workspace config provides the repo and git credentials.
	TaskName string `json:"task_name"`
	// RepoURL is a direct GitHub repo URL (falls back to ORKA_GIT_REPO env var).
	RepoURL string `json:"repo_url"`
	// UnassignedOnly filters to issues with no assignee. Default is true.
	UnassignedOnly *bool `json:"unassigned_only"`
	// PerPage is the number of results per page (default: 30, max: 100).
	PerPage int `json:"per_page"`
	// Page is the page number for pagination.
	Page int `json:"page"`
}

type ListIssuesResult struct {
	Issues      []IssueSummary `json:"issues"`
	Count       int            `json:"count"`         // number of issues on this page (after filtering)
	HasNextPage bool           `json:"has_next_page"` // true if more pages may exist
}

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

type ListPullRequestsArgs struct {
	TaskName string `json:"task_name"` // optional: resolve repo from a task's workspace
	RepoURL  string `json:"repo_url"`  // optional: direct repo URL; with task context it must match that task's repository scope
	PerPage  int    `json:"per_page"`  // results per page (default: 30, max: 100)
	Page     int    `json:"page"`      // page number (default: 1)
}

type ListPullRequestsResult struct {
	PullRequests []PRSummary `json:"pull_requests"`
	TotalCount   int         `json:"total_count"`
}

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

type ListTasksTool struct{}

type ListToolsTool struct{}

type MemoryProposalWriter interface {
	CreateMemoryProposal(context.Context, *store.MemoryProposal) error
}

type MemoryReader interface {
	ListMemories(context.Context, store.MemoryFilter) ([]store.Memory, error)
}

type MergePullRequestArgs struct {
	// TaskName is the name of the child task to read workspace config from.
	TaskName string `json:"task_name"`
	// PRNumber is the GitHub PR number to merge.
	PRNumber int `json:"pr_number"`
	// MergeMethod is the merge method: "merge", "squash", "rebase". Defaults to "squash".
	MergeMethod string `json:"merge_method,omitempty"`
	// CommitTitle is the custom merge commit title.
	CommitTitle string `json:"commit_title,omitempty"`
	// CommitMessage is the custom merge commit message.
	CommitMessage string `json:"commit_message,omitempty"`
}

type MergePullRequestResult struct {
	SHA          string `json:"sha"`
	Merged       bool   `json:"merged"`
	Message      string `json:"message"`
	ChecksPassed bool   `json:"checks_passed"`
}

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

type ModelArgs struct {
	Provider      string `json:"provider,omitempty"`
	Name          string `json:"name,omitempty"`
	ContextWindow *int32 `json:"contextWindow,omitempty"`
	MaxTokens     *int32 `json:"maxTokens,omitempty"`
}

type PRSummary struct {
	Number     int      `json:"number"`
	Title      string   `json:"title"`
	Body       string   `json:"body"`
	Author     string   `json:"author"`
	BaseBranch string   `json:"base_branch"`
	HeadBranch string   `json:"head_branch"`
	Labels     []string `json:"labels"`
	CreatedAt  string   `json:"created_at"`
	HTMLURL    string   `json:"html_url"`
	Draft      bool     `json:"draft"`
}

type PostReviewCommentArgs struct {
	// TaskName is an optional task to read workspace config and credentials from.
	TaskName string `json:"task_name,omitempty"`
	// RepoURL is an optional GitHub repository URL.
	RepoURL string `json:"repo_url,omitempty"`
	// PRNumber is the GitHub PR number.
	PRNumber int `json:"pr_number"`
	// Body is the top-level review body text.
	Body string `json:"body"`
	// Event is one of reviewEventApprove, reviewEventRequestChanges, reviewEventComment.
	Event string `json:"event"`
	// Comments is an optional list of line-level review comments.
	Comments []ReviewComment `json:"comments,omitempty"`
}

type PostReviewCommentResult struct {
	ReviewID int    `json:"review_id"`
	Status   string `json:"status"`
	HTMLURL  string `json:"html_url"`
}

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

type ProposeMemoryTool struct{}

type RecallMemoryTool struct{}

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

type RememberMemoryTool struct{}

type RepositoryValidationBindingStore interface {
	CreateMonitorEvent(context.Context, *store.MonitorEvent) error
	ListMonitorEvents(context.Context, store.MonitorEventFilter) ([]store.MonitorEvent, string, error)
}

type RepositoryValidationCommandBinding struct {
	MonitorNamespace   string
	MonitorName        string
	RunID              string
	ItemKind           string
	ItemNumber         int64
	MonitorUID         string
	ReviewTaskName     string
	ReviewTaskUID      string
	ValidationTaskName string
	Image              string
	HeadSHA            string
	CommandDigest      string
}

type RequestApprovalTool struct{}

type RequestApprovalValidationError struct {
	Err error
}

type ReviewComment struct {
	// Path is the file path relative to the repo root.
	Path string `json:"path"`
	// Line is the line number in the diff (new file line number).
	Line int `json:"line"`
	// Body is the comment text.
	Body string `json:"body"`
}

type ReviewPullRequestArgs struct {
	// TaskName is an optional task to read workspace config and credentials from.
	TaskName string `json:"task_name,omitempty"`
	// RepoURL is an optional GitHub repository URL.
	RepoURL string `json:"repo_url,omitempty"`
	// PRNumber is the GitHub PR number to review.
	PRNumber int `json:"pr_number"`
}

type ReviewPullRequestResult struct {
	PRTitle    string       `json:"pr_title"`
	PRBody     string       `json:"pr_body"`
	PRAuthor   string       `json:"pr_author"`
	BaseBranch string       `json:"base_branch"`
	HeadBranch string       `json:"head_branch"`
	Diff       string       `json:"diff"`
	Files      []FileChange `json:"files"`
	Status     string       `json:"status"`
}

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

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

type RuntimeArgs struct {
	Type                string   `json:"type"`
	SecretRef           string   `json:"secretRef,omitempty"`
	DefaultAllowedTools []string `json:"defaultAllowedTools,omitempty"`
	DefaultAllowBash    *bool    `json:"defaultAllowBash,omitempty"`
}

type SearchTranscriptTool struct{}

type SendMessageArgs struct {
	ToTask  string `json:"to_task"`
	Content string `json:"content"`
}

type SendMessageTool struct{}

type TaskMessageStore interface {
	SendMessage(context.Context, *store.Message) error
	GetMessages(context.Context, string, string, string, bool) ([]store.Message, error)
}

type TaskResultInfo struct {
	Task             string                                     `json:"task"`
	Agent            string                                     `json:"agent,omitempty"`
	Phase            string                                     `json:"phase"`
	Result           string                                     `json:"result,omitempty"`
	Summary          string                                     `json:"summary,omitempty"`
	Verdict          string                                     `json:"verdict,omitempty"`
	Feedback         string                                     `json:"feedback,omitempty"`
	Files            []string                                   `json:"files,omitempty"`
	Data             map[string]any                             `json:"data,omitempty"`
	Artifacts        []common.ArtifactRef                       `json:"artifacts,omitempty"`
	BaseSHA          string                                     `json:"baseSHA,omitempty"`
	HeadSHA          string                                     `json:"headSHA,omitempty"`
	PushBranch       string                                     `json:"pushBranch,omitempty"`
	WorkspaceRef     string                                     `json:"workspaceRef,omitempty"`
	WorkspaceBranch  string                                     `json:"workspaceBranch,omitempty"`
	Iteration        string                                     `json:"iteration,omitempty"`
	FailureDetails   *FailureDetails                            `json:"failureDetails,omitempty"`
	Retried          bool                                       `json:"retried,omitempty"`
	RetryTaskName    string                                     `json:"retryTaskName,omitempty"`
	ExecutionOutcome *corev1alpha1.TaskWorkloadExecutionOutcome `json:"executionOutcome,omitempty"`
	WorkspaceStatus  *corev1alpha1.ExecutionWorkspaceStatus     `json:"workspaceStatus,omitempty"`
	Delivery         *corev1alpha1.TaskDeliveryStatus           `json:"delivery,omitempty"`
}

type Tool interface {
	// Name returns the tool name
	Name() string

	// Description returns the tool description for the LLM
	Description() string

	// Parameters returns the JSON Schema for the tool parameters
	Parameters() json.RawMessage

	// Execute executes the tool with the given arguments
	Execute(ctx context.Context, args json.RawMessage) (string, error)
}

type ToolContext struct {
	Client client.Client
	// PolicyReader bypasses informer lag when coordination tools resolve Task,
	// Agent, Provider, Tool, and AgentRuntime policy. Writes continue through Client.
	PolicyReader              client.Reader
	KubeClient                kubernetes.Interface
	Namespace                 string
	SessionID                 string
	TaskID                    string
	TaskUID                   string
	ParentTaskID              string
	AgentName                 string
	ToolCallID                string
	OperationID               string
	Tenant                    string
	Provider                  string
	ProviderType              string
	ExecutionMode             executionmode.Mode
	WatchNamespace            string
	EnforceNamespaceIsolation bool
	// Brokered marks an authenticated controller-side MCP broker execution.
	// Broker-aware tools must fail closed on missing request-scoped dependencies
	// instead of falling back to controller process environment or credentials.
	Brokered bool
	// TaskProvenanceProtected reports that Task provenance admission reserves
	// controller-authenticated lineage metadata from direct namespace writes.
	TaskProvenanceProtected bool
	// ExternalEffects and OperationID let brokered coordination tools bind
	// created resources to the controller-owned effect receipt for this exact
	// tool call. The receipt remains authoritative when provenance admission is
	// disabled and Task metadata is mutable.
	ExternalEffects store.ExternalEffectStore
	// Least-privilege durable dependencies for brokered memory tools.
	MemoryReader         MemoryReader
	MemoryProposalWriter MemoryProposalWriter
	TranscriptSearcher   TranscriptSearcher
	// RepositoryValidationBindings stores the controller-owned command binding
	// created before a repository validation Task.
	RepositoryValidationBindings RepositoryValidationBindingStore
	// ResultStore for fetching task outputs (store.ResultStore)
	ResultStore interface {
		GetResult(ctx context.Context, namespace, taskName string) ([]byte, error)
	}
	// MessageStore for inter-agent messaging when tools execute in-process from the controller broker.
	MessageStore TaskMessageStore
	// SessionDeleter for deleting sessions (controller.SessionManager)
	SessionDeleter interface {
		DeleteSession(ctx context.Context, namespace, sessionID string) error
	}
	// Task creation helpers provided by the chat executor
	GenerateTaskName     func() string
	TaskLabels           func() map[string]string
	CheckTaskLimit       func() *ChatToolError
	AuthorizeTaskCreate  func(context.Context, *corev1alpha1.Task) *ChatToolError
	AuthorizeTaskDelete  func(context.Context, *corev1alpha1.Task) *ChatToolError
	AuthorizeAgentCreate func(context.Context, *corev1alpha1.Agent) *ChatToolError
	// AuthorizeAgentInitialTask preflights the combined Agent/Task operation
	// before creating the Agent. Full Task authorization still runs later.
	AuthorizeAgentInitialTask func(context.Context, *corev1alpha1.Agent) *ChatToolError
	AuthorizeAgentUpdate      func(context.Context, *corev1alpha1.Agent) *ChatToolError
	AuthorizeAgentDelete      func(context.Context, *corev1alpha1.Agent) *ChatToolError
	AuthorizeSecretRead       func(context.Context, string, string) *ChatToolError
	AuthorizePodLogs          func(context.Context, string, string) error
	// AuthorizeCodeExecResources checks creation and cleanup permissions for
	// the complete temporary resource set before code_exec creates anything.
	AuthorizeCodeExecResources     func(context.Context, []client.Object) error
	RequireSecretReadAuthorization bool
	// RequireGitHubTaskCredentials disables controller-global repository and
	// credential fallback for external GitHub tool calls.
	RequireGitHubTaskCredentials bool
	IncrementTasks               func()
	ApprovalEmitter              func(context.Context, approvals.ApprovalTarget) error
	ApprovalTargetSpecDigest     func(context.Context, string) (string, error)
	ApprovalTargetArguments      func(context.Context, string, json.RawMessage) (json.RawMessage, error)
	ApprovalTargetRefresh        func(context.Context, string, *corev1alpha1.Tool) error
}

type TranscriptSearcher interface {
	SearchTranscript(context.Context, store.TranscriptSearchFilter) ([]store.TranscriptSearchResult, error)
}

type UpdateAgentTool struct{}

type UpdatePlanTool struct{}

type WaitForTaskTool struct{}

type WaitForTasksArgs struct {
	Tasks   []string `json:"tasks"`
	Timeout string   `json:"timeout,omitempty"`
}

type WaitForTasksResult struct {
	Completed bool             `json:"completed"`
	Results   []TaskResultInfo `json:"results"`
}

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

type WebFetchArgs struct {
	URL      string `json:"url"`
	MaxChars int    `json:"max_chars,omitempty"`
	Raw      bool   `json:"raw,omitempty"`
}

type WebFetchResult struct {
	URL       string `json:"url"`
	Status    int    `json:"status"`
	Content   string `json:"content"`
	Length    int    `json:"length"`
	Truncated bool   `json:"truncated"`
	Extractor string `json:"extractor"`
}

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

type WebSearchArgs struct {
	Query string `json:"query"`
	Limit int    `json:"limit,omitempty"`
}

type WebSearchResult struct {
	Title   string `json:"title"`
	URL     string `json:"url"`
	Snippet string `json:"snippet"`
}

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

type WorkspaceArgs struct {
	Intent                       string `json:"intent,omitempty"`
	GitRepo                      string `json:"gitRepo,omitempty"`
	Branch                       string `json:"branch,omitempty"`
	Ref                          string `json:"ref,omitempty"`
	ReadCredentialRef            string `json:"readCredentialRef,omitempty"`
	PublicationGitRepo           string `json:"publicationGitRepo,omitempty"`
	PublicationReadCredentialRef string `json:"publicationReadCredentialRef,omitempty"`
	PublicationCredentialRef     string `json:"publicationCredentialRef,omitempty"`
	ForgeCredentialRef           string `json:"forgeCredentialRef,omitempty"`
	PushBranch                   string `json:"pushBranch,omitempty"`
	PRBaseBranch                 string `json:"prBaseBranch,omitempty"`
	CreatePR                     bool   `json:"createPR,omitempty"`
}