SessionFS コールバック
対象: SessionRpc(Session に紐づくセッション単位の操作) RPC 全体の概要とページ一覧は RPC を参照してください。SessionFS コールバック型
セッションスコープのファイルシステム操作のためのコールバック型(Request/Result)が定義されています。これらはCopilot CLIがクライアントにコールバックする際のリクエスト/レスポンスの型です。SessionFsStatResult / SessionFsReaddirResult / SessionFsReaddirWithTypesResult は失敗時に使う任意の error(SessionFsError)を持ちます。
SessionFsハンドラー
ClientはsessionFs.readFile / readFileBytes / writeFile / writeFileBytes に加えて、appendFile、exists、stat、mkdir、readdir、readdirWithTypes、rm、rename、sqliteQuery、sqliteTransaction、sqliteExists の各リクエストをSessionのプロバイダーへ振り分けます。ファイル操作の失敗は ENOENT(ENOENTまたは errno 2)/ UNKNOWN のerrorとして返します。existsは例外時にfalse、statは失敗時にゼロ値+errorを返します。プロバイダーが対応していない操作はUNKNOWNエラー(SQLite系はJSON-RPCエラー)になります。sqliteQuery/sqliteExistsの例外はJSON-RPCエラー、sqliteTransactionの失敗は結果のerror(errorClass付き)として返します。
プロバイダー側のインターフェース(SessionFsFilesystemProvider、SessionFsSqliteCapableProvider、SessionFsSqliteProvider、SessionFsSqliteTransactionProvider)は、従来のSessionFsProvider(2メソッド)を壊さないよう別インターフェースとして追加されています。
SQLite コールバック型
SQLiteサポートを有効にするには、
SessionFsSetProviderRequest の capabilities に SessionFsSetProviderCapabilities(sqlite: true) を渡します。
sessionFs(またはconfig/copilot.phpのsession_fs)を指定するとClient::start()がsessionFs.setProviderを1回だけ送信します。セッションにはcreateSessionFsProviderが必要です(SessionConfigを参照)。
SessionFsSqliteQueryType enum(src/Enums/)はクエリ種別を表します:
Exec: DDL/複数ステートメント(結果なし)Query: SELECT(行を返す)Run: INSERT/UPDATE/DELETE(rowsAffected を返す)
src/Types/Rpc/に配置されています。