execute

type ActionExecutionConfig struct {
	// DefaultTimeout is the default timeout per action execution.
	DefaultTimeout time.Duration `json:"defaultTimeout,omitempty" yaml:"defaultTimeout,omitempty" doc:"Default per-action execution timeout"`

	// GracePeriod is the cancellation grace period.
	GracePeriod time.Duration `json:"gracePeriod,omitempty" yaml:"gracePeriod,omitempty" doc:"Cancellation grace period"`

	// MaxConcurrency limits concurrent action execution (0=unlimited).
	MaxConcurrency int `json:"maxConcurrency,omitempty" yaml:"maxConcurrency,omitempty" doc:"Maximum concurrent actions" maximum:"1000"`

	// OutputDir is the target directory for action output. When set, providers
	// in action mode resolve relative paths against this directory instead of CWD.
	// An empty string means actions use CWD (backward-compatible default).
	OutputDir string `json:"outputDir,omitempty" yaml:"outputDir,omitempty" doc:"Target directory for action output" maxLength:"4096"`

	// Cwd is the original working directory to expose as __cwd in action
	// expressions. When empty, the executor captures os.Getwd() at creation time.
	// Callers that change the working directory before creating the executor
	// (e.g., bundle extraction) should set this explicitly.
	Cwd string `json:"-" yaml:"-"`
}

type ActionExecutionResult struct {
	// Result is the underlying action execution result.
	Result *action.ExecutionResult `json:"result" yaml:"result" doc:"Action execution result"`
}

type GraphRenderer interface {
	RenderASCII(w io.Writer) error
	RenderDOT(w io.Writer) error
	RenderMermaid(w io.Writer) error
}

type ResolverDiagnostic struct {
	// Resolver is the name of the resolver that failed. It may be empty when
	// the failure is not attributable to a specific resolver.
	Resolver string `json:"resolver,omitempty" yaml:"resolver,omitempty" doc:"Name of the resolver that failed"`

	// Phase is the execution phase number where the failure occurred (0 when unknown).
	Phase int `json:"phase,omitempty" yaml:"phase,omitempty" doc:"Phase number where the failure occurred"`

	// Message is the human-readable failure description.
	Message string `json:"message" yaml:"message" doc:"Human-readable failure message"`
}

type ResolverExecutionConfig struct {
	// Timeout is the default timeout per resolver.
	Timeout time.Duration `json:"timeout,omitempty" yaml:"timeout,omitempty" doc:"Default timeout per resolver"`

	// PhaseTimeout is the timeout for each execution phase.
	PhaseTimeout time.Duration `json:"phaseTimeout,omitempty" yaml:"phaseTimeout,omitempty" doc:"Timeout for each execution phase"`

	// MaxConcurrency limits concurrent resolver execution (0=unlimited).
	MaxConcurrency int `json:"maxConcurrency,omitempty" yaml:"maxConcurrency,omitempty" doc:"Maximum concurrent resolvers"`

	// WarnValueSize triggers a warning when resolver values exceed this size in bytes.
	WarnValueSize int64 `json:"warnValueSize,omitempty" yaml:"warnValueSize,omitempty" doc:"Warn when value exceeds this size"`

	// MaxValueSize rejects resolver values exceeding this size in bytes.
	MaxValueSize int64 `json:"maxValueSize,omitempty" yaml:"maxValueSize,omitempty" doc:"Reject values exceeding this size"`

	// ValidateAll validates all resolvers even if some fail.
	ValidateAll bool `json:"validateAll,omitempty" yaml:"validateAll,omitempty" doc:"Validate all resolvers even on failure"`

	// SkipValidation skips resolver validation.
	SkipValidation bool `json:"skipValidation,omitempty" yaml:"skipValidation,omitempty" doc:"Skip resolver validation"`

	// SkipTransform skips resolver transforms.
	SkipTransform bool `json:"skipTransform,omitempty" yaml:"skipTransform,omitempty" doc:"Skip resolver transforms"`

	// NonFatalValidation, when true, treats resolver validation-only failures
	// as non-fatal: the populated values are returned alongside structured
	// diagnostics (ResolverExecutionResult.Diagnostics) instead of aborting
	// with an error. Resolve- and transform-phase failures (where no value
	// could be produced) remain fatal. This is used by inspection and
	// troubleshooting paths (run resolver, preview_resolvers) so that resolver
	// output remains useful even when validation fails. It implies validate-all
	// semantics so that all reachable resolvers populate their values.
	NonFatalValidation bool `` /* 159-byte string literal not displayed */
}

type ResolverExecutionResult struct {
	// Data contains the resolved values keyed by resolver name. When
	// NonFatalValidation is enabled, this also includes partial values produced
	// by resolvers that failed validation (their value is captured post-transform
	// before the validate phase rejects it).
	Data map[string]any `json:"data" yaml:"data" doc:"Resolved values"`

	// Context is the resolver execution context with full metadata.
	Context *resolver.Context `json:"-" yaml:"-"`

	// Diagnostics holds the resolver validation or execution error collected
	// when NonFatalValidation is enabled. It is nil when execution was clean.
	// Use DiagnosticsFromError to convert it into a structured list.
	Diagnostics error `json:"-" yaml:"-"`
}

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

type SolutionValidationResult struct {
	// Valid is true when the solution passes all validation checks.
	Valid bool `json:"valid" yaml:"valid" doc:"Whether the solution is valid"`

	// HasResolvers indicates whether the solution defines resolvers.
	HasResolvers bool `json:"hasResolvers" yaml:"hasResolvers" doc:"Whether the solution has resolvers"`

	// HasWorkflow indicates whether the solution defines an action workflow.
	HasWorkflow bool `json:"hasWorkflow" yaml:"hasWorkflow" doc:"Whether the solution has a workflow"`

	// Errors contains any validation errors found.
	Errors []string `json:"errors,omitempty" yaml:"errors,omitempty" doc:"Validation errors"`
}