desktop

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

type ApprovalRequestPayload struct {
	ProjectID string         `json:"project_id"`
	ToolName  string         `json:"tool_name"`
	Args      map[string]any `json:"args"`
}

type AuthStatus struct {
	LoggedIn  bool   `json:"logged_in"`
	ServerURL string `json:"server_url,omitempty"`
	UserID    string `json:"user_id,omitempty"`
	Email     string `json:"email,omitempty"`
	Name      string `json:"name,omitempty"`
	// Expired means the stored login no longer works. The app stays in managed
	// mode and refuses to run rather than quietly using local models, which
	// would send prompts somewhere the user did not choose. Signing in again or
	// signing out are the two ways out — see docs/design/client-modes.md
	// section 8.
	Expired bool `json:"expired,omitempty"`
	// ExpiredDetail is what to tell the user, set only when Expired.
	ExpiredDetail string `json:"expired_detail,omitempty"`
}

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

type HistoryMoveResult struct {
	// SessionID is the session to display next: the same one after a rewind,
	// the new child after a fork.
	SessionID string              `json:"session_id"`
	Messages  int                 `json:"messages"`
	Tools     []HistoryToolEffect `json:"tools,omitempty"`
	// Prompt is the rewound message, for the composer to take back. Empty
	// after a fork, which removes nothing.
	Prompt string `json:"prompt,omitempty"`
	// Attachments counts images the rewound message carried and the composer
	// cannot restore.
	Attachments int `json:"attachments,omitempty"`
}

type HistoryPoint struct {
	ItemID   string              `json:"item_id"`
	Role     string              `json:"role"`
	Content  string              `json:"content"`
	Messages int                 `json:"messages"`
	Tools    []HistoryToolEffect `json:"tools,omitempty"`
}

type HistoryPointsResult struct {
	SessionID string         `json:"session_id"`
	Rewind    []HistoryPoint `json:"rewind"`
	Fork      []HistoryPoint `json:"fork"`
}

type HistoryToolEffect struct {
	Name string `json:"name"`
	// Interrupted marks a call that entered its tool and never reported back.
	// It is the worse of the two: it may have changed as much as one that
	// finished, and nothing recorded what.
	Interrupted bool `json:"interrupted"`
}

type InstallPluginPlan struct {
	Name             string   `json:"name"`
	Version          string   `json:"version"`
	Digest           string   `json:"digest"`
	SizeBytes        int64    `json:"size_bytes"`
	PublishedBy      string   `json:"published_by,omitempty"`
	AlreadyInstalled bool     `json:"already_installed"`
	Skills           []string `json:"skills,omitempty"`
	Subagents        []string `json:"subagents,omitempty"`
	MCP              []string `json:"mcp,omitempty"`
	Hooks            []string `json:"hooks,omitempty"`
	// MissingEnv names the variables this release reads that are not set here,
	// which is the usual reason a plugin looks installed and does nothing.
	MissingEnv []string `json:"missing_env,omitempty"`
	// DirtySource says the release was packed from a working tree that was not
	// the commit it names.
	DirtySource bool `json:"dirty_source,omitempty"`
}

type JobDeliveryPayload struct {
	ProjectID string `json:"project_id"`
	SessionID string `json:"session_id"`
	JobID     string `json:"job_id"`
	Source    string `json:"source"`
	Title     string `json:"title"`
}

type JobDeliveryPendingPayload struct {
	ProjectID string `json:"project_id"`
	SessionID string `json:"session_id"`
	Pending   int    `json:"pending"`
}

type JobOutputPayload struct {
	Data       string `json:"data"`
	NextCursor uint64 `json:"next_cursor"`
	Dropped    uint64 `json:"dropped,omitempty"`
	Running    bool   `json:"running"`
	State      string `json:"state"`
}

type JobPayload struct {
	ProjectID  string `json:"project_id"`
	ID         string `json:"id"`
	Kind       string `json:"kind"`
	State      string `json:"state"`
	StopReason string `json:"stop_reason,omitempty"`
	ExitCode   int    `json:"exit_code,omitempty"`
	Error      string `json:"error,omitempty"`
	Command    string `json:"command"`
	SessionID  string `json:"session_id,omitempty"`
	Running    bool   `json:"running"`
	CreatedAt  string `json:"created_at"`
	EndedAt    string `json:"ended_at,omitempty"`
}

type MemoryEntry struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Description string `json:"description"`
	Body        string `json:"body"`
	UpdatedAt   string `json:"updated_at,omitempty"`
	VerifiedAt  string `json:"verified_at,omitempty"`
}

type MemorySkipped struct {
	File   string `json:"file"`
	Reason string `json:"reason"`
}

type MessageBlockedPayload struct {
	Prompt string   `json:"prompt"`
	Reason string   `json:"reason"`
	Queued []string `json:"queued"`
}

type MessageDequeuedPayload struct {
	Prompt string   `json:"prompt"`
	Queued []string `json:"queued"`
}

type PluginEntry struct {
	Name        string `json:"name"`
	DisplayName string `json:"display_name"`
	Description string `json:"description,omitempty"`
	Path        string `json:"path"`
	Source      string `json:"source"`
	// State is active, disabled, refused, or error — a decision and a defect
	// are different things and a reader should not have to tell them apart
	// from a message.
	State string `json:"state"`

	Version string `json:"version,omitempty"`
	Digest  string `json:"digest,omitempty"`

	RemoteURL string `json:"remote_url,omitempty"`
	Branch    string `json:"branch,omitempty"`
	Commit    string `json:"commit,omitempty"`
	Dirty     bool   `json:"dirty,omitempty"`

	Skills    []string       `json:"skills,omitempty"`
	Subagents []string       `json:"subagents,omitempty"`
	MCP       []string       `json:"mcp,omitempty"`
	Hooks     []string       `json:"hooks,omitempty"`
	Env       []PluginEnvVar `json:"env,omitempty"`
	// Shadowed names what a higher layer overrode, so a plugin does not read
	// as fully active while part of it never loads.
	Shadowed []string `json:"shadowed,omitempty"`
	Problems []string `json:"problems,omitempty"`
}

type PluginEnvVar struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required"`
	Set         bool   `json:"set"`
}

type PluginsResult struct {
	Dir     string        `json:"dir"`
	Plugins []PluginEntry `json:"plugins"`
	// AllowedSources is the operator's restriction, empty when there is none.
	AllowedSources []string `json:"allowed_sources,omitempty"`
	// Notes are directory-level findings: a stray directory, unreadable state.
	Notes []string `json:"notes,omitempty"`
}

type ProjectMemoryPayload struct {
	ProjectName string `json:"project_name"`
	Directory   string `json:"directory"`
	// IndexChars is what the index costs on every model call and IndexBudget
	// what it may cost. That pair is what a person prunes against, not the
	// count.
	IndexChars  int `json:"index_chars"`
	IndexBudget int `json:"index_budget"`
	// Unavailable distinguishes a store that could not be read from one with
	// nothing in it.
	Unavailable string          `json:"unavailable,omitempty"`
	Memories    []MemoryEntry   `json:"memories"`
	Skipped     []MemorySkipped `json:"skipped,omitempty"`
}

type ReplyPayload struct {
	Reply                 string `json:"reply"`
	SessionID             string `json:"session_id"`
	ContextTokens         int    `json:"context_tokens"`
	ContextWindow         int    `json:"context_window"`
	PromptTokens          int    `json:"prompt_tokens"`
	CompletionTokens      int    `json:"completion_tokens"`
	TotalPromptTokens     int    `json:"total_prompt_tokens"`
	TotalCompletionTokens int    `json:"total_completion_tokens"`
	// Cache counts are the cached parts of the prompt counts above, not extra
	// tokens to add to them.
	CacheReadTokens       int `json:"cache_read_tokens"`
	CacheWriteTokens      int `json:"cache_write_tokens"`
	TotalCacheReadTokens  int `json:"total_cache_read_tokens"`
	TotalCacheWriteTokens int `json:"total_cache_write_tokens"`
}

type RunStatusPayload struct {
	ContextTokens         int `json:"context_tokens"`
	ContextWindow         int `json:"context_window"`
	PromptTokens          int `json:"prompt_tokens"`
	CompletionTokens      int `json:"completion_tokens"`
	TotalPromptTokens     int `json:"total_prompt_tokens"`
	TotalCompletionTokens int `json:"total_completion_tokens"`
	CacheReadTokens       int `json:"cache_read_tokens"`
	CacheWriteTokens      int `json:"cache_write_tokens"`
	TotalCacheReadTokens  int `json:"total_cache_read_tokens"`
	TotalCacheWriteTokens int `json:"total_cache_write_tokens"`
}

type SessionDetail struct {
	ID        string        `json:"id"`
	Title     string        `json:"title,omitempty"`
	CreatedAt string        `json:"created_at"`
	Messages  []llm.Message `json:"messages,omitempty"`
}

type SlashAgentEntry struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	IsBuiltin   bool   `json:"is_builtin"`
}

type SlashAgentsResult struct {
	Agents []SlashAgentEntry `json:"agents"`
}

type SlashMCPResult struct {
	LoadError string           `json:"load_error,omitempty"`
	Servers   []SlashMCPServer `json:"servers"`
}

type SlashMCPServer struct {
	ID        string `json:"id"`
	Type      string `json:"type"`
	OK        bool   `json:"ok"`
	ToolCount int    `json:"tool_count"`
	Error     string `json:"error,omitempty"`
}

type SlashModelEntry struct {
	Name          string `json:"name"`
	ProviderModel string `json:"provider_model,omitempty"`
	IsCurrent     bool   `json:"is_current"`
	// Destination is the provider endpoint a local model is called at. Empty in
	// managed mode, where the deployment on the result says where every prompt
	// goes and no model has an endpoint of its own.
	Destination string `json:"destination,omitempty"`
}

type SlashModelsResult struct {
	Current string `json:"current"`
	// Managed and ServerURL say where every prompt in this session goes. It is
	// the app's mode, not a property of one model, so the picker states it once
	// above the list. See docs/design/client-modes.md.
	Managed   bool              `json:"managed"`
	ServerURL string            `json:"server_url,omitempty"`
	Models    []SlashModelEntry `json:"models"`
}

type SlashSkillEntry struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Path        string `json:"path"`
}

type SlashSkillsResult struct {
	Skills []SlashSkillEntry `json:"skills"`
}

type StreamErrorPayload struct {
	Message string `json:"message"`
}

type ToolEndPayload struct {
	ToolCallID string `json:"tool_call_id"`
	ToolName   string `json:"tool_name"`
	DurationMs int64  `json:"duration_ms,omitempty"`
	IsError    bool   `json:"is_error,omitempty"`
	Denied     bool   `json:"denied,omitempty"`
	Reason     string `json:"reason,omitempty"`
}

type ToolStartPayload struct {
	ToolCallID string `json:"tool_call_id"`
	ToolName   string `json:"tool_name"`
	Args       string `json:"args"`
}

type TurnDigestPayload struct {
	// Recap is a short account of what the turn did, or "" when it earned none.
	Recap string `json:"recap"`
	// Suggestion is the answer the user is likely about to give, or "" when the
	// turn did not end by asking them anything.
	Suggestion string `json:"suggestion"`
}