@xyagent/cli 1.0.0 → 1.1.1

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.
Files changed (47) hide show
  1. package/README.md +42 -0
  2. package/bin/agentlink +468 -86
  3. package/package.json +3 -3
  4. package/src/tunnel_service.mjs +17 -1
  5. package/src-ext/bin.mjs +12 -11
  6. package/src-ext/commands/agent.mjs +34 -0
  7. package/src-ext/commands/pair.mjs +122 -23
  8. package/src-ext/commands/service.mjs +1 -1
  9. package/src-ext/core/activeRuns.mjs +26 -9
  10. package/src-ext/core/defaultWorkspace.mjs +43 -13
  11. package/src-ext/core/defaultWorkspaceSync.mjs +20 -0
  12. package/src-ext/core/installationIdentity.mjs +94 -0
  13. package/src-ext/core/mcpRuntimeFanout.mjs +23 -1
  14. package/src-ext/core/pairCodeClient.mjs +48 -8
  15. package/src-ext/core/pairInventory.mjs +31 -6
  16. package/src-ext/core/relayWorker.mjs +21 -1
  17. package/src-ext/core/runtimeRegistry.mjs +180 -0
  18. package/src-ext/core/scanWorkspaces.mjs +163 -23
  19. package/src-ext/core/unifiedDispatchHandler.mjs +9 -2
  20. package/src-ext/postinstall.mjs +14 -0
  21. package/src-ext/runtime/_shared/bridgedSessionLedger.mjs +60 -0
  22. package/src-ext/runtime/_shared/claudeSchemaEvent.mjs +49 -0
  23. package/src-ext/runtime/_shared/headlessCliBridge.mjs +168 -0
  24. package/src-ext/runtime/_shared/jsonMcpConfigAdapter.mjs +70 -0
  25. package/src-ext/runtime/_shared/ndjsonProcess.mjs +141 -0
  26. package/src-ext/runtime/_shared/resolveWorkspaceCwd.mjs +47 -0
  27. package/src-ext/runtime/_shared/slashCommandRouter.mjs +10 -0
  28. package/src-ext/runtime/claude/handleRequest.mjs +15 -37
  29. package/src-ext/runtime/claude/stdoutParser.mjs +8 -3
  30. package/src-ext/runtime/codebuddy/index.mjs +41 -0
  31. package/src-ext/runtime/codex/handleRequest.mjs +13 -35
  32. package/src-ext/runtime/cursor/index.mjs +46 -0
  33. package/src-ext/runtime/cursor/mcpConfigAdapter.mjs +15 -0
  34. package/src-ext/runtime/deepagents/preflight.mjs +57 -0
  35. package/src-ext/runtime/hermes/envSetup.mjs +22 -8
  36. package/src-ext/runtime/hermes/gatewayManager.mjs +239 -3
  37. package/src-ext/runtime/hermes/handleRequest.mjs +13 -0
  38. package/src-ext/runtime/hermes/httpBackend.mjs +12 -1
  39. package/src-ext/runtime/hermes/index.mjs +1 -1
  40. package/src-ext/runtime/hermes/preflight.mjs +2 -1
  41. package/src-ext/runtime/kimi/index.mjs +100 -0
  42. package/src-ext/runtime/openclaw/workspaceContext.mjs +58 -0
  43. package/src-ext/runtime/opencode/index.mjs +48 -0
  44. package/src-ext/runtime/opencode/mcpConfigAdapter.mjs +15 -0
  45. package/src-ext/runtime/opencode/preflight.mjs +72 -0
  46. package/src-ext/runtime/qwen/index.mjs +42 -0
  47. package/src-ext/service/serviceManager.mjs +120 -42
package/README.md CHANGED
@@ -18,6 +18,33 @@
18
18
 
19
19
  ---
20
20
 
21
+ ## Debug 包本地联调
22
+
23
+ AgentLink Debug 选择「本地」后会调用 CLI 时传入内部参数
24
+ `--agentlink-home ~/.agentlink-debug`。CLI 会将该目录作为全部配对凭据和 runtime 服务状态的根目录，
25
+ 因此不会覆盖日常 `~/.agentlink` 的正式/测试配对。
26
+
27
+ 本地联调前先启动 Relay：
28
+
29
+ ```bash
30
+ cd /Users/zjd/cece/code/agentlink/go_relay
31
+ make local-up
32
+ ```
33
+
34
+ 然后在 Debug 包中选择「本地」、用本地验证码登录，并重新配对 runtime。不要手动把测试环境的
35
+ `config.json`、`ext-*-last.json` 或 token 复制到 `~/.agentlink-debug`；本地环境必须从空状态配对。
36
+ 配对成功后，可用以下命令查看隔离状态：
37
+
38
+ ```bash
39
+ agentlink status --agentlink-home "$HOME/.agentlink-debug" --json
40
+ agentlink service status --agentlink-home "$HOME/.agentlink-debug" --json
41
+ ```
42
+
43
+ `--agentlink-home` 是 Debug Desktop 的内部桥接参数，要求绝对路径，未写入常规帮助；正常手工使用 CLI
44
+ 继续使用默认 `~/.agentlink` 即可。
45
+
46
+ ---
47
+
21
48
  ## 1. 整体架构
22
49
 
23
50
  ```
@@ -104,6 +131,21 @@
104
131
 
105
132
  4 个 bridge 入口文件大小都 ≤ 800 行硬限，最大约 700 行。
106
133
 
134
+ #### runtime 集合分三层（取值合法 ≠ 命令支持）
135
+
136
+ 上表是**有 bridge 实现**的那一层。`opencode` / `deepagents` 加入枚举后，本仓存在三个语义不同的 runtime 集合，改代码前先认清在哪一层：
137
+
138
+ | 层 | 成员 | 含义 |
139
+ | --- | --- | --- |
140
+ | 已知枚举（6） | openclaw / hermes / claude / codex / **opencode** / **deepagents** | 参数解析层承认的取值。传这些值不会得到「must be one of ...」 |
141
+ | 本机探测集（5） | 已知枚举 − deepagents | 会去探测本机是否装了，并把结果上报 host-inventory。`deepagents` 没有任何本机探测手段，**不探测也就不谎报未安装** |
142
+ | 可操作集（4） | openclaw / hermes / claude / codex | 真有 pair / bridge / reset / service 实现，即上表四行 |
143
+
144
+ 由此得到两条别踩的线：
145
+
146
+ - `-r opencode` / `-r deepagents` 会**显式报错退出**（「取值合法但暂无实现」），绝不静默回落成 openclaw —— 否则配对结果会写进 openclaw 的凭证槽位，用户以为配的是别的 runtime。这与「取值非法」是两类失败，两条文案不得混用（测试有断言）。
147
+ - 命令用法里的取值串按**该命令实际支持的层**写，不是照抄已知枚举：`scan` 只支持 scan-capable 的 openclaw / hermes，`pair` / `bridge` 只列可操作集。新增 runtime 时逐处判断，别全局替换。
148
+
107
149
  ---
108
150
 
109
151
  ## 2. 代码结构