workflow

type AddIssueCommentConfig struct {
}

type AddIssueLabelsConfig struct {
	Allowed  []string `yaml:"allowed,omitempty"`   // Optional list of allowed labels. If omitted, any labels are allowed (including creating new ones).
	MaxCount *int     `yaml:"max-count,omitempty"` // Optional maximum number of labels to add (default: 3)
}

type AgenticEngine interface {
	// GetID returns the unique identifier for this engine
	GetID() string

	// GetDisplayName returns the human-readable name for this engine
	GetDisplayName() string

	// GetDescription returns a description of this engine's capabilities
	GetDescription() string

	// IsExperimental returns true if this engine is experimental
	IsExperimental() bool

	// SupportsToolsWhitelist returns true if this engine supports MCP tool allow-listing
	SupportsToolsWhitelist() bool

	// SupportsHTTPTransport returns true if this engine supports HTTP transport for MCP servers
	SupportsHTTPTransport() bool

	// SupportsMaxTurns returns true if this engine supports the max-turns feature
	SupportsMaxTurns() bool

	// GetDeclaredOutputFiles returns a list of output files that this engine may produce
	// These files will be automatically uploaded as artifacts if they exist
	GetDeclaredOutputFiles() []string

	// GetInstallationSteps returns the GitHub Actions steps needed to install this engine
	GetInstallationSteps(engineConfig *EngineConfig) []GitHubActionStep

	// GetExecutionConfig returns the configuration for executing this engine
	GetExecutionConfig(workflowName string, logFile string, engineConfig *EngineConfig, hasOutput bool) ExecutionConfig

	// RenderMCPConfig renders the MCP configuration for this engine to the given YAML builder
	RenderMCPConfig(yaml *strings.Builder, tools map[string]any, mcpTools []string)

	// ParseLogMetrics extracts metrics from engine-specific log content
	ParseLogMetrics(logContent string, verbose bool) LogMetrics

	// GetLogParserScript returns the name of the JavaScript script to parse logs for this engine
	GetLogParserScript() string
}

type AndNode struct {
	Left, Right ConditionNode
}

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

type BooleanLiteralNode struct {
	Value bool
}

type ClaudeEngine struct {
	BaseEngine
}

type ClaudeSettings struct {
	Hooks *HookConfiguration `json:"hooks,omitempty"`
}

type ClaudeSettingsGenerator struct{}

type CodexEngine struct {
	BaseEngine
}

type ComparisonNode struct {
	Left     ConditionNode
	Operator string
	Right    ConditionNode
}

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

type ConditionNode interface {
	Render() string
}

type ContainsNode struct {
	Array ConditionNode
	Value ConditionNode
}

type CreateIssueConfig struct {
	TitlePrefix string   `yaml:"title-prefix,omitempty"`
	Labels      []string `yaml:"labels,omitempty"`
}

type CreatePullRequestConfig struct {
	TitlePrefix string   `yaml:"title-prefix,omitempty"`
	Labels      []string `yaml:"labels,omitempty"`
	Draft       *bool    `yaml:"draft,omitempty"` // Pointer to distinguish between unset (nil) and explicitly false
}

type DisjunctionNode struct {
	Terms     []ConditionNode
	Multiline bool // If true, render each term on separate line with comments
}

type EngineConfig struct {
	ID          string
	Version     string
	Model       string
	MaxTurns    string
	Permissions *EnginePermissions `yaml:"permissions,omitempty"`
}

type EnginePermissions struct {
	Network *NetworkPermissions `yaml:"network,omitempty"`
}

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

type ExecutionConfig struct {
	// StepName is the name of the GitHub Actions step
	StepName string

	// Command is the shell command to execute (for CLI-based engines)
	Command string

	// Action is the GitHub Action to use (for action-based engines)
	Action string

	// Inputs are the inputs to pass to the action
	Inputs map[string]string

	// Environment variables needed for execution
	Environment map[string]string
}

type ExpressionNode struct {
	Expression  string
	Description string // Optional comment/description for the expression
}

type FileTracker interface {
	TrackCreated(filePath string)
}

type FunctionCallNode struct {
	FunctionName string
	Arguments    []ConditionNode
}

type GitHubActionStep []string

type HookConfiguration struct {
	PreToolUse []PreToolUseHook `json:"PreToolUse,omitempty"`
}

type HookEntry struct {
	Type    string `json:"type"`
	Command string `json:"command"`
}

type Job struct {
	Name           string
	RunsOn         string
	If             string
	Permissions    string
	TimeoutMinutes int
	Steps          []string
	Depends        []string // Job dependencies (needs clause)
	Outputs        map[string]string
}

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

type LogMetrics struct {
	TokenUsage    int
	EstimatedCost float64
	ErrorCount    int
	WarningCount  int
}

type MCPConfigRenderer struct {
	// IndentLevel controls the indentation level for properties (e.g., "                " for JSON, "          " for TOML)
	IndentLevel string
	// Format specifies the output format ("json" for JSON-like, "toml" for TOML-like)
	Format string
}

type NetworkHookGenerator struct{}

type NetworkPermissions struct {
	Allowed []string `yaml:"allowed,omitempty"`
}

type NotNode struct {
	Child ConditionNode
}

type NumberLiteralNode struct {
	Value string
}

type OrNode struct {
	Left, Right ConditionNode
}

type PreToolUseHook struct {
	Matcher string      `json:"matcher"`
	Hooks   []HookEntry `json:"hooks"`
}

type PropertyAccessNode struct {
	PropertyPath string
}

type SafeOutputsConfig struct {
	CreateIssue       *CreateIssueConfig       `yaml:"create-issue,omitempty"`
	AddIssueComment   *AddIssueCommentConfig   `yaml:"add-issue-comment,omitempty"`
	CreatePullRequest *CreatePullRequestConfig `yaml:"create-pull-request,omitempty"`
	AddIssueLabels    *AddIssueLabelsConfig    `yaml:"add-issue-labels,omitempty"`
	AllowedDomains    []string                 `yaml:"allowed-domains,omitempty"`
}

type StringLiteralNode struct {
	Value string
}

type TernaryNode struct {
	Condition  ConditionNode
	TrueValue  ConditionNode
	FalseValue ConditionNode
}

type TimeDelta struct {
	Hours   int
	Days    int
	Minutes int
	Weeks   int
	Months  int
}

type WorkflowData struct {
	Name             string
	On               string
	Permissions      string
	Concurrency      string
	RunName          string
	Env              string
	If               string
	TimeoutMinutes   string
	CustomSteps      string
	PostSteps        string // steps to run after AI execution
	RunsOn           string
	Tools            map[string]any
	MarkdownContent  string
	AllowedTools     string
	AI               string        // "claude" or "codex" (for backwards compatibility)
	EngineConfig     *EngineConfig // Extended engine configuration
	StopTime         string
	Alias            string             // for @alias trigger support
	AliasOtherEvents map[string]any     // for merging alias with other events
	AIReaction       string             // AI reaction type like "eyes", "heart", etc.
	Jobs             map[string]any     // custom job configurations with dependencies
	Cache            string             // cache configuration
	NeedsTextOutput  bool               // whether the workflow uses ${{ needs.task.outputs.text }}
	SafeOutputs      *SafeOutputsConfig // output configuration for automatic output routes
}