# Runs

Un run représente une exécution IA auditable. Les méthodes sont read-only et exigent
`runs:read`.

```php
$page = $relai->runs()->list([
    'page' => 1,
    'limit' => 20,
    'status' => 'failed',
    'type' => 'structured',
]);
```

```php
$run = $relai->runs()->get($runId);

print_r([
    'provider' => $run['providerSlug'],
    'model' => $run['model'],
    'status' => $run['status'],
    'durationMs' => $run['durationMs'] ?? null,
    'error' => $run['errorMessage'] ?? null,
    'toolCalls' => $run['toolCalls'] ?? [],
]);
```

Types actuels : `chat`, `structured`, `tool_loop`, `analysis`. Statuts : `pending`,
`running`, `completed`, `failed`.

Les compteurs de tokens et timestamps peuvent être nuls. Évitez de logger directement
`input`/`output`, qui peuvent contenir des données sensibles.