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

# Error Handling

> Understand parse, validation, and runtime errors.

The executor can fail before execution, during validation, or while running providers and tools.

## Error phases

| Phase      | Example                                                         |
| ---------- | --------------------------------------------------------------- |
| Parse      | malformed block syntax                                          |
| Validation | unknown reference or invalid schema path                        |
| Runtime    | provider request failed, tool call failed, invalid model output |

## `/execute` error shape

```json theme={"languages":{"custom":["/languages/wire.tmLanguage.json"]}}
{
  "error": {
    "kind": "validation_error",
    "message": "Unknown reference: agent.missing.summary",
    "issues": [
      {
        "path": "agent.writer.instruction",
        "message": "Unknown reference: agent.missing.summary"
      }
    ]
  }
}
```

## `/execute` event-stream error shape

```text theme={"languages":{"custom":["/languages/wire.tmLanguage.json"]}}
event: workflow_failed
data: {"message":"Provider request failed"}
```

## Common fixes

* Check that every referenced agent field exists in that agent's `output` block.
* Check that `input` and `secrets` payloads match the workflow declarations.
* Check that imported tools, prompts, and resources are listed in an agent's `uses` array when the agent needs them.
* Check provider endpoint, API key, and model IDs.
* Check that tool call runtime values are supplied with `bindings {}`.