エコシステムアーキテクチャ

AI-Lib エコシステムは、各レイヤーが明確な責務を持つクリーンな 3 層アーキテクチャで構築されています。現在のバージョン：AI-Protocol v0.5.0、ai-lib-rust v0.7.1、ai-lib-python v0.6.0。

3 つのレイヤー

仕様レイヤーです。YAML マニフェストで以下を定義します：

プロバイダーマニフェスト（providers/*.yaml）— 35 以上のプロバイダーそれぞれのエンドポイント、認証、パラメータマッピング、ストリーミングデコーダー、エラー分類
モデルレジストリ（models/*.yaml）— コンテキストウィンドウ、機能、価格を持つモデルインスタンス
コア仕様（spec.yaml）— 標準パラメータ、イベント、エラー型、リトライポリシー
スキーマ（schemas/）— すべての設定の JSON Schema 検証

プロトコルレイヤーは言語非依存です。あらゆる言語のランタイムから消費されます。

実行レイヤーです。ランタイムは以下を実装します：

両ランタイムは同じアーキテクチャを共有します：

アプリケーションは統合ランタイム API を使用します。単一の AiClient インターフェースがすべてのプロバイダーで動作します：

Your App → AiClient → Protocol Manifest → Provider API

モデル識別子を 1 つ変更するだけでプロバイダーを切り替えられます。コード変更は不要です。

client.chat().user("Hello").stream() を呼び出すと何が起こるか：

AiClient がリクエストを受け取る
ProtocolLoader がプロバイダーマニフェストを提供する
リクエストコンパイラ が標準パラメータをプロバイダー固有の JSON にマッピングする
トランスポート が正しい認証/ヘッダーで HTTP リクエストを送信する
パイプライン がストリーミングレスポンスを処理する：
- Decoder がバイト → JSON フレーム（SSE または NDJSON）に変換
- Selector が JSONPath で関連フレームをフィルタリング
- Accumulator が部分的なツール呼び出しを組み立てる
- EventMapper がフレーム → 統一 StreamingEvent に変換
アプリケーション が統一イベントをイテレートする

両ランタイムは次の順序でプロトコルマニフェストを検索します：

つまり、ローカルセットアップなしで開発を開始できます。ランタイムが GitHub からマニフェストを自動的に取得します。

プロトコル v0.5.0 リリースでは 3 層ピラミッド アーキテクチャを導入しています：

コンプライアンステストスイート（42 テストケース、両ランタイムで 20/20 合格）により、Rust と Python 実装間で同一の動作が保証されます。

AI-Protocol と MCP（Model Context Protocol）は補完的です：

これらは異なるレイヤーで動作し、併用できます。