英語版: IVfsProvider
IVfsProvider
Responsibility
IVfsProvider が AIKernel のオーケストレーションおよび統治フローで、認証済み Vfs session を開くための provider 境界を定義する。
IVfsProvider 自体は read/write/delete/navigation/query 権限を意味しない。これらの権限は、返された session が実装する capability interface によって表現する。
主要メンバー（Draft）
| Member | Type | 説明 |
|---|---|---|
ProviderId |
string |
Vfs provider identifier. |
Name |
string |
Vfs provider display name. |
OpenSessionAsync(IVfsCredentials credentials) |
Task<IVfsSession> |
Open authenticated Vfs session. |
IsAvailableAsync() |
Task<bool> |
Check provider availability. |
GetHealthAsync() |
Task<VfsProviderHealth> |
Return health status for diagnostics. |
関連ユースケース
../../use-cases/AIKernel_UseCaseCatalog-jp.md の IVfsProvider 参照箇所を基準とする。
Notes
- 本文書は Interface レベルのドラフトである。
IVfsProviderは公開 namespaceAIKernel.Vfsを維持したまま、AIKernel.Abstractionsassembly が所有する。個別のAIKernel.Vfs互換 package は v0.0.4 で削除された。- 実装は fail-closed と deterministic replay の原則を維持すること。
VfsProviderHealthなどの具象データキャリアはAIKernel.Dtos.Vfsに定義する。- 不足している capability は、実行前に必要な capability interface を確認して検出すること。Provider は未対応の write/delete/query member を公開して遅延失敗させてはならない。
変更履歴
- v0.0.0 / v0.0.0.0: 初期ドラフト
- v0.0.1 (2026-05-06): ドキュメント規約に基づくバージョン更新
- v0.0.2 (2026-05-09): Session capability boundary を明確化
- v0.0.3 (2026-06-02): Abstractions 所有と type-forwarding 互換の注記を追加
- v0.0.4 (2026-06-04): namespace ownership を維持したまま個別の AIKernel.Vfs 互換 package 注記を削除
Source:
architecture/interfaces/vfs/IVfsProvider-jp.md