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 nebensessionFs.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.
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)
src/Types/Rpc/.