workflow

type AddIssueCommentConfig struct {
}

type AddIssueCommentsConfig struct {
	Max    int    `yaml:"max,omitempty"`    // Maximum number of comments to create
	Target string `yaml:"target,omitempty"` // Target for comments: "triggering" (default), "*" (any issue), or explicit issue number
}

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,omitempty"`     // Optional maximum number of labels to add (default: 3)
}

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 CodingAgentEngine 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(workflowData *WorkflowData) []GitHubActionStep

	// GetExecutionSteps returns the GitHub Actions steps for executing this engine
	GetExecutionSteps(workflowData *WorkflowData, logFile string) []GitHubActionStep

	// 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 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 CreateDiscussionsConfig struct {
	TitlePrefix string `yaml:"title-prefix,omitempty"`
	CategoryId  string `yaml:"category-id,omitempty"` // Discussion category ID
	Max         int    `yaml:"max,omitempty"`         // Maximum number of discussions to create
}

type CreateIssuesConfig struct {
	TitlePrefix string   `yaml:"title-prefix,omitempty"`
	Labels      []string `yaml:"labels,omitempty"`
	Max         int      `yaml:"max,omitempty"` // Maximum number of issues to create
}

type CreatePullRequestReviewCommentsConfig struct {
	Max  int    `yaml:"max,omitempty"`  // Maximum number of review comments to create (default: 1)
	Side string `yaml:"side,omitempty"` // Side of the diff: "LEFT" or "RIGHT" (default: "RIGHT")
}

type CreatePullRequestsConfig 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
	Max         int      `yaml:"max,omitempty"`           // Maximum number of pull requests to create
	IfNoChanges string   `yaml:"if-no-changes,omitempty"` // Behavior when no changes to push: "warn" (default), "error", or "ignore"
}

type CreateSecurityReportsConfig struct {
	Max    int    `yaml:"max,omitempty"`    // Maximum number of security findings to include (default: unlimited)
	Driver string `yaml:"driver,omitempty"` // Driver name for SARIF tool.driver.name field (default: "GitHub Agentic Workflows Security Scanner")
}

type CustomEngine struct {
	BaseEngine
}

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
	Env      map[string]string
	Steps    []map[string]any
}

type EngineNetworkConfig struct {
	Engine  *EngineConfig
	Network *NetworkPermissions
}

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

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

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

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
	Needs          []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
	Turns         int            // Number of turns needed to complete the task
	ToolCalls     []ToolCallInfo // Tool call statistics

}

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 MissingToolConfig struct {
	Max int `yaml:"max,omitempty"` // Maximum number of missing tool reports (default: unlimited)
}

type NetworkHookGenerator struct{}

type NetworkPermissions struct {
	Mode    string   `yaml:"mode,omitempty"`    // "defaults" for default access
	Allowed []string `yaml:"allowed,omitempty"` // List of allowed domains
}

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 PushToBranchConfig struct {
	Branch      string `yaml:"branch"`                  // The branch to push changes to (defaults to "triggering")
	Target      string `yaml:"target,omitempty"`        // Target for push-to-branch: like add-issue-comment but for pull requests
	IfNoChanges string `yaml:"if-no-changes,omitempty"` // Behavior when no changes to push: "warn", "error", or "ignore" (default: "warn")
}

type SafeOutputsConfig struct {
	CreateIssues                    *CreateIssuesConfig                    `yaml:"create-issue,omitempty"`
	CreateDiscussions               *CreateDiscussionsConfig               `yaml:"create-discussion,omitempty"`
	AddIssueComments                *AddIssueCommentsConfig                `yaml:"add-issue-comment,omitempty"`
	CreatePullRequests              *CreatePullRequestsConfig              `yaml:"create-pull-request,omitempty"`
	CreatePullRequestReviewComments *CreatePullRequestReviewCommentsConfig `yaml:"create-pull-request-review-comment,omitempty"`
	CreateSecurityReports           *CreateSecurityReportsConfig           `yaml:"create-security-report,omitempty"`
	AddIssueLabels                  *AddIssueLabelsConfig                  `yaml:"add-issue-label,omitempty"`
	UpdateIssues                    *UpdateIssuesConfig                    `yaml:"update-issue,omitempty"`
	PushToBranch                    *PushToBranchConfig                    `yaml:"push-to-branch,omitempty"`
	MissingTool                     *MissingToolConfig                     `yaml:"missing-tool,omitempty"` // Optional for reporting missing functionality
	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 ToolCallInfo struct {
	Name          string // Prettified tool name (e.g., "github::search_issues", "bash")
	CallCount     int    // Number of times this tool was called
	MaxOutputSize int    // Maximum output size in tokens for any call
}

type UpdateIssuesConfig struct {
	Status *bool  `yaml:"status,omitempty"` // Allow updating issue status (open/closed) - presence indicates field can be updated
	Target string `yaml:"target,omitempty"` // Target for updates: "triggering" (default), "*" (any issue), or explicit issue number
	Title  *bool  `yaml:"title,omitempty"`  // Allow updating issue title - presence indicates field can be updated
	Body   *bool  `yaml:"body,omitempty"`   // Allow updating issue body - presence indicates field can be updated
	Max    int    `yaml:"max,omitempty"`    // Maximum number of issues to update (default: 1)
}

type WorkflowData struct {
	Name               string
	FrontmatterName    string // name field from frontmatter (for security report driver default)
	On                 string
	Permissions        string
	Network            string // top-level network permissions configuration
	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
	AI                 string        // "claude" or "codex" (for backwards compatibility)
	EngineConfig       *EngineConfig // Extended engine configuration
	StopTime           string
	Command            string              // for /command trigger support
	CommandOtherEvents map[string]any      // for merging command 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 }}
	NetworkPermissions *NetworkPermissions // parsed network permissions
	SafeOutputs        *SafeOutputsConfig  // output configuration for automatic output routes
}