inputs

Language reference / inputs

Meaning and placement

document

Typed workflow inputs · ${{ inputs.X }} · the parameters an author declares and a caller supplies. Each entry is a typed declaration whose type: speaks the full TypeExpr of 09-types (R3b · LAW-GRAMMAR-0211 · the flat 6-enum is dead · LAW-SURFACE-0211). The typed half of the dead vars: block (R3a · LAW-SURFACE-0201) · a required: true value lands here per the E-split total rule.

Property	Declaration
Requirement	Optional in this object
Schema location	`/properties/inputs`
type	”object”
additionalProperties	{“type”: “object”, “additionalProperties”: false, “required”: [“type”], “properties”: {“type”: {“ $ref": "#/$ defs/typeExpr”}, “required”: {“type”: “boolean”, “description”: “The caller MUST supply a value (no default is consulted).”}, “default”: {“description”: “The value used when the caller supplies none · MUST conform to `type:` (R3b · LAW-TYPE-0211 · NIKA-DEFAULT-001 · the P0 soundness hole is closed at check).”}, “description”: {“description”: “Free-form prose about this input · what a caller is being asked for. Documentation only — the contract is `type` and `required`.”, “type”: “string”}}}

In the same object: const · model · nika · outputs · permits · run · secrets · tasks Schema source (use the pointer above)

In a source template

Excerpt from templates/agent-loop.nika.yaml, source lines 37–46. This is a fragment, not a runnable workflow.

illustration

# stamp leaves `mock/echo`, the offline path this file guarantees.
model: mock/echo

inputs:
  goal:
    type: string
    required: true
    # A `required:` input still carries a `default:` here so the skeleton
    # RUNS the moment it is scaffolded. Replace the default with your job;
    # `--var goal=…` overrides it at any time.

Templates containing this field

Template	Source
`templates/agent-loop.nika.yaml`	Line 40

These are literal key occurrences in the source files, not an execution or conformance claim. How to instantiate a template.

Contract and implementation

This page projects the named specification revision. Check released engine status and the validation workflow before running a file. An optional field is not evidence that every engine supports every value. Canonical identity: language:word:inputs. Spec revision: c5ebbb7b862b. How documentation stays connected.

YAML

Language fields

CLI & errors

Data catalogs

Workspace

Documentation system

Tool contracts

Meaning and placement

document

In a source template

Templates containing this field

Contract and implementation

​Meaning and placement

​document

​In a source template

​Templates containing this field

​Contract and implementation

Meaning and placement

document

In a source template

Templates containing this field

Contract and implementation