protocol

type AgentDoneMsg struct{}

type Attachment struct {
	Type      string `json:"type"`
	MediaType string `json:"media_type"`
	Data      string `json:"data"`
	Path      string `json:"path,omitempty"`
}

type ClearMsg struct{}

type ConfirmRequestMsg struct {
	ToolName string
	Params   map[string]any
}

type DaemonDisconnectedMsg struct{}

type DaemonEventMsg struct {
	Event SessionEvent
}

type DaemonStatusMsg struct {
	Connected bool
}

type ErrorMsg struct{ Err error }

type EventCompacted struct {
	FromTokens      int64 `json:"from_tokens"`
	ToTokens        int64 `json:"to_tokens"`
	SummarizedTurns int   `json:"summarized_turns"`
	Auto            bool  `json:"auto"` // true = auto-trigger, false = /compact
}

type EventConfirmRequest struct {
	ToolName      string         `json:"tool_name"`
	Params        map[string]any `json:"params"`
	RequestedDirs []string       `json:"requested_dirs,omitempty"` // directories outside cwd that require approval
	Detail        string         `json:"detail,omitempty"`         // same format as EventToolResult.Detail — fenced code block or structured diff
}

type EventError struct {
	Message string `json:"message"`
	// Code is an optional machine-readable discriminator. Used by the attach
	// flow: "session_not_found" tells the client a resume target no longer
	// exists on disk so it can orphan the session (offer /copy) instead of
	// retrying the reconnect forever; "session_busy" tells the client the
	// session is already open in another connection (exclusive single-writer
	// ownership) so it should retry later or attach a different session.
	Code string `json:"code,omitempty"`
}

type EventInitState struct {
	State int    `json:"state"`
	Model string `json:"model,omitempty"` // resolved model spec, set on InitDone
}

type EventJobDone struct {
	JobID     string `json:"job_id"`
	Name      string `json:"name,omitempty"`
	Status    string `json:"status"`
	Error     string `json:"error,omitempty"`
	SessionID string `json:"session_id,omitempty"`
}

type EventJobRun struct {
	JobID  string `json:"job_id"`
	Name   string `json:"name,omitempty"`
	Status string `json:"status"`
	Error  string `json:"error,omitempty"`
}

type EventPlanComplete struct {
	Plan *Plan `json:"plan"`
}

type EventPlanProposed struct {
	Plan *Plan `json:"plan"`
}

type EventPlanTaskDone struct {
	TaskIdx int    `json:"task_idx"`
	Title   string `json:"title"`
	Success bool   `json:"success"`
	Summary string `json:"summary"`
}

type EventPlanTaskStart struct {
	TaskIdx int    `json:"task_idx"`
	Title   string `json:"title"`
	Total   int    `json:"total"`
}

type EventQuestionOption struct {
	Title        string `json:"title"`
	Description  string `json:"description"`
	HasUserInput bool   `json:"has_user_input,omitempty"`
}

type EventReplay struct {
	Messages       []ReplayMessage `json:"messages"`
	Todos          []TodoItem      `json:"todos,omitempty"`
	ActivePlan     *Plan           `json:"active_plan,omitempty"`
	Model          string          `json:"model,omitempty"`
	Title          string          `json:"title,omitempty"`
	SessionMode    string          `json:"session_mode,omitempty"`
	ActiveWorkflow string          `json:"active_workflow,omitempty"`
	// Warnings are human-readable restore notices rendered into the viewport
	// (e.g. "Saved with model X; switched to your current default Y.").
	Warnings []string `json:"warnings,omitempty"`
}

type EventRetry struct {
	Attempt    int    `json:"attempt"`
	MaxRetries int    `json:"max_retries"`
	WaitSecs   int    `json:"wait_secs"`
	Reason     string `json:"reason"`
}

type EventSessionStarted struct {
	SessionID   string `json:"session_id"`
	StartedAt   string `json:"started_at"` // RFC3339
	ParentID    string `json:"parent_id,omitempty"`
	ForkTurnIdx int    `json:"fork_turn_idx,omitempty"`
}

type EventSessionsChanged struct{}

type EventSkillsAvailable struct {
	Skills []SkillInfo `json:"skills"`
}

type EventStreamChunk struct {
	Text string `json:"text"`
}

type EventStreamDone struct {
	InputTokens         int64 `json:"input_tokens"`
	OutputTokens        int64 `json:"output_tokens"`
	CacheCreationTokens int64 `json:"cache_creation_tokens"`
	CacheReadTokens     int64 `json:"cache_read_tokens"`
	ElapsedMs           int64 `json:"elapsed_ms"`
}

type EventThinkingChunk struct {
	Text string `json:"text"`
}

type EventThinkingStall struct {
	ElapsedMs    int64 `json:"elapsed_ms"`
	SummaryChars int   `json:"summary_chars"`
}

type EventTitleUpdated struct {
	Title string `json:"title"`
}

type EventTodoListUpdated struct {
	Todos []TodoItem `json:"todos"`
}

type EventToolCall struct {
	ToolID string `json:"tool_id"`
	Name   string `json:"name"`
	// Arguments is the raw tool input as issued by the model (structured
	// key/value payload). Included so trajectory consumers (ATIF exporters,
	// SFT/RL pipelines) can round-trip the exact call without re-deriving
	// it from Summary. Summary stays the human-readable one-liner.
	Arguments map[string]any `json:"arguments,omitempty"`
	Summary   string         `json:"summary"`
	Reason    string         `json:"reason,omitempty"`
	// TimeoutSec is the effective tool-call timeout in seconds, after daemon
	// clamping. See daemon.resolveToolTimeout: floor and cap come from the
	// `tool_timeouts` block in settings.json (defaulting to 120s / 600s when
	// absent or invalid), and only bash/glob_files honor the model's
	// `timeout` override.
	TimeoutSec int `json:"timeout_sec,omitempty"`
	// Bash-specific alternative-tool justifications (omitted when empty or "N/A").
	ReasonNotReadFile  string `json:"reason_not_read_file,omitempty"`
	ReasonNotEditFile  string `json:"reason_not_edit_file,omitempty"`
	ReasonNotGlobFiles string `json:"reason_not_glob_files,omitempty"`
	// ReasonToIncreaseTimeout is the model's justification for raising the
	// bash/glob_files timeout above the 120s default. Populated from the
	// `reason_to_increase_timeout` field of the tool input.
	ReasonToIncreaseTimeout string `json:"reason_to_increase_timeout,omitempty"`
}

type EventToolResult struct {
	ToolID  string `json:"tool_id"`
	Name    string `json:"name"`
	Output  string `json:"output"`
	IsError bool   `json:"is_error"`
	Detail  string `json:"detail,omitempty"` // optional rich detail (e.g. edit diff)
}

type EventUpdateAvailable struct {
	Current string `json:"current"`
	Latest  string `json:"latest,omitempty"`
	URL     string `json:"url,omitempty"`
	Method  string `json:"method,omitempty"`
}

type EventUserQuestion struct {
	// Single-question fields (backward compatible)
	Question    string                `json:"question"`
	Options     []string              `json:"options"`
	RichOptions []EventQuestionOption `json:"rich_options,omitempty"` // structured options (workflow tool steps)
	Placeholder string                `json:"placeholder,omitempty"`
	Category    string                `json:"category,omitempty"`

	// Multi-question batch (if set, overrides single fields)
	Questions []QuestionDef `json:"questions,omitempty"`
}

type EventWorkflowComplete struct {
	WorkflowName string     `json:"workflow_name"`
	Success      bool       `json:"success"`
	Summary      string     `json:"summary,omitempty"`
	StepCosts    []StepCost `json:"step_costs,omitempty"`
	DurationMs   int64      `json:"duration_ms,omitempty"`
}

type EventWorkflowStart struct {
	WorkflowName string             `json:"workflow_name"`
	TotalSteps   int                `json:"total_steps"`
	Steps        []WorkflowStepInfo `json:"steps,omitempty"`
}

type EventWorkflowStatus struct {
	WorkflowName   string `json:"workflow_name"`
	Status         string `json:"status"`
	StepID         string `json:"step_id,omitempty"`
	Iteration      int    `json:"iteration,omitempty"`
	TokensUsed     int64  `json:"tokens_used,omitempty"`
	TokenBudget    int64  `json:"token_budget,omitempty"`
	ElapsedSeconds int64  `json:"elapsed_seconds,omitempty"`
	Note           string `json:"note,omitempty"`
}

type EventWorkflowStepDone struct {
	StepID              string     `json:"step_id"`
	StepIdx             int        `json:"step_idx"`
	Total               int        `json:"total"`
	Success             bool       `json:"success"`
	TimedOut            bool       `json:"timed_out,omitempty"` // bash step killed by per-step timeout; workflow continues
	Display             string     `json:"display,omitempty"`
	Command             string     `json:"command,omitempty"`     // bash step: resolved command that was run
	BashOutput          string     `json:"bash_output,omitempty"` // bash step: first 5 lines of output
	Model               string     `json:"model,omitempty"`
	InputTokens         int64      `json:"input_tokens,omitempty"`
	OutputTokens        int64      `json:"output_tokens,omitempty"`
	CacheCreationTokens int64      `json:"cache_creation_tokens,omitempty"`
	CacheReadTokens     int64      `json:"cache_read_tokens,omitempty"`
	ToolStats           []ToolStat `json:"tool_stats,omitempty"`
	DurationMs          int64      `json:"duration_ms,omitempty"`
}

type EventWorkflowStepStart struct {
	StepID      string `json:"step_id"`
	StepIdx     int    `json:"step_idx"`
	Total       int    `json:"total"`
	Agent       string `json:"agent"`
	Explanation string `json:"explanation,omitempty"`
}

type EventWorkflowsAvailable struct {
	Workflows []WorkflowInfo `json:"workflows"`
}

type InitState int

type InitStateMsg struct{ State int }

type InstanceRegisterData struct {
	InstanceID string `json:"instance_id,omitempty"`
	Mode       string `json:"mode,omitempty"` // "tui" | "headless"
}

type Plan struct {
	Name         string      `json:"name"`
	Context      string      `json:"context"`
	Architecture string      `json:"architecture,omitempty"`
	Files        []string    `json:"files,omitempty"`
	Risks        string      `json:"risks,omitempty"`
	Tasks        []*PlanTask `json:"tasks"`
	CurrentIdx   int         `json:"current_idx"`
}

type PlanAction struct {
	Type PlanActionType
	Text string // only used for PlanModify
}

type PlanActionType int

type PlanCompleteMsg struct{ Plan *Plan }

type PlanProposedMsg struct{ Plan *Plan }

type PlanTask struct {
	ID          int        `json:"id"`
	Title       string     `json:"title"`
	Description string     `json:"description"`
	Substeps    []string   `json:"substeps,omitempty"`
	Status      TaskStatus `json:"status"`
	Result      string     `json:"result,omitempty"`
}

type PlanTaskDoneMsg struct {
	TaskIdx int
	Title   string
	Success bool
	Summary string
}

type PlanTaskStartMsg struct {
	TaskIdx int
	Title   string
	Total   int
}

type QuestionDef struct {
	ID       string   `json:"id"`
	Category string   `json:"category"`
	Question string   `json:"question"`
	Options  []string `json:"options,omitempty"`
}

type QuitMsg struct{}

type ReplayBlock struct {
	Kind     string         `json:"kind"` // "text" | "thinking" | "tool_use" | "tool_result"
	Text     string         `json:"text,omitempty"`
	ToolID   string         `json:"tool_id,omitempty"`
	ToolName string         `json:"tool_name,omitempty"`
	Input    map[string]any `json:"input,omitempty"`
	Output   string         `json:"output,omitempty"`
	IsError  bool           `json:"is_error,omitempty"`
}

type ReplayMessage struct {
	Role   string        `json:"role"` // "user" | "assistant"
	Blocks []ReplayBlock `json:"blocks"`
}

type SessionCommand struct {
	Type      string          `json:"type"`
	AuthToken string          `json:"auth_token,omitempty"`
	Data      json.RawMessage `json:"data"`
}

type SessionConfirmData struct {
	Approved    bool `json:"approved"`
	PersistDirs bool `json:"persist_dirs,omitempty"` // save approved directories to settings.json
}

type SessionEvent struct {
	Type string `json:"type"`
	Data any    `json:"data"`
}

type SessionInputData struct {
	Text        string       `json:"text"`
	Attachments []Attachment `json:"attachments,omitempty"`
}

type SessionPlanActionData struct {
	Action string `json:"action"` // "approve", "reject", "modify"
	Text   string `json:"text,omitempty"`
}

type SessionSetModelData struct {
	Model string `json:"model"`
}

type SessionStartData struct {
	CWD                            string `json:"cwd"`
	ConfigDir                      string `json:"config_dir,omitempty"`
	Model                          string `json:"model"`
	ForceInit                      bool   `json:"force_init"`
	EnableAutomaticWritePermission bool   `json:"enable_automatic_write_permission"`
	EnableAutomaticDirectoryAccess bool   `json:"enable_automatic_directory_access"`
	Headless                       bool   `json:"headless"`
	// ClientVersion is the vix binary version opening this session. The daemon
	// refuses the session (event.error, code "version_mismatch") when it does
	// not exactly match the daemon's own version — a long-lived daemon must
	// never serve a client from a different build.
	ClientVersion string `json:"client_version,omitempty"`
	// Fork fields: when ForkSessionID is non-empty the new session is seeded
	// with the conversation history of the named session up to and including
	// the turn at ForkTurnIdx (0-based).
	ForkSessionID string `json:"fork_session_id,omitempty"`
	ForkTurnIdx   int    `json:"fork_turn_idx,omitempty"`
	// AttachSessionID, when non-empty, asks the daemon to resume a persisted
	// session by ID instead of creating a fresh one: it loads the on-disk
	// record from open/, reuses that ID, and replays the conversation to the
	// client via event.replay. Records in closed/ are not attachable — an
	// explicitly closed session stays closed. If no open record exists the
	// daemon answers with event.error carrying Code "session_not_found".
	AttachSessionID string `json:"attach_session_id,omitempty"`
}

type SessionSummary struct {
	ID    string `json:"id"`
	CWD   string `json:"cwd"`
	Model string `json:"model"`
	// Title is the session's display title: set by an LLM summarization pass
	// after a few turns (user sessions) or at creation time (job runs). When
	// empty, clients fall back to FirstMessage.
	Title         string `json:"title,omitempty"`
	FirstMessage  string `json:"first_message,omitempty"`
	StartedAt     string `json:"started_at,omitempty"`      // RFC3339
	LastRequestAt string `json:"last_request_at,omitempty"` // RFC3339
	// Attached is true when this session is currently live in the daemon (open
	// in some connection). The launching client uses it to avoid attaching a
	// session another instance already owns (exclusive single-writer ownership).
	Attached bool `json:"attached,omitempty"`
	// Origin distinguishes user-started sessions ("", the default) from
	// vix-initiated ones ("vix" — scheduled job runs, synthetic alerts). The
	// TUI groups the sessions list by it and never auto-claims vix-initiated
	// sessions on launch.
	Origin  string       `json:"origin,omitempty"`
	Trigger *TriggerInfo `json:"trigger,omitempty"`
	// JobStatus carries the finished run's status (ok | error | timeout) for
	// vix-initiated sessions, powering the badge in the sessions list.
	JobStatus string `json:"job_status,omitempty"`
	// Unread reports whether the session holds content the user hasn't seen
	// (session-global, persisted — survives restarts). Cleared via the
	// session.mark_read command when the user views the session.
	Unread bool `json:"unread,omitempty"`
}

type SessionTrimData struct {
	TurnIdx int `json:"turn_idx"` // keep history up to and including this turn (0-based)
}

type SessionUserAnswerData struct {
	Answer  string            `json:"answer"`
	Text    string            `json:"text,omitempty"`    // user input when has_user_input
	Answers map[string]string `json:"answers,omitempty"` // question ID → answer (batch mode)
}

type SessionWorkflowData struct {
	Name string `json:"name"`
	Text string `json:"text"`
}

type SessionWorkflowMessageData struct {
	Text string `json:"text"`
}

type SkillInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type StepCost struct {
	StepID              string  `json:"step_id"`
	Explanation         string  `json:"explanation,omitempty"`
	Model               string  `json:"model"`
	InputTokens         int64   `json:"input_tokens"`
	OutputTokens        int64   `json:"output_tokens"`
	CacheCreationTokens int64   `json:"cache_creation_tokens"`
	CacheReadTokens     int64   `json:"cache_read_tokens"`
	Cost                float64 `json:"cost"`
	DurationMs          int64   `json:"duration_ms,omitempty"`
}

type StreamChunkMsg struct{ Text string }

type StreamDoneMsg struct {
	InputTokens         int64
	OutputTokens        int64
	CacheCreationTokens int64
	CacheReadTokens     int64
	Elapsed             time.Duration
}

type SubagentDoneMsg struct {
	Name   string
	TaskID string
}

type SubagentStartMsg struct {
	Name       string
	Background bool
	TaskID     string
}

type TaskStatus int

type TodoItem struct {
	ID        string     `json:"id"`
	Content   string     `json:"content"`
	Status    TodoStatus `json:"status"`
	DependsOn []string   `json:"depends_on,omitempty"`
}

type TodoStatus string

type ToolCallMsg struct {
	Name    string
	Summary string
}

type ToolResultMsg struct {
	Name    string
	Output  string
	IsError bool
}

type ToolStat struct {
	Name    string `json:"name"`
	Calls   int    `json:"calls"`
	Summary string `json:"summary"`
}

type TriggerInfo struct {
	Type string `json:"type"`
	Ref  string `json:"ref,omitempty"`
}

type WorkflowInfo struct {
	Name string `json:"name"`
}

type WorkflowStepInfo struct {
	ID          string `json:"id"`
	Explanation string `json:"explanation,omitempty"`
}