server

type APIMessage struct {
	MessageID      string    `json:"message_id"`
	ConversationID string    `json:"conversation_id"`
	SequenceID     int64     `json:"sequence_id"`
	Type           string    `json:"type"`
	LlmData        *string   `json:"llm_data,omitempty"`
	UserData       *string   `json:"user_data,omitempty"`
	UsageData      *string   `json:"usage_data,omitempty"`
	CreatedAt      time.Time `json:"created_at"`
	DisplayData    *string   `json:"display_data,omitempty"`
	EndOfTurn      *bool     `json:"end_of_turn,omitempty"`
}

type ChannelTypeInfo struct {
	Type         string        `json:"type"`
	Label        string        `json:"label"`
	ConfigFields []ConfigField `json:"config_fields"`
}

type ChatRequest struct {
	Message string `json:"message"`
	Model   string `json:"model,omitempty"`
	Cwd     string `json:"cwd,omitempty"`
}

type CodebaseInfo struct {
	InjectFiles        []string
	InjectFileContents map[string]string
	GuidanceFiles      []string
}

type CommitInfo struct {
	SHA     string    `json:"sha"`
	Message string    `json:"message"`
	Author  string    `json:"author"`
	Date    time.Time `json:"date"`
}

type ConfigField struct {
	Name        string `json:"name"`
	Label       string `json:"label"`
	Type        string `json:"type"`
	Required    bool   `json:"required"`
	Placeholder string `json:"placeholder,omitempty"`
}

type ContinueConversationRequest struct {
	SourceConversationID string `json:"source_conversation_id"`
	Model                string `json:"model,omitempty"`
	Cwd                  string `json:"cwd,omitempty"`
}

type ConversationListUpdate struct {
	Type           string                  `json:"type"` // "update", "delete"
	Conversation   *generated.Conversation `json:"conversation,omitempty"`
	ConversationID string                  `json:"conversation_id,omitempty"` // For deletes
}

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

type ConversationState struct {
	ConversationID string `json:"conversation_id"`
	Working        bool   `json:"working"`
	Model          string `json:"model,omitempty"`
}

type ConversationWithState struct {
	generated.Conversation
	Working bool `json:"working"`
}

type CreateModelRequest struct {
	DisplayName  string `json:"display_name"`
	ProviderType string `json:"provider_type"`
	Endpoint     string `json:"endpoint"`
	APIKey       string `json:"api_key"`
	ModelName    string `json:"model_name"`
	MaxTokens    int64  `json:"max_tokens"`
	Tags         string `json:"tags"` // Comma-separated tags
}

type CreateNotificationChannelRequest struct {
	ChannelType string `json:"channel_type"`
	DisplayName string `json:"display_name"`
	Enabled     bool   `json:"enabled"`
	Config      any    `json:"config"`
}

type DirectoryEntry struct {
	Name           string `json:"name"`
	IsDir          bool   `json:"is_dir"`
	GitHeadSubject string `json:"git_head_subject,omitempty"`
}

type DuplicateModelRequest struct {
	DisplayName string `json:"display_name,omitempty"`
}

type EditMessageRequest struct {
	SequenceID int64  `json:"sequence_id"`
	Message    string `json:"message"`
}

type ExecMessage struct {
	Type string `json:"type"`
	Data string `json:"data,omitempty"`
	Cols uint16 `json:"cols,omitempty"`
	Rows uint16 `json:"rows,omitempty"`
}

type ForkConversationRequest struct {
	SourceConversationID string `json:"source_conversation_id"`
	AtSequenceID         int64  `json:"at_sequence_id"`
	Model                string `json:"model,omitempty"`
}

type GitDiffInfo struct {
	ID         string    `json:"id"`
	Message    string    `json:"message"`
	Author     string    `json:"author"`
	Timestamp  time.Time `json:"timestamp"`
	FilesCount int       `json:"filesCount"`
	Additions  int       `json:"additions"`
	Deletions  int       `json:"deletions"`
}

type GitFileDiff struct {
	Path       string `json:"path"`
	OldContent string `json:"oldContent"`
	NewContent string `json:"newContent"`
}

type GitFileInfo struct {
	Path        string `json:"path"`
	Status      string `json:"status"` // added, modified, deleted
	Additions   int    `json:"additions"`
	Deletions   int    `json:"deletions"`
	IsGenerated bool   `json:"isGenerated"`
}

type GitInfo struct {
	Root string
}

type GitInfoUserData struct {
	Worktree string `json:"worktree"`
	Branch   string `json:"branch"`
	Commit   string `json:"commit"`
	Subject  string `json:"subject"`
	Text     string `json:"text"` // Human-readable description
}

type LLMConfig struct {
	// API keys for each provider
	AnthropicAPIKey string
	OpenAIAPIKey    string
	GeminiAPIKey    string
	FireworksAPIKey string

	// Gateway is the base URL of the LLM gateway (optional)
	Gateway string

	// TerminalURL is the URL to the terminal interface (optional)
	TerminalURL string

	// DefaultModel is the default model to use (optional, defaults to models.Default())
	DefaultModel string

	// Links are custom links to be displayed in the UI (optional)
	Links []Link

	// NotificationChannels is a list of notification channel configs from percy.json.
	// Each entry is a map with at least a "type" key, plus channel-specific fields.
	NotificationChannels []map[string]any

	// OllamaURL is the base URL of a local Ollama instance for auto-discovery.
	// Default: "http://localhost:11434". Set to "" to disable.
	OllamaURL string

	// DB is the database for recording LLM requests (optional)
	DB *db.DB

	Logger *slog.Logger
}

type LLMProvider interface {
	GetService(modelID string) (llm.Service, error)
	GetAvailableModels() []string
	HasModel(modelID string) bool
	GetModelInfo(modelID string) *models.ModelInfo
	RefreshCustomModels() error
}

type Link struct {
	Title   string `json:"title"`
	IconSVG string `json:"icon_svg,omitempty"` // SVG path data for the icon
	URL     string `json:"url"`
}

type ListDirectoryResponse struct {
	Path            string           `json:"path"`
	Parent          string           `json:"parent"`
	Entries         []DirectoryEntry `json:"entries"`
	GitHeadSubject  string           `json:"git_head_subject,omitempty"`
	GitWorktreeRoot string           `json:"git_worktree_root,omitempty"`
}

type ModelAPI struct {
	ModelID      string `json:"model_id"`
	DisplayName  string `json:"display_name"`
	ProviderType string `json:"provider_type"`
	Endpoint     string `json:"endpoint"`
	APIKey       string `json:"api_key"`
	ModelName    string `json:"model_name"`
	MaxTokens    int64  `json:"max_tokens"`
	Tags         string `json:"tags"` // Comma-separated tags (e.g., "slug" for slug generation)
}

type ModelInfo struct {
	ID               string `json:"id"`
	DisplayName      string `json:"display_name,omitempty"`
	Source           string `json:"source,omitempty"` // Human-readable source (e.g., "exe.dev gateway", "$ANTHROPIC_API_KEY")
	Ready            bool   `json:"ready"`
	MaxContextTokens int    `json:"max_context_tokens,omitempty"`
}

type NotificationChannelAPI struct {
	ChannelID   string `json:"channel_id"`
	ChannelType string `json:"channel_type"`
	DisplayName string `json:"display_name"`
	Enabled     bool   `json:"enabled"`
	Config      any    `json:"config"`
}

type ReleaseInfo struct {
	TagName      string            `json:"tag_name"`
	Version      string            `json:"version"`
	Commit       string            `json:"commit"`
	CommitFull   string            `json:"commit_full"`
	CommitTime   string            `json:"commit_time"`
	PublishedAt  string            `json:"published_at"`
	DownloadURLs map[string]string `json:"download_urls"`
	ChecksumsURL string            `json:"checksums_url"`
}

type RenameRequest struct {
	Slug string `json:"slug"`
}

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

type StaticCommitInfo struct {
	SHA     string `json:"sha"`
	Subject string `json:"subject"`
}

type StreamResponse struct {
	Messages          []APIMessage           `json:"messages"`
	Conversation      generated.Conversation `json:"conversation"`
	ConversationState *ConversationState     `json:"conversation_state,omitempty"`
	ContextWindowSize uint64                 `json:"context_window_size,omitempty"`
	// ConversationListUpdate is set when another conversation in the list changed
	ConversationListUpdate *ConversationListUpdate `json:"conversation_list_update,omitempty"`
	// Heartbeat indicates this is a heartbeat message (no new data, just keeping connection alive)
	Heartbeat bool `json:"heartbeat,omitempty"`
	// NotificationEvent is set when a notification-worthy event occurs (e.g. agent finished).
	NotificationEvent *notifications.Event `json:"notification_event,omitempty"`
}

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

type SubagentSystemPromptData struct {
	WorkingDirectory string
	CurrentDate      string // Today's date in YYYY-MM-DD format
	GitInfo          *GitInfo
}

type SwitchModelRequest struct {
	Model             string `json:"model"`
	CancelCurrentTurn bool   `json:"cancel_current_turn"`
}

type SystemPromptData struct {
	WorkingDirectory string
	CurrentDate      string // Today's date in YYYY-MM-DD format
	GitInfo          *GitInfo
	Codebase         *CodebaseInfo
	IsExeDev         bool
	IsSudoAvailable  bool
	Hostname         string // For exe.dev, the public hostname (e.g., "vmname.exe.xyz")
	PercyDBPath      string // Path to the percy database
	SkillsXML        string // XML block for available skills
}

type TestModelRequest struct {
	ModelID      string `json:"model_id,omitempty"` // If provided, use stored API key
	ProviderType string `json:"provider_type"`
	Endpoint     string `json:"endpoint"`
	APIKey       string `json:"api_key"`
	ModelName    string `json:"model_name"`
}

type TouchedFile struct {
	Path      string `json:"path"`
	Operation string `json:"operation"` // "read", "write", "patch", "navigate"
	Count     int    `json:"count"`     // number of interactions
}

type UpdateModelRequest struct {
	DisplayName  string `json:"display_name"`
	ProviderType string `json:"provider_type"`
	Endpoint     string `json:"endpoint"`
	APIKey       string `json:"api_key"` // Empty string means keep existing
	ModelName    string `json:"model_name"`
	MaxTokens    int64  `json:"max_tokens"`
	Tags         string `json:"tags"` // Comma-separated tags
}

type UpdateNotificationChannelRequest struct {
	DisplayName string `json:"display_name"`
	Enabled     bool   `json:"enabled"`
	Config      any    `json:"config"`
}

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

type VersionInfo struct {
	CurrentVersion      string       `json:"current_version"`
	CurrentTag          string       `json:"current_tag,omitempty"`
	CurrentCommit       string       `json:"current_commit,omitempty"`
	CurrentCommitTime   string       `json:"current_commit_time,omitempty"`
	LatestVersion       string       `json:"latest_version,omitempty"`
	LatestTag           string       `json:"latest_tag,omitempty"`
	PublishedAt         time.Time    `json:"published_at,omitempty"`
	HasUpdate           bool         `json:"has_update"`    // True if minor version is newer (for showing upgrade button)
	ShouldNotify        bool         `json:"should_notify"` // True if should show red dot (newer + 5 days old)
	DownloadURL         string       `json:"download_url,omitempty"`
	ExecutablePath      string       `json:"executable_path,omitempty"`
	Commits             []CommitInfo `json:"commits,omitempty"`
	CheckedAt           time.Time    `json:"checked_at"`
	Error               string       `json:"error,omitempty"`
	RunningUnderSystemd bool         `json:"running_under_systemd"` // True if INVOCATION_ID env var is set (systemd)
	ReleaseInfo         *ReleaseInfo `json:"-"`                     // Internal, not exposed to JSON
}