cli

type AccessLogEntry struct {
	Timestamp string
	Duration  string
	ClientIP  string
	Status    string
	Size      string
	Method    string
	URL       string
	User      string
	Hierarchy string
	Type      string
}

type AccessLogSummary struct {
	TotalRequests  int                        `json:"total_requests" console:"header:Total Requests"`
	AllowedCount   int                        `json:"allowed_count" console:"header:Allowed"`
	DeniedCount    int                        `json:"denied_count" console:"header:Denied"`
	AllowedDomains []string                   `json:"allowed_domains" console:"-"`
	DeniedDomains  []string                   `json:"denied_domains" console:"-"`
	ByWorkflow     map[string]*DomainAnalysis `json:"by_workflow,omitempty" console:"-"`
}

type ActionInput struct {
	Name        string
	Description string
	Required    bool
	Default     string
}

type ActionMetadata struct {
	Name         string
	Description  string
	Filename     string // e.g., "noop.cjs"
	ActionName   string // e.g., "noop"
	Inputs       []ActionInput
	Outputs      []ActionOutput
	Dependencies []string
}

type ActionOutput struct {
	Name        string
	Description string
}

type Argument struct {
	Type  string `json:"type"`
	Value string `json:"value,omitempty"`
}

type AuditData struct {
	Overview                OverviewData             `json:"overview"`
	Metrics                 MetricsData              `json:"metrics"`
	KeyFindings             []Finding                `json:"key_findings,omitempty"`
	Recommendations         []Recommendation         `json:"recommendations,omitempty"`
	FailureAnalysis         *FailureAnalysis         `json:"failure_analysis,omitempty"`
	PerformanceMetrics      *PerformanceMetrics      `json:"performance_metrics,omitempty"`
	Jobs                    []JobData                `json:"jobs,omitempty"`
	DownloadedFiles         []FileInfo               `json:"downloaded_files"`
	MissingTools            []MissingToolReport      `json:"missing_tools,omitempty"`
	Noops                   []NoopReport             `json:"noops,omitempty"`
	MCPFailures             []MCPFailureReport       `json:"mcp_failures,omitempty"`
	FirewallAnalysis        *FirewallAnalysis        `json:"firewall_analysis,omitempty"`
	RedactedDomainsAnalysis *RedactedDomainsAnalysis `json:"redacted_domains_analysis,omitempty"`
	Errors                  []ErrorInfo              `json:"errors,omitempty"`
	Warnings                []ErrorInfo              `json:"warnings,omitempty"`
	ToolUsage               []ToolUsageInfo          `json:"tool_usage,omitempty"`
}

type AwInfo struct {
	EngineID     string      `json:"engine_id"`
	EngineName   string      `json:"engine_name"`
	Model        string      `json:"model"`
	Version      string      `json:"version"`
	WorkflowName string      `json:"workflow_name"`
	Staged       bool        `json:"staged"`
	Steps        AwInfoSteps `json:"steps,omitempty"` // Steps metadata
	CreatedAt    string      `json:"created_at"`
	// Additional fields that might be present
	RunID      any    `json:"run_id,omitempty"`
	RunNumber  any    `json:"run_number,omitempty"`
	Repository string `json:"repository,omitempty"`
}

type AwInfoSteps struct {
	Firewall string `json:"firewall,omitempty"` // Firewall type (e.g., "squid") or empty if no firewall
}

type Codemod struct {
	ID           string // Unique identifier for the codemod
	Name         string // Human-readable name
	Description  string // Description of what the codemod does
	IntroducedIn string // Version where this codemod was introduced
	Apply        func(content string, frontmatter map[string]any) (string, bool, error)
}

type CodemodResult struct {
	Applied bool   // Whether the codemod was applied
	Message string // Description of what changed
}

type CombinedTrialResult struct {
	WorkflowNames []string              `json:"workflow_names"`
	Results       []WorkflowTrialResult `json:"results"`
	Timestamp     time.Time             `json:"timestamp"`
}

type CompilationStats struct {
	Total           int
	Errors          int
	Warnings        int
	FailedWorkflows []string // Names of workflows that failed compilation
}

type CompileConfig struct {
	MarkdownFiles        []string // Files to compile (empty for all files)
	Verbose              bool     // Enable verbose output
	EngineOverride       string   // Override AI engine setting
	Validate             bool     // Enable schema validation
	Watch                bool     // Enable watch mode
	WorkflowDir          string   // Custom workflow directory
	SkipInstructions     bool     // Deprecated: Instructions are no longer written during compilation
	NoEmit               bool     // Validate without generating lock files
	Purge                bool     // Remove orphaned lock files
	TrialMode            bool     // Enable trial mode (suppress safe outputs)
	TrialLogicalRepoSlug string   // Target repository for trial mode
	Strict               bool     // Enable strict mode validation
	Dependabot           bool     // Generate Dependabot manifests for npm dependencies
	ForceOverwrite       bool     // Force overwrite of existing files (dependabot.yml)
	Zizmor               bool     // Run zizmor security scanner on generated .lock.yml files
	Poutine              bool     // Run poutine security scanner on generated .lock.yml files
	Actionlint           bool     // Run actionlint linter on generated .lock.yml files
	JSONOutput           bool     // Output validation results as JSON
	RefreshStopTime      bool     // Force regeneration of stop-after times instead of preserving existing ones
	ActionMode           string   // Action script inlining mode: inline, dev, or release
}

type ContinuationData struct {
	Message      string `json:"message"`
	WorkflowName string `json:"workflow_name,omitempty"`
	Count        int    `json:"count,omitempty"`
	StartDate    string `json:"start_date,omitempty"`
	EndDate      string `json:"end_date,omitempty"`
	Engine       string `json:"engine,omitempty"`
	Branch       string `json:"branch,omitempty"`
	AfterRunID   int64  `json:"after_run_id,omitempty"`
	BeforeRunID  int64  `json:"before_run_id,omitempty"`
	Timeout      int    `json:"timeout,omitempty"`
}

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

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

type DevcontainerCodespaces struct {
	Repositories map[string]DevcontainerRepoPermissions `json:"repositories"`
}

type DevcontainerConfig struct {
	Name              string                      `json:"name"`
	Image             string                      `json:"image"`
	Customizations    *DevcontainerCustomizations `json:"customizations,omitempty"`
	Features          DevcontainerFeatures        `json:"features,omitempty"`
	PostCreateCommand string                      `json:"postCreateCommand,omitempty"`
}

type DevcontainerCustomizations struct {
	VSCode     *DevcontainerVSCode     `json:"vscode,omitempty"`
	Codespaces *DevcontainerCodespaces `json:"codespaces,omitempty"`
}

type DevcontainerFeatures map[string]any

type DevcontainerRepoPermissions struct {
	Permissions map[string]string `json:"permissions"`
}

type DevcontainerVSCode struct {
	Settings   map[string]any `json:"settings,omitempty"`
	Extensions []string       `json:"extensions,omitempty"`
}

type DomainAnalysis struct {
	DomainBuckets
	TotalRequests int
	AllowedCount  int
	DeniedCount   int
}

type DomainBuckets struct {
	AllowedDomains []string
	DeniedDomains  []string
}

type DomainRequestStats struct {
	Allowed int
	Denied  int
}

type DownloadResult struct {
	Run                     WorkflowRun
	Metrics                 LogMetrics
	AccessAnalysis          *DomainAnalysis
	FirewallAnalysis        *FirewallAnalysis
	RedactedDomainsAnalysis *RedactedDomainsAnalysis
	MissingTools            []MissingToolReport
	Noops                   []NoopReport
	MCPFailures             []MCPFailureReport
	JobDetails              []JobInfoWithDuration
	Error                   error
	Skipped                 bool
	Cached                  bool // True if loaded from cached summary
	LogsPath                string
}

type EnvironmentVariable struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	IsRequired  bool   `json:"is_required,omitempty"`
	IsSecret    bool   `json:"is_secret,omitempty"`
	Default     string `json:"default,omitempty"`
}

type ErrorInfo struct {
	File    string `json:"file,omitempty"`
	Line    int    `json:"line,omitempty"`
	Type    string `json:"type"`
	Message string `json:"message"`
}

type ErrorSummary struct {
	Type         string `json:"type" console:"header:Type"`
	Message      string `json:"message" console:"header:Message,maxlen:80"`
	Count        int    `json:"count" console:"header:Occurrences"`
	Engine       string `json:"engine,omitempty" console:"header:Engine,omitempty"`
	RunID        int64  `json:"run_id" console:"header:Sample Run"`
	RunURL       string `json:"run_url" console:"-"`
	WorkflowName string `json:"workflow_name,omitempty" console:"-"`
	PatternID    string `json:"pattern_id,omitempty" console:"-"`
}

type FailureAnalysis struct {
	PrimaryFailure string   `json:"primary_failure"`      // Main reason for failure
	FailedJobs     []string `json:"failed_jobs"`          // List of failed job names
	ErrorSummary   string   `json:"error_summary"`        // Summary of errors
	RootCause      string   `json:"root_cause,omitempty"` // Identified root cause if determinable
}

type FileInfo struct {
	Path        string `json:"path"`
	Size        int64  `json:"size"`
	Description string `json:"description"`
}

type FileTracker struct {
	CreatedFiles    []string
	ModifiedFiles   []string
	OriginalContent map[string][]byte // Store original content for rollback
	// contains filtered or unexported fields
}

type Finding struct {
	Category    string `json:"category"`         // e.g., "error", "performance", "cost", "tooling"
	Severity    string `json:"severity"`         // "critical", "high", "medium", "low", "info"
	Title       string `json:"title"`            // Brief title
	Description string `json:"description"`      // Detailed description
	Impact      string `json:"impact,omitempty"` // What impact this has
}

type FirewallAnalysis struct {
	DomainBuckets
	TotalRequests    int
	AllowedRequests  int
	DeniedRequests   int
	RequestsByDomain map[string]DomainRequestStats
}

type FirewallLogEntry struct {
	Timestamp    string
	ClientIPPort string
	Domain       string
	DestIPPort   string
	Proto        string
	Method       string
	Status       string
	Decision     string
	URL          string
	UserAgent    string
}

type FirewallLogSummary struct {
	TotalRequests    int                           `json:"total_requests" console:"header:Total Requests"`
	AllowedRequests  int                           `json:"allowed_requests" console:"header:Allowed"`
	DeniedRequests   int                           `json:"denied_requests" console:"header:Denied"`
	AllowedDomains   []string                      `json:"allowed_domains" console:"-"`
	DeniedDomains    []string                      `json:"denied_domains" console:"-"`
	RequestsByDomain map[string]DomainRequestStats `json:"requests_by_domain,omitempty" console:"-"`
	ByWorkflow       map[string]*FirewallAnalysis  `json:"by_workflow,omitempty" console:"-"`
}

type FixConfig struct {
	WorkflowIDs []string
	Write       bool
	Verbose     bool
}

type GitHubWorkflow struct {
	ID    int64  `json:"id"`
	Name  string `json:"name"`
	Path  string `json:"path"`
	State string `json:"state"`
}

type Header struct {
	Name     string `json:"name"`
	IsSecret bool   `json:"is_secret,omitempty"`
	Default  string `json:"default,omitempty"`
}

type IncludeDependency struct {
	SourcePath string // Path in the source (local)
	TargetPath string // Relative path where it should be copied in .github/workflows
	IsOptional bool   // Whether this is an optional include (@include?)
}

type InteractiveWorkflowBuilder struct {
	WorkflowName  string
	Trigger       string
	Engine        string
	Tools         []string
	SafeOutputs   []string
	Intent        string
	NetworkAccess string
	CustomDomains []string
}

type JobData struct {
	Name       string `json:"name" console:"header:Name"`
	Status     string `json:"status" console:"header:Status"`
	Conclusion string `json:"conclusion,omitempty" console:"header:Conclusion,omitempty"`
	Duration   string `json:"duration,omitempty" console:"header:Duration,omitempty"`
}

type JobInfo struct {
	Name        string    `json:"name"`
	Status      string    `json:"status"`
	Conclusion  string    `json:"conclusion"`
	StartedAt   time.Time `json:"started_at,omitempty"`
	CompletedAt time.Time `json:"completed_at,omitempty"`
}

type JobInfoWithDuration struct {
	JobInfo
	Duration time.Duration
}

type LogAnalysis interface {
	// GetAllowedDomains returns the list of allowed domains
	GetAllowedDomains() []string
	// GetDeniedDomains returns the list of denied domains
	GetDeniedDomains() []string
	// SetAllowedDomains sets the list of allowed domains
	SetAllowedDomains(domains []string)
	// SetDeniedDomains sets the list of denied domains
	SetDeniedDomains(domains []string)
	// AddMetrics adds metrics from another analysis
	AddMetrics(other LogAnalysis)
}

type LogMetrics = workflow.LogMetrics

type LogParser[T LogAnalysis] func(logPath string, verbose bool) (T, error)

type LogsData struct {
	Summary           LogsSummary                `json:"summary" console:"title:Workflow Logs Summary"`
	Runs              []RunData                  `json:"runs" console:"title:Workflow Logs Overview"`
	ToolUsage         []ToolUsageSummary         `json:"tool_usage,omitempty" console:"title:🛠️  Tool Usage Summary,omitempty"`
	ErrorsAndWarnings []ErrorSummary             `json:"errors_and_warnings,omitempty" console:"title:Errors and Warnings,omitempty"`
	MissingTools      []MissingToolSummary       `json:"missing_tools,omitempty" console:"title:🛠️  Missing Tools Summary,omitempty"`
	MCPFailures       []MCPFailureSummary        `json:"mcp_failures,omitempty" console:"title:⚠️  MCP Server Failures,omitempty"`
	AccessLog         *AccessLogSummary          `json:"access_log,omitempty" console:"title:Access Log Analysis,omitempty"`
	FirewallLog       *FirewallLogSummary        `json:"firewall_log,omitempty" console:"title:🔥 Firewall Log Analysis,omitempty"`
	RedactedDomains   *RedactedDomainsLogSummary `json:"redacted_domains,omitempty" console:"title:🔒 Redacted URL Domains,omitempty"`
	Continuation      *ContinuationData          `json:"continuation,omitempty" console:"-"`
	LogsLocation      string                     `json:"logs_location" console:"-"`
}

type LogsDataSchema struct {
	Description string                 `json:"description"`
	Type        string                 `json:"type"`
	Fields      map[string]SchemaField `json:"fields"`
}

type LogsSummary struct {
	TotalRuns         int     `json:"total_runs" console:"header:Total Runs"`
	TotalDuration     string  `json:"total_duration" console:"header:Total Duration"`
	TotalTokens       int     `json:"total_tokens" console:"header:Total Tokens,format:number"`
	TotalCost         float64 `json:"total_cost" console:"header:Total Cost,format:cost"`
	TotalTurns        int     `json:"total_turns" console:"header:Total Turns"`
	TotalErrors       int     `json:"total_errors" console:"header:Total Errors"`
	TotalWarnings     int     `json:"total_warnings" console:"header:Total Warnings"`
	TotalMissingTools int     `json:"total_missing_tools" console:"header:Total Missing Tools"`
}

type MCPConfig struct {
	Servers map[string]VSCodeMCPServer `json:"servers"`
}

type MCPFailureReport struct {
	ServerName   string `json:"server_name"`
	Status       string `json:"status"`
	Timestamp    string `json:"timestamp,omitempty"`
	WorkflowName string `json:"workflow_name,omitempty"`
	RunID        int64  `json:"run_id,omitempty"`
}

type MCPFailureSummary struct {
	ServerName       string   `json:"server_name" console:"header:Server"`
	Count            int      `json:"count" console:"header:Failures"`
	Workflows        []string `json:"workflows" console:"-"`                  // List of workflow names that had this server fail
	WorkflowsDisplay string   `json:"-" console:"header:Workflows,maxlen:60"` // Formatted display of workflows
	RunIDs           []int64  `json:"run_ids" console:"-"`                    // List of run IDs where this server failed
}

type MCPLogsGuardrailResponse struct {
	Message          string             `json:"message"`
	OutputTokens     int                `json:"output_tokens"`
	OutputSizeLimit  int                `json:"output_size_limit"`
	Schema           LogsDataSchema     `json:"schema"`
	SuggestedQueries []SuggestedJqQuery `json:"suggested_queries"`
}

type MCPPackage struct {
	RegistryType         string                `json:"registry_type,omitempty"`
	Identifier           string                `json:"identifier,omitempty"`
	Version              string                `json:"version,omitempty"`
	RuntimeHint          string                `json:"runtime_hint,omitempty"`
	Transport            Transport             `json:"transport,omitempty"`
	RuntimeArguments     []Argument            `json:"runtime_arguments,omitempty"`
	PackageArguments     []Argument            `json:"package_arguments,omitempty"`
	EnvironmentVariables []EnvironmentVariable `json:"environment_variables,omitempty"`
}

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

type MCPRegistryServerForProcessing struct {
	Name                 string                `json:"name"`
	Description          string                `json:"description"`
	Repository           string                `json:"repository"`
	Command              string                `json:"command"`
	Args                 []string              `json:"args"`
	RuntimeHint          string                `json:"runtime_hint"`
	RuntimeArguments     []string              `json:"runtime_arguments"`
	Transport            string                `json:"transport"`
	Config               map[string]any        `json:"config"`
	EnvironmentVariables []EnvironmentVariable `json:"environment_variables"`
}

type MCPToolTableOptions struct {
	// TruncateLength is the maximum length for tool descriptions before truncation
	// A value of 0 means no truncation
	TruncateLength int
	// ShowSummary controls whether to display the summary line at the bottom
	ShowSummary bool
	// SummaryFormat is the format string for the summary (default: "📊 Summary: %d allowed, %d not allowed out of %d total tools\n")
	SummaryFormat string
	// ShowVerboseHint controls whether to show the "Run with --verbose" hint in non-verbose mode
	ShowVerboseHint bool
}

type MetricsData struct {
	TokenUsage    int     `json:"token_usage,omitempty" console:"header:Token Usage,format:number,omitempty"`
	EstimatedCost float64 `json:"estimated_cost,omitempty" console:"header:Estimated Cost,format:cost,omitempty"`
	Turns         int     `json:"turns,omitempty" console:"header:Turns,omitempty"`
	ErrorCount    int     `json:"error_count" console:"header:Errors"`
	WarningCount  int     `json:"warning_count" console:"header:Warnings"`
}

type MissingToolReport struct {
	Tool         string `json:"tool"`
	Reason       string `json:"reason"`
	Alternatives string `json:"alternatives,omitempty"`
	Timestamp    string `json:"timestamp"`
	WorkflowName string `json:"workflow_name,omitempty"` // Added for tracking which workflow reported this
	RunID        int64  `json:"run_id,omitempty"`        // Added for tracking which run reported this
}

type MissingToolSummary struct {
	Tool               string   `json:"tool" console:"header:Tool"`
	Count              int      `json:"count" console:"header:Occurrences"`
	Workflows          []string `json:"workflows" console:"-"`                     // List of workflow names that reported this tool
	WorkflowsDisplay   string   `json:"-" console:"header:Workflows,maxlen:40"`    // Formatted display of workflows
	FirstReason        string   `json:"first_reason" console:"-"`                  // Reason from the first occurrence
	FirstReasonDisplay string   `json:"-" console:"header:First Reason,maxlen:50"` // Formatted display of first reason
	RunIDs             []int64  `json:"run_ids" console:"-"`                       // List of run IDs where this tool was reported
}

type NoopReport struct {
	Message      string `json:"message"`
	Timestamp    string `json:"timestamp,omitempty"`
	WorkflowName string `json:"workflow_name,omitempty"` // Added for tracking which workflow reported this
	RunID        int64  `json:"run_id,omitempty"`        // Added for tracking which run reported this
}

type OverviewData struct {
	RunID        int64     `json:"run_id" console:"header:Run ID"`
	WorkflowName string    `json:"workflow_name" console:"header:Workflow"`
	Status       string    `json:"status" console:"header:Status"`
	Conclusion   string    `json:"conclusion,omitempty" console:"header:Conclusion,omitempty"`
	CreatedAt    time.Time `json:"created_at" console:"header:Created At"`
	StartedAt    time.Time `json:"started_at,omitempty" console:"header:Started At,omitempty"`
	UpdatedAt    time.Time `json:"updated_at,omitempty" console:"header:Updated At,omitempty"`
	Duration     string    `json:"duration,omitempty" console:"header:Duration,omitempty"`
	Event        string    `json:"event" console:"header:Event"`
	Branch       string    `json:"branch" console:"header:Branch"`
	URL          string    `json:"url" console:"header:URL"`
	LogsPath     string    `json:"logs_path,omitempty" console:"header:Files,omitempty"`
}

type OverviewDisplay struct {
	RunID    int64  `console:"header:Run ID"`
	Workflow string `console:"header:Workflow"`
	Status   string `console:"header:Status"`
	Duration string `console:"header:Duration,omitempty"`
	Event    string `console:"header:Event"`
	Branch   string `console:"header:Branch"`
	URL      string `console:"header:URL"`
	Files    string `console:"header:Files,omitempty"`
}

type PRInfo struct {
	Number      int    `json:"number"`
	Title       string `json:"title"`
	Body        string `json:"body"`
	State       string `json:"state"`
	HeadSHA     string `json:"headSHA"`
	BaseBranch  string `json:"baseBranch"`
	HeadBranch  string `json:"headBranch"`
	SourceRepo  string `json:"sourceRepo"`
	TargetRepo  string `json:"targetRepo"`
	AuthorLogin string `json:"authorLogin"`
}

type Package struct {
	Name      string
	Path      string
	Workflows []string
	CommitSHA string
}

type PerformanceMetrics struct {
	TokensPerMinute float64 `json:"tokens_per_minute,omitempty"`
	CostEfficiency  string  `json:"cost_efficiency,omitempty"` // e.g., "good", "poor"
	AvgToolDuration string  `json:"avg_tool_duration,omitempty"`
	MostUsedTool    string  `json:"most_used_tool,omitempty"`
	NetworkRequests int     `json:"network_requests,omitempty"`
}

type PollOptions struct {
	// Interval between poll attempts
	PollInterval time.Duration
	// Timeout for the entire polling operation
	Timeout time.Duration
	// Function to call on each poll iteration
	// Should return PollContinue to keep polling, PollSuccess to succeed, or PollFailure to fail
	PollFunc func() (PollResult, error)
	// Message to display when polling starts (optional)
	StartMessage string
	// Message to display on each poll iteration (optional)
	ProgressMessage string
	// Message to display on successful completion (optional)
	SuccessMessage string
	// Whether to show verbose progress messages
	Verbose bool
}

type PollResult int

type ProcessedRun struct {
	Run                     WorkflowRun
	AccessAnalysis          *DomainAnalysis
	FirewallAnalysis        *FirewallAnalysis
	RedactedDomainsAnalysis *RedactedDomainsAnalysis
	MissingTools            []MissingToolReport
	Noops                   []NoopReport
	MCPFailures             []MCPFailureReport
	JobDetails              []JobInfoWithDuration
}

type PullRequest struct {
	Number    int       `json:"number"`
	Title     string    `json:"title"`
	IsDraft   bool      `json:"isDraft"`
	Mergeable string    `json:"mergeable"`
	CreatedAt time.Time `json:"createdAt"`
	UpdatedAt time.Time `json:"updatedAt"`
}

type Recommendation struct {
	Priority string `json:"priority"`          // "high", "medium", "low"
	Action   string `json:"action"`            // What to do
	Reason   string `json:"reason"`            // Why to do it
	Example  string `json:"example,omitempty"` // Example of how to implement
}

type RedactedDomainsAnalysis struct {
	// TotalDomains is the total number of unique domains found in the redacted log
	TotalDomains int `json:"total_domains" console:"header:Total Domains"`
	// Domains is a sorted list of unique domain names that were redacted
	Domains []string `json:"domains" console:"title:Redacted Domains,omitempty"`
}

type RedactedDomainsLogSummary struct {
	TotalDomains int                                 `json:"total_domains" console:"header:Total Domains"`
	Domains      []string                            `json:"domains" console:"title:Redacted Domains,omitempty"`
	ByWorkflow   map[string]*RedactedDomainsAnalysis `json:"by_workflow,omitempty" console:"-"`
}

type Remote struct {
	Type    string   `json:"type"`
	URL     string   `json:"url"`
	Headers []Header `json:"headers,omitempty"`
}

type RepeatOptions struct {
	// Number of times to repeat execution (0 = run once)
	RepeatCount int
	// Message to display when starting repeat mode
	StartMessage string
	// Message to display on each repeat iteration (optional, uses default if empty)
	RepeatMessage string
	// Function to execute on each iteration
	ExecuteFunc func() error
	// Function to execute on cleanup/exit (optional)
	CleanupFunc func()
	// Whether to use stderr for informational messages (default: true)
	UseStderr bool
}

type RepoSpec struct {
	RepoSlug string // e.g., "owner/repo"
	Version  string // optional version/tag/SHA/branch
}

type Repository struct {
	URL    string `json:"url"`
	Source string `json:"source,omitempty"`
}

type RunData struct {
	DatabaseID       int64     `json:"database_id" console:"header:Run ID"`
	Number           int       `json:"number" console:"-"`
	WorkflowName     string    `json:"workflow_name" console:"header:Workflow"`
	Agent            string    `json:"agent,omitempty" console:"header:Agent,omitempty"`
	Status           string    `json:"status" console:"header:Status"`
	Conclusion       string    `json:"conclusion,omitempty" console:"-"`
	Duration         string    `json:"duration,omitempty" console:"header:Duration,omitempty"`
	TokenUsage       int       `json:"token_usage,omitempty" console:"header:Tokens,format:number,omitempty"`
	EstimatedCost    float64   `json:"estimated_cost,omitempty" console:"header:Cost ($),format:cost,omitempty"`
	Turns            int       `json:"turns,omitempty" console:"header:Turns,omitempty"`
	ErrorCount       int       `json:"error_count" console:"header:Errors"`
	WarningCount     int       `json:"warning_count" console:"header:Warnings"`
	MissingToolCount int       `json:"missing_tool_count" console:"header:Missing"`
	CreatedAt        time.Time `json:"created_at" console:"header:Created"`
	URL              string    `json:"url" console:"-"`
	LogsPath         string    `json:"logs_path" console:"header:Logs Path"`
	Event            string    `json:"event" console:"-"`
	Branch           string    `json:"branch" console:"-"`
}

type RunSummary struct {
	CLIVersion              string                   `json:"cli_version"`               // CLI version used to process this run
	RunID                   int64                    `json:"run_id"`                    // Workflow run database ID
	ProcessedAt             time.Time                `json:"processed_at"`              // When this summary was created
	Run                     WorkflowRun              `json:"run"`                       // Full workflow run metadata
	Metrics                 LogMetrics               `json:"metrics"`                   // Extracted log metrics
	AccessAnalysis          *DomainAnalysis          `json:"access_analysis"`           // Network access analysis
	FirewallAnalysis        *FirewallAnalysis        `json:"firewall_analysis"`         // Firewall log analysis
	RedactedDomainsAnalysis *RedactedDomainsAnalysis `json:"redacted_domains_analysis"` // Redacted URL domains analysis
	MissingTools            []MissingToolReport      `json:"missing_tools"`             // Missing tool reports
	Noops                   []NoopReport             `json:"noops"`                     // Noop messages
	MCPFailures             []MCPFailureReport       `json:"mcp_failures"`              // MCP server failures
	ArtifactsList           []string                 `json:"artifacts_list"`            // List of downloaded artifact files
	JobDetails              []JobInfoWithDuration    `json:"job_details"`               // Job execution details
}

type SchemaField struct {
	Type        string `json:"type"`
	Description string `json:"description"`
}

type SecretInfo struct {
	Name      string // Secret name (e.g., "DD_API_KEY")
	EnvKey    string // Environment variable key where it should be set
	Available bool   // Whether the secret is available
	Source    string // Where the secret was found ("env", "actions", or "")
	Value     string // The secret value (if fetched)
}

type Server struct {
	Name        string       `json:"name"`
	Description string       `json:"description"`
	Status      string       `json:"status"`
	Version     string       `json:"version,omitempty"`
	Repository  Repository   `json:"repository,omitempty"`
	Packages    []MCPPackage `json:"packages,omitempty"`
	Remotes     []Remote     `json:"remotes,omitempty"`
}

type ServerListResponse struct {
	Servers []Server `json:"servers"`
}

type SourceSpec struct {
	Repo string // e.g., "owner/repo"
	Path string // e.g., "workflows/workflow-name.md"
	Ref  string // optional ref (version/tag/SHA/branch)
}

type SuggestedJqQuery struct {
	Description string `json:"description"`
	Query       string `json:"query"`
	Example     string `json:"example,omitempty"`
}

type ToolGraph struct {
	Tools       map[string]bool // Set of all tools
	Transitions map[string]int  // Key: "from->to", Value: count
	// contains filtered or unexported fields
}

type ToolTransition struct {
	From  string // Source tool name
	To    string // Target tool name
	Count int    // Number of times this transition occurred
}

type ToolUsageInfo struct {
	Name          string `json:"name" console:"header:Tool"`
	CallCount     int    `json:"call_count" console:"header:Calls"`
	MaxInputSize  int    `json:"max_input_size,omitempty" console:"header:Max Input,format:number,omitempty"`
	MaxOutputSize int    `json:"max_output_size,omitempty" console:"header:Max Output,format:number,omitempty"`
	MaxDuration   string `json:"max_duration,omitempty" console:"header:Max Duration,omitempty"`
}

type ToolUsageSummary struct {
	Name          string `json:"name" console:"header:Tool"`
	TotalCalls    int    `json:"total_calls" console:"header:Total Calls,format:number"`
	Runs          int    `json:"runs" console:"header:Runs"` // Number of runs that used this tool
	MaxOutputSize int    `json:"max_output_size,omitempty" console:"header:Max Output,format:filesize,default:N/A,omitempty"`
	MaxDuration   string `json:"max_duration,omitempty" console:"header:Max Duration,default:N/A,omitempty"`
}

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

type TrialArtifacts struct {
	SafeOutputs map[string]any `json:"safe_outputs"`
	//AgentStdioLogs      []string               `json:"agent_stdio_logs,omitempty"`
	AgenticRunInfo      map[string]any `json:"agentic_run_info,omitempty"`
	AdditionalArtifacts map[string]any `json:"additional_artifacts,omitempty"`
}

type TrialSecretTracker struct {
	RepoSlug     string          `json:"repo_slug"`
	AddedSecrets map[string]bool `json:"added_secrets"` // secrets that were successfully added by trial
}

type VSCodeMCPServer struct {
	Command string   `json:"command"`
	Args    []string `json:"args"`
	CWD     string   `json:"cwd,omitempty"`
}

type ValidationError struct {
	Type    string `json:"type"`
	Message string `json:"message"`
	Line    int    `json:"line,omitempty"`
}

type ValidationResult struct {
	Workflow     string            `json:"workflow"`
	Valid        bool              `json:"valid"`
	Errors       []ValidationError `json:"errors"`
	Warnings     []ValidationError `json:"warnings"`
	CompiledFile string            `json:"compiled_file,omitempty"`
}

type Workflow struct {
	Name string                 `yaml:"name,omitempty"`
	On   any                    `yaml:"on,omitempty"`
	Jobs map[string]WorkflowJob `yaml:"jobs,omitempty"`
}

type WorkflowFileStatus struct {
	IsModified         bool // File has unstaged changes
	IsStaged           bool // File has staged changes
	HasUnpushedCommits bool // File has unpushed commits affecting it
}

type WorkflowInfo struct {
	ID          string `console:"header:ID"`
	Name        string `console:"header:Name"`
	Description string `console:"header:Description,omitempty"`
	Path        string `console:"-"` // Internal use only, not displayed
}

type WorkflowJob struct {
	RunsOn      any            `yaml:"runs-on,omitempty"`
	Permissions map[string]any `yaml:"permissions,omitempty"`
	Steps       []WorkflowStep `yaml:"steps,omitempty"`
}

type WorkflowMCPMetadata struct {
	FilePath    string
	FileName    string
	BaseName    string
	MCPConfigs  []parser.MCPServerConfig
	Frontmatter map[string]any
}

type WorkflowNode struct {
	Path       string   // Absolute path to the workflow file
	IsTopLevel bool     // True if this is a top-level workflow (not in subdirectory)
	Imports    []string // List of imported file paths (absolute)
}

type WorkflowRun struct {
	DatabaseID       int64     `json:"databaseId"`
	Number           int       `json:"number"`
	URL              string    `json:"url"`
	Status           string    `json:"status"`
	Conclusion       string    `json:"conclusion"`
	WorkflowName     string    `json:"workflowName"`
	WorkflowPath     string    `json:"workflowPath,omitempty"` // Workflow file path (e.g., .github/workflows/copilot-swe-agent.yml)
	CreatedAt        time.Time `json:"createdAt"`
	StartedAt        time.Time `json:"startedAt"`
	UpdatedAt        time.Time `json:"updatedAt"`
	Event            string    `json:"event"`
	HeadBranch       string    `json:"headBranch"`
	HeadSha          string    `json:"headSha"`
	DisplayTitle     string    `json:"displayTitle"`
	Duration         time.Duration
	TokenUsage       int
	EstimatedCost    float64
	Turns            int
	ErrorCount       int
	WarningCount     int
	MissingToolCount int
	NoopCount        int
	LogsPath         string
}

type WorkflowRunInfo struct {
	URL        string
	DatabaseID int64
	Status     string
	Conclusion string
	CreatedAt  time.Time
}

type WorkflowSourceInfo struct {
	PackagePath string
	SourcePath  string
	CommitSHA   string // The actual commit SHA used when the package was installed
}

type WorkflowSpec struct {
	RepoSpec            // embedded RepoSpec for Repo and Version fields
	WorkflowPath string // e.g., "workflows/workflow-name.md"
	WorkflowName string // e.g., "workflow-name"
	IsWildcard   bool   // true if this is a wildcard spec (e.g., "owner/repo/*")
}

type WorkflowStatus struct {
	Workflow      string   `json:"workflow" console:"header:Workflow"`
	EngineID      string   `json:"engine_id" console:"header:Engine"`
	Compiled      string   `json:"compiled" console:"header:Compiled"`
	Status        string   `json:"status" console:"header:Status"`
	TimeRemaining string   `json:"time_remaining" console:"header:Time Remaining"`
	Labels        []string `json:"labels,omitempty" console:"header:Labels,omitempty"`
	On            any      `json:"on,omitempty" console:"-"`
	RunStatus     string   `json:"run_status,omitempty" console:"header:Run Status,omitempty"`
	RunConclusion string   `json:"run_conclusion,omitempty" console:"header:Run Conclusion,omitempty"`
}

type WorkflowStep struct {
	Name string         `yaml:"name,omitempty"`
	Uses string         `yaml:"uses,omitempty"`
	Run  string         `yaml:"run,omitempty"`
	With map[string]any `yaml:"with,omitempty"`
	Env  map[string]any `yaml:"env,omitempty"`
}

type WorkflowTrialResult struct {
	WorkflowName string         `json:"workflow_name"`
	RunID        string         `json:"run_id"`
	SafeOutputs  map[string]any `json:"safe_outputs"`
	//AgentStdioLogs      []string               `json:"agent_stdio_logs,omitempty"`
	AgenticRunInfo      map[string]any `json:"agentic_run_info,omitempty"`
	AdditionalArtifacts map[string]any `json:"additional_artifacts,omitempty"`
	Timestamp           time.Time      `json:"timestamp"`
}