tools

type ACPRemote struct {
	URL   string
	Token string
}

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

type AlarmGateway interface {
	Set(*automation.Alarm) error
	Cancel(id string) bool
	List() []*automation.Alarm
}

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

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

type AskUserBridge func(ctx context.Context, prompt string, choices []string) (text string, index int, cancel bool)

type AskUserInput struct {
	Question string   `json:"question"`
	Choices  []string `json:"choices,omitempty"`
}

type AskUserOutput struct {
	Answer    string `json:"answer"`
	Index     int    `json:"index"`
	Cancelled bool   `json:"cancelled"`
}

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

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

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

type AutomationLister interface {
	LoadSOPs() ([]automation.SOP, error)
}

type AvailableTool interface{ Available() bool }

type BashSecurityOption bool

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

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

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

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

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

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

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

type BrowserHostPolicy struct {
	Allowed []string
	Blocked []string
}

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

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

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

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

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

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

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

type CanvasHandler func(context.Context, string, string) (json.RawMessage, error)

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

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

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

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

type CommitInfo struct {
	Hash    string
	Message string
	Author  string
	Date    string
}

type Compressor interface {
	ToolName() string
	Compress(output json.RawMessage) (json.RawMessage, int, error)
}

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

type ConcurrencySafeTool interface {
	Tool
	// IsConcurrencySafe reports whether this invocation of the tool
	// can run in parallel with other concurrent-safe tools. Tool
	// implementations should base this on the input — e.g., a Bash
	// tool returns true for "ls" but false for "npm install".
	IsConcurrencySafe(input json.RawMessage) bool
}

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

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

type CronLister interface {
	LoadJobs(ctx context.Context) ([]cron.Job, error)
}

type CurrentModelProvider interface {
	Model() string
}

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

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

type DevBrowserClickTool struct {
	Manager *devbrowser.Manager
}

type DevBrowserOpenTool struct {
	Manager *devbrowser.Manager
}

type DevBrowserSnapshotTool struct {
	Manager *devbrowser.Manager
}

type DevBrowserTypeTool struct {
	Manager *devbrowser.Manager
}

type DiagnoseNextTierTool struct{}

type DiagramComponent struct {
	Name        string   `json:"name"`
	Kind        string   `json:"kind"` // service, database, gateway, tool, external
	Description string   `json:"description"`
	DependsOn   []string `json:"depends_on"`
}

type DiagramInput struct {
	Title       string             `json:"title"`       // Diagram title
	Type        string             `json:"type"`        // Mermaid diagram type: flowchart, sequenceDiagram, classDiagram, erDiagram, graph
	Description string             `json:"description"` // Natural language description of what to diagram
	Components  []DiagramComponent `json:"components,omitempty"`
}

type DiagramRenderer interface {
	Render(mermaid string, title string) (svg string, err error)
}

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

type ExecutionGuard func(context.Context, Tool, json.RawMessage) (json.RawMessage, error)

type ExecutionOptions struct {
	Timeout    time.Duration
	WorkingDir string
	Env        map[string]string
}

type FSInput struct {
	Action  string `json:"action"`
	Path    string `json:"path"`
	Content string `json:"content"`
	Old     string `json:"old"`
	New     string `json:"new"`
	Pattern string `json:"pattern"`
	Offset  int    `json:"offset"`
	Limit   int    `json:"limit"`
}

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

type FactoryDeps struct {
	Canvas     CanvasHandler        // application-bound persisted session canvas
	ACPRemotes map[string]ACPRemote // trusted named destinations/credentials

	// CWD is the working directory for file-system-scoped tools.
	CWD            string
	ExecutionGuard ExecutionGuard

	// ── Browser ──────────────────────────────────────────────────────
	BrowserManager *browser.Manager
	BrowserPolicy  BrowserHostPolicy

	// ── Dev browser (legacy narrow surface) ──────────────────────────
	DevBrowserManager *devbrowser.Manager

	// ── Vision ───────────────────────────────────────────────────────
	VisionDescriber vision.Describer

	// ── LSP ──────────────────────────────────────────────────────────
	LSPQuerier LSPQuerier
	LSPManager *lsp.Manager

	// ── Memory ───────────────────────────────────────────────────────
	MemoryOrchestrator *memory.Orchestrator

	// ── Plan ─────────────────────────────────────────────────────────
	PlanQuerier PlanQuerier

	// ── Checkpoint ───────────────────────────────────────────────────
	CheckpointManager   *checkpoint.Manager
	CheckpointSessionFn func() string

	// ── Subagent ─────────────────────────────────────────────────────
	SubagentManager *subagent.Manager

	// ── Goal ─────────────────────────────────────────────────────────
	GoalQuerier GoalQuerier

	// ── Tasks ────────────────────────────────────────────────────────
	TasksStore        TasksStore
	SessionIDProvider SessionIDProvider

	// ── Segments ─────────────────────────────────────────────────────
	SegmentsStore SegmentsStore

	// ── Standing Orders ──────────────────────────────────────────────
	StandingOrdersStore StandingOrdersStore

	// ── Journal ──────────────────────────────────────────────────────
	JournalQuerier JournalQuerier
	JournalReader  JournalReader // bookmark_recall

	// ── Playbooks ────────────────────────────────────────────────────
	PlaybooksStore PlaybooksStore

	// ── Automation ───────────────────────────────────────────────────
	AutomationLister AutomationLister
	CronLister       CronLister

	// ── FailHypo ─────────────────────────────────────────────────────
	FailHypoQuerier FailHypoQuerier

	// ── Learnings ────────────────────────────────────────────────────
	LearningsQuerier LearningsQuerier
	LearnRecorder    LearnRecorder

	// ── Pipeline ─────────────────────────────────────────────────────
	PipelineRunner PipelineRunner

	// ── Project Root ─────────────────────────────────────────────────
	ProjectRootResolver ProjectRootResolver

	// ── Ask User ─────────────────────────────────────────────────────
	AskUserBridge AskUserBridge

	// ── Alarm ────────────────────────────────────────────────────────
	AlarmGateway   AlarmGateway
	AlarmSessionFn func() string

	// ── Tags ─────────────────────────────────────────────────────────
	TagsManager *tags.Manager

	// ── Architecture Walls ───────────────────────────────────────────
	ArchitectureWall *walls.ArchitectureWall
	OuroborosWall    *walls.OuroborosWall

	// ── Regression Bank ──────────────────────────────────────────────
	RegressionBank *walls.RegressionBank

	// ── Autocommit ───────────────────────────────────────────────────
	AutoCommitter *automation.AutoCommitter

	// ── Multimodal ───────────────────────────────────────────────────
	MultimodalRegistry *multimodal.Registry

	// ── Introspect / Skill Extract ───────────────────────────────────
	IntrospectDir   string
	SkillExtractDir string

	// ── Extra tools ──────────────────────────────────────────────────
	// For sub-package tools (tts, messaging, imagegen) that live outside
	// the tools package and may transitively import gateway → agent →
	// tools (creating an import cycle if imported here). Callers in
	// cmd/overkill construct these tools and append them here.
	ExtraTools []Tool
}

type FailHypoQuerier interface {
	Search(query string) ([]journal.FailedHypothesis, error)
	SearchForModel(query, modelID string) ([]journal.FailedHypothesis, error)
	All() ([]journal.FailedHypothesis, error)
}

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

type FileDiff struct {
	Path      string
	Status    string
	Additions int
	Deletions int
}

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

type GitCompressor struct{}

type GitInput struct {
	Action      string   `json:"action"`
	Staged      bool     `json:"staged"`
	Stat        bool     `json:"stat"`
	Count       int      `json:"count"`
	Paths       []string `json:"paths"`
	Message     string   `json:"message"`
	Ref         string   `json:"ref"`
	StashAction string   `json:"stash_action"`
}

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

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

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

type GoalQuerier interface {
	SetWithBudgets(ctx context.Context, sessionID, text string, tokenBudget, timeBudget int) error
	Get(ctx context.Context, sessionID string) (goalJSON json.RawMessage, err error)
	SetStatus(ctx context.Context, sessionID string, status string) error
	GetStatus(ctx context.Context, sessionID string) (string, error)
}

type GoalStoreBackend interface {
	SetWithBudgets(ctx context.Context, sessionID, text string, tokenBudget, timeBudget int) error
	Get(ctx context.Context, sessionID string) (json.RawMessage, error)
	SetStatus(ctx context.Context, sessionID string, status string) error
}

type GrepCompressor struct{}

type GrepInput struct {
	Pattern    string `json:"pattern"`
	Include    string `json:"include"`
	MaxResults int    `json:"max_results"`
}

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

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

type HoverResult struct {
	Contents string `json:"contents"`
}

type Hunk struct {
	OldStart int
	OldCount int
	NewStart int
	NewCount int
	Lines    []string // each starts with ' ', '-', or '+'
}

type InterruptBehavior int

type InterruptibleTool interface {
	Tool
	InterruptBehavior() InterruptBehavior
}

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

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

type JournalQuerier interface {
	SearchFlight(opts journal.FlightSearchOptions) ([]journal.FlightIndexHit, error)
	TimelineFlight(anchorID string, depth int) ([]journal.Entry, error)
	GetFlight(id string) (*journal.Entry, error)
}

type JournalReader interface {
	GetFlight(id string) (*journal.Entry, error)
}

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

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

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

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

type LSPQuerier interface {
	// Available reports whether any language server is running and can handle
	// the given path. Tools short-circuit with a clear error otherwise.
	Available(path string) bool
	Hover(ctx context.Context, path string, line, col int) (HoverResult, error)
	Definition(ctx context.Context, path string, line, col int) ([]LocationResult, error)
	References(ctx context.Context, path string, line, col int) ([]LocationResult, error)
}

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

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

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

type LearnRecorder interface {
	RecordSuccess(class string) bool
	Snapshot() map[string]int
}

type LearningsQuerier interface {
	Append(l plan.Learning) error
	All() ([]plan.Learning, error)
	Search(query string) ([]plan.Learning, error)
	SearchForModel(query, modelID string) ([]plan.Learning, error)
}

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

type LocationResult struct {
	File      string `json:"file"`
	Line      int    `json:"line"`
	Column    int    `json:"column"`
	EndLine   int    `json:"end_line,omitempty"`
	EndColumn int    `json:"end_column,omitempty"`
}

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

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

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

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

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

type PatchCompressor struct{}

type PatchInput struct {
	Path  string `json:"path"`
	Patch string `json:"patch"`
}

type PatchOutput struct {
	Path         string `json:"path"`
	HunksApplied int    `json:"hunks_applied"`
	Result       string `json:"result"` // resulting file content
}

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

type PipelineRunner interface {
	// Run executes all four stages sequentially. The result is whatever
	// JSON shape the underlying pipeline.PipelineResult marshals to; the
	// tool passes it through to the model without re-shaping.
	Run(ctx context.Context, request string) (json.RawMessage, error)
}

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

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

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

type PlanQuerier interface {
	Current() *plan.Plan
	Set(title string, items []string) (*plan.Plan, error)
	Check(itemID, note string) (*plan.Plan, error)
	Uncheck(itemID string) (*plan.Plan, error)
	Clear() error
	Remaining() int
}

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

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

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

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

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

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

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

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

type PlaybooksStore interface {
	Create(pb *playbooks.Playbook) (*playbooks.Playbook, error)
	Get(id string) (*playbooks.Playbook, error)
	Delete(id string) error
	Use(id string) (*playbooks.Playbook, error)
	RecordOutcome(id string, success bool) (*playbooks.Playbook, error)
	Refine(parentID, content, description string) (*playbooks.Playbook, error)
	All() ([]*playbooks.Playbook, error)
	Rank(taskType, query string, topK int, opts playbooks.RankOptions) ([]playbooks.Hit, error)
}

type ProjectRootResolver func() string

type PushPreview struct {
	Commits    []CommitInfo
	Files      []FileDiff
	HasSecrets bool
	SecretHits []SecretHit
}

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

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

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

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

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

type SecretHit struct {
	File    string
	Line    int
	Pattern string
	Preview string
}

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

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

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

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

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

type SegmentsStore interface {
	Create(seg *memory.Segment) (*memory.Segment, error)
	Get(id string) (*memory.Segment, error)
	Delete(id string) error
	All() ([]*memory.Segment, error)
	Search(query string) ([]*memory.Segment, error)
	Rank(query string, topK int, opts memory.RankOptions) ([]memory.SegmentHit, error)
	Touch(id string) error
	LoadFiles(id string) ([]string, error)
}

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

type SessionIDProvider interface {
	SessionID() string
}

type ShellCompressor struct{}

type ShellInput struct {
	Command        string            `json:"command"`
	TimeoutSeconds int               `json:"timeout_seconds"`
	WorkingDir     string            `json:"working_dir"`
	Env            map[string]string `json:"env"`
}

type ShellOutput struct {
	// Raw combined bytes include ANSI escapes and the completion marker;
	// visible output retains at most 1 MiB plus a truncation notice.
	OutputTruncated bool   `json:"output_truncated,omitempty"`
	OutputBytes     int64  `json:"output_bytes,omitempty"`
	ExitCode        int    `json:"exit_code"`
	Stdout          string `json:"stdout"`
	Stderr          string `json:"stderr"`
	TimedOut        bool   `json:"timed_out"`
	Completed       bool   `json:"completed"`
	// Cwd is $PWD at the moment the marker fired — i.e. the working
	// directory the shell ended in (after any `cd` in the command).
	// Empty when the marker didn't carry a cwd (legacy / parse failure).
	Cwd string `json:"cwd,omitempty"`
	// ElapsedMs is wall-clock time from exec start to marker. Measured
	// Go-side. Includes shell startup + the command itself.
	ElapsedMs int64 `json:"elapsed_ms,omitempty"`
}

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

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

type SliceDecomposeTool struct{}

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

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

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

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

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

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

type StandingOrdersStore interface {
	AddEVR(text, verify, report string) (*automation.StandingOrder, error)
	Remove(id string) error
	SetEnabled(id string, enabled bool) error
	All() []automation.StandingOrder
}

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

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

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

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

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

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

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

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

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

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