file

type Config struct {
	// AllowedPaths is a list of paths that file operations are allowed in.
	// If empty, only the working directory and its subdirectories are allowed.
	AllowedPaths []string

	// WorkingDir is the current working directory.
	WorkingDir string

	// ReadTracking tracks which files have been read (for Edit validation).
	// Maps file path to read time (Unix milliseconds UTC).
	ReadTracking map[string]int64

	// ContentHashes stores content hashes for optimistic locking.
	// When a file is read, its hash is stored. During edit, we verify
	// the hash matches to detect external modifications.
	ContentHashes map[string]string

	// LSPReleaser coordinates file access with LSP servers.
	// Optional. If nil, no LSP coordination is performed.
	// Required for Windows to avoid "Access is denied" errors during atomic writes.
	LSPReleaser LSPReleaser

	// GraphRefresher provides synchronous graph updates after file writes.
	// Optional. If nil, no synchronous refresh is performed.
	// Recommended to prevent event storms and stale graph queries.
	GraphRefresher GraphRefresher
}

type DiffParams struct {
	// FileA is the first file to compare.
	FileA string `json:"file_a"`

	// FileB is the second file to compare.
	FileB string `json:"file_b"`

	// ContextLines is the number of context lines around changes.
	ContextLines int `json:"context_lines,omitempty"`
}

type DiffResult struct {
	// Diff is the unified diff output.
	Diff string `json:"diff"`

	// LinesAdded is the number of lines added.
	LinesAdded int `json:"lines_added"`

	// LinesRemoved is the number of lines removed.
	LinesRemoved int `json:"lines_removed"`

	// FilesIdentical indicates if the files are the same.
	FilesIdentical bool `json:"files_identical"`
}

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

type EditError struct {
	// Err is the underlying error.
	Err error

	// MatchCount is the number of matches found.
	MatchCount int

	// Suggestion provides guidance for fixing the error.
	Suggestion string
}

type EditParams struct {
	// FilePath is the absolute path to the file to edit.
	FilePath string `json:"file_path"`

	// OldString is the exact text to replace.
	OldString string `json:"old_string"`

	// NewString is the replacement text.
	NewString string `json:"new_string"`

	// ReplaceAll replaces all occurrences if true.
	ReplaceAll bool `json:"replace_all,omitempty"`
}

type EditResult struct {
	// Success indicates if the edit succeeded.
	Success bool `json:"success"`

	// Replacements is the number of replacements made.
	Replacements int `json:"replacements"`

	// Diff is the unified diff of the changes.
	Diff string `json:"diff"`

	// Path is the absolute path of the edited file.
	Path string `json:"path"`
}

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

type FileInfo struct {
	// Path is the absolute path to the file.
	Path string `json:"path"`

	// RelPath is the path relative to the search root.
	RelPath string `json:"rel_path,omitempty"`

	// Size is the file size in bytes.
	Size int64 `json:"size"`

	// ModTime is the last modification time (Unix milliseconds UTC).
	ModTime int64 `json:"mod_time"`

	// IsDir indicates if this is a directory.
	IsDir bool `json:"is_dir,omitempty"`
}

type GlobParams struct {
	// Pattern is the glob pattern to match (e.g., "**/*.go").
	Pattern string `json:"pattern"`

	// Path is the directory to search in. Defaults to current working directory.
	Path string `json:"path,omitempty"`

	// Limit is the maximum number of results. Defaults to DefaultGlobLimit.
	Limit int `json:"limit,omitempty"`
}

type GlobResult struct {
	// Files is the list of matching files.
	Files []FileInfo `json:"files"`

	// Count is the total number of matches found.
	Count int `json:"count"`

	// Truncated indicates if results were truncated due to limit.
	Truncated bool `json:"truncated"`

	// SearchPath is the directory that was searched.
	SearchPath string `json:"search_path"`
}

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

type GraphRefresher interface {
	// RefreshFiles synchronously refreshes the graph for the given file paths.
	// Returns after the graph is updated. If an error occurs, the graph may
	// be partially updated but should not corrupt existing data.
	RefreshFiles(ctx context.Context, paths []string) error
}

type GrepMatch struct {
	// File is the absolute path to the file containing the match.
	File string `json:"file"`

	// Line is the 1-indexed line number of the match.
	Line int `json:"line"`

	// Content is the matching line content.
	Content string `json:"content"`

	// ContextBefore contains lines before the match.
	ContextBefore []string `json:"context_before,omitempty"`

	// ContextAfter contains lines after the match.
	ContextAfter []string `json:"context_after,omitempty"`
}

type GrepParams struct {
	// Pattern is the regex pattern to search for.
	Pattern string `json:"pattern"`

	// Path is the file or directory to search in.
	Path string `json:"path,omitempty"`

	// Glob is an optional file pattern filter (e.g., "*.go").
	Glob string `json:"glob,omitempty"`

	// ContextLines is the number of lines to show before and after each match.
	ContextLines int `json:"context_lines,omitempty"`

	// CaseInsensitive enables case-insensitive matching.
	CaseInsensitive bool `json:"case_insensitive,omitempty"`

	// Limit is the maximum number of matches. Defaults to DefaultGrepLimit.
	Limit int `json:"limit,omitempty"`

	// Fuzzy enables fzf-style fuzzy matching where characters must appear
	// in order but not necessarily adjacent. Example: "prsfil" matches "parseFile".
	Fuzzy bool `json:"fuzzy,omitempty"`

	// Approximate enables agrep-style approximate matching using Levenshtein
	// distance. Example: "functon" matches "function" with MaxErrors=1.
	Approximate bool `json:"approximate,omitempty"`

	// MaxErrors is the maximum edit distance for approximate matching.
	// Only used when Approximate=true. Default: 2, Max: 5.
	MaxErrors int `json:"max_errors,omitempty"`
}

type GrepResult struct {
	// Matches is the list of matching lines.
	Matches []GrepMatch `json:"matches"`

	// Count is the total number of matches found.
	Count int `json:"count"`

	// Truncated indicates if results were truncated due to limit.
	Truncated bool `json:"truncated"`

	// FilesSearched is the number of files searched.
	FilesSearched int `json:"files_searched"`

	// SearchPath is the directory or file that was searched.
	SearchPath string `json:"search_path"`
}

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

type JSONParams struct {
	// FilePath is the JSON file to query/validate.
	FilePath string `json:"file_path"`

	// Query is a jq-style path (e.g., ".users[0].name").
	Query string `json:"query,omitempty"`

	// Validate only validates JSON, doesn't query.
	Validate bool `json:"validate,omitempty"`
}

type JSONResult struct {
	// Value is the query result.
	Value any `json:"value,omitempty"`

	// Valid indicates if the JSON is valid.
	Valid bool `json:"valid"`

	// Error contains the parse error if invalid.
	Error string `json:"error,omitempty"`

	// Path is the file path.
	Path string `json:"path"`
}

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

type LSPReleaser interface {
	// ReleaseFile tells LSP servers to close the file.
	// Called before atomic writes on Windows.
	ReleaseFile(ctx context.Context, filePath string) error

	// ReopenFile tells LSP servers to reopen the file with new content.
	// Called after atomic writes on Windows.
	ReopenFile(ctx context.Context, filePath string, content string, languageID string) error
}

type ReadParams struct {
	// FilePath is the absolute path to the file to read.
	FilePath string `json:"file_path"`

	// Offset is the line number to start reading from (1-indexed).
	// If 0 or not provided, reads from the beginning.
	Offset int `json:"offset,omitempty"`

	// Limit is the maximum number of lines to read.
	// Defaults to DefaultReadLimit if not provided.
	Limit int `json:"limit,omitempty"`
}

type ReadResult struct {
	// Content is the file content with line numbers.
	Content string `json:"content"`

	// TotalLines is the total number of lines in the file.
	TotalLines int `json:"total_lines"`

	// LinesRead is the number of lines actually read.
	LinesRead int `json:"lines_read"`

	// Truncated indicates if output was truncated due to limits.
	Truncated bool `json:"truncated"`

	// TruncatedAt is the line number where truncation occurred.
	TruncatedAt int `json:"truncated_at,omitempty"`

	// BytesRead is the number of bytes read from the file.
	BytesRead int64 `json:"bytes_read"`

	// FileType indicates the detected file type.
	FileType string `json:"file_type,omitempty"`
}

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

type TreeParams struct {
	// Path is the directory to visualize.
	Path string `json:"path,omitempty"`

	// Depth is the maximum depth to traverse (default: 3, max: 10).
	Depth int `json:"depth,omitempty"`

	// ShowHidden includes dotfiles/dotdirs.
	ShowHidden bool `json:"show_hidden,omitempty"`

	// DirsOnly shows only directories, not files.
	DirsOnly bool `json:"dirs_only,omitempty"`
}

type TreeResult struct {
	// Tree is the ASCII tree output.
	Tree string `json:"tree"`

	// TotalDirs is the number of directories found.
	TotalDirs int `json:"total_dirs"`

	// TotalFiles is the number of files found.
	TotalFiles int `json:"total_files"`

	// Truncated indicates if depth limit was hit.
	Truncated bool `json:"truncated"`
}

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

type WriteParams struct {
	// FilePath is the absolute path for the new file.
	FilePath string `json:"file_path"`

	// Content is the file content to write.
	Content string `json:"content"`
}

type WriteResult struct {
	// Success indicates if the write succeeded.
	Success bool `json:"success"`

	// BytesWritten is the number of bytes written.
	BytesWritten int64 `json:"bytes_written"`

	// Path is the absolute path of the written file.
	Path string `json:"path"`

	// Created indicates if a new file was created (vs overwritten).
	Created bool `json:"created"`
}

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