tools

type AskUserQuestionParamOption struct {
	Label       string `json:"label"`
	Description string `json:"description"`
}

type AskUserQuestionParamQuestion struct {
	Question    string                       `json:"question"`
	Header      string                       `json:"header"`
	MultiSelect bool                         `json:"multiSelect"`
	Options     []AskUserQuestionParamOption `json:"options"`
}

type AskUserQuestionParams struct {
	Questions []AskUserQuestionParamQuestion `json:"questions"`
}

type AskUserQuestionResponseMetadata struct {
	Answers []userinput.Answer `json:"answers"`
}

type BaseTool interface {
	Info() ToolInfo
	Run(ctx context.Context, params ToolCall) (ToolResponse, error)
}

type BashParams struct {
	Command   string `json:"command"`
	Timeout   int    `json:"timeout"`
	HeadLimit int    `json:"head_limit"` // Max output lines to return (0 = no limit)
	TailLines int    `json:"tail_lines"` // Only return last N lines (0 = no limit)
}

type BashPermissionsParams struct {
	Command string `json:"command"`
	Timeout int    `json:"timeout"`
}

type BashResponseMetadata struct {
	StartTime  int64 `json:"start_time"`
	EndTime    int64 `json:"end_time"`
	TotalLines int   `json:"total_lines"`
	Truncated  bool  `json:"truncated"`
	// OutputFilter is the name of the RTK-style filter or native parser that
	// compressed the command output, empty when no compression was applied.
	OutputFilter string `json:"output_filter,omitempty"`
	// OutputFilterCharsBefore / OutputFilterCharsAfter record the byte sizes
	// before and after compression so the UI can show the token/char savings.
	OutputFilterCharsBefore int `json:"output_filter_chars_before,omitempty"`
	OutputFilterCharsAfter  int `json:"output_filter_chars_after,omitempty"`
}

type BrowserClickTool struct{}

type BrowserConsoleEntry struct {
	Level   string
	Message string
	Time    time.Time
}

type BrowserConsoleLogsTool struct{}

type BrowserEvaluateParams struct {
	Expression string `json:"expression"`
}

type BrowserEvaluateTool struct{}

type BrowserFillTool struct{}

type BrowserGetContentParams struct {
	Format   string `json:"format,omitempty"`
	Selector string `json:"selector,omitempty"`
}

type BrowserGetContentTool struct{}

type BrowserInstall = browser.BrowserInstall

type BrowserNavigateParams struct {
	URL     string `json:"url"`
	WaitFor string `json:"wait_for,omitempty"`
	Timeout int    `json:"timeout,omitempty"`
}

type BrowserNavigateTool struct{}

type BrowserNetworkEntry struct {
	RequestID string
	URL       string
	Method    string
	Status    int
	MimeType  string
	Time      time.Time
}

type BrowserNetworkTool struct{}

type BrowserPDFTool struct{}

type BrowserScreenshotParams struct {
	Selector string `json:"selector,omitempty"`
	Quality  int    `json:"quality,omitempty"`
	FullPage bool   `json:"full_page,omitempty"`
}

type BrowserScreenshotTool struct{}

type BrowserScrollTool struct{}

type CacheEntry struct {
	ID         string
	ToolCallID string
	ToolName   string
	Content    string   // Full raw response
	Lines      []string // Pre-split lines for O(1) pagination
	TotalLines int
	TotalBytes int
	CreatedAt  time.Time
	LastUsed   time.Time
}

type CacheEntrySummary struct {
	CacheID    string `json:"cache_id"`
	ToolName   string `json:"tool_name"`
	TotalLines int    `json:"total_lines"`
	TotalBytes int    `json:"total_bytes"`
	AgeSeconds int    `json:"age_seconds"`
}

type CacheReadParams struct {
	CacheID      string `json:"cache_id"`                // Required: ID from truncated response
	Offset       int    `json:"offset"`                  // Line offset (0-based), default 0
	Limit        int    `json:"limit"`                   // Lines to read, default 200
	Pattern      string `json:"pattern"`                 // Optional: search within cached content
	ContextLines int    `json:"context_lines,omitempty"` // Context lines around matches (default 2)
}

type CacheStats struct {
	EntryCount int   `json:"entry_count"`
	TotalBytes int64 `json:"total_bytes"`
	MaxBytes   int64 `json:"max_bytes"`
	Evictions  int   `json:"evictions"`
	// DedupHits counts unchanged-re-read collapses (Phase 2 F-references).
	DedupHits int `json:"dedup_hits"`
	// Bounces counts compressed→full read bounces observed by the Phase 3 tracker.
	Bounces int `json:"bounces"`
	// BounceWastedBytes is the rendered size of compressed reads that later bounced.
	BounceWastedBytes int64 `json:"bounce_wasted_bytes"`
}

type CacheStatsResponse struct {
	Stats   CacheStats          `json:"stats"`
	Entries []CacheEntrySummary `json:"entries"`
}

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

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

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

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

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

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

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

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

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

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

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

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

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

type DesignCanvasParams struct {
	HTML   string `json:"html"`
	Dest   string `json:"dest"`
	Width  int    `json:"width,omitempty"`
	Height int    `json:"height,omitempty"`
	WaitMS int    `json:"wait_ms,omitempty"`
}

type DesignCreateParams struct {
	Title        string            `json:"title"`
	Kind         string            `json:"kind,omitempty"`
	Slug         string            `json:"slug,omitempty"`
	Skill        string            `json:"skill,omitempty"`
	DesignSystem string            `json:"design_system,omitempty"`
	Entry        string            `json:"entry,omitempty"`
	Files        map[string]string `json:"files,omitempty"`
}

type DesignCritiqueParams struct {
	ArtifactID string `json:"artifact_id"`
	Action     string `json:"action,omitempty"`
	Version    int    `json:"version,omitempty"`
	Width      int    `json:"width,omitempty"`
	Height     int    `json:"height,omitempty"`
	// Policy overrides the gate for this pass: none, standard or strict.
	Policy string `json:"policy,omitempty"`
	// Round is the 1-based iteration number; it defaults to the version.
	Round int `json:"round,omitempty"`
	// SkipRender audits without a browser: design-system checks only.
	SkipRender bool `json:"skip_render,omitempty"`
	// Record stores the pass in the artifact's critique history. Default true.
	Record *bool `json:"record,omitempty"`

	// Score, Summary and Issues carry the critic's own judgement.
	Score   float64        `json:"score,omitempty"`
	Summary string         `json:"summary,omitempty"`
	Issues  []design.Issue `json:"issues,omitempty"`
}

type DesignExportParams struct {
	ArtifactID string `json:"artifact_id"`
	Format     string `json:"format,omitempty"`
	Dest       string `json:"dest,omitempty"`
	Slide      int    `json:"slide,omitempty"`
	FullPage   bool   `json:"full_page,omitempty"`
	Landscape  bool   `json:"landscape,omitempty"`
	Width      int    `json:"width,omitempty"`
	Height     int    `json:"height,omitempty"`
}

type DesignInspectParams struct {
	ArtifactID    string   `json:"artifact_id"`
	Version       int      `json:"version,omitempty"`
	NodeID        string   `json:"node_id,omitempty"`
	Selector      string   `json:"selector,omitempty"`
	Text          string   `json:"text,omitempty"`
	Slide         int      `json:"slide,omitempty"`
	Depth         int      `json:"depth,omitempty"`
	Offset        int      `json:"offset,omitempty"`
	Limit         int      `json:"limit,omitempty"`
	IncludeStyles bool     `json:"include_styles,omitempty"`
	StyleProps    []string `json:"style_props,omitempty"`
	MaxTextLen    int      `json:"max_text_len,omitempty"`
}

type DesignPatchParams struct {
	ArtifactID string           `json:"artifact_id"`
	Ops        []design.PatchOp `json:"ops"`
	Summary    string           `json:"summary,omitempty"`
	Commit     bool             `json:"commit,omitempty"`
}

type DesignPresentParams struct {
	ArtifactID string `json:"artifact_id"`
	Slide      int    `json:"slide,omitempty"`
	NodeID     string `json:"node_id,omitempty"`
	Open       bool   `json:"open,omitempty"`
	// View selects the surface: "artifact" (default) is one document, "canvas"
	// is the read-only board holding every artifact of the session.
	View string `json:"view,omitempty"`
}

type DesignRenderParams struct {
	ArtifactID string `json:"artifact_id"`
	Width      int    `json:"width,omitempty"`
	Height     int    `json:"height,omitempty"`
	WaitMS     int    `json:"wait_ms,omitempty"`
	MaxNodes   int    `json:"max_nodes,omitempty"`
	MaxDepth   int    `json:"max_depth,omitempty"`
	PrintMedia bool   `json:"print_media,omitempty"`
}

type DesignScreenshotParams struct {
	ArtifactID string `json:"artifact_id"`
	Selector   string `json:"selector,omitempty"`
	NodeID     string `json:"node_id,omitempty"`
	Slide      int    `json:"slide,omitempty"`
	FullPage   bool   `json:"full_page,omitempty"`
	Width      int    `json:"width,omitempty"`
	Height     int    `json:"height,omitempty"`
	WaitMS     int    `json:"wait_ms,omitempty"`
}

type DesignSkillsParams struct {
	Action string `json:"action,omitempty"`
	// Name is the template ("show", "install").
	Name string `json:"name,omitempty"`
	// Craft names a craft reference to read instead of a template ("show").
	Craft string `json:"craft,omitempty"`
	// Scope is "project" (default) or "global" ("install").
	Scope string `json:"scope,omitempty"`
	// Force replaces an already installed copy ("install").
	Force bool `json:"force,omitempty"`
}

type DesignSystemParams struct {
	Action string                       `json:"action,omitempty"`
	Name   string                       `json:"name,omitempty"`
	Tokens map[string]map[string]string `json:"tokens,omitempty"`
	Fonts  []string                     `json:"fonts,omitempty"`
	// Source and Target drive "extract".
	Source string `json:"source,omitempty"`
	Target string `json:"target,omitempty"`
	// ArtifactID drives "apply".
	ArtifactID string `json:"artifact_id,omitempty"`
}

type DesignVersionsParams struct {
	ArtifactID string `json:"artifact_id,omitempty"`
	Action     string `json:"action,omitempty"`
	Version    int    `json:"version,omitempty"`
	From       int    `json:"from,omitempty"`
	To         int    `json:"to,omitempty"`
	Summary    string `json:"summary,omitempty"`
	Session    bool   `json:"session_only,omitempty"`
}

type DesktopAppsParams struct{}

type DesktopAppsTool struct{}

type DesktopClickAtParams struct {
	X int `json:"x"`
	Y int `json:"y"`
}

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

type DesktopClickParams struct {
	Ref string `json:"ref"`
}

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

type DesktopFindParams struct {
	Selector string `json:"selector"`
	Limit    int    `json:"limit,omitempty"`
	// contains filtered or unexported fields
}

type DesktopFindTool struct{}

type DesktopFocusParams struct {
	Ref string `json:"ref"`
}

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

type DesktopKeyParams struct {
	Ref string `json:"ref,omitempty"`
	Key string `json:"key"`
}

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

type DesktopObserveParams struct {
	Depth int `json:"depth,omitempty"`
	// contains filtered or unexported fields
}

type DesktopObserveTool struct{}

type DesktopReadParams struct {
	Ref string `json:"ref"`
}

type DesktopReadTool struct{}

type DesktopScreenshotParams struct {
	Target string `json:"target,omitempty"`
	Grid   bool   `json:"grid,omitempty"`
}

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

type DesktopScrollParams struct {
	Ref    string `json:"ref"`
	Amount int    `json:"amount"`
}

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

type DesktopTypeParams struct {
	Ref  string `json:"ref"`
	Text string `json:"text"`
}

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

type DesktopWaitParams struct {
	Selector  string `json:"selector"`
	Condition string `json:"condition"`
	Timeout   int    `json:"timeout,omitempty"`
	// contains filtered or unexported fields
}

type DesktopWaitTool struct{}

type DiagnosticsParams struct {
	FilePath string `json:"file_path"`
}

type EditParams struct {
	FilePath  string `json:"file_path"`
	OldString string `json:"old_string"`
	NewString string `json:"new_string"`
}

type EditPermissionsParams struct {
	FilePath string `json:"file_path"`
	Diff     string `json:"diff"`
}

type EditResponseMetadata struct {
	Diff      string `json:"diff"`
	Additions int    `json:"additions"`
	Removals  int    `json:"removals"`
}

type EditStrategy interface {
	Apply(content, oldStr, newStr string) (result string, matched bool)
	Name() string
}

type FetchParams struct {
	URL       string `json:"url"`
	Format    string `json:"format"`
	Timeout   int    `json:"timeout,omitempty"`
	Browser   string `json:"browser,omitempty"`
	MaxLength int    `json:"max_length,omitempty"` // Max chars to return (0 = no limit beyond defaults)
}

type FetchPermissionsParams struct {
	URL     string `json:"url"`
	Format  string `json:"format"`
	Timeout int    `json:"timeout,omitempty"`
	Browser string `json:"browser,omitempty"`
}

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

type GlobParams struct {
	Pattern   string `json:"pattern"`
	Path      string `json:"path"`
	HeadLimit int    `json:"head_limit"` // Max files to return (default 100)
	Offset    int    `json:"offset"`     // Skip first N files for pagination
}

type GlobResponseMetadata struct {
	NumberOfFiles int  `json:"number_of_files"`
	Truncated     bool `json:"truncated"`
	TotalFound    int  `json:"total_found"` // Total before offset/limit
	Offset        int  `json:"offset"`
	HasMore       bool `json:"has_more"`
}

type GrepParams struct {
	Pattern     string `json:"pattern"`
	Path        string `json:"path"`
	Include     string `json:"include"`
	LiteralText bool   `json:"literal_text"`
	// Extended parameters
	OutputMode string `json:"output_mode"` // "content" | "files_with_matches" | "count" (default: "files_with_matches")
	Context    int    `json:"context"`     // lines of context before AND after (-C)
	Before     int    `json:"before"`      // lines before match (-B), overrides Context
	After      int    `json:"after"`       // lines after match (-A), overrides Context
	Type       string `json:"type"`        // file type filter: "go", "js", "py", "ts", "rust", etc.
	Multiline  bool   `json:"multiline"`   // enable multiline matching
	HeadLimit  int    `json:"head_limit"`  // cap total results (0 = use default 100)
	Offset     int    `json:"offset"`      // skip first N results for pagination
}

type GrepResponseMetadata struct {
	NumberOfMatches int  `json:"number_of_matches"`
	Truncated       bool `json:"truncated"`
}

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

type ImageCropParams struct {
	Path   string `json:"path"`
	X      int    `json:"x"`
	Y      int    `json:"y"`
	Width  int    `json:"width,omitempty"`
	Height int    `json:"height,omitempty"`
}

type ImageCropTool struct{}

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

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

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

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

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

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

type LSPCatalogEntry struct {
	Name        string
	Description string
	Command     string
	Languages   []string
	Filenames   []string
	// Configured reports an explicit [LSP.<name>] entry; OptIn a preset that
	// stays inactive until the user declares it.
	Configured bool
	OptIn      bool
	Disabled   bool
	Installing bool
	// Availability is "installed", "installable" or "manual", with
	// AvailabilityLabel its short human-readable form.
	Availability      string
	AvailabilityLabel string
	Reason            string
	Hint              string
	// RunState is "stopped", "starting", "ready" or "error".
	RunState string
}

type LSPProvider interface {
	// EnsureForFile lazily starts the language server(s) that handle the file's
	// type, if not already running and the binary is installed. It is a no-op
	// when on-demand activation is disabled. Equivalent to EnsureForFileTrigger
	// with config.LSPTriggerEdit.
	EnsureForFile(ctx context.Context, path string)
	// EnsureForFileTrigger is EnsureForFile with the reason for the activation.
	// The configuration decides which triggers may start a server, so a tool
	// that only reads a file must not claim it edited one.
	EnsureForFileTrigger(ctx context.Context, path string, trigger config.LSPTrigger)
	// WaitForFile blocks briefly while lazy startup settles so callers can use a
	// freshly spawned LSP client within the same request.
	WaitForFile(ctx context.Context, path string) map[string]*lsp.Client
	// ClientsForFile returns a snapshot of running clients that handle the file.
	ClientsForFile(path string) map[string]*lsp.Client
	// Clients returns a snapshot of all running clients.
	Clients() map[string]*lsp.Client
	// UnavailableReason explains, in terms a user can act on, why no ready
	// language server could be obtained for the file: a missing binary and its
	// install command, an install still in flight, or activation being off. It
	// returns an empty string when a server is available.
	UnavailableReason(path string) string
}

type LSParams struct {
	Path   string   `json:"path"`
	Ignore []string `json:"ignore"`
}

type LSResponseMetadata struct {
	NumberOfFiles int  `json:"number_of_files"`
	Truncated     bool `json:"truncated"`
}

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

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

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

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

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

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

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

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

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

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

type PaginationInfo struct {
	TotalItems    int    `json:"total_items,omitempty"`
	ReturnedItems int    `json:"returned_items,omitempty"`
	Offset        int    `json:"offset,omitempty"`
	Limit         int    `json:"limit,omitempty"`
	HasMore       bool   `json:"has_more,omitempty"`
	CacheID       string `json:"cache_id,omitempty"` // Set if response was auto-cached
}

type PaginationMetadata struct {
	CacheID       string `json:"cache_id"`
	TotalLines    int    `json:"total_lines"`
	TotalBytes    int    `json:"total_bytes"`
	Offset        int    `json:"offset"`
	Limit         int    `json:"limit"`
	HasMore       bool   `json:"has_more"`
	ReturnedLines int    `json:"returned_lines"`
	ToolName      string `json:"tool_name"`
}

type PatchParams struct {
	PatchText string `json:"patch_text"`
}

type PatchResponseMetadata struct {
	FilesChanged []string `json:"files_changed"`
	Additions    int      `json:"additions"`
	Removals     int      `json:"removals"`
}

type ReadDedupResult struct {
	// Status is new / unchanged / changed.
	Status ReadDedupStatus
	// Label is the stable F-reference label for this window (e.g. "F1").
	Label string
	// PrevContent holds the previously-delivered window content; populated only
	// when Status is ReadDedupChanged so the caller can render a diff.
	PrevContent string
}

type ReadDedupStatus string

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

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

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

type SavingsStatsResponse struct {
	Report savings.Report `json:"report"`
}

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

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

type SetupBridge interface {
	// SessionInfo returns the usage snapshot for a session.
	SessionInfo(ctx context.Context, sessionID string) (SetupSessionInfo, error)
	// SessionModes lists the session modes and their current state.
	SessionModes(sessionID string) []SetupMode
	// Commands lists the slash commands, runnable or not.
	Commands() []SetupRunnableCommand
	// RunCommand activates a slash command for the session and returns the text
	// the agent should read (a confirmation, or the command's own instructions).
	RunCommand(ctx context.Context, sessionID, name, args string) (string, error)
	// CurrentModel reports the model the session runs on.
	CurrentModel(sessionID string) (SetupModelState, error)
	// SetSessionModel switches the model for this session only. An empty modelID
	// clears the override. When the target costs more than the current model — or
	// either price is unknown — the switch is only applied if confirmed is true;
	// otherwise it returns a quote with Applied false and changes nothing.
	SetSessionModel(sessionID, modelID string, confirmed bool) (SetupModelSwitch, error)
	// Projects lists the projects registered in this Pando instance's project
	// registry — the ids/paths/names mesnada_spawn_agent's "project" argument
	// accepts to delegate work into another project. Returns an error when the
	// project registry is unavailable in this runtime.
	Projects(ctx context.Context) ([]SetupProjectRef, error)
}

type SetupLSPCatalog interface {
	LSPCatalog() []LSPCatalogEntry
}

type SetupMode struct {
	Name  string `json:"name"`
	State string `json:"state"`
}

type SetupModelState struct {
	ID            string  `json:"id"`
	Name          string  `json:"name,omitempty"`
	Provider      string  `json:"provider,omitempty"`
	Account       string  `json:"account,omitempty"`
	ContextWindow int64   `json:"contextWindow,omitempty"`
	CostIn        float64 `json:"costIn"`
	CostOut       float64 `json:"costOut"`
	// CostKnown is false when the catalogue has no price for the model (local
	// models, mock providers, entries models.dev could not enrich). It is not the
	// same as a price of zero and must not be reported as "free".
	CostKnown bool `json:"costKnown"`
	// Overridden reports that the model comes from a session-scoped override
	// rather than from the agent's configured default.
	Overridden bool `json:"overridden"`
}

type SetupModelSwitch struct {
	// Applied is false when the switch was only quoted and still needs the user's
	// confirmation; in that case nothing changed.
	Applied  bool            `json:"applied"`
	Previous SetupModelState `json:"previous"`
	Target   SetupModelState `json:"target"`
	// ConfirmationReason is set only when Applied is false: why the user has to
	// approve (the target costs more, or a price is missing on either side).
	ConfirmationReason string `json:"confirmationReason,omitempty"`
	// Cleared reports that the session override was removed and the agent's
	// configured default is back in use.
	Cleared bool `json:"cleared,omitempty"`
}

type SetupProjectRef struct {
	ID     string `json:"id"`
	Name   string `json:"name"`
	Path   string `json:"path"`
	Status string `json:"status"`
}

type SetupRunnableCommand struct {
	Name    string `json:"name"`
	Summary string `json:"summary"`
	Args    string `json:"args,omitempty"`
	// Reason is set only when the command is listed but not runnable by the
	// agent; it explains why the user has to trigger it.
	Reason string `json:"reason,omitempty"`
}

type SetupSessionInfo struct {
	ID                  string  `json:"id"`
	Title               string  `json:"title,omitempty"`
	Model               string  `json:"model,omitempty"`
	MessageCount        int64   `json:"messageCount"`
	PromptTokens        int64   `json:"promptTokens"`
	CompletionTokens    int64   `json:"completionTokens"`
	CacheReadTokens     int64   `json:"cacheReadTokens"`
	CacheCreationTokens int64   `json:"cacheCreationTokens"`
	ReasoningTokens     int64   `json:"reasoningTokens"`
	ContextWindow       int64   `json:"contextWindow,omitempty"`
	Cost                float64 `json:"cost"`
}

type SourcegraphParams struct {
	Query         string `json:"query"`
	Count         int    `json:"count,omitempty"`
	ContextWindow int    `json:"context_window,omitempty"`
	Timeout       int    `json:"timeout,omitempty"`
}

type SourcegraphResponseMetadata struct {
	NumberOfMatches int  `json:"number_of_matches"`
	Truncated       bool `json:"truncated"`
}

type TodoItem struct {
	Content  string `json:"content"`
	Status   string `json:"status"`   // pending | in_progress | completed
	Priority string `json:"priority"` // high | medium | low
}

type TodoWriteParams struct {
	Todos []TodoItem `json:"todos"`
}

type ToolCall struct {
	ID    string `json:"id"`
	Name  string `json:"name"`
	Input string `json:"input"`
}

type ToolExecutor interface {
	ExecuteTool(ctx context.Context, name string, params map[string]interface{}) (ToolResponse, error)
}

type ToolInfo struct {
	Name        string
	Description string
	Parameters  map[string]any
	Required    []string
}

type ToolResponse struct {
	Type     toolResponseType `json:"type"`
	Content  string           `json:"content"`
	Metadata string           `json:"metadata,omitempty"`
	IsError  bool             `json:"is_error"`
}

type ToolSearchEntry struct {
	CanonicalName string   `json:"name"`
	Aliases       []string `json:"aliases,omitempty"`
	ServerName    string   `json:"server,omitempty"`
	Source        string   `json:"source,omitempty"`
	Description   string   `json:"description"`
}

type ToolSearchProvider interface {
	// Search returns up to limit results ranked by relevance to query.
	// Each result must be JSON-marshallable.
	SearchTools(query string, limit int) []ToolSearchEntry
	// MarkDiscovered marks a canonical tool name as visible for this session.
	MarkDiscovered(name string)
}

type TreeNode struct {
	Name     string      `json:"name"`
	Path     string      `json:"path"`
	Type     string      `json:"type"` // "file" or "directory"
	Children []*TreeNode `json:"children,omitempty"`
}

type ViewParams struct {
	FilePath string `json:"file_path"`
	Offset   int    `json:"offset"`
	Limit    int    `json:"limit"`
	EndLine  int    `json:"end_line"`
	// Mode selects the read fidelity (lean-ctx Phase 1). One of "full" (default —
	// raw line-numbered window), "signatures" (every symbol's signature),
	// "map" (imports + top-level signatures) or "auto" (picked by file size/type).
	// Absent or "full" reproduces the legacy output exactly. Compressed modes
	// preserve line numbers so you can follow up with offset/limit to read bodies.
	Mode string `json:"mode,omitempty"`
}

type ViewResponseMetadata struct {
	FilePath string `json:"file_path"`
	Content  string `json:"content"`
}

type WriteParams struct {
	FilePath string `json:"file_path"`
	Content  string `json:"content"`
}

type WritePermissionsParams struct {
	FilePath string `json:"file_path"`
	Diff     string `json:"diff"`
}

type WriteResponseMetadata struct {
	Diff      string `json:"diff"`
	Additions int    `json:"additions"`
	Removals  int    `json:"removals"`
}