types

type Diagnosis struct {
	// FailureType categorizes the detected issue.
	FailureType FailureType `json:"failure_type"`

	// RootCause provides a human-readable explanation of what went wrong.
	RootCause string `json:"root_cause"`

	// Confidence is the Doctor's confidence in the diagnosis (0.0 to 1.0).
	Confidence float64 `json:"confidence"`

	// Remediation specifies the recommended action.
	Remediation RemediationType `json:"remediation"`

	// RemediationArgs contains action-specific parameters (e.g., flags to apply, pattern to inject).
	RemediationArgs map[string]string `json:"remediation_args,omitempty"`

	// RawAnalysis contains the full diagnostic output from the AI model if used.
	RawAnalysis string `json:"raw_analysis,omitempty"`
}

type DiagnosticSnapshot struct {
	// Timestamp is when the snapshot was captured.
	Timestamp time.Time `json:"timestamp"`

	// ProcessState describes the current state of the process ("running", "blocked", "terminated").
	ProcessState string `json:"process_state"`

	// LastLogLines contains the most recent output from stdout/stderr.
	LastLogLines []string `json:"last_log_lines"`

	// ElapsedTimeMs is the time elapsed since process start.
	ElapsedTimeMs int64 `json:"elapsed_time_ms"`

	// StderrContent contains the full stderr output if available.
	StderrContent string `json:"stderr_content,omitempty"`

	// Provider is the provider being executed (e.g., "claudecli", "geminicli").
	Provider string `json:"provider"`

	// Model is the model being used.
	Model string `json:"model"`
}

type FailureType string

type HealingAction struct {
	// Timestamp is when the action was initiated.
	Timestamp time.Time `json:"timestamp"`

	// ActionType categorizes the intervention (e.g., "stdin_injection", "restart_with_flags", "fallback_routing").
	ActionType string `json:"action_type"`

	// Description provides a human-readable explanation of what was done.
	Description string `json:"description"`

	// Success indicates whether the action achieved its intended outcome.
	Success bool `json:"success"`

	// Details contains action-specific metadata (e.g., flags applied, provider switched to).
	Details map[string]interface{} `json:"details,omitempty"`
}

type HealingMetadata struct {
	// RequestID uniquely identifies the request that triggered healing.
	RequestID string `json:"request_id"`

	// OriginalProvider is the provider initially selected for the request.
	OriginalProvider string `json:"original_provider"`

	// FinalProvider is the provider that ultimately fulfilled the request (may differ after fallback).
	FinalProvider string `json:"final_provider"`

	// TotalHealingTimeMs is the cumulative time spent on all healing actions.
	TotalHealingTimeMs int64 `json:"total_healing_time_ms"`

	// Actions is the chronological list of all autonomous interventions.
	Actions []HealingAction `json:"actions"`

	// ContextOptimized indicates whether the Context Sculptor reduced content to fit limits.
	ContextOptimized bool `json:"context_optimized,omitempty"`

	// HighDensityMap contains a summary of excluded content when optimization occurred.
	HighDensityMap *HighDensityMap `json:"high_density_map,omitempty"`

	// DiagnosisHistory contains all diagnoses performed during the request lifecycle.
	DiagnosisHistory []*Diagnosis `json:"diagnosis_history,omitempty"`
}

type HighDensityMap struct {
	// TotalFiles is the total number of files referenced in the original request.
	TotalFiles int `json:"total_files"`

	// IncludedFiles is the number of files included after optimization.
	IncludedFiles int `json:"included_files"`

	// ExcludedFiles is the number of files excluded to fit within limits.
	ExcludedFiles int `json:"excluded_files"`

	// DirectoryTree is a text representation of the directory structure.
	DirectoryTree string `json:"directory_tree,omitempty"`

	// FileSummaries maps excluded file paths to brief summaries of their content.
	FileSummaries map[string]string `json:"file_summaries,omitempty"`

	// TokensSaved is the estimated number of tokens saved by optimization.
	TokensSaved int `json:"tokens_saved"`
}

type NegotiatedFailureResponse struct {
	// Error contains the standard error information.
	Error struct {
		// Message is a human-readable description of the failure.
		Message string `json:"message"`

		// Type categorizes the error (e.g., "provider_unavailable", "unrecoverable_failure").
		Type string `json:"type"`

		// Code is a machine-readable error code for programmatic handling.
		Code string `json:"code"`
	} `json:"error"`

	// Superbrain contains information about autonomous actions attempted during healing.
	Superbrain struct {
		// AttemptedActions lists all healing actions that were tried.
		AttemptedActions []string `json:"attempted_actions"`

		// DiagnosisSummary provides the Internal Doctor's analysis of the failure.
		DiagnosisSummary string `json:"diagnosis_summary"`

		// Suggestions provides actionable recommendations for the user.
		Suggestions []string `json:"suggestions"`

		// FallbacksTried lists all alternative providers that were attempted.
		FallbacksTried []string `json:"fallbacks_tried,omitempty"`
	} `json:"superbrain"`
}

type RemediationType string