Zum Hauptinhalt springen

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.

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. 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

Um die SQLite-Unterstützung zu aktivieren, übergeben Sie SessionFsSetProviderCapabilities(sqlite: true) an capabilities von SessionFsSetProviderRequest.
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). 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/.
Zuletzt geändert am 19. November 2026