主な機能
V2マニフェスト解析
V2プロトコルマニフェストの解析とロード、標準エラーコード（13コード）対応。プロバイダー非依存の設定、ハードコードロジックゼロ。
レジリエンスパターン
組み込みのRetryPolicy、CircuitBreaker、RateLimiter、Backpressure。PreflightCheckerによる統一リクエストゲーティング。
モデルルーティング
ModelManagerによるCostBasedSelector、QualityBasedSelector、FallbackChain。コストと品質の最適化のためのスマートモデル選択。
マルチモーダル対応
SttClientで音声テキスト変換、TtsClientでテキスト音声変換、RerankerClientでドキュメント再ランキング。完全なマルチモーダルコンテンツブロック対応。
MCPツールブリッジ
MCPツールをAI-Protocol形式にブリッジ。MCPサーバーと統一ツール呼び出しインターフェースをシームレスに統合。
バッチ処理とプラグイン
BatchExecutorによる並列処理、設定可能な並行数。リクエスト/レスポンスインターセプトフックを持つプラグインシステム。
シンプルで統一されたAPI
同じコードが37のすべてのプロバイダーで動作します。モデル識別子を変更するだけ——プロトコルマニフェストがすべてを処理します。
- 1 モデルIDでクライアントを作成
- 2 フルーエントAPIでチャットリクエストを構築
- 3 レスポンスを実行またはストリーミング
import { AiClient, Message } from '@hiddenpath/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 (local/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/
Model Context Protocol サーバーをシームレスに統合するための McpBridge, McpTool 定義。
multimodal/
SttClient, TtsClient, RerankerClient、マルチモーダル入力と専門モデルを完全にサポート。
plugins/ + batch/
PluginRegistry, Hooks。並行制限付きのバッチ実行のための BatchExecutor。