tools

type BackgroundBashMetadata struct {
	Command   string    `json:"command"`
	PID       int       `json:"pid"`
	LogPath   string    `json:"logPath"`
	StartTime time.Time `json:"startTime"`
}

type BackgroundProcess struct {
	PID       int         `json:"pid"`
	Command   string      `json:"command"`
	LogPath   string      `json:"log_path"`
	StartTime time.Time   `json:"start_time"`
	Process   *os.Process `json:"-"` // Not serialized
}

type BackgroundProcessInfo struct {
	PID       int       `json:"pid"`
	Command   string    `json:"command"`
	LogPath   string    `json:"logPath"`
	StartTime time.Time `json:"startTime"`
	Status    string    `json:"status"` // "running", "stopped"
}

type BaseToolResult struct {
	Result string `json:"result"`
	Error  string `json:"error"`
}

type BashMetadata struct {
	Command       string        `json:"command"`
	ExitCode      int           `json:"exitCode"`
	Output        string        `json:"output"`
	ExecutionTime time.Duration `json:"executionTime"`
	WorkingDir    string        `json:"workingDir,omitempty"`
}

type BlockedMetadata struct {
	ToolName string `json:"tool_name"`
	Reason   string `json:"reason"`
}

type BlockedToolResult struct {
	ToolName string `json:"tool_name"`
	Reason   string `json:"reason"`
}

type CodeExecutionMetadata struct {
	Code    string `json:"code"`
	Output  string `json:"output"`
	Runtime string `json:"runtime"`
}

type CustomToolMetadata struct {
	ExecutionTime time.Duration `json:"executionTime"`
	Output        string        `json:"output"`
}

type Edit struct {
	StartLine  int    `json:"startLine"`
	EndLine    int    `json:"endLine"`
	OldContent string `json:"oldContent"`
	NewContent string `json:"newContent"`
}

type FileEditMetadata struct {
	FilePath      string `json:"filePath"`
	Edits         []Edit `json:"edits"`
	Language      string `json:"language,omitempty"`
	ReplaceAll    bool   `json:"replaceAll,omitempty"`
	ReplacedCount int    `json:"replacedCount,omitempty"`
}

type FileInfo struct {
	Path     string    `json:"path"`
	Size     int64     `json:"size"`
	ModTime  time.Time `json:"modTime"`
	Type     string    `json:"type"` // "file" or "directory"
	Language string    `json:"language,omitempty"`
}

type FileReadMetadata struct {
	FilePath       string   `json:"filePath"`
	Offset         int      `json:"offset"`
	LineLimit      int      `json:"lineLimit"`
	Lines          []string `json:"lines"`
	Language       string   `json:"language,omitempty"`
	Truncated      bool     `json:"truncated"`
	RemainingLines int      `json:"remainingLines,omitempty"`
}

type FileWriteMetadata struct {
	FilePath string `json:"filePath"`
	Content  string `json:"content"`
	Size     int64  `json:"size"`
	Language string `json:"language,omitempty"`
}

type GlobMetadata struct {
	Pattern   string     `json:"pattern"`
	Path      string     `json:"path,omitempty"`
	Files     []FileInfo `json:"files"`
	Truncated bool       `json:"truncated"`
}

type GrepMetadata struct {
	Pattern          string         `json:"pattern"`
	Path             string         `json:"path,omitempty"`
	Include          string         `json:"include,omitempty"`
	Results          []SearchResult `json:"results"`
	Truncated        bool           `json:"truncated"`
	TruncationReason string         `json:"truncationReason,omitempty"`
	MaxResults       int            `json:"maxResults,omitempty"`
}

type ImageDimensions struct {
	Width  int `json:"width"`
	Height int `json:"height"`
}

type ImageRecognitionMetadata struct {
	ImagePath string          `json:"imagePath"`
	ImageType string          `json:"imageType"` // "local" or "remote"
	Prompt    string          `json:"prompt"`
	Analysis  string          `json:"analysis"`
	ImageSize ImageDimensions `json:"imageSize,omitempty"`
}

type MCPContent struct {
	Type     string         `json:"type"`
	Text     string         `json:"text,omitempty"`
	Data     string         `json:"data,omitempty"`
	MimeType string         `json:"mimeType,omitempty"`
	URI      string         `json:"uri,omitempty"`
	Metadata map[string]any `json:"metadata,omitempty"`
}

type MCPToolMetadata struct {
	MCPToolName   string         `json:"mcpToolName"`
	ServerName    string         `json:"serverName,omitempty"`
	Parameters    map[string]any `json:"parameters,omitempty"`
	Content       []MCPContent   `json:"content"`
	ContentText   string         `json:"contentText"`
	ExecutionTime time.Duration  `json:"executionTime"`
}

type SearchMatch struct {
	LineNumber int    `json:"lineNumber"`
	Content    string `json:"content"`
	MatchStart int    `json:"matchStart"`
	MatchEnd   int    `json:"matchEnd"`
	IsContext  bool   `json:"isContext,omitempty"`
}

type SearchResult struct {
	FilePath string        `json:"filePath"`
	Language string        `json:"language,omitempty"`
	Matches  []SearchMatch `json:"matches"`
}

type SkillMetadata struct {
	SkillName string `json:"skillName"`
	Directory string `json:"directory"`
}

type State interface {
	SetFileLastAccessed(path string, lastAccessed time.Time) error
	GetFileLastAccessed(path string) (time.Time, error)
	ClearFileLastAccessed(path string) error
	TodoFilePath() (string, error)
	SetTodoFilePath(path string)
	SetFileLastAccess(fileLastAccess map[string]time.Time)
	FileLastAccess() map[string]time.Time
	BasicTools() []Tool
	MCPTools() []Tool
	Tools() []Tool
	// Background process management
	AddBackgroundProcess(process BackgroundProcess) error
	GetBackgroundProcesses() []BackgroundProcess
	RemoveBackgroundProcess(pid int) error

	// Context discovery
	DiscoverContexts() map[string]string

	// LLM configuration access
	GetLLMConfig() any // Returns llmtypes.Config but using any to avoid circular import

	// File locking for atomic operations
	// LockFile acquires an exclusive lock for the given file path to prevent race conditions
	// during read-modify-write operations. Must be paired with UnlockFile.
	LockFile(path string)
	// UnlockFile releases the lock for the given file path
	UnlockFile(path string)
}

type StructuredToolResult struct {
	ToolName  string       `json:"toolName"`
	Success   bool         `json:"success"`
	Error     string       `json:"error,omitempty"`
	Metadata  ToolMetadata `json:"metadata,omitempty"`
	Timestamp time.Time    `json:"timestamp"`
}

type SubAgentMetadata struct {
	Question string `json:"question"`
	Response string `json:"response"`
	Workflow string `json:"workflow,omitempty"`
	Cwd      string `json:"cwd,omitempty"`
}

type TodoItem struct {
	ID        string    `json:"id"`
	Content   string    `json:"content"`
	Status    string    `json:"status"`
	Priority  string    `json:"priority"`
	CreatedAt time.Time `json:"createdAt,omitempty"`
	UpdatedAt time.Time `json:"updatedAt,omitempty"`
}

type TodoMetadata struct {
	Action     string     `json:"action"` // "read" or "write"
	TodoList   []TodoItem `json:"todoList"`
	Statistics TodoStats  `json:"statistics,omitempty"`
}

type TodoStats struct {
	Total      int `json:"total"`
	Completed  int `json:"completed"`
	InProgress int `json:"inProgress"`
	Pending    int `json:"pending"`
}

type Tool interface {
	GenerateSchema() *jsonschema.Schema
	Name() string
	Description() string
	ValidateInput(state State, parameters string) error
	Execute(ctx context.Context, state State, parameters string) ToolResult
	TracingKVs(parameters string) ([]attribute.KeyValue, error)
}

type ToolMetadata interface {
	ToolType() string
}

type ToolResult interface {
	AssistantFacing() string
	IsError() bool
	GetError() string  // xxx: to be removed
	GetResult() string // xxx: to be removed
	StructuredData() StructuredToolResult
}

type ViewBackgroundProcessesMetadata struct {
	Processes []BackgroundProcessInfo `json:"processes"`
	Count     int                     `json:"count"`
}

type WebFetchMetadata struct {
	URL           string `json:"url"`
	ContentType   string `json:"contentType"`
	Size          int64  `json:"size"`
	SavedPath     string `json:"savedPath,omitempty"`
	Prompt        string `json:"prompt,omitempty"`
	ProcessedType string `json:"processedType"` // "saved", "markdown", "ai_extracted"
	Content       string `json:"content"`       // The actual fetched content
}