evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
package/dist/paths.js CHANGED
@@ -171,6 +171,17 @@ export function agentRelationDir(aid, peerKey) {
171
171
  export function agentRelationSharedDir(aid, peerKey) {
172
172
  return path.join(agentRelationDir(aid, peerKey), 'shared');
173
173
  }
174
+ /**
175
+ * Agent 级附件目录:所有收发附件的文件本体都在这里,按内容去重。
176
+ * 与关系无关,同一份文件发给多个对端只占一份磁盘。
177
+ */
178
+ export function agentAttachmentsDir(aid) {
179
+ return path.join(agentDir(aid), 'attachments');
180
+ }
181
+ /** 关系归属索引:每个对端一个 `<peerKey>.jsonl`,只记元数据不存文件。 */
182
+ export function agentAttachmentIndexDir(aid) {
183
+ return path.join(agentAttachmentsDir(aid), 'index');
184
+ }
174
185
  /** @deprecated Use agentRelationsDir instead */
175
186
  export function agentIdentitiesDir(aid) {
176
187
  return agentRelationsDir(aid);
@@ -460,7 +471,9 @@ function migrateFromAun() {
460
471
  }
461
472
  }
462
473
  copyDirIfMissing(path.join(oldRoot, 'CA'), path.join(newRoot, 'CA'));
463
- for (const f of ['.seed', '.device_id']) {
474
+ // `.device_id.hmac` is the SDK-written guard for `.device_id`; migrating the
475
+ // pair together avoids a rewrite under the destination root's key.
476
+ for (const f of ['.seed', '.device_id', '.device_id.hmac']) {
464
477
  copyFileIfMissing(path.join(oldRoot, f), path.join(newRoot, f));
465
478
  }
466
479
  }
@@ -575,3 +588,37 @@ export function consumeAsModeOverride() {
575
588
  catch { /* ignore */ }
576
589
  return value === 'dev' || value === 'install' ? value : null;
577
590
  }
591
+ // ── 历史记录中的可迁移路径 ────────────────────────────────────────────────
592
+ //
593
+ // `messages.jsonl` 会跟着 `$EVOLCORE_HOME` 一起搬迁(换机器、换盘符)。
594
+ // 里存绝对路径,搬完后全部失效。因此历史正文里统一写别名路径,
595
+ // 由模型按系统提示里注入的别名值展开——别名值每轮渲染,天然跟着当前安装走。
596
+ const RELATIONS_DIR_ALIAS = '$RELATIONS_DIR/';
597
+ const AGENT_DIR_ALIAS = '$AGENT_DIR/';
598
+ function toAliasPath(prefix, baseDir, absolutePath) {
599
+ if (!baseDir)
600
+ return null;
601
+ const relative = path.relative(path.resolve(baseDir), path.resolve(absolutePath));
602
+ if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
603
+ return null;
604
+ return prefix + relative.split(path.sep).join('/');
605
+ }
606
+ /**
607
+ * 附件落盘路径 → agent 级别名路径。
608
+ *
609
+ * 收发附件的文件本体统一放在 `$AGENT_DIR/attachments/` 下(按内容去重),
610
+ * 历史里记成 `$AGENT_DIR/attachments/<文件名>`;模型用 `[venue]` 段的
611
+ * AGENT_DIR 值展开,换机器/换盘符后仍然有效。
612
+ */
613
+ export function toAttachmentMarkedPath(selfAid, absolutePath) {
614
+ return toAliasPath(AGENT_DIR_ALIAS, agentDir(selfAid), absolutePath) ?? absolutePath;
615
+ }
616
+ /**
617
+ * 旧版附件路径 → 关系级别名路径。
618
+ *
619
+ * 升级前附件落在 `$RELATIONS_DIR/<peerKey>/attachments/`,历史里可能仍引用这些位置,
620
+ * 保留该转换供读取侧展开。
621
+ */
622
+ export function toRelationMarkedPath(selfAid, absolutePath) {
623
+ return toAliasPath(RELATIONS_DIR_ALIAS, agentRelationsDir(selfAid), absolutePath) ?? absolutePath;
624
+ }
@@ -0,0 +1,38 @@
1
+ import { PaymentError } from './protocol.js';
2
+ export const PAYMENT_HELP = `用法: ec pay request --spec-file <JSON文件>
3
+ ec pay status <request-id>
4
+ ec pay cancel <request-id>
5
+ ec pay verify <request-id>
6
+ ec pay refresh <request-id>
7
+ ec pay update <request-id> --spec-file <JSON文件>
8
+ ec pay complete <request-id> --event-id <event-id>
9
+
10
+ 可选 --format json;所有结果均为 JSON。仅当前 Owner 的 AUN 私聊托管任务可用。
11
+ request 上传二维码并发送付款 Action Card;verify/refresh 异步安排原任务。
12
+ update 提交待处理事件的订单核验及可选新码;complete 确认付款后的任务已处理。
13
+ 完整输入格式:kits/docs/evolcore/pay.md;遇到付款先加载 ec-pay 技能。`;
14
+ export function parsePaymentCommand(argv) {
15
+ const args = argv[0] === 'pay' ? argv.slice(1) : [...argv];
16
+ const format = args.indexOf('--format');
17
+ if (format >= 0) {
18
+ if (args[format + 1] !== 'json')
19
+ throw new PaymentError('INVALID_ARGUMENT', '--format only supports json');
20
+ args.splice(format, 2);
21
+ }
22
+ const [op, id, flag, value] = args;
23
+ if (op === 'request' && args.length === 3 && id === '--spec-file' && flag && !flag.startsWith('-')) {
24
+ return { operation: op, file: flag };
25
+ }
26
+ if (!id || !/^pay_[a-f0-9]{32}$/.test(id))
27
+ throw new PaymentError('INVALID_ARGUMENT', PAYMENT_HELP);
28
+ if (['status', 'cancel', 'verify', 'refresh'].includes(op) && args.length === 2) {
29
+ return { operation: op, requestId: id };
30
+ }
31
+ if (op === 'update' && args.length === 4 && flag === '--spec-file' && value && !value.startsWith('-')) {
32
+ return { operation: op, requestId: id, file: value };
33
+ }
34
+ if (op === 'complete' && args.length === 4 && flag === '--event-id' && /^payjob_[a-f0-9]{32}$/.test(value)) {
35
+ return { operation: op, requestId: id, eventId: value };
36
+ }
37
+ throw new PaymentError('INVALID_ARGUMENT', PAYMENT_HELP);
38
+ }
@@ -0,0 +1,136 @@
1
+ import { z } from 'zod';
2
+ export class PaymentError extends Error {
3
+ code;
4
+ constructor(code, message) {
5
+ super(message);
6
+ this.code = code;
7
+ this.name = 'PaymentError';
8
+ }
9
+ }
10
+ const text = z.string().trim().min(1).max(2000);
11
+ const timestamp = z.number().int().nonnegative().safe();
12
+ export const providerSchema = z.enum(['wechat', 'alipay']);
13
+ const evidenceSource = z.enum(['page_text', 'page_dom', 'qr_payload', 'inferred', 'unknown']);
14
+ const methodSchema = z.object({
15
+ provider: providerSchema,
16
+ availability: z.enum(['ready', 'requires_site_switch', 'unavailable', 'unknown']),
17
+ qr_ids: z.array(z.string().min(1).max(100)).max(4),
18
+ evidence: z.object({ source: evidenceSource, text: text.optional() }).strict(),
19
+ }).strict();
20
+ const qrSchema = z.object({
21
+ id: z.string().regex(/^[A-Za-z0-9_-]{1,100}$/),
22
+ attachment_index: z.number().int().min(0).max(3),
23
+ providers: z.array(providerSchema).min(1).max(2),
24
+ source: z.enum(['page_image', 'page_screenshot', 'page_dom']),
25
+ expires_at_ms: timestamp.nullable().default(null),
26
+ raw_payload: z.string().min(1).max(8192).optional(),
27
+ }).strict();
28
+ export const mediaSchema = z.object({
29
+ attachments: z.array(z.object({ file_path: z.string().min(1).max(4096) }).strict()).max(4),
30
+ method_options: z.array(methodSchema).max(2),
31
+ qr_codes: z.array(qrSchema).max(4),
32
+ }).strict();
33
+ export const factsSchema = z.object({
34
+ source: z.object({
35
+ origin: z.string().url().refine(value => {
36
+ const url = new URL(value);
37
+ return url.protocol === 'https:' && !url.username && !url.password && url.origin === value;
38
+ }, 'origin must be an HTTPS origin without credentials, path or query'),
39
+ order_id: text.optional(), purpose: text.optional(),
40
+ }).strict(),
41
+ product: z.object({ title: text, description: text.optional(), quantity: z.number().int().positive().safe().optional(),
42
+ image_attachment_index: z.number().int().min(0).max(3).optional() }).strict(),
43
+ merchant: z.object({ name: text, source: evidenceSource }).strict().optional(),
44
+ amount: z.object({ value_minor: z.number().int().nonnegative().safe().nullable(),
45
+ currency: z.string().regex(/^[A-Z]{3}$/).nullable(), source: evidenceSource }).strict(),
46
+ }).strict();
47
+ export const requestSchema = factsSchema.extend(mediaSchema.shape).extend({
48
+ idempotency_key: z.string().regex(/^[A-Za-z0-9_-]{1,128}$/).optional(),
49
+ expires_at_ms: timestamp.optional(),
50
+ order_expires_at_ms: timestamp.nullable().default(null),
51
+ }).strict();
52
+ export const verificationSchema = z.object({
53
+ order_state: z.enum(['pending', 'paid', 'failed', 'unknown']),
54
+ source: z.enum(['website_order', 'website_success_page', 'payment_api']),
55
+ checked_at_ms: timestamp,
56
+ evidence: text,
57
+ order_id: text.optional(),
58
+ }).strict();
59
+ export const updateSchema = z.object({
60
+ expected_state_version: z.number().int().positive().safe(),
61
+ event_id: z.string().regex(/^payjob_[a-f0-9]{32}$/),
62
+ verification: verificationSchema.optional(),
63
+ media: mediaSchema.optional(),
64
+ }).strict().refine(value => !!value.verification || !!value.media, 'update must include verification or media');
65
+ export function validateMedia(media, now) {
66
+ const ids = new Set(media.qr_codes.map(qr => qr.id));
67
+ if (ids.size !== media.qr_codes.length || new Set(media.method_options.map(m => m.provider)).size !== media.method_options.length) {
68
+ throw new PaymentError('INVALID_ARGUMENT', 'Duplicate payment method or QR id');
69
+ }
70
+ for (const qr of media.qr_codes) {
71
+ if (qr.attachment_index >= media.attachments.length || new Set(qr.providers).size !== qr.providers.length) {
72
+ throw new PaymentError('QR_INVALID', 'QR attachment or provider binding is invalid');
73
+ }
74
+ }
75
+ for (const method of media.method_options) {
76
+ if (method.availability !== 'ready' && method.qr_ids.length) {
77
+ throw new PaymentError('METHOD_NOT_READY', 'Only ready methods may bind QR codes');
78
+ }
79
+ if (method.availability === 'ready' && (!method.qr_ids.length
80
+ || method.evidence.source === 'inferred' || method.evidence.source === 'unknown')) {
81
+ throw new PaymentError('METHOD_NOT_READY', 'Ready methods require explicit evidence and a QR code');
82
+ }
83
+ for (const id of method.qr_ids) {
84
+ const qr = media.qr_codes.find(q => q.id === id);
85
+ if (!qr || !qr.providers.includes(method.provider) || qr.expires_at_ms !== null && qr.expires_at_ms <= now) {
86
+ throw new PaymentError('QR_INVALID', 'Payment method references an invalid or expired QR');
87
+ }
88
+ }
89
+ }
90
+ }
91
+ export function paymentActions(p, now) {
92
+ if (p.order_state === 'paid')
93
+ return [];
94
+ const actions = [];
95
+ const active = p.request_state === 'active' && p.expires_at_ms > now
96
+ && (p.order_expires_at_ms === null || p.order_expires_at_ms > now);
97
+ if (active && p.order_state === 'pending') {
98
+ for (const method of p.method_options) {
99
+ const name = method.provider === 'wechat' ? '微信' : '支付宝';
100
+ if (method.availability === 'ready' && method.qr_ids.some(id => p.qr_codes.some(q => q.id === id
101
+ && (q.expires_at_ms === null || q.expires_at_ms > now)))) {
102
+ actions.push({ label: `使用${name}付款`, value: `pay.open.${method.provider}`, behavior: 'reply', style: 'primary' });
103
+ }
104
+ else if (method.availability === 'requires_site_switch') {
105
+ actions.push({ label: `切换${name}`, value: `pay.select.${method.provider}`, behavior: 'reply' });
106
+ }
107
+ }
108
+ actions.push({ label: '重新获取二维码', value: 'pay.refresh', behavior: 'reply' });
109
+ }
110
+ if (p.order_state !== 'verification_pending')
111
+ actions.push({ label: '我已付款,请核验', value: 'pay.verify', behavior: 'reply' });
112
+ if (p.request_state === 'active')
113
+ actions.push({ label: '取消本次请求', value: 'pay.cancel', behavior: 'reply' });
114
+ return actions;
115
+ }
116
+ export function buildPaymentCard(p, attachments, threadId, now = Date.now()) {
117
+ const amount = p.amount.value_minor === null || p.amount.currency === null ? '金额待确认'
118
+ : new Intl.NumberFormat('zh-CN', { style: 'currency', currency: p.amount.currency }).format(p.amount.value_minor / 10 ** (new Intl.NumberFormat('zh-CN', { style: 'currency', currency: p.amount.currency })
119
+ .resolvedOptions().maximumFractionDigits ?? 2));
120
+ const state = p.order_state === 'paid' ? '已付款' : p.order_state === 'verification_pending' ? '正在核验订单'
121
+ : p.request_state !== 'active' ? ({ expired: '请求已过期', cancelled: '请求已取消', superseded: '请求已替代' })[p.request_state]
122
+ : p.order_state === 'unknown' ? '付款结果待核验' : p.order_state === 'failed' ? '网站订单失败' : '待付款';
123
+ const text = `${p.product.title} · ${amount} · ${state}\n网站:${p.source.origin}`
124
+ + (p.source.order_id ? `\n订单:${p.source.order_id}` : '')
125
+ + (p.source.purpose ? `\n用途:${p.source.purpose}` : '')
126
+ + `\n本次请求有效至:${new Date(p.expires_at_ms).toISOString()}\n付款结果以原网站订单核验为准。`;
127
+ return { type: 'action_card', card_kind: 'payment', title: p.product.title, text, blocking: false,
128
+ ...(threadId ? { thread_id: threadId } : {}), attachments, actions: paymentActions(p, now), payment: p };
129
+ }
130
+ export function isPaymentControlPayload(payload) {
131
+ if (!payload || typeof payload !== 'object' || Array.isArray(payload))
132
+ return false;
133
+ const value = payload;
134
+ return value.type === 'json' && typeof value.kind === 'string' && value.kind.startsWith('payment.')
135
+ || value.type === 'action_card_reply' && value.payment_action !== undefined;
136
+ }
@@ -0,0 +1,188 @@
1
+ import path from 'node:path';
2
+ import crypto from 'node:crypto';
3
+ import sharp from 'sharp';
4
+ import jsQR from 'jsqr';
5
+ import { agentDir } from '../paths.js';
6
+ import { readManagedLocalFile } from '../trigger/local-files.js';
7
+ import { currentContactBinding, sameContactBinding } from '../core/message/contact-admission.js';
8
+ import { PaymentError, isPaymentControlPayload } from './protocol.js';
9
+ import { PaymentStore } from './store.js';
10
+ import { PaymentService } from './service.js';
11
+ import { parsePaymentCommand } from './command.js';
12
+ import { sessionTopicThreadId } from '../core/thread/topic-id.js';
13
+ import { logger } from '../utils/logger.js';
14
+ const services = new Map();
15
+ export function paymentStore(aid) { return new PaymentStore(path.join(agentDir(aid), 'data', 'payments')); }
16
+ export async function consumePaymentInbound(selfAid, fromAid, payload, encrypted) {
17
+ const service = services.get(selfAid);
18
+ const value = payload && typeof payload === 'object' && !Array.isArray(payload) ? payload : undefined;
19
+ if (!value)
20
+ return false;
21
+ const ref = value.card_message_id;
22
+ const belongs = value.type === 'action_card_reply' && typeof ref === 'string' && ref.length <= 256
23
+ && !!paymentStore(selfAid).findCard(ref);
24
+ if (!belongs && !isPaymentControlPayload(payload))
25
+ return false;
26
+ if (!service)
27
+ return true; // Never leak payment controls into model input while runtime starts.
28
+ try {
29
+ return await service.inbound({ fromAid, payload: value, encrypted });
30
+ }
31
+ catch (error) {
32
+ logger.warn(`[Pay] Isolated payment control: ${error instanceof Error ? error.message : String(error)}`);
33
+ return true;
34
+ }
35
+ }
36
+ export async function preparePaymentMedia(media, scope, channel) {
37
+ const images = media.attachments.map(item => readManagedLocalFile(item.file_path, scope, 'attachment'));
38
+ const qrCodes = structuredClone(media.qr_codes);
39
+ // Validate every image and all codes before uploading any of them.
40
+ for (let index = 0; index < images.length; index++) {
41
+ const metadata = await sharp(images[index], { limitInputPixels: 16_000_000 }).metadata();
42
+ if (!['png', 'jpeg', 'webp'].includes(metadata.format ?? ''))
43
+ throw new PaymentError('QR_INVALID', 'Payment images must be PNG, JPEG or WebP');
44
+ const codes = qrCodes.filter(q => q.attachment_index === index);
45
+ if (codes.length) {
46
+ const { data, info } = await sharp(images[index], { limitInputPixels: 16_000_000 }).rotate().ensureAlpha().raw().toBuffer({ resolveWithObject: true });
47
+ const decoded = jsQR(new Uint8ClampedArray(data), info.width, info.height);
48
+ if (!decoded?.data || decoded.data.length > 8192)
49
+ throw new PaymentError('QR_INVALID', 'Payment QR could not be decoded; crop a clear code including its border');
50
+ for (const qr of codes) {
51
+ if (qr.raw_payload !== undefined && qr.raw_payload !== decoded.data)
52
+ throw new PaymentError('QR_INVALID', 'QR image and raw payload do not match');
53
+ qr.raw_payload = decoded.data;
54
+ }
55
+ }
56
+ }
57
+ const attachments = [];
58
+ for (let i = 0; i < images.length; i++)
59
+ attachments.push(await channel.uploadPaymentImage(images[i], path.basename(media.attachments[i].file_path)));
60
+ return { attachments, qr_codes: qrCodes };
61
+ }
62
+ export function registerPaymentRuntime(deps) {
63
+ const owned = new Map();
64
+ const channelFor = (aid) => {
65
+ const instance = deps.channelInstances.find(item => item.channelType === 'aun'
66
+ && item.channel.getAid?.() === aid);
67
+ if (!instance)
68
+ throw new PaymentError('CHANNEL_UNAVAILABLE', 'Agent AUN channel is unavailable');
69
+ return instance.channel;
70
+ };
71
+ const get = (aid) => {
72
+ const existing = owned.get(aid);
73
+ if (existing)
74
+ return existing;
75
+ const store = paymentStore(aid);
76
+ const service = new PaymentService({ store, currentBinding: () => currentContactBinding(aid),
77
+ prepareMedia: async () => { throw new PaymentError('NOT_AUTHORIZED', 'Media upload requires a delegated task'); },
78
+ send: async (record, delivery) => {
79
+ const result = await channelFor(aid).sendContentPayload(record.binding.owner_aid, delivery.payload, {
80
+ contentKind: delivery.kind === 'card' ? 'card' : 'custom',
81
+ dedupeKey: `payment:${record.payment.request_id}:${delivery.id}`,
82
+ context: { delivery: { chatType: 'private' }, ...(record.threadId ? { threadId: record.threadId } : {}),
83
+ metadata: { encrypted: record.encrypted, source: 'msg' }, sessionId: record.sessionId },
84
+ postSend: { type: 'register_payment_delivery', requestId: record.payment.request_id, deliveryId: delivery.id },
85
+ logText: delivery.payload.text ?? '[payment]',
86
+ });
87
+ if (result.status === 'permanent')
88
+ throw new PaymentError(result.code ?? 'DELIVERY_FAILED', result.error ?? 'Payment delivery failed');
89
+ return { messageId: result.messageId, queued: !!result.outboxId || result.queued };
90
+ },
91
+ enqueue: async (record, job) => {
92
+ const session = await deps.sessionManager.getSessionById(record.sessionId);
93
+ if (!session || session.deletedAt || session.selfAID !== aid || session.channelType !== 'aun'
94
+ || session.chatType !== 'private' || session.channelId !== record.binding.owner_aid
95
+ || sessionTopicThreadId(session) !== record.threadId
96
+ || !sameContactBinding(record.binding, currentContactBinding(aid))) {
97
+ throw new PaymentError('NOT_AUTHORIZED', 'Original payment task is no longer available');
98
+ }
99
+ const content = `[付款任务事件]\n请求:${record.payment.request_id}\n事件:${job.id}\n操作:${job.kind}\n`
100
+ + `请先加载 ec-pay 技能,再执行 ec pay status ${record.payment.request_id} 获取最新状态。`
101
+ + (job.kind === 'continue' ? '\n订单已核验付款。核对原任务,检查此前完成情况后继续后续步骤,避免重复购买或开通;完成后用 ec pay complete 确认事件。'
102
+ : '\n先核验原网站订单;切换或刷新必须确认原订单未付,不得再次下单。通过 ec pay update 提交事件结果。');
103
+ await deps.messageQueue.enqueuePersisted(session.id, {
104
+ channel: session.channel, channelType: 'aun', channelId: record.binding.owner_aid,
105
+ selfAID: aid, baseagent: session.baseagent, chatType: 'private', peerId: record.binding.owner_aid,
106
+ content, messageId: job.id, timestamp: job.createdAt, source: 'self-address',
107
+ encrypted: record.encrypted, threadId: record.threadId,
108
+ selfAddressedMeta: { noopSentinel: '__PAYMENT_TASK_NOOP__' },
109
+ replyContext: { delivery: { chatType: 'private' }, ...(record.threadId ? { threadId: record.threadId } : {}),
110
+ metadata: { encrypted: record.encrypted } },
111
+ }, session.projectPath, { interruptible: false, role: 'owner', agentName: aid,
112
+ sessionKeyField: session.sessionKey, selfAID: aid });
113
+ },
114
+ });
115
+ owned.set(aid, service);
116
+ services.set(aid, service);
117
+ return service;
118
+ };
119
+ deps.ipcServer.setPaymentExecutor(async (params) => {
120
+ try {
121
+ const command = parsePaymentCommand(params.argv);
122
+ const authorized = await deps.authorize(params, `ec.pay.${command.operation}`);
123
+ if (!authorized.ok)
124
+ return authorized;
125
+ const grant = authorized.grant;
126
+ const session = await deps.sessionManager.getSessionById(params.sessionId);
127
+ const binding = currentContactBinding(authorized.aid);
128
+ if (!session || !binding || grant.systemSession || grant.actorId !== binding.owner_aid
129
+ || grant.channelType !== 'aun' || grant.chatType !== 'private' || grant.peerKey !== `aun#${binding.owner_aid}`
130
+ || session.selfAID !== authorized.aid || session.channelId !== binding.owner_aid
131
+ || session.channelType !== 'aun' || session.chatType !== 'private') {
132
+ throw new PaymentError('NOT_AUTHORIZED', 'Payment commands require the current Owner AUN private conversation');
133
+ }
134
+ const origin = { binding, sessionId: session.id, threadId: sessionTopicThreadId(session),
135
+ encrypted: deps.sessionManager.getSessionEncrypt(session.id) === true };
136
+ const scope = { selfAid: authorized.aid, projectPath: session.projectPath,
137
+ sessionRuntimeDir: authorized.sessionRuntimeDir, cwd: session.projectPath };
138
+ const prepare = (media) => preparePaymentMedia(media, scope, channelFor(authorized.aid));
139
+ const service = get(authorized.aid);
140
+ const readSpec = () => {
141
+ const bytes = readManagedLocalFile(command.file, scope, 'attachment');
142
+ if (bytes.length > 64 * 1024)
143
+ throw new PaymentError('INVALID_ARGUMENT', 'Payment specification exceeds 64 KiB');
144
+ return JSON.parse(bytes.toString('utf8'));
145
+ };
146
+ if (command.operation === 'request')
147
+ return await service.request(origin, readSpec(), crypto.createHash('sha256').update(`${session.id}:${grant.messageId}:${command.file}`).digest('hex'), prepare);
148
+ if (command.operation === 'update')
149
+ return await service.update(origin, command.requestId, readSpec(), prepare);
150
+ if (command.operation === 'complete')
151
+ return await service.complete(origin, command.requestId, command.eventId);
152
+ return await service.command(origin, command.requestId, command.operation);
153
+ }
154
+ catch (error) {
155
+ return { ok: false, code: error.code ?? 'INVALID_ARGUMENT', error: error instanceof Error ? error.message : String(error) };
156
+ }
157
+ });
158
+ let reconciling = false;
159
+ const reconcile = async () => {
160
+ if (reconciling)
161
+ return;
162
+ reconciling = true;
163
+ try {
164
+ for (const item of deps.channelInstances) {
165
+ if (item.channelType !== 'aun')
166
+ continue;
167
+ const aid = item.channel.getAid?.();
168
+ if (aid) {
169
+ try {
170
+ await get(aid).reconcile();
171
+ }
172
+ catch (error) {
173
+ logger.warn(`[Pay] Reconcile pending: ${String(error)}`);
174
+ }
175
+ }
176
+ }
177
+ }
178
+ finally {
179
+ reconciling = false;
180
+ }
181
+ };
182
+ void reconcile();
183
+ const timer = setInterval(() => { void reconcile(); }, 15_000);
184
+ timer.unref();
185
+ return () => { clearInterval(timer); for (const [aid, service] of owned)
186
+ if (services.get(aid) === service)
187
+ services.delete(aid); };
188
+ }