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

# Excepciones y manejo de errores

> Conoce qué excepciones lanza el Laravel Copilot SDK y cuándo, cómo capturarlas con throw() y cómo funcionan los errores JSON-RPC y de SQLite en SessionFs.

## Excepciones y manejo de errores

Todas las excepciones que lanza el SDK están en el namespace `Revolution\Copilot\Exceptions`. Aparecen de dos formas: algunas se guardan en el resultado de la sesión y se lanzan al llamar a `throw()`, y otras se lanzan de inmediato, por ejemplo en las llamadas RPC.

## Errores y timeouts de sesión

Con `sendAndWait()` y `Copilot::run()`, un error o timeout de sesión no se lanza en el momento. En su lugar, la excepción se guarda en el `SessionEvent` devuelto. Igual que con Http y Process de Laravel, llamar a `throw()` lanza la excepción guardada. Si no hay error, `throw()` no hace nada, así que puedes seguir encadenando métodos.

```php theme={null}
use Revolution\Copilot\Exceptions\SessionErrorException;
use Revolution\Copilot\Exceptions\SessionTimeoutException;
use Revolution\Copilot\Facades\Copilot;

try {
    $content = Copilot::run('Calculate 1 + 1')->throw()->content();
} catch (SessionTimeoutException $e) {
    // Manejar el timeout
} catch (SessionErrorException $e) {
    // Manejar el error de sesión
}
```

Para comprobar el éxito sin lanzar excepciones, usa `failed()` y `successful()`. Consulta [SessionEvent](https://kawax.biz/es/packages/laravel-copilot-sdk/session-event.md) para más detalles.

### SessionTimeoutException

Se guarda cuando la espera de `session.idle` (la finalización de la respuesta) agota el tiempo. Establece el tiempo límite con el argumento `timeout` de `sendAndWait()`. Si lo omites, se usa el valor de configuración `copilot.timeout` (60 segundos por defecto).

### SessionErrorException

Se guarda cuando la sesión devuelve un error mediante un evento `SESSION_ERROR`. El mensaje contiene el error devuelto por el runtime.

## JsonRpcException

Se lanza de inmediato cuando la CLI devuelve un error JSON-RPC para una llamada RPC. Lee el código de error JSON-RPC en la propiedad `code` y los datos adjuntos al error en la propiedad `data`.

```php theme={null}
use Revolution\Copilot\Exceptions\JsonRpcException;
use Revolution\Copilot\Facades\Copilot;

try {
    Copilot::client()->rpc()->ping();
} catch (JsonRpcException $e) {
    $e->code; // Código de error JSON-RPC
    $e->data; // Datos adjuntos al error
}
```

## SessionFsSqliteTransactionFailure

Usa esta excepción cuando implementes un proveedor SQLite de SessionFs. No la capturas: la lanzas desde `transaction()` del proveedor para indicar al runtime cómo debe clasificarse el fallo. Establece la clasificación con `errorClass`:

* `Fatal` (predeterminado): un fallo irrecuperable
* `BusyOrLocked`: úsalo solo cuando SQLite devolvió BUSY/LOCKED antes del commit y la transacción se revirtió
* `PostCommitAmbiguous`: no se puede determinar el resultado después del commit

Cualquier otra excepción lanzada desde `transaction()` se informa como `fatal`.

```php theme={null}
use Revolution\Copilot\Enums\SessionFSSqliteTransactionErrorClass;
use Revolution\Copilot\Exceptions\SessionFsSqliteTransactionFailure;

throw new SessionFsSqliteTransactionFailure(
    'database is locked',
    SessionFSSqliteTransactionErrorClass::BusyOrLocked,
);
```

## StrayRequestException

La lanza el fake de pruebas cuando envías una solicitud sin un fake coincidente registrado. Si aparece de forma inesperada, olvidaste registrar un fake para esa solicitud. Consulta [Pruebas](https://kawax.biz/es/packages/laravel-copilot-sdk/fake.md) para saber cómo usar los fakes.


## Related topics

- [SessionEvent](https://kawax.biz/es/packages/laravel-copilot-sdk/session-event.md)
- [Manejo de errores](https://kawax.biz/es/error-handling.md)
- [Estructura de aplicación en Laravel 11 y posteriores](https://kawax.biz/es/advanced/app-structure.md)
- [Construir una SPA con Inertia.js](https://kawax.biz/es/blog/inertia-introduction.md)
- [Autenticación OAuth 2.0 - Google Sheets API for Laravel](https://kawax.biz/es/packages/laravel-google-sheets/oauth.md)


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