aai-gateway 0.9.2 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +35 -40
- package/README.ko.md +36 -41
- package/README.md +34 -39
- package/README.zh-CN.md +35 -40
- package/dist/acp-BR3nRg0h.js +2 -0
- package/dist/{acp-FxXoyW5o.js → acp-DKrqo3wS.js} +58 -13
- package/dist/acp-DKrqo3wS.js.map +1 -0
- package/dist/cli.js +11 -158
- package/dist/cli.js.map +1 -1
- package/dist/errors-C3N_hrpx.js.map +1 -1
- package/dist/index.js +63 -308
- package/dist/index.js.map +1 -1
- package/dist/mcp-registry-CAwSIW_K.js +2 -0
- package/dist/{mcp-registry-C_CK4tJR.js → mcp-registry-CuVFEyIP.js} +2 -2
- package/dist/{mcp-registry-C_CK4tJR.js.map → mcp-registry-CuVFEyIP.js.map} +1 -1
- package/dist/{server-BGUNbiBy.js → server-Bn5_ZW2P.js} +2689 -3722
- package/dist/server-Bn5_ZW2P.js.map +1 -0
- package/package.json +1 -1
- package/dist/acp-C-_WyzGE.js +0 -2
- package/dist/acp-FxXoyW5o.js.map +0 -1
- package/dist/config-BY9_-RkU.js +0 -63
- package/dist/config-BY9_-RkU.js.map +0 -1
- package/dist/importer-6KW19HEp.js +0 -2
- package/dist/importer-CrT4tpAD.js +0 -563
- package/dist/importer-CrT4tpAD.js.map +0 -1
- package/dist/mcp-registry-CdXvUgWx.js +0 -2
- package/dist/server-BGUNbiBy.js.map +0 -1
package/README.ja.md
CHANGED
|
@@ -33,7 +33,7 @@ AAI Gateway は AI エージェントとすべてのツールの間に位置し
|
|
|
33
33
|
| **コンテキストコスト** | すべてのプロンプトに 50 のツールスキーマ | 10 の1行サマリー（それぞれ約200文字）、詳細はオンデマンドでロード |
|
|
34
34
|
| **設定** | エージェントごとに MCP を設定 | 1回インポートですべてのエージェントが即時共有 |
|
|
35
35
|
| **新ツール** | インストール後にエージェントを再起動 | ホットリロードで即座に可用 |
|
|
36
|
-
|
|
|
36
|
+
| **ツール検索** | 手動検索 + 設定コピー | `"ファイルシステム MCP を探して"` → 数秒でインストール |
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
@@ -146,7 +146,7 @@ AI エージェントに直接話しかけます：
|
|
|
146
146
|
|
|
147
147
|
### エージェント相互運用性（ACP）
|
|
148
148
|
|
|
149
|
-
AAI Gateway
|
|
149
|
+
AAI Gateway は人気のコーディングエージェント（Claude Code、Codex、OpenCode）をビルトインでサポートし、制御可能なアプリとして公開します。これにより：
|
|
150
150
|
|
|
151
151
|
- **1つのエージェントで別のエージェントをオーケストレーション** — 例如、Claude Code にコードを書かせながら別のツールからレビュー
|
|
152
152
|
- **リモートワーク** — 外出中に電話でコーディングエージェントに指示
|
|
@@ -159,15 +159,9 @@ AAI Gateway はインストールされたエージェントツール（Claude C
|
|
|
159
159
|
- `removeApp` — 完全アンインストール
|
|
160
160
|
- `listAllAaiApps` — 登録されたすべてを表示
|
|
161
161
|
|
|
162
|
-
###
|
|
162
|
+
### ビルトイン ACP エージェント
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **macOS**：`<App>.app/Contents/Resources/aai.json`
|
|
167
|
-
- **Linux**：`/usr/share`、`/usr/local/share`、`~/.local/share`
|
|
168
|
-
- **Windows**：`Program Files`、`%LOCALAPPDATA%`
|
|
169
|
-
|
|
170
|
-
手動インポートは不要 — アプリをインストールすると、AAI Gateway が見つけます。
|
|
164
|
+
AAI Gateway には人気のコーディングエージェント（Claude Code、Codex、OpenCode）のディスクリプタが内蔵されています。起動時に自動的に登録されます — 手動インポートは不要です。
|
|
171
165
|
|
|
172
166
|
---
|
|
173
167
|
|
|
@@ -182,7 +176,7 @@ AAI Gateway はインストールされたエージェントツール（Claude C
|
|
|
182
176
|
| `aai:exec` | 管理アプリから特定のツールを実行（`app` + `tool` + `args`） |
|
|
183
177
|
| `mcp:import` | MCP サーバーをインポート |
|
|
184
178
|
| `skill:import` | スキルパッケージをインポート |
|
|
185
|
-
| `skill:create` |
|
|
179
|
+
| `skill:create` | AAI Gateway で管理される新規スキルを作成 |
|
|
186
180
|
| `search:discover` | 自然言語でツールやスキルを検索 |
|
|
187
181
|
|
|
188
182
|
さらに、インポートされたアプリごとの **`guide:<app-id>`** ツール — パラメータなしで、呼び出すと完全な操作ガイドを返します。
|
|
@@ -193,34 +187,37 @@ AAI Gateway はインストールされたエージェントツール（Claude C
|
|
|
193
187
|
|
|
194
188
|
```
|
|
195
189
|
┌─────────────────────────────────────────────────────────────┐
|
|
196
|
-
│ AI エージェント
|
|
190
|
+
│ AI エージェント │
|
|
197
191
|
│ Claude Code / Codex / OpenCode / ... │
|
|
198
192
|
└────────────────────────┬────────────────────────────────────┘
|
|
199
|
-
│ 単一 MCP 接続
|
|
193
|
+
│ 単一 MCP 接続 (stdio)
|
|
200
194
|
▼
|
|
201
195
|
┌─────────────────────────────────────────────────────────────┐
|
|
202
|
-
│
|
|
203
|
-
│
|
|
204
|
-
|
|
205
|
-
│
|
|
206
|
-
│ │
|
|
207
|
-
│
|
|
208
|
-
│
|
|
209
|
-
│ │
|
|
210
|
-
│ │
|
|
211
|
-
|
|
212
|
-
│
|
|
213
|
-
│ │
|
|
214
|
-
|
|
215
|
-
│
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
196
|
+
│ MCP サーバー層 (src/mcp/server.ts) │
|
|
197
|
+
│ プロトコル層 — MCP リクエスト/レスポンスを処理 │
|
|
198
|
+
├─────────────────────────────────────────────────────────────┤
|
|
199
|
+
│ コアゲートウェイ (src/core/gateway.ts) │
|
|
200
|
+
│ ┌─────────────────────────────────────────────────────┐ │
|
|
201
|
+
│ │ プログレッシブ開示 — サマリー → オンデマンド │ │
|
|
202
|
+
│ │ エージェント別可視性 — 有効化 / 無効化 / 削除 │ │
|
|
203
|
+
│ │ インポート — MCP サーバー、スキル、検索・発見 │ │
|
|
204
|
+
│ └─────────────────────────────────────────────────────┘ │
|
|
205
|
+
├─────────────────────────────────────────────────────────────┤
|
|
206
|
+
│ 実行コーディネーター (src/core/execution-coordinator.ts) │
|
|
207
|
+
│ 適切なエクスキューターにルーティング │
|
|
208
|
+
├──────────────────────┬──────────────────────────────────────┤
|
|
209
|
+
│ ストレージ │ シード │
|
|
210
|
+
│ ~/.local/share/ │ ビルトイン ACP エージェント │
|
|
211
|
+
│ aai-gateway/apps/ │ 起動時に書き込み（常に最新） │
|
|
212
|
+
│ <appId>/aai.json │ │
|
|
213
|
+
└──────────────────────┴──────────────┬───────────────────────┘
|
|
214
|
+
│
|
|
215
|
+
┌────────────┼────────────┐
|
|
216
|
+
▼ ▼ ▼
|
|
217
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
218
|
+
│ MCP │ │ スキル │ │ ACP │
|
|
219
|
+
│ サーバー │ │ │ │エージェント│
|
|
220
|
+
└──────────┘ └──────────┘ └──────────┘
|
|
224
221
|
```
|
|
225
222
|
|
|
226
223
|
---
|
|
@@ -247,7 +244,7 @@ ACP エージェントを設定。任意のエージェント（甚至电话上
|
|
|
247
244
|
|
|
248
245
|
## アプリ開発者の方へ：AAI 記述子
|
|
249
246
|
|
|
250
|
-
|
|
247
|
+
AAI Gateway でアプリを使えるようにしたいですか？`aai.json` ディスクリプタを作成してください：
|
|
251
248
|
|
|
252
249
|
```json
|
|
253
250
|
{
|
|
@@ -269,11 +266,9 @@ ACP エージェントを設定。任意のエージェント（甚至电话上
|
|
|
269
266
|
}
|
|
270
267
|
```
|
|
271
268
|
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
将描述符放置在[自动发现位置](#自动发现)之一，AAI Gateway 会自动获取它。
|
|
269
|
+
サポートされるプロトコル：`mcp`、`skill`、`acp-agent`
|
|
275
270
|
|
|
276
|
-
|
|
271
|
+
`mcp:import` または `skill:import` でインポートするか、ビルトインディスクリプタとしてバンドルします。ビルトインアプリを追加したいですか？[PR を提出](../../pulls) — `src/discovery/descriptors/` の例を参照。
|
|
277
272
|
|
|
278
273
|
---
|
|
279
274
|
|
package/README.ko.md
CHANGED
|
@@ -33,7 +33,7 @@ AAI Gateway는 AI 에이전트와 모든 도구 사이에 위치합니다. 하
|
|
|
33
33
|
| **컨텍스트 비용** | 모든 프롬프트에 50개 도구 스키마 | 10개 1줄 요약 (각각 약 200자), 상세내용은 요청 시 로드 |
|
|
34
34
|
| **설정** | 에이전트마다 MCP 설정 | 한 번 가져오기, 모든 에이전트가 즉시 공유 |
|
|
35
35
|
| **새 도구** | 설치 후 에이전트 재시작 | 핫리로딩, 즉시 사용 가능 |
|
|
36
|
-
|
|
|
36
|
+
| **도구 찾기** | 수동 검색 + 설정 복사 | `"파일 시스템 MCP 찾아줘"` → 몇 초 내 설치 |
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
@@ -146,7 +146,7 @@ AI 에이전트에게 직접 말하세요:
|
|
|
146
146
|
|
|
147
147
|
### 에이전트 상호운용성 (ACP)
|
|
148
148
|
|
|
149
|
-
AAI Gateway는
|
|
149
|
+
AAI Gateway는 인기 코딩 에이전트(Claude Code, Codex, OpenCode)를 기본 지원하며 제어 가능한 앱으로 노출합니다. 이것은 다음을 의미합니다:
|
|
150
150
|
|
|
151
151
|
- **한 에이전트로 다른 에이전트 오케스트레이션** — 예: Claude Code에 코드 작성시키고 다른 도구에서 리뷰
|
|
152
152
|
- **원격 작업** — 외출 중에 전화로 코딩 에이전트에 지시
|
|
@@ -159,15 +159,9 @@ AAI Gateway는 설치된 에이전트 도구(Claude Code, Codex, OpenCode)를
|
|
|
159
159
|
- `removeApp` — 완전히アンインストール
|
|
160
160
|
- `listAllAaiApps` — 등록된 모든 항목 보기
|
|
161
161
|
|
|
162
|
-
###
|
|
162
|
+
### 기본 제공 ACP 에이전트
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **macOS**: `<App>.app/Contents/Resources/aai.json`
|
|
167
|
-
- **Linux**: `/usr/share`, `/usr/local/share`, `~/.local/share`
|
|
168
|
-
- **Windows**: `Program Files`, `%LOCALAPPDATA%`
|
|
169
|
-
|
|
170
|
-
수동 가져오기 불필요 — 앱을 설치하면 AAI Gateway가 자동으로 찾습니다.
|
|
164
|
+
AAI Gateway에는 인기 코딩 에이전트(Claude Code, Codex, OpenCode)의 디스크립터가 내장되어 있습니다. 시작 시 자동으로 등록됩니다 — 수동 가져오기가 필요 없습니다.
|
|
171
165
|
|
|
172
166
|
---
|
|
173
167
|
|
|
@@ -182,7 +176,7 @@ AAI Gateway는 설치된 에이전트 도구(Claude Code, Codex, OpenCode)를
|
|
|
182
176
|
| `aai:exec` | 관리 앱에서 특정 도구 실행 (`app` + `tool` + `args`) |
|
|
183
177
|
| `mcp:import` | MCP 서버 가져오기 |
|
|
184
178
|
| `skill:import` | 스킬 패키지 가져오기 |
|
|
185
|
-
| `skill:create` | 새 스킬 생성
|
|
179
|
+
| `skill:create` | AAI Gateway가 관리하는 새 스킬 생성 |
|
|
186
180
|
| `search:discover` | 자연어로 도구 또는 스킬 검색 |
|
|
187
181
|
|
|
188
182
|
또한 가져온 각 앱에 대한 **`guide:<app-id>`** 도구 — 파라미터 없음, 호출 시 전체 작업 가이드 반환.
|
|
@@ -193,34 +187,37 @@ AAI Gateway는 설치된 에이전트 도구(Claude Code, Codex, OpenCode)를
|
|
|
193
187
|
|
|
194
188
|
```
|
|
195
189
|
┌─────────────────────────────────────────────────────────────┐
|
|
196
|
-
│ AI 에이전트
|
|
197
|
-
│ Claude Code / Codex / OpenCode / ...
|
|
190
|
+
│ AI 에이전트 │
|
|
191
|
+
│ Claude Code / Codex / OpenCode / ... │
|
|
198
192
|
└────────────────────────┬────────────────────────────────────┘
|
|
199
|
-
│ 단일 MCP 연결
|
|
193
|
+
│ 단일 MCP 연결 (stdio)
|
|
200
194
|
▼
|
|
201
195
|
┌─────────────────────────────────────────────────────────────┐
|
|
202
|
-
│
|
|
203
|
-
│
|
|
204
|
-
|
|
205
|
-
│
|
|
206
|
-
│ │
|
|
207
|
-
│
|
|
208
|
-
│
|
|
209
|
-
│ │
|
|
210
|
-
│ │
|
|
211
|
-
|
|
212
|
-
│
|
|
213
|
-
│
|
|
214
|
-
|
|
215
|
-
│
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
196
|
+
│ MCP 서버 레이어 (src/mcp/server.ts) │
|
|
197
|
+
│ 프로토콜 레이어 — MCP 요청/응답 처리 │
|
|
198
|
+
├─────────────────────────────────────────────────────────────┤
|
|
199
|
+
│ 코어 게이트웨이 (src/core/gateway.ts) │
|
|
200
|
+
│ ┌─────────────────────────────────────────────────────┐ │
|
|
201
|
+
│ │ 점진적 공개 — 요약 → 요청 시 로드 │ │
|
|
202
|
+
│ │ 에이전트별 가시성 — 활성화 / 비활성화 / 제거 │ │
|
|
203
|
+
│ │ 가져오기 — MCP 서버, 스킬, 검색 및 발견 │ │
|
|
204
|
+
│ └─────────────────────────────────────────────────────┘ │
|
|
205
|
+
├─────────────────────────────────────────────────────────────┤
|
|
206
|
+
│ 실행 코디네이터 (src/core/execution-coordinator.ts) │
|
|
207
|
+
│ 적절한 실행기로 라우팅 │
|
|
208
|
+
├──────────────────────┬──────────────────────────────────────┤
|
|
209
|
+
│ 스토리지 │ 시드 │
|
|
210
|
+
│ ~/.local/share/ │ 기본 제공 ACP 에이전트 디스크립터 │
|
|
211
|
+
│ aai-gateway/apps/ │ 시작 시 기록 (항상 최신) │
|
|
212
|
+
│ <appId>/aai.json │ │
|
|
213
|
+
└──────────────────────┴──────────────┬───────────────────────┘
|
|
214
|
+
│
|
|
215
|
+
┌────────────┼────────────┐
|
|
216
|
+
▼ ▼ ▼
|
|
217
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
218
|
+
│ MCP │ │ 스킬 │ │ ACP │
|
|
219
|
+
│ 서버 │ │ │ │ 에이전트 │
|
|
220
|
+
└──────────┘ └──────────┘ └──────────┘
|
|
224
221
|
```
|
|
225
222
|
|
|
226
223
|
---
|
|
@@ -247,7 +244,7 @@ ACP 에이전트 설정. 모든 에이전트(甚至电话上的)를 사용하여
|
|
|
247
244
|
|
|
248
245
|
## 앱 개발자를 위한: AAI 설명자
|
|
249
246
|
|
|
250
|
-
|
|
247
|
+
AAI Gateway에서 앱을 사용하고 싶으신가요? `aai.json` 설명자를 만드세요:
|
|
251
248
|
|
|
252
249
|
```json
|
|
253
250
|
{
|
|
@@ -269,11 +266,9 @@ ACP 에이전트 설정. 모든 에이전트(甚至电话上的)를 사용하여
|
|
|
269
266
|
}
|
|
270
267
|
```
|
|
271
268
|
|
|
272
|
-
지원되는 프로토콜: `mcp`, `skill`, `acp-agent
|
|
273
|
-
|
|
274
|
-
설명자를 [자동 감지 위치](#자동-감지) 중 하나에 놓으면 AAI Gateway가 자동으로拾います.
|
|
269
|
+
지원되는 프로토콜: `mcp`, `skill`, `acp-agent`
|
|
275
270
|
|
|
276
|
-
|
|
271
|
+
`mcp:import` 또는 `skill:import`로 가져오거나 기본 제공 디스크립터로 번들합니다. 기본 제공 앱을 추가하고 싶으신가요? [PR 열기](../../pulls) — `src/discovery/descriptors/`의 예제를 참조하세요.
|
|
277
272
|
|
|
278
273
|
---
|
|
279
274
|
|
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ AAI Gateway sits between your AI agents and all your tools. One MCP connection r
|
|
|
33
33
|
| **Context cost** | 50 tool schemas in every prompt | 10 one-line summaries (~200 chars each), details loaded on demand |
|
|
34
34
|
| **Config** | Configure each MCP per agent | Import once, all agents share instantly |
|
|
35
35
|
| **New tools** | Restart agent after install | Hot-reload, available immediately |
|
|
36
|
-
| **
|
|
36
|
+
| **Finding tools** | Manual search + copy config | `"Find me a filesystem MCP"` → installed in seconds |
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
@@ -146,7 +146,7 @@ Import local or remote skill packages. AAI Gateway copies them into managed stor
|
|
|
146
146
|
|
|
147
147
|
### Agent Interoperability (ACP)
|
|
148
148
|
|
|
149
|
-
AAI Gateway
|
|
149
|
+
AAI Gateway ships with built-in support for popular coding agents (Claude Code, Codex, OpenCode) and exposes them as controllable apps. This means:
|
|
150
150
|
|
|
151
151
|
- Use **one agent to orchestrate another** — e.g., direct Claude Code to write code while you review from a different tool
|
|
152
152
|
- **Remote work** — instruct your coding agents from your phone while on the go
|
|
@@ -159,15 +159,9 @@ One import serves all agents, but you can fine-tune visibility:
|
|
|
159
159
|
- `removeApp` — uninstall completely
|
|
160
160
|
- `listAllAaiApps` — see everything that's registered
|
|
161
161
|
|
|
162
|
-
###
|
|
162
|
+
### Pre-built ACP Agents
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **macOS**: `<App>.app/Contents/Resources/aai.json`
|
|
167
|
-
- **Linux**: `/usr/share`, `/usr/local/share`, `~/.local/share`
|
|
168
|
-
- **Windows**: `Program Files`, `%LOCALAPPDATA%`
|
|
169
|
-
|
|
170
|
-
No manual import needed — install the app, and AAI Gateway finds it.
|
|
164
|
+
AAI Gateway ships with built-in descriptors for popular coding agents (Claude Code, Codex, OpenCode). These are seeded automatically on startup — no manual import needed.
|
|
171
165
|
|
|
172
166
|
---
|
|
173
167
|
|
|
@@ -182,7 +176,7 @@ No manual import needed — install the app, and AAI Gateway finds it.
|
|
|
182
176
|
| `aai:exec` | Execute a specific tool from a managed app (`app` + `tool` + `args`) |
|
|
183
177
|
| `mcp:import` | Import an MCP server |
|
|
184
178
|
| `skill:import` | Import a skill package |
|
|
185
|
-
| `skill:create` | Create a new skill
|
|
179
|
+
| `skill:create` | Create a new skill managed by AAI Gateway |
|
|
186
180
|
| `search:discover` | Search for new tools or skills with natural language |
|
|
187
181
|
|
|
188
182
|
Plus a **`guide:<app-id>`** tool for each imported app — no parameters, just returns the full operation guide when called.
|
|
@@ -196,31 +190,34 @@ Plus a **`guide:<app-id>`** tool for each imported app — no parameters, just r
|
|
|
196
190
|
│ AI Agents │
|
|
197
191
|
│ Claude Code / Codex / OpenCode / ... │
|
|
198
192
|
└────────────────────────┬────────────────────────────────────┘
|
|
199
|
-
│ Single MCP Connection
|
|
193
|
+
│ Single MCP Connection (stdio)
|
|
200
194
|
▼
|
|
201
195
|
┌─────────────────────────────────────────────────────────────┐
|
|
202
|
-
│
|
|
203
|
-
│
|
|
204
|
-
|
|
205
|
-
│
|
|
206
|
-
│ │
|
|
207
|
-
│
|
|
208
|
-
│
|
|
209
|
-
│ │
|
|
210
|
-
│ │
|
|
211
|
-
|
|
212
|
-
│
|
|
213
|
-
│
|
|
214
|
-
|
|
215
|
-
│
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
196
|
+
│ MCP Server (src/mcp/server.ts) │
|
|
197
|
+
│ Protocol layer — handles MCP requests/responses │
|
|
198
|
+
├─────────────────────────────────────────────────────────────┤
|
|
199
|
+
│ Core Gateway (src/core/gateway.ts) │
|
|
200
|
+
│ ┌─────────────────────────────────────────────────────┐ │
|
|
201
|
+
│ │ Progressive Disclosure — summaries → on-demand │ │
|
|
202
|
+
│ │ Per-Agent Visibility — enable / disable / remove │ │
|
|
203
|
+
│ │ Import — MCP servers, skills, search & discover │ │
|
|
204
|
+
│ └─────────────────────────────────────────────────────┘ │
|
|
205
|
+
├─────────────────────────────────────────────────────────────┤
|
|
206
|
+
│ Execution (src/core/execution-coordinator.ts) │
|
|
207
|
+
│ Route calls to the right executor │
|
|
208
|
+
├──────────────────────┬──────────────────────────────────────┤
|
|
209
|
+
│ Storage │ Seed │
|
|
210
|
+
│ ~/.local/share/ │ Pre-built ACP agent descriptors │
|
|
211
|
+
│ aai-gateway/apps/ │ written on startup (always fresh) │
|
|
212
|
+
│ <appId>/aai.json │ │
|
|
213
|
+
└──────────────────────┴──────────────┬───────────────────────┘
|
|
214
|
+
│
|
|
215
|
+
┌────────────┼────────────┐
|
|
216
|
+
▼ ▼ ▼
|
|
217
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
218
|
+
│ MCP │ │ Skills │ │ ACP │
|
|
219
|
+
│ Servers │ │ │ │ Agents │
|
|
220
|
+
└──────────┘ └──────────┘ └──────────┘
|
|
224
221
|
```
|
|
225
222
|
|
|
226
223
|
---
|
|
@@ -247,7 +244,7 @@ Just describe what you need: `"I need something to query PostgreSQL"`. AAI Gatew
|
|
|
247
244
|
|
|
248
245
|
## For App Developers: AAI Descriptor
|
|
249
246
|
|
|
250
|
-
Want your app to
|
|
247
|
+
Want your app to work with AAI Gateway? Create an `aai.json` descriptor:
|
|
251
248
|
|
|
252
249
|
```json
|
|
253
250
|
{
|
|
@@ -269,11 +266,9 @@ Want your app to be auto-discovered by AAI Gateway? Add an `aai.json` descriptor
|
|
|
269
266
|
}
|
|
270
267
|
```
|
|
271
268
|
|
|
272
|
-
Supported protocols: `mcp`, `skill`, `acp-agent
|
|
273
|
-
|
|
274
|
-
Place the descriptor at one of the [auto-discovery locations](#auto-discovery), and AAI Gateway picks it up automatically.
|
|
269
|
+
Supported protocols: `mcp`, `skill`, `acp-agent`
|
|
275
270
|
|
|
276
|
-
|
|
271
|
+
Import via `mcp:import` or `skill:import`, or bundle as a pre-built descriptor. Want to add a pre-built app? [Open a PR](../../pulls) — see `src/discovery/descriptors/` for examples.
|
|
277
272
|
|
|
278
273
|
---
|
|
279
274
|
|
package/README.zh-CN.md
CHANGED
|
@@ -33,7 +33,7 @@ AAI Gateway 位于 AI 代理和所有工具之间。一个 MCP 连接可以替
|
|
|
33
33
|
| **上下文成本** | 每个提示词包含 50 个工具模式 | 10 个一行摘要（约 200 字符每个），详情按需加载 |
|
|
34
34
|
| **配置** | 每个代理单独配置 MCP | 导入一次，所有代理立即共享 |
|
|
35
35
|
| **新工具** | 安装后需要重启代理 | 热加载，立即可用 |
|
|
36
|
-
|
|
|
36
|
+
| **找工具** | 手动搜索 + 复制配置 | `"帮我找一个文件系统 MCP"` → 秒级安装 |
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
@@ -146,7 +146,7 @@ codex mcp add aai-gateway -- npx -y aai-gateway
|
|
|
146
146
|
|
|
147
147
|
### 代理互操作性（ACP）
|
|
148
148
|
|
|
149
|
-
AAI Gateway
|
|
149
|
+
AAI Gateway 内置支持主流编码代理（Claude Code、Codex、OpenCode）并将其作为可控制的应用暴露。这意味着：
|
|
150
150
|
|
|
151
151
|
- 使用**一个代理编排另一个** — 例如，让 Claude Code 写代码，同时你从另一个工具审查
|
|
152
152
|
- **远程工作** — 在外出时用手机指挥你的编码代理
|
|
@@ -159,15 +159,9 @@ AAI Gateway 自动检测已安装的代理工具（Claude Code、Codex、OpenCod
|
|
|
159
159
|
- `removeApp` — 完全卸载
|
|
160
160
|
- `listAllAaiApps` — 查看所有已注册的内容
|
|
161
161
|
|
|
162
|
-
###
|
|
162
|
+
### 预置 ACP 代理
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **macOS**：`<App>.app/Contents/Resources/aai.json`
|
|
167
|
-
- **Linux**：`/usr/share`、`/usr/local/share`、`~/.local/share`
|
|
168
|
-
- **Windows**：`Program Files`、`%LOCALAPPDATA%`
|
|
169
|
-
|
|
170
|
-
无需手动导入 — 安装应用后，AAI Gateway 会自动找到它。
|
|
164
|
+
AAI Gateway 内置了主流编码代理（Claude Code、Codex、OpenCode）的描述文件。启动时自动注册 — 无需手动导入。
|
|
171
165
|
|
|
172
166
|
---
|
|
173
167
|
|
|
@@ -182,7 +176,7 @@ AAI Gateway 自动检测已安装的代理工具（Claude Code、Codex、OpenCod
|
|
|
182
176
|
| `aai:exec` | 执行托管应用中的特定工具（`app` + `tool` + `args`） |
|
|
183
177
|
| `mcp:import` | 导入 MCP 服务器 |
|
|
184
178
|
| `skill:import` | 导入技能包 |
|
|
185
|
-
| `skill:create` |
|
|
179
|
+
| `skill:create` | 创建由 AAI Gateway 管理的新技能 |
|
|
186
180
|
| `search:discover` | 用自然语言搜索新工具或技能 |
|
|
187
181
|
|
|
188
182
|
另外还有每个已导入应用的 **`guide:<app-id>`** 工具 — 无参数，调用时返回完整操作指南。
|
|
@@ -194,33 +188,36 @@ AAI Gateway 自动检测已安装的代理工具（Claude Code、Codex、OpenCod
|
|
|
194
188
|
```
|
|
195
189
|
┌─────────────────────────────────────────────────────────────┐
|
|
196
190
|
│ AI 代理 │
|
|
197
|
-
│ Claude Code / Codex / OpenCode / ...
|
|
191
|
+
│ Claude Code / Codex / OpenCode / ... │
|
|
198
192
|
└────────────────────────┬────────────────────────────────────┘
|
|
199
|
-
│ 单一 MCP 连接
|
|
193
|
+
│ 单一 MCP 连接 (stdio)
|
|
200
194
|
▼
|
|
201
195
|
┌─────────────────────────────────────────────────────────────┐
|
|
202
|
-
│
|
|
203
|
-
│
|
|
204
|
-
|
|
205
|
-
│
|
|
206
|
-
│ │
|
|
207
|
-
│
|
|
208
|
-
│
|
|
209
|
-
│ │
|
|
210
|
-
│ │
|
|
211
|
-
|
|
212
|
-
│
|
|
213
|
-
│ │
|
|
214
|
-
|
|
215
|
-
│
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
196
|
+
│ MCP 服务层 (src/mcp/server.ts) │
|
|
197
|
+
│ 协议层 — 处理 MCP 请求/响应 │
|
|
198
|
+
├─────────────────────────────────────────────────────────────┤
|
|
199
|
+
│ 核心网关 (src/core/gateway.ts) │
|
|
200
|
+
│ ┌─────────────────────────────────────────────────────┐ │
|
|
201
|
+
│ │ 渐进式披露 — 摘要 → 按需加载 │ │
|
|
202
|
+
│ │ 代理级别可见性 — 启用 / 禁用 / 移除 │ │
|
|
203
|
+
│ │ 导入 — MCP 服务器、技能、搜索发现 │ │
|
|
204
|
+
│ └─────────────────────────────────────────────────────┘ │
|
|
205
|
+
├─────────────────────────────────────────────────────────────┤
|
|
206
|
+
│ 执行协调 (src/core/execution-coordinator.ts) │
|
|
207
|
+
│ 将调用路由到正确的执行器 │
|
|
208
|
+
├──────────────────────┬──────────────────────────────────────┤
|
|
209
|
+
│ 存储 │ 预置 │
|
|
210
|
+
│ ~/.local/share/ │ 预置 ACP 代理描述文件 │
|
|
211
|
+
│ aai-gateway/apps/ │ 启动时写入（始终覆盖最新） │
|
|
212
|
+
│ <appId>/aai.json │ │
|
|
213
|
+
└──────────────────────┴──────────────┬───────────────────────┘
|
|
214
|
+
│
|
|
215
|
+
┌────────────┼────────────┐
|
|
216
|
+
▼ ▼ ▼
|
|
217
|
+
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
218
|
+
│ MCP │ │ 技能 │ │ ACP │
|
|
219
|
+
│ 服务器 │ │ │ │ 代理 │
|
|
220
|
+
└──────────┘ └──────────┘ └──────────┘
|
|
224
221
|
```
|
|
225
222
|
|
|
226
223
|
---
|
|
@@ -247,7 +244,7 @@ AAI Gateway 的两阶段披露将上下文 token 使用量减少 90%+。你的
|
|
|
247
244
|
|
|
248
245
|
## 应用开发者：AAI 描述符
|
|
249
246
|
|
|
250
|
-
|
|
247
|
+
想让你的应用接入 AAI Gateway？创建一个 `aai.json` 描述符：
|
|
251
248
|
|
|
252
249
|
```json
|
|
253
250
|
{
|
|
@@ -269,11 +266,9 @@ AAI Gateway 的两阶段披露将上下文 token 使用量减少 90%+。你的
|
|
|
269
266
|
}
|
|
270
267
|
```
|
|
271
268
|
|
|
272
|
-
支持的协议：`mcp`、`skill`、`acp-agent
|
|
273
|
-
|
|
274
|
-
将描述符放置在[自动发现位置](#自动发现)之一，AAI Gateway 会自动获取它。
|
|
269
|
+
支持的协议：`mcp`、`skill`、`acp-agent`
|
|
275
270
|
|
|
276
|
-
|
|
271
|
+
通过 `mcp:import` 或 `skill:import` 导入，或作为预置描述符打包。想添加预置应用？[提交 PR](../../pulls) — 参考 `src/discovery/descriptors/` 中的示例。
|
|
277
272
|
|
|
278
273
|
---
|
|
279
274
|
|