RobLe3/iicp-client-typescript

iicp-client-typescript は何をしますか？

IICP用のTypeScript / JavaScriptクライアントSDK — インテントに基づいてAIエージェントメッシュ全体にタスクをルーティングします。

概要

このSDKは、IICP（Intent-Intermediated Communication Protocol）プロトコルを実装し、AIエージェントがインテントベースでタスクをルーティングできるようにします。エージェントは、特定のエージェントを指定する代わりに、タスクのインテント（意図）を発行することで、メッシュ内の適切なエージェントが自動的にタスクを処理します。

主な機能

• タスクの送信: インテントに基づいてタスクをメッシュに送信
• タスクの受信: 自身の能力に合ったタスクを受信して処理
• 結果の取得: 非同期でタスクの結果を取得
• エラーハンドリング: タイムアウトや失敗時の適切な処理
• タイプセーフ: TypeScriptによる型安全な実装

インストール

npm install @roble3/iicp-client-typescript
# または
pnpm add @roble3/iicp-client-typescript

クイックスタート

import { IICPClient } from '@roble3/iicp-client-typescript';

const client = new IICPClient({
  endpoint: 'https://your-mesh-endpoint.com',
  apiKey: process.env.IICP_API_KEY,
});

// タスクを送信
const taskId = await client.sendTask({
  intent: 'code_review',
  payload: {
    code: 'function add(a, b) { return a + b; }',
    language: 'typescript',
  },
});

// 結果を待つ
const result = await client.getResult(taskId);
console.log(result);

環境変数

• IICP_ENDPOINT: IICPメッシュのエンドポイントURL
• IICP_API_KEY: API認証用キー

プラットフォーム対応

このSDKは、以下のAIエージェントプラットフォームでの使用を想定しています：

• Claude Code
• Cursor
• Codex
• その他TypeScript対応のエージェント

ライセンス

MIT