workflow

Oct 7, 2026

Changes in this version

+ const DefaultContinuationIdlePrompt — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultContinuationPrompt — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultContinuationTodoFile — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultMaxContinuations — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultMaxIdleTurns — darwin/amd64, linux/amd64, windows/amd64

+ func ReadTodoStatus(todoFile string) todoStatus — darwin/amd64, linux/amd64, windows/amd64

type AgentWorkflowConfig — darwin/amd64, linux/amd64, windows/amd64

+ Continuation *AgentWorkflowContinuation

+ type AgentWorkflowContinuation struct — darwin/amd64, linux/amd64, windows/amd64

+ ContinueUntilDone *bool

+ MaxContinuations int

+ MaxIdleTurns int

+ Prompt string

+ TodoFile string

+ func (c *AgentWorkflowContinuation) IsEnabled() bool

+ type ContinuationResult struct — darwin/amd64, linux/amd64, windows/amd64

+ Continuations int

+ Err error

+ RunnableItems int

+ StopReason ContinuationStopReason

+ func RunInitialContinuation(ctx context.Context, chatAgent *agent.Agent, eventBus *events.EventBus, ...) (ContinuationResult, error)

+ type ContinuationStopReason string — darwin/amd64, linux/amd64, windows/amd64

+ const ContinuationStopBudgetExceeded

+ const ContinuationStopContextCancelled

+ const ContinuationStopMaxContinuations

+ const ContinuationStopNoProgress

+ const ContinuationStopNoRunnableItems

+ const ContinuationStopTurnError

Jul 23, 2026

Changes in this version

+ const PathModeReadOnly — darwin/amd64, linux/amd64, windows/amd64

+ const PathModeReadWrite — darwin/amd64, linux/amd64, windows/amd64

+ func ApplyWorkflowRuntimeAllowedPaths(chatAgent *agent.Agent, paths []AllowedPath) (snapshotPaths []string, snapshotModes map[string]string, addedPaths []string, ...) — darwin/amd64, linux/amd64, windows/amd64

+ func IsSystemPathPrefix(p string) bool — darwin/amd64, linux/amd64, windows/amd64

+ func RestoreWorkflowRuntimeAllowedPaths(chatAgent *agent.Agent, snapshotPaths []string, ...) error — darwin/amd64, linux/amd64, windows/amd64

type AgentWorkflowConfig — darwin/amd64, linux/amd64, windows/amd64

+ AllowedPaths []AllowedPath

type AgentWorkflowInitial — darwin/amd64, linux/amd64, windows/amd64

+ AllowedPaths []AllowedPath

type AgentWorkflowStep — darwin/amd64, linux/amd64, windows/amd64

+ AllowedPaths []AllowedPath

+ type AllowedPath struct — darwin/amd64, linux/amd64, windows/amd64

+ Mode string

+ Path string

+ Reason string

+ func (a *AllowedPath) Validate() error

Jul 15, 2026

Changes in this version

+ const DefaultWorkflowConversationSessionID — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultWorkflowOrchestrationEventsFile — darwin/amd64, linux/amd64, windows/amd64

+ const DefaultWorkflowOrchestrationStateFile — darwin/amd64, linux/amd64, windows/amd64

+ const WorkflowWhenAlways — darwin/amd64, linux/amd64, windows/amd64

+ const WorkflowWhenOnError — darwin/amd64, linux/amd64, windows/amd64

+ const WorkflowWhenOnSuccess — darwin/amd64, linux/amd64, windows/amd64

+ func ApplyWorkflowCommandOverrides(cfg *AgentWorkflowConfig, overrides *CLIOverrides) — darwin/amd64, linux/amd64, windows/amd64

+ func ApplyWorkflowInitialOverrides(chatAgent *agent.Agent, cfg *AgentWorkflowConfig, overrides *CLIOverrides) error — darwin/amd64, linux/amd64, windows/amd64

+ func ApplyWorkflowRuntimeOverrides(chatAgent *agent.Agent, runtime AgentWorkflowRuntime, overrides *CLIOverrides) error — darwin/amd64, linux/amd64, windows/amd64

+ func ApplyWorkflowSubagentOverrides(subagentTypes map[string]configuration.SubagentType, ...) — darwin/amd64, linux/amd64, windows/amd64

+ func AttachWorkflowBudget(chatAgent *agent.Agent, cfg *AgentWorkflowConfig) (stop func()) — darwin/amd64, linux/amd64, windows/amd64

+ func EmitWorkflowOrchestrationEvent(cfg *AgentWorkflowConfig, eventType string, payload map[string]interface{}) error — darwin/amd64, linux/amd64, windows/amd64

+ func FindSubagentTypeMapKey(subagentTypes map[string]configuration.SubagentType, normalizedID string) (string, bool) — darwin/amd64, linux/amd64, windows/amd64

+ func IsValidWorkflowWhen(v string) bool — darwin/amd64, linux/amd64, windows/amd64

+ func LoadLoopCheckpoint(workDir string) (int, error) — darwin/amd64, linux/amd64, windows/amd64

+ func LoopCheckpointFilePath(workDir string) string — darwin/amd64, linux/amd64, windows/amd64

+ func NormalizeReasoningEffort(v string) string — darwin/amd64, linux/amd64, windows/amd64

+ func NormalizeWorkflowPaths(paths []string) []string — darwin/amd64, linux/amd64, windows/amd64

+ func NormalizeWorkflowPersonaID(raw string) string — darwin/amd64, linux/amd64, windows/amd64

+ func NormalizeWorkflowWhen(v string) string — darwin/amd64, linux/amd64, windows/amd64

+ func ParseBudgetWarnList(s string) ([]float64, error) — darwin/amd64, linux/amd64, windows/amd64

+ func PersistLoopCheckpoint(workDir string, lineNum int) error — darwin/amd64, linux/amd64, windows/amd64

+ func PersistWorkflowCheckpoint(cfg *AgentWorkflowConfig, state *WorkflowExecutionState, ...) error — darwin/amd64, linux/amd64, windows/amd64

+ func PersistWorkflowConversationState(chatAgent *agent.Agent, cfg *AgentWorkflowConfig) error — darwin/amd64, linux/amd64, windows/amd64

+ func PersistWorkflowExecutionState(cfg *AgentWorkflowConfig, state *WorkflowExecutionState) error — darwin/amd64, linux/amd64, windows/amd64

+ func PrepareWorkflowRuntimeRestorer(chatAgent *agent.Agent, cfg *AgentWorkflowConfig, overrides *CLIOverrides) (func() error, error) — darwin/amd64, linux/amd64, windows/amd64

+ func RemoveLoopCheckpoint(workDir string) — darwin/amd64, linux/amd64, windows/amd64

+ func ResolveStepPrompt(step AgentWorkflowStep) (string, error) — darwin/amd64, linux/amd64, windows/amd64

+ func ResolveWorkflowInitialPrompt(cliQuery string, cfg *AgentWorkflowConfig) (string, error) — darwin/amd64, linux/amd64, windows/amd64

+ func ResolveWorkflowTextOrFile(text, filePath, label string) (string, error) — darwin/amd64, linux/amd64, windows/amd64

+ func RestoreWorkflowConversationState(chatAgent *agent.Agent, cfg *AgentWorkflowConfig, ...) error — darwin/amd64, linux/amd64, windows/amd64

+ func RunAgentWorkflow(ctx context.Context, chatAgent *agent.Agent, eventBus *events.EventBus, ...) (bool, error) — darwin/amd64, linux/amd64, windows/amd64

+ func RunAgentWorkflowLoop(ctx context.Context, chatAgent *agent.Agent, eventBus *events.EventBus, ...) (bool, error) — darwin/amd64, linux/amd64, windows/amd64

+ func ShouldRestoreWorkflowConversationState(state *WorkflowExecutionState) bool — darwin/amd64, linux/amd64, windows/amd64

+ func ShouldRunWorkflowStep(when string, hasError bool) bool — darwin/amd64, linux/amd64, windows/amd64

+ func ShouldYieldBeforeWorkflowStep(cfg *AgentWorkflowConfig, state *WorkflowExecutionState, ...) bool — darwin/amd64, linux/amd64, windows/amd64

+ func StepFileTriggersSatisfied(step AgentWorkflowStep) (bool, error) — darwin/amd64, linux/amd64, windows/amd64

+ func WorkflowEffectiveStepProvider(chatAgent *agent.Agent, step AgentWorkflowStep) string — darwin/amd64, linux/amd64, windows/amd64

+ func WriteFileAtomic(path string, data []byte, perm os.FileMode) error — darwin/amd64, linux/amd64, windows/amd64

+ type AgentWorkflowBudgetConfig struct — darwin/amd64, linux/amd64, windows/amd64

+ OnExceed string

+ USD float64

+ WarnAt []float64

+ type AgentWorkflowConfig struct — darwin/amd64, linux/amd64, windows/amd64

+ Budget *AgentWorkflowBudgetConfig

+ ContinueOnError bool

+ Daemon *bool

+ Description string

+ Initial *AgentWorkflowInitial

+ Loop *AgentWorkflowLoopConfig

+ NoWebUI *bool

+ Orchestration *AgentWorkflowOrchestrationConfig

+ PersistRuntimeOverrides *bool

+ Progress *AgentWorkflowProgressConfig

+ RequiresApproval *bool

+ Steps []AgentWorkflowStep

+ SubagentTimeoutSeconds *int

+ WebPort *int

+ func LoadAgentWorkflowConfig(path string) (*AgentWorkflowConfig, error)

+ func (c *AgentWorkflowConfig) IsApprovalRequired() bool

+ func (c *AgentWorkflowConfig) OrchestrationEnabled() bool

+ func (c *AgentWorkflowConfig) OrchestrationResumeEnabled() bool

+ func (c *AgentWorkflowConfig) OrchestrationYieldOnProviderHandoff() bool

+ func (c *AgentWorkflowConfig) ShouldPersistRuntimeOverrides() bool

+ func (c *AgentWorkflowConfig) Validate() error

+ type AgentWorkflowInitial struct — darwin/amd64, linux/amd64, windows/amd64

+ Prompt string

+ PromptFile string

+ type AgentWorkflowLoopConfig struct — darwin/amd64, linux/amd64, windows/amd64

+ BuildCommand string

+ GatePromptFile string

+ MaxIterations int

+ MaxRetries int

+ TodoFile string

+ type AgentWorkflowOrchestrationConfig struct — darwin/amd64, linux/amd64, windows/amd64

+ ConversationSessionID string

+ Enabled bool

+ EventsFile string

+ Resume *bool

+ StateFile string

+ YieldOnProviderHandoff *bool

+ type AgentWorkflowProgressConfig struct — darwin/amd64, linux/amd64, windows/amd64

+ HeartbeatSeconds int

+ type AgentWorkflowRuntime struct — darwin/amd64, linux/amd64, windows/amd64

+ DryRun *bool

+ MaxIterations *int

+ Model string

+ NoStream *bool

+ NoSubagents *bool

+ Persona string

+ Provider string

+ ReasoningEffort string

+ ResourceDirectory string

+ RiskProfile string

+ SkipPrompt *bool

+ SubagentOverrides WorkflowSubagentOverrides

+ SystemPrompt string

+ SystemPromptFile string

+ Unsafe *bool

+ func (r *AgentWorkflowRuntime) Validate(prefix string) error

+ type AgentWorkflowStep struct — darwin/amd64, linux/amd64, windows/amd64

+ Command string

+ CommandFile string

+ FileExists []string

+ FileNotExists []string

+ Name string

+ Prompt string

+ PromptFile string

+ When string

+ func (s AgentWorkflowStep) IsShellStep() bool

+ type CLIOverrides struct — darwin/amd64, linux/amd64, windows/amd64

+ BudgetUSD float64

+ BudgetWarn string

+ GetNoStream func() bool

+ HeartbeatSeconds int

+ SetDaemon func(enabled bool)

+ SetNoStream func(enabled bool)

+ SetWebPort func(port int)

+ SetWebUI func(disabled bool)

+ type QueryExecutor func(ctx context.Context, chatAgent *agent.Agent, eventBus *events.EventBus, ...) error — darwin/amd64, linux/amd64, windows/amd64

+ type WorkflowExecutionState struct — darwin/amd64, linux/amd64, windows/amd64

+ Complete bool

+ CurrentTodoLineNum int

+ FirstError string

+ HasError bool

+ InitialCompleted bool

+ LastProvider string

+ NextStepIndex int

+ UpdatedAt string

+ Version int

+ func LoadWorkflowExecutionState(cfg *AgentWorkflowConfig) (*WorkflowExecutionState, error)

+ func NewWorkflowExecutionState() *WorkflowExecutionState

+ type WorkflowSubagentOverride struct — darwin/amd64, linux/amd64, windows/amd64

+ Model string

+ Provider string

+ type WorkflowSubagentOverrides map[string]WorkflowSubagentOverride — darwin/amd64, linux/amd64, windows/amd64