automate

type AllowedPathSummary struct {
	Path   string `json:"path"`
	Mode   string `json:"mode"`
	Reason string `json:"reason,omitempty"`
}

type AutomateSessionInfo struct {
	Workflow       string    `json:"workflow"`
	PID            int       `json:"pid"`
	StartedAt      time.Time `json:"started_at"`
	OutputFilePath string    `json:"output_file_path,omitempty"`
	BudgetUSD      *float64  `json:"budget_usd,omitempty"`
	Kind           string    `json:"kind"` // always "automate"
}

type BudgetSummary struct {
	USD    float64   `json:"usd"`
	WarnAt []float64 `json:"warn_at,omitempty"`
}

type Entry struct {
	Filename    string `json:"name"`
	FilePath    string
	Description string `json:"description,omitempty"`
}

type InitialSummary struct {
	Persona           string                    `json:"persona,omitempty"`
	Provider          string                    `json:"provider,omitempty"`
	Model             string                    `json:"model,omitempty"`
	MaxIterations     int                       `json:"max_iterations"`
	RiskProfile       string                    `json:"risk_profile,omitempty"`
	HasPrompt         bool                      `json:"has_prompt"`
	SubagentOverrides []SubagentOverrideSummary `json:"subagent_overrides,omitempty"`
	AllowedPaths      []AllowedPathSummary      `json:"allowed_paths,omitempty"`
}

type StepSummary struct {
	Name           string               `json:"name,omitempty"`
	Kind           string               `json:"kind"`
	Persona        string               `json:"persona,omitempty"`
	Provider       string               `json:"provider,omitempty"`
	Model          string               `json:"model,omitempty"`
	When           string               `json:"when,omitempty"`
	CommandPreview string               `json:"command_preview,omitempty"`
	AllowedPaths   []AllowedPathSummary `json:"allowed_paths,omitempty"`
}

type SubagentOverrideSummary struct {
	Persona  string `json:"persona"`
	Provider string `json:"provider,omitempty"`
	Model    string `json:"model,omitempty"`
}

type Summary struct {
	Description     string          `json:"description,omitempty"`
	ContinueOnError bool            `json:"continue_on_error,omitempty"`
	NoWebUI         bool            `json:"no_web_ui,omitempty"`
	Initial         *InitialSummary `json:"initial,omitempty"`
	Steps           []StepSummary   `json:"steps,omitempty"`
	Budget          *BudgetSummary  `json:"budget,omitempty"`
	// RequiresApproval reports whether the run_automate tool path should
	// prompt the user before launching this workflow. nil means the field
	// was unset in JSON (defaults to true). Explicit false marks the
	// workflow as agent-runnable without user confirmation. Serialized
	// as `null` when nil — the field is intentionally NOT omitempty so
	// the WebUI can distinguish "unset (defaults to required)" from
	// "absent (treated as not_required)".
	RequiresApproval *bool `json:"requires_approval"`
	// SubagentTimeoutSeconds overrides the per-run_subagent tool timeout
	// (default 1800 = 30 minutes). nil means use the default. Same nil-
	// semantics as RequiresApproval — serialized as `null` when unset.
	SubagentTimeoutSeconds *int `json:"subagent_timeout_seconds"`
	// AllowedPaths is the display-only view of the workflow's
	// declared allowed_paths entries. Populated by Summarize after
	// the same Validate() that the loader runs, so a malformed entry
	// surfaces as a parse error rather than silently dropping the
	// whole field. Entries are sorted by path for stable display.
	AllowedPaths []AllowedPathSummary `json:"allowed_paths,omitempty"`
	// Warnings collects advisory messages produced while building the
	// summary — currently the system-prefix warning when an
	// allowed_path falls under /etc, /usr, /var, etc. The CLI and
	// WebUI render these alongside the allowed_paths block so the
	// user sees the "this workflow touches platform infrastructure"
	// heads-up even when the path itself is well-formed.
	Warnings []string `json:"warnings,omitempty"`
}