spec

type ArgDef struct {
	// Type is the argument's declared type. Supplied values are coerced to this
	// type via CoerceType. When omitted, the value passes through unchanged.
	// Supported types: string, int, float (alias: number), bool, array, object,
	// time, duration, and any.
	Type Type `` /* 151-byte string literal not displayed */

	// Required marks the argument as mandatory at every call site.
	// A required argument cannot declare a Default.
	Required bool `json:"required,omitempty" yaml:"required,omitempty" doc:"Whether the argument must be supplied at every call site"`

	// Default is applied when the argument is omitted at a call site.
	// Only valid when Required is false.
	Default any `` /* 142-byte string literal not displayed */

	// Description documents the argument for readers and tooling.
	Description string `json:"description,omitempty" yaml:"description,omitempty" doc:"Human-readable description of the argument" maxLength:"500"`
}

type Call struct {
	// Description documents the call definition for readers and tooling.
	Description string `` /* 129-byte string literal not displayed */

	// Args declares the named, typed arguments the definition accepts, keyed by
	// argument name.
	Args map[string]*ArgDef `json:"args,omitempty" yaml:"args,omitempty" doc:"Named, typed argument declarations keyed by argument name"`

	// Provider is the provider name executed when the call is invoked.
	Provider string `` /* 229-byte string literal not displayed */

	// Inputs are the provider inputs. They reference arguments via the args
	// namespace and are resolved after arguments are bound.
	Inputs map[string]*ValueRef `json:"inputs,omitempty" yaml:"inputs,omitempty" doc:"Provider inputs; reference arguments via the args namespace"`

	// Dedup enables opt-in, in-memory de-duplication of identical invocations
	// within a single run. Results are keyed by the bound argument values and
	// are never persisted to state or shared across runs.
	Dedup bool `` /* 146-byte string literal not displayed */
}

type CallRef struct {
	// Call is the name of a spec.calls definition to invoke.
	Call string `` /* 208-byte string literal not displayed */

	// Args supplies argument values for the call, keyed by argument name.
	// Values are standard ValueRefs (literals, rslvr, expr, or tmpl) and are
	// resolved in the host step's context.
	Args map[string]*ValueRef `` /* 135-byte string literal not displayed */
}

type Condition struct {
	Expr *celexp.Expression `json:"expr" yaml:"expr" doc:"CEL expression that must evaluate to boolean" example:"_.environment == 'prod'"`
}

type ForEachClause struct {
	// Item is the variable name alias for the current element.
	// Creates both __item (always) and this custom name.
	// Optional - if not specified, only __item is available.
	Item string `` /* 210-byte string literal not displayed */

	// Index is the variable name alias for the current 0-based index.
	// Creates both __index (always) and this custom name.
	// Optional - if not specified, only __index is available.
	Index string `` /* 199-byte string literal not displayed */

	// In specifies the array to iterate over.
	// Optional - defaults to __self (current transform value) for resolvers.
	In *ValueRef `json:"in,omitempty" yaml:"in,omitempty" doc:"Array to iterate over (default: __self for resolvers)"`

	// Concurrency limits parallel execution.
	// 0 (default) means unlimited parallelism.
	Concurrency int `` /* 129-byte string literal not displayed */

	// ContinueOnError controls whether a failed iteration allows execution to
	// continue. It accepts a boolean or a CEL expression evaluated per iteration
	// with the structured error bound as __error and the iteration variables
	// (__item/__index plus any configured aliases) in scope. Truthy continues
	// with the remaining iterations; falsy aborts. Overrides the deprecated
	// OnError field. This field is only used by actions; resolvers ignore it.
	ContinueOnError *Condition `` /* 284-byte string literal not displayed */

	// OnError defines behavior when an iteration fails.
	// This field is only used by actions; resolvers ignore it.
	//
	// Deprecated: use ContinueOnError instead.
	OnError OnErrorBehavior `` /* 223-byte string literal not displayed */

	// KeepSkipped controls whether items skipped by a when condition are
	// retained as nil entries in the output array.
	// By default (false), skipped items are removed so the output contains
	// only the items that were actually processed. Set to true when you need
	// the output array to remain index-aligned with the input array.
	KeepSkipped bool `` /* 135-byte string literal not displayed */
}

type IterationContext struct {
	Item       any    `json:"-" yaml:"-" doc:"Current array element (__item)"`
	Index      int    `json:"-" yaml:"-" doc:"Current index (__index)"`
	ItemAlias  string `json:"-" yaml:"-" doc:"Custom name for item (if specified)"`
	IndexAlias string `json:"-" yaml:"-" doc:"Custom name for index (if specified)"`
}

type OnErrorBehavior string

type Type string

type Usage struct {
	// Synopsis is a one-line description of how to consume the solution.
	// When set it takes precedence over the metadata description in the usage view.
	Synopsis string `` /* 186-byte string literal not displayed */

	// Details is free-form, multi-paragraph prose describing how the solution
	// works and when to use it -- the long-form counterpart to the one-line
	// description/synopsis (analogous to a command's long help or a README body).
	Details string `` /* 140-byte string literal not displayed */

	// Examples are curated command examples shown in the usage view.
	Examples []UsageExample `json:"examples,omitempty" yaml:"examples,omitempty" doc:"Curated usage examples" maxItems:"50"`
}

type UsageExample struct {
	// Description explains what the example does.
	Description string `` /* 141-byte string literal not displayed */

	// Command is the CLI invocation to run.
	Command string `` /* 134-byte string literal not displayed */
}

type ValueRef struct {
	Literal  any                         `json:"-" yaml:"-"`
	Resolver *string                     `` /* 198-byte string literal not displayed */
	Expr     *celexp.Expression          `json:"expr,omitempty" yaml:"expr,omitempty" doc:"CEL expression to evaluate"`
	Tmpl     *gotmpl.GoTemplatingContent `json:"tmpl,omitempty" yaml:"tmpl,omitempty" doc:"Go template to execute"`
}