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

# SessionFS-Callbacks

> Typen und Implementierungsbeispiele für die SessionFS-Callbacks, die mit SessionRpc des Laravel Copilot SDK verwendet werden.

## SessionFS-Callbacks

Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session gebunden sind)

Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter [RPC](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md).

## SessionFS-Callback-Typen

Für Dateisystemoperationen im Session-Scope sind Callback-Typen (Request/Result) definiert. Dies sind die Request-/Response-Typen, die verwendet werden, wenn die Copilot CLI den Client per Callback aufruft.

| Typklasse | Zweck |
| - | - |
| `SessionFsReadFileRequest` / `SessionFsReadFileResult` | Datei lesen |
| `SessionFsWriteFileRequest` | Datei schreiben |
| `SessionFsAppendFileRequest` | An Datei anhängen |
| `SessionFsExistsRequest` / `SessionFsExistsResult` | Existenz einer Datei prüfen |
| `SessionFsStatRequest` / `SessionFsStatResult` | Datei-Metadaten abrufen |
| `SessionFsMkdirRequest` | Verzeichnis erstellen |
| `SessionFsReaddirRequest` / `SessionFsReaddirResult` | Verzeichnisliste |
| `SessionFsReaddirWithTypesRequest` / `SessionFsReaddirWithTypesResult` | Typisierte Verzeichnisliste |
| `SessionFsRmRequest` | Datei/Verzeichnis löschen |
| `SessionFsRenameRequest` | Datei/Verzeichnis umbenennen |

`SessionFsStatResult` / `SessionFsReaddirResult` / `SessionFsReaddirWithTypesResult` haben ein optionales `error` (`SessionFsError`) für den Fehlerfall.

### SessionFs-Handler

Der Client leitet neben `sessionFs.readFile` / `readFileBytes` / `writeFile` / `writeFileBytes` auch die Anfragen `appendFile`, `exists`, `stat`, `mkdir`, `readdir`, `readdirWithTypes`, `rm`, `rename`, `sqliteQuery`, `sqliteTransaction` und `sqliteExists` an den Provider der `Session` weiter. Fehler bei Dateioperationen werden als `error` mit `ENOENT` (`ENOENT` oder errno 2) / `UNKNOWN` zurückgegeben. `exists` gibt bei einer Exception `false` zurück, `stat` bei einem Fehler Nullwerte plus `error`. Vom Provider nicht unterstützte Operationen führen zu einem `UNKNOWN`-Fehler (bei SQLite-Operationen zu einem JSON-RPC-Fehler). Exceptions in `sqliteQuery`/`sqliteExists` werden als JSON-RPC-Fehler zurückgegeben, Fehler in `sqliteTransaction` als `error` im Ergebnis (mit `errorClass`).

Die Provider-Interfaces (`SessionFsFilesystemProvider`, `SessionFsSqliteCapableProvider`, `SessionFsSqliteProvider`, `SessionFsSqliteTransactionProvider`) wurden als separate Interfaces hinzugefügt, um das bisherige `SessionFsProvider` (2 Methoden) nicht zu brechen.

### SQLite-Callback-Typen

| Typklasse | Zweck |
| - | - |
| `SessionFsSetProviderCapabilities` | Deklaration der vom Provider unterstützten Funktionen (z. B. SQLite-Unterstützung) |
| `SessionFsSqliteExistsRequest` / `SessionFsSqliteExistsResult` | Existenz einer SQLite-Datenbank prüfen |
| `SessionFsSqliteQueryRequest` / `SessionFsSqliteQueryResult` | SQLite-Abfrage ausführen |
| `SessionFsSqliteTransactionRequest` / `SessionFsSqliteTransactionStatement` / `SessionFsSqliteTransactionResult` | SQLite-Transaktion (mehrere Statements atomar ausführen) |
| `SessionFsSqliteTransactionError` | Klassifizierung von Transaktionsfehlern (`errorClass`: `busyOrLocked` / `fatal` / `postCommitAmbiguous`; enum `SessionFSSqliteTransactionErrorClass`) |

Um die SQLite-Unterstützung zu aktivieren, übergeben Sie `SessionFsSetProviderCapabilities(sqlite: true)` an `capabilities` von `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),
));
```

Normalerweise rufen Sie diesen RPC nicht direkt auf: Wenn Sie die Client-Option `sessionFs` (oder `session_fs` in `config/copilot.php`) angeben, sendet `Client::start()` `sessionFs.setProvider` genau einmal. Sessions benötigen `createSessionFsProvider` (siehe [SessionConfig](https://kawax.biz/de/packages/laravel-copilot-sdk/session-config.md)).

Das Enum `SessionFsSqliteQueryType` (`src/Enums/`) beschreibt den Abfragetyp:

* `Exec`: DDL/mehrere Statements (kein Ergebnis)
* `Query`: SELECT (gibt Zeilen zurück)
* `Run`: INSERT/UPDATE/DELETE (gibt rowsAffected zurück)

Diese Typklassen befinden sich unter `src/Types/Rpc/`.


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [SessionConfig](https://kawax.biz/de/packages/laravel-copilot-sdk/session-config.md)
- [Session fortsetzen](https://kawax.biz/de/packages/laravel-copilot-sdk/resume.md)
- [Session-Informationen und lokale Session-Verwaltung](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/session-info.md)
- [Session-Hooks](https://kawax.biz/de/packages/laravel-copilot-sdk/hooks.md)


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