> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nika.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Language field reference

> Find a YAML field by name, understand its scope, and follow its contract and examples.

This reference is generated from the specification schema. Fields with the same spelling share one page with their separate placement contracts. The schema defines the language; [engine status](https://docs.nika.sh/reference/status.md) identifies the released implementation.

## Start with the shape

[Workflow syntax](https://docs.nika.sh/reference/yaml-syntax.md) · [Bindings and dependencies](https://docs.nika.sh/concepts/bindings.md) · [Verbs](https://docs.nika.sh/concepts/verbs.md) · [Security](https://docs.nika.sh/concepts/security.md)

## Workflow envelope

| Field | Declared in |
| - | - |
| [const](https://docs.nika.sh/reference/language/words/const.md) | / |
| [inputs](https://docs.nika.sh/reference/language/words/inputs.md) | / |
| [model](https://docs.nika.sh/reference/language/words/model.md) | / · /$defs/agent · /$defs/infer |
| [nika](https://docs.nika.sh/reference/language/words/nika.md) | / |
| [outputs](https://docs.nika.sh/reference/language/words/outputs.md) | / |
| [permits](https://docs.nika.sh/reference/language/words/permits.md) | / |
| [run](https://docs.nika.sh/reference/language/words/run.md) | / |
| [secrets](https://docs.nika.sh/reference/language/words/secrets.md) | / |
| [tasks](https://docs.nika.sh/reference/language/words/tasks.md) | / |

## Tasks and dependencies

| Field | Declared in |
| - | - |
| [after](https://docs.nika.sh/reference/language/words/after.md) | /\$defs/task |
| [agent](https://docs.nika.sh/reference/language/words/agent.md) | /\$defs/task |
| [because](https://docs.nika.sh/reference/language/words/because.md) | /\$defs/task/properties/lift/items |
| [exec](https://docs.nika.sh/reference/language/words/exec.md) | /\$defs/task · /properties/permits |
| [extract](https://docs.nika.sh/reference/language/words/extract.md) | /\$defs/task |
| [fail\_fast](https://docs.nika.sh/reference/language/words/fail_fast.md) | /\$defs/task/properties/for\_each |
| [for\_each](https://docs.nika.sh/reference/language/words/for_each.md) | /\$defs/task |
| [from](https://docs.nika.sh/reference/language/words/from.md) | /\$defs/task/properties/lift/items |
| [group](https://docs.nika.sh/reference/language/words/group.md) | /\$defs/task |
| [infer](https://docs.nika.sh/reference/language/words/infer.md) | /\$defs/task |
| [invoke](https://docs.nika.sh/reference/language/words/invoke.md) | /\$defs/task |
| [items](https://docs.nika.sh/reference/language/words/items.md) | /\$defs/task/properties/for\_each |
| [law](https://docs.nika.sh/reference/language/words/law.md) | /$defs/task/properties/lift/items · /$defs/task/properties/lift/items/allOf/0/if |
| [lift](https://docs.nika.sh/reference/language/words/lift.md) | /\$defs/task |
| [max\_items](https://docs.nika.sh/reference/language/words/max_items.md) | /\$defs/task/properties/for\_each |
| [max\_parallel](https://docs.nika.sh/reference/language/words/max_parallel.md) | /\$defs/task/properties/for\_each |
| [on\_error](https://docs.nika.sh/reference/language/words/on_error.md) | /\$defs/task |
| [retry](https://docs.nika.sh/reference/language/words/retry.md) | /\$defs/task |
| [returns](https://docs.nika.sh/reference/language/words/returns.md) | /\$defs/task |
| [timeout](https://docs.nika.sh/reference/language/words/timeout.md) | /\$defs/task |
| [when](https://docs.nika.sh/reference/language/words/when.md) | /\$defs/task |
| [with](https://docs.nika.sh/reference/language/words/with.md) | /\$defs/task |

## Verbs and models

| Field | Declared in |
| - | - |
| [args](https://docs.nika.sh/reference/language/words/args.md) | /\$defs/invoke |
| [budget\_tokens](https://docs.nika.sh/reference/language/words/budget_tokens.md) | /\$defs/infer/properties/thinking |
| [capture](https://docs.nika.sh/reference/language/words/capture.md) | /\$defs/exec |
| [command](https://docs.nika.sh/reference/language/words/command.md) | /\$defs/exec |
| [cwd](https://docs.nika.sh/reference/language/words/cwd.md) | /\$defs/exec |
| [decode](https://docs.nika.sh/reference/language/words/decode.md) | /\$defs/exec |
| [enabled](https://docs.nika.sh/reference/language/words/enabled.md) | /\$defs/infer/properties/thinking |
| [env](https://docs.nika.sh/reference/language/words/env.md) | /\$defs/exec · /properties/permits |
| [file](https://docs.nika.sh/reference/language/words/file.md) | /$defs/promptText/oneOf/1 · /$defs/schemaContract/oneOf/0 |
| [images](https://docs.nika.sh/reference/language/words/images.md) | /\$defs/agent |
| [max\_tokens](https://docs.nika.sh/reference/language/words/max_tokens.md) | /\$defs/infer |
| [max\_tokens\_total](https://docs.nika.sh/reference/language/words/max_tokens_total.md) | /\$defs/agent |
| [max\_turns](https://docs.nika.sh/reference/language/words/max_turns.md) | /\$defs/agent |
| [path](https://docs.nika.sh/reference/language/words/path.md) | /\$defs/infer/properties/vision/items · /properties/secrets/additionalProperties |
| [prompt](https://docs.nika.sh/reference/language/words/prompt.md) | /$defs/agent · /$defs/infer |
| [save](https://docs.nika.sh/reference/language/words/save.md) | /\$defs/agent/properties/images |
| [schema](https://docs.nika.sh/reference/language/words/schema.md) | /$defs/agent · /$defs/infer |
| [shell](https://docs.nika.sh/reference/language/words/shell.md) | /\$defs/exec |
| [skills](https://docs.nika.sh/reference/language/words/skills.md) | /\$defs/agent |
| [source](https://docs.nika.sh/reference/language/words/source.md) | /\$defs/infer/properties/vision/items · /properties/secrets/additionalProperties · /properties/secrets/additionalProperties/allOf/0/if |
| [stdin](https://docs.nika.sh/reference/language/words/stdin.md) | /\$defs/exec |
| [system](https://docs.nika.sh/reference/language/words/system.md) | /$defs/agent · /$defs/infer |
| [temperature](https://docs.nika.sh/reference/language/words/temperature.md) | /$defs/agent · /$defs/infer |
| [thinking](https://docs.nika.sh/reference/language/words/thinking.md) | /\$defs/infer |
| [tool](https://docs.nika.sh/reference/language/words/tool.md) | /\$defs/invoke |
| [tools](https://docs.nika.sh/reference/language/words/tools.md) | /\$defs/agent · /properties/permits |
| [url](https://docs.nika.sh/reference/language/words/url.md) | /\$defs/infer/properties/vision/items |
| [vision](https://docs.nika.sh/reference/language/words/vision.md) | /\$defs/infer |
| [workflow](https://docs.nika.sh/reference/language/words/workflow.md) | /\$defs/invoke |

## Retries and recovery

| Field | Declared in |
| - | - |
| [backoff\_max\_ms](https://docs.nika.sh/reference/language/words/backoff_max_ms.md) | /\$defs/retry |
| [backoff\_ms](https://docs.nika.sh/reference/language/words/backoff_ms.md) | /\$defs/retry |
| [backoff\_strategy](https://docs.nika.sh/reference/language/words/backoff_strategy.md) | /\$defs/retry |
| [jitter](https://docs.nika.sh/reference/language/words/jitter.md) | /\$defs/retry |
| [max\_attempts](https://docs.nika.sh/reference/language/words/max_attempts.md) | /\$defs/retry |
| [on\_codes](https://docs.nika.sh/reference/language/words/on_codes.md) | /$defs/onError · /$defs/retry |
| [recover](https://docs.nika.sh/reference/language/words/recover.md) | /\$defs/onError |
| [skip](https://docs.nika.sh/reference/language/words/skip.md) | /\$defs/onError |

## Permissions and secrets

| Field | Declared in |
| - | - |
| [egress](https://docs.nika.sh/reference/language/words/egress.md) | /properties/secrets/additionalProperties |
| [fs](https://docs.nika.sh/reference/language/words/fs.md) | /properties/permits |
| [host](https://docs.nika.sh/reference/language/words/host.md) | /properties/secrets/additionalProperties/properties/egress/items |
| [host\_from\_self](https://docs.nika.sh/reference/language/words/host_from_self.md) | /properties/secrets/additionalProperties/properties/egress/items |
| [http](https://docs.nika.sh/reference/language/words/http.md) | /properties/permits/properties/net |
| [key](https://docs.nika.sh/reference/language/words/key.md) | /properties/secrets/additionalProperties |
| [net](https://docs.nika.sh/reference/language/words/net.md) | /properties/permits |
| [read](https://docs.nika.sh/reference/language/words/read.md) | /properties/permits/properties/fs |
| [to](https://docs.nika.sh/reference/language/words/to.md) | /properties/secrets/additionalProperties/properties/egress/items |
| [write](https://docs.nika.sh/reference/language/words/write.md) | /properties/permits/properties/fs |

## Execution settings

| Field | Declared in |
| - | - |
| [access](https://docs.nika.sh/reference/language/words/access.md) | /properties/run |
| [clock](https://docs.nika.sh/reference/language/words/clock.md) | /properties/run |
| [effort](https://docs.nika.sh/reference/language/words/effort.md) | /properties/run/properties/reasoning |
| [entropy](https://docs.nika.sh/reference/language/words/entropy.md) | /properties/run |
| [fallback](https://docs.nika.sh/reference/language/words/fallback.md) | /properties/run/properties/access |
| [protocol](https://docs.nika.sh/reference/language/words/protocol.md) | /properties/run/properties/access |
| [reasoning](https://docs.nika.sh/reference/language/words/reasoning.md) | /properties/run |
| [seeded](https://docs.nika.sh/reference/language/words/seeded.md) | /properties/run/properties/entropy/anyOf/1 |
| [service\_tier](https://docs.nika.sh/reference/language/words/service_tier.md) | /properties/run/properties/access |
| [via](https://docs.nika.sh/reference/language/words/via.md) | /properties/run/properties/access |

## Values and types

| Field | Declared in |
| - | - |
| [additional](https://docs.nika.sh/reference/language/words/additional.md) | /\$defs/typeExpr/oneOf/2 |
| [array](https://docs.nika.sh/reference/language/words/array.md) | /\$defs/typeExpr/oneOf/2 |
| [default](https://docs.nika.sh/reference/language/words/default.md) | /properties/inputs/additionalProperties |
| [description](https://docs.nika.sh/reference/language/words/description.md) | /properties/const/additionalProperties/then · /properties/inputs/additionalProperties · /properties/outputs/additionalProperties/anyOf/1 |
| [enum](https://docs.nika.sh/reference/language/words/enum.md) | /\$defs/typeExpr/oneOf/2 |
| [integer](https://docs.nika.sh/reference/language/words/integer.md) | /\$defs/typeExpr/oneOf/2 |
| [map](https://docs.nika.sh/reference/language/words/map.md) | /\$defs/typeExpr/oneOf/2 |
| [max](https://docs.nika.sh/reference/language/words/max.md) | /$defs/typeExpr/oneOf/2/properties/integer · /$defs/typeExpr/oneOf/2/properties/number |
| [max\_len](https://docs.nika.sh/reference/language/words/max_len.md) | /\$defs/typeExpr/oneOf/2/properties/string |
| [min](https://docs.nika.sh/reference/language/words/min.md) | /$defs/typeExpr/oneOf/2/properties/integer · /$defs/typeExpr/oneOf/2/properties/number |
| [min\_len](https://docs.nika.sh/reference/language/words/min_len.md) | /\$defs/typeExpr/oneOf/2/properties/string |
| [number](https://docs.nika.sh/reference/language/words/number.md) | /\$defs/typeExpr/oneOf/2 |
| [object](https://docs.nika.sh/reference/language/words/object.md) | /\$defs/typeExpr/oneOf/2 |
| [optional](https://docs.nika.sh/reference/language/words/optional.md) | /\$defs/fieldTypeExpr/oneOf/1 |
| [pattern](https://docs.nika.sh/reference/language/words/pattern.md) | /\$defs/typeExpr/oneOf/2/properties/string |
| [required](https://docs.nika.sh/reference/language/words/required.md) | /properties/inputs/additionalProperties |
| [string](https://docs.nika.sh/reference/language/words/string.md) | /\$defs/typeExpr/oneOf/2 |
| [type](https://docs.nika.sh/reference/language/words/type.md) | /properties/const/additionalProperties/then · /properties/inputs/additionalProperties · /properties/outputs/additionalProperties/anyOf/1 |
| [union](https://docs.nika.sh/reference/language/words/union.md) | /\$defs/typeExpr/oneOf/2 |
| [value](https://docs.nika.sh/reference/language/words/value.md) | /properties/const/additionalProperties/then · /properties/outputs/additionalProperties/anyOf/1 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.