cli

type AddOptions struct {
	Session          string
	Agents           AgentSpecs
	PluginMap        map[string]plugins.AgentPlugin
	PersonaMap       map[string]*persona.Persona
	CassContextQuery string
	NoCassContext    bool
	Prompt           string
}

type AdoptOptions struct {
	Session   string
	AutoName  bool
	DryRun    bool
	CCPanes   []int
	CodPanes  []int
	GmiPanes  []int
	UserPanes []int
}

type AdoptResult struct {
	Success      bool               `json:"success"`
	Session      string             `json:"session"`
	AdoptedPanes []AdoptedPaneInfo  `json:"adopted_panes"`
	TotalPanes   int                `json:"total_panes"`
	Agents       AdoptedAgentCounts `json:"agents"`
	DryRun       bool               `json:"dry_run"`
	Error        string             `json:"error,omitempty"`
}

type AdoptedAgentCounts struct {
	Claude int `json:"cc"`
	Codex  int `json:"cod"`
	Gemini int `json:"gmi"`
	User   int `json:"user"`
}

type AdoptedPaneInfo struct {
	PaneID    string `json:"pane_id"`
	PaneIndex int    `json:"pane_index"`
	AgentType string `json:"agent_type"`
	OldTitle  string `json:"old_title,omitempty"`
	NewTitle  string `json:"new_title"`
	NTMIndex  int    `json:"ntm_index"`
}

type AgentFilter struct {
	All    bool
	Claude bool
	Codex  bool
	Gemini bool
}

type AgentMailStatus struct {
	Available       bool   `json:"available"`
	RegisteredAgent string `json:"registered_agent,omitempty"`
	LockCount       int    `json:"lock_count"`
	ConflictCount   int    `json:"conflict_count"`
}

type AgentSpawnContext struct {
	SpawnContext
	Order        int           // 1-based position in spawn order (1, 2, 3...)
	StaggerDelay time.Duration // Delay before this agent receives its prompt
}

type AgentSpec struct {
	Type  AgentType
	Count int
	Model string // Optional, empty = use default model
}

type AgentSpecs []AgentSpec

type AgentStats struct {
	Count     int `json:"count"`
	Prompts   int `json:"prompts"`
	CharsSent int `json:"chars_sent"`
	TokensEst int `json:"tokens_estimated"`
}

type AgentType string

type Alert struct {
	Type     string   `json:"type"`
	Severity string   `json:"severity"`
	Message  string   `json:"message"`
	IssueID  string   `json:"issue_id,omitempty"`
	Labels   []string `json:"labels,omitempty"`
}

type AlertsResponse struct {
	Alerts []Alert `json:"alerts"`
}

type AllocationOutput struct {
	Project     string `json:"project"`
	Path        string `json:"path"`
	OpenBeads   int    `json:"open_beads"`
	Tier        int    `json:"tier"`
	CCAgents    int    `json:"cc_agents"`
	CodAgents   int    `json:"cod_agents"`
	GmiAgents   int    `json:"gmi_agents"`
	TotalAgents int    `json:"total_agents"`
}

type AnalyticsStats struct {
	Period         string                `json:"period"`
	TotalSessions  int                   `json:"total_sessions"`
	TotalAgents    int                   `json:"total_agents"`
	TotalPrompts   int                   `json:"total_prompts"`
	TotalCharsSent int                   `json:"total_chars_sent"`
	TotalTokensEst int                   `json:"total_tokens_estimated"`
	AgentBreakdown map[string]AgentStats `json:"agent_breakdown"`
	SessionDetails []SessionSummary      `json:"sessions,omitempty"`
	ErrorCount     int                   `json:"error_count"`
	ErrorTypes     map[string]int        `json:"error_types,omitempty"`
}

type ApprovalResult struct {
	Success  bool   `json:"success"`
	ID       string `json:"id"`
	Action   string `json:"action"`
	Resource string `json:"resource"`
	Status   string `json:"status"`
	Error    string `json:"error,omitempty"`
}

type AssignCommandOptions struct {
	Session         string
	BeadIDs         []string
	Strategy        string
	Limit           int
	AgentTypeFilter string
	Template        string
	TemplateFile    string
	Verbose         bool
	Quiet           bool
	Timeout         time.Duration
	ReserveFiles    bool // Reserve file paths via Agent Mail before assignment

	// Direct pane assignment options
	Pane       int    // Direct pane assignment (-1 = disabled)
	Force      bool   // Force assignment even if pane busy
	IgnoreDeps bool   // Ignore dependency checks
	Prompt     string // Custom prompt for direct assignment

	// Clear assignment options
	Clear     string // Clear specific bead assignments (comma-separated)
	ClearPane int    // Clear all assignments for a pane (-1 = disabled)
}

type AssignEnvelope[T any] struct {
	Command    string       `json:"command"`
	Subcommand string       `json:"subcommand,omitempty"`
	Session    string       `json:"session"`
	Timestamp  string       `json:"timestamp"`
	Success    bool         `json:"success"`
	Data       *T           `json:"data,omitempty"`
	Warnings   []string     `json:"warnings"`
	Error      *AssignError `json:"error,omitempty"`
}

type AssignError struct {
	Code    string                 `json:"code"`
	Message string                 `json:"message"`
	Details map[string]interface{} `json:"details,omitempty"`
}

type AssignOutputEnhanced struct {
	Strategy    string                `json:"strategy"`
	Assignments []AssignmentItem      `json:"assignments"`
	Skipped     []SkippedItem         `json:"skipped"`
	Summary     AssignSummaryEnhanced `json:"summary"`
	Errors      []string              `json:"-"`
}

type AssignSummaryEnhanced struct {
	TotalBeadCount    int `json:"total_bead_count"`
	ActionableCount   int `json:"actionable_count"` // Beads with no blockers
	BlockedCount      int `json:"blocked_count"`    // Beads blocked by dependencies
	AssignedCount     int `json:"assigned_count"`
	SkippedCount      int `json:"skipped_count"`
	IdleAgents        int `json:"idle_agent_count"`
	CycleWarningCount int `json:"cycle_warning_count,omitempty"` // Beads in dependency cycles
}

type AssignmentItem struct {
	BeadID     string  `json:"bead_id"`
	BeadTitle  string  `json:"bead_title"`
	Pane       int     `json:"pane"`
	AgentType  string  `json:"agent_type"`
	AgentName  string  `json:"agent_name"`
	Status     string  `json:"status"`      // assigned|working|completed|failed
	PromptSent bool    `json:"prompt_sent"` // Whether prompt was sent
	AssignedAt string  `json:"assigned_at"` // ISO8601 timestamp
	Score      float64 `json:"score,omitempty"`
	Reasoning  string  `json:"-"`
}

type AtRiskItem struct {
	ID      string   `json:"id"`
	Title   string   `json:"title"`
	Risk    string   `json:"risk"` // behind_schedule, blocked, scope_creep
	Reasons []string `json:"reasons"`
}

type AutoReassignOptions struct {
	Session         string
	Strategy        string
	Template        string
	TemplateFile    string
	ReserveFiles    bool
	Verbose         bool
	Quiet           bool
	Timeout         time.Duration
	AgentTypeFilter string
}

type AutoReassignResult struct {
	TriggerBeadID  string           `json:"trigger_bead_id"`
	NewlyUnblocked []UnblockedBead  `json:"newly_unblocked"`
	Assignments    []AssignmentItem `json:"assignments"`
	Skipped        []SkippedItem    `json:"skipped"`
	IdleAgents     int              `json:"idle_agents"`
	Errors         []string         `json:"errors,omitempty"`
	CyclesDetected [][]string       `json:"cycles_detected,omitempty"`
	CompletionTime time.Time        `json:"completion_time"`
}

type AutomationResponse struct {
	output.TimestampedResponse
	AutoCommit   bool   `json:"auto_commit"`
	AutoPush     bool   `json:"auto_push"`
	ForceRelease string `json:"force_release"`
	Modified     bool   `json:"modified,omitempty"`
}

type BatchPrompt struct {
	Text   string
	Source string
}

type BatchPromptResult struct {
	Index         int    `json:"index"`
	PromptPreview string `json:"prompt_preview"`
	Success       bool   `json:"success"`
	Targets       []int  `json:"targets,omitempty"`
	Delivered     int    `json:"delivered"`
	Error         string `json:"error,omitempty"`
	Skipped       bool   `json:"skipped,omitempty"`
}

type BatchResult struct {
	Success   bool                `json:"success"`
	Session   string              `json:"session"`
	Total     int                 `json:"batch_total"`
	Delivered int                 `json:"batch_delivered"`
	Failed    int                 `json:"batch_failed"`
	Skipped   int                 `json:"batch_skipped"`
	Results   []BatchPromptResult `json:"results"`
	Error     string              `json:"error,omitempty"`
}

type BeadEvent struct {
	Timestamp time.Time `json:"timestamp"`
	Event     string    `json:"event"`
	Status    string    `json:"status,omitempty"`
}

type BeadHistory struct {
	ID         string      `json:"id"`
	Title      string      `json:"title"`
	Events     []BeadEvent `json:"events"`
	Commits    []string    `json:"commits"`
	Milestones []string    `json:"milestones"`
}

type BlockedResponse struct {
	output.TimestampedResponse
	Entries []policy.BlockedEntry `json:"entries"`
	Count   int                   `json:"count"`
}

type BurndownProgress struct {
	TotalPoints     int     `json:"total_points"`
	CompletedPoints int     `json:"completed_points"`
	PercentComplete float64 `json:"percent_complete"`
	DaysRemaining   int     `json:"days_remaining"`
}

type BurndownResponse struct {
	Sprint       string           `json:"sprint"`
	Progress     BurndownProgress `json:"progress"`
	ScopeChanges []ScopeChange    `json:"scope_changes,omitempty"`
	AtRisk       []AtRiskItem     `json:"at_risk,omitempty"`
}

type CheckDCGVerdict struct {
	Available bool   `json:"available"`
	Checked   bool   `json:"checked"`
	Blocked   bool   `json:"blocked"`
	Reason    string `json:"reason,omitempty"`
	Error     string `json:"error,omitempty"`
}

type CheckPolicyVerdict struct {
	Action  string `json:"action"` // allow, block, approve
	Pattern string `json:"pattern,omitempty"`
	Reason  string `json:"reason,omitempty"`
	SLB     bool   `json:"slb,omitempty"` // Requires SLB two-person approval
}

type CheckResponse struct {
	output.TimestampedResponse
	Command string `json:"command"`
	Action  string `json:"action"` // allow, block, approve
	Pattern string `json:"pattern,omitempty"`
	Reason  string `json:"reason,omitempty"`

	Policy *CheckPolicyVerdict `json:"policy,omitempty"`
	DCG    *CheckDCGVerdict    `json:"dcg,omitempty"`
}

type CleanupStats struct {
	TotalFiles   int
	TotalSize    int64
	DeletedFiles int
	DeletedSize  int64
	Errors       int
}

type ClearAllResult struct {
	Pane         int                     `json:"pane"`
	AgentType    string                  `json:"agent_type"`
	Success      bool                    `json:"success"`
	Error        string                  `json:"error,omitempty"`
	ClearedBeads []ClearAssignmentResult `json:"cleared_beads"`
}

type ClearAssignmentResult struct {
	BeadID                   string   `json:"bead_id"`
	BeadTitle                string   `json:"bead_title,omitempty"`
	PreviousPane             int      `json:"previous_pane,omitempty"`
	PreviousAgent            string   `json:"previous_agent,omitempty"`
	PreviousAgentType        string   `json:"previous_agent_type,omitempty"`
	PreviousStatus           string   `json:"previous_status,omitempty"`
	AssignmentFound          bool     `json:"assignment_found"`
	FileReservationsReleased bool     `json:"file_reservations_released"`
	FilesReleased            []string `json:"files_released,omitempty"`
	Success                  bool     `json:"success"`
	Error                    string   `json:"error,omitempty"`
	ErrorCode                string   `json:"error_code,omitempty"`
}

type ClearAssignmentsData struct {
	Cleared   []ClearAssignmentResult `json:"cleared"`
	Summary   ClearAssignmentsSummary `json:"summary"`
	Pane      *int                    `json:"pane,omitempty"`
	AgentType string                  `json:"agent_type,omitempty"`
}

type ClearAssignmentsEnvelope struct {
	Command    string                 `json:"command"`
	Subcommand string                 `json:"subcommand"`
	Session    string                 `json:"session"`
	Timestamp  string                 `json:"timestamp"`
	Success    bool                   `json:"success"`
	Data       *ClearAssignmentsData  `json:"data,omitempty"`
	Warnings   []string               `json:"warnings"`
	Error      *ClearAssignmentsError `json:"error,omitempty"`
}

type ClearAssignmentsError struct {
	Code    string                 `json:"code"`
	Message string                 `json:"message"`
	Details map[string]interface{} `json:"details,omitempty"`
}

type ClearAssignmentsSummary struct {
	ClearedCount         int `json:"cleared_count"`
	ReservationsReleased int `json:"reservations_released"`
	FailedCount          int `json:"failed_count,omitempty"`
}

type CommitInfo struct {
	Hash      string    `json:"hash"`
	Timestamp time.Time `json:"timestamp"`
	Message   string    `json:"message"`
	Beads     []string  `json:"beads,omitempty"`
}

type ConfigCheck struct {
	Name    string `json:"name"`
	Valid   bool   `json:"valid"`
	Status  string `json:"status"`
	Message string `json:"message,omitempty"`
}

type ConfigLocation struct {
	Path   string
	Type   string
	Exists bool
}

type ConfirmRotationResult struct {
	AgentID string `json:"agent_id"`
	Action  string `json:"action"`
	Success bool   `json:"success"`
	Message string `json:"message"`
}

type ControllerInput struct {
	Session    string `json:"session"`
	AgentType  string `json:"agent_type,omitempty"`
	PromptFile string `json:"prompt_file,omitempty"`
	NoPrompt   bool   `json:"no_prompt,omitempty"`
}

type ControllerResponse struct {
	output.TimestampedResponse
	Session    string `json:"session"`
	PaneID     string `json:"pane_id"`
	PaneIndex  int    `json:"pane_index"`
	AgentType  string `json:"agent_type"`
	PromptUsed string `json:"prompt_used,omitempty"`
	AgentCount int    `json:"agent_count"`
	AgentList  string `json:"agent_list,omitempty"`
}

type CopyOptions struct {
	Last     int
	Pattern  string
	Code     bool
	Headers  bool
	Output   string
	Quiet    bool
	PaneSpec string
}

type DaemonCheck struct {
	Name    string `json:"name"`
	Running bool   `json:"running"`
	Port    int    `json:"port,omitempty"`
	PID     int    `json:"pid,omitempty"`
	Status  string `json:"status"`
	Message string `json:"message,omitempty"`
}

type DepCheck struct {
	Name       string `json:"name"`
	Installed  bool   `json:"installed"`
	Version    string `json:"version,omitempty"`
	MinVersion string `json:"min_version,omitempty"`
	Status     string `json:"status"`
	Message    string `json:"message,omitempty"`
}

type DependencyAwareResult struct {
	CompletedBeadID string          `json:"completed_bead_id"`
	NewlyUnblocked  []UnblockedBead `json:"newly_unblocked"`
	CyclesDetected  [][]string      `json:"cycles_detected,omitempty"`
	Errors          []string        `json:"errors,omitempty"`
}

type DepsInput struct {
	Verbose bool `json:"verbose,omitempty"`
}

type DirectAssignData struct {
	Assignment       *DirectAssignItem             `json:"assignment"`
	FileReservations *DirectAssignFileReservations `json:"file_reservations,omitempty"`
}

type DirectAssignFileReservations struct {
	Requested []string `json:"requested"`
	Granted   []string `json:"granted"`
	Denied    []string `json:"denied"`
}

type DirectAssignItem struct {
	BeadID       string   `json:"bead_id"`
	BeadTitle    string   `json:"bead_title"`
	Pane         int      `json:"pane"`
	AgentType    string   `json:"agent_type"`
	Status       string   `json:"status"`
	Prompt       string   `json:"prompt"`
	PromptSent   bool     `json:"prompt_sent"`
	AssignedAt   string   `json:"assigned_at"`
	PaneWasBusy  bool     `json:"pane_was_busy,omitempty"`
	DepsIgnored  bool     `json:"deps_ignored,omitempty"`
	BlockedByIDs []string `json:"blocked_by_ids,omitempty"`
}

type DirectAssignResult struct {
	BeadID         string                        `json:"bead_id"`
	BeadTitle      string                        `json:"bead_title,omitempty"`
	Pane           int                           `json:"pane"`
	AgentType      string                        `json:"agent_type"`
	AgentName      string                        `json:"agent_name,omitempty"`
	PromptSent     string                        `json:"prompt_sent"`
	Success        bool                          `json:"success"`
	Error          string                        `json:"error,omitempty"`
	Reservations   *assign.FileReservationResult `json:"reservations,omitempty"`
	PaneWasBusy    bool                          `json:"pane_was_busy,omitempty"`
	DepsIgnored    bool                          `json:"deps_ignored,omitempty"`
	BlockedByBeads []string                      `json:"blocked_by_beads,omitempty"`
}

type DoctorReport struct {
	Timestamp     time.Time        `json:"timestamp"`
	Overall       string           `json:"overall"` // "healthy", "warning", "unhealthy"
	Tools         []ToolCheck      `json:"tools"`
	Dependencies  []DepCheck       `json:"dependencies"`
	Daemons       []DaemonCheck    `json:"daemons"`
	Configuration []ConfigCheck    `json:"configuration"`
	Invariants    []InvariantCheck `json:"invariants"`
	Warnings      int              `json:"warnings"`
	Errors        int              `json:"errors"`
}

type ErrorEntry struct {
	Timestamp time.Time `json:"timestamp"`
	Session   string    `json:"session"`
	Pane      string    `json:"pane"`
	PaneIndex int       `json:"pane_index"`
	Line      int       `json:"line"`
	Content   string    `json:"content"`
	MatchType string    `json:"match_type"`
	Context   []string  `json:"context,omitempty"`
	AgentType string    `json:"agent_type,omitempty"`
}

type ErrorsOptions struct {
	Since        time.Duration
	Panes        []int
	ContextLines int
	MaxLines     int
	Follow       bool
	Filter       AgentFilter
}

type ErrorsResult struct {
	Session     string       `json:"session"`
	Errors      []ErrorEntry `json:"errors"`
	TotalErrors int          `json:"total_errors"`
	TotalLines  int          `json:"total_lines_searched"`
	PaneCount   int          `json:"panes_searched"`
	Timestamp   time.Time    `json:"timestamp"`
}

type ExtractResponse struct {
	output.TimestampedResponse
	Session    string                `json:"session"`
	Source     string                `json:"source"` // Session or session:pane
	Blocks     []codeblock.CodeBlock `json:"blocks"`
	TotalFound int                   `json:"total_found"`
}

type FlatAgent struct {
	Type  AgentType
	Index int    // 1-based index within type
	Model string // Resolved model (may be empty for default)
}

type ForceReleaseResult struct {
	Success        bool       `json:"success"`
	Session        string     `json:"session"`
	Agent          string     `json:"agent"`
	ReservationID  int        `json:"reservation_id"`
	PreviousHolder string     `json:"previous_holder,omitempty"`
	PathPattern    string     `json:"path_pattern,omitempty"`
	ReleasedAt     *time.Time `json:"released_at,omitempty"`
	Notified       bool       `json:"notified,omitempty"`
	Error          string     `json:"error,omitempty"`
}

type ForecastItem struct {
	ID              string    `json:"id"`
	Title           string    `json:"title"`
	EstimatedETA    time.Time `json:"estimated_eta"`
	ConfidenceLevel float64   `json:"confidence_level"`
	DependencyCount int       `json:"dependency_count"`
	CriticalPath    bool      `json:"critical_path"`
	BlockingFactors []string  `json:"blocking_factors,omitempty"`
}

type ForecastResponse struct {
	Forecasts []ForecastItem `json:"forecasts"`
}

type GitHubAsset struct {
	Name               string `json:"name"`
	Size               int64  `json:"size"`
	BrowserDownloadURL string `json:"browser_download_url"`
	ContentType        string `json:"content_type"`
}

type GitHubRelease struct {
	TagName     string        `json:"tag_name"`
	Name        string        `json:"name"`
	Draft       bool          `json:"draft"`
	Prerelease  bool          `json:"prerelease"`
	PublishedAt time.Time     `json:"published_at"`
	Body        string        `json:"body"`
	Assets      []GitHubAsset `json:"assets"`
	HTMLURL     string        `json:"html_url"`
}

type GitInfo struct {
	Branch          string   `json:"branch"`
	Commit          string   `json:"commit"`
	CommitShort     string   `json:"commit_short"`
	Dirty           bool     `json:"dirty"`
	Ahead           int      `json:"ahead"`
	Behind          int      `json:"behind"`
	StagedFiles     []string `json:"staged_files,omitempty"`
	ModifiedFiles   []string `json:"modified_files,omitempty"`
	UntrackedFiles  []string `json:"untracked_files,omitempty"`
	ConflictedFiles []string `json:"conflicted_files,omitempty"`
}

type GitStatusResult struct {
	Success      bool                        `json:"success"`
	Session      string                      `json:"session,omitempty"`
	WorkingDir   string                      `json:"working_dir"`
	Git          *GitInfo                    `json:"git,omitempty"`
	Reservations []agentmail.InboxMessage    `json:"reservations,omitempty"`
	Locks        []agentmail.FileReservation `json:"locks,omitempty"`
	AgentMail    *AgentMailStatus            `json:"agent_mail,omitempty"`
	Error        string                      `json:"error,omitempty"`
}

type GitSyncResult struct {
	Success     bool        `json:"success"`
	Session     string      `json:"session,omitempty"`
	WorkingDir  string      `json:"working_dir"`
	PullResult  *PullResult `json:"pull_result,omitempty"`
	PushResult  *PushResult `json:"push_result,omitempty"`
	HasConflict bool        `json:"has_conflict"`
	Error       string      `json:"error,omitempty"`
}

type GraphResponse struct {
	Format string      `json:"format"`
	Data   interface{} `json:"data"`
}

type GrepMatch struct {
	Session string   `json:"session"`
	Pane    string   `json:"pane"`
	PaneID  string   `json:"pane_id"`
	Line    int      `json:"line"`
	Content string   `json:"content"`
	Context []string `json:"context,omitempty"`
	// ContextBefore/After track how many lines in Context are before/after the match.
	// This avoids assuming a symmetric split when only -A or -B is provided.
	ContextBefore int `json:"context_before,omitempty"`
	ContextAfter  int `json:"context_after,omitempty"`
}

type GrepOptions struct {
	AllSessions     bool
	CaseInsensitive bool
	InvertMatch     bool
	ContextLines    int
	AfterLines      int
	BeforeLines     int
	MaxLines        int
	ListOnly        bool
	Filter          AgentFilter
}

type GrepResult struct {
	Pattern         string      `json:"pattern"`
	Session         string      `json:"session"`
	Matches         []GrepMatch `json:"matches"`
	TotalLines      int         `json:"total_lines_searched"`
	MatchCount      int         `json:"match_count"`
	PaneCount       int         `json:"panes_searched"`
	CaseInsensitive bool        `json:"case_insensitive,omitempty"`
}

type GuardsInstallResponse struct {
	output.TimestampedResponse
	Success    bool   `json:"success"`
	RepoPath   string `json:"repo_path"`
	ProjectKey string `json:"project_key"`
	HookPath   string `json:"hook_path"`
	Message    string `json:"message,omitempty"`
}

type GuardsStatusResponse struct {
	output.TimestampedResponse
	Installed    bool   `json:"installed"`
	RepoPath     string `json:"repo_path"`
	HookPath     string `json:"hook_path"`
	ProjectKey   string `json:"project_key,omitempty"`
	IsNTMGuard   bool   `json:"is_ntm_guard"`
	OtherHook    bool   `json:"other_hook"`
	MCPAvailable bool   `json:"mcp_available"`
}

type GuardsUninstallResponse struct {
	output.TimestampedResponse
	Success  bool   `json:"success"`
	RepoPath string `json:"repo_path"`
	HookPath string `json:"hook_path"`
	Message  string `json:"message,omitempty"`
}

type HealthOutput struct {
	*health.SessionHealth
	Error string `json:"error,omitempty"`
}

type HistoryListEntry struct {
	ID         string    `json:"id"`
	Timestamp  time.Time `json:"ts"`
	Session    string    `json:"session"`
	Targets    []string  `json:"targets"`
	Prompt     string    `json:"prompt"`
	Source     string    `json:"source"`
	Template   string    `json:"template,omitempty"`
	Success    bool      `json:"success"`
	Error      string    `json:"error,omitempty"`
	DurationMs int       `json:"duration_ms,omitempty"`
}

type HistoryListResult struct {
	Entries    []history.HistoryEntry `json:"entries"`
	TotalCount int                    `json:"total_count"`
	Showing    int                    `json:"showing"`
}

type HistoryResponse struct {
	Stats       HistoryStats          `json:"stats"`
	Histories   []BeadHistory         `json:"histories"`
	CommitIndex map[string]CommitInfo `json:"commit_index"`
}

type HistoryShowResult struct {
	Entry *history.HistoryEntry `json:"entry"`
}

type HistoryStats struct {
	TotalBeads      int `json:"total_beads"`
	TotalCommits    int `json:"total_commits"`
	CorrelatedCount int `json:"correlated_count"`
}

type ImpactResponse struct {
	Files       []ImpactResult `json:"files"`
	TotalBeads  int            `json:"total_beads"`
	UniqueBeads int            `json:"unique_beads"`
}

type ImpactResult struct {
	File         string   `json:"file"`
	ImpactedIDs  []string `json:"impacted_ids"`
	TotalImpact  int      `json:"total_impact"`
	DirectImpact int      `json:"direct_impact"`
}

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

type InvariantCheck struct {
	ID      string   `json:"id"`
	Name    string   `json:"name"`
	Status  string   `json:"status"` // "ok", "warning", "error"
	Message string   `json:"message,omitempty"`
	Details []string `json:"details,omitempty"`
}

type LabelDependency struct {
	From   string  `json:"from"`
	To     string  `json:"to"`
	Count  int     `json:"count"`
	Weight float64 `json:"weight"`
}

type LabelFlowResponse struct {
	FlowMatrix       map[string]map[string]int `json:"flow_matrix"`
	Dependencies     []LabelDependency         `json:"dependencies"`
	BottleneckLabels []string                  `json:"bottleneck_labels"`
}

type LabelHealth struct {
	Label         string  `json:"label"`
	HealthLevel   string  `json:"health_level"` // healthy, warning, critical
	VelocityScore float64 `json:"velocity_score"`
	Staleness     float64 `json:"staleness"`
	BlockedCount  int     `json:"blocked_count"`
}

type LabelHealthResponse struct {
	Results LabelHealthResults `json:"results"`
}

type LabelHealthResults struct {
	Labels []LabelHealth `json:"labels"`
}

type LockResult struct {
	Success   bool                            `json:"success"`
	Session   string                          `json:"session"`
	Agent     string                          `json:"agent"`
	Granted   []agentmail.FileReservation     `json:"granted,omitempty"`
	Conflicts []agentmail.ReservationConflict `json:"conflicts,omitempty"`
	TTL       string                          `json:"ttl"`
	ExpiresAt *time.Time                      `json:"expires_at,omitempty"`
	Error     string                          `json:"error,omitempty"`
}

type LocksResult struct {
	Success      bool                        `json:"success"`
	Session      string                      `json:"session"`
	Agent        string                      `json:"agent,omitempty"`
	ProjectKey   string                      `json:"project_key"`
	Reservations []agentmail.FileReservation `json:"reservations"`
	Count        int                         `json:"count"`
	Error        string                      `json:"error,omitempty"`
}

type OpenAPIGenerateInput struct {
	Output    string `json:"output"`
	Version   string `json:"version"`
	ServerURL string `json:"server_url"`
	Stdout    bool   `json:"stdout"`
}

type OpenAPIGenerateResponse struct {
	Success    bool   `json:"success"`
	OutputPath string `json:"output_path,omitempty"`
	Message    string `json:"message,omitempty"`
}

type PaneOutput struct {
	Index     int    `json:"index"`
	Project   string `json:"project"`
	AgentType string `json:"agent_type"`
}

type PendingRotationInfo struct {
	AgentID        string  `json:"agent_id"`
	SessionName    string  `json:"session_name"`
	ContextPercent float64 `json:"context_percent"`
	TimeoutSeconds int     `json:"timeout_seconds"`
	DefaultAction  string  `json:"default_action"`
	CreatedAt      string  `json:"created_at"`
}

type PendingRotationsResult struct {
	Pending []PendingRotationInfo `json:"pending"`
	Count   int                   `json:"count"`
}

type PersonaAgentInfo struct {
	PersonaName string
	AgentType   AgentType
	Model       string
	Index       int
}

type PersonaSpec struct {
	Name  string
	Count int // Default 1
}

type PersonaSpecs []PersonaSpec

type PolicyRulesDetail struct {
	Blocked          []RuleSummary `json:"blocked,omitempty"`
	ApprovalRequired []RuleSummary `json:"approval_required,omitempty"`
	Allowed          []RuleSummary `json:"allowed,omitempty"`
}

type PolicyShowResponse struct {
	output.TimestampedResponse
	Version    int                     `json:"version"`
	PolicyPath string                  `json:"policy_path,omitempty"`
	IsDefault  bool                    `json:"is_default"`
	Stats      PolicyStats             `json:"stats"`
	Automation policy.AutomationConfig `json:"automation"`
	Rules      *PolicyRulesDetail      `json:"rules,omitempty"`
}

type PolicyStats struct {
	Blocked  int `json:"blocked"`
	Approval int `json:"approval"`
	Allowed  int `json:"allowed"`
	SLBRules int `json:"slb_rules"`
}

type PolicyValidateResponse struct {
	output.TimestampedResponse
	Valid      bool     `json:"valid"`
	PolicyPath string   `json:"policy_path"`
	Errors     []string `json:"errors,omitempty"`
	Warnings   []string `json:"warnings,omitempty"`
}

type PreflightFinding struct {
	ID       string         `json:"id"`
	Severity string         `json:"severity"`
	Message  string         `json:"message"`
	Help     string         `json:"help"`
	Metadata map[string]any `json:"metadata,omitempty"`
	Start    int            `json:"start,omitempty"`
	End      int            `json:"end,omitempty"`
	Line     int            `json:"line,omitempty"`
}

type PreflightInput struct {
	Prompt string `json:"prompt"`
	Strict bool   `json:"strict,omitempty"`
}

type PreflightResult struct {
	robot.RobotResponse

	// Core results
	PreviewHash     string             `json:"preview_hash"`
	PreviewLen      int                `json:"preview_len"`
	EstimatedTokens int                `json:"estimated_tokens"`
	Findings        []PreflightFinding `json:"findings"`

	// Summary counts
	ErrorCount   int `json:"error_count"`
	WarningCount int `json:"warning_count"`
	InfoCount    int `json:"info_count"`

	// Prompt preview (truncated if long)
	Preview string `json:"preview,omitempty"`

	// DCG integration status
	DCGAvailable bool `json:"dcg_available"`
}

type ProfileSwitchResult struct {
	Success    bool   `json:"success"`
	AgentID    string `json:"agent_id"`
	PaneID     string `json:"pane_id"`
	OldProfile string `json:"old_profile,omitempty"`
	NewProfile string `json:"new_profile"`
	Message    string `json:"message,omitempty"`
	Error      string `json:"error,omitempty"`
}

type ProjectType int

type PromptStatus struct {
	// Pane is the pane title (e.g., "proj__cc_1")
	Pane string `json:"pane"`

	// PaneID is the tmux pane ID for reliable lookup
	PaneID string `json:"pane_id"`

	// Order is the 1-based spawn order
	Order int `json:"order"`

	// ScheduledAt is when the prompt is scheduled to be sent
	ScheduledAt time.Time `json:"scheduled"`

	// Sent indicates whether the prompt has been delivered
	Sent bool `json:"sent"`

	// SentAt is when the prompt was actually sent (zero if not sent)
	SentAt time.Time `json:"sent_at,omitempty"`
}

type PullResult struct {
	Success         bool     `json:"success"`
	FastForward     bool     `json:"fast_forward"`
	Behind          int      `json:"behind"`
	Merged          int      `json:"merged"`
	Files           []string `json:"files,omitempty"`
	Conflicts       []string `json:"conflicts,omitempty"`
	Error           string   `json:"error,omitempty"`
	AlreadyUpToDate bool     `json:"already_up_to_date"`
}

type PushResult struct {
	Success       bool   `json:"success"`
	Ahead         int    `json:"ahead"`
	Pushed        int    `json:"pushed"`
	Remote        string `json:"remote"`
	Branch        string `json:"branch"`
	Error         string `json:"error,omitempty"`
	NothingToPush bool   `json:"nothing_to_push"`
}

type ReassignData struct {
	BeadID                       string `json:"bead_id"`
	BeadTitle                    string `json:"bead_title"`
	Pane                         int    `json:"pane"`
	AgentType                    string `json:"agent_type"`
	AgentName                    string `json:"agent_name,omitempty"`
	Status                       string `json:"status"`
	PromptSent                   bool   `json:"prompt_sent"`
	AssignedAt                   string `json:"assigned_at"`
	PreviousPane                 int    `json:"previous_pane"`
	PreviousAgent                string `json:"previous_agent,omitempty"`
	PreviousAgentType            string `json:"previous_agent_type"`
	PreviousStatus               string `json:"previous_status"`
	FileReservationsTransferred  bool   `json:"file_reservations_transferred"`
	FileReservationsReleasedFrom int    `json:"file_reservations_released_from,omitempty"`
	FileReservationsCreatedFor   int    `json:"file_reservations_created_for,omitempty"`
}

type ReassignEnvelope struct {
	Command    string         `json:"command"`
	Subcommand string         `json:"subcommand"`
	Session    string         `json:"session"`
	Timestamp  string         `json:"timestamp"`
	Success    bool           `json:"success"`
	Data       *ReassignData  `json:"data,omitempty"`
	Warnings   []string       `json:"warnings"`
	Error      *ReassignError `json:"error,omitempty"`
}

type ReassignError struct {
	Code    string                 `json:"code"`
	Message string                 `json:"message"`
	Details map[string]interface{} `json:"details,omitempty"`
}

type RecipeInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Source      string `json:"source"`
	TotalAgents int    `json:"total_agents"`
}

type RecipeShowResult struct {
	Name        string             `json:"name"`
	Description string             `json:"description"`
	Source      string             `json:"source"`
	TotalAgents int                `json:"total_agents"`
	Agents      []recipe.AgentSpec `json:"agents"`
}

type RecipesListResult struct {
	Recipes []RecipeInfo `json:"recipes"`
	Total   int          `json:"total"`
}

type RecoveryAssignmentSummary struct {
	Total      int `json:"total"`
	Assigned   int `json:"assigned,omitempty"`
	Working    int `json:"working,omitempty"`
	Completed  int `json:"completed,omitempty"`
	Failed     int `json:"failed,omitempty"`
	Reassigned int `json:"reassigned,omitempty"`
}

type RecoveryBVSummary struct {
	OpenCount       int       `json:"open_count"`
	ActionableCount int       `json:"actionable_count"`
	BlockedCount    int       `json:"blocked_count"`
	InProgressCount int       `json:"in_progress_count"`
	TopPicks        []string  `json:"top_picks,omitempty"`
	CapturedAt      time.Time `json:"captured_at"`
}

type RecoveryBead struct {
	ID       string `json:"id"`
	Title    string `json:"title"`
	Assignee string `json:"assignee,omitempty"`
}

type RecoveryCMMemories struct {
	Rules        []RecoveryCMRule `json:"rules,omitempty"`
	AntiPatterns []RecoveryCMRule `json:"anti_patterns,omitempty"`
}

type RecoveryCMRule struct {
	ID       string `json:"id"`
	Content  string `json:"content"`
	Category string `json:"category,omitempty"`
}

type RecoveryCheckpoint struct {
	ID          string                     `json:"id"`
	Name        string                     `json:"name"`
	Description string                     `json:"description"`
	CreatedAt   time.Time                  `json:"created_at"`
	PaneCount   int                        `json:"pane_count"`
	HasGitPatch bool                       `json:"has_git_patch"`
	Assignments *RecoveryAssignmentSummary `json:"assignments_summary,omitempty"`
	BVSummary   *RecoveryBVSummary         `json:"bv_summary,omitempty"`
}

type RecoveryContext struct {
	// Checkpoint contains checkpoint info for recovery
	Checkpoint *RecoveryCheckpoint `json:"checkpoint,omitempty"`
	// Beads contains in-progress beads from BV
	Beads []RecoveryBead `json:"beads,omitempty"`
	// CompletedBeads contains recently completed beads for context
	CompletedBeads []RecoveryBead `json:"completed_beads,omitempty"`
	// BlockedBeads contains blocked beads for awareness
	BlockedBeads []RecoveryBead `json:"blocked_beads,omitempty"`
	// Messages contains recent Agent Mail messages
	Messages []RecoveryMessage `json:"messages,omitempty"`
	// CMMemories contains procedural memories from CM
	CMMemories *RecoveryCMMemories `json:"cm_memories,omitempty"`
	// FileReservations contains files currently reserved by this session
	FileReservations []string `json:"file_reservations,omitempty"`
	// ReservationTransfer contains results from attempting to transfer reservations
	ReservationTransfer *handoff.ReservationTransferResult `json:"reservation_transfer,omitempty"`
	// Sessions contains past sessions for recovery context
	Sessions []RecoverySession `json:"sessions,omitempty"`
	// Summary is a human-readable summary of the recovery context
	Summary string `json:"summary,omitempty"`
	// TokenCount is an estimate of the total token count
	TokenCount int `json:"token_count,omitempty"`
	// Error contains error info if recovery was partial
	Error *RecoveryError `json:"error,omitempty"`
}

type RecoveryError struct {
	Code        string   `json:"code"`
	Message     string   `json:"message"`
	Component   string   `json:"component"` // Which component failed
	Recoverable bool     `json:"recoverable"`
	Details     []string `json:"details,omitempty"`
}

type RecoveryMessage struct {
	ID         int       `json:"id"`
	From       string    `json:"from"`
	Subject    string    `json:"subject"`
	Body       string    `json:"body,omitempty"`
	Importance string    `json:"importance,omitempty"`
	CreatedAt  time.Time `json:"created_at"`
}

type RecoverySession struct {
	Name      string    `json:"name"`
	CreatedAt time.Time `json:"created_at"`
	AgentType string    `json:"agent_type"`
}

type RedactionSummary struct {
	Mode       string         `json:"mode"`
	Findings   int            `json:"findings"`
	Categories map[string]int `json:"categories,omitempty"`
	Action     string         `json:"action,omitempty"` // warn|redact|block
}

type RenewResult struct {
	Success       bool   `json:"success"`
	Session       string `json:"session"`
	Agent         string `json:"agent"`
	ExtendMinutes int    `json:"extend_minutes"`
	Error         string `json:"error,omitempty"`
}

type ResolvedPersonaAgent struct {
	Persona *persona.Persona
	Type    AgentType
	Model   string
	Index   int // 1-based index within this persona
}

type ResumeHandoffInfo struct {
	Path       string            `json:"path"`
	Session    string            `json:"session"`
	Goal       string            `json:"goal"`
	Now        string            `json:"now"`
	Status     string            `json:"status"`
	Outcome    string            `json:"outcome,omitempty"`
	Decisions  map[string]string `json:"decisions,omitempty"`
	Next       []string          `json:"next,omitempty"`
	Blockers   []string          `json:"blockers,omitempty"`
	AgeSeconds int64             `json:"age_seconds"`
	FileCount  int               `json:"file_count"`
}

type ResumeInjectInfo struct {
	Session     string `json:"session"`
	PanesSent   int    `json:"panes_sent"`
	PanesFailed int    `json:"panes_failed"`
}

type ResumeResult struct {
	Success    bool               `json:"success"`
	Action     string             `json:"action"` // display, spawn, inject
	Handoff    *ResumeHandoffInfo `json:"handoff,omitempty"`
	SpawnInfo  *ResumeSpawnInfo   `json:"spawn_info,omitempty"`
	InjectInfo *ResumeInjectInfo  `json:"inject_info,omitempty"`
	Error      string             `json:"error,omitempty"`
}

type ResumeSpawnInfo struct {
	Session   string   `json:"session"`
	PaneCount int      `json:"pane_count"`
	PaneIDs   []string `json:"pane_ids,omitempty"`
}

type RetryData struct {
	Retried []RetryItem        `json:"retried"`
	Skipped []RetrySkippedItem `json:"skipped"`
	Summary RetrySummary       `json:"summary"`
}

type RetryItem struct {
	BeadID             string `json:"bead_id"`
	BeadTitle          string `json:"bead_title"`
	Pane               int    `json:"pane"`
	AgentType          string `json:"agent_type"`
	AgentName          string `json:"agent_name,omitempty"`
	Status             string `json:"status"`
	PromptSent         bool   `json:"prompt_sent"`
	AssignedAt         string `json:"assigned_at"`
	PreviousPane       int    `json:"previous_pane"`
	PreviousAgent      string `json:"previous_agent,omitempty"`
	PreviousFailReason string `json:"previous_fail_reason,omitempty"`
	RetryCount         int    `json:"retry_count"`
}

type RetrySkippedItem struct {
	BeadID string `json:"bead_id"`
	Reason string `json:"reason"`
}

type RetrySummary struct {
	TotalFailed  int `json:"total_failed"`
	RetriedCount int `json:"retried_count"`
	SkippedCount int `json:"skipped_count"`
}

type RotationHistoryResult struct {
	Records    []ctxmon.RotationRecord `json:"records"`
	TotalCount int                     `json:"total_count"`
	Showing    int                     `json:"showing"`
}

type RotationStatsResult struct {
	*ctxmon.RotationStats
}

type RuleSummary struct {
	Pattern string `json:"pattern"`
	Reason  string `json:"reason,omitempty"`
	SLB     bool   `json:"slb,omitempty"`
}

type SafetyStatusResponse struct {
	output.TimestampedResponse
	Installed     bool   `json:"installed"`
	PolicyPath    string `json:"policy_path,omitempty"`
	BlockedCount  int    `json:"blocked_rules"`
	ApprovalCount int    `json:"approval_rules"`
	AllowedCount  int    `json:"allowed_rules"`
	WrapperPath   string `json:"wrapper_path,omitempty"`
	HookInstalled bool   `json:"hook_installed"`
}

type ScopeChange struct {
	Timestamp time.Time `json:"timestamp"`
	Action    string    `json:"action"` // added, removed, modified
	IssueID   string    `json:"issue_id"`
	Points    int       `json:"points"`
}

type SearchResponse struct {
	Query   string         `json:"query"`
	Results []SearchResult `json:"results"`
}

type SearchResult struct {
	ID       string  `json:"id"`
	Title    string  `json:"title"`
	Score    float64 `json:"score"`
	Status   string  `json:"status"`
	Priority int     `json:"priority"`
	Snippet  string  `json:"snippet,omitempty"`
}

type SendDryRunEntry struct {
	Pane          int    `json:"pane"`
	Agent         string `json:"agent,omitempty"`
	Prompt        string `json:"prompt"`
	PromptPreview string `json:"prompt_preview,omitempty"`
	Source        string `json:"source,omitempty"`
}

type SendDryRunResult struct {
	Success   bool               `json:"success"`
	DryRun    bool               `json:"dry_run"`
	Session   string             `json:"session"`
	Redaction *RedactionSummary  `json:"redaction,omitempty"`
	Warnings  []string           `json:"warnings,omitempty"`
	Blocked   bool               `json:"blocked,omitempty"`
	ErrorCode string             `json:"error_code,omitempty"`
	Total     int                `json:"total"`
	WouldSend []SendDryRunEntry  `json:"would_send"`
	RoutedTo  *SendRoutingResult `json:"routed_to,omitempty"`
	Message   string             `json:"message,omitempty"`
	Error     string             `json:"error,omitempty"`
}

type SendOptions struct {
	Session        string
	Prompt         string
	PromptSource   string
	Targets        SendTargets
	TargetAll      bool
	SkipFirst      bool
	PaneIndex      int
	Panes          []int // Specific pane indices to target
	PanesSpecified bool  // True if --panes was explicitly set
	TemplateName   string
	Tags           []string
	DryRun         bool

	// Smart routing options
	SmartRoute    bool   // Use smart routing to select best agent
	RouteStrategy string // Routing strategy (least-loaded, round-robin, etc.)

	// CASS check options
	CassCheck      bool
	CassSimilarity float64
	CassCheckDays  int

	// Hooks
	NoHooks bool

	// Batch processing options
	BatchFile       string        // Path to batch file
	BatchDelay      time.Duration // Delay between prompts
	BatchConfirm    bool          // Confirm each prompt before sending
	BatchStopOnErr  bool          // Stop on first error
	BatchBroadcast  bool          // Send same prompt to all agents simultaneously
	BatchAgentIndex int           // Send to specific agent index (-1 = round-robin)
	// contains filtered or unexported fields
}

type SendResult struct {
	Success       bool               `json:"success"`
	Session       string             `json:"session"`
	PromptPreview string             `json:"prompt_preview,omitempty"`
	Redaction     *RedactionSummary  `json:"redaction,omitempty"`
	Warnings      []string           `json:"warnings,omitempty"`
	Blocked       bool               `json:"blocked,omitempty"`
	ErrorCode     string             `json:"error_code,omitempty"`
	Targets       []int              `json:"targets"`
	Delivered     int                `json:"delivered"`
	Failed        int                `json:"failed"`
	RoutedTo      *SendRoutingResult `json:"routed_to,omitempty"`
	Error         string             `json:"error,omitempty"`
}

type SendRoutingResult struct {
	PaneIndex int     `json:"pane_index"`
	AgentType string  `json:"agent_type"`
	Strategy  string  `json:"strategy"`
	Reason    string  `json:"reason"`
	Score     float64 `json:"score"`
}

type SendTarget struct {
	Type    AgentType
	Variant string // Empty = all agents of type; non-empty = filter by variant
}

type SendTargets []SendTarget

type SessionAttachInput struct {
	Session string `json:"session"`
}

type SessionCreateInput struct {
	Session string `json:"session"`
	Panes   int    `json:"panes,omitempty"`
}

type SessionHealthInput struct {
	Session string `json:"session"`
	Pane    *int   `json:"pane,omitempty"`
	Status  string `json:"status,omitempty"`
	Verbose bool   `json:"verbose,omitempty"`
}

type SessionInterruptInput struct {
	Session string   `json:"session"`
	Tags    []string `json:"tags,omitempty"`
}

type SessionKillInput struct {
	Session   string   `json:"session"`
	Force     bool     `json:"force,omitempty"`
	Tags      []string `json:"tags,omitempty"`
	NoHooks   bool     `json:"no_hooks,omitempty"`
	Summarize bool     `json:"summarize,omitempty"` // Generate summary before killing
}

type SessionListInput struct {
	Tags []string `json:"tags,omitempty"`
}

type SessionOutput struct {
	Name      string       `json:"name"`
	AgentType string       `json:"agent_type"`
	PaneCount int          `json:"pane_count"`
	Panes     []PaneOutput `json:"panes"`
}

type SessionResolution struct {
	Session  string
	Reason   string
	Inferred bool // Session arg was omitted and we resolved automatically/with chooser.
	Prompted bool // User picked from a selector (may be canceled).
}

type SessionResolveOptions struct {
	// TreatAsJSON disables prompting for local-json subcommands that don't use the global flag.
	TreatAsJSON bool
}

type SessionStatusInput struct {
	Session         string   `json:"session"`
	Tags            []string `json:"tags,omitempty"`
	ShowAssignments bool     `json:"show_assignments,omitempty"`
	FilterStatus    string   `json:"status,omitempty"`
	FilterAgent     string   `json:"agent,omitempty"`
	FilterPane      *int     `json:"pane,omitempty"`
	ShowSummary     bool     `json:"summary,omitempty"`
}

type SessionSummary struct {
	Name        string    `json:"name"`
	CreatedAt   time.Time `json:"created_at"`
	AgentCount  int       `json:"agent_count"`
	PromptCount int       `json:"prompt_count"`
}

type SessionTemplateInfo struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Source      string   `json:"source"`
	Tags        []string `json:"tags,omitempty"`
	AgentCount  int      `json:"agent_count"`
}

type SessionTemplateShowResult struct {
	Name        string                        `json:"name"`
	Description string                        `json:"description"`
	Source      string                        `json:"source"`
	Tags        []string                      `json:"tags,omitempty"`
	Agents      *templates.AgentsSpec         `json:"agents"`
	Prompts     *templates.PromptsSpec        `json:"prompts,omitempty"`
	CASS        *templates.CASSSpec           `json:"cass,omitempty"`
	Beads       *templates.BeadsSpec          `json:"beads,omitempty"`
	Options     *templates.SessionOptionsSpec `json:"options,omitempty"`
}

type SessionTemplatesListResult struct {
	Templates []SessionTemplateInfo `json:"templates"`
	Total     int                   `json:"total"`
}

type SessionViewInput struct {
	Session string `json:"session"`
}

type SessionZoomInput struct {
	Session string `json:"session"`
	Pane    *int   `json:"pane,omitempty"`
}

type SessionsListResult struct {
	Sessions []session.SavedSession `json:"sessions"`
	Count    int                    `json:"count"`
}

type SessionsRestoreResult struct {
	Success    bool                  `json:"success"`
	SavedName  string                `json:"saved_name"`
	RestoredAs string                `json:"restored_as"`
	State      *session.SessionState `json:"state,omitempty"`
	AgentCount int                   `json:"agent_count"`
	Error      string                `json:"error,omitempty"`
	GitWarning string                `json:"git_warning,omitempty"`
}

type SessionsSaveResult struct {
	Success  bool                  `json:"success"`
	Session  string                `json:"session"`
	SavedAs  string                `json:"saved_as"`
	FilePath string                `json:"file_path"`
	State    *session.SessionState `json:"state,omitempty"`
	Error    string                `json:"error,omitempty"`
}

type SessionsShowResult struct {
	State *session.SessionState `json:"state"`
}

type SetupResponse struct {
	output.TimestampedResponse
	Success           bool     `json:"success"`
	ProjectPath       string   `json:"project_path"`
	NTMDir            string   `json:"ntm_dir"`
	CreatedDirs       []string `json:"created_dirs"`
	CreatedFiles      []string `json:"created_files"`
	WrappersInstalled bool     `json:"wrappers_installed,omitempty"`
	HooksInstalled    bool     `json:"hooks_installed,omitempty"`
	BeadsInitialized  bool     `json:"beads_initialized,omitempty"`
	BeadsWarning      string   `json:"beads_warning,omitempty"`
}

type SkippedItem struct {
	BeadID       string   `json:"bead_id"`
	BeadTitle    string   `json:"bead_title"`
	Reason       string   `json:"reason"`
	BlockedByIDs []string `json:"blocked_by_ids,omitempty"` // Only set when reason is "blocked"
}

type SpawnAssignResult struct {
	Spawn  *output.SpawnResponse `json:"spawn"`
	Init   *SpawnInitResult      `json:"init,omitempty"`
	Assign *AssignOutputEnhanced `json:"assign,omitempty"`
}

type SpawnContext struct {
	BatchID     string    // Unique identifier for this spawn batch
	TotalAgents int       // Total number of agents in this spawn
	CreatedAt   time.Time // When the spawn batch was initiated
}

type SpawnInitResult struct {
	PromptSent    bool `json:"prompt_sent"`
	AgentsReached int  `json:"agents_reached"`
}

type SpawnOptions struct {
	Session       string
	Agents        []FlatAgent
	CCCount       int
	CodCount      int
	GmiCount      int
	CursorCount   int
	WindsurfCount int
	AiderCount    int
	UserPane      bool
	AutoRestart   bool
	RecipeName    string
	PersonaMap    map[string]*persona.Persona
	PluginMap     map[string]plugins.AgentPlugin

	// Profile mapping: list of persona names to map to agents in order
	ProfileList []*persona.Persona

	// CASS Context
	CassContextQuery string
	NoCassContext    bool
	Prompt           string
	InitPrompt       string
	LocalModel       string
	LocalHost        string

	// Hooks
	NoHooks bool

	// Safety mode: fail if session already exists
	Safety bool

	// Stagger configuration for thundering herd prevention
	// StaggerMode: "smart", "fixed", or "none" (default)
	// - smart: Use learned optimal delays from RateLimitTracker
	// - fixed: Use fixed delay (StaggerDelay)
	// - none: No staggering (backward compatible default)
	StaggerMode  string        // "smart", "fixed", or "none"
	StaggerDelay time.Duration // Delay for fixed mode (default 30s)

	// Legacy stagger fields (deprecated, kept for backward compatibility)
	Stagger        time.Duration // Delay between agent prompt delivery
	StaggerEnabled bool          // True if --stagger flag was provided

	// Assignment configuration for spawn+assign workflow
	Assign             bool          // Enable auto-assignment after spawn
	AssignStrategy     string        // Assignment strategy: balanced, speed, quality, dependency, round-robin
	AssignLimit        int           // Maximum assignments (0 = unlimited)
	AssignReadyTimeout time.Duration // Timeout waiting for agents to become ready
	AssignVerbose      bool          // Show detailed scoring/decision logs during assignment
	AssignQuiet        bool          // Suppress non-essential assignment output
	AssignTimeout      time.Duration // Timeout for external calls during assignment (bv, br, Agent Mail)
	AssignAgentType    string        // Filter assignment to specific agent type (claude, codex, gemini)

	// Git worktree isolation configuration
	UseWorktrees bool // Enable git worktree isolation for agents

	// Privacy mode configuration (bd-2u3tv)
	PrivacyMode  bool // Enable privacy mode (no persistence)
	AllowPersist bool // Allow persistence even in privacy mode
}

type SpawnState struct {

	// BatchID is the unique identifier for this spawn batch
	BatchID string `json:"batch_id"`

	// StartedAt is when the spawn began
	StartedAt time.Time `json:"started_at"`

	// StaggerSeconds is the interval between agent prompts
	StaggerSeconds int `json:"stagger_seconds"`

	// TotalAgents is the total number of agents spawned
	TotalAgents int `json:"total_agents"`

	// Prompts tracks the status of each agent's prompt delivery
	Prompts []PromptStatus `json:"prompts"`

	// CompletedAt is when all prompts were delivered (zero if still in progress)
	CompletedAt time.Time `json:"completed_at,omitempty"`
	// contains filtered or unexported fields
}

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

type SwarmPlanOutput struct {
	ScanDir         string             `json:"scan_dir"`
	TotalCC         int                `json:"total_cc"`
	TotalCod        int                `json:"total_cod"`
	TotalGmi        int                `json:"total_gmi"`
	TotalAgents     int                `json:"total_agents"`
	SessionsPerType int                `json:"sessions_per_type"`
	PanesPerSession int                `json:"panes_per_session"`
	Allocations     []AllocationOutput `json:"allocations"`
	Sessions        []SessionOutput    `json:"sessions"`
	DryRun          bool               `json:"dry_run"`
	Error           string             `json:"error,omitempty"`
}

type TableStyle int

type TemplateListItem struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Source      string   `json:"source"`
	SourcePath  string   `json:"source_path,omitempty"`
	Tags        []string `json:"tags,omitempty"`
	Variables   []string `json:"variables,omitempty"`
}

type TemplateShowOutput struct {
	Name        string                   `json:"name"`
	Description string                   `json:"description"`
	Source      string                   `json:"source"`
	SourcePath  string                   `json:"source_path,omitempty"`
	Tags        []string                 `json:"tags,omitempty"`
	Variables   []TemplateVariableOutput `json:"variables,omitempty"`
	Body        string                   `json:"body,omitempty"`
}

type TemplateVariableOutput struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required"`
	Default     string `json:"default,omitempty"`
}

type TimelineCleanupResult struct {
	Deleted    int `json:"deleted"`
	Remaining  int `json:"remaining"`
	Compressed int `json:"compressed"`
}

type TimelineEventStats struct {
	TotalEvents    int                         `json:"total_events"`
	UniqueAgents   int                         `json:"unique_agents"`
	AgentBreakdown map[string]int              `json:"agent_breakdown"`
	StateBreakdown map[state.TimelineState]int `json:"state_breakdown"`
	Duration       time.Duration               `json:"duration"`
	FirstEvent     time.Time                   `json:"first_event"`
	LastEvent      time.Time                   `json:"last_event"`
}

type TimelineListResult struct {
	Timelines  []state.TimelineInfo `json:"timelines"`
	TotalCount int                  `json:"total_count"`
	Showing    int                  `json:"showing"`
}

type TimelineShowResult struct {
	Info   *state.TimelineInfo `json:"info"`
	Events []state.AgentEvent  `json:"events,omitempty"`
	Stats  *TimelineEventStats `json:"stats"`
}

type TimelineStatsResult struct {
	TotalTimelines  int    `json:"total_timelines"`
	TotalEvents     int    `json:"total_events"`
	TotalAgents     int    `json:"total_agents"`
	TotalSize       int64  `json:"total_size_bytes"`
	CompressedCount int    `json:"compressed_count"`
	OldestTimeline  string `json:"oldest_timeline,omitempty"`
	NewestTimeline  string `json:"newest_timeline,omitempty"`
}

type ToolCheck struct {
	Name         string   `json:"name"`
	Installed    bool     `json:"installed"`
	Version      string   `json:"version,omitempty"`
	Path         string   `json:"path,omitempty"`
	Capabilities []string `json:"capabilities,omitempty"`
	Required     bool     `json:"required"`
	Status       string   `json:"status"` // "ok", "warning", "error"
	Message      string   `json:"message,omitempty"`
}

type UnblockedBead struct {
	ID            string   `json:"id"`
	Title         string   `json:"title"`
	Priority      int      `json:"priority"`
	PrevBlockers  []string `json:"previous_blockers"`
	UnblockedByID string   `json:"unblocked_by_id"` // The blocker that was completed
}

type UnlockResult struct {
	Success    bool       `json:"success"`
	Session    string     `json:"session"`
	Agent      string     `json:"agent"`
	Released   int        `json:"released"`
	ReleasedAt *time.Time `json:"released_at,omitempty"`
	Error      string     `json:"error,omitempty"`
}

type ValidationIssue struct {
	Field   string `json:"field,omitempty"`
	Message string `json:"message"`
	Fixable bool   `json:"fixable,omitempty"`
}

type ValidationReport struct {
	Valid   bool               `json:"valid"`
	Results []ValidationResult `json:"results"`
	Summary ValidationSummary  `json:"summary"`
}

type ValidationResult struct {
	Path     string            `json:"path"`
	Type     string            `json:"type"` // "main", "project", "recipes", "personas", "policy"
	Valid    bool              `json:"valid"`
	Errors   []ValidationIssue `json:"errors,omitempty"`
	Warnings []ValidationIssue `json:"warnings,omitempty"`
	Info     []string          `json:"info,omitempty"`
}

type ValidationSummary struct {
	FilesChecked int `json:"files_checked"`
	ErrorCount   int `json:"error_count"`
	WarningCount int `json:"warning_count"`
	FixableCount int `json:"fixable_count"`
}

type VersionInput struct {
	Short bool `json:"short,omitempty"`
}

type WaitAgentInfo struct {
	Pane      string    `json:"pane"`
	State     string    `json:"state"`
	MetAt     time.Time `json:"met_at"`
	AgentType string    `json:"agent_type,omitempty"`
}

type WaitCondition string

type WaitErrorStateError struct {
	Pane string
}

type WaitOptions struct {
	Session      string
	Condition    WaitCondition
	Timeout      time.Duration
	PollInterval time.Duration
	PaneIndex    int // -1 means all panes
	AgentType    string
	WaitForAny   bool // If true, wait for ANY agent; otherwise wait for ALL
	ExitOnError  bool // If true, exit immediately on ERROR state
	CountN       int  // With --any, wait for at least N agents (default 1)
}

type WaitResult struct {
	Success       bool            `json:"success"`
	Timestamp     string          `json:"timestamp"`
	Session       string          `json:"session"`
	Condition     string          `json:"condition"`
	WaitedSeconds float64         `json:"waited_seconds"`
	Agents        []WaitAgentInfo `json:"agents,omitempty"`
	AgentsPending []string        `json:"agents_pending,omitempty"`
	Error         string          `json:"error,omitempty"`
	ErrorCode     string          `json:"error_code,omitempty"`
	Hint          string          `json:"hint,omitempty"`
}

type WaitTimeoutError struct {
	Duration time.Duration
}

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

type WizardResult struct {
	ProjectType     ProjectType
	AgentCount      int
	EnableAgentMail bool
	EnableCASS      bool
	EnableCM        bool
	AutoFileReserve bool
	Cancelled       bool
}

type WizardStep int

type WorkflowInfo struct {
	Name         string `json:"name"`
	Description  string `json:"description"`
	Source       string `json:"source"`
	Coordination string `json:"coordination"`
	AgentCount   int    `json:"agent_count"`
}

type WorkflowShowResult struct {
	Name          string                   `json:"name"`
	Description   string                   `json:"description"`
	Source        string                   `json:"source"`
	Coordination  string                   `json:"coordination"`
	AgentCount    int                      `json:"agent_count"`
	Agents        []workflow.WorkflowAgent `json:"agents"`
	Flow          *workflow.FlowConfig     `json:"flow,omitempty"`
	Prompts       []workflow.SetupPrompt   `json:"prompts,omitempty"`
	ErrorHandling *workflow.ErrorConfig    `json:"error_handling,omitempty"`
}

type WorkflowsListResult struct {
	Workflows []WorkflowInfo `json:"workflows"`
	Total     int            `json:"total"`
}