AI-Lib
v1.0.0 · npm

TypeScript ランタイム
AI-Protocol 向け。

プロトコル駆動の TypeScript/Node.js ランタイム(v1.0.0)。HttpTransport + マニフェスト解析。 /core と /contact、V2 エラーコード 13 種。

npm install
npm install @ailib-official/ai-lib-ts

主な機能

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 実行またはストリームで応答を取得
chat.ts
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);

内部アーキテクチャ

プロトコル駆動アーキテクチャ:型安全な実行、既定のレジリエンス、完全な拡張性。

ai-lib-ts ランタイムアーキテクチャ クライアント層 AiClient · Message · ChatRequestBuilder · ChatResponse ポリシーエンジン PreflightChecker · Validator · FallbackChain プロトコル層 ProtocolLoader · Manifest · Validator レジリエンス層 RateLimiter · Backpressure · Retry ストリーミングパイプライン Decoder Selector Accumulator FanOut EventMapper トランスポート層 HttpTransport (undici/fetch) · Auth · Interceptors OpenAI · Anthropic · Gemini · DeepSeek · Qwen · 37 プロバイダー

モジュール概要

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。