ai

type AIRuntimeStatus struct {
	RemoteConfigured   bool                      `json:"remote_configured"`
	DesktopModelSource *DesktopModelSourceStatus `json:"desktop_model_source,omitempty"`
}

type ActiveThreadRun struct {
	ThreadID string `json:"thread_id"`
	RunID    string `json:"run_id"`
}

type ActivityTimelineBlock struct {
	Type        string                              `json:"type"`
	FileActions map[string]FlowerActivityFileAction `json:"file_actions,omitempty"`
	observation.ActivityTimeline
}

type AppendThreadMessageRequest struct {
	Role   string `json:"role"`
	Text   string `json:"text"`
	Format string `json:"format,omitempty"` // markdown|text (defaults to markdown for now)
}

type ApplyPatchResult struct {
	FilesChanged     int                  `json:"files_changed"`
	Hunks            int                  `json:"hunks"`
	Additions        int                  `json:"additions"`
	Deletions        int                  `json:"deletions"`
	InputFormat      string               `json:"input_format"`
	NormalizedFormat string               `json:"normalized_format"`
	Files            []patchFileSummary   `json:"files"`
	Mutations        []FileMutationResult `json:"mutations"`
}

type ApprovalDecisionKind string

type CompactThreadContextRequest struct {
	ThreadID    string `json:"thread_id"`
	ActiveRunID string `json:"active_run_id,omitempty"`
}

type CompactThreadContextResponse struct {
	OperationID string `json:"operation_id,omitempty"`
	Kind        string `json:"kind"`
	ErrorCode   string `json:"error_code,omitempty"`
}

type ContentPart struct {
	Type       string `json:"type"`
	Text       string `json:"text,omitempty"`
	FileURI    string `json:"file_uri,omitempty"`
	MimeType   string `json:"mime_type,omitempty"`
	ToolCallID string `json:"tool_call_id,omitempty"`
	ToolUseID  string `json:"tool_use_id,omitempty"`
	ToolName   string `json:"tool_name,omitempty"`
	ArgsJSON   string `json:"args_json,omitempty"`
	JSON       []byte `json:"json,omitempty"`
}

type ContextActionContextItem struct {
	Kind           string  `json:"kind"`
	Path           string  `json:"path,omitempty"`
	IsDirectory    bool    `json:"is_directory,omitempty"`
	RootLabel      string  `json:"root_label,omitempty"`
	Selection      string  `json:"selection,omitempty"`
	SelectionChars int     `json:"selection_chars,omitempty"`
	WorkingDir     string  `json:"working_dir,omitempty"`
	PID            int     `json:"pid,omitempty"`
	Name           string  `json:"name,omitempty"`
	Username       string  `json:"username,omitempty"`
	CPUPercent     float64 `json:"cpu_percent,omitempty"`
	MemoryBytes    int64   `json:"memory_bytes,omitempty"`
	Platform       string  `json:"platform,omitempty"`
	CapturedAtMs   int64   `json:"captured_at_ms,omitempty"`
	Title          string  `json:"title,omitempty"`
	Detail         string  `json:"detail,omitempty"`
	Content        string  `json:"content,omitempty"`
}

type ContextActionEnvelope struct {
	SchemaVersion       int                         `json:"schema_version"`
	ActionID            string                      `json:"action_id"`
	Provider            string                      `json:"provider,omitempty"`
	Target              ContextActionTarget         `json:"target"`
	Source              ContextActionSource         `json:"source"`
	ExecutionContext    *ContextActionExecutionHint `json:"execution_context,omitempty"`
	Context             []ContextActionContextItem  `json:"context"`
	Presentation        ContextActionPresentation   `json:"presentation"`
	SuggestedWorkingDir string                      `json:"suggested_working_dir_abs,omitempty"`
}

type ContextActionExecutionHint struct {
	CurrentTargetID   string `json:"current_target_id,omitempty"`
	SourceEnvPublicID string `json:"source_env_public_id,omitempty"`
	RuntimeHint       string `json:"runtime_hint,omitempty"`
	SessionSource     string `json:"session_source,omitempty"`
}

type ContextActionPresentation struct {
	Label          string `json:"label"`
	Priority       int    `json:"priority"`
	StatusLabel    string `json:"status_label,omitempty"`
	DisabledReason string `json:"disabled_reason,omitempty"`
}

type ContextActionSource struct {
	Surface   string `json:"surface"`
	SurfaceID string `json:"surface_id,omitempty"`
}

type ContextActionTarget struct {
	TargetID string `json:"target_id"`
	Locality string `json:"locality"`
}

type CreateThreadRequest struct {
	Title              string                      `json:"title"`
	ModelID            string                      `json:"model_id,omitempty"`
	PermissionType     string                      `json:"permission_type,omitempty"`
	WorkingDir         string                      `json:"working_dir,omitempty"`
	ReasoningSelection config.AIReasoningSelection `json:"reasoning_selection,omitempty"`
}

type CreateThreadResponse struct {
	Thread ThreadView `json:"thread"`
}

type DefaultPermissionToolFilter struct{}

type DelegatedApprovalRef struct {
	ParentThreadID  string `json:"parent_thread_id"`
	ParentRunID     string `json:"parent_run_id"`
	ParentTurnID    string `json:"parent_turn_id,omitempty"`
	SubagentID      string `json:"subagent_id"`
	ChildThreadID   string `json:"child_thread_id"`
	ChildRunID      string `json:"child_run_id"`
	ChildTurnID     string `json:"child_turn_id,omitempty"`
	ChildToolCallID string `json:"child_tool_call_id"`
	ApprovalID      string `json:"approval_id"`
}

type DesktopModelSourceConnectorOptions struct {
	Logger                *slog.Logger
	ConfigPath            string
	SecretsPath           string
	RuntimeControlBaseURL string
	RuntimeControlToken   string
	DesktopOwnerID        string
	SessionID             string
	Source                string
	ExpiresAtUnixMS       int64
	StartupReportFile     string
	HTTPClient            *http.Client
}

type DesktopModelSourceModel struct {
	ID                            string                        `json:"id"`
	Label                         string                        `json:"label,omitempty"`
	Provider                      string                        `json:"provider,omitempty"`
	ContextWindow                 int                           `json:"context_window,omitempty"`
	MaxOutputTokens               int                           `json:"max_output_tokens,omitempty"`
	EffectiveContextWindowPercent int                           `json:"effective_context_window_percent,omitempty"`
	InputModalities               []string                      `json:"input_modalities,omitempty"`
	SupportsImageInput            bool                          `json:"supports_image_input,omitempty"`
	ReasoningCapability           config.AIReasoningCapability  `json:"reasoning_capability,omitempty"`
	Capability                    *contextmodel.ModelCapability `json:"capability,omitempty"`
}

type DesktopModelSourceModelSnapshot struct {
	Configured            bool                      `json:"configured"`
	CurrentModel          string                    `json:"current_model"`
	Models                []DesktopModelSourceModel `json:"models"`
	MissingKeyProviderIDs []string                  `json:"missing_key_provider_ids,omitempty"`
}

type DesktopModelSourceRPCError struct {
	Code    string `json:"code,omitempty"`
	Message string `json:"message,omitempty"`
}

type DesktopModelSourceRPCFrame struct {
	ProtocolVersion string                      `json:"protocol_version,omitempty"`
	ID              string                      `json:"id,omitempty"`
	Type            string                      `json:"type"`
	Method          string                      `json:"method,omitempty"`
	Params          json.RawMessage             `json:"params,omitempty"`
	Event           *StreamEvent                `json:"event,omitempty"`
	Result          json.RawMessage             `json:"result,omitempty"`
	Error           *DesktopModelSourceRPCError `json:"error,omitempty"`
}

type DesktopModelSourceSession struct {
	SessionID       string
	Source          string
	ProtocolVersion string
	ExpiresAtUnixMS int64
}

type DesktopModelSourceStartupReport struct {
	Status                string   `json:"status"`
	SessionID             string   `json:"session_id"`
	PID                   int      `json:"pid"`
	Configured            bool     `json:"configured"`
	ModelCount            int      `json:"model_count"`
	MissingKeyProviderIDs []string `json:"missing_key_provider_ids,omitempty"`
}

type DesktopModelSourceStatus struct {
	BindingState          string   `json:"binding_state,omitempty"`
	Connected             bool     `json:"connected"`
	Available             bool     `json:"available"`
	ModelSource           string   `json:"model_source,omitempty"`
	SessionID             string   `json:"session_id,omitempty"`
	ExpiresAtUnixMS       int64    `json:"expires_at_unix_ms,omitempty"`
	ConnectedAtUnixMS     int64    `json:"connected_at_unix_ms,omitempty"`
	ModelCount            int      `json:"model_count"`
	MissingKeyProviderIDs []string `json:"missing_key_provider_ids,omitempty"`
	LastError             string   `json:"last_error,omitempty"`
}

type FileEditArgs struct {
	FilePath   string `json:"file_path"`
	OldString  string `json:"old_string"`
	NewString  string `json:"new_string"`
	ReplaceAll bool   `json:"replace_all,omitempty"`
}

type FileMutationResult struct {
	FilePath              string `json:"file_path"`
	DisplayName           string `json:"display_name"`
	OldPath               string `json:"old_path,omitempty"`
	NewPath               string `json:"new_path,omitempty"`
	ChangeType            string `json:"change_type"`
	Additions             int    `json:"additions,omitempty"`
	Deletions             int    `json:"deletions,omitempty"`
	UnifiedDiff           string `json:"unified_diff,omitempty"`
	DiffUnavailableReason string `json:"diff_unavailable_reason,omitempty"`
	Truncated             bool   `json:"truncated,omitempty"`
}

type FileReadArgs struct {
	FilePath string `json:"file_path"`
	Offset   int    `json:"offset,omitempty"`
	Limit    int    `json:"limit,omitempty"`
}

type FileReadResult struct {
	FilePath    string `json:"file_path"`
	DisplayName string `json:"display_name"`
	Content     string `json:"content"`
	LineOffset  int    `json:"line_offset,omitempty"`
	LineCount   int    `json:"line_count,omitempty"`
	TotalLines  int    `json:"total_lines,omitempty"`
	Truncated   bool   `json:"truncated,omitempty"`
}

type FileWriteArgs struct {
	FilePath string `json:"file_path"`
	Content  string `json:"content"`
}

type FlowerActivityFileAction struct {
	ActionID      string `json:"action_id"`
	DisplayName   string `json:"display_name"`
	PreviewPath   string `json:"preview_path,omitempty"`
	DirectoryPath string `json:"directory_path,omitempty"`
}

type FlowerApprovalAction struct {
	ActionID            string                            `json:"action_id"`
	Origin              FlowerApprovalOrigin              `json:"origin"`
	RunID               string                            `json:"run_id,omitempty"`
	TurnID              string                            `json:"turn_id,omitempty"`
	StepID              string                            `json:"step_id,omitempty"`
	ToolID              string                            `json:"tool_id,omitempty"`
	ToolName            string                            `json:"tool_name"`
	State               FlowerApprovalState               `json:"state"`
	Status              FlowerApprovalStatus              `json:"status"`
	Revision            int64                             `json:"revision"`
	Version             int64                             `json:"version"`
	SurfaceEpoch        int64                             `json:"surface_epoch,omitempty"`
	SurfaceRole         FlowerApprovalSurfaceRole         `json:"surface_role,omitempty"`
	Scope               string                            `json:"scope,omitempty"`
	RequestedAtMs       int64                             `json:"requested_at_unix_ms"`
	ResolvedAtMs        int64                             `json:"resolved_at_unix_ms,omitempty"`
	ExpiresAtMs         int64                             `json:"expires_at_unix_ms,omitempty"`
	CanApprove          bool                              `json:"can_approve"`
	ExpectedSeq         int64                             `json:"expected_seq,omitempty"`
	ReadOnlyReason      string                            `json:"read_only_reason,omitempty"`
	DelegatedRef        *DelegatedApprovalRef             `json:"delegated_ref,omitempty"`
	DeliveryState       FlowerApprovalDeliveryState       `json:"delivery_state,omitempty"`
	ChildExecutionState FlowerApprovalChildExecutionState `json:"child_execution_state,omitempty"`
	PrimaryWaitAnchor   string                            `json:"primary_wait_anchor,omitempty"`
	QueueGeneration     int64                             `json:"queue_generation"`
	QueueOrder          int64                             `json:"queue_order"`
	BatchIndex          int                               `json:"batch_index"`
	BatchSize           int                               `json:"batch_size"`
	Summary             FlowerApprovalSummary             `json:"summary"`
}

type FlowerApprovalChildExecutionState string

type FlowerApprovalDeliveryState string

type FlowerApprovalOrigin string

type FlowerApprovalQueue struct {
	Generation      int64  `json:"generation"`
	Revision        int64  `json:"revision"`
	CurrentActionID string `json:"current_action_id,omitempty"`
	CurrentPosition int    `json:"current_position"`
	Total           int    `json:"total"`
	UnresolvedCount int    `json:"unresolved_count"`
}

type FlowerApprovalState string

type FlowerApprovalStatus string

type FlowerApprovalSummary struct {
	Label       string             `json:"label"`
	Description string             `json:"description,omitempty"`
	Command     string             `json:"command,omitempty"`
	Cwd         string             `json:"cwd,omitempty"`
	Effects     []string           `json:"effects,omitempty"`
	Flags       []string           `json:"flags,omitempty"`
	Targets     []FlowerSafeTarget `json:"targets,omitempty"`
}

type FlowerApprovalSurfaceRole string

type FlowerContextCompaction struct {
	OperationID         string `json:"operation_id"`
	RunID               string `json:"run_id,omitempty"`
	StepIndex           int    `json:"step_index,omitempty"`
	Phase               string `json:"phase"`
	Status              string `json:"status"`
	Trigger             string `json:"trigger,omitempty"`
	Reason              string `json:"reason,omitempty"`
	TokensBefore        int64  `json:"tokens_before,omitempty"`
	TokensAfterEstimate int64  `json:"tokens_after_estimate,omitempty"`
	Error               string `json:"error,omitempty"`
	UpdatedAtMs         int64  `json:"updated_at_ms"`
}

type FlowerContextUsage struct {
	RunID                  string  `json:"run_id,omitempty"`
	StepIndex              int     `json:"step_index,omitempty"`
	Phase                  string  `json:"phase"`
	InputTokens            int64   `json:"input_tokens,omitempty"`
	ContextWindowTokens    int64   `json:"context_window_tokens,omitempty"`
	ThresholdTokens        int64   `json:"threshold_tokens,omitempty"`
	RequestSafeLimitTokens int64   `json:"request_safe_limit_tokens,omitempty"`
	OutputHeadroomTokens   int64   `json:"output_headroom_tokens,omitempty"`
	UsedRatio              float64 `json:"used_ratio,omitempty"`
	ThresholdRatio         float64 `json:"threshold_ratio,omitempty"`
	PressureStatus         string  `json:"pressure_status"`
	Source                 string  `json:"source,omitempty"`
	UpdatedAtMs            int64   `json:"updated_at_ms"`
}

type FlowerFileActionOpenRequest struct {
	ThreadID   string `json:"thread_id,omitempty"`
	MessageID  string `json:"message_id"`
	BlockIndex int    `json:"block_index"`
	ItemID     string `json:"item_id"`
	ActionID   string `json:"action_id"`
	Action     string `json:"action"`
}

type FlowerFileActionOpenTarget struct {
	ActionID string `json:"action_id"`
	Action   string `json:"action"`
	Path     string `json:"path"`
}

type FlowerLiveApprovalPayload struct {
	Action        FlowerApprovalAction `json:"action"`
	ApprovalQueue *FlowerApprovalQueue `json:"approval_queue,omitempty"`
}

type FlowerLiveBlock struct {
	Type    string          `json:"type"`
	Content string          `json:"content,omitempty"`
	Block   json.RawMessage `json:"block,omitempty"`
}

type FlowerLiveBootstrapResponse struct {
	SchemaVersion    int64                       `json:"schema_version"`
	EndpointID       string                      `json:"endpoint_id"`
	ThreadID         string                      `json:"thread_id"`
	StreamGeneration int64                       `json:"stream_generation"`
	Cursor           int64                       `json:"cursor"`
	RetainedFromSeq  int64                       `json:"retained_from_seq"`
	Thread           ThreadView                  `json:"thread"`
	TimelineMessages []FlowerTimelineMessage     `json:"timeline_messages"`
	LiveState        FlowerLiveMaterializedState `json:"live_state"`
	ReadStatus       FlowerThreadReadView        `json:"read_status"`
	GeneratedAtMs    int64                       `json:"generated_at_unix_ms"`
}

type FlowerLiveContextCompactionUpdatedPayload struct {
	Compaction         FlowerContextCompaction  `json:"compaction"`
	TimelineDecoration FlowerTimelineDecoration `json:"timeline_decoration"`
}

type FlowerLiveEvent struct {
	SchemaVersion int64           `json:"schema_version"`
	Seq           int64           `json:"seq"`
	EndpointID    string          `json:"endpoint_id"`
	ThreadID      string          `json:"thread_id"`
	RunID         string          `json:"run_id,omitempty"`
	TurnID        string          `json:"turn_id,omitempty"`
	TraceID       string          `json:"trace_id,omitempty"`
	Step          string          `json:"step,omitempty"`
	AtUnixMs      int64           `json:"at_unix_ms"`
	Kind          FlowerLiveKind  `json:"kind"`
	Payload       json.RawMessage `json:"payload"`
}

type FlowerLiveEventsResponse struct {
	StreamGeneration int64             `json:"stream_generation"`
	Events           []FlowerLiveEvent `json:"events"`
	NextCursor       int64             `json:"next_cursor"`
	HasMore          bool              `json:"has_more,omitempty"`
	RetainedFromSeq  int64             `json:"retained_from_seq"`
}

type FlowerLiveInputRequestedPayload struct {
	Request RequestUserInputPrompt `json:"request"`
}

type FlowerLiveInputResolvedPayload struct {
	PromptID string `json:"prompt_id"`
}

type FlowerLiveKind string

type FlowerLiveMaterializedState struct {
	ThreadPatch         FlowerLiveThreadPatch             `json:"thread_patch"`
	Messages            map[string]FlowerLiveMessageDraft `json:"-"`
	Runs                map[string]FlowerLiveRunState     `json:"runs"`
	ModelIO             *FlowerModelIOStatus              `json:"model_io,omitempty"`
	ContextUsage        *FlowerContextUsage               `json:"context_usage,omitempty"`
	ContextCompactions  []FlowerContextCompaction         `json:"context_compactions,omitempty"`
	TimelineDecorations []FlowerTimelineDecoration        `json:"timeline_decorations,omitempty"`
	ApprovalActions     map[string]FlowerApprovalAction   `json:"approval_actions"`
	ApprovalActionsSeen bool                              `json:"-"`
	ApprovalQueue       *FlowerApprovalQueue              `json:"approval_queue,omitempty"`
	InputRequests       map[string]RequestUserInputPrompt `json:"input_requests"`
}

type FlowerLiveMessageBlockDeltaPayload struct {
	MessageID  string `json:"message_id"`
	BlockIndex int    `json:"block_index"`
	Delta      string `json:"delta"`
}

type FlowerLiveMessageBlockSetPayload struct {
	MessageID  string `json:"message_id"`
	BlockIndex int    `json:"block_index"`
	Block      any    `json:"block"`
}

type FlowerLiveMessageBlockStartedPayload struct {
	MessageID  string `json:"message_id"`
	BlockIndex int    `json:"block_index"`
	BlockType  string `json:"block_type"`
}

type FlowerLiveMessageCommittedPayload struct {
	MessageID string          `json:"message_id"`
	Message   json.RawMessage `json:"message"`
}

type FlowerLiveMessageDraft struct {
	MessageID   string            `json:"message_id"`
	Role        string            `json:"role"`
	Status      string            `json:"status"`
	CreatedAtMs int64             `json:"created_at_ms"`
	Blocks      []FlowerLiveBlock `json:"blocks"`
}

type FlowerLiveMessageFailedPayload struct {
	MessageID string `json:"message_id"`
	Error     string `json:"error"`
}

type FlowerLiveMessageStartedPayload struct {
	MessageID   string `json:"message_id"`
	Role        string `json:"role"`
	Status      string `json:"status"`
	CreatedAtMs int64  `json:"created_at_ms"`
}

type FlowerLiveModelIOUpdatedPayload struct {
	Status *FlowerModelIOStatus `json:"status"`
}

type FlowerLiveResyncRequiredPayload struct {
	Reason string `json:"reason"`
}

type FlowerLiveRunStartedPayload struct {
	RunID     string `json:"run_id"`
	TurnID    string `json:"turn_id,omitempty"`
	MessageID string `json:"message_id,omitempty"`
	Status    string `json:"status"`
	ModelID   string `json:"model_id,omitempty"`
}

type FlowerLiveRunState struct {
	RunID         string                  `json:"run_id"`
	Status        string                  `json:"status"`
	MessageID     string                  `json:"message_id,omitempty"`
	WaitingPrompt *RequestUserInputPrompt `json:"waiting_prompt,omitempty"`
	ErrorCode     string                  `json:"error_code,omitempty"`
	Error         string                  `json:"error,omitempty"`
}

type FlowerLiveRunStatusChangedPayload struct {
	RunID         string                  `json:"run_id"`
	Status        string                  `json:"status"`
	ErrorCode     string                  `json:"error_code,omitempty"`
	Error         string                  `json:"error,omitempty"`
	WaitingPrompt *RequestUserInputPrompt `json:"waiting_prompt,omitempty"`
}

type FlowerLiveThreadPatch struct {
	ThreadID               string                        `json:"thread_id,omitempty"`
	Title                  string                        `json:"title,omitempty"`
	ModelID                string                        `json:"model_id,omitempty"`
	PermissionType         string                        `json:"permission_type,omitempty"`
	WorkingDir             string                        `json:"working_dir,omitempty"`
	QueuedTurnCount        *int                          `json:"queued_turn_count,omitempty"`
	RunStatus              string                        `json:"run_status,omitempty"`
	RunUpdatedAtUnixMs     int64                         `json:"run_updated_at_unix_ms,omitempty"`
	RunErrorCode           string                        `json:"run_error_code,omitempty"`
	RunError               string                        `json:"run_error,omitempty"`
	WaitingPrompt          *RequestUserInputPrompt       `json:"waiting_prompt,omitempty"`
	LastContextRunID       string                        `json:"last_context_run_id,omitempty"`
	PinnedAtUnixMs         int64                         `json:"pinned_at_unix_ms,omitempty"`
	CreatedAtUnixMs        int64                         `json:"created_at_unix_ms,omitempty"`
	UpdatedAtUnixMs        int64                         `json:"updated_at_unix_ms,omitempty"`
	LastMessageAtUnixMs    int64                         `json:"last_message_at_unix_ms,omitempty"`
	LastMessagePreview     string                        `json:"last_message_preview,omitempty"`
	ReasoningSelection     *config.AIReasoningSelection  `json:"reasoning_selection,omitempty"`
	ReasoningCapability    *config.AIReasoningCapability `json:"reasoning_capability,omitempty"`
	ReasoningSelectionSet  bool                          `json:"-"`
	ReasoningCapabilitySet bool                          `json:"-"`
	ReadStatus             *FlowerThreadReadView         `json:"read_status,omitempty"`
	Subagents              []FlowerSubagentSummary       `json:"subagents,omitempty"`
	SubagentsSet           bool                          `json:"-"`
}

type FlowerLiveThreadPatchedPayload struct {
	Patch FlowerLiveThreadPatch `json:"patch"`
}

type FlowerLiveTimelineReplacedPayload struct {
	Messages            []FlowerTimelineMessage     `json:"messages"`
	StreamGeneration    int64                       `json:"stream_generation"`
	SnapshotThroughSeq  int64                       `json:"snapshot_through_seq"`
	ThreadPatch         FlowerLiveThreadPatch       `json:"thread_patch"`
	LiveState           FlowerLiveMaterializedState `json:"live_state"`
	ContextUsage        *FlowerContextUsage         `json:"context_usage"`
	ContextCompactions  []FlowerContextCompaction   `json:"context_compactions"`
	TimelineDecorations []FlowerTimelineDecoration  `json:"timeline_decorations"`
}

type FlowerLiveUsageUpdatedPayload struct {
	Usage FlowerContextUsage `json:"usage"`
}

type FlowerModelIOPhase string

type FlowerModelIOStatus struct {
	Phase       FlowerModelIOPhase `json:"phase"`
	RunID       string             `json:"run_id,omitempty"`
	StepIndex   int                `json:"step_index,omitempty"`
	UpdatedAtMs int64              `json:"updated_at_ms"`
}

type FlowerPermissionType string

type FlowerReadStateCleaner interface {
	DeleteFlowerThreadReadState(context.Context, string, string) error
}

type FlowerSafeTarget struct {
	Kind  string `json:"kind"`
	Label string `json:"label"`
	URI   string `json:"uri,omitempty"`
}

type FlowerSubagentApprovalView struct {
	State    string            `json:"state,omitempty"`
	ToolID   string            `json:"tool_id,omitempty"`
	ToolName string            `json:"tool_name,omitempty"`
	ToolKind string            `json:"tool_kind,omitempty"`
	ArgsHash string            `json:"args_hash,omitempty"`
	Reason   string            `json:"reason,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type FlowerSubagentCompactionView struct {
	Trigger             string            `json:"trigger,omitempty"`
	Reason              string            `json:"reason,omitempty"`
	Phase               string            `json:"phase,omitempty"`
	TokensBefore        int64             `json:"tokens_before,omitempty"`
	TokensAfterEstimate int64             `json:"tokens_after_estimate,omitempty"`
	Metadata            map[string]string `json:"metadata,omitempty"`
}

type FlowerSubagentDetailMessage struct {
	Role    string `json:"role,omitempty"`
	Text    string `json:"text,omitempty"`
	Preview string `json:"preview,omitempty"`
}

type FlowerSubagentDetailResponse struct {
	Summary             FlowerSubagentSummary       `json:"summary"`
	Timeline            []FlowerSubagentTimelineRow `json:"timeline"`
	Activity            *ActivityTimelineBlock      `json:"activity,omitempty"`
	ModelIOStatus       *FlowerModelIOStatus        `json:"model_io_status,omitempty"`
	ContextUsage        *FlowerContextUsage         `json:"context_usage,omitempty"`
	ContextCompactions  []FlowerContextCompaction   `json:"context_compactions,omitempty"`
	TimelineDecorations []FlowerTimelineDecoration  `json:"timeline_decorations,omitempty"`
	NextOrdinal         int64                       `json:"next_ordinal,omitempty"`
	HasMore             bool                        `json:"has_more,omitempty"`
	RetainedFrom        int64                       `json:"retained_from,omitempty"`
	GeneratedAtMs       int64                       `json:"generated_at_ms"`
}

type FlowerSubagentGenericView struct {
	Title    string            `json:"title,omitempty"`
	Body     string            `json:"body,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type FlowerSubagentSummary struct {
	ParentThreadID  string `json:"parent_thread_id"`
	SubagentID      string `json:"subagent_id"`
	ThreadID        string `json:"thread_id"`
	TaskName        string `json:"task_name,omitempty"`
	TaskDescription string `json:"task_description,omitempty"`
	Title           string `json:"title,omitempty"`
	AgentType       string `json:"agent_type,omitempty"`
	ContextMode     string `json:"context_mode,omitempty"`
	Status          string `json:"status"`
	LastMessage     string `json:"last_message,omitempty"`
	WaitingPrompt   string `json:"waiting_prompt,omitempty"`
	QueuedInputs    int    `json:"queued_inputs,omitempty"`
	CanSendInput    bool   `json:"can_send_input"`
	CanInterrupt    bool   `json:"can_interrupt"`
	CanClose        bool   `json:"can_close"`
	CreatedAtUnixMs int64  `json:"created_at_ms,omitempty"`
	UpdatedAtUnixMs int64  `json:"updated_at_ms,omitempty"`
}

type FlowerSubagentTimelineRow struct {
	Ordinal     int64                         `json:"ordinal"`
	Kind        string                        `json:"kind"`
	Type        string                        `json:"type,omitempty"`
	CreatedAtMs int64                         `json:"created_at_ms"`
	Message     *FlowerSubagentDetailMessage  `json:"message,omitempty"`
	ToolCall    *FlowerSubagentToolCallView   `json:"tool_call,omitempty"`
	ToolResult  *FlowerSubagentToolResultView `json:"tool_result,omitempty"`
	Approval    *FlowerSubagentApprovalView   `json:"approval,omitempty"`
	TurnMarker  *FlowerSubagentTurnMarkerView `json:"turn_marker,omitempty"`
	Compaction  *FlowerSubagentCompactionView `json:"compaction,omitempty"`
	Generic     *FlowerSubagentGenericView    `json:"generic,omitempty"`
	Error       string                        `json:"error,omitempty"`
	Metadata    map[string]string             `json:"metadata,omitempty"`
}

type FlowerSubagentToolCallView struct {
	ID          string `json:"id,omitempty"`
	Name        string `json:"name,omitempty"`
	ArgsPreview string `json:"args_preview,omitempty"`
	ArgsHash    string `json:"args_hash,omitempty"`
}

type FlowerSubagentToolResultView struct {
	CallID        string `json:"call_id,omitempty"`
	ToolName      string `json:"tool_name,omitempty"`
	Status        string `json:"status,omitempty"`
	Preview       string `json:"preview,omitempty"`
	Truncated     bool   `json:"truncated,omitempty"`
	OriginalBytes int    `json:"original_bytes,omitempty"`
	VisibleBytes  int    `json:"visible_bytes,omitempty"`
	OriginalLines int    `json:"original_lines,omitempty"`
	VisibleLines  int    `json:"visible_lines,omitempty"`
	Strategy      string `json:"strategy,omitempty"`
	ContentSHA256 string `json:"content_sha256,omitempty"`
}

type FlowerSubagentTurnMarkerView struct {
	Status   string            `json:"status,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type FlowerThreadReadRecord struct {
	LastSeenActivityRevision  int64  `json:"last_seen_activity_revision"`
	LastReadMessageAtUnixMs   int64  `json:"last_read_message_at_unix_ms"`
	LastSeenActivitySignature string `json:"last_seen_activity_signature"`
	LastSeenWaitingPromptID   string `json:"last_seen_waiting_prompt_id,omitempty"`
}

type FlowerThreadReadSnapshot struct {
	ActivityRevision    int64  `json:"activity_revision"`
	LastMessageAtUnixMs int64  `json:"last_message_at_unix_ms"`
	ActivitySignature   string `json:"activity_signature"`
	WaitingPromptID     string `json:"waiting_prompt_id,omitempty"`
}

type FlowerThreadReadView struct {
	IsUnread  bool                     `json:"is_unread"`
	Snapshot  FlowerThreadReadSnapshot `json:"snapshot"`
	ReadState FlowerThreadReadRecord   `json:"read_state"`
}

type FlowerTimelineAnchor struct {
	TargetKind     string `json:"target_kind"`
	MessageID      string `json:"message_id"`
	BlockIndex     *int   `json:"block_index,omitempty"`
	ActivityItemID string `json:"activity_item_id,omitempty"`
	Edge           string `json:"edge"`
}

type FlowerTimelineDecoration struct {
	DecorationID          string                           `json:"decoration_id"`
	Kind                  FlowerTimelineDecorationKind     `json:"kind"`
	Anchor                FlowerTimelineAnchor             `json:"anchor"`
	Ordinal               int                              `json:"ordinal"`
	Compaction            FlowerContextCompaction          `json:"-"`
	ProjectionUnavailable *FlowerTurnProjectionUnavailable `json:"-"`
	// contains filtered or unexported fields
}

type FlowerTimelineDecorationKind string

type FlowerTimelineMessage struct {
	MessageID     string `json:"id"`
	Role          string `json:"role"`
	Content       string `json:"content"`
	Status        string `json:"status"`
	CreatedAtMs   int64  `json:"created_at_ms"`
	Blocks        []any  `json:"blocks,omitempty"`
	ContextAction any    `json:"context_action,omitempty"`
	Live          bool   `json:"live"`
	ActiveCursor  bool   `json:"active_cursor"`
}

type FlowerTurnProjectionUnavailable struct {
	TurnID            string                                `json:"turn_id"`
	RunID             string                                `json:"run_id"`
	ExpectedMessageID string                                `json:"expected_message_id"`
	Reason            FlowerTurnProjectionUnavailableReason `json:"reason"`
}

type FlowerTurnProjectionUnavailableReason string

type FollowupAttachmentView struct {
	Name     string `json:"name"`
	MimeType string `json:"mime_type"`
	URL      string `json:"url,omitempty"`
}

type FollowupItemView struct {
	FollowupID      string                   `json:"followup_id"`
	Lane            string                   `json:"lane"`
	MessageID       string                   `json:"message_id"`
	Text            string                   `json:"text"`
	ModelID         string                   `json:"model_id,omitempty"`
	PermissionType  string                   `json:"permission_type,omitempty"`
	Position        int                      `json:"position"`
	CreatedAtUnixMs int64                    `json:"created_at_unix_ms"`
	Attachments     []FollowupAttachmentView `json:"attachments,omitempty"`
	ContextAction   *ContextActionEnvelope   `json:"context_action,omitempty"`
}

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

type ListFollowupsResponse struct {
	Revision     int64              `json:"revision"`
	PausedReason string             `json:"paused_reason,omitempty"`
	Queued       []FollowupItemView `json:"queued"`
	Drafts       []FollowupItemView `json:"drafts"`
}

type ListRunEventsQuery struct {
	Cursor   int64
	Limit    int
	Category string
}

type ListRunEventsResponse struct {
	Events     []RunEventView `json:"events"`
	NextCursor int64          `json:"next_cursor,omitempty"`
	HasMore    bool           `json:"has_more,omitempty"`
}

type ListThreadMessagesResponse struct {
	Messages            []any                      `json:"messages"`
	TimelineDecorations []FlowerTimelineDecoration `json:"timeline_decorations,omitempty"`
	NextBeforeID        int64                      `json:"next_before_id,omitempty"`
	HasMore             bool                       `json:"has_more,omitempty"`
	TotalReturned       int                        `json:"total_returned,omitempty"`
}

type ListThreadsResponse struct {
	Threads    []ThreadView `json:"threads"`
	NextCursor string       `json:"next_cursor,omitempty"`
}

type LocalToolExecutionOptions struct {
	Logger          *slog.Logger
	StateDir        string
	AgentHomeDir    string
	WorkingDir      string
	FilesystemScope *filesystemscope.Registry
	Shell           string
	AIConfig        *config.AIConfig
	SessionMeta     *session.Meta
	ToolCallID      string
	ToolName        string
	Arguments       json.RawMessage
	Timeout         time.Duration
}

type LocalToolExecutionResult struct {
	ToolCallID string `json:"tool_call_id"`
	ToolName   string `json:"tool_name"`
	Result     any    `json:"result,omitempty"`
}

type LoopDetector interface {
	Detect(ctx context.Context, window []TurnSnapshot) (hit bool, reason string, confidence float64)
}

type Message struct {
	Role    string        `json:"role"`
	Content []ContentPart `json:"content"`
}

type ModeFlags struct {
	ReasoningOnly bool `json:"reasoning_only,omitempty"`
}

type Model struct {
	ID                  string                       `json:"id"`
	Label               string                       `json:"label,omitempty"`
	Source              string                       `json:"source,omitempty"`
	SourceLabel         string                       `json:"source_label,omitempty"`
	ContextWindow       int                          `json:"context_window,omitempty"`
	MaxOutputTokens     int                          `json:"max_output_tokens,omitempty"`
	InputModalities     []string                     `json:"input_modalities,omitempty"`
	SupportsImageInput  bool                         `json:"supports_image_input,omitempty"`
	ReasoningCapability config.AIReasoningCapability `json:"reasoning_capability,omitempty"`
}

type ModelGateway interface {
	StreamTurn(ctx context.Context, req ModelGatewayRequest, onEvent func(StreamEvent)) (ModelGatewayResult, error)
}

type ModelGatewayRequest struct {
	Model            string           `json:"model"`
	Messages         []Message        `json:"messages"`
	Tools            []ToolDef        `json:"tools"`
	Budgets          TurnBudgets      `json:"budgets"`
	ModeFlags        ModeFlags        `json:"mode_flags"`
	ProviderControls ProviderControls `json:"provider_controls,omitempty"`
	WebSearchMode    string           `json:"web_search_mode,omitempty"`
}

type ModelGatewayResult struct {
	FinishReason    string             `json:"finish_reason"`
	Text            string             `json:"text,omitempty"`
	Reasoning       string             `json:"reasoning,omitempty"`
	ToolCalls       []ToolCall         `json:"tool_calls,omitempty"`
	Sources         []SourceRef        `json:"sources,omitempty"`
	Usage           TurnUsage          `json:"usage,omitempty"`
	ProviderState   *ModelGatewayState `json:"provider_state,omitempty"`
	RawProviderDiag map[string]any     `json:"raw_provider_diag,omitempty"`
	StreamEvents    []StreamEvent      `json:"stream_events,omitempty"`
	ToolResults     []ToolResult       `json:"tool_results,omitempty"`
}

type ModelGatewayState struct {
	Kind       string            `json:"kind,omitempty"`
	ID         string            `json:"id,omitempty"`
	Attributes map[string]string `json:"attributes,omitempty"`
}

type ModelSelectInput struct {
	Mode          string
	ReasoningOnly bool
	Configured    string
}

type ModelSelector interface {
	Select(ctx context.Context, in ModelSelectInput) (provider string, model string, reason string)
}

type ModelsResponse struct {
	CurrentModel string           `json:"current_model"`
	Models       []Model          `json:"models"`
	Runtime      *AIRuntimeStatus `json:"runtime,omitempty"`
}

type Options struct {
	Logger   *slog.Logger
	StateDir string

	AgentHomeDir    string
	Shell           string
	FilesystemScope *filesystemscope.Registry

	Config *config.AIConfig

	ToolTargetPolicy       ToolTargetPolicy
	TargetToolExecutor     TargetToolExecutor
	ToolTargetPolicyForRun func(meta *session.Meta, thread threadstore.Thread, flowerMeta *threadstore.FlowerThreadMetadata) ToolTargetPolicy

	// PersistOpTimeout is the per-operation timeout for threadstore persistence
	// (SQLite reads/writes). It must NOT be tied to a run's overall lifetime, since
	// runs can take much longer than persistence should ever be allowed to block.
	//
	// When zero, it defaults to 10 seconds.
	PersistOpTimeout time.Duration

	// RunMaxWallTime is the hard cap for a single run's lifetime.
	//
	// When zero, it defaults to 15 minutes.
	RunMaxWallTime time.Duration
	// RunIdleTimeout cancels a run if no runtime stream activity is observed for the duration.
	//
	// When zero, it defaults to 2 minutes.
	RunIdleTimeout time.Duration
	// ToolApprovalTimeout is the max time a run waits for user approval for high-risk tools.
	//
	// When zero, it defaults to 10 minutes.
	ToolApprovalTimeout time.Duration
	// StreamWriteTimeout is the best-effort per-frame write deadline for the NDJSON stream.
	//
	// When zero, it defaults to 5 seconds.
	StreamWriteTimeout time.Duration

	// ResolveProviderAPIKey returns the API key for the given provider id.
	//
	// It should read from a local secrets store, not from config.json.
	ResolveProviderAPIKey func(providerID string) (string, bool, error)

	// ResolveWebSearchProviderAPIKey returns the API key for a provider-scoped web search backend.
	//
	// It should read from a local secrets store, not from config.json.
	ResolveWebSearchProviderAPIKey func(providerID string) (string, bool, error)

	FlowerReadStateCleaner    FlowerReadStateCleaner
	OpenThreadMaintenanceHost func() (ThreadMaintenanceHost, error)
}

type PartialToolCall struct {
	ID            string         `json:"id,omitempty"`
	Name          string         `json:"name,omitempty"`
	ArgumentsJSON string         `json:"arguments_json,omitempty"`
	Arguments     map[string]any `json:"arguments,omitempty"`
}

type PartialUsage struct {
	InputTokens     int64 `json:"input_tokens,omitempty"`
	OutputTokens    int64 `json:"output_tokens,omitempty"`
	ReasoningTokens int64 `json:"reasoning_tokens,omitempty"`
}

type PatchFollowupRequest struct {
	Text *string `json:"text,omitempty"`
}

type PatchThreadRequest struct {
	Title              *string         `json:"title,omitempty"`
	ModelID            *string         `json:"model_id,omitempty"`
	PermissionType     *string         `json:"permission_type,omitempty"`
	Pinned             *bool           `json:"pinned,omitempty"`
	ReasoningSelection json.RawMessage `json:"reasoning_selection,omitempty"`
}

type PendingToolResult struct {
	Handle      string            `json:"handle"`
	Summary     string            `json:"summary"`
	Instruction string            `json:"instruction"`
	Metadata    map[string]string `json:"metadata,omitempty"`
}

type PermissionSnapshot struct {
	Version               int                             `json:"version"`
	SnapshotID            string                          `json:"snapshot_id,omitempty"`
	PermissionType        FlowerPermissionType            `json:"permission_type"`
	VisibleToolNames      []string                        `json:"visible_tool_names"`
	PromptCapabilityNames []string                        `json:"prompt_capability_names"`
	FloretToolNames       []string                        `json:"floret_tool_names"`
	ToolPolicies          map[string]ToolPermissionPolicy `json:"tool_policies"`
	SnapshotHash          string                          `json:"snapshot_hash,omitempty"`
	RegistryHash          string                          `json:"registry_hash,omitempty"`
	SchemaHash            string                          `json:"schema_hash,omitempty"`
	PresentationHash      string                          `json:"presentation_hash,omitempty"`
	// contains filtered or unexported fields
}

type PermissionToolFilter interface {
	FilterTools(permissionType FlowerPermissionType, all []ToolDef) []ToolDef
}

type ProviderControls struct {
	ReasoningSelection  config.AIReasoningSelection  `json:"reasoning_selection,omitempty"`
	ReasoningCapability config.AIReasoningCapability `json:"reasoning_capability,omitempty"`
	CacheControl        string                       `json:"cache_control,omitempty"`
	ResponseFormat      string                       `json:"response_format,omitempty"`
	PreviousResponseID  string                       `json:"previous_response_id,omitempty"`
	Temperature         *float64                     `json:"temperature,omitempty"`
	TopP                *float64                     `json:"top_p,omitempty"`
}

type QueuedTurnView struct {
	MessageID       string                 `json:"message_id"`
	Text            string                 `json:"text"`
	CreatedAtUnixMs int64                  `json:"created_at_unix_ms"`
	ContextAction   *ContextActionEnvelope `json:"context_action,omitempty"`
}

type RealtimeEvent struct {
	EventType     RealtimeEventType       `json:"event_type"`
	EndpointID    string                  `json:"endpoint_id"`
	ThreadID      string                  `json:"thread_id"`
	RunID         string                  `json:"run_id"`
	AtUnixMs      int64                   `json:"at_unix_ms"`
	StreamKind    RealtimeStreamKind      `json:"stream_kind,omitempty"`
	Phase         RealtimeLifecyclePhase  `json:"phase,omitempty"`
	Diag          map[string]any          `json:"diag,omitempty"`
	StreamEvent   any                     `json:"stream_event,omitempty"`
	RunStatus     string                  `json:"run_status,omitempty"`
	RunErrorCode  string                  `json:"run_error_code,omitempty"`
	RunError      string                  `json:"run_error,omitempty"`
	WaitingPrompt *RequestUserInputPrompt `json:"waiting_prompt,omitempty"`

	// Transcript message events (EventType=transcript_message).
	MessageRowID int64           `json:"message_row_id,omitempty"`
	MessageJSON  json.RawMessage `json:"message_json,omitempty"`

	// Thread summary events (EventType=thread_summary).
	Title               string                       `json:"title,omitempty"`
	ModelID             string                       `json:"model_id,omitempty"`
	UpdatedAtUnixMs     int64                        `json:"updated_at_unix_ms,omitempty"`
	LastMessagePreview  string                       `json:"last_message_preview,omitempty"`
	LastMessageAtUnixMs int64                        `json:"last_message_at_unix_ms,omitempty"`
	ActiveRunID         string                       `json:"active_run_id,omitempty"`
	LastContextRunID    string                       `json:"last_context_run_id,omitempty"`
	PermissionType      string                       `json:"permission_type,omitempty"`
	QueuedTurnCount     int                          `json:"queued_turn_count,omitempty"`
	ReasoningSelection  config.AIReasoningSelection  `json:"reasoning_selection,omitempty"`
	ReasoningCapability config.AIReasoningCapability `json:"reasoning_capability,omitempty"`

	// Transcript reset events (EventType=transcript_reset).
	ResetReason       string `json:"reset_reason,omitempty"`
	ResetCheckpointID string `json:"reset_checkpoint_id,omitempty"`
}

type RealtimeEventType string

type RealtimeLifecyclePhase string

type RealtimeStreamKind string

type ReorderFollowupsRequest struct {
	Lane               string   `json:"lane"`
	OrderedFollowupIDs []string `json:"ordered_followup_ids"`
	ExpectedRevision   *int64   `json:"expected_revision,omitempty"`
}

type RequestUserInputAction struct {
	Type string `json:"type"`
}

type RequestUserInputAnswer struct {
	ChoiceID string `json:"choice_id,omitempty"`
	Text     string `json:"text,omitempty"`
}

type RequestUserInputChoice struct {
	ChoiceID         string                   `json:"choice_id"`
	Label            string                   `json:"label"`
	Description      string                   `json:"description,omitempty"`
	Kind             string                   `json:"kind"`
	InputPlaceholder string                   `json:"input_placeholder,omitempty"`
	Actions          []RequestUserInputAction `json:"actions,omitempty"`
}

type RequestUserInputPrompt struct {
	PromptID           string                      `json:"prompt_id"`
	MessageID          string                      `json:"message_id"`
	ToolID             string                      `json:"tool_id"`
	ToolName           string                      `json:"tool_name"`
	ReasonCode         string                      `json:"reason_code,omitempty"`
	ReasoningSelection config.AIReasoningSelection `json:"reasoning_selection,omitempty"`
	RequiredFromUser   []string                    `json:"required_from_user,omitempty"`
	EvidenceRefs       []string                    `json:"evidence_refs,omitempty"`
	Questions          []RequestUserInputQuestion  `json:"questions,omitempty"`
	PublicSummary      string                      `json:"public_summary,omitempty"`
	ContainsSecret     bool                        `json:"contains_secret,omitempty"`
}

type RequestUserInputQuestion struct {
	ID                string                   `json:"id"`
	Header            string                   `json:"header"`
	Question          string                   `json:"question"`
	IsSecret          bool                     `json:"is_secret"`
	ResponseMode      string                   `json:"response_mode,omitempty"`
	ChoicesExhaustive *bool                    `json:"choices_exhaustive,omitempty"`
	WriteLabel        string                   `json:"write_label,omitempty"`
	WritePlaceholder  string                   `json:"write_placeholder,omitempty"`
	Choices           []RequestUserInputChoice `json:"choices,omitempty"`
}

type RequestUserInputResolvedQuestion struct {
	QuestionID          string `json:"question_id"`
	Header              string `json:"header,omitempty"`
	Question            string `json:"question,omitempty"`
	SelectedChoiceID    string `json:"selected_choice_id,omitempty"`
	SelectedChoiceLabel string `json:"selected_choice_label,omitempty"`
	Text                string `json:"text,omitempty"`
	PublicSummary       string `json:"public_summary,omitempty"`
	ContainsSecret      bool   `json:"contains_secret,omitempty"`
}

type RequestUserInputResponse struct {
	PromptID string                            `json:"prompt_id"`
	Answers  map[string]RequestUserInputAnswer `json:"answers"`
}

type RequestUserInputResponseRecord struct {
	PromptID          string                             `json:"prompt_id"`
	ToolID            string                             `json:"tool_id,omitempty"`
	ReasonCode        string                             `json:"reason_code,omitempty"`
	Responses         []RequestUserInputResolvedQuestion `json:"responses,omitempty"`
	PublicSummary     string                             `json:"public_summary,omitempty"`
	ContainsSecret    bool                               `json:"contains_secret,omitempty"`
	ResponseMessageID string                             `json:"response_message_id,omitempty"`
}

type RequestUserInputSecretAnswer struct {
	QuestionID string `json:"question_id"`
	Text       string `json:"text,omitempty"`
}

type RunAttachmentIn struct {
	Name     string `json:"name"`
	MimeType string `json:"mime_type"`
	URL      string `json:"url"`
}

type RunEventView struct {
	EventID    int64  `json:"event_id"`
	RunID      string `json:"run_id"`
	ThreadID   string `json:"thread_id"`
	StreamKind string `json:"stream_kind,omitempty"`
	EventType  string `json:"event_type"`
	AtUnixMs   int64  `json:"at_unix_ms"`
	Payload    any    `json:"payload,omitempty"`
}

type RunInput struct {
	// MessageID is an optional client-supplied id for the user input message persisted in the transcript.
	//
	// When set, the agent will prefer this id over generating a new one so the UI can keep a stable
	// message id across optimistic rendering, realtime events, and history backfill.
	MessageID          string                          `json:"message_id,omitempty"`
	Text               string                          `json:"text"`
	Attachments        []RunAttachmentIn               `json:"attachments"`
	ContextAction      *ContextActionEnvelope          `json:"context_action,omitempty"`
	StructuredResponse *RequestUserInputResponseRecord `json:"-"`
	SecretAnswers      []RequestUserInputSecretAnswer  `json:"-"`
}

type RunOptions struct {
	// ReasoningOnly relaxes tool-pressure heuristics while preserving the same Floret turn flow.
	ReasoningOnly bool `json:"reasoning_only,omitempty"`

	// RequireUserConfirmOnTaskComplete forces explicit user confirmation when model emits task_complete.
	RequireUserConfirmOnTaskComplete bool `json:"require_user_confirm_on_task_complete,omitempty"`

	// NoUserInteraction prevents direct user-input prompts for autonomous runs.
	// Tool approval waits are governed by the explicit approver/delegation policy.
	NoUserInteraction bool `json:"no_user_interaction,omitempty"`

	// ToolAllowlist is an internal runtime guard that limits the visible tool surface
	// for the current run. It is intended for runtime-owned callers such as evals and
	// subagents rather than general user-facing requests.
	ToolAllowlist []string `json:"tool_allowlist,omitempty"`

	// PermissionType controls the run tool surface and approval policy.
	PermissionType string `json:"permission_type,omitempty"`

	// Provider controls.
	ReasoningSelection config.AIReasoningSelection `json:"reasoning_selection,omitempty"`
	CacheControl       string                      `json:"cache_control,omitempty"`
	ResponseFormat     string                      `json:"response_format,omitempty"`
	Temperature        *float64                    `json:"temperature,omitempty"`
	TopP               *float64                    `json:"top_p,omitempty"`

	// Optional hard budgets (0 means unset). Input is cumulative across one run;
	// output is the maximum for each provider request.
	MaxInputTokens  int     `json:"max_input_tokens,omitempty"`
	MaxOutputTokens int     `json:"max_output_tokens,omitempty"`
	MaxCostUSD      float64 `json:"max_cost_usd,omitempty"`

	// CompactionThreshold controls when runtime compaction is triggered.
	// Value is a fraction in range [0,1]. 0 means use runtime default.
	CompactionThreshold float64 `json:"compaction_threshold,omitempty"`
}

type RunRequest struct {
	Model           string                       `json:"model"`
	Objective       string                       `json:"objective,omitempty"`
	Input           RunInput                     `json:"input"`
	Options         RunOptions                   `json:"options"`
	ModelCapability contextmodel.ModelCapability `json:"-"`
}

type RunStartRequest struct {
	ThreadID string     `json:"thread_id"`
	Model    string     `json:"model"`
	Input    RunInput   `json:"input"`
	Options  RunOptions `json:"options"`
}

type RunState string

type SendUserTurnRequest struct {
	ThreadID              string     `json:"thread_id"`
	Model                 string     `json:"model,omitempty"`
	Input                 RunInput   `json:"input"`
	Options               RunOptions `json:"options"`
	ExpectedRunID         string     `json:"expected_run_id,omitempty"`
	QueueAfterWaitingUser bool       `json:"queue_after_waiting_user,omitempty"`
	SourceFollowupID      string     `json:"source_followup_id,omitempty"`
}

type SendUserTurnResponse struct {
	RunID                   string `json:"run_id"`
	Kind                    string `json:"kind"` // "start" | "queued"
	QueueID                 string `json:"queue_id,omitempty"`
	QueuePosition           int    `json:"queue_position,omitempty"`
	ConsumedWaitingPromptID string `json:"consumed_waiting_prompt_id,omitempty"`
	AppliedPermissionType   string `json:"applied_permission_type,omitempty"`
}

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

type SkillActivation struct {
	ActivationID    string               `json:"activation_id"`
	Name            string               `json:"name"`
	RootDir         string               `json:"root_dir"`
	Priority        int                  `json:"priority"`
	Content         string               `json:"content"`
	ContentRef      string               `json:"content_ref"`
	PermissionHints []string             `json:"permission_hints,omitempty"`
	Dependencies    []SkillMCPDependency `json:"dependencies,omitempty"`
	ActivatedAt     int64                `json:"activated_at_unix_ms"`
}

type SkillBrowseFileResult struct {
	Root      string `json:"root"`
	File      string `json:"file"`
	Encoding  string `json:"encoding"`
	Truncated bool   `json:"truncated"`
	Size      int64  `json:"size"`
	Content   string `json:"content"`
}

type SkillBrowseTreeEntry struct {
	Name             string `json:"name"`
	Path             string `json:"path"`
	IsDir            bool   `json:"is_dir"`
	Size             int64  `json:"size"`
	ModifiedAtUnixMs int64  `json:"modified_at_unix_ms"`
}

type SkillBrowseTreeResult struct {
	Root    string                 `json:"root"`
	Dir     string                 `json:"dir"`
	Entries []SkillBrowseTreeEntry `json:"entries"`
}

type SkillCatalog struct {
	CatalogVersion int64                `json:"catalog_version"`
	Skills         []SkillCatalogEntry  `json:"skills"`
	Conflicts      []SkillCatalogNotice `json:"conflicts,omitempty"`
	Errors         []SkillCatalogNotice `json:"errors,omitempty"`
}

type SkillCatalogEntry struct {
	ID                      string               `json:"id"`
	Name                    string               `json:"name"`
	Description             string               `json:"description"`
	Path                    string               `json:"path"`
	Scope                   string               `json:"scope"`
	Priority                int                  `json:"priority,omitempty"`
	PermissionHints         []string             `json:"permission_hints,omitempty"`
	AllowImplicitInvocation bool                 `json:"allow_implicit_invocation"`
	Dependencies            []SkillMCPDependency `json:"dependencies,omitempty"`
	DependencyState         string               `json:"dependency_state,omitempty"`
	Enabled                 bool                 `json:"enabled"`
	Effective               bool                 `json:"effective"`
	ShadowedBy              string               `json:"shadowed_by,omitempty"`
}

type SkillCatalogNotice struct {
	Name       string `json:"name,omitempty"`
	Path       string `json:"path,omitempty"`
	Message    string `json:"message,omitempty"`
	WinnerPath string `json:"winner_path,omitempty"`
}

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

type SkillGitHubAuth struct {
	GitHubToken            string `json:"github_token,omitempty"`
	UseLocalGitCredentials bool   `json:"use_local_git_credentials,omitempty"`
}

type SkillGitHubCatalog struct {
	Source SkillGitHubCatalogSource `json:"source"`
	Skills []SkillGitHubCatalogItem `json:"skills"`
}

type SkillGitHubCatalogItem struct {
	RemoteID       string   `json:"remote_id"`
	Name           string   `json:"name"`
	Description    string   `json:"description"`
	RepoPath       string   `json:"repo_path"`
	ExistsLocal    bool     `json:"exists_local"`
	InstalledPaths []string `json:"installed_paths,omitempty"`
}

type SkillGitHubCatalogRequest struct {
	Repo        string `json:"repo,omitempty"`
	Ref         string `json:"ref,omitempty"`
	BasePath    string `json:"base_path,omitempty"`
	ForceReload bool   `json:"force_reload,omitempty"`
}

type SkillGitHubCatalogSource struct {
	Repo     string `json:"repo"`
	Ref      string `json:"ref"`
	BasePath string `json:"base_path"`
}

type SkillGitHubImportItem struct {
	Name            string          `json:"name"`
	Scope           string          `json:"scope"`
	SkillPath       string          `json:"skill_path"`
	SourceType      SkillSourceType `json:"source_type"`
	SourceID        string          `json:"source_id"`
	InstallMode     string          `json:"install_mode"`
	InstalledCommit string          `json:"installed_commit,omitempty"`
}

type SkillGitHubImportRequest struct {
	Scope     string          `json:"scope"`
	Repo      string          `json:"repo,omitempty"`
	Ref       string          `json:"ref,omitempty"`
	Paths     []string        `json:"paths,omitempty"`
	URL       string          `json:"url,omitempty"`
	Overwrite bool            `json:"overwrite,omitempty"`
	Auth      SkillGitHubAuth `json:"auth,omitempty"`
}

type SkillGitHubImportResult struct {
	Catalog SkillCatalog            `json:"catalog"`
	Imports []SkillGitHubImportItem `json:"imports"`
}

type SkillGitHubResolvedSkill struct {
	Name            string `json:"name"`
	Description     string `json:"description"`
	Scope           string `json:"scope,omitempty"`
	Repo            string `json:"repo"`
	Ref             string `json:"ref"`
	RepoPath        string `json:"repo_path"`
	TargetDir       string `json:"target_dir"`
	TargetSkillPath string `json:"target_skill_path"`
	AlreadyExists   bool   `json:"already_exists"`
}

type SkillGitHubValidateResult struct {
	Resolved []SkillGitHubResolvedSkill `json:"resolved"`
}

type SkillMCPDependency struct {
	Name      string `json:"name,omitempty" yaml:"name"`
	Transport string `json:"transport,omitempty" yaml:"transport"`
	Command   string `json:"command,omitempty" yaml:"command"`
	URL       string `json:"url,omitempty" yaml:"url"`
}

type SkillMeta struct {
	Name                    string               `json:"name"`
	Description             string               `json:"description"`
	Path                    string               `json:"path"`
	Scope                   string               `json:"scope"`
	Priority                int                  `json:"priority,omitempty"`
	PermissionHints         []string             `json:"permission_hints,omitempty"`
	AllowImplicitInvocation bool                 `json:"allow_implicit_invocation"`
	Dependencies            []SkillMCPDependency `json:"dependencies,omitempty"`
}

type SkillReinstallItem struct {
	SkillPath   string `json:"skill_path"`
	SourceID    string `json:"source_id"`
	InstallMode string `json:"install_mode"`
}

type SkillReinstallResult struct {
	Catalog     SkillCatalog         `json:"catalog"`
	Reinstalled []SkillReinstallItem `json:"reinstalled"`
}

type SkillSourceRecord struct {
	SkillPath           string          `json:"skill_path"`
	SourceType          SkillSourceType `json:"source_type"`
	SourceID            string          `json:"source_id"`
	Repo                string          `json:"repo,omitempty"`
	Ref                 string          `json:"ref,omitempty"`
	RepoPath            string          `json:"repo_path,omitempty"`
	InstallMode         string          `json:"install_mode,omitempty"`
	InstalledCommit     string          `json:"installed_commit,omitempty"`
	InstalledAtUnixMs   int64           `json:"installed_at_unix_ms,omitempty"`
	LastCheckedAtUnixMs int64           `json:"last_checked_at_unix_ms,omitempty"`
}

type SkillSourceType string

type SkillSourcesView struct {
	Items []SkillSourceRecord `json:"items"`
}

type SkillTogglePatch struct {
	Path    string `json:"path"`
	Enabled bool   `json:"enabled"`
}

type SourceRef struct {
	Title string `json:"title,omitempty"`
	URL   string `json:"url"`
}

type StopThreadRequest struct {
	ThreadID string `json:"thread_id"`
}

type StopThreadResponse struct {
	OK                 bool               `json:"ok"`
	RecoveredFollowups []FollowupItemView `json:"recovered_followups,omitempty"`
}

type StreamEvent struct {
	Type       StreamEventType  `json:"type"`
	Text       string           `json:"text,omitempty"`
	ToolCall   *PartialToolCall `json:"tool_call,omitempty"`
	Usage      *PartialUsage    `json:"usage,omitempty"`
	FinishHint string           `json:"finish_hint,omitempty"`
}

type StreamEventType string

type SubmitFlowerApprovalRequest struct {
	ThreadID        string                `json:"thread_id"`
	Origin          FlowerApprovalOrigin  `json:"origin,omitempty"`
	RunID           string                `json:"run_id"`
	ActionID        string                `json:"action_id"`
	ToolID          string                `json:"tool_id"`
	Approved        bool                  `json:"approved"`
	ExpectedSeq     int64                 `json:"expected_seq"`
	Revision        int64                 `json:"revision"`
	Version         int64                 `json:"version,omitempty"`
	SurfaceEpoch    int64                 `json:"surface_epoch,omitempty"`
	QueueGeneration int64                 `json:"queue_generation"`
	QueueRevision   int64                 `json:"queue_revision"`
	IdempotencyKey  string                `json:"idempotency_key,omitempty"`
	DelegatedRef    *DelegatedApprovalRef `json:"delegated_ref,omitempty"`
}

type SubmitFlowerApprovalResponse struct {
	OK            bool  `json:"ok"`
	CurrentCursor int64 `json:"current_cursor"`
}

type SubmitRequestUserInputResponseRequest struct {
	ThreadID         string                   `json:"thread_id"`
	Model            string                   `json:"model,omitempty"`
	Response         RequestUserInputResponse `json:"response"`
	Input            RunInput                 `json:"input"`
	Options          RunOptions               `json:"options"`
	ExpectedRunID    string                   `json:"expected_run_id,omitempty"`
	SourceFollowupID string                   `json:"source_followup_id,omitempty"`
}

type SubmitRequestUserInputResponseResponse struct {
	RunID                   string `json:"run_id"`
	Kind                    string `json:"kind"`
	ConsumedWaitingPromptID string `json:"consumed_waiting_prompt_id,omitempty"`
	AppliedPermissionType   string `json:"applied_permission_type,omitempty"`
}

type TargetToolCall struct {
	ToolCallID           string          `json:"tool_call_id"`
	TargetID             string          `json:"target_id"`
	ToolName             string          `json:"tool_name"`
	Arguments            json.RawMessage `json:"arguments"`
	RequiredCapabilities []string        `json:"required_capabilities"`
}

type TargetToolExecutor interface {
	ExecuteTargetTool(ctx context.Context, call TargetToolCall) (TargetToolResult, error)
}

type TargetToolResult struct {
	TargetID          string `json:"target_id"`
	ExecutionLocation string `json:"execution_location,omitempty"`
	Result            any    `json:"result,omitempty"`
}

type TerminalToolOutput struct {
	RunID           string `json:"run_id"`
	ToolID          string `json:"tool_id"`
	ToolName        string `json:"tool_name"`
	Status          string `json:"status"`
	ProcessID       string `json:"process_id,omitempty"`
	Output          string `json:"output,omitempty"`
	LatestOutput    string `json:"latest_output,omitempty"`
	Stdout          string `json:"stdout"`
	Stderr          string `json:"stderr"`
	ExitCode        int    `json:"exit_code"`
	DurationMS      int64  `json:"duration_ms"`
	Truncated       bool   `json:"truncated"`
	Cwd             string `json:"cwd,omitempty"`
	FirstSeq        int64  `json:"first_seq,omitempty"`
	LastSeq         int64  `json:"last_seq,omitempty"`
	TotalBytes      int64  `json:"total_bytes,omitempty"`
	StartedAtUnixMs int64  `json:"started_at_ms,omitempty"`
	EndedAtUnixMs   int64  `json:"ended_at_ms,omitempty"`
	RawResult       string `json:"raw_result,omitempty"`
}

type ThreadDeleteResult struct {
	OperationID string             `json:"operation_id"`
	Status      ThreadDeleteStatus `json:"status"`
}

type ThreadDeleteStatus string

type ThreadMaintenanceHost interface {
	DeleteThread(context.Context, flruntime.ThreadID) error
	Close() error
}

type ThreadTodosView struct {
	Version         int64      `json:"version"`
	UpdatedAtUnixMs int64      `json:"updated_at_unix_ms"`
	Todos           []TodoItem `json:"todos"`
}

type ThreadView struct {
	ThreadID            string                       `json:"thread_id"`
	Title               string                       `json:"title"`
	ModelID             string                       `json:"model_id"`
	PermissionType      string                       `json:"permission_type"`
	WorkingDir          string                       `json:"working_dir"`
	QueuedTurnCount     int                          `json:"queued_turn_count"`
	QueuedTurns         []QueuedTurnView             `json:"queued_turns,omitempty"`
	RunStatus           string                       `json:"run_status"`
	ReadOnlyReason      string                       `json:"read_only_reason,omitempty"`
	OwnerKind           string                       `json:"owner_kind,omitempty"`
	OwnerID             string                       `json:"owner_id,omitempty"`
	ParentThreadID      string                       `json:"parent_thread_id,omitempty"`
	RunUpdatedAtUnixMs  int64                        `json:"run_updated_at_unix_ms"`
	RunErrorCode        string                       `json:"run_error_code,omitempty"`
	RunError            string                       `json:"run_error,omitempty"`
	WaitingPrompt       *RequestUserInputPrompt      `json:"waiting_prompt,omitempty"`
	LastContextRunID    string                       `json:"last_context_run_id,omitempty"`
	ReasoningSelection  config.AIReasoningSelection  `json:"reasoning_selection,omitempty"`
	ReasoningCapability config.AIReasoningCapability `json:"reasoning_capability,omitempty"`
	PinnedAtUnixMs      int64                        `json:"pinned_at_unix_ms,omitempty"`
	CreatedAtUnixMs     int64                        `json:"created_at_unix_ms"`
	UpdatedAtUnixMs     int64                        `json:"updated_at_unix_ms"`
	LastMessageAtUnixMs int64                        `json:"last_message_at_unix_ms"`
	LastMessagePreview  string                       `json:"last_message_preview"`
	Subagents           []FlowerSubagentSummary      `json:"subagents,omitempty"`
	FlowerActivity      FlowerThreadReadSnapshot     `json:"-"`
}

type TodoItem struct {
	ID      string `json:"id"`
	Content string `json:"content"`
	Status  string `json:"status"`
	Note    string `json:"note,omitempty"`
}

type TodoSummary struct {
	Total      int `json:"total"`
	Pending    int `json:"pending"`
	InProgress int `json:"in_progress"`
	Completed  int `json:"completed"`
	Cancelled  int `json:"cancelled"`
}

type ToolApprovalRequest struct {
	ToolID   string `json:"tool_id"`
	Approved bool   `json:"approved"`
}

type ToolCall struct {
	ID   string         `json:"id,omitempty"`
	Name string         `json:"name"`
	Args map[string]any `json:"args,omitempty"`
}

type ToolCapabilityClass string

type ToolDef struct {
	Name             string                       `json:"name"`
	Description      string                       `json:"description,omitempty"`
	InputSchema      json.RawMessage              `json:"input_schema,omitempty"`
	Mutating         bool                         `json:"mutating,omitempty"`
	RequiresApproval bool                         `json:"requires_approval,omitempty"`
	Visibility       ToolVisibilityClass          `json:"visibility,omitempty"`
	Capabilities     []ToolCapabilityClass        `json:"capabilities,omitempty"`
	Presentation     aitools.ToolPresentationSpec `json:"presentation,omitempty"`
	Source           string                       `json:"source,omitempty"`
	Namespace        string                       `json:"namespace,omitempty"`
	Priority         int                          `json:"priority,omitempty"`
}

type ToolDetail struct {
	RunID           string         `json:"run_id"`
	ToolID          string         `json:"tool_id"`
	ToolName        string         `json:"tool_name"`
	Status          string         `json:"status"`
	Args            map[string]any `json:"args,omitempty"`
	Result          any            `json:"result,omitempty"`
	ErrorCode       string         `json:"error_code,omitempty"`
	ErrorMessage    string         `json:"error_message,omitempty"`
	Retryable       bool           `json:"retryable,omitempty"`
	RecoveryAction  string         `json:"recovery_action,omitempty"`
	StartedAtUnixMs int64          `json:"started_at_unix_ms,omitempty"`
	EndedAtUnixMs   int64          `json:"ended_at_unix_ms,omitempty"`
	LatencyMS       int64          `json:"latency_ms,omitempty"`
	RawArgs         string         `json:"raw_args,omitempty"`
	RawResult       string         `json:"raw_result,omitempty"`
}

type ToolHandler interface {
	Validate(ctx context.Context, call ToolCall) error
	Execute(ctx context.Context, call ToolCall) (ToolResult, error)
	HandlePartial(ctx context.Context, partial PartialToolCall) error
}

type ToolPermissionPolicy struct {
	Visibility       ToolVisibilityClass   `json:"visibility"`
	Capabilities     []ToolCapabilityClass `json:"capabilities,omitempty"`
	ResourceKinds    []string              `json:"resource_kinds,omitempty"`
	ApprovalDecision ApprovalDecisionKind  `json:"approval_decision"`
}

type ToolRegistry interface {
	Register(tool ToolDef, handler ToolHandler) error
	Unregister(name string) error
	Snapshot() []ToolDef
}

type ToolResult struct {
	ToolID     string             `json:"tool_id,omitempty"`
	ToolName   string             `json:"tool_name,omitempty"`
	Status     string             `json:"status"`
	Summary    string             `json:"summary,omitempty"`
	Details    string             `json:"details,omitempty"`
	Data       any                `json:"data,omitempty"`
	Pending    *PendingToolResult `json:"pending,omitempty"`
	Error      *aitools.ToolError `json:"error,omitempty"`
	Truncated  bool               `json:"truncated,omitempty"`
	ContentRef string             `json:"content_ref,omitempty"`
}

type ToolTargetPolicy struct {
	Mode             string   `json:"mode"`
	DefaultTargetID  string   `json:"default_target_id,omitempty"`
	AllowedTargetIDs []string `json:"allowed_target_ids,omitempty"`
}

type ToolVisibilityClass string

type TurnBudgets struct {
	// MaxOutputToken limits one provider request, not cumulative run output.
	MaxOutputToken int     `json:"max_output_tokens,omitempty"`
	MaxCostUSD     float64 `json:"max_cost_usd,omitempty"`
}

type TurnSnapshot struct {
	ToolCalls    []ToolCall
	ToolResults  []ToolResult
	FinishReason string
	Assistant    string
}

type TurnUsage struct {
	InputTokens     int64 `json:"input_tokens,omitempty"`
	OutputTokens    int64 `json:"output_tokens,omitempty"`
	ReasoningTokens int64 `json:"reasoning_tokens,omitempty"`
}

type UploadResponse struct {
	URL      string `json:"url"`
	Name     string `json:"name"`
	Size     int64  `json:"size"`
	MimeType string `json:"mime_type"`
}