evolcore 0.0.49 → 0.0.51

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 (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. 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
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -2,6 +2,113 @@ import crypto from 'crypto';
2
2
  import fs from 'fs';
3
3
  import path from 'path';
4
4
  import { formatSize } from '../../utils/media-cache.js';
5
+ export const MAX_WIDGET_HTML_BYTES = 1024 * 1024;
6
+ export const MAX_WIDGET_VALUES_BYTES = 64 * 1024;
7
+ /** Shared browser runtime injected into uploaded WidgetCard HTML, never generated per business field. */
8
+ export const WIDGET_CARD_FORM_SCRIPT = String.raw `(() => {
9
+ 'use strict';
10
+ let sending = false;
11
+ const forbidden = new Set(['__proto__', 'prototype', 'constructor']);
12
+ const formOf = () => {
13
+ const selected = document.querySelectorAll('form[data-widget-form]');
14
+ const forms = selected.length ? selected : document.forms;
15
+ if (forms.length !== 1) throw new Error('WidgetCard requires one form or one form[data-widget-form].');
16
+ return forms[0];
17
+ };
18
+ const collect = (form = formOf()) => {
19
+ if (!form.reportValidity()) throw new Error('Please complete the required fields.');
20
+ const entries = new FormData(form);
21
+ const groups = new Map();
22
+ for (const control of form.elements) {
23
+ if (!control.name || control.matches(':disabled') || !['INPUT', 'SELECT', 'TEXTAREA'].includes(control.tagName)) continue;
24
+ if (['submit', 'button', 'reset', 'image'].includes(control.type)) continue;
25
+ if (forbidden.has(control.name)) throw new Error('Reserved field name: ' + control.name);
26
+ if (control.type === 'file') throw new Error('File inputs are not supported by WidgetCard v1.');
27
+ if (!groups.has(control.name)) groups.set(control.name, []);
28
+ groups.get(control.name).push(control);
29
+ }
30
+ const values = Object.create(null);
31
+ for (const [name, controls] of groups) {
32
+ const first = controls[0];
33
+ const declared = first.dataset.widgetType;
34
+ if (controls.some(c => c.dataset.widgetType !== declared)) throw new Error('Conflicting field types: ' + name);
35
+ const checkboxes = controls.every(c => c.type === 'checkbox');
36
+ const radio = controls.every(c => c.type === 'radio');
37
+ const array = declared === 'array' || first.multiple || (checkboxes && controls.length > 1);
38
+ const boolean = declared === 'boolean' || (checkboxes && controls.length === 1 && !array);
39
+ if (declared && !['string', 'number', 'boolean', 'array'].includes(declared)) throw new Error('Unknown field type: ' + name);
40
+ if (boolean && (!checkboxes || controls.length !== 1)) throw new Error('Boolean fields require one checkbox: ' + name);
41
+ if (controls.length > 1 && !array && !radio) throw new Error('Repeated fields must declare array type: ' + name);
42
+ const raw = entries.getAll(name);
43
+ if (raw.some(v => typeof v !== 'string')) throw new Error('Only JSON values are supported.');
44
+ const itemType = first.dataset.widgetItemType || 'string';
45
+ if (array && !['string', 'number'].includes(itemType)) throw new Error('Invalid array item type: ' + name);
46
+ const numeric = declared === 'number' || (!declared && first.type === 'number');
47
+ const convert = (value, number) => {
48
+ if (!number) return value;
49
+ if (value.trim() === '') return null;
50
+ const result = Number(value);
51
+ if (!Number.isFinite(result)) throw new Error('Invalid number: ' + name);
52
+ return result;
53
+ };
54
+ values[name] = boolean ? first.checked : array ? raw.map(v => convert(v, itemType === 'number'))
55
+ : raw.length ? convert(raw[0], numeric) : null;
56
+ }
57
+ if (new TextEncoder().encode(JSON.stringify(values)).length > 65536) throw new Error('Form result exceeds 64 KiB.');
58
+ return values;
59
+ };
60
+ const feedback = (form, text) => {
61
+ let status = form.querySelector('[data-widget-status]');
62
+ if (!status) {
63
+ status = document.createElement('p');
64
+ status.dataset.widgetStatus = '';
65
+ status.setAttribute('role', 'status');
66
+ form.append(status);
67
+ }
68
+ status.textContent = text;
69
+ };
70
+ const send = async action => {
71
+ if (sending) return;
72
+ const form = formOf();
73
+ try {
74
+ const values = action === 'submit' ? collect(form) : undefined;
75
+ const bridge = window.EvolWidgetBridge;
76
+ if (!bridge || typeof bridge.postMessage !== 'function') throw new Error('Open this form in a WidgetCard-capable EvolApp.');
77
+ sending = true;
78
+ feedback(form, 'Sending…');
79
+ const result = await bridge.postMessage(JSON.stringify({ action, ...(values ? { values } : {}) }));
80
+ if (!result || result.ok !== true) throw new Error(result && result.error || 'The App did not confirm message delivery.');
81
+ feedback(form, 'Sent.');
82
+ } catch (error) {
83
+ sending = false;
84
+ feedback(form, error.message || String(error));
85
+ form.dispatchEvent(new CustomEvent('widget:error', { detail: { message: error.message || String(error) } }));
86
+ }
87
+ };
88
+ window.EvolWidget = Object.freeze({ collect, submit: () => send('submit'), cancel: () => send('cancel'),
89
+ retry: () => { sending = false; } });
90
+ document.addEventListener('submit', event => {
91
+ if (event.target !== formOf()) return;
92
+ event.preventDefault();
93
+ void send('submit');
94
+ });
95
+ document.addEventListener('click', event => {
96
+ if (event.target.closest('[data-widget-cancel]')) { event.preventDefault(); void send('cancel'); }
97
+ });
98
+ })();`;
99
+ export function prepareWidgetHtml(data, filename) {
100
+ if (!/\.html?$/i.test(filename))
101
+ throw new Error('WidgetCard requires an HTML file');
102
+ if (data.length > MAX_WIDGET_HTML_BYTES)
103
+ throw new Error('WidgetCard HTML exceeds 1 MiB');
104
+ const html = new TextDecoder('utf-8', { fatal: true }).decode(data);
105
+ if (!html.trim() || html.includes('\0') || !/<form\b/i.test(html)) {
106
+ throw new Error('WidgetCard requires nonempty UTF-8 HTML containing a form');
107
+ }
108
+ if (/data-evol-widget-runtime/i.test(html))
109
+ throw new Error('WidgetCard HTML already contains the injected runtime');
110
+ return Buffer.from(`${html}\n<script data-evol-widget-runtime>${WIDGET_CARD_FORM_SCRIPT}</script>\n`, 'utf8');
111
+ }
5
112
  const EXT_TYPE_MAP = {
6
113
  '.png': 'image', '.jpg': 'image', '.jpeg': 'image',
7
114
  '.gif': 'image', '.webp': 'image', '.svg': 'image',
@@ -25,7 +132,7 @@ export function inferPayloadType(filename) {
25
132
  return EXT_TYPE_MAP[ext] ?? 'file';
26
133
  }
27
134
  export function isValidPayloadType(value) {
28
- return value === 'image' || value === 'video' || value === 'voice' || value === 'file';
135
+ return value === 'image' || value === 'video' || value === 'voice' || value === 'file' || value === 'widget_card';
29
136
  }
30
137
  /** 单次上传最大大小(与 daemon sendFile 和 Menu file fetch 一致)。 */
31
138
  export const MAX_AUN_ATTACHMENT_SIZE = 256 * 1024 * 1024;
@@ -43,8 +150,17 @@ export async function uploadBufferAndBuildPayload(conn, ownerAid, data, filename
43
150
  if (data.length > MAX_AUN_ATTACHMENT_SIZE) {
44
151
  throw new Error(`文件过大 (${formatSize(data.length)}, 上限 ${formatSize(MAX_AUN_ATTACHMENT_SIZE)}): ${displayFilename}`);
45
152
  }
153
+ if (opts?.as && !isValidPayloadType(opts.as)) {
154
+ throw new Error(`--as 必须是 image|video|voice|file|widget_card,收到: ${opts.as}`);
155
+ }
156
+ if (opts?.as === 'widget_card') {
157
+ if (opts.contentType && !/^text\/html(?:\s*;|$)/i.test(opts.contentType)) {
158
+ throw new Error('WidgetCard content type must be text/html');
159
+ }
160
+ data = prepareWidgetHtml(data, displayFilename);
161
+ }
46
162
  const sha256 = crypto.createHash('sha256').update(data).digest('hex');
47
- const explicitContentType = opts?.contentType?.trim() || undefined;
163
+ const explicitContentType = opts?.as === 'widget_card' ? 'text/html' : opts?.contentType?.trim() || undefined;
48
164
  // Storage keys have a narrower character set than local filenames. Keep the
49
165
  // original basename in the attachment; only the opaque storage key is sanitized.
50
166
  const storageFilename = displayFilename.replace(/[^A-Za-z0-9._-]/g, '_');
@@ -87,7 +203,7 @@ export async function uploadBufferAndBuildPayload(conn, ownerAid, data, filename
87
203
  let type;
88
204
  if (opts?.as) {
89
205
  if (!isValidPayloadType(opts.as)) {
90
- throw new Error(`--as 必须是 image|video|voice|file,收到: ${opts.as}`);
206
+ throw new Error(`--as 必须是 image|video|voice|file|widget_card,收到: ${opts.as}`);
91
207
  }
92
208
  type = opts.as;
93
209
  }
@@ -104,6 +220,10 @@ export async function uploadBufferAndBuildPayload(conn, ownerAid, data, filename
104
220
  payload.text = `📎 ${displayFilename} (${formatSize(total)})`;
105
221
  if (type === 'voice' && opts?.transcript)
106
222
  payload.transcript = opts.transcript;
223
+ if (type === 'widget_card') {
224
+ payload.title = opts?.title?.trim() || displayFilename;
225
+ payload.text = opts?.text || '请在支持 WidgetCard 的 EvolApp 中打开并填写表单。';
226
+ }
107
227
  return { payload, type, attachment };
108
228
  }
109
229
  /**
@@ -117,6 +237,9 @@ export async function uploadFileAndBuildPayload(conn, ownerAid, filePath, opts)
117
237
  throw new Error(`文件不存在: ${absPath}`);
118
238
  }
119
239
  const stat = fs.statSync(absPath);
240
+ if (opts?.as === 'widget_card' && stat.size > MAX_WIDGET_HTML_BYTES) {
241
+ throw new Error('WidgetCard HTML exceeds 1 MiB');
242
+ }
120
243
  if (stat.size === 0) {
121
244
  throw new Error(`文件为空: ${absPath}`);
122
245
  }
@@ -21,7 +21,7 @@ import { ServiceProxyClient, EndpointPolicy } from '@agentunion/fastaun';
21
21
  import { DEFAULT_ECWEB_PROXY_VISIBILITY } from '../config/daemon-services.js';
22
22
  import { resolvePaths } from '../paths.js';
23
23
  import { logger } from '../utils/logger.js';
24
- import { parseEcwebInstanceRecord } from '../contracts/ecweb-instance.js';
24
+ import { parseEcwebInstanceRecord } from '../ecweb/contracts/ecweb-instance.js';
25
25
  import { getProcessStartTimeAsync, startTimeMatches } from '../utils/process-introspect.js';
26
26
  const LOG = '[ServiceProxy]';
27
27
  const CONTROL_CONNECTION_INTERVAL_MS = 250;
@@ -1,9 +1,251 @@
1
1
  export { storageUpload, storageUploadBuffer, storageLs, storageRm, storageQuota } from './client.js';
2
2
  export { storageDownload, storageGetByShare } from './download.js';
3
3
  import { isValidAid } from '../aid/validation.js';
4
+ import fs from 'node:fs';
5
+ import path from 'node:path';
6
+ import { createHash } from 'node:crypto';
7
+ import { StorageVFS } from '@agentunion/fastaun';
8
+ import { atomicWriteJson, withFileLock } from '../../utils/atomic-write.js';
9
+ /** Shared CLI/managed grammar, using the Storage RPC field names for structured ACL entries. */
10
+ export function parseStorageAcl(value, remove, options = {}) {
11
+ if (value.length > 128 * 1024)
12
+ throw new Error('ACL entry is too large');
13
+ const object = (input, keys) => {
14
+ if (!input || typeof input !== 'object' || Array.isArray(input)
15
+ || Object.keys(input).some(key => !keys.includes(key)))
16
+ throw new Error('Invalid or unknown ACL field');
17
+ return input;
18
+ };
19
+ let input;
20
+ if (value.trim().startsWith('{')) {
21
+ input = object(JSON.parse(value), remove ? ['grantee_aid', 'grantee_aids', 'subject']
22
+ : ['grantee_aid', 'grantee_aids', 'subject', 'perms', 'expires_at', 'max_uses']);
23
+ }
24
+ else {
25
+ const parts = value.split(':');
26
+ if (parts[0] !== 'aid' || parts.length !== (remove ? 2 : 3)) {
27
+ throw new Error('ACL entry must use aid:<AID>[:<perms>] or a JSON object');
28
+ }
29
+ input = { grantee_aid: parts[1], ...(!remove ? { perms: parts[2] } : {}) };
30
+ }
31
+ const selectors = ['grantee_aid', 'grantee_aids', 'subject'].filter(key => key in input);
32
+ if (selectors.length !== 1)
33
+ throw new Error('Exactly one ACL subject or AID selector is required');
34
+ const aid = (item) => {
35
+ if (typeof item !== 'string' || !isValidAid(item))
36
+ throw new Error('Invalid ACL AID');
37
+ return item;
38
+ };
39
+ const result = {};
40
+ if ('grantee_aid' in input)
41
+ result.grantee_aid = aid(input.grantee_aid);
42
+ if ('grantee_aids' in input) {
43
+ if (!Array.isArray(input.grantee_aids) || !input.grantee_aids.length)
44
+ throw new Error('Non-empty ACL AID list required');
45
+ result.grantee_aids = [...new Set(input.grantee_aids.map(aid))];
46
+ }
47
+ if ('subject' in input) {
48
+ const subject = object(input.subject, ['ownership', 'card']);
49
+ const ownership = object(subject.ownership, ['owner_aid', 'scope']);
50
+ const scope = ownership.scope === undefined ? 'direct' : ownership.scope;
51
+ if (scope !== 'direct' && scope !== 'descendants')
52
+ throw new Error('Invalid ACL Ownership scope');
53
+ result.subject = { ownership: { owner_aid: aid(ownership.owner_aid), scope } };
54
+ if ('card' in subject) {
55
+ const card = object(subject.card, ['type', 'exttype']);
56
+ result.subject.card = {};
57
+ for (const key of ['type', 'exttype'])
58
+ if (key in card) {
59
+ const items = card[key];
60
+ if (!Array.isArray(items) || !items.length
61
+ || items.some(item => typeof item !== 'string' || !item.trim()))
62
+ throw new Error('Invalid ACL card condition');
63
+ result.subject.card[key] = [...new Set(items.map(item => item.trim()))].sort();
64
+ }
65
+ if (!Object.keys(result.subject.card).length)
66
+ delete result.subject.card;
67
+ }
68
+ }
69
+ if (remove && (options.expires !== undefined || options.maxUses !== undefined)) {
70
+ throw new Error('ACL removal does not accept expiry or usage limits');
71
+ }
72
+ if (!remove) {
73
+ if (typeof input.perms !== 'string' || !/^[rwx]+$/.test(input.perms))
74
+ throw new Error('ACL permissions must combine r, w, x');
75
+ result.perms = [...'rwx'].filter(bit => input.perms.includes(bit)).join('');
76
+ for (const [field, flag] of [['expires_at', 'expires'], ['max_uses', 'maxUses']]) {
77
+ let number = input[field];
78
+ if (options[flag] !== undefined) {
79
+ if (field in input)
80
+ throw new Error('ACL JSON and flags cannot both specify ' + field);
81
+ const text = options[flag].trim();
82
+ number = /^\d+$/.test(text) ? Number(text)
83
+ : field === 'expires_at' && /^\d{4}-\d{2}-\d{2}(?:T.*)?$/.test(text) ? Date.parse(text) / 1000 : NaN;
84
+ }
85
+ if (number !== undefined) {
86
+ if (!Number.isSafeInteger(number) || number < 0)
87
+ throw new Error('Invalid ACL ' + field);
88
+ result[field] = number;
89
+ }
90
+ }
91
+ }
92
+ return result;
93
+ }
94
+ /** Execute a general ACL mutation and confirm that the returned resource and rule match the request. */
95
+ export async function executeStorageAcl(client, ownerAid, remotePath, entry, remove) {
96
+ const acl = parseStorageAcl(JSON.stringify(entry), remove);
97
+ const key = path.posix.normalize(remotePath.replace(/\\/g, '/').trim()).replace(/^\/+|\/+$/g, '');
98
+ const storage = new StorageVFS(client);
99
+ const selector = {
100
+ owner: ownerAid, granteeAid: acl.grantee_aid, granteeAids: acl.grantee_aids,
101
+ subject: acl.subject ? {
102
+ ownership: { ownerAid: acl.subject.ownership.owner_aid, scope: acl.subject.ownership.scope },
103
+ card: acl.subject.card,
104
+ } : undefined,
105
+ };
106
+ const result = remove ? await storage.removeAcl(remotePath, selector)
107
+ : await storage.setAcl(remotePath, { ...selector, perms: acl.perms,
108
+ expiresAt: acl.expires_at, maxUses: acl.max_uses });
109
+ const views = acl.grantee_aids ? result?.[remove ? 'results' : 'acls'] : [result];
110
+ const expected = acl.grantee_aids ?? [acl.grantee_aid];
111
+ const seen = new Set();
112
+ try {
113
+ if (!Array.isArray(views) || views.length !== expected.length)
114
+ throw new Error('Incomplete ACL receipt');
115
+ for (const view of views) {
116
+ if (!view || view.owner_aid !== ownerAid || view.bucket !== 'default'
117
+ || String(view.path ?? view.path_prefix ?? '').replace(/^\/+|\/+$/g, '') !== key
118
+ || !expected.includes(view.grantee_aid) || seen.has(view.grantee_aid))
119
+ throw new Error('Mismatched ACL receipt');
120
+ seen.add(view.grantee_aid);
121
+ if (acl.subject && JSON.stringify(parseStorageAcl(JSON.stringify({ subject: view.subject }), true).subject)
122
+ !== JSON.stringify(acl.subject))
123
+ throw new Error('Mismatched ACL subject');
124
+ if (remove ? typeof view.removed !== 'boolean'
125
+ : typeof view.acl_id !== 'string' || !view.acl_id || view.perms !== acl.perms
126
+ || acl.expires_at !== undefined && (view.expires_at ?? 0) !== acl.expires_at
127
+ || acl.max_uses !== undefined && view.max_uses !== acl.max_uses)
128
+ throw new Error('Unconfirmed ACL effect');
129
+ }
130
+ }
131
+ catch {
132
+ throw Object.assign(new Error('Storage returned an unconfirmed ACL receipt; query getfacl before retrying'), {
133
+ code: 'ACL_RESULT_UNKNOWN',
134
+ });
135
+ }
136
+ return result;
137
+ }
138
+ export function parseStorageShare(input) {
139
+ const value = input;
140
+ if (!value || typeof value !== 'object' || Array.isArray(value)
141
+ || !['create', 'list', 'revoke', 'status'].includes(value.action))
142
+ throw new Error('Invalid share action');
143
+ const allowed = {
144
+ create: ['action', 'requestId', 'path', 'allowedAids', 'expireInSeconds', 'maxUses'],
145
+ list: ['action', 'path'], revoke: ['action', 'requestId', 'shareId'], status: ['action', 'requestId'],
146
+ };
147
+ if (Object.keys(value).some(key => !allowed[value.action].includes(key)))
148
+ throw new Error('Unknown share field');
149
+ if (value.action !== 'list' && (typeof value.requestId !== 'string' || !value.requestId.trim() || value.requestId.length > 200)) {
150
+ throw new Error('Stable share requestId required');
151
+ }
152
+ if (['create', 'list'].includes(value.action) && (typeof value.path !== 'string'
153
+ || !/^\/[A-Za-z0-9._/-]+$/.test(value.path) || value.path.slice(1).split('/').some((part) => !part || part === '.' || part === '..'))) {
154
+ throw new Error('Absolute Storage object path required');
155
+ }
156
+ if (value.action === 'revoke' && !/^[A-Za-z0-9]{10}$/.test(value.shareId))
157
+ throw new Error('Invalid shareId');
158
+ if (value.action === 'create') {
159
+ if (!Array.isArray(value.allowedAids) || !value.allowedAids.length || value.allowedAids.length > 100
160
+ || value.allowedAids.some((aid) => typeof aid !== 'string' || !isValidAid(aid)))
161
+ throw new Error('Explicit AID allowlist required');
162
+ for (const key of ['expireInSeconds', 'maxUses'])
163
+ if (value[key] !== undefined
164
+ && (!Number.isSafeInteger(value[key]) || value[key] < 0))
165
+ throw new Error('Invalid ' + key);
166
+ return { ...value, allowedAids: [...new Set(value.allowedAids)].sort(), expireInSeconds: value.expireInSeconds ?? 259200,
167
+ maxUses: value.maxUses ?? 0 };
168
+ }
169
+ return value;
170
+ }
171
+ /** Share writes use the actual authenticated Agent connection and keep uncertain effects durable. */
172
+ export async function executeStorageShare(client, aid, input, receiptsRoot) {
173
+ const command = parseStorageShare(input);
174
+ if (command.action === 'list')
175
+ return { state: 'succeeded', result: await client.call('storage.list_share_links', {
176
+ owner_aid: aid, bucket: 'default', object_key: command.path.slice(1)
177
+ }) };
178
+ const hash = (value) => createHash('sha256').update(JSON.stringify(value, (_key, item) => item
179
+ && typeof item === 'object' && !Array.isArray(item) ? Object.fromEntries(Object.keys(item).sort().map(key => [key, item[key]])) : item)).digest('hex');
180
+ const file = path.join(receiptsRoot, hash([aid, command.requestId]) + '.json');
181
+ fs.mkdirSync(receiptsRoot, { recursive: true });
182
+ return withFileLock(file + '.lock', async () => {
183
+ const previous = fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf8')) : undefined;
184
+ if (command.action === 'status') {
185
+ if (!previous)
186
+ throw new Error('Share request not found');
187
+ if (previous.state === 'unknown' && previous.command.action === 'create') {
188
+ const original = previous.command;
189
+ const listed = await client.call('storage.list_share_links', { owner_aid: aid, bucket: 'default', object_key: original.path.slice(1) });
190
+ const shares = Array.isArray(listed) ? listed : listed?.links ?? listed?.shares ?? listed?.items ?? [];
191
+ const candidates = shares.filter((share) => share.object_key === original.path.slice(1)
192
+ && JSON.stringify([...(share.allowed_aids ?? [])].sort()) === JSON.stringify(original.allowedAids)
193
+ && share.max_uses === original.maxUses && typeof share.created_at === 'number'
194
+ && share.created_at * (share.created_at < 10_000_000_000 ? 1000 : 1) >= previous.startedAt - 1000);
195
+ // A matching old share is not proof that this particular request created it.
196
+ previous.candidates = candidates.map((share) => share.share_id);
197
+ atomicWriteJson(file, previous);
198
+ fs.chmodSync(file, 0o600);
199
+ }
200
+ return { requestId: command.requestId, state: previous.state, result: previous.result, error: previous.error,
201
+ ...(previous.candidates ? { candidates: previous.candidates } : {}) };
202
+ }
203
+ const fingerprint = hash(command);
204
+ if (previous) {
205
+ if (previous.fingerprint !== fingerprint)
206
+ throw new Error('Share request parameters conflict');
207
+ return { requestId: command.requestId, state: previous.state, result: previous.result, error: previous.error };
208
+ }
209
+ const receipt = { aid, fingerprint, state: 'unknown', command, startedAt: Date.now() };
210
+ atomicWriteJson(file, receipt);
211
+ fs.chmodSync(file, 0o600);
212
+ try {
213
+ receipt.result = command.action === 'create' ? await client.call('storage.create_share_link', {
214
+ owner_aid: aid, bucket: 'default', object_key: command.path.slice(1), allowed_aids: command.allowedAids,
215
+ expire_in_seconds: command.expireInSeconds, max_uses: command.maxUses,
216
+ }) : await client.call('storage.revoke_share_link', { share_id: command.shareId });
217
+ if (command.action === 'create' && !/^[A-Za-z0-9]{10}$/.test(receipt.result?.share_id)
218
+ || command.action === 'revoke' && receipt.result?.revoked !== true) {
219
+ throw new Error('Storage returned an unconfirmed share operation receipt');
220
+ }
221
+ receipt.state = 'succeeded';
222
+ }
223
+ catch (error) {
224
+ // A lost reply may have created/revoked a share. Replays must not repeat that write.
225
+ receipt.error = { code: String(error.code ?? 'SHARE_RESULT_UNKNOWN'), message: String(error.message ?? error) };
226
+ }
227
+ atomicWriteJson(file, receipt);
228
+ fs.chmodSync(file, 0o600);
229
+ return { requestId: command.requestId, state: receipt.state, result: receipt.result, error: receipt.error };
230
+ });
231
+ }
4
232
  export function resolveStorageCommandArgv(argv) {
5
233
  if (argv[0] !== 'storage')
6
234
  throw new Error('Expected a storage command');
235
+ if (argv[1] === 'share') {
236
+ const aid = argv[2];
237
+ if (!isValidAid(aid))
238
+ throw new Error('Invalid share actor');
239
+ const flags = argv.slice(3);
240
+ if (flags[0] !== '--input-file' || !flags[1]
241
+ || !(flags.length === 2 || flags.length === 4 && flags[2] === '--format' && flags[3] === 'json'))
242
+ throw new Error('share requires --input-file FILE [--format json]');
243
+ const stat = fs.statSync(flags[1]);
244
+ if (!stat.isFile() || stat.size > 128 * 1024)
245
+ throw new Error('Bounded share input required');
246
+ return { sub: 'share', aid, operation: 'storage.share', isPublic: false,
247
+ share: parseStorageShare(JSON.parse(fs.readFileSync(flags[1], 'utf8'))) };
248
+ }
7
249
  const positionals = [];
8
250
  let isPublic = false;
9
251
  for (let index = 1; index < argv.length; index++) {
@@ -1 +1 @@
1
- {"id":"sha256:12c2256a403ff169bb86c416","builtAt":"2026-11-15T03:59:05.194Z"}
1
+ {"id":"sha256:952ec85481f4e204ad331770","builtAt":"2026-11-22T02:55:48.300Z"}