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.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.SessionFsStatResult / SessionFsReaddirResult / SessionFsReaddirWithTypesResult tienen un error opcional (SessionFsError) que se usa en caso de fallo.
Handlers de SessionFs
El Client reparte al proveedor de laSession 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
Para activar el soporte de SQLite, pasa
SessionFsSetProviderCapabilities(sqlite: true) en capabilities de SessionFsSetProviderRequest.
sessionFs (o session_fs en config/copilot.php), Client::start() envía sessionFs.setProvider una sola vez. La sesión necesita createSessionFsProvider (consulta SessionConfig).
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)
src/Types/Rpc/.