> ## 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.

# images

> Contract, placement, related fields and source examples for this Nika YAML field.

[Language reference](https://docs.nika.sh/reference/language/overview.md) / `images`

## Meaning and placement

### agent

The images an agent application delivers during its turn, as a value of the task: `.output` becomes `{ message, images }`, each image `{ index, path, sha256, size_bytes, mime_type, width, height }`. Only bytes received on this task's own session count; a path the application reports is never opened. A task that runs on a seat (`run.access.protocol: acp`) only (spec/02-verbs.md §Harness images).

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/$defs/agent/properties/images` |
| type | `"object"` |
| additionalProperties | `false` |

**In the same object:** [max\_tokens\_total](https://docs.nika.sh/reference/language/words/max_tokens_total.md) · [max\_turns](https://docs.nika.sh/reference/language/words/max_turns.md) · [model](https://docs.nika.sh/reference/language/words/model.md) · [prompt](https://docs.nika.sh/reference/language/words/prompt.md) · [schema](https://docs.nika.sh/reference/language/words/schema.md) · [skills](https://docs.nika.sh/reference/language/words/skills.md) · [system](https://docs.nika.sh/reference/language/words/system.md) · [temperature](https://docs.nika.sh/reference/language/words/temperature.md) · [tools](https://docs.nika.sh/reference/language/words/tools.md)

[Schema source (use the pointer above)](https://github.com/supernovae-st/nika-spec/blob/5c40ba456c53a4ab663a949d44003078e161305d/schemas/workflow.schema.json)

## Examples

No matching source-template occurrence is recorded in this projection. [Write a workflow](https://docs.nika.sh/guides/templates.md) or consult the schema declaration above.

## Contract and implementation

This page projects the named specification revision. Check [released engine status](https://docs.nika.sh/reference/status.md) and [the validation workflow](https://docs.nika.sh/guides/agent-authoring.md) before running a file. An optional field is not evidence that every engine supports every value.

Canonical identity: `language:word:images`. Spec revision: [`5c40ba456c53`](https://github.com/supernovae-st/nika-spec/tree/5c40ba456c53a4ab663a949d44003078e161305d).

[How documentation stays connected](https://docs.nika.sh/reference/knowledge-system.md).


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