types

type AMICleanupResult struct {
	TotalFound            int       `json:"total_found"`
	TotalRemoved          int       `json:"total_removed"`
	StorageSavingsMonthly float64   `json:"storage_savings_monthly"`
	RemovedAMIs           []AMIInfo `json:"removed_amis"`
	CompletedAt           time.Time `json:"completed_at"`
}

type AMICostAnalysis struct {
	TemplateName string `json:"template_name"`
	Region       string `json:"region"`

	// AMI deployment costs
	AMILaunchCost  float64 `json:"ami_launch_cost"`  // Per hour
	AMIStorageCost float64 `json:"ami_storage_cost"` // Per month
	AMISetupCost   float64 `json:"ami_setup_cost"`   // One-time (minimal)

	// Script deployment costs
	ScriptLaunchCost float64 `json:"script_launch_cost"` // Per hour (same as AMI)
	ScriptSetupCost  float64 `json:"script_setup_cost"`  // One-time setup cost (higher)
	ScriptSetupTime  int     `json:"script_setup_time"`  // Setup time in minutes

	// Cost comparison
	BreakEvenPoint   float64 `json:"break_even_point"` // Hours where costs are equal
	CostSavings1Hour float64 `json:"cost_savings_1h"`  // Savings for 1-hour session
	CostSavings8Hour float64 `json:"cost_savings_8h"`  // Savings for 8-hour session
	TimeSavings      int     `json:"time_savings"`     // Time saved in minutes

	// Recommendations
	Recommendation string `json:"recommendation"` // "ami_recommended", "script_recommended", "neutral"
	Reasoning      string `json:"reasoning"`
}

type AMICreationRequest struct {
	// Source instance information
	InstanceID   string `json:"instance_id"`
	TemplateName string `json:"template_name"`

	// AMI metadata
	Name        string            `json:"name"`
	Description string            `json:"description"`
	Version     string            `json:"version,omitempty"`
	Tags        map[string]string `json:"tags,omitempty"`

	// Sharing configuration
	Public    bool     `json:"public"`
	ShareWith []string `json:"share_with,omitempty"` // AWS account IDs
	Community string   `json:"community,omitempty"`  // Community to share with

	// Multi-region deployment
	MultiRegion    []string `json:"multi_region,omitempty"`
	RegionPriority []string `json:"region_priority,omitempty"` // Preferred order for deployment

	// Creation options
	NoReboot           bool `json:"no_reboot,omitempty"`
	BlockDeviceMapping bool `json:"block_device_mapping,omitempty"`
}

type AMICreationResult struct {
	// Primary AMI information
	AMIID        string            `json:"ami_id"`
	Name         string            `json:"name"`
	CreationTime time.Duration     `json:"creation_time"`
	Status       AMICreationStatus `json:"status"`

	// Multi-region deployment results
	RegionResults map[string]*RegionAMIResult `json:"region_results,omitempty"`

	// Community sharing results
	CommunitySharing *CommunityShareResult `json:"community_sharing,omitempty"`

	// Cost information
	StorageCost  float64 `json:"storage_cost"`  // Monthly storage cost
	CreationCost float64 `json:"creation_cost"` // One-time creation cost
	TransferCost float64 `json:"transfer_cost"` // Multi-region copy cost
}

type AMICreationStatus string

type AMIDeletionResult struct {
	AMIID                 string    `json:"ami_id"`
	Status                string    `json:"status"`
	DeletedSnapshots      []string  `json:"deleted_snapshots,omitempty"`
	StorageSavingsMonthly float64   `json:"storage_savings_monthly"`
	CompletedAt           time.Time `json:"completed_at"`
}

type AMIInfo struct {
	// Basic AMI identification
	AMIID        string `json:"ami_id"`
	Name         string `json:"name"`
	Description  string `json:"description"`
	Region       string `json:"region"`
	Architecture string `json:"architecture"` // x86_64, arm64

	// AMI metadata
	Owner        string            `json:"owner"`
	CreationDate time.Time         `json:"creation_date"`
	State        string            `json:"state"`
	Public       bool              `json:"public"`
	Tags         map[string]string `json:"tags,omitempty"`

	// Performance and cost information
	LaunchTime      time.Duration `json:"launch_time"`      // Expected launch time
	MarketplaceCost float64       `json:"marketplace_cost"` // Marketplace hourly cost (if applicable)
	StorageCost     float64       `json:"storage_cost"`     // Monthly storage cost
	SourceRegion    string        `json:"source_region"`    // Different from Region if copied

	// Community AMI information (if applicable)
	CommunityInfo *CommunityAMIInfo `json:"community_info,omitempty"`

	// Validation and security
	SignatureValid bool      `json:"signature_valid"`
	SecurityScore  float64   `json:"security_score"` // 0.0-10.0
	LastTested     time.Time `json:"last_tested"`
}

type AMIResolutionMethod string

type AMIResolutionResult struct {
	// Resolved AMI information
	AMI *AMIInfo `json:"ami,omitempty"`

	// How the AMI was resolved
	ResolutionMethod AMIResolutionMethod `json:"resolution_method"`

	// Chain of fallback methods attempted
	FallbackChain []string `json:"fallback_chain"`

	// User warning about resolution (if applicable)
	Warning string `json:"warning,omitempty"`

	// Cost analysis
	EstimatedCost float64       `json:"estimated_cost"`
	LaunchTime    time.Duration `json:"launch_time"`
	CostSavings   float64       `json:"cost_savings,omitempty"` // vs script provisioning

	// Region information
	TargetRegion string `json:"target_region"`
	SourceRegion string `json:"source_region,omitempty"` // Different if cross-region copy
}

type AMIRestoreResult struct {
	AMIID                      string    `json:"ami_id"`
	Name                       string    `json:"name"`
	Description                string    `json:"description"`
	Architecture               string    `json:"architecture"`
	EstimatedCompletionMinutes int       `json:"estimated_completion_minutes"`
	RestoreInitiatedAt         time.Time `json:"restore_initiated_at"`
}

type AMIReview struct {
	UserID    string    `json:"user_id"`
	Rating    int       `json:"rating"` // 1-5 stars
	Review    string    `json:"review"`
	Helpful   int       `json:"helpful"` // Helpful votes
	CreatedAt time.Time `json:"created_at"`
}

type AMITestRequest struct {
	TemplateName string   `json:"template_name"`
	Regions      []string `json:"regions,omitempty"`     // Test specific regions, empty = all
	TestLaunch   bool     `json:"test_launch,omitempty"` // Actually launch instance for testing
}

type AMITestResult struct {
	TemplateName     string                       `json:"template_name"`
	OverallStatus    AMITestStatus                `json:"overall_status"`
	RegionResults    map[string]*RegionTestResult `json:"region_results"`
	TestedAt         time.Time                    `json:"tested_at"`
	TotalRegions     int                          `json:"total_regions"`
	AvailableRegions int                          `json:"available_regions"`
}

type AMITestStatus string

type AMIUsageMetrics struct {
	// Resolution metrics
	ResolutionAttempts    map[AMIResolutionMethod]int64         `json:"resolution_attempts"`
	ResolutionSuccesses   map[AMIResolutionMethod]int64         `json:"resolution_successes"`
	AverageResolutionTime map[AMIResolutionMethod]time.Duration `json:"average_resolution_time"`

	// Launch metrics
	AMILaunches       int64         `json:"ami_launches"`
	ScriptLaunches    int64         `json:"script_launches"`
	LaunchSuccessRate float64       `json:"launch_success_rate"`
	AverageLaunchTime time.Duration `json:"average_launch_time"`

	// Cost metrics
	TotalCostSavings   float64       `json:"total_cost_savings"`
	AverageCostSavings float64       `json:"average_cost_savings"`
	TotalTimeSavings   time.Duration `json:"total_time_savings"`

	// Regional metrics
	RegionalAvailability map[string]float64 `json:"regional_availability"` // region -> availability percentage
	CrossRegionCopies    int64              `json:"cross_region_copies"`

	// Community metrics
	CommunityAMIUsage      int64 `json:"community_ami_usage"`
	CommunityContributions int64 `json:"community_contributions"`

	// Time period
	Period    string    `json:"period"` // "daily", "weekly", "monthly"
	StartTime time.Time `json:"start_time"`
	EndTime   time.Time `json:"end_time"`
}

type APIError struct {
	Code        ErrorCode         `json:"code"`
	Message     string            `json:"message"`
	Details     string            `json:"details,omitempty"`
	RequestID   string            `json:"request_id,omitempty"`
	Operation   string            `json:"operation,omitempty"`
	Resource    string            `json:"resource,omitempty"`    // Resource type (instance, volume, etc.)
	ResourceID  string            `json:"resource_id,omitempty"` // Specific resource ID (if applicable)
	Field       string            `json:"field,omitempty"`       // Field name for validation errors
	Validation  map[string]string `json:"validation,omitempty"`  // Field validation errors
	StatusCode  int               `json:"status_code,omitempty"` // HTTP status code
	Retryable   bool              `json:"retryable,omitempty"`   // Whether operation can be retried
	Suggestions []string          `json:"suggestions,omitempty"` // Suggested actions to resolve
	// contains filtered or unexported fields
}

type APIErrorResponse struct {
	// Error code (e.g., "not_found", "validation_error")
	Code string `json:"code"`

	// HTTP status code
	Status int `json:"status"`

	// User-friendly error message
	Message string `json:"message"`

	// More detailed error information
	Details string `json:"details,omitempty"`

	// Request ID for tracking
	RequestID string `json:"request_id,omitempty"`

	// API version used for the request
	APIVersion string `json:"api_version,omitempty"`

	// Documentation URL for this error type
	DocsURL string `json:"docs_url,omitempty"`
}

type APIVersionInfo struct {
	// Version string (e.g., "v1", "v2.1", "v2-beta")
	Version string `json:"version"`

	// Status of this version (stable, beta, alpha, deprecated)
	Status string `json:"status"`

	// IsDefault indicates if this is the default version
	IsDefault bool `json:"is_default"`

	// ReleaseDate when this version was released
	ReleaseDate time.Time `json:"release_date,omitempty"`

	// DeprecationDate when this version was deprecated (if applicable)
	DeprecationDate *time.Time `json:"deprecation_date,omitempty"`

	// SunsetDate when this version will be removed (if applicable)
	SunsetDate *time.Time `json:"sunset_date,omitempty"`

	// DocsURL is the URL to the documentation for this API version
	DocsURL string `json:"docs_url,omitempty"`
}

type APIVersionResponse struct {
	// All supported API versions
	Versions []APIVersionInfo `json:"versions"`

	// Default version to use when no version is specified
	DefaultVersion string `json:"default_version"`

	// Current stable version
	StableVersion string `json:"stable_version"`

	// Latest version (may be alpha/beta)
	LatestVersion string `json:"latest_version"`

	// Base URL for API documentation
	DocsBaseURL string `json:"docs_base_url,omitempty"`
}

type AWSService string

type AppliedTemplateRecord struct {
	TemplateName       string    `json:"template_name"`
	AppliedAt          time.Time `json:"applied_at"`
	PackageManager     string    `json:"package_manager"`
	PackagesInstalled  []string  `json:"packages_installed"`
	ServicesConfigured []string  `json:"services_configured"`
	UsersCreated       []string  `json:"users_created"`
	RollbackCheckpoint string    `json:"rollback_checkpoint"`
}

type AuthResponse struct {
	APIKey    string    `json:"api_key"`
	CreatedAt time.Time `json:"created_at"`
	ExpiresAt time.Time `json:"expires_at,omitempty"`
	Message   string    `json:"message"`
}

type BackupContentsRequest struct {
	BackupName string `json:"backup_name" binding:"required"`
	Path       string `json:"path"`
	Recursive  bool   `json:"recursive"`
}

type BackupContentsResponse struct {
	BackupName string           `json:"backup_name"`
	Path       string           `json:"path"`
	Files      []BackupFileInfo `json:"files"`
	Count      int              `json:"count"`
	TotalSize  int64            `json:"total_size"`
}

type BackupCreateRequest struct {
	InstanceName string   `json:"instance_name" binding:"required"`
	BackupName   string   `json:"backup_name" binding:"required"`
	Description  string   `json:"description"`
	IncludePaths []string `json:"include_paths"`
	ExcludePaths []string `json:"exclude_paths"`
	Full         bool     `json:"full"`
	Incremental  bool     `json:"incremental"`
	StorageType  string   `json:"storage_type"` // "s3", "efs", "ebs"
	Encrypted    bool     `json:"encrypted"`
	Wait         bool     `json:"wait"`
}

type BackupCreateResult struct {
	BackupName                 string    `json:"backup_name"`
	BackupID                   string    `json:"backup_id"`
	SourceInstance             string    `json:"source_instance"`
	BackupType                 string    `json:"backup_type"`
	StorageType                string    `json:"storage_type"`
	StorageLocation            string    `json:"storage_location"`
	EstimatedCompletionMinutes int       `json:"estimated_completion_minutes"`
	EstimatedSizeBytes         int64     `json:"estimated_size_bytes"`
	StorageCostMonthly         float64   `json:"storage_cost_monthly"`
	CreatedAt                  time.Time `json:"created_at"`
	Encrypted                  bool      `json:"encrypted"`
	Message                    string    `json:"message"`
}

type BackupDeleteResult struct {
	BackupName            string    `json:"backup_name"`
	BackupID              string    `json:"backup_id"`
	StorageType           string    `json:"storage_type"`
	StorageLocation       string    `json:"storage_location"`
	DeletedSizeBytes      int64     `json:"deleted_size_bytes"`
	StorageSavingsMonthly float64   `json:"storage_savings_monthly"`
	DeletedAt             time.Time `json:"deleted_at"`
}

type BackupFileInfo struct {
	Path     string            `json:"path"`
	Size     int64             `json:"size"`
	Mode     string            `json:"mode"`
	Owner    string            `json:"owner"`
	Group    string            `json:"group"`
	ModTime  time.Time         `json:"mod_time"`
	IsDir    bool              `json:"is_dir"`
	Checksum string            `json:"checksum,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type BackupInfo struct {
	BackupName         string            `json:"backup_name"`
	BackupID           string            `json:"backup_id"`
	SourceInstance     string            `json:"source_instance"`
	SourceInstanceId   string            `json:"source_instance_id"`
	Description        string            `json:"description"`
	BackupType         string            `json:"backup_type"` // "full", "incremental"
	StorageType        string            `json:"storage_type"`
	StorageLocation    string            `json:"storage_location"`
	State              string            `json:"state"` // "creating", "available", "error", "deleting"
	SizeBytes          int64             `json:"size_bytes"`
	CompressedBytes    int64             `json:"compressed_bytes"`
	FileCount          int               `json:"file_count"`
	IncludedPaths      []string          `json:"included_paths"`
	ExcludedPaths      []string          `json:"excluded_paths"`
	Encrypted          bool              `json:"encrypted"`
	StorageCostMonthly float64           `json:"storage_cost_monthly"`
	CreatedAt          time.Time         `json:"created_at"`
	CompletedAt        *time.Time        `json:"completed_at,omitempty"`
	ExpiresAt          *time.Time        `json:"expires_at,omitempty"`
	Metadata           map[string]string `json:"metadata,omitempty"`
	ParentBackup       string            `json:"parent_backup,omitempty"` // For incremental backups
	ChecksumMD5        string            `json:"checksum_md5,omitempty"`
}

type BackupListResponse struct {
	Backups      []BackupInfo   `json:"backups"`
	Count        int            `json:"count"`
	TotalSize    int64          `json:"total_size_bytes"`
	TotalCost    float64        `json:"total_cost_monthly"`
	StorageTypes map[string]int `json:"storage_types"`
}

type BackupVerifyRequest struct {
	BackupName     string   `json:"backup_name" binding:"required"`
	SelectivePaths []string `json:"selective_paths"`
	QuickCheck     bool     `json:"quick_check"`
}

type BackupVerifyResult struct {
	BackupName            string                 `json:"backup_name"`
	VerificationState     string                 `json:"verification_state"` // "valid", "corrupt", "partial"
	CheckedFileCount      int                    `json:"checked_file_count"`
	CorruptFileCount      int                    `json:"corrupt_file_count"`
	MissingFileCount      int                    `json:"missing_file_count"`
	VerifiedBytes         int64                  `json:"verified_bytes"`
	VerificationStarted   time.Time              `json:"verification_started"`
	VerificationCompleted *time.Time             `json:"verification_completed,omitempty"`
	CorruptFiles          []string               `json:"corrupt_files,omitempty"`
	MissingFiles          []string               `json:"missing_files,omitempty"`
	Summary               map[string]interface{} `json:"summary,omitempty"`
}

type BillingInfo struct {
	MonthToDateSpend float64      `json:"month_to_date_spend"`
	ForecastedSpend  float64      `json:"forecasted_spend"`
	Credits          []CreditInfo `json:"credits"`
	BillingPeriod    string       `json:"billing_period"`
	LastUpdated      time.Time    `json:"last_updated"`
}

type Budget struct {
	// ID is the unique budget identifier
	ID string `json:"id"`

	// Name is the budget name (e.g., "NSF Grant CISE-2024-12345")
	Name string `json:"name"`

	// Description provides budget details
	Description string `json:"description"`

	// TotalAmount is the total budget pool in USD
	TotalAmount float64 `json:"total_amount"`

	// AllocatedAmount is the sum of all project allocations from this budget
	AllocatedAmount float64 `json:"allocated_amount"`

	// SpentAmount is the actual amount spent across all allocations
	SpentAmount float64 `json:"spent_amount"`

	// Period defines the budget period
	Period BudgetPeriod `json:"period"`

	// StartDate is when the budget period began
	StartDate time.Time `json:"start_date"`

	// EndDate is when the budget period ends (optional for ongoing budgets)
	EndDate *time.Time `json:"end_date,omitempty"`

	// AlertThreshold is the global alert percentage (0.0-1.0)
	AlertThreshold float64 `json:"alert_threshold"`

	// CreatedBy is the user who created the budget
	CreatedBy string `json:"created_by"`

	// CreatedAt is when the budget was created
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the budget was last modified
	UpdatedAt time.Time `json:"updated_at"`

	// Tags for budget organization
	Tags map[string]string `json:"tags,omitempty"`
}

type BudgetActionType string

type BudgetAlert struct {
	// Threshold is the spending percentage (0.0-1.0) that triggers the alert
	Threshold float64 `json:"threshold"`

	// Type defines the alert type
	Type BudgetAlertType `json:"type"`

	// Recipients defines who receives the alert
	Recipients []string `json:"recipients"`

	// Message is an optional custom alert message
	Message string `json:"message,omitempty"`

	// Enabled indicates if the alert is active
	Enabled bool `json:"enabled"`

	// LastTriggered is when this alert was last sent
	LastTriggered *time.Time `json:"last_triggered,omitempty"`
}

type BudgetAlertType string

type BudgetAutoAction struct {
	// Threshold is the spending percentage (0.0-1.0) that triggers the action
	Threshold float64 `json:"threshold"`

	// Action defines what action to take
	Action BudgetActionType `json:"action"`

	// Enabled indicates if the auto action is active
	Enabled bool `json:"enabled"`

	// LastTriggered is when this action was last executed
	LastTriggered *time.Time `json:"last_triggered,omitempty"`
}

type BudgetPeriod string

type BudgetSummary struct {
	// Budget is the budget details
	Budget Budget `json:"budget"`

	// Allocations is the list of project allocations
	Allocations []ProjectBudgetAllocation `json:"allocations"`

	// ProjectNames maps project IDs to names for display
	ProjectNames map[string]string `json:"project_names"`

	// RemainingAmount is unallocated budget (TotalAmount - AllocatedAmount)
	RemainingAmount float64 `json:"remaining_amount"`

	// UtilizationRate is the percentage of allocated funds actually spent
	UtilizationRate float64 `json:"utilization_rate"`
}

type BulkInvitationEntry struct {
	// Email is the invitee's email address (required)
	Email string `json:"email"`

	// Role overrides DefaultRole if specified
	Role ProjectRole `json:"role,omitempty"`

	// Message overrides DefaultMessage if specified
	Message string `json:"message,omitempty"`
}

type BulkInvitationRequest struct {
	// Invitations is the list of invitations to create
	Invitations []BulkInvitationEntry `json:"invitations"`

	// DefaultRole is applied when invitation entry has no role specified
	DefaultRole ProjectRole `json:"default_role,omitempty"`

	// DefaultMessage is applied when invitation entry has no message
	DefaultMessage string `json:"default_message,omitempty"`

	// ExpiresIn is the default expiration duration (e.g., "7d", "30d")
	ExpiresIn string `json:"expires_in,omitempty"`

	// ExpiresAt is an absolute expiration time (mutually exclusive with ExpiresIn)
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
}

type BulkInvitationResponse struct {
	// Summary provides aggregate statistics
	Summary BulkInvitationSummary `json:"summary"`

	// Results contains the outcome for each invitation
	Results []BulkInvitationResult `json:"results"`

	// Message is a human-readable summary
	Message string `json:"message"`
}

type BulkInvitationResult struct {
	// Email is the invitee's email address
	Email string `json:"email"`

	// Status is the result status: "sent", "skipped", or "failed"
	Status string `json:"status"`

	// InvitationID is the ID of the created invitation (only for "sent" status)
	InvitationID string `json:"invitation_id,omitempty"`

	// Reason explains why the invitation was skipped
	Reason string `json:"reason,omitempty"`

	// Error contains the error message for failed invitations
	Error string `json:"error,omitempty"`
}

type BulkInvitationSummary struct {
	// Total is the total number of invitations processed
	Total int `json:"total"`

	// Sent is the number of successfully sent invitations
	Sent int `json:"sent"`

	// Skipped is the number of skipped invitations (duplicates, already members)
	Skipped int `json:"skipped"`

	// Failed is the number of failed invitations
	Failed int `json:"failed"`
}

type CPUAnalysis struct {
	AverageUtilization float64 `json:"average_utilization"`
	PeakUtilization    float64 `json:"peak_utilization"`
	P95Utilization     float64 `json:"p95_utilization"`
	P99Utilization     float64 `json:"p99_utilization"`
	IdlePercentage     float64 `json:"idle_percentage"`
	IsBottleneck       bool    `json:"is_bottleneck"`
	Recommendation     string  `json:"recommendation"`
}

type CPUMetrics struct {
	UtilizationPercent float64 `json:"utilization_percent"`
	Load1Min           float64 `json:"load_1min"`
	Load5Min           float64 `json:"load_5min"`
	Load15Min          float64 `json:"load_15min"`
	CoreCount          int     `json:"core_count"`
	IdlePercent        float64 `json:"idle_percent"`
	WaitPercent        float64 `json:"wait_percent"`
}

type CommunityAMIInfo struct {
	Creator       string      `json:"creator"`
	Version       string      `json:"version"`
	Rating        float64     `json:"rating"` // 0.0-5.0
	ReviewCount   int         `json:"review_count"`
	DownloadCount int         `json:"download_count"`
	Verified      bool        `json:"verified"`
	LastUpdated   time.Time   `json:"last_updated"`
	Reviews       []AMIReview `json:"reviews,omitempty"`
}

type CommunityShareResult struct {
	Community   string    `json:"community"`
	Status      string    `json:"status"` // submitted, approved, rejected
	SubmittedAt time.Time `json:"submitted_at"`
	ReviewURL   string    `json:"review_url,omitempty"`
	Error       string    `json:"error,omitempty"`
}

type ConfidenceLevel string

type Config struct {
	DefaultProfile string    `json:"default_profile"`
	DefaultRegion  string    `json:"default_region"`
	APIKey         string    `json:"api_key,omitempty"`
	APIKeyCreated  time.Time `json:"api_key_created,omitempty"`
}

type ConnectionType string

type CostImpact struct {
	CurrentDailyCost     float64 `json:"current_daily_cost"`
	RecommendedDailyCost float64 `json:"recommended_daily_cost"`
	DailyDifference      float64 `json:"daily_difference"`
	PercentageChange     float64 `json:"percentage_change"`
	MonthlySavings       float64 `json:"monthly_savings"`
	AnnualSavings        float64 `json:"annual_savings"`
	IsIncrease           bool    `json:"is_increase"`
	PaybackPeriodDays    float64 `json:"payback_period_days,omitempty"`
}

type CostOptimizationSummary struct {
	PotentialDailySavings         float64 `json:"potential_daily_savings"`
	PotentialMonthlySavings       float64 `json:"potential_monthly_savings"`
	PotentialAnnualSavings        float64 `json:"potential_annual_savings"`
	SavingsPercentage             float64 `json:"savings_percentage"`
	OverprovisionedInstances      int     `json:"overprovisioned_instances"`
	UnderprovisionedInstances     int     `json:"underprovisioned_instances"`
	OptimallyProvisionedInstances int     `json:"optimally_provisioned_instances"`
}

type CreateSharedTokenRequest struct {
	// ProjectID is the project this token grants access to (inferred from URL path if not provided)
	ProjectID string `json:"project_id,omitempty"`

	// Name is the display name for this token
	Name string `json:"name"`

	// Role is the role assigned to redeemers
	Role ProjectRole `json:"role"`

	// Message is an optional welcome message
	Message string `json:"message,omitempty"`

	// RedemptionLimit is the maximum number of redemptions
	RedemptionLimit int `json:"redemption_limit"`

	// ExpiresIn is the expiration duration (e.g., "7d")
	ExpiresIn string `json:"expires_in,omitempty"`

	// ExpiresAt is an absolute expiration time
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// CreatedBy is the user ID creating the token (inferred from auth context if not provided)
	CreatedBy string `json:"created_by,omitempty"`
}

type CreditInfo struct {
	TotalCredits     float64    `json:"total_credits"`
	RemainingCredits float64    `json:"remaining_credits"`
	UsedCredits      float64    `json:"used_credits"`
	CreditType       string     `json:"credit_type"` // "AWS Promotional", "AWS Educate", etc.
	ExpirationDate   *time.Time `json:"expiration_date,omitempty"`
	Description      string     `json:"description"`
}

type CushionBudgetConfig struct {
	Enabled            bool     `json:"enabled"`
	HeadroomPercent    float64  `json:"headroom_percent"`
	HeadroomFixed      *float64 `json:"headroom_fixed_usd,omitempty"`
	Mode               string   `json:"mode"`
	NotifyBeforeAction bool     `json:"notify_before_action"`
	WarnLeadHours      int      `json:"warn_lead_hours"`
}

type DaemonStatus struct {
	// Version of the daemon
	Version string `json:"version"`

	// Status of the daemon (running, starting, stopping)
	Status string `json:"status"`

	// StartTime is when the daemon was started
	StartTime time.Time `json:"start_time"`

	// Uptime is the duration the daemon has been running
	Uptime string `json:"uptime,omitempty"`

	// ActiveOps is the number of currently active operations
	ActiveOps int `json:"active_ops"`

	// TotalRequests is the total number of requests processed
	TotalRequests int64 `json:"total_requests"`

	// RequestsPerMinute is the current request rate
	RequestsPerMinute float64 `json:"requests_per_minute,omitempty"`

	// AWSRegion is the current AWS region being used
	AWSRegion string `json:"aws_region"`

	// AWSProfile is the current AWS profile being used
	AWSProfile string `json:"aws_profile,omitempty"`

	// CurrentProfile is the active profile ID (if applicable)
	CurrentProfile string `json:"current_profile,omitempty"`

	// Rate limiting status (v0.5.12)
	RateLimitEnabled     bool `json:"rate_limit_enabled,omitempty"`
	RateLimitMaxLaunches int  `json:"rate_limit_max_launches,omitempty"`
	RateLimitWindow      int  `json:"rate_limit_window,omitempty"`
	RateLimitCurrent     int  `json:"rate_limit_current,omitempty"`
	RateLimitRemaining   int  `json:"rate_limit_remaining,omitempty"`
}

type DiscountConfig struct {
	EC2Discount              float64 `json:"ec2_discount"`               // Percentage discount (0.0-1.0)
	EBSDiscount              float64 `json:"ebs_discount"`               // Percentage discount (0.0-1.0)
	EFSDiscount              float64 `json:"efs_discount"`               // Percentage discount (0.0-1.0)
	SavingsPlansDiscount     float64 `json:"savings_plans_discount"`     // Additional savings plan discount
	ReservedInstanceDiscount float64 `json:"reserved_instance_discount"` // RI discount
	SpotDiscount             float64 `json:"spot_discount"`              // Spot instance discount
	VolumeDiscount           float64 `json:"volume_discount"`            // Volume discount for large usage
	EducationalDiscount      float64 `json:"educational_discount"`       // Educational institution discount
	StartupDiscount          float64 `json:"startup_discount"`           // AWS Activate/startup credits
	EnterpriseDiscount       float64 `json:"enterprise_discount"`        // Enterprise agreement discount
}

type DualUserIntegration = research.DualUserIntegration

type ErrorCode string

type ExecRequest struct {
	Command        string            `json:"command"`                   // Command to execute
	WorkingDir     string            `json:"working_dir,omitempty"`     // Working directory
	User           string            `json:"user,omitempty"`            // User to execute as
	Environment    map[string]string `json:"environment,omitempty"`     // Environment variables
	TimeoutSeconds int               `json:"timeout_seconds,omitempty"` // Command timeout
	Interactive    bool              `json:"interactive,omitempty"`     // Interactive session
}

type ExecResult struct {
	Command       string `json:"command"`
	ExitCode      int    `json:"exit_code"`
	StdOut        string `json:"stdout"`
	StdErr        string `json:"stderr"`
	Status        string `json:"status"`               // success, failed, timeout
	ExecutionTime int    `json:"execution_time"`       // Execution time in milliseconds
	CommandID     string `json:"command_id,omitempty"` // SSM command ID for reference
}

type FleetOverview struct {
	TotalInstances       int     `json:"total_instances"`
	RunningInstances     int     `json:"running_instances"`
	StoppedInstances     int     `json:"stopped_instances"`
	TotalDailyCost       float64 `json:"total_daily_cost"`
	TotalMonthlyCost     float64 `json:"total_monthly_cost"`
	InstancesWithMetrics int     `json:"instances_with_metrics"`
}

type GPUAnalysis struct {
	AverageUtilization float64 `json:"average_utilization"`
	PeakUtilization    float64 `json:"peak_utilization"`
	MemoryUtilization  float64 `json:"memory_utilization"`
	TemperatureAverage float64 `json:"temperature_average"`
	PowerUsageAverage  float64 `json:"power_usage_average"`
	IsBottleneck       bool    `json:"is_bottleneck"`
	IsUnderutilized    bool    `json:"is_underutilized"`
	Recommendation     string  `json:"recommendation"`
}

type GPUMetrics struct {
	Count                    int     `json:"count"`
	UtilizationPercent       float64 `json:"utilization_percent"`
	MemoryTotalMB            float64 `json:"memory_total_mb"`
	MemoryUsedMB             float64 `json:"memory_used_mb"`
	MemoryUtilizationPercent float64 `json:"memory_utilization_percent"`
	TemperatureCelsius       float64 `json:"temperature_celsius"`
	PowerDrawWatts           float64 `json:"power_draw_watts"`
}

type HibernationStatus struct {
	HibernationSupported bool   `json:"hibernation_supported"`
	InstanceState        string `json:"instance_state"`      // Current AWS state: running, stopped, stopping, etc.
	PossiblyHibernated   bool   `json:"possibly_hibernated"` // True if stopped with hibernation support
	InstanceName         string `json:"instance_name"`
	Note                 string `json:"note,omitempty"` // Explanatory note about the status

	// Deprecated: Use PossiblyHibernated instead
	IsHibernated bool `json:"is_hibernated,omitempty"` // Kept for backward compatibility
}

type IdleDetection struct {
	Enabled        bool      `json:"enabled"`
	Policy         string    `json:"policy"`
	IdleTime       int       `json:"idle_time"`       // Minutes
	Threshold      int       `json:"threshold"`       // Minutes
	ActionSchedule time.Time `json:"action_schedule"` // When action will occur
	ActionPending  bool      `json:"action_pending"`  // Whether action is pending
}

type IdleDetectionConfig struct {
	Enabled                   bool `yaml:"enabled" json:"enabled"`
	IdleThresholdMinutes      int  `yaml:"idle_threshold_minutes" json:"idle_threshold_minutes"`
	HibernateThresholdMinutes int  `yaml:"hibernate_threshold_minutes" json:"hibernate_threshold_minutes"`
	CheckIntervalMinutes      int  `yaml:"check_interval_minutes" json:"check_interval_minutes"`
}

type IdleExecutionResponse struct {
	Executed int      `json:"executed"`
	Errors   []string `json:"errors"`
	Total    int      `json:"total"`
}

type IdleHistoryEntry struct {
	InstanceID   string            `json:"instance_id"`
	InstanceName string            `json:"instance_name"`
	Action       string            `json:"action"`
	Time         time.Time         `json:"time"`
	IdleDuration time.Duration     `json:"idle_duration"`
	Metrics      *IdleUsageMetrics `json:"metrics,omitempty"`
}

type IdleScheduledAction struct {
	Action string    `json:"action"`
	Time   time.Time `json:"time"`
}

type IdleState struct {
	InstanceID   string               `json:"instance_id"`
	InstanceName string               `json:"instance_name"`
	Profile      string               `json:"profile"`
	IsIdle       bool                 `json:"is_idle"`
	IdleSince    *time.Time           `json:"idle_since,omitempty"`
	LastActivity time.Time            `json:"last_activity"`
	NextAction   *IdleScheduledAction `json:"next_action,omitempty"`
	LastMetrics  *IdleUsageMetrics    `json:"last_metrics,omitempty"`
}

type IdleUsageMetrics struct {
	Timestamp   time.Time `json:"timestamp"`
	CPU         float64   `json:"cpu"`
	Memory      float64   `json:"memory"`
	Network     float64   `json:"network"`
	Disk        float64   `json:"disk"`
	GPU         *float64  `json:"gpu,omitempty"`
	HasActivity bool      `json:"has_activity"`
}

type Instance struct {
	ID                    string                  `json:"id"`
	Name                  string                  `json:"name"`
	Template              string                  `json:"template"`
	Region                string                  `json:"region"`            // AWS region where instance is running
	AvailabilityZone      string                  `json:"availability_zone"` // AWS availability zone within region
	PublicIP              string                  `json:"public_ip"`
	PrivateIP             string                  `json:"private_ip"`
	State                 string                  `json:"state"`
	LaunchTime            time.Time               `json:"launch_time"`
	RunningStateStartTime *time.Time              `json:"running_state_start_time,omitempty"` // When instance entered running state (billing starts)
	DeletionTime          *time.Time              `json:"deletion_time,omitempty"`            // When user initiated deletion
	HourlyRate            float64                 `json:"hourly_rate"`                        // AWS list price per hour
	CurrentSpend          float64                 `json:"current_spend"`                      // Actual accumulated cost since launch
	EffectiveRate         float64                 `json:"effective_rate"`                     // Current spend ÷ hours since launch
	AttachedVolumes       []string                `json:"attached_volumes"`                   // EFS volume names
	AttachedEBSVolumes    []string                `json:"attached_ebs_volumes"`               // EBS volume IDs
	InstanceType          string                  `json:"instance_type"`
	InstanceLifecycle     string                  `json:"instance_lifecycle"` // "spot" or "on-demand"
	KeyName               string                  `json:"key_name"`           // EC2 key pair name
	Username              string                  `json:"username"`
	ConnectionType        ConnectionType          `json:"connection_type,omitempty"` // How users connect (ssh, web, desktop)
	DCVPassword           string                  `json:"dcv_password,omitempty"`    // DCV session password (desktop templates only)
	WebPort               int                     `json:"web_port"`                  // Deprecated: Use Services instead
	HasWebInterface       bool                    `json:"has_web_interface"`         // Deprecated: Use Services instead
	Services              []Service               `json:"services,omitempty"`        // Web services available on this instance
	ProjectID             string                  `json:"project_id,omitempty"`      // Associated project ID
	IdleDetection         *IdleDetection          `json:"idle_detection,omitempty"`
	AppliedTemplates      []AppliedTemplateRecord `json:"applied_templates,omitempty"` // Template application history

	// Cost optimization fields
	EstimatedCost     float64 `json:"estimated_cost,omitempty"` // Daily cost estimate
	IdlePolicyEnabled bool    `json:"idle_policy_enabled,omitempty"`
	SpotEligible      bool    `json:"spot_eligible,omitempty"`
	IsSpot            bool    `json:"is_spot,omitempty"`
	IsHibernating     bool    `json:"is_hibernating,omitempty"` // Currently in stopping state due to hibernation (stopping IS billable during hibernation)
	ARMCompatible     bool    `json:"arm_compatible,omitempty"`
	Architecture      string  `json:"architecture,omitempty"`
	AlwaysOn          bool    `json:"always_on,omitempty"`
	WorkloadType      string  `json:"workload_type,omitempty"`
	Runtime           float64 `json:"runtime,omitempty"` // Hours since launch
	StorageGB         float64 `json:"storage_gb,omitempty"`
	StorageUsedGB     float64 `json:"storage_used_gb,omitempty"`

	// Universal AMI System fields (Phase 5.1)
	AMIResolutionMethod string        `json:"ami_resolution_method,omitempty"` // How AMI was resolved
	AMIID               string        `json:"ami_id,omitempty"`                // AMI used for launch
	CostSavings         float64       `json:"cost_savings,omitempty"`          // Cost savings vs script
	BootTime            time.Duration `json:"boot_time,omitempty"`             // Time to boot from AMI

	// State transition history for accurate cost tracking
	StateHistory []StateTransition `json:"state_history,omitempty"` // History of all state changes
}

type InstanceConfiguration struct {
	InstanceType       string  `json:"instance_type"`
	Size               string  `json:"size"`
	VCPUs              int     `json:"vcpus"`
	MemoryGB           float64 `json:"memory_gb"`
	StorageGB          float64 `json:"storage_gb"`
	NetworkPerformance string  `json:"network_performance"`
	DailyCost          float64 `json:"daily_cost"`
}

type InstanceCost struct {
	// InstanceName is the instance identifier
	InstanceName string `json:"instance_name"`

	// InstanceType is the AWS instance type
	InstanceType string `json:"instance_type"`

	// ComputeCost is the EC2 compute cost
	ComputeCost float64 `json:"compute_cost"`

	// StorageCost is the EBS storage cost
	StorageCost float64 `json:"storage_cost"`

	// TotalCost is the total instance cost
	TotalCost float64 `json:"total_cost"`

	// RunningHours is the number of hours the instance was running
	RunningHours float64 `json:"running_hours"`

	// HibernatedHours is the number of hours the instance was hibernated
	HibernatedHours float64 `json:"hibernated_hours"`

	// StoppedHours is the number of hours the instance was stopped
	StoppedHours float64 `json:"stopped_hours"`
}

type InstanceExtended struct {
	Instance
	IdleDetection *InstanceIdleStatus `json:"idle_detection,omitempty"`
}

type InstanceIdleStatus struct {
	Enabled        bool      `json:"enabled"`
	Policy         string    `json:"policy"`
	IdleTime       int       `json:"idle_time"`
	Threshold      int       `json:"threshold"`
	ActionSchedule time.Time `json:"action_schedule"`
	ActionPending  bool      `json:"action_pending"`
}

type InstanceLogSummary struct {
	Name          string `json:"name"`
	ID            string `json:"id"`
	State         string `json:"state"`
	LogsAvailable bool   `json:"logs_available"`
}

type InstanceMetrics struct {
	InstanceID   string         `json:"instance_id"`
	InstanceName string         `json:"instance_name"`
	Timestamp    time.Time      `json:"timestamp"`
	CPU          CPUMetrics     `json:"cpu"`
	Memory       MemoryMetrics  `json:"memory"`
	Storage      StorageMetrics `json:"storage"`
	Network      NetworkMetrics `json:"network"`
	GPU          *GPUMetrics    `json:"gpu,omitempty"`
	System       SystemMetrics  `json:"system"`
}

type InstanceRestoreRequest struct {
	SnapshotName    string `json:"snapshot_name" binding:"required"`
	NewInstanceName string `json:"new_instance_name" binding:"required"`
	Wait            bool   `json:"wait"`
}

type InstanceRestoreResult struct {
	NewInstanceName string    `json:"new_instance_name"`
	InstanceID      string    `json:"instance_id"`
	SnapshotName    string    `json:"snapshot_name"`
	SnapshotID      string    `json:"snapshot_id"`
	SourceTemplate  string    `json:"source_template"`
	State           string    `json:"state"`
	Message         string    `json:"message"`
	RestoredAt      time.Time `json:"restored_at"`
}

type InstanceSnapshotDeleteResult struct {
	SnapshotName          string    `json:"snapshot_name"`
	SnapshotID            string    `json:"snapshot_id"`
	DeletedSnapshots      []string  `json:"deleted_snapshots"`
	StorageSavingsMonthly float64   `json:"storage_savings_monthly"`
	DeletedAt             time.Time `json:"deleted_at"`
}

type InstanceSnapshotInfo struct {
	SnapshotID          string    `json:"snapshot_id"`
	SnapshotName        string    `json:"snapshot_name"`
	SourceInstance      string    `json:"source_instance"`
	SourceInstanceId    string    `json:"source_instance_id"`
	SourceTemplate      string    `json:"source_template"`
	Description         string    `json:"description"`
	State               string    `json:"state"`
	Architecture        string    `json:"architecture"`
	StorageCostMonthly  float64   `json:"storage_cost_monthly"`
	CreatedAt           time.Time `json:"created_at"`
	AssociatedSnapshots []string  `json:"associated_snapshots,omitempty"`
}

type InstanceSnapshotListResponse struct {
	Snapshots []InstanceSnapshotInfo `json:"snapshots"`
	Count     int                    `json:"count"`
}

type InstanceSnapshotRequest struct {
	InstanceName string `json:"instance_name" binding:"required"`
	SnapshotName string `json:"snapshot_name" binding:"required"`
	Description  string `json:"description"`
	NoReboot     bool   `json:"no_reboot"`
	Wait         bool   `json:"wait"`
}

type InstanceSnapshotResult struct {
	SnapshotID                 string    `json:"snapshot_id"`
	SnapshotName               string    `json:"snapshot_name"`
	SourceInstance             string    `json:"source_instance"`
	SourceInstanceId           string    `json:"source_instance_id"`
	Description                string    `json:"description"`
	State                      string    `json:"state"`
	EstimatedCompletionMinutes int       `json:"estimated_completion_minutes"`
	StorageCostMonthly         float64   `json:"storage_cost_monthly"`
	CreatedAt                  time.Time `json:"created_at"`
	NoReboot                   bool      `json:"no_reboot"`
}

type Invitation struct {
	// ID is the unique invitation identifier
	ID string `json:"id"`

	// ProjectID is the project being invited to
	ProjectID string `json:"project_id"`

	// ProjectName is the name of the project (enriched for display)
	ProjectName string `json:"project_name,omitempty"`

	// Email is the invitee's email address
	Email string `json:"email"`

	// Role is the role to be assigned when invitation is accepted
	Role ProjectRole `json:"role"`

	// Token is the secure random token used for acceptance/decline
	Token string `json:"token"`

	// InvitedBy is the user ID of who sent the invitation
	InvitedBy string `json:"invited_by"`

	// ProfileID is the profile associated with this invitation (for credential validation)
	ProfileID string `json:"profile_id,omitempty"`

	// InvitedAt is when the invitation was sent
	InvitedAt time.Time `json:"invited_at"`

	// ExpiresAt is when the invitation expires (default: 7 days)
	ExpiresAt time.Time `json:"expires_at"`

	// Status is the current invitation status
	Status InvitationStatus `json:"status"`

	// AcceptedAt is when the invitation was accepted (if applicable)
	AcceptedAt *time.Time `json:"accepted_at,omitempty"`

	// DeclinedAt is when the invitation was declined (if applicable)
	DeclinedAt *time.Time `json:"declined_at,omitempty"`

	// DeclineReason is an optional reason for declining
	DeclineReason string `json:"decline_reason,omitempty"`

	// ResendCount tracks how many times the invitation was resent
	ResendCount int `json:"resend_count"`

	// LastResent is when the invitation was last resent
	LastResent *time.Time `json:"last_resent,omitempty"`

	// Message is an optional personal message from the inviter
	Message string `json:"message,omitempty"`
}

type InvitationFilter struct {
	// ProjectID filters by project
	ProjectID string `json:"project_id,omitempty"`

	// Email filters by invitee email
	Email string `json:"email,omitempty"`

	// Status filters by invitation status
	Status InvitationStatus `json:"status,omitempty"`

	// InvitedBy filters by inviter user ID
	InvitedBy string `json:"invited_by,omitempty"`

	// IncludeExpired includes expired invitations (default: false)
	IncludeExpired bool `json:"include_expired"`

	// Limit limits the number of results (default: 50)
	Limit int `json:"limit,omitempty"`

	// Offset skips N results for pagination
	Offset int `json:"offset,omitempty"`
}

type InvitationStatus string

type InvitationSummary struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// TotalInvitations is the total number of invitations sent
	TotalInvitations int `json:"total_invitations"`

	// PendingCount is the number of pending invitations
	PendingCount int `json:"pending_count"`

	// AcceptedCount is the number of accepted invitations
	AcceptedCount int `json:"accepted_count"`

	// DeclinedCount is the number of declined invitations
	DeclinedCount int `json:"declined_count"`

	// ExpiredCount is the number of expired invitations
	ExpiredCount int `json:"expired_count"`

	// RecentInvitations lists the 10 most recent invitations
	RecentInvitations []*Invitation `json:"recent_invitations"`
}

type LaunchRequest struct {
	Template            string                 `json:"template"`
	Name                string                 `json:"name"`
	Size                string                 `json:"size,omitempty"`            // XS, S, M, L, XL, GPU-S, etc.
	PackageManager      string                 `json:"package_manager,omitempty"` // auto, conda, spack, apt
	Volumes             []string               `json:"volumes,omitempty"`         // EFS volume names to attach
	EBSVolumes          []string               `json:"ebs_volumes,omitempty"`     // EBS volume IDs to attach
	Region              string                 `json:"region,omitempty"`
	SubnetID            string                 `json:"subnet_id,omitempty"`
	VpcID               string                 `json:"vpc_id,omitempty"`
	ProjectID           string                 `json:"project_id,omitempty"`            // Project to associate instance with
	FundingAllocationID string                 `json:"funding_allocation_id,omitempty"` // Budget allocation to charge (v0.5.10+)
	SSHKeyName          string                 `json:"ssh_key_name,omitempty"`          // AWS key pair name to use
	Spot                bool                   `json:"spot,omitempty"`
	IdlePolicy          bool                   `json:"idle_policy,omitempty"` // Enable idle policy for automatic cost optimization
	DryRun              bool                   `json:"dry_run,omitempty"`
	Wait                bool                   `json:"wait,omitempty"`          // Wait and show launch progress
	Quiet               bool                   `json:"quiet,omitempty"`         // Suppress progress output (for scripting)
	NoProgress          bool                   `json:"no_progress,omitempty"`   // Disable progress monitoring
	AutoYes             bool                   `json:"auto_yes,omitempty"`      // Skip confirmation prompt (--yes)
	Parameters          map[string]interface{} `json:"parameters,omitempty"`    // Template parameters
	ResearchUser        string                 `json:"research_user,omitempty"` // Research user to create and provision (Phase 5A+)

	// Universal Version System (v0.5.5)
	Version string `json:"version,omitempty"` // OS version (e.g., "24.04", "22.04", "9", "10", "latest", "lts")

	// Universal AMI System fields (Phase 5.1)
	AMIStrategy         string               `json:"ami_strategy,omitempty"`          // Override template AMI strategy
	PreferScript        bool                 `json:"prefer_script,omitempty"`         // Prefer script over AMI
	ShowAMIResolution   bool                 `json:"show_ami_resolution,omitempty"`   // Show AMI resolution details
	AMIResolutionResult *AMIResolutionResult `json:"ami_resolution_result,omitempty"` // Internal: resolved AMI info
	CustomAMI           string               `json:"custom_ami,omitempty"`            // Override AMI ID (e.g., for restore from snapshot)
}

type LaunchResponse struct {
	Instance       Instance `json:"instance"`
	Message        string   `json:"message"`
	EstimatedCost  string   `json:"estimated_cost"`
	ConnectionInfo string   `json:"connection_info"`
}

type LaunchTestResult struct {
	InstanceID string        `json:"instance_id,omitempty"`
	LaunchTime time.Duration `json:"launch_time"`
	Success    bool          `json:"success"`
	Error      string        `json:"error,omitempty"`
	CleanedUp  bool          `json:"cleaned_up"`
}

type ListResponse struct {
	Instances []Instance `json:"instances"`
	TotalCost float64    `json:"total_cost"`
}

type LogRequest struct {
	LogType string `json:"log_type,omitempty"`
	Tail    int    `json:"tail,omitempty"`
	Since   string `json:"since,omitempty"`
	Follow  bool   `json:"follow,omitempty"`
}

type LogResponse struct {
	InstanceName string    `json:"instance_name"`
	InstanceID   string    `json:"instance_id"`
	LogType      string    `json:"log_type"`
	Lines        []string  `json:"lines"`
	Timestamp    time.Time `json:"timestamp"`
	Follow       bool      `json:"follow"`
	Tail         int       `json:"tail,omitempty"`
}

type LogSummaryResponse struct {
	Instances         []InstanceLogSummary `json:"instances"`
	AvailableLogTypes []string             `json:"available_log_types"`
}

type LogTypesResponse struct {
	InstanceName      string   `json:"instance_name"`
	InstanceID        string   `json:"instance_id"`
	AvailableLogTypes []string `json:"available_log_types"`
	SSMEnabled        bool     `json:"ssm_enabled"`
}

type MemoryAnalysis struct {
	AverageUtilization float64 `json:"average_utilization"`
	PeakUtilization    float64 `json:"peak_utilization"`
	P95Utilization     float64 `json:"p95_utilization"`
	P99Utilization     float64 `json:"p99_utilization"`
	SwapUsage          float64 `json:"swap_usage"`
	IsBottleneck       bool    `json:"is_bottleneck"`
	Recommendation     string  `json:"recommendation"`
}

type MemoryMetrics struct {
	TotalMB            float64 `json:"total_mb"`
	UsedMB             float64 `json:"used_mb"`
	FreeMB             float64 `json:"free_mb"`
	AvailableMB        float64 `json:"available_mb"`
	CachedMB           float64 `json:"cached_mb"`
	BufferedMB         float64 `json:"buffered_mb"`
	UtilizationPercent float64 `json:"utilization_percent"`
	SwapTotalMB        float64 `json:"swap_total_mb"`
	SwapUsedMB         float64 `json:"swap_used_mb"`
}

type MetricsCollectionStatus struct {
	IsActive           bool      `json:"is_active"`
	LastCollectionTime time.Time `json:"last_collection_time"`
	CollectionInterval string    `json:"collection_interval"`
	TotalDataPoints    int       `json:"total_data_points"`
	DataRetentionDays  int       `json:"data_retention_days"`
	StorageLocation    string    `json:"storage_location"`
}

type MetricsSummary struct {
	CPUSummary     ResourceSummary  `json:"cpu_summary"`
	MemorySummary  ResourceSummary  `json:"memory_summary"`
	StorageSummary ResourceSummary  `json:"storage_summary"`
	NetworkSummary ResourceSummary  `json:"network_summary"`
	GPUSummary     *ResourceSummary `json:"gpu_summary,omitempty"`
}

type NetworkAnalysis struct {
	AverageThroughput float64 `json:"average_throughput"`
	PeakThroughput    float64 `json:"peak_throughput"`
	PacketRate        float64 `json:"packet_rate"`
	IsBottleneck      bool    `json:"is_bottleneck"`
	Recommendation    string  `json:"recommendation"`
}

type NetworkMetrics struct {
	RxBytesPerSec   float64 `json:"rx_bytes_per_sec"`
	TxBytesPerSec   float64 `json:"tx_bytes_per_sec"`
	RxPacketsPerSec float64 `json:"rx_packets_per_sec"`
	TxPacketsPerSec float64 `json:"tx_packets_per_sec"`
	TotalRxBytes    float64 `json:"total_rx_bytes"`
	TotalTxBytes    float64 `json:"total_tx_bytes"`
}

type ProgressResponse struct {
	InstanceName      string          `json:"instance_name"`
	OverallProgress   float64         `json:"overall_progress"`    // 0-100
	CurrentStage      string          `json:"current_stage"`       // Human-readable current stage
	CurrentStageIndex int             `json:"current_stage_index"` // Index of current stage
	Stages            []ProgressStage `json:"stages"`
	IsComplete        bool            `json:"is_complete"`
	EstimatedTimeLeft string          `json:"estimated_time_left"` // e.g., "~5 minutes"
}

type ProgressStage struct {
	Name        string    `json:"name"`         // Internal name: "system-packages"
	DisplayName string    `json:"display_name"` // User-facing: "Installing system packages"
	Status      string    `json:"status"`       // "pending", "running", "complete", "error"
	StartTime   time.Time `json:"start_time"`   // When stage started
	EndTime     time.Time `json:"end_time"`     // When stage ended
	Output      string    `json:"output"`       // Last output line from this stage
}

type Project struct {
	// ID is the unique project identifier
	ID string `json:"id"`

	// Name is the human-readable project name
	Name string `json:"name"`

	// Description provides project details
	Description string `json:"description"`

	// Owner is the project owner/principal investigator
	Owner string `json:"owner"`

	// Members are additional project members with access
	Members []ProjectMember `json:"members"`

	// Budget contains the project budget configuration (DEPRECATED in v0.5.10)
	// Use ProjectBudgetAllocation system instead
	Budget *ProjectBudget `json:"budget,omitempty"`

	// DefaultAllocationID is the default funding source for this project (v0.5.10+)
	// When users launch resources under this project without specifying --funding,
	// this allocation is automatically used
	DefaultAllocationID *string `json:"default_allocation_id,omitempty"`

	// Tags for project organization and reporting
	Tags map[string]string `json:"tags,omitempty"`

	// CreatedAt is when the project was created
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the project was last modified
	UpdatedAt time.Time `json:"updated_at"`

	// Status indicates the project status
	Status ProjectStatus `json:"status"`

	// LaunchPrevented prevents new instance launches when true (set by budget actions)
	LaunchPrevented bool `json:"launch_prevented"`
}

type ProjectBudget struct {
	// TotalBudget is the total project budget in USD
	TotalBudget float64 `json:"total_budget"`

	// SpentAmount is the current amount spent in USD
	SpentAmount float64 `json:"spent_amount"`

	// MonthlyLimit is the optional monthly spending limit in USD
	MonthlyLimit *float64 `json:"monthly_limit,omitempty"`

	// DailyLimit is the optional daily spending limit in USD
	DailyLimit *float64 `json:"daily_limit,omitempty"`

	// AlertThresholds define when to send budget alerts
	AlertThresholds []BudgetAlert `json:"alert_thresholds"`

	// AutoActions define automatic actions when thresholds are reached
	AutoActions []BudgetAutoAction `json:"auto_actions"`

	// BudgetPeriod defines the budget period (project lifetime, monthly, etc.)
	BudgetPeriod BudgetPeriod `json:"budget_period"`

	// StartDate is when budget tracking began
	StartDate time.Time `json:"start_date"`

	// EndDate is when the budget period ends (optional)
	EndDate *time.Time `json:"end_date,omitempty"`

	// LastUpdated is when spending was last calculated
	LastUpdated time.Time `json:"last_updated"`

	// Cushion defines the automatic safety headroom configuration.
	// When enabled, Prism takes action (hibernate/stop/etc.) before the full
	// budget is exhausted, protecting against cost overruns.
	Cushion *CushionBudgetConfig `json:"cushion,omitempty"`
}

type ProjectBudgetAllocation struct {
	// ID is the unique allocation identifier
	ID string `json:"id"`

	// BudgetID is the parent budget pool
	BudgetID string `json:"budget_id"`

	// ProjectID is the project receiving the allocation
	ProjectID string `json:"project_id"`

	// AllocatedAmount is how much of the budget is allocated to this project
	AllocatedAmount float64 `json:"allocated_amount"`

	// SpentAmount is how much has been spent from this allocation (cached)
	SpentAmount float64 `json:"spent_amount"`

	// AlertThreshold is an optional project-specific alert threshold (overrides budget default)
	AlertThreshold *float64 `json:"alert_threshold,omitempty"`

	// BackupAllocationID is an optional backup funding source for exhaustion (#234)
	BackupAllocationID *string `json:"backup_allocation_id,omitempty"`

	// Notes provide context for this allocation
	Notes string `json:"notes,omitempty"`

	// AllocatedAt is when this allocation was created
	AllocatedAt time.Time `json:"allocated_at"`

	// AllocatedBy is the user who created the allocation
	AllocatedBy string `json:"allocated_by"`

	// UpdatedAt is when the allocation was last modified
	UpdatedAt time.Time `json:"updated_at"`
}

type ProjectCostBreakdown struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// TotalCost is the total project cost in USD
	TotalCost float64 `json:"total_cost"`

	// InstanceCosts breaks down costs by instance
	InstanceCosts []InstanceCost `json:"instance_costs"`

	// StorageCosts breaks down storage costs
	StorageCosts []StorageCost `json:"storage_costs"`

	// PeriodStart is the start of the cost reporting period
	PeriodStart time.Time `json:"period_start"`

	// PeriodEnd is the end of the cost reporting period
	PeriodEnd time.Time `json:"period_end"`

	// GeneratedAt is when this breakdown was generated
	GeneratedAt time.Time `json:"generated_at"`
}

type ProjectFundingSummary struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// ProjectName is the project name
	ProjectName string `json:"project_name"`

	// Allocations is the list of budget allocations funding this project
	Allocations []ProjectBudgetAllocation `json:"allocations"`

	// BudgetNames maps budget IDs to names for display
	BudgetNames map[string]string `json:"budget_names"`

	// TotalAllocated is the sum of all allocations to this project
	TotalAllocated float64 `json:"total_allocated"`

	// TotalSpent is the sum of spending across all allocations
	TotalSpent float64 `json:"total_spent"`

	// DefaultAllocationID is the project's default funding source
	DefaultAllocationID *string `json:"default_allocation_id,omitempty"`
}

type ProjectMember struct {
	// UserID is the member's user identifier
	UserID string `json:"user_id"`

	// Role defines the member's permissions within the project
	Role ProjectRole `json:"role"`

	// AddedAt is when the member was added to the project
	AddedAt time.Time `json:"added_at"`

	// AddedBy is who added the member to the project
	AddedBy string `json:"added_by"`
}

type ProjectResourceUsage struct {
	// ProjectID is the project identifier
	ProjectID string `json:"project_id"`

	// ActiveInstances is the number of currently active instances
	ActiveInstances int `json:"active_instances"`

	// TotalInstances is the total number of instances ever launched
	TotalInstances int `json:"total_instances"`

	// TotalStorage is the total storage in GB across all volumes
	TotalStorage float64 `json:"total_storage"`

	// ComputeHours is the total compute hours used
	ComputeHours float64 `json:"compute_hours"`

	// IdleSavings is the estimated cost savings from idle policies
	IdleSavings float64 `json:"idle_savings"`

	// MeasurementPeriod defines the period for these metrics
	MeasurementPeriod time.Duration `json:"measurement_period"`

	// LastUpdated is when these metrics were last calculated
	LastUpdated time.Time `json:"last_updated"`
}

type ProjectRole string

type ProjectStatus string

type RecommendationsSummary struct {
	TotalRecommendations    int `json:"total_recommendations"`
	DownsizeRecommendations int `json:"downsize_recommendations"`
	UpsizeRecommendations   int `json:"upsize_recommendations"`
	OptimizeRecommendations int `json:"optimize_recommendations"`
	HighConfidenceCount     int `json:"high_confidence_count"`
	MediumConfidenceCount   int `json:"medium_confidence_count"`
	LowConfidenceCount      int `json:"low_confidence_count"`
}

type RedeemSharedTokenRequest struct {
	// Token is the token code to redeem
	Token string `json:"token"`

	// RedeemedBy is the user email/ID redeeming the token
	RedeemedBy string `json:"redeemed_by"`
}

type RedeemSharedTokenResponse struct {
	// Success indicates if redemption was successful
	Success bool `json:"success"`

	// ProjectID is the project the user was added to
	ProjectID string `json:"project_id"`

	// Role is the role assigned to the user
	Role ProjectRole `json:"role"`

	// RedemptionPosition is the user's redemption order
	RedemptionPosition int `json:"redemption_position"`

	// RemainingRedemptions is how many redemptions are left
	RemainingRedemptions int `json:"remaining_redemptions"`

	// Message is a human-readable message
	Message string `json:"message"`
}

type RegionAMIResult struct {
	Region   string            `json:"region"`
	AMIID    string            `json:"ami_id"`
	Status   AMICreationStatus `json:"status"`
	Error    string            `json:"error,omitempty"`
	CopyTime time.Duration     `json:"copy_time,omitempty"`
	CopyCost float64           `json:"copy_cost,omitempty"`
}

type RegionTestResult struct {
	Region           string              `json:"region"`
	Status           AMITestStatus       `json:"status"`
	AMI              *AMIInfo            `json:"ami,omitempty"`
	ResolutionMethod AMIResolutionMethod `json:"resolution_method,omitempty"`
	LaunchTest       *LaunchTestResult   `json:"launch_test,omitempty"`
	Error            string              `json:"error,omitempty"`
	TestDuration     time.Duration       `json:"test_duration"`
}

type RepositoryStatus struct {
	Repositories []TemplateRepository `json:"repositories"`
	DefaultRepo  string               `json:"default_repo"`
	SyncEnabled  bool                 `json:"sync_enabled"`
	LastSyncTime time.Time            `json:"last_sync_time"`
}

type ResearchUserTemplate = research.ResearchUserTemplate

type ResizeRequest struct {
	InstanceName       string `json:"instance_name"`
	TargetInstanceType string `json:"target_instance_type"`
	Force              bool   `json:"force,omitempty"`
	Wait               bool   `json:"wait,omitempty"`
}

type ResizeResponse struct {
	Success    bool   `json:"success"`
	Message    string `json:"message"`
	InstanceID string `json:"instance_id,omitempty"`
	OldType    string `json:"old_type,omitempty"`
	NewType    string `json:"new_type,omitempty"`
	Status     string `json:"status,omitempty"`
}

type ResourceAnalysis struct {
	CPUAnalysis     CPUAnalysis     `json:"cpu_analysis"`
	MemoryAnalysis  MemoryAnalysis  `json:"memory_analysis"`
	StorageAnalysis StorageAnalysis `json:"storage_analysis"`
	NetworkAnalysis NetworkAnalysis `json:"network_analysis"`
	GPUAnalysis     *GPUAnalysis    `json:"gpu_analysis,omitempty"`
	WorkloadPattern WorkloadPattern `json:"workload_pattern"`
}

type ResourceSummary struct {
	Average           float64 `json:"average"`
	Peak              float64 `json:"peak"`
	P95               float64 `json:"p95"`
	P99               float64 `json:"p99"`
	Minimum           float64 `json:"minimum"`
	StandardDeviation float64 `json:"standard_deviation"`
	TrendDirection    string  `json:"trend_direction"` // "increasing", "decreasing", "stable"
	Bottleneck        bool    `json:"bottleneck"`
	Underutilized     bool    `json:"underutilized"`
}

type ResourceUtilizationSummary struct {
	AverageCPUUtilization     float64 `json:"average_cpu_utilization"`
	AverageMemoryUtilization  float64 `json:"average_memory_utilization"`
	AverageStorageUtilization float64 `json:"average_storage_utilization"`
	InstancesWithLowCPU       int     `json:"instances_with_low_cpu"`
	InstancesWithHighCPU      int     `json:"instances_with_high_cpu"`
	InstancesWithLowMemory    int     `json:"instances_with_low_memory"`
	InstancesWithHighMemory   int     `json:"instances_with_high_memory"`
}

type RestoreRequest struct {
	BackupName      string   `json:"backup_name" binding:"required"`
	TargetInstance  string   `json:"target_instance" binding:"required"`
	RestorePath     string   `json:"restore_path"`
	SelectivePaths  []string `json:"selective_paths"`
	Overwrite       bool     `json:"overwrite"`
	Merge           bool     `json:"merge"`
	DryRun          bool     `json:"dry_run"`
	PreservePerms   bool     `json:"preserve_permissions"`
	PreserveOwner   bool     `json:"preserve_owner"`
	VerifyIntegrity bool     `json:"verify_integrity"`
	Wait            bool     `json:"wait"`
}

type RestoreResult struct {
	RestoreID           string                 `json:"restore_id"`
	BackupName          string                 `json:"backup_name"`
	TargetInstance      string                 `json:"target_instance"`
	RestorePath         string                 `json:"restore_path"`
	SelectivePaths      []string               `json:"selective_paths"`
	State               string                 `json:"state"` // "running", "completed", "error"
	RestoredFileCount   int                    `json:"restored_file_count"`
	RestoredBytes       int64                  `json:"restored_bytes"`
	SkippedFileCount    int                    `json:"skipped_file_count"`
	ErrorCount          int                    `json:"error_count"`
	StartedAt           time.Time              `json:"started_at"`
	CompletedAt         *time.Time             `json:"completed_at,omitempty"`
	EstimatedCompletion int                    `json:"estimated_completion_minutes"`
	Message             string                 `json:"message"`
	Errors              []string               `json:"errors,omitempty"`
	Summary             map[string]interface{} `json:"summary,omitempty"`
	IntegrityVerified   bool                   `json:"integrity_verified"`
}

type RightsizingAnalysisRequest struct {
	InstanceName        string  `json:"instance_name"`
	AnalysisPeriodHours float64 `json:"analysis_period_hours,omitempty"`
	IncludeDetails      bool    `json:"include_details,omitempty"`
	ForceRefresh        bool    `json:"force_refresh,omitempty"`
}

type RightsizingAnalysisResponse struct {
	Recommendation      *RightsizingRecommendation `json:"recommendation"`
	MetricsAvailable    bool                       `json:"metrics_available"`
	DataPointsCount     int                        `json:"data_points_count"`
	AnalysisPeriodHours float64                    `json:"analysis_period_hours"`
	LastUpdated         time.Time                  `json:"last_updated"`
	Message             string                     `json:"message,omitempty"`
}

type RightsizingRecommendation struct {
	InstanceID              string           `json:"instance_id"`
	InstanceName            string           `json:"instance_name"`
	CurrentInstanceType     string           `json:"current_instance_type"`
	CurrentSize             string           `json:"current_size"`
	RecommendedInstanceType string           `json:"recommended_instance_type"`
	RecommendedSize         string           `json:"recommended_size"`
	RecommendationType      RightsizingType  `json:"recommendation_type"`
	Confidence              ConfidenceLevel  `json:"confidence"`
	Reasoning               string           `json:"reasoning"`
	CostImpact              CostImpact       `json:"cost_impact"`
	ResourceAnalysis        ResourceAnalysis `json:"resource_analysis"`
	CreatedAt               time.Time        `json:"created_at"`
	DataPointsAnalyzed      int              `json:"data_points_analyzed"`
	AnalysisPeriodHours     float64          `json:"analysis_period_hours"`
}

type RightsizingRecommendationsResponse struct {
	Recommendations  []RightsizingRecommendation `json:"recommendations"`
	TotalInstances   int                         `json:"total_instances"`
	ActiveInstances  int                         `json:"active_instances"`
	PotentialSavings float64                     `json:"potential_savings"`
	GeneratedAt      time.Time                   `json:"generated_at"`
}

type RightsizingStatsResponse struct {
	InstanceName         string                     `json:"instance_name"`
	CurrentConfiguration InstanceConfiguration      `json:"current_configuration"`
	MetricsSummary       MetricsSummary             `json:"metrics_summary"`
	RecentMetrics        []InstanceMetrics          `json:"recent_metrics"`
	Recommendation       *RightsizingRecommendation `json:"recommendation,omitempty"`
	CollectionStatus     MetricsCollectionStatus    `json:"collection_status"`
}

type RightsizingSummaryResponse struct {
	FleetOverview       FleetOverview              `json:"fleet_overview"`
	CostOptimization    CostOptimizationSummary    `json:"cost_optimization"`
	ResourceUtilization ResourceUtilizationSummary `json:"resource_utilization"`
	Recommendations     RecommendationsSummary     `json:"recommendations"`
	GeneratedAt         time.Time                  `json:"generated_at"`
}

type RightsizingType string

type RollbackRequest struct {
	InstanceName string `json:"instance_name"`
	CheckpointID string `json:"checkpoint_id"`
}

type RuntimeTemplate struct {
	Name                 string
	Slug                 string // CLI identifier for template (e.g., "python-ml")
	Description          string
	LongDescription      string                       // Detailed description for GUI
	AMI                  map[string]map[string]string // region -> arch -> AMI ID
	InstanceType         map[string]string            // arch -> instance type
	UserData             string                       // Generated installation script
	Ports                []int
	RootVolumeGB         int                            `json:"root_volume_gb"` // Root volume size in GB (default: 20)
	EstimatedCostPerHour map[string]float64             // arch -> cost per hour
	IdleDetection        *IdleDetectionConfig           // Idle detection configuration
	ResearchUser         *research.ResearchUserTemplate `json:"research_user,omitempty"`

	// Complexity and categorization for GUI
	Complexity TemplateComplexity `json:"complexity,omitempty"`
	Category   string             `json:"category,omitempty"`
	Domain     string             `json:"domain,omitempty"`

	// Visual presentation for GUI
	Icon     string `json:"icon,omitempty"`
	Color    string `json:"color,omitempty"`
	Popular  bool   `json:"popular,omitempty"`
	Featured bool   `json:"featured,omitempty"`

	// User guidance for GUI
	EstimatedLaunchTime int      `json:"estimated_launch_time,omitempty"`
	Prerequisites       []string `json:"prerequisites,omitempty"`
	LearningResources   []string `json:"learning_resources,omitempty"`

	// Template metadata for GUI
	ValidationStatus ValidationStatus  `json:"validation_status,omitempty"`
	Tags             map[string]string `json:"tags,omitempty"`
	Maintainer       string            `json:"maintainer,omitempty"`

	// Connection configuration
	ConnectionType ConnectionType `json:"connection_type,omitempty"`

	// Additional metadata from unified template
	Source    interface{} `json:"-"` // Reference to source template (avoid circular import)
	Generated time.Time   // When this runtime template was generated
}

type Service struct {
	Name        string `json:"name"`                  // Service name (e.g., "jupyter", "rstudio-server")
	Port        int    `json:"port"`                  // Remote port on instance
	LocalPort   int    `json:"local_port"`            // Local tunnel port (0 = not tunneled)
	Type        string `json:"type,omitempty"`        // Service type: "web", "api", etc.
	URL         string `json:"url,omitempty"`         // Local access URL (e.g., "http://localhost:8787")
	AuthToken   string `json:"auth_token,omitempty"`  // Authentication token if needed
	Status      string `json:"status,omitempty"`      // "running", "stopped", "unknown"
	Description string `json:"description,omitempty"` // Human-readable description
}

type SharedInvitationToken struct {
	// ID is the unique token identifier
	ID string `json:"id"`

	// ProjectID is the project this token grants access to
	ProjectID string `json:"project_id"`

	// Token is the human-readable token code (e.g., WORKSHOP-NEURIPS-2025)
	Token string `json:"token"`

	// Name is the display name for this token
	Name string `json:"name"`

	// Role is the role assigned to users who redeem this token
	Role ProjectRole `json:"role"`

	// Message is an optional welcome message for redeemers
	Message string `json:"message,omitempty"`

	// CreatedBy is the user ID of who created the token
	CreatedBy string `json:"created_by"`

	// CreatedAt is when the token was created
	CreatedAt time.Time `json:"created_at"`

	// ExpiresAt is when the token expires (optional)
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// RedemptionLimit is the maximum number of redemptions allowed
	RedemptionLimit int `json:"redemption_limit"`

	// RedemptionCount is the current number of redemptions
	RedemptionCount int `json:"redemption_count"`

	// Status is the current token status
	Status SharedTokenStatus `json:"status"`

	// Redemptions is the audit trail of redemptions
	Redemptions []SharedTokenRedemption `json:"redemptions"`
}

type SharedTokenRedemption struct {
	// RedeemedBy is the user email/ID who redeemed the token
	RedeemedBy string `json:"redeemed_by"`

	// RedeemedAt is when the redemption occurred
	RedeemedAt time.Time `json:"redeemed_at"`

	// Position is the redemption order (1, 2, 3, ...)
	Position int `json:"position"`
}

type SharedTokenStatus string

type SimpleAPIError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Details string `json:"details,omitempty"`
}

type SnapshotCreationResult struct {
	SnapshotID                 string    `json:"snapshot_id"`
	VolumeID                   string    `json:"volume_id"`
	VolumeSize                 int       `json:"volume_size"`
	Description                string    `json:"description"`
	EstimatedCompletionMinutes int       `json:"estimated_completion_minutes"`
	StorageCostMonthly         float64   `json:"storage_cost_monthly"`
	CreationInitiatedAt        time.Time `json:"creation_initiated_at"`
}

type SnapshotDeletionResult struct {
	SnapshotID            string    `json:"snapshot_id"`
	VolumeSize            int       `json:"volume_size"`
	StorageSavingsMonthly float64   `json:"storage_savings_monthly"`
	CompletedAt           time.Time `json:"completed_at"`
}

type SnapshotInfo struct {
	SnapshotID         string    `json:"snapshot_id"`
	VolumeID           string    `json:"volume_id"`
	VolumeSize         int       `json:"volume_size"`
	Description        string    `json:"description"`
	StartTime          time.Time `json:"start_time"`
	State              string    `json:"state"`
	Progress           string    `json:"progress"`
	StorageCostMonthly float64   `json:"storage_cost_monthly"`
}

type State struct {
	Version        string                   `json:"version"` // State file format version
	Instances      map[string]Instance      `json:"instances"`
	StorageVolumes map[string]StorageVolume `json:"storage_volumes"`
	Config         Config                   `json:"config"`
	IdleSchedules  json.RawMessage          `json:"idle_schedules,omitempty"` // Persisted idle schedules (Issue #288)
}

type StateTransition struct {
	FromState string    `json:"from_state"`          // Previous state (or empty for launch)
	ToState   string    `json:"to_state"`            // New state
	Timestamp time.Time `json:"timestamp"`           // When transition occurred
	Reason    string    `json:"reason,omitempty"`    // Why transition happened (user action, idle detection, etc.)
	Initiator string    `json:"initiator,omitempty"` // Who/what initiated (user, system, policy)
}

type StorageAnalysis struct {
	AverageIOPS       float64 `json:"average_iops"`
	PeakIOPS          float64 `json:"peak_iops"`
	AverageThroughput float64 `json:"average_throughput"`
	PeakThroughput    float64 `json:"peak_throughput"`
	SpaceUtilization  float64 `json:"space_utilization"`
	IsBottleneck      bool    `json:"is_bottleneck"`
	Recommendation    string  `json:"recommendation"`
}

type StorageCost struct {
	// VolumeName is the storage volume identifier
	VolumeName string `json:"volume_name"`

	// VolumeType is the storage type (EFS, EBS, etc.)
	VolumeType string `json:"volume_type"`

	// SizeGB is the storage size in gigabytes
	SizeGB float64 `json:"size_gb"`

	// Cost is the storage cost in USD
	Cost float64 `json:"cost"`

	// CostPerGB is the cost per gigabyte
	CostPerGB float64 `json:"cost_per_gb"`
}

type StorageCreateRequest struct {
	Name       string `json:"name"`
	Size       string `json:"size"`        // XS, S, M, L, XL or specific GB
	VolumeType string `json:"volume_type"` // gp3, io2
	Region     string `json:"region,omitempty"`
}

type StorageMetrics struct {
	TotalGB             float64 `json:"total_gb"`
	UsedGB              float64 `json:"used_gb"`
	AvailableGB         float64 `json:"available_gb"`
	UtilizationPercent  float64 `json:"utilization_percent"`
	ReadIOPS            float64 `json:"read_iops"`
	WriteIOPS           float64 `json:"write_iops"`
	ReadThroughputMBps  float64 `json:"read_throughput_mbps"`
	WriteThroughputMBps float64 `json:"write_throughput_mbps"`
}

type StorageType string

type StorageVolume struct {
	Name         string      `json:"name"`          // User-friendly name
	Type         StorageType `json:"type"`          // User-facing type (local/shared/cloud)
	AWSService   AWSService  `json:"aws_service"`   // Technical AWS service
	Region       string      `json:"region"`        // AWS region
	State        string      `json:"state"`         // available, creating, in-use, deleting
	CreationTime time.Time   `json:"creation_time"` // When created

	// Size/capacity (varies by type)
	SizeGB    *int32 `json:"size_gb,omitempty"`    // Size in GB (EBS)
	SizeBytes *int64 `json:"size_bytes,omitempty"` // Size in bytes (EFS)

	// EBS-specific fields
	VolumeID   string `json:"volume_id,omitempty"`   // AWS EBS volume ID
	VolumeType string `json:"volume_type,omitempty"` // gp3, io2, etc.
	IOPS       *int32 `json:"iops,omitempty"`        // Provisioned IOPS
	Throughput *int32 `json:"throughput,omitempty"`  // MB/s throughput
	AttachedTo string `json:"attached_to,omitempty"` // Instance name if attached

	// EFS-specific fields
	FileSystemID    string   `json:"filesystem_id,omitempty"`    // AWS EFS ID
	MountTargets    []string `json:"mount_targets,omitempty"`    // Mount target IDs
	PerformanceMode string   `json:"performance_mode,omitempty"` // generalPurpose, maxIO
	ThroughputMode  string   `json:"throughput_mode,omitempty"`  // bursting, provisioned

	// S3-specific fields
	BucketName string `json:"bucket_name,omitempty"` // S3 bucket name

	// Cost estimation
	EstimatedCostGB float64 `json:"estimated_cost_gb"` // $/GB/month
}

type SystemMetrics struct {
	ProcessCount    int       `json:"process_count"`
	LoggedInUsers   int       `json:"logged_in_users"`
	UptimeSeconds   float64   `json:"uptime_seconds"`
	LastActivity    time.Time `json:"last_activity"`
	LoadAverage1Min float64   `json:"load_average_1min"`
}

type Template = RuntimeTemplate

type TemplateComplexity string

type TemplateRepository struct {
	Name          string    `json:"name"`
	URL           string    `json:"url"`
	Priority      int       `json:"priority"`
	Enabled       bool      `json:"enabled"`
	LastSync      time.Time `json:"last_sync"`
	TemplateCount int       `json:"template_count"`
	Description   string    `json:"description"`
	Owner         string    `json:"owner,omitempty"`
	AuthType      string    `json:"auth_type,omitempty"` // none, token, ssh
}

type TemplateRepositoryUpdate struct {
	Name     string `json:"name"`
	URL      string `json:"url"`
	Priority int    `json:"priority"`
	Enabled  bool   `json:"enabled"`
}

type ValidationStatus string

type VolumeCreateRequest struct {
	Name            string `json:"name"`
	PerformanceMode string `json:"performance_mode,omitempty"` // generalPurpose, maxIO
	ThroughputMode  string `json:"throughput_mode,omitempty"`  // bursting, provisioned
	Region          string `json:"region,omitempty"`
}

type WorkloadPattern struct {
	Type                WorkloadPatternType `json:"type"`
	ConsistencyScore    float64             `json:"consistency_score"`
	PeakHours           []int               `json:"peak_hours"`
	SeasonalityDetected bool                `json:"seasonality_detected"`
	GrowthTrend         float64             `json:"growth_trend"`
	BurstFrequency      float64             `json:"burst_frequency"`
	Description         string              `json:"description"`
}

type WorkloadPatternType string