Saltar al contenido principal

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

Para activar el soporte de SQLite, pasa SessionFsSetProviderCapabilities(sqlite: true) en capabilities de SessionFsSetProviderRequest.
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). 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/.
Última modificación el 20 de noviembre de 2026