@1agents/dsh-a2a 0.0.0-stage → 0.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 (144) hide show
  1. package/README.md +57 -2
  2. package/cordis.patch.yml +10 -0
  3. package/dist/approvals.js +50 -0
  4. package/dist/cli.js +32596 -0
  5. package/dist/executor.js +24896 -0
  6. package/dist/index.js +32595 -0
  7. package/dist/sdk-runtime.js +166 -0
  8. package/dist/server.js +32581 -0
  9. package/dist/shared/a2a/workbench-ui.js +186 -0
  10. package/dist/workbench-ui/app.css +453 -0
  11. package/dist/workbench-ui/app.js +13 -0
  12. package/dist/workbench-ui/chunk-23JHGYT3.js +1 -0
  13. package/dist/workbench-ui/chunk-3H6STGPV.js +1 -0
  14. package/dist/workbench-ui/chunk-3SNBBMGH.js +1 -0
  15. package/dist/workbench-ui/chunk-3XJZ6DIE.js +1 -0
  16. package/dist/workbench-ui/chunk-44KDLLKJ.js +1 -0
  17. package/dist/workbench-ui/chunk-46H7FU5Y.js +7 -0
  18. package/dist/workbench-ui/chunk-4N44QPL7.js +1 -0
  19. package/dist/workbench-ui/chunk-4YN4BS7I.js +1 -0
  20. package/dist/workbench-ui/chunk-53EG4IVQ.js +96 -0
  21. package/dist/workbench-ui/chunk-5FIPUNR4.js +1 -0
  22. package/dist/workbench-ui/chunk-6DWWYA6G.js +2 -0
  23. package/dist/workbench-ui/chunk-6FU3T633.js +99 -0
  24. package/dist/workbench-ui/chunk-6XKIHRA4.js +1 -0
  25. package/dist/workbench-ui/chunk-7GIX43Y5.js +1 -0
  26. package/dist/workbench-ui/chunk-7Q4WBGX6.js +4 -0
  27. package/dist/workbench-ui/chunk-A3BQM7HR.js +1 -0
  28. package/dist/workbench-ui/chunk-AFCFDDOP.js +24 -0
  29. package/dist/workbench-ui/chunk-AG67EUYD.js +89 -0
  30. package/dist/workbench-ui/chunk-AGJHMMTN.js +1 -0
  31. package/dist/workbench-ui/chunk-AO6JUBV6.js +41 -0
  32. package/dist/workbench-ui/chunk-AUSLTP43.js +72 -0
  33. package/dist/workbench-ui/chunk-AVZL46TT.js +1 -0
  34. package/dist/workbench-ui/chunk-AZRIGIV2.js +168 -0
  35. package/dist/workbench-ui/chunk-B2LIVH37.js +1 -0
  36. package/dist/workbench-ui/chunk-B7YX5TR5.js +1 -0
  37. package/dist/workbench-ui/chunk-BCB4X4XX.js +1 -0
  38. package/dist/workbench-ui/chunk-BCRQUL2A.js +88 -0
  39. package/dist/workbench-ui/chunk-BI6UHHQP.js +1 -0
  40. package/dist/workbench-ui/chunk-BLSLQ4AQ.js +120 -0
  41. package/dist/workbench-ui/chunk-C3QSRS6E.js +1 -0
  42. package/dist/workbench-ui/chunk-CK7M2PJ3.js +62 -0
  43. package/dist/workbench-ui/chunk-CM6LZ7TU.js +1 -0
  44. package/dist/workbench-ui/chunk-CP63H27F.js +36 -0
  45. package/dist/workbench-ui/chunk-CPUMMIS2.js +70 -0
  46. package/dist/workbench-ui/chunk-CSEIBI5U.js +2 -0
  47. package/dist/workbench-ui/chunk-CUS65DKZ.js +161 -0
  48. package/dist/workbench-ui/chunk-CVQY7TNC.js +1 -0
  49. package/dist/workbench-ui/chunk-D6S3XBIX.js +106 -0
  50. package/dist/workbench-ui/chunk-E253Y562.js +1 -0
  51. package/dist/workbench-ui/chunk-EADDJUDC.js +1 -0
  52. package/dist/workbench-ui/chunk-EBGJ3YXG.js +206 -0
  53. package/dist/workbench-ui/chunk-EKPVZ3WY.js +8 -0
  54. package/dist/workbench-ui/chunk-EQDCEAFY.js +1 -0
  55. package/dist/workbench-ui/chunk-ES3SSDJY.js +40 -0
  56. package/dist/workbench-ui/chunk-ESFD2H7N.js +231 -0
  57. package/dist/workbench-ui/chunk-FVOHPMS6.js +1 -0
  58. package/dist/workbench-ui/chunk-FXMQAGVT.js +1 -0
  59. package/dist/workbench-ui/chunk-GGTADRXD.js +24 -0
  60. package/dist/workbench-ui/chunk-GHIVPGNQ.js +1 -0
  61. package/dist/workbench-ui/chunk-GLU2YQV2.js +1 -0
  62. package/dist/workbench-ui/chunk-GOCKBYSM.js +1 -0
  63. package/dist/workbench-ui/chunk-H2KMMTJB.js +1 -0
  64. package/dist/workbench-ui/chunk-HGVLDNPP.js +39 -0
  65. package/dist/workbench-ui/chunk-HSAVC5GY.js +1 -0
  66. package/dist/workbench-ui/chunk-HSEAD2JH.js +1 -0
  67. package/dist/workbench-ui/chunk-HSIHOBTY.js +1 -0
  68. package/dist/workbench-ui/chunk-IZXOKUGG.js +67 -0
  69. package/dist/workbench-ui/chunk-JFT2LC2T.js +1 -0
  70. package/dist/workbench-ui/chunk-JHL3ZDYK.js +3 -0
  71. package/dist/workbench-ui/chunk-JMORLCZG.js +257 -0
  72. package/dist/workbench-ui/chunk-JR4SIX7A.js +1 -0
  73. package/dist/workbench-ui/chunk-K23HAGEH.js +30 -0
  74. package/dist/workbench-ui/chunk-K43JDCBH.js +1 -0
  75. package/dist/workbench-ui/chunk-KINKFJY7.js +1 -0
  76. package/dist/workbench-ui/chunk-KKQSA4LI.js +2 -0
  77. package/dist/workbench-ui/chunk-KOUZX3UX.js +1 -0
  78. package/dist/workbench-ui/chunk-KR4DRHW2.js +78 -0
  79. package/dist/workbench-ui/chunk-KT4DJNOR.js +1 -0
  80. package/dist/workbench-ui/chunk-KTPNKRRZ.js +292 -0
  81. package/dist/workbench-ui/chunk-LFHIPGSU.js +7 -0
  82. package/dist/workbench-ui/chunk-LWDL4HZB.js +125 -0
  83. package/dist/workbench-ui/chunk-MVYC3CY4.js +1 -0
  84. package/dist/workbench-ui/chunk-NWUPALCY.js +129 -0
  85. package/dist/workbench-ui/chunk-NY7C662Z.js +1 -0
  86. package/dist/workbench-ui/chunk-O76WTHWP.js +1 -0
  87. package/dist/workbench-ui/chunk-OTF7YHRE.js +162 -0
  88. package/dist/workbench-ui/chunk-P6TKKRKP.js +1 -0
  89. package/dist/workbench-ui/chunk-PFHOOWV3.js +1 -0
  90. package/dist/workbench-ui/chunk-PUQLANIM.js +1 -0
  91. package/dist/workbench-ui/chunk-PZCGBYVO.js +1 -0
  92. package/dist/workbench-ui/chunk-QOHUZGP4.js +1 -0
  93. package/dist/workbench-ui/chunk-QSEG3OFF.js +1 -0
  94. package/dist/workbench-ui/chunk-QYPOXZIA.js +84 -0
  95. package/dist/workbench-ui/chunk-R6SOF3JC.js +1 -0
  96. package/dist/workbench-ui/chunk-RCLOYU5F.js +1 -0
  97. package/dist/workbench-ui/chunk-RSRUP64S.js +1 -0
  98. package/dist/workbench-ui/chunk-RVAIT6JW.js +1 -0
  99. package/dist/workbench-ui/chunk-S2CCN3II.js +1 -0
  100. package/dist/workbench-ui/chunk-S2Q52W46.js +1 -0
  101. package/dist/workbench-ui/chunk-S2W5THJ5.js +1 -0
  102. package/dist/workbench-ui/chunk-S6ZQZNOX.js +1 -0
  103. package/dist/workbench-ui/chunk-S74PLMMS.js +1 -0
  104. package/dist/workbench-ui/chunk-S7C4HKEY.js +1 -0
  105. package/dist/workbench-ui/chunk-SDTB3Q65.js +1 -0
  106. package/dist/workbench-ui/chunk-SLPRGYUV.js +32 -0
  107. package/dist/workbench-ui/chunk-SQE76S5B.js +1 -0
  108. package/dist/workbench-ui/chunk-SSDZPVPW.js +1 -0
  109. package/dist/workbench-ui/chunk-SVI7DGIE.js +1 -0
  110. package/dist/workbench-ui/chunk-T6QKLZ4H.js +62 -0
  111. package/dist/workbench-ui/chunk-TJNRPTFL.js +1 -0
  112. package/dist/workbench-ui/chunk-TP6U4EDH.js +2 -0
  113. package/dist/workbench-ui/chunk-TYAAT3GQ.js +1 -0
  114. package/dist/workbench-ui/chunk-U6OCY4ZH.js +1 -0
  115. package/dist/workbench-ui/chunk-UAN3NLRF.js +1 -0
  116. package/dist/workbench-ui/chunk-UMLU3FIX.js +1 -0
  117. package/dist/workbench-ui/chunk-URIY2OTM.js +1 -0
  118. package/dist/workbench-ui/chunk-V2NUKAA7.js +38 -0
  119. package/dist/workbench-ui/chunk-V4QLL4TE.js +139 -0
  120. package/dist/workbench-ui/chunk-VASHXUK4.js +2 -0
  121. package/dist/workbench-ui/chunk-VJLIWNIU.js +1 -0
  122. package/dist/workbench-ui/chunk-VQNQFBID.js +1 -0
  123. package/dist/workbench-ui/chunk-VSIWU7XA.js +3 -0
  124. package/dist/workbench-ui/chunk-VSJASPUZ.js +321 -0
  125. package/dist/workbench-ui/chunk-VXPNUNUX.js +3 -0
  126. package/dist/workbench-ui/chunk-WBKLDCV6.js +1 -0
  127. package/dist/workbench-ui/chunk-WOKJM3FY.js +1 -0
  128. package/dist/workbench-ui/chunk-X3U3NA3X.js +34 -0
  129. package/dist/workbench-ui/chunk-XBYU7M4J.js +1 -0
  130. package/dist/workbench-ui/chunk-XBZAO4ID.js +10 -0
  131. package/dist/workbench-ui/chunk-XLLPZ2WO.js +1 -0
  132. package/dist/workbench-ui/chunk-YFVL4NJL.js +1 -0
  133. package/dist/workbench-ui/chunk-YRFQENM4.js +1 -0
  134. package/dist/workbench-ui/chunk-YUADQVB2.js +1 -0
  135. package/dist/workbench-ui/chunk-Z3TCAKM5.js +1 -0
  136. package/dist/workbench-ui/chunk-Z6QR6FRE.js +10 -0
  137. package/dist/workbench-ui/chunk-ZJPSORPP.js +3 -0
  138. package/dist/workbench-ui/chunk-ZLGCSTR2.js +15 -0
  139. package/dist/workbench-ui/chunk-ZLR4SG5X.js +1 -0
  140. package/dist/workbench-ui/chunk-ZND3TTGF.js +1 -0
  141. package/dist/workbench-ui/chunk-ZOP3ZYH7.js +2 -0
  142. package/dist/workbench-ui/index.html +14 -0
  143. package/dist/workbench.js +222 -0
  144. package/package.json +33 -4
package/README.md CHANGED
@@ -1,3 +1,58 @@
1
- # Temporary Holding Version
1
+ # @1agents/dsh-a2a
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 独立的 A2A HTTP 服务,仅调用已安装的 DSH headless runtime。它不依赖 `@1agents/dsh-acp`,不连接 ACP 端口,不注册 ACP preset,不管理 ACP 进程。
4
+
5
+ ```sh
6
+ dsh-a2a ./dsh-a2a.local.json
7
+ ```
8
+
9
+ 配置示例(令牌通过 `DSH_A2A_TOKEN` 环境变量提供):
10
+
11
+ ```json
12
+ {
13
+ "host": "127.0.0.1",
14
+ "port": 3080,
15
+ "publicUrl": "http://127.0.0.1:3080",
16
+ "stateDirectory": "/absolute/path/to/.1agents/state/dsh-a2a",
17
+ "runtime": {
18
+ "command": "dsh",
19
+ "args": ["--profile", "headless"]
20
+ },
21
+ "workbench": {
22
+ "url": "http://127.0.0.1:36814",
23
+ "token": "<gateway-workbench-token>",
24
+ "pageRelaySecret": "<gateway-workbench-page-relay-secret>"
25
+ }
26
+ }
27
+ ```
28
+
29
+ 服务在自己的端口提供 `/.well-known/agent-card.json` 和 `/a2a`。DSH 插件模式通过 Cordis effect 管理相同服务的生命周期;只应由一个实例启动服务,其他客户端连接其 A2A 地址。`publicUrl` 仅描述对外地址,监听由 `host` 和 `port` 决定。
30
+
31
+ 运行环境须安装支持 `--json`、`--session-id`、`--approval-policy never` 的 DSH headless。源码契约参考本机 DSH 0.2.2-rc.2。`runtime.command` 和 `runtime.args` 是管理员配置的可执行文件和参数数组,不经过 shell;可以显式指向安装版的命令入口。模型、工具、权限和凭据由 headless profile 配置,不继承 Web/Desktop 的全部设置。默认 headless 不读取 GUI 的保存登录,需按 DSH 官方配置启用所需认证。
32
+
33
+ 每次执行启动一个 headless 进程,最终回执和退出码同时成功才报告完成;后续任务通过持久化 runtime session ID 续跑。A2A 返回的是服务自己的稳定 session ID,运行记录保存对应 DSH ID。崩溃、取消或缺少 final 回执会标记结果不确定,阻止静默重发;需人工检查运行记录和 DSH 会话再恢复。
34
+
35
+ 本版本只接受 headless 固定 composition(省略 agentPreset 或使用 standard);不支持任意 preset、逐任务模型选择、ACP 会话删除和原 Web 工作台接管。默认 headless 模式由 `--approval-policy never` 拒绝需要审批的调用;需要交互式执行审批时使用下述 SDK 模式。Web 工作台迁移到本服务的 `/workbench/ui`(默认 `http://127.0.0.1:3080/workbench/ui`)。使用 `DSH_A2A_TOKEN` 登录,服务端通过 `workbench.url` 转发任务、聊天、产物与审核 API;网关凭据不会发送到浏览器。`pageRelaySecret` 必须与网关一致,才能提交发布、验收和继续任务等人工决定。任务账本仍由网关管理,本包不另建一套账本。未配置网关时可以加载页面和登录,但业务 API 返回配置缺失。原来的父级 DSH GUI 接管入口与 MCP 回传仍不可用。
36
+
37
+ A2A 协议、持久化任务和预检在构建阶段复用 `@1agents/acp-service` 的宿主无关实现,并打包进本包 dist。发布包没有 `@1agents/acp-service` 依赖,不会安装或启动 ACP 服务。
38
+
39
+ 交互式执行审批配置:
40
+
41
+ ```json
42
+ {
43
+ "runtime": {
44
+ "mode": "sdk",
45
+ "command": "dsh",
46
+ "args": ["--profile", "sdk"],
47
+ "permissionMode": "workspace-write",
48
+ "provider": "<configured-provider>",
49
+ "model": "<configured-model>"
50
+ }
51
+ }
52
+ ```
53
+
54
+ SDK 模式使用 DSH 原生 JSON-RPC,初始化启用 `approvalRequests`,不使用 ACP。runtime 的权限策略应允许 ask(never 会在发送审批前拒绝)。A2A 任务须由网关携带 `metadata.1agents.execution` 的 jobId/attemptId,且配置 workbench.url/token。审批以 permission 过程请求展示在现有工作台,浏览器原有回答 API 决定批准或拒绝;批准仅授予 allowed-once。缺少任务绑定、请求过期、网关失败、执行取消或连接中断不会放行;取消尽力写回网关。子 Agent 的审批当前拒绝为 cancelled,避免未验证父子关系时错绑任务。SDK 会话与 headless 会话的 profile 不同,应使用独立 stateDirectory,禁止直接切换既有会话。
55
+
56
+ SDK 每轮等待 session/wait 和精确根会话的 turn/end,再关闭 runtime;恢复使用 session/resume。原生问答、计划审核、DSH GUI 接管不在本次执行审批接入范围。
57
+
58
+ 本地验收:10 项自动测试通过;在 DSH 0.2.2-rc.2 上通过真实 Web 页面登录、真实 Grok SDK 模型执行、工作区外写入审批与浏览器“允许本次”回传,文件内容核验通过;浏览器拒绝后模型停止,拒绝目标文件未创建。独立 tarball 从 npm 公共依赖干净安装后,agent card、工作台 HTML 和脚本可访问。验收同时修复后台标签首次不加载任务的问题。Grok Web 插件采用延迟注册时,SDK composition 须等待适配器就绪后再 initialize。尚未配置系统常驻启动。
@@ -0,0 +1,10 @@
1
+ - id: oneagents-dsh-a2a
2
+ name: '@1agents/dsh-a2a'
3
+ config:
4
+ host: 127.0.0.1
5
+ port: 3080
6
+ publicUrl: http://127.0.0.1:3080
7
+ tokenEnv: DSH_A2A_TOKEN
8
+ runtime:
9
+ command: dsh
10
+ args: ['--profile', 'headless']
@@ -0,0 +1,50 @@
1
+ // src/approvals.js
2
+ import { randomUUID } from "node:crypto";
3
+ import { setTimeout as delay } from "node:timers/promises";
4
+ async function requestApproval(workbench, execution, sessionId, params, signal) {
5
+ if (!workbench?.url || !execution?.jobId || !execution?.attemptId) return { outcome: "cancelled" };
6
+ const origin = new URL(workbench.url).origin;
7
+ const headers = { "Content-Type": "application/json", ...workbench.token ? { Authorization: `Bearer ${workbench.token}` } : {} };
8
+ const requestId = `prc-${randomUUID().replaceAll("-", "")}`;
9
+ const path = `/workbench/tasks/${encodeURIComponent(execution.jobId)}/process-requests`;
10
+ const send = async (suffix, method, body, requestSignal = signal) => {
11
+ const response = await fetch(new URL(path + suffix, origin), {
12
+ method,
13
+ headers,
14
+ signal: requestSignal,
15
+ redirect: "error",
16
+ ...body ? { body: JSON.stringify(body) } : {}
17
+ });
18
+ if (!response.ok) throw new Error(`Approval gateway returned ${response.status}`);
19
+ return response.json();
20
+ };
21
+ try {
22
+ const opened = await send("", "POST", {
23
+ requestId,
24
+ jobId: execution.jobId,
25
+ attemptId: execution.attemptId,
26
+ sessionId,
27
+ kind: "permission",
28
+ toolTitle: String(params.toolName ?? "DSH operation").slice(0, 500),
29
+ toolDetail: String(params.reason ?? "").slice(0, 16384)
30
+ });
31
+ if (opened.requestId !== requestId) throw new Error("Approval receipt identity mismatch");
32
+ for (; ; ) {
33
+ signal.throwIfAborted();
34
+ const view = await send(`/${requestId}`, "GET");
35
+ if (view.requestId !== requestId || view.jobId !== execution.jobId) throw new Error("Approval identity mismatch");
36
+ if (view.status === "answered") return { outcome: view.answer?.outcome === "approved" ? "allowed-once" : view.answer?.outcome === "rejected" ? "rejected" : "cancelled" };
37
+ if (view.status !== "pending" || !Number.isFinite(Date.parse(view.deadlineAt)) || Date.parse(view.deadlineAt) <= Date.now()) break;
38
+ await delay(workbench.pollMs ?? 200, void 0, { signal });
39
+ }
40
+ } catch {
41
+ }
42
+ try {
43
+ await send(`/${requestId}/answers`, "POST", { clientRequestId: `cancel:${requestId}`, outcome: "cancelled" }, AbortSignal.timeout(5e3));
44
+ } catch {
45
+ }
46
+ return { outcome: "cancelled" };
47
+ }
48
+ export {
49
+ requestApproval
50
+ };