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

# Callbacks de SessionFS

> Tipos y ejemplos de implementación de los callbacks de SessionFS que se usan con SessionRpc en Laravel Copilot SDK.

## Callbacks de SessionFS

Ámbito: SessionRpc (operaciones por sesión vinculadas a una Session)

Para una visión general de RPC y la lista de todas las páginas de RPC, consulta [RPC](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

## Tipos de callback de SessionFS

Están definidos tipos de callback (Request/Result) para las operaciones de sistema de ficheros con ámbito de sesión. Son los tipos de petición/respuesta que usa Copilot CLI al hacer callback al cliente.

| Clase de tipo | Uso |
| - | - |
| `SessionFsReadFileRequest` / `SessionFsReadFileResult` | Leer ficheros |
| `SessionFsWriteFileRequest` | Escribir ficheros |
| `SessionFsAppendFileRequest` | Añadir contenido a un fichero |
| `SessionFsExistsRequest` / `SessionFsExistsResult` | Comprobar existencia de fichero |
| `SessionFsStatRequest` / `SessionFsStatResult` | Obtener metadatos de fichero |
| `SessionFsMkdirRequest` | Crear directorio |
| `SessionFsReaddirRequest` / `SessionFsReaddirResult` | Listar directorio |
| `SessionFsReaddirWithTypesRequest` / `SessionFsReaddirWithTypesResult` | Listado de directorio con tipos |
| `SessionFsRmRequest` | Eliminar fichero/directorio |
| `SessionFsRenameRequest` | Renombrar fichero/directorio |

`SessionFsStatResult` / `SessionFsReaddirResult` / `SessionFsReaddirWithTypesResult` tienen un `error` opcional (`SessionFsError`) que se usa en caso de fallo.

### Handlers de SessionFs

El Client reparte al proveedor de la `Session` las solicitudes `sessionFs.readFile` / `readFileBytes` / `writeFile` / `writeFileBytes`, además de `appendFile`, `exists`, `stat`, `mkdir`, `readdir`, `readdirWithTypes`, `rm`, `rename`, `sqliteQuery`, `sqliteTransaction` y `sqliteExists`. Los fallos de las operaciones de ficheros se devuelven como `error` `ENOENT` (`ENOENT` o errno 2) / `UNKNOWN`. `exists` devuelve `false` ante una excepción, y `stat` devuelve valores cero + `error` si falla. Las operaciones que el proveedor no soporta producen un error `UNKNOWN` (en las de SQLite, un error JSON-RPC). Las excepciones de `sqliteQuery`/`sqliteExists` se devuelven como error JSON-RPC, y los fallos de `sqliteTransaction` como `error` del resultado (con `errorClass`).

Las interfaces del lado del proveedor (`SessionFsFilesystemProvider`, `SessionFsSqliteCapableProvider`, `SessionFsSqliteProvider`, `SessionFsSqliteTransactionProvider`) se han añadido como interfaces independientes para no romper el `SessionFsProvider` existente (2 métodos).

### Tipos de callback de SQLite

| Clase de tipo | Uso |
| - | - |
| `SessionFsSetProviderCapabilities` | Declaración de las capacidades del proveedor (soporte de SQLite, etc.) |
| `SessionFsSqliteExistsRequest` / `SessionFsSqliteExistsResult` | Comprobar la existencia de una base de datos SQLite |
| `SessionFsSqliteQueryRequest` / `SessionFsSqliteQueryResult` | Ejecutar consultas SQLite |
| `SessionFsSqliteTransactionRequest` / `SessionFsSqliteTransactionStatement` / `SessionFsSqliteTransactionResult` | Transacción SQLite (ejecuta varias sentencias de forma atómica) |
| `SessionFsSqliteTransactionError` | Clasificación de fallos de transacción (`errorClass`: `busyOrLocked` / `fatal` / `postCommitAmbiguous`. enum `SessionFSSqliteTransactionErrorClass`) |

Para activar el soporte de SQLite, pasa `SessionFsSetProviderCapabilities(sqlite: true)` en `capabilities` de `SessionFsSetProviderRequest`.

```php theme={null}
use Revolution\Copilot\Types\Rpc\SessionFsSetProviderCapabilities;
use Revolution\Copilot\Types\Rpc\SessionFsSetProviderRequest;

$client->rpc()->sessionFs()->setProvider(new SessionFsSetProviderRequest(
    initialCwd: '/app',
    sessionStatePath: '.copilot/sessions',
    capabilities: new SessionFsSetProviderCapabilities(sqlite: true),
));
```

Normalmente no se llama a esta RPC directamente: si indicas la opción de Client `sessionFs` (o `session_fs` en `config/copilot.php`), `Client::start()` envía `sessionFs.setProvider` una sola vez. La sesión necesita `createSessionFsProvider` (consulta [SessionConfig](https://kawax.biz/es/packages/laravel-copilot-sdk/session-config.md)).

El enum `SessionFsSqliteQueryType` (`src/Enums/`) representa el tipo de consulta:

* `Exec`: DDL/varias sentencias (sin resultado)
* `Query`: SELECT (devuelve filas)
* `Run`: INSERT/UPDATE/DELETE (devuelve rowsAffected)

Estas clases están en `src/Types/Rpc/`.


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [SessionConfig](https://kawax.biz/es/packages/laravel-copilot-sdk/session-config.md)
- [Referencia de opciones del cliente](https://kawax.biz/es/packages/laravel-copilot-sdk/client-options.md)
- [Resumen de ServerRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [Excepciones y manejo de errores](https://kawax.biz/es/packages/laravel-copilot-sdk/exceptions.md)


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