methods

type AgentCapabilities struct {
	Run          bool `json:"run"`
	Stop         bool `json:"stop"`
	Respond      bool `json:"respond"`
	Sessions     bool `json:"sessions"`
	SessionWatch bool `json:"sessionWatch"`
}

type AgentInputParams struct {
	// Input is the keyboard input to send.
	Input string `json:"input"`
}

type AgentInputResult struct {
	Status string `json:"status"`
}

type AgentManager interface {
	// StartWithSession starts the agent with a prompt and session configuration.
	StartWithSession(ctx context.Context, prompt string, mode SessionMode, sessionID string, permissionMode string) error

	// Stop stops the running agent process.
	Stop(ctx context.Context) error

	// SendResponse sends a response to an interactive prompt.
	SendResponse(toolUseID, response string, isError bool) error

	// SendPTYInput sends input to the PTY (for interactive responses).
	SendPTYInput(input string) error

	// IsPTYMode returns true if running in PTY mode.
	IsPTYMode() bool

	// State returns the current agent state.
	State() AgentState

	// PID returns the process ID of the running agent (0 if not running).
	PID() int

	// SessionID returns the current session ID.
	SessionID() string

	// AgentType returns the type of agent (e.g., "claude", "gemini", "codex").
	AgentType() string
}

type AgentRespondParams struct {
	// ToolUseID is the ID of the tool use to respond to.
	ToolUseID string `json:"tool_use_id"`

	// Response is the response content.
	Response string `json:"response"`

	// IsError indicates if the response is an error.
	IsError bool `json:"is_error,omitempty"`
}

type AgentRespondResult struct {
	Status    string `json:"status"`
	ToolUseID string `json:"tool_use_id"`
}

type AgentRunParams struct {
	// Prompt is the prompt to send to the agent.
	Prompt string `json:"prompt"`

	// Mode is the session mode: "new" or "continue".
	// Default is "new".
	Mode string `json:"mode,omitempty"`

	// SessionID is required when mode is "continue".
	SessionID string `json:"session_id,omitempty"`

	// PermissionMode controls how permissions are handled.
	// "default" - standard permission prompts
	// "acceptEdits" - auto-accept file edits
	// "bypassPermissions" - skip all permission checks
	// "plan" - plan mode
	// "interactive" - PTY mode with terminal-like permission prompts
	PermissionMode string `json:"permission_mode,omitempty"`
}

type AgentRunResult struct {
	// Status is "started" on success.
	Status string `json:"status"`

	// PID is the process ID of the agent CLI.
	PID int `json:"pid"`

	// SessionID is the agent session ID.
	SessionID string `json:"session_id,omitempty"`

	// Mode is the session mode used.
	Mode string `json:"mode"`

	// AgentType is the type of agent (e.g., "claude", "gemini", "codex").
	AgentType string `json:"agent_type"`
}

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

type AgentState string

type AgentStatusResult struct {
	// State is the current agent state.
	State string `json:"state"`

	// PID is the process ID if running.
	PID int `json:"pid,omitempty"`

	// SessionID is the current session ID.
	SessionID string `json:"session_id,omitempty"`

	// AgentType is the type of agent (e.g., "claude", "gemini", "codex").
	AgentType string `json:"agent_type"`

	// WaitingFor describes what the agent is waiting for (if any).
	WaitingFor string `json:"waiting_for,omitempty"`
}

type AgentStopResult struct {
	Status string `json:"status"`
}

type BranchInfo struct {
	Name    string `json:"name"`
	Current bool   `json:"current"`
}

type BranchesResult struct {
	Current  string       `json:"current"`
	Upstream string       `json:"upstream,omitempty"`
	Ahead    int          `json:"ahead"`
	Behind   int          `json:"behind"`
	Branches []BranchInfo `json:"branches"`
}

type CheckoutParams struct {
	Branch string `json:"branch"`
	Create bool   `json:"create,omitempty"`
}

type CheckoutResult struct {
	Success bool   `json:"success"`
	Branch  string `json:"branch,omitempty"`
	Message string `json:"message,omitempty"`
	Error   string `json:"error,omitempty"`
}

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

type ClaudeCapabilities = AgentCapabilities

type ClientCapabilities struct {
	// Notifications the client can handle.
	Notifications []string `json:"notifications,omitempty"`
}

type ClientFocusProvider interface {
	// SetSessionFocus updates the session focus for a client.
	// Returns focus change result with other viewers info and error.
	SetSessionFocus(clientID, workspaceID, sessionID string) (interface{}, error)
}

type ClientInfo struct {
	Name    string `json:"name"`
	Version string `json:"version,omitempty"`
}

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

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

type CodexManager interface {
	// Start starts Codex with the given prompt.
	Start(ctx context.Context, prompt string) error

	// Stop stops the running Codex process.
	Stop(ctx context.Context) error

	// SendInput sends input to the Codex process.
	SendInput(input string) error

	// Approve approves a pending action.
	Approve() error

	// Deny denies a pending action.
	Deny() error

	// IsRunning returns true if Codex is running.
	IsRunning() bool

	// IsWaiting returns true if waiting for user input.
	IsWaiting() bool

	// PID returns the process ID.
	PID() int

	// SessionID returns the current session ID.
	SessionID() string
}

type CommitParams struct {
	Message string `json:"message"`
	Push    bool   `json:"push,omitempty"`
}

type CommitResult struct {
	Success        bool   `json:"success"`
	SHA            string `json:"sha,omitempty"`
	Message        string `json:"message,omitempty"`
	FilesCommitted int    `json:"files_committed,omitempty"`
	Pushed         bool   `json:"pushed,omitempty"`
	Error          string `json:"error,omitempty"`
}

type DiffParams struct {
	// Path is the file path. If empty, returns diff for all files.
	Path string `json:"path,omitempty"`
}

type DiffResult struct {
	Path        string `json:"path,omitempty"`
	Diff        string `json:"diff"`
	IsStaged    bool   `json:"is_staged"`
	IsNew       bool   `json:"is_new"`
	IsTruncated bool   `json:"is_truncated"`
}

type DirStats struct {
	FolderCount int   // Direct subdirectories
	FileCount   int   // Recursive file count
	TotalSize   int64 // Total size in bytes
}

type DirectoryInfo struct {
	Path             string    `json:"path"`
	Name             string    `json:"name"`
	FolderCount      int       `json:"folder_count"` // Direct subdirectories count
	FileCount        int       `json:"file_count"`   // Recursive file count
	TotalSizeBytes   int64     `json:"total_size_bytes"`
	TotalSizeDisplay string    `json:"total_size_display"` // Human readable: "35 KB"
	LastModified     time.Time `json:"last_modified,omitempty"`
	ModifiedDisplay  string    `json:"modified_display,omitempty"` // Relative: "2 hours ago"
}

type DiscardResult struct {
	Success   bool     `json:"success"`
	Discarded []string `json:"discarded"`
}

type EventPublisher interface {
	Publish(event events.Event)
	// SubscriberCount returns the number of active subscribers.
	SubscriberCount() int
}

type FileCapabilities struct {
	Get         bool  `json:"get"`
	List        bool  `json:"list"`
	MaxFileSize int64 `json:"maxFileSize,omitempty"`
}

type FileContentProvider interface {
	// GetFileContent returns the content of a file.
	// Returns content, truncated flag, and error.
	GetFileContent(ctx context.Context, path string, maxSizeKB int) (string, bool, error)

	// ListDirectory returns entries in a directory.
	// Returns entries, error.
	ListDirectory(ctx context.Context, path string) ([]FileEntry, error)
}

type FileEntry struct {
	// Name is the file/directory name.
	Name string `json:"name"`

	// Type is either "file" or "directory".
	Type string `json:"type"`

	// Size is the file size in bytes (only for files).
	Size *int64 `json:"size,omitempty"`

	// Modified is the last modification time (only for files).
	Modified *string `json:"modified,omitempty"`

	// ChildrenCount is the number of children (only for directories).
	ChildrenCount *int `json:"children_count,omitempty"`
}

type FileInfo struct {
	Path        string    `json:"path"`
	Name        string    `json:"name"`
	Directory   string    `json:"directory"`
	Extension   string    `json:"extension,omitempty"`
	SizeBytes   int64     `json:"size_bytes"`
	ModifiedAt  time.Time `json:"modified_at"`
	IndexedAt   time.Time `json:"indexed_at,omitempty"`
	IsBinary    bool      `json:"is_binary"`
	IsSymlink   bool      `json:"is_symlink"`
	IsSensitive bool      `json:"is_sensitive"`
	GitTracked  bool      `json:"git_tracked"`
	GitIgnored  bool      `json:"git_ignored"`
}

type FileListResult struct {
	Directory        string          `json:"directory"`
	Files            []FileInfo      `json:"files"`
	Directories      []DirectoryInfo `json:"directories"`
	TotalFiles       int             `json:"total_files"`
	TotalDirectories int             `json:"total_directories"`
	Pagination       PaginationInfo  `json:"pagination"`
}

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

type FilteredSubscriberProvider interface {
	GetFilteredSubscriber(clientID string) *hub.FilteredSubscriber
}

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

type GeminiManager interface {
	// Start starts Gemini with the given prompt.
	Start(ctx context.Context, prompt string) error

	// Stop stops the running Gemini process.
	Stop(ctx context.Context) error

	// SendInput sends input to the Gemini process.
	SendInput(input string) error

	// IsRunning returns true if Gemini is running.
	IsRunning() bool

	// PID returns the process ID.
	PID() int

	// ConversationID returns the current conversation ID.
	ConversationID() string
}

type GetFileParams struct {
	// Path is the file path relative to the repository root.
	Path string `json:"path"`
}

type GetFileResult struct {
	// Path is the file path.
	Path string `json:"path"`

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

	// Encoding is the content encoding (always "utf-8").
	Encoding string `json:"encoding"`

	// Truncated indicates if the content was truncated due to size limits.
	Truncated bool `json:"truncated"`

	// Size is the content size in bytes.
	Size int `json:"size"`
}

type GetSessionElementsParams struct {
	SessionID string `json:"session_id"`
	AgentType string `json:"agent_type,omitempty"`
	Limit     int    `json:"limit,omitempty"`
	Before    string `json:"before,omitempty"`
	After     string `json:"after,omitempty"`
}

type GetSessionElementsResult struct {
	SessionID  string                    `json:"session_id"`
	Elements   []SessionElement          `json:"elements"`
	Pagination SessionElementsPagination `json:"pagination"`
}

type GetSessionMessagesParams struct {
	SessionID string `json:"session_id"`
	AgentType string `json:"agent_type,omitempty"`
	Limit     int    `json:"limit,omitempty"`
	Offset    int    `json:"offset,omitempty"`
	Order     string `json:"order,omitempty"` // "asc" or "desc" (default: "asc")
}

type GetSessionMessagesResult struct {
	SessionID   string           `json:"session_id"`
	Messages    []SessionMessage `json:"messages"`
	Total       int              `json:"total"`
	Limit       int              `json:"limit"`
	Offset      int              `json:"offset"`
	HasMore     bool             `json:"has_more"`
	QueryTimeMs float64          `json:"query_time_ms"`
}

type GetSessionParams struct {
	SessionID string `json:"session_id"`
	AgentType string `json:"agent_type,omitempty"`
}

type GetStatusResult struct {
	// ClaudeState is the current Claude state.
	ClaudeState string `json:"claude_state"`

	// ConnectedClients is the number of connected clients.
	ConnectedClients int `json:"connected_clients"`

	// RepoPath is the repository path.
	RepoPath string `json:"repo_path"`

	// RepoName is the repository name (basename of path).
	RepoName string `json:"repo_name"`

	// UptimeSeconds is the server uptime in seconds.
	UptimeSeconds int64 `json:"uptime_seconds"`

	// AgentVersion is the server version.
	AgentVersion string `json:"agent_version"`

	// WatcherEnabled indicates if the file watcher is enabled.
	WatcherEnabled bool `json:"watcher_enabled"`

	// GitEnabled indicates if git integration is enabled.
	GitEnabled bool `json:"git_enabled"`
}

type GitCapabilities struct {
	Status   bool `json:"status"`
	Diff     bool `json:"diff"`
	Stage    bool `json:"stage"`
	Unstage  bool `json:"unstage"`
	Discard  bool `json:"discard"`
	Commit   bool `json:"commit"`
	Push     bool `json:"push"`
	Pull     bool `json:"pull"`
	Branches bool `json:"branches"`
	Checkout bool `json:"checkout"`
}

type GitFileStatus struct {
	Path   string `json:"path"`
	Status string `json:"status"`
}

type GitProvider interface {
	// Status returns the git status.
	Status(ctx context.Context) (GitStatusInfo, error)

	// Diff returns the diff for a file or all files.
	Diff(ctx context.Context, path string) (string, bool, bool, error)

	// Stage stages files.
	Stage(ctx context.Context, paths []string) error

	// Unstage unstages files.
	Unstage(ctx context.Context, paths []string) error

	// Discard discards changes to files.
	Discard(ctx context.Context, paths []string) error

	// Commit creates a commit and optionally pushes. Returns commit result.
	Commit(ctx context.Context, message string, push bool) (*CommitResult, error)

	// Push pushes to remote. Returns push result.
	Push(ctx context.Context) (*PushResult, error)

	// Pull pulls from remote. Returns pull result.
	Pull(ctx context.Context) (*PullResult, error)

	// Branches returns the list of branches with full info.
	Branches(ctx context.Context) (*BranchesResult, error)

	// Checkout checks out a branch. Returns checkout result.
	Checkout(ctx context.Context, branch string) (*CheckoutResult, error)
}

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

type GitStatusInfo struct {
	Branch     string          `json:"branch"`
	Upstream   string          `json:"upstream,omitempty"`
	Ahead      int             `json:"ahead"`
	Behind     int             `json:"behind"`
	Staged     []GitFileStatus `json:"staged"`
	Unstaged   []GitFileStatus `json:"unstaged"`
	Untracked  []GitFileStatus `json:"untracked"`
	Conflicted []GitFileStatus `json:"conflicted"`
	RepoName   string          `json:"repo_name"`
	RepoRoot   string          `json:"repo_root"`
}

type GitWatcherManager interface {
	StartGitWatcher(workspaceID string) error
	StopGitWatcher(workspaceID string)
}

type HealthResult struct {
	Status        string `json:"status"`
	UptimeSeconds int64  `json:"uptime_seconds"`
}

type InitializeParams struct {
	// ProtocolVersion is the protocol version the client supports.
	ProtocolVersion string `json:"protocolVersion"`

	// ClientInfo describes the client.
	ClientInfo *ClientInfo `json:"clientInfo,omitempty"`

	// Capabilities describes what the client can handle.
	Capabilities *ClientCapabilities `json:"capabilities,omitempty"`

	// RootPath is the root path of the workspace.
	RootPath string `json:"rootPath,omitempty"`
}

type InitializeResult struct {
	// ProtocolVersion is the protocol version the server uses.
	ProtocolVersion string `json:"protocolVersion"`

	// ServerInfo describes the server.
	ServerInfo ServerInfo `json:"serverInfo"`

	// Capabilities describes what the server can do.
	Capabilities ServerCapabilities `json:"capabilities"`

	// ClientID is the unique identifier assigned to this client connection.
	// Use this to identify yourself in session events (e.g., session_joined, session_left).
	ClientID string `json:"clientId"`
}

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

type ListDirectoryParams struct {
	// Path is the directory path relative to the repository root.
	// If empty, lists the root directory.
	Path string `json:"path,omitempty"`
}

type ListDirectoryResult struct {
	// Path is the directory path.
	Path string `json:"path"`

	// Entries is the list of files and directories.
	Entries []FileEntry `json:"entries"`

	// TotalCount is the number of entries.
	TotalCount int `json:"total_count"`
}

type ListSessionsParams struct {
	// AgentType filters by agent type (optional, empty = all).
	AgentType string `json:"agent_type,omitempty"`

	// WorkspaceID filters by workspace (server resolves path automatically).
	WorkspaceID string `json:"workspace_id,omitempty"`

	// Limit is the max number of sessions to return.
	Limit int `json:"limit,omitempty"`
}

type ListSessionsResult struct {
	Sessions []SessionInfo `json:"sessions"`
	Total    int           `json:"total"`
}

type PaginationInfo struct {
	Limit   int  `json:"limit"`
	Offset  int  `json:"offset"`
	HasMore bool `json:"has_more"`
}

type PathsParams struct {
	Paths []string `json:"paths"`
}

type PendingParams struct {
	SessionID string `json:"session_id,omitempty"`
}

type PendingRequestInfo struct {
	ToolUseID   string                 `json:"tool_use_id"`
	SessionID   string                 `json:"session_id"`
	WorkspaceID string                 `json:"workspace_id"`
	ToolName    string                 `json:"tool_name"`
	ToolInput   map[string]interface{} `json:"tool_input"`
	CreatedAt   string                 `json:"created_at"`
}

type PermissionManager interface {
	// CheckMemory checks session memory for a matching pattern.
	CheckMemory(sessionID, toolName string, toolInput map[string]interface{}) *permission.StoredDecision

	// StoreDecision stores a permission decision in session memory.
	StoreDecision(sessionID, workspaceID, pattern string, decision permission.Decision)

	// AddPendingRequest adds a request waiting for mobile response.
	AddPendingRequest(req *permission.Request)

	// GetPendingRequest retrieves a pending request.
	GetPendingRequest(toolUseID string) *permission.Request

	// RemovePendingRequest removes a pending request.
	RemovePendingRequest(toolUseID string)

	// RespondToRequest sends a response to a pending request.
	RespondToRequest(toolUseID string, response *permission.Response) bool

	// GetAndRemovePendingRequest atomically gets and removes a pending request.
	GetAndRemovePendingRequest(toolUseID string) *permission.Request

	// ListPendingRequests returns all pending permission requests.
	ListPendingRequests() []*permission.Request

	// GetSessionStats returns statistics about session memory.
	GetSessionStats() map[string]interface{}
}

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

type PullResult struct {
	Success         bool     `json:"success"`
	Message         string   `json:"message,omitempty"`
	CommitsPulled   int      `json:"commits_pulled,omitempty"`
	FilesChanged    int      `json:"files_changed,omitempty"`
	ConflictedFiles []string `json:"conflicted_files,omitempty"`
	Error           string   `json:"error,omitempty"`
}

type PushResult struct {
	Success       bool   `json:"success"`
	Message       string `json:"message,omitempty"`
	CommitsPushed int    `json:"commits_pushed,omitempty"`
	Error         string `json:"error,omitempty"`
}

type RepositoryCapabilities struct {
	Index   bool `json:"index"`   // repository/index/status, repository/index/rebuild
	Search  bool `json:"search"`  // repository/search
	List    bool `json:"list"`    // repository/files/list
	Tree    bool `json:"tree"`    // repository/files/tree
	Stats   bool `json:"stats"`   // repository/stats
	Rebuild bool `json:"rebuild"` // repository/index/rebuild
}

type RepositoryIndexer interface {
	GetStatus() repository.IndexStatus
	Search(ctx context.Context, query repository.SearchQuery) (*repository.SearchResult, error)
	ListFiles(ctx context.Context, opts repository.ListOptions) (*repository.FileList, error)
	GetTree(ctx context.Context, rootPath string, depth int) (*repository.DirectoryTree, error)
	GetStats(ctx context.Context) (*repository.RepositoryStats, error)
	FullScan(ctx context.Context) error
}

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

type RequestParams struct {
	SessionID string                 `json:"session_id"`
	ToolName  string                 `json:"tool_name"`
	ToolInput map[string]interface{} `json:"tool_input"`
	ToolUseID string                 `json:"tool_use_id"`
	Cwd       string                 `json:"cwd"`
}

type RespondParams struct {
	ToolUseID string `json:"tool_use_id"`
	Decision  string `json:"decision"` // "allow" or "deny"
	Scope     string `json:"scope"`    // "once" or "session"
}

type RuntimeCapabilityRegistry struct {
	SchemaVersion  string              `json:"schemaVersion"`
	GeneratedAt    string              `json:"generatedAt,omitempty"`
	DefaultRuntime string              `json:"defaultRuntime"`
	Routing        RuntimeRouting      `json:"routing"`
	Runtimes       []RuntimeDescriptor `json:"runtimes"`
}

type RuntimeDescriptor struct {
	ID                                    string         `json:"id"`
	DisplayName                           string         `json:"displayName"`
	Status                                string         `json:"status"`
	SessionListSource                     string         `json:"sessionListSource"`
	SessionMessagesSource                 string         `json:"sessionMessagesSource"`
	SessionWatchSource                    string         `json:"sessionWatchSource"`
	RequiresWorkspaceActivationOnResume   bool           `json:"requiresWorkspaceActivationOnResume"`
	RequiresSessionResolutionOnNewSession bool           `json:"requiresSessionResolutionOnNewSession"`
	SupportsResume                        bool           `json:"supportsResume"`
	SupportsInteractiveQuestions          bool           `json:"supportsInteractiveQuestions"`
	SupportsPermissions                   bool           `json:"supportsPermissions"`
	Methods                               RuntimeMethods `json:"methods"`
}

type RuntimeMethods struct {
	History  string `json:"history"`
	Messages string `json:"messages"`
	Watch    string `json:"watch"`
	Unwatch  string `json:"unwatch"`
	Start    string `json:"start"`
	Send     string `json:"send"`
	Stop     string `json:"stop"`
	Input    string `json:"input"`
	Respond  string `json:"respond"`
	State    string `json:"state,omitempty"`
}

type RuntimeRouting struct {
	AgentTypeField    string   `json:"agentTypeField"`
	DefaultAgentType  string   `json:"defaultAgentType"`
	RequiredOnMethods []string `json:"requiredOnMethods,omitempty"`
}

type ServerCapabilities struct {
	// Agent operations (generic for any AI CLI)
	Agent *AgentCapabilities `json:"agent,omitempty"`

	// Git operations
	Git *GitCapabilities `json:"git,omitempty"`

	// File operations
	File *FileCapabilities `json:"file,omitempty"`

	// Repository indexing
	Repository *RepositoryCapabilities `json:"repository,omitempty"`

	// Notifications the server can send
	Notifications []string `json:"notifications,omitempty"`

	// SupportedAgents lists the configured agent types (e.g., "claude", "gemini", "codex")
	SupportedAgents []string `json:"supportedAgents,omitempty"`

	// RuntimeRegistry describes per-runtime behavior so clients can route without hardcoded branches.
	RuntimeRegistry *RuntimeCapabilityRegistry `json:"runtimeRegistry,omitempty"`
}

type ServerInfo struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

type SessionElement struct {
	// ID is the element identifier.
	ID string `json:"id"`

	// Type is the element type (user_input, assistant_text, tool_call, tool_result, diff, thinking, context_compaction, interrupted).
	Type string `json:"type"`

	// Timestamp is when the element was created.
	Timestamp string `json:"timestamp"`

	// Content is the type-specific content.
	Content interface{} `json:"content"`
}

type SessionElementsPagination struct {
	Total         int    `json:"total"`
	Returned      int    `json:"returned"`
	HasMoreBefore bool   `json:"has_more_before"`
	HasMoreAfter  bool   `json:"has_more_after"`
	OldestID      string `json:"oldest_id,omitempty"`
	NewestID      string `json:"newest_id,omitempty"`
}

type SessionFocusParams struct {
	// WorkspaceID is the workspace ID.
	WorkspaceID string `json:"workspace_id"`

	// SessionID is the session ID being focused on.
	SessionID string `json:"session_id"`
}

type SessionFocusProvider interface {
	SetSessionFocus(clientID, workspaceID, sessionID string) (interface{}, error)
}

type SessionInfo struct {
	// SessionID is the unique identifier.
	SessionID string `json:"session_id"`

	// AgentType is the type of agent (claude, gemini, codex).
	AgentType string `json:"agent_type"`

	// Summary is a brief description of the session.
	Summary string `json:"summary,omitempty"`

	// FirstPrompt is the first user message (for Codex sessions).
	FirstPrompt string `json:"first_prompt,omitempty"`

	// MessageCount is the number of messages in the session.
	MessageCount int `json:"message_count"`

	// StartTime is when the session started.
	StartTime time.Time `json:"start_time"`

	// LastUpdated is when the session was last updated.
	LastUpdated time.Time `json:"last_updated"`

	// Branch is the git branch (if available).
	Branch string `json:"branch,omitempty"`

	// GitCommit is the git commit hash (if available).
	GitCommit string `json:"git_commit,omitempty"`

	// GitRepo is the repository URL (if available).
	GitRepo string `json:"git_repo,omitempty"`

	// ProjectPath is the project this session belongs to.
	ProjectPath string `json:"project_path,omitempty"`

	// ModelProvider is the AI provider (openai, anthropic, etc.).
	ModelProvider string `json:"model_provider,omitempty"`

	// Model is the specific model used.
	Model string `json:"model,omitempty"`

	// CLIVersion is the CLI version that created the session.
	CLIVersion string `json:"cli_version,omitempty"`

	// FileSize is the session file size in bytes.
	FileSize int64 `json:"file_size,omitempty"`

	// FilePath is the full path to the session file.
	FilePath string `json:"file_path,omitempty"`
}

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

type SessionMessage struct {
	// ID is the database row ID.
	ID int64 `json:"id"`

	// SessionID is the parent session ID.
	SessionID string `json:"session_id"`

	// Type is the message type (user, assistant).
	Type string `json:"type"`

	// UUID is the unique message identifier.
	UUID string `json:"uuid,omitempty"`

	// Timestamp is when the message was created (ISO 8601 string).
	Timestamp string `json:"timestamp,omitempty"`

	// GitBranch is the git branch when message was created.
	GitBranch string `json:"git_branch,omitempty"`

	// Message is the raw Claude API message (content, role, model, usage, etc).
	Message json.RawMessage `json:"message"`

	// IsContextCompaction is true when this is an auto-generated message
	// created by Claude Code when the context window was maxed out.
	IsContextCompaction bool `json:"is_context_compaction,omitempty"`

	// IsMeta is true for system-generated metadata messages (e.g., command caveats).
	IsMeta bool `json:"is_meta,omitempty"`
}

type SessionMode string

type SessionProvider interface {
	// ListSessions returns available sessions for the current project.
	// If projectPath is provided, filters sessions to that project path.
	ListSessions(ctx context.Context, projectPath string) ([]SessionInfo, error)

	// GetSession returns detailed session info.
	GetSession(ctx context.Context, sessionID string) (*SessionInfo, error)

	// GetSessionMessages returns messages for a session.
	// Order can be "asc" or "desc" (default: "asc").
	GetSessionMessages(ctx context.Context, sessionID string, limit, offset int, order string) ([]SessionMessage, int, error)

	// GetSessionElements returns pre-parsed UI elements for a session.
	GetSessionElements(ctx context.Context, sessionID string, limit int, beforeID, afterID string) ([]SessionElement, int, error)

	// DeleteSession deletes a specific session.
	DeleteSession(ctx context.Context, sessionID string) error

	// DeleteAllSessions deletes all sessions.
	DeleteAllSessions(ctx context.Context) (int, error)

	// AgentType returns the type of agent this provider is for.
	AgentType() string
}

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

type SessionStreamer interface {
	// WatchSession starts watching a session for new messages.
	WatchSession(sessionID string) error

	// UnwatchSession stops watching the current session.
	UnwatchSession()

	// GetWatchedSession returns the currently watched session ID.
	GetWatchedSession() string
}

type SessionViewerProvider interface {
	// GetSessionViewers returns a map of session ID to list of client IDs viewing that session.
	GetSessionViewers(workspaceID string) map[string][]string
}

type ShutdownResult struct {
	Success bool `json:"success"`
}

type StageResult struct {
	Success bool     `json:"success"`
	Staged  []string `json:"staged"`
}

type StatusProvider interface {
	// ClaudeState returns the current Claude state.
	ClaudeState() string

	// ConnectedClients returns the number of connected clients.
	ConnectedClients() int

	// RepoPath returns the repository path.
	RepoPath() string

	// UptimeSeconds returns the uptime in seconds.
	UptimeSeconds() int64

	// Version returns the server version.
	Version() string

	// WatcherEnabled returns whether the file watcher is enabled.
	WatcherEnabled() bool

	// GitEnabled returns whether git integration is enabled.
	GitEnabled() bool
}

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

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

type TokenUsage struct {
	Input    int `json:"input,omitempty"`
	Output   int `json:"output,omitempty"`
	Cached   int `json:"cached,omitempty"`
	Thinking int `json:"thinking,omitempty"`
	Total    int `json:"total,omitempty"`
}

type ToolCall struct {
	// ID is the tool use ID.
	ID string `json:"id"`

	// Name is the tool name.
	Name string `json:"name"`

	// Input is the tool input arguments.
	Input map[string]interface{} `json:"input,omitempty"`

	// Result is the tool result (if completed).
	Result string `json:"result,omitempty"`

	// Status is the tool call status.
	Status string `json:"status,omitempty"`
}

type UnstageResult struct {
	Success  bool     `json:"success"`
	Unstaged []string `json:"unstaged"`
}

type UnwatchSessionResult struct {
	Status   string `json:"status"`
	Watching bool   `json:"watching"`
}

type WatchSessionParams struct {
	SessionID string `json:"session_id"`
	AgentType string `json:"agent_type,omitempty"`
}

type WatchSessionResult struct {
	Status   string `json:"status"`
	Watching bool   `json:"watching"`
}

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

type WorkspaceIDResolver struct {
}

type WorkspaceInfo struct {
	ID               string        `json:"id"`
	Name             string        `json:"name"`
	Path             string        `json:"path"`
	AutoStart        bool          `json:"auto_start"`
	CreatedAt        string        `json:"created_at"`
	HasActiveSession bool          `json:"has_active_session"`
	Session          *session.Info `json:"session,omitempty"`
}

type WorkspacePathResolver interface {
	GetWorkspacePath(workspaceID string) (string, error)
}

type WorkspaceResolver interface {
	ResolveWorkspaceID(path string) (string, error)
}