主な機能
V2 マニフェスト解析
標準エラーコード(13 種)付き V2 プロトコルマニフェストを解析・読み込み。 ハードコードなしのプロバイダー非依存設定。
レジリエンスパターン
組み込みの RetryPolicy、CircuitBreaker、RateLimiter、Backpressure。 PreflightChecker による統一リクエストゲート。
モデルルーティング
ModelManager と CostBasedSelector / QualityBasedSelector / FallbackChain。 コストと品質を最適化するスマート選択。
マルチモーダル対応
音声認識の SttClient、音声合成の TtsClient、再ランキングの RerankerClient。 マルチモーダルコンテンツブロックを完全サポート。
MCP ツールブリッジ
MCP ツールを AI-Protocol 形式へ橋渡し。統一ツール呼び出しで MCP サーバーを統合。
バッチとプラグイン
並行度設定可能な BatchExecutor。リクエスト / レスポンス傍受用フック付きプラグイン。
シンプルで統一された API
同じコードが 37+ プロバイダーで動作します。モデル識別子を変えるだけ —the protocol manifest handles everything else.
- 1 モデル ID でクライアントを作成
- 2 流暢な API でチャットリクエストを構築
- 3 実行またはストリームで応答を取得
import { AiClient, Message } from '@ailib-official/ai-lib-ts';
const client = await AiClient.new('openai/gpt-4o');
const response = await client
.chat([
Message.system('You are helpful.'),
Message.user('Hello!'),
])
.temperature(0.7)
.execute();
console.log(response.content); 内部アーキテクチャ
プロトコル駆動アーキテクチャ:型安全な実行、既定のレジリエンス、完全な拡張性。
モジュール概要
client/ + errors/
AiClient、ChatRequestBuilder、ChatResponse、CallStats、CancelToken、 CancellableStream、統一エラーコード。
protocol/
ProtocolLoader(ローカル / fetch / GitHub)、V2 マニフェスト、JSON Schema 検証、 プロバイダー非依存モデル。
pipeline/
Decoder(SSE、JSON Lines)、Selector(JSONPath)、Accumulator、FanOut、EventMapper (プロトコル駆動)。
resilience/
RetryPolicy、CircuitBreaker、RateLimiter、Backpressure、PreflightChecker、 SignalsSnapshot、FallbackChain。
routing/
ModelManager、QualityBasedSelector、CostBasedSelector、FallbackChain による知的選択。
mcp/
McpBridge と McpTool 定義で Model Context Protocol サーバーを統合。
multimodal/
SttClient、TtsClient、RerankerClient。マルチモーダル入力と専用モデルを完全サポート。
plugins/ + batch/
PluginRegistry、Hooks。並行上限付き BatchExecutor。