@okxweb3/a2a-node 0.0.6 → 0.0.7-beta-3678009f42-260615204732
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/dist/cli.js +6059 -705
- package/dist/index.js +5000 -154
- package/package.json +3 -2
- package/dist/workspace/AGENTS.md +0 -52
- package/dist/workspace/CLAUDE.md +0 -53
- package/dist/workspace/xmtp-tool.js +0 -769
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@okxweb3/a2a-node",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.7-beta-3678009f42-260615204732",
|
|
4
4
|
"description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -34,7 +34,8 @@
|
|
|
34
34
|
"@xmtp/node-bindings": "1.6.8",
|
|
35
35
|
"@xmtp/node-sdk": "4.6.0",
|
|
36
36
|
"@xmtp/proto": "3.78.0",
|
|
37
|
-
"viem": "2.48.4"
|
|
37
|
+
"viem": "2.48.4",
|
|
38
|
+
"ws": "8.20.0"
|
|
38
39
|
},
|
|
39
40
|
"devDependencies": {
|
|
40
41
|
"@types/node": "25.6.0",
|
package/dist/workspace/AGENTS.md
DELETED
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
# OKX A2A Tools — Bridge Mapping
|
|
2
|
-
|
|
3
|
-
🛑 **HARD RULE — there are NO native `xmtp_*` / `session_status` tools in this environment.**
|
|
4
|
-
|
|
5
|
-
- **DO NOT** `ToolSearch` for any tool name listed below — the search will return empty / irrelevant results and waste ~10‑18s.
|
|
6
|
-
- **DO NOT** `Read` any `legacy-tool-bridge/SKILL.md` — the full mapping is already in the table below.
|
|
7
|
-
- When a playbook references `xmtp_send` / `xmtp_dispatch_user` / `xmtp_prompt_user` / `session_status` / etc., skip discovery and go straight to `node xmtp-tool.js <tool_name> '<args_json>'`.
|
|
8
|
-
|
|
9
|
-
## Skill files — try known locations first, never scan the whole disk
|
|
10
|
-
|
|
11
|
-
When a task prompt says "Read the okx-agent-task skill" (or names any other
|
|
12
|
-
OKX skill), try these paths in order — skills are usually installed via
|
|
13
|
-
`npx skills add`, whose default global root is `~/.agents/skills`:
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
./.agents/skills/<skill-name>/SKILL.md # project-level install
|
|
17
|
-
~/.agents/skills/<skill-name>/SKILL.md # global install (most common)
|
|
18
|
-
~/.claude/skills/<skill-name>/SKILL.md # host-specific directory
|
|
19
|
-
~/.codex/skills/<skill-name>/SKILL.md # host-specific directory
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
- If none of these exist, you may search — but only INSIDE the skill roots
|
|
23
|
-
above (e.g. `ls ~/.agents/skills/`), never across `$HOME` or the whole
|
|
24
|
-
filesystem (`find ~ -name SKILL.md`, `find / -path '*okx-agent-task*'`,
|
|
25
|
-
`grep -r ~`). Home-wide scans hit permission-protected directories and
|
|
26
|
-
abort the run.
|
|
27
|
-
- If the skill cannot be found in any skill root, state that in your reply.
|
|
28
|
-
|
|
29
|
-
## Calling convention
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
node xmtp-tool.js <tool_name> '<args_json>'
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
Run from the current cwd — `xmtp-tool.js` is shipped here.
|
|
36
|
-
|
|
37
|
-
## Tool reference (12 tools)
|
|
38
|
-
|
|
39
|
-
| Tool | Args (JSON keys) | Semantic |
|
|
40
|
-
|---|---|---|
|
|
41
|
-
| `session_status` | `{}` | env → sessionKey / jobId / agentId |
|
|
42
|
-
| `xmtp_start_conversation` | `myAgentId`, `toAgentId`, `jobId`, `groupId?` | create XMTP group with peer |
|
|
43
|
-
| `xmtp_start_evaluate_conversation` | `myAgentId`, `jobId` | evaluator arbitration session (metadata only) |
|
|
44
|
-
| `xmtp_send` | `sessionKey`, `content`, `payload?` | sub → peer agent (**over XMTP**) |
|
|
45
|
-
| `xmtp_dispatch_user` | `content` | sub → user notify (no reply) |
|
|
46
|
-
| `xmtp_prompt_user` | `userContent`, `llmContent` | sub → user decision request (wait reply) |
|
|
47
|
-
| `xmtp_dispatch_session` | `sessionKey?`, `content` | sub → sub (**local, NOT XMTP**) |
|
|
48
|
-
| `xmtp_get_conversation_history` | `sessionKey`, `limit?` | read peer chat history |
|
|
49
|
-
| `xmtp_sessions_query` | `toAgentId?`, `myAgentId?`, `jobId?` | list sub-session keys |
|
|
50
|
-
| `xmtp_delete_conversation` | `sessionKey?`, `jobId?` | delete SQLite session metadata |
|
|
51
|
-
| `xmtp_file_upload` | `filePath`, `jobId`, `myAgentId`, `filename?`, `mimeType?` | upload attachment → fileKey |
|
|
52
|
-
| `xmtp_file_download` | `fileKey` (+ crypto metadata from source attachment message) | download attachment |
|
package/dist/workspace/CLAUDE.md
DELETED
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# OKX A2A Tools — Bridge Mapping
|
|
2
|
-
|
|
3
|
-
🛑 **HARD RULE — there are NO native `xmtp_*` / `session_status` tools in this environment.**
|
|
4
|
-
|
|
5
|
-
- **DO NOT** `ToolSearch` for any tool name listed below — the search will return empty / irrelevant results and waste ~10‑18s.
|
|
6
|
-
- **DO NOT** `Read` any `legacy-tool-bridge/SKILL.md` — the full mapping is already in the table below.
|
|
7
|
-
- When a playbook references `xmtp_send` / `xmtp_dispatch_user` / `xmtp_prompt_user` / `session_status` / etc., skip discovery and go straight to `node xmtp-tool.js <tool_name> '<args_json>'`.
|
|
8
|
-
|
|
9
|
-
## Skill files — try known locations first, never scan the whole disk
|
|
10
|
-
|
|
11
|
-
When a task prompt says "Read the okx-agent-task skill" (or names any other
|
|
12
|
-
OKX skill): if a Skill tool with that name is available, invoke it. Otherwise
|
|
13
|
-
try these paths in order — skills are usually installed via
|
|
14
|
-
`npx skills add`, whose default global root is `~/.agents/skills`:
|
|
15
|
-
|
|
16
|
-
```
|
|
17
|
-
./.agents/skills/<skill-name>/SKILL.md # project-level install
|
|
18
|
-
~/.agents/skills/<skill-name>/SKILL.md # global install (most common)
|
|
19
|
-
~/.claude/skills/<skill-name>/SKILL.md # host-specific directory
|
|
20
|
-
~/.codex/skills/<skill-name>/SKILL.md # host-specific directory
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
- If none of these exist, you may search — but only INSIDE the skill roots
|
|
24
|
-
above (e.g. `ls ~/.agents/skills/`), never across `$HOME` or the whole
|
|
25
|
-
filesystem (`find ~ -name SKILL.md`, `find / -path '*okx-agent-task*'`,
|
|
26
|
-
`grep -r ~`). Home-wide scans hit permission-protected directories and
|
|
27
|
-
abort the run.
|
|
28
|
-
- If the skill cannot be found in any skill root, state that in your reply.
|
|
29
|
-
|
|
30
|
-
## Calling convention
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
node xmtp-tool.js <tool_name> '<args_json>'
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Run from the current cwd — `xmtp-tool.js` is shipped here.
|
|
37
|
-
|
|
38
|
-
## Tool reference (12 tools)
|
|
39
|
-
|
|
40
|
-
| Tool | Args (JSON keys) | Semantic |
|
|
41
|
-
|---|---|---|
|
|
42
|
-
| `session_status` | `{}` | env → sessionKey / jobId / agentId |
|
|
43
|
-
| `xmtp_start_conversation` | `myAgentId`, `toAgentId`, `jobId`, `groupId?` | create XMTP group with peer |
|
|
44
|
-
| `xmtp_start_evaluate_conversation` | `myAgentId`, `jobId` | evaluator arbitration session (metadata only) |
|
|
45
|
-
| `xmtp_send` | `sessionKey`, `content`, `payload?` | sub → peer agent (**over XMTP**) |
|
|
46
|
-
| `xmtp_dispatch_user` | `content` | sub → user notify (no reply) |
|
|
47
|
-
| `xmtp_prompt_user` | `userContent`, `llmContent` | sub → user decision request (wait reply) |
|
|
48
|
-
| `xmtp_dispatch_session` | `sessionKey?`, `content` | sub → sub (**local, NOT XMTP**) |
|
|
49
|
-
| `xmtp_get_conversation_history` | `sessionKey`, `limit?` | read peer chat history |
|
|
50
|
-
| `xmtp_sessions_query` | `toAgentId?`, `myAgentId?`, `jobId?` | list sub-session keys |
|
|
51
|
-
| `xmtp_delete_conversation` | `sessionKey?`, `jobId?` | delete SQLite session metadata |
|
|
52
|
-
| `xmtp_file_upload` | `filePath`, `jobId`, `myAgentId`, `filename?`, `mimeType?` | upload attachment → fileKey |
|
|
53
|
-
| `xmtp_file_download` | `fileKey` (+ crypto metadata from source attachment message) | download attachment |
|