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
@@ -3,8 +3,8 @@
3
3
  * owns refreshes and snapshots. Runners in the daemon use that same instance.
4
4
  */
5
5
  import path from 'node:path';
6
- import { clearRuntimeBaseagentModelDefaults } from '../../agents/baseagent.js';
7
- import { buildModelRequestHeaders } from '../../agents/request-identity.js';
6
+ import { listSupportedBaseagents, clearRuntimeBaseagentModelDefaults } from '../baseagent/baseagent.js';
7
+ import { buildModelRequestHeaders } from '../inference/request-identity.js';
8
8
  import { activeBaseagent } from './config-scope.js';
9
9
  import { resolveEffective } from '../../config/config-manager.js';
10
10
  import { readRuntimeEnvironmentVariable } from '../../config/runtime-env.js';
@@ -15,6 +15,7 @@ import { getWindowsInstanceSocketPathCandidates, resolvePaths } from '../../path
15
15
  import { ModelCatalogService, adaptCatalogModels, adaptServiceCatalogModels, catalogEfforts, catalogHash, resolveCatalogModel } from './catalog-service.js';
16
16
  import { assertProviderModelAllowed, readProvidersFile, providerModelEnabled, providerModelLiteralId, isProviderModelPattern, providerIsConfigured, providerServiceTypesForBaseagent, resolveProviderService, resolveProviderServiceForBaseagent } from '../../config/providers.js';
17
17
  import { resolveProviderModelSettings } from '../../config/providers-config.js';
18
+ import { assertDeclaredBaseagentCapability } from '../baseagent/baseagent-capability-adapter.js';
18
19
  export * from './catalog-service.js';
19
20
  let daemonOwner = false;
20
21
  export function setModelCatalogDaemonOwner(value) { daemonOwner = value; }
@@ -78,12 +79,12 @@ export async function queryDaemonCatalog(self, baseagent, refresh = false, selec
78
79
  const service = new ModelCatalogService({
79
80
  storageDir: () => path.join(path.dirname(resolvePaths().claudeModelCache), 'model-catalog'),
80
81
  legacyAliasFile: () => resolvePaths().claudeModelCache,
81
- native: async (context) => (await import('../../agents/codex/catalog.js')).codexNativeCatalog(context),
82
+ native: async (context) => (await import('../../agents/codex/index.js')).codexNativeCatalog(context),
82
83
  });
83
- const HOST_BASEAGENTS = ['claude', 'codex', 'ecagent', 'gemini'];
84
+ const hostBaseagents = () => listSupportedBaseagents();
84
85
  function resolveProviderCatalogBaseagent(serviceType, requested) {
85
86
  const baseagent = requested ?? (['claude', 'codex', 'gemini'].includes(serviceType) ? serviceType : '');
86
- if (baseagent && (!HOST_BASEAGENTS.includes(baseagent)
87
+ if (baseagent && (!hostBaseagents().includes(baseagent)
87
88
  || !providerServiceTypesForBaseagent(baseagent).includes(serviceType))) {
88
89
  throw new Error(`Baseagent ${baseagent} is incompatible with provider service ${serviceType}`);
89
90
  }
@@ -170,8 +171,8 @@ export function resolveCatalogContext(self, ba) {
170
171
  }
171
172
  /** Query the catalog for a host-level default connection, without Agent scope. */
172
173
  export async function getBaseagentCatalog(baseagent, options = {}) {
173
- if (!HOST_BASEAGENTS.includes(baseagent)) {
174
- throw Object.assign(new Error(`Invalid baseagent: ${baseagent}. Valid: ${HOST_BASEAGENTS.join(', ')}`), { code: 'INVALID_ARGUMENT' });
174
+ if (!hostBaseagents().includes(baseagent)) {
175
+ throw Object.assign(new Error(`Invalid baseagent: ${baseagent}. Valid: ${hostBaseagents().join(', ')}`), { code: 'INVALID_ARGUMENT' });
175
176
  }
176
177
  const normalized = baseagent;
177
178
  const snapshot = await getCatalog(undefined, normalized, options.refresh === true);
@@ -180,9 +181,19 @@ export async function getBaseagentCatalog(baseagent, options = {}) {
180
181
  /** Used by the IPC handler and the owner process. Never calls IPC recursively. */
181
182
  export async function getLocalCatalog(self, ba, refresh = false) {
182
183
  const context = resolveCatalogContext(self, ba);
184
+ assertDeclaredBaseagentCapability(context.baseagent, 'C10');
185
+ if (context.baseagent === 'dsh' && context.configUnavailable) {
186
+ const config = self ? resolveEffective({ self }, { cache: true }) : loadDefaults();
187
+ const block = config?.baseagents?.dsh;
188
+ if (block?.runtimeMode === 'native-shared') {
189
+ const { getDshNativeCatalog } = await import('../../agents/dsh/resources.js');
190
+ return getDshNativeCatalog(block, self);
191
+ }
192
+ }
183
193
  return applyProviderModelOverrides(await service.get(context, refresh), context.modelOverrides, context.modelPolicy);
184
194
  }
185
195
  export async function getCatalog(self, ba, refresh = false) {
196
+ assertDeclaredBaseagentCapability(ba || activeBaseagent(self), 'C10');
186
197
  if (!daemonOwner) {
187
198
  const snapshot = await queryDaemonCatalog(self, ba, refresh);
188
199
  if (snapshot)
@@ -1,6 +1,6 @@
1
- import { resolveAnthropicConfig, resolveRuntimeBaseagentModelSelection, resolveEcagentConfig, resolveOpenaiConfig } from '../../agents/baseagent.js';
2
- import { buildModelRequestHeaders } from '../../agents/request-identity.js';
3
- import { appendV1RequestPath } from '../../agents/request-identity.js';
1
+ import { resolveAnthropicConfig, resolveRuntimeBaseagentModelSelection, resolveEcagentConfig, resolveOpenaiConfig } from '../baseagent/baseagent.js';
2
+ import { buildModelRequestHeaders } from '../inference/request-identity.js';
3
+ import { appendV1RequestPath } from '../inference/request-identity.js';
4
4
  import { resolveEffective, resolveEffectiveFieldWithSource } from '../../config/config-manager.js';
5
5
  import { constrainResolvedModelForRole } from './model-permission.js';
6
6
  import { getCatalog } from './model-catalog.js';
@@ -232,7 +232,7 @@ export function formatModelCheck(result) {
232
232
  lines.push(`⚠️ 当前配置的模型 ${result.configuredModel} 不可用`);
233
233
  }
234
234
  else if (result.configuredModel && result.configModelAvailable === true) {
235
- lines.push(`✓ 当前配置的模型 ${result.configuredModel} 可用`);
235
+ lines.push(`当前配置的模型 ${result.configuredModel} 可用`);
236
236
  }
237
237
  return lines.join('\n');
238
238
  }
@@ -1,17 +1,47 @@
1
1
  import fs from 'fs';
2
2
  import path from 'path';
3
3
  import { createHash, randomUUID } from 'crypto';
4
- import { agentMdPath, agentOwnerBindingRejectionPath, ownershipCachePath, resolvePaths } from '../../paths.js';
4
+ import { agentMdPath, agentOwnerBindingRejectionPath, ownershipCachePath } from '../../paths.js';
5
5
  import { isValidAid } from '../../aun/aid/validation.js';
6
- import { atomicReadJson } from '../../utils/atomic-write.js';
7
- import { configuredOwnerList as readConfiguredOwnerList } from '../../config/owner-config.js';
8
6
  import { logger, logOwnershipEvent, ownershipErrorCode } from '../../utils/logger.js';
9
7
  import { hasTrustedPrincipal } from '../auth/authenticated-actor.js';
10
8
  import { registerContent, verifyFile } from '../file-integrity/store.js';
11
9
  import { atomicWrite } from '../../utils/atomic-write.js';
10
+ /**
11
+ * How long an Ownership view stays usable before this process asks again.
12
+ *
13
+ * The ownership protocol already decides how long a relation is valid: the
14
+ * remote archive carries `valid_until` (a certificate/relationship expiry that
15
+ * is months out, not minutes), and the SDK re-verifies the whole proof — both
16
+ * signed originals, relation version, archive revision, expiry — before it
17
+ * serves anything from its local record. A consensus that passed those checks
18
+ * stays true until a party changes the relation or the expiry passes, so this
19
+ * process must not expire it on a short timer of its own.
20
+ *
21
+ * The bound below is not an authority lifetime. It is the point where an
22
+ * earlier *failure* should be retried after a later one stopped caching; it
23
+ * still never shortens a verified relation that has a later `valid_until`.
24
+ */
12
25
  export const OWNERSHIP_CACHE_MAX_AGE_MS = 30 * 60_000;
26
+ /** Authorization re-uses the same relation for as long as the protocol says it holds. */
13
27
  export const OWNERSHIP_AUTHORIZATION_MAX_AGE_MS = OWNERSHIP_CACHE_MAX_AGE_MS;
14
28
  export const OWNERSHIP_RETRY_BASE_MS = 5_000;
29
+ /**
30
+ * Effective window for one consensus result.
31
+ *
32
+ * A consensus that carries a protocol expiry is valid until that expiry: the
33
+ * SDK already proved both signed originals, the relation version and the
34
+ * archive revision, and re-checks them whenever it re-reads. Only a result with
35
+ * no protocol expiry falls back to the process-local bound, which exists so a
36
+ * degraded observation cannot authorize indefinitely.
37
+ */
38
+ export function ownershipValidity(consensus, checkedAt) {
39
+ const protocolUntil = typeof consensus?.valid_until === 'number' && Number.isSafeInteger(consensus.valid_until)
40
+ && consensus.valid_until > 0 ? consensus.valid_until * 1000 : 0;
41
+ return protocolUntil > checkedAt
42
+ ? { validUntil: protocolUntil, source: 'protocol' }
43
+ : { validUntil: checkedAt + OWNERSHIP_CACHE_MAX_AGE_MS, source: 'local' };
44
+ }
15
45
  const CREATION_BIND_OPERATION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
16
46
  /** Only use the task returned by this create's bind call. Never select a latest task. */
17
47
  export function creationOwnershipBinding(task, subjectAid, ownerAid) {
@@ -65,9 +95,6 @@ export class OwnerResolver {
65
95
  subjects = new Map();
66
96
  authorizationChecks = new Map();
67
97
  daemonAid;
68
- /** Compatibility binding targets loaded from config; never an Owner authorization source. */
69
- configuredOwners = new Map();
70
- configuredOwnerFileRevision = new Map();
71
98
  listeners = new Set();
72
99
  updateListeners = new Set();
73
100
  cacheFile;
@@ -161,8 +188,11 @@ export class OwnerResolver {
161
188
  || !Number.isSafeInteger(view.consensus.relation_version) || view.consensus.relation_version < 1
162
189
  || !/^[a-f0-9]{64}$/.test(view.consensus.agent_md_sha256 ?? '')
163
190
  || !Number.isSafeInteger(view.checkedAt) || view.checkedAt > now
164
- || view.checkedAt > raw.savedAt || now - view.checkedAt >= OWNERSHIP_CACHE_MAX_AGE_MS
165
- || view.validUntil !== view.checkedAt + OWNERSHIP_CACHE_MAX_AGE_MS
191
+ || view.checkedAt > raw.savedAt
192
+ // The snapshot must still be inside the window it recorded. A view the
193
+ // protocol dated keeps that date; one it did not is bounded locally.
194
+ || !Number.isSafeInteger(view.validUntil) || view.validUntil <= now
195
+ || view.validUntil !== ownershipValidity(view.consensus, view.checkedAt).validUntil
166
196
  || (view.profile && (view.profile.sha256 !== view.consensus.agent_md_sha256
167
197
  || typeof view.profile.type !== 'string')))
168
198
  continue;
@@ -196,6 +226,9 @@ export class OwnerResolver {
196
226
  }
197
227
  subject.view = { ...JSON.parse(JSON.stringify(cached)), connected: subject.view.connected };
198
228
  this.rememberVerifiedRelation(subject);
229
+ // Restoring a restart snapshot changes readiness just like a network result.
230
+ // Cache hits must wake observers even when no consensus query runs.
231
+ this.notifyUpdate(subjectAid);
199
232
  }
200
233
  persistCache(subject, invalidate = false) {
201
234
  // The daemon is the sole production writer. Short-lived CLI processes may read, never replace its snapshot.
@@ -250,47 +283,12 @@ export class OwnerResolver {
250
283
  logger.warn(`[ownership] Cache write failed: ${error instanceof Error ? error.message : String(error)}`);
251
284
  }
252
285
  }
253
- setConfiguredOwners(subjectAid, owners) {
254
- this.assertAid(subjectAid);
255
- const normalized = [...new Set(owners
256
- .map(owner => String(owner || '').trim())
257
- .filter(owner => isValidAid(owner) && owner !== subjectAid))];
258
- const previous = this.configuredOwners.get(subjectAid) ?? [];
259
- if (JSON.stringify(previous) === JSON.stringify(normalized))
260
- return;
261
- if (normalized.length > 0)
262
- this.configuredOwners.set(subjectAid, normalized);
263
- else
264
- this.configuredOwners.delete(subjectAid);
265
- const subject = this.subjects.get(subjectAid);
266
- // Retiring compatibility targets must not invalidate the freshly verified protocol Owner.
267
- const removesConfirmedTargets = normalized.length === 0 && subject?.view.consensusStatus === 'consensus'
268
- && this.isCacheFresh(subject, OWNERSHIP_AUTHORIZATION_MAX_AGE_MS);
269
- if (subject && !removesConfirmedTargets) {
270
- this.invalidate(subject, 'Configured Owners changed; fresh consensus is required', true);
271
- }
272
- }
273
- setAgentConfiguredOwners(subjectAid, owners) {
274
- this.assertAid(subjectAid);
275
- if (subjectAid === this.daemonAid)
276
- return;
277
- this.setConfiguredOwners(subjectAid, owners);
278
- }
279
- configuredOwnerList(subjectAid) {
280
- if (!subjectAid)
281
- return [];
282
- this.refreshConfiguredOwnersFromDisk(subjectAid);
283
- return [...(this.configuredOwners.get(subjectAid) ?? [])];
284
- }
285
286
  isOwner(subjectAid, ownerAid) {
286
287
  if (!subjectAid || !ownerAid)
287
288
  return false;
288
289
  if (subjectAid === ownerAid && this.owner(subjectAid) === subjectAid)
289
290
  return true;
290
- if (this.protocolOwners(subjectAid).includes(ownerAid))
291
- return true;
292
- return !this.hasObservedProtocolConsensus(subjectAid)
293
- && this.configuredOwnerList(subjectAid).includes(ownerAid);
291
+ return this.protocolOwners(subjectAid).includes(ownerAid);
294
292
  }
295
293
  assertLocalSubject(subjectAid) {
296
294
  this.assertAid(subjectAid);
@@ -462,10 +460,34 @@ export class OwnerResolver {
462
460
  // A transport replacement must not erase a still-valid restart snapshot.
463
461
  this.invalidate(subject, 'AUN client is unavailable', false, false);
464
462
  }
463
+ /**
464
+ * Read the current ownership view, restoring the durable snapshot on first
465
+ * read. A restarted daemon has no in-memory consensus until someone refreshes
466
+ * or restores; without this, every read-only caller (control-plane authority,
467
+ * agent listing, consolidation) would see an unbound subject after a restart
468
+ * even though a verified snapshot is on disk.
469
+ */
470
+ observedView(subjectAid) {
471
+ const subject = this.subjects.get(subjectAid);
472
+ if (!subject) {
473
+ if (!isValidAid(subjectAid))
474
+ return undefined;
475
+ try {
476
+ const created = this.subject(subjectAid);
477
+ this.restoreCache(subjectAid, created);
478
+ return created.view;
479
+ }
480
+ catch {
481
+ return undefined;
482
+ }
483
+ }
484
+ this.restoreCache(subjectAid, subject);
485
+ return subject.view;
486
+ }
465
487
  owner(subjectAid) {
466
488
  if (!subjectAid)
467
489
  return undefined;
468
- const view = this.subjects.get(subjectAid)?.view;
490
+ const view = this.observedView(subjectAid);
469
491
  return view?.consensusStatus === 'consensus'
470
492
  && view.checkedAt !== undefined && view.checkedAt <= this.now()
471
493
  && ((view.validUntil ?? 0) > this.now() || view.refreshFailure?.fallbackUsed === true)
@@ -477,7 +499,11 @@ export class OwnerResolver {
477
499
  const protocol = this.protocolOwners(subjectAid);
478
500
  if (protocol.length > 0 || this.hasObservedProtocolConsensus(subjectAid))
479
501
  return protocol;
480
- return this.configuredOwnerList(subjectAid);
502
+ // Ownership is granted by the ownership protocol only. A configured value
503
+ // is a binding target and never an authorization source — not for Agents,
504
+ // and not for the daemon's own control identity. Until consensus exists the
505
+ // daemon has no Owner and its control surface stays closed.
506
+ return [];
481
507
  }
482
508
  protocolOwners(subjectAid) {
483
509
  const owner = this.owner(subjectAid);
@@ -487,8 +513,7 @@ export class OwnerResolver {
487
513
  hasObservedProtocolConsensus(subjectAid) {
488
514
  if (!subjectAid)
489
515
  return false;
490
- const subject = this.subjects.get(subjectAid);
491
- const relation = subject?.view.relation;
516
+ const relation = this.observedView(subjectAid)?.relation;
492
517
  return !!relation
493
518
  && relation.relationVersion > 0
494
519
  && (relation.consensusStatus === 'consensus' || relation.consensusStatus === 'released');
@@ -496,18 +521,17 @@ export class OwnerResolver {
496
521
  primaryOwner(subjectAid) {
497
522
  return this.owners(subjectAid)[0];
498
523
  }
524
+ /** Owners already established by protocol evidence. Configured values never qualify. */
499
525
  knownOwners(subjectAid) {
500
526
  if (!subjectAid)
501
527
  return [];
502
528
  const protocol = this.protocolOwners(subjectAid);
503
529
  if (protocol.length > 0)
504
530
  return protocol;
505
- const relation = this.subjects.get(subjectAid)?.view.relation;
531
+ const relation = this.observedView(subjectAid)?.relation;
506
532
  if (relation?.consensusStatus === 'consensus' && relation.ownerAid)
507
533
  return [relation.ownerAid];
508
- if (this.hasObservedProtocolConsensus(subjectAid))
509
- return [];
510
- return this.configuredOwnerList(subjectAid);
534
+ return [];
511
535
  }
512
536
  knownOwner(subjectAid) {
513
537
  return this.knownOwners(subjectAid)[0];
@@ -515,20 +539,21 @@ export class OwnerResolver {
515
539
  daemonOwners() {
516
540
  return this.owners(this.daemonAid);
517
541
  }
518
- configuredRevision(subjectAid) {
519
- return JSON.stringify(this.configuredOwnerList(subjectAid));
520
- }
521
542
  revision(subjectAid) {
522
543
  const view = this.subjects.get(subjectAid)?.view;
523
544
  return JSON.stringify([
524
545
  view?.revision ?? 0,
525
546
  this.owner(subjectAid),
526
547
  view?.consensusStatus ?? 'unavailable',
527
- this.configuredOwnerList(subjectAid),
528
548
  ]);
529
549
  }
530
550
  snapshot(subjectAid) {
531
551
  const subject = this.subject(subjectAid);
552
+ // Restore the durable snapshot on first read so a restarted daemon reports
553
+ // the verified relation it already has on disk instead of an empty view.
554
+ // Restoring clears the guard inside restoreCache, so a notifyUpdate-driven
555
+ // re-entry cannot loop: the second pass returns before notifying.
556
+ this.restoreCache(subjectAid, subject);
532
557
  const view = JSON.parse(JSON.stringify(subject.view));
533
558
  view.requests = [...subject.requests.values()].map(request => ({ ...request }));
534
559
  if (view.consensusStatus === 'consensus' && !this.owner(subjectAid)) {
@@ -536,16 +561,16 @@ export class OwnerResolver {
536
561
  view.synchronization = { status: 'unavailable' };
537
562
  }
538
563
  const now = this.now();
564
+ // Authorization follows the relation's own expiry, exactly as `owner()` does.
539
565
  view.authorizationStatus = view.consensusStatus === 'consensus'
540
566
  && view.checkedAt !== undefined && view.checkedAt <= now
541
- ? view.ownerAid && now - view.checkedAt < OWNERSHIP_AUTHORIZATION_MAX_AGE_MS ? 'verified' : 'expired'
567
+ ? view.ownerAid && (view.validUntil ?? 0) > now ? 'verified' : 'expired'
542
568
  : 'unavailable';
543
569
  return view;
544
570
  }
545
571
  async refresh(subjectAid, options = {}) {
546
572
  const subject = this.subject(subjectAid);
547
573
  this.restoreCache(subjectAid, subject);
548
- this.refreshConfiguredOwnersFromDisk(subjectAid);
549
574
  const inFlight = subject.refreshing?.epoch === subject.epoch ? subject.refreshing : undefined;
550
575
  const refreshing = inFlight?.promise;
551
576
  const initialEpoch = subject.epoch;
@@ -567,14 +592,12 @@ export class OwnerResolver {
567
592
  .filter(frame => !/\/core\/ownership\/owner-resolver\.[cm]?[jt]s:/.test(frame))
568
593
  .map(frame => frame.match(/\/((?:src|dist)\/[a-zA-Z0-9_./-]+\.[cm]?[jt]s:\d+:\d+)/)?.[1])
569
594
  .find(frame => !!frame);
570
- const configuredOwners = this.configuredOwnerList(subjectAid);
571
595
  const diagnostic = inFlight?.diagnostic ?? {
572
596
  startedAt: performance.now(), source: options.source ?? 'direct', caller,
573
597
  attemptId, processId: process.pid, connected: subject.view.connected,
574
598
  sdkReady: subject.client?.isReady === true,
575
599
  force: !!options.force, maxAgeMs, timeoutMs: this.options.timeoutMs ?? 8_000,
576
600
  firstObservation: !subject.view.consensus, previousConsensusStatus: subject.view.consensusStatus,
577
- configuredOwnerAid: configuredOwners[0], configuredOwnerCount: configuredOwners.length,
578
601
  };
579
602
  const promise = refreshing ?? this.refreshSubject(subjectAid, subject, attemptId, attemptedAt, diagnostic, options);
580
603
  subject.refreshing = { epoch: subject.epoch, attemptId, attemptedAt, diagnostic, promise };
@@ -686,6 +709,7 @@ export class OwnerResolver {
686
709
  const previousStatus = subject.view.consensusStatus;
687
710
  const previousConsensus = subject.view.consensus;
688
711
  const checkedAt = this.now();
712
+ const validity = ownershipValidity(consensus, checkedAt);
689
713
  const pending = subject.view.task?.status === 'pending' || subject.view.requestStatus === 'requesting';
690
714
  subject.view = {
691
715
  ...subject.view,
@@ -696,7 +720,7 @@ export class OwnerResolver {
696
720
  consensus: JSON.parse(JSON.stringify(consensus)),
697
721
  profile: profile ?? (subject.view.profile?.sha256 === consensus.agent_md_sha256 ? subject.view.profile : undefined),
698
722
  checkedAt,
699
- validUntil: checkedAt + (this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS),
723
+ validUntil: validity.validUntil,
700
724
  revision: subject.view.revision + (previousOwner !== ownerAid
701
725
  || subject.view.consensusStatus !== consensus.status
702
726
  || subject.view.consensus?.relation_version !== consensus.relation_version
@@ -717,7 +741,9 @@ export class OwnerResolver {
717
741
  this.persistCache(subject);
718
742
  this.clearConfirmedRequest(subject, consensus, ownerAid);
719
743
  this.clearResolvedRequests(subject, consensus);
720
- if (previousOwner !== ownerAid || previousStatus !== consensus.status
744
+ // Compare protocol observations, not the expiring authorization view.
745
+ // Revalidating the same relation after expiry/invalidation is not a change.
746
+ if (previousConsensus?.owner_aid !== consensus.owner_aid || previousConsensus?.status !== consensus.status
721
747
  || previousConsensus?.relation_version !== consensus.relation_version
722
748
  || previousConsensus?.lock !== consensus.lock) {
723
749
  logOwnershipEvent('consensus.changed', { subjectAid, ownerAid, ...diagnostic,
@@ -1126,7 +1152,7 @@ export class OwnerResolver {
1126
1152
  }
1127
1153
  // A fresh snapshot survives transport loss; serve it instead of loading a
1128
1154
  // short-lived client. Only a stale unattached subject needs a live check.
1129
- if (!options.force && this.isCacheFresh(subject, this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS)) {
1155
+ if (!options.force && this.isCacheFresh(subject)) {
1130
1156
  return this.snapshot(subjectAid);
1131
1157
  }
1132
1158
  const generation = subject.generation;
@@ -1157,13 +1183,26 @@ export class OwnerResolver {
1157
1183
  }
1158
1184
  }
1159
1185
  }
1186
+ /** True when the view's expiry is the relation expiry the protocol published. */
1187
+ isProtocolDated(view) {
1188
+ const protocolUntil = view.consensus?.valid_until;
1189
+ return typeof protocolUntil === 'number' && Number.isSafeInteger(protocolUntil) && protocolUntil > 0
1190
+ && view.validUntil === protocolUntil * 1000;
1191
+ }
1160
1192
  isCacheFresh(subject, maxAgeMs) {
1161
1193
  const { checkedAt, validUntil, consensusStatus } = subject.view;
1162
1194
  const now = this.now();
1163
1195
  // A transient fallback can authorize callers, but is not a successful fresh check.
1164
- return !subject.view.refreshFailure && consensusStatus !== 'unavailable' && consensusStatus !== 'not_applicable'
1165
- && checkedAt !== undefined && checkedAt <= now && (validUntil ?? 0) > now
1166
- && now - checkedAt < maxAgeMs;
1196
+ if (subject.view.refreshFailure || consensusStatus === 'unavailable' || consensusStatus === 'not_applicable'
1197
+ || checkedAt === undefined || checkedAt > now || (validUntil ?? 0) <= now)
1198
+ return false;
1199
+ // A relation the protocol dated lives until that date: the SDK re-verifies
1200
+ // both signed originals, the relation version and the archive revision
1201
+ // before serving it, and nobody can extend or shorten it locally. Only an
1202
+ // observation the protocol did not date is bounded by the caller's budget.
1203
+ if (this.isProtocolDated(subject.view))
1204
+ return true;
1205
+ return maxAgeMs === undefined || now - checkedAt < maxAgeMs;
1167
1206
  }
1168
1207
  async withSubjectClient(subjectAid, operation) {
1169
1208
  const subject = this.subject(subjectAid);
@@ -1207,8 +1246,6 @@ export class OwnerResolver {
1207
1246
  for (const subjectAid of this.subjects.keys())
1208
1247
  this.detachClient(subjectAid);
1209
1248
  this.subjects.clear();
1210
- this.configuredOwners.clear();
1211
- this.configuredOwnerFileRevision.clear();
1212
1249
  this.authorizationChecks.clear();
1213
1250
  this.cacheEntries.clear();
1214
1251
  this.cacheFile = undefined;
@@ -1694,7 +1731,7 @@ export class OwnerResolver {
1694
1731
  authorizationStatus: ownerAid ? 'verified' : 'unavailable', consensusStatus: consensus.status,
1695
1732
  consensus: JSON.parse(JSON.stringify(consensus)),
1696
1733
  profile: subject.view.profile?.sha256 === consensus.agent_md_sha256 ? subject.view.profile : undefined,
1697
- checkedAt, validUntil: checkedAt + (this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS),
1734
+ checkedAt, validUntil: ownershipValidity(consensus, checkedAt).validUntil,
1698
1735
  revision: subject.view.revision + (previousOwner !== ownerAid || subject.view.consensusStatus !== consensus.status
1699
1736
  || subject.view.consensus?.relation_version !== consensus.relation_version
1700
1737
  || subject.view.consensus?.lock !== consensus.lock ? 1 : 0),
@@ -1714,7 +1751,7 @@ export class OwnerResolver {
1714
1751
  subject.failures = 0;
1715
1752
  this.clearConfirmedRequest(subject, consensus, ownerAid);
1716
1753
  this.clearResolvedRequests(subject, consensus);
1717
- if (previousOwner !== ownerAid || previousStatus !== consensus.status
1754
+ if (previousConsensus?.owner_aid !== consensus.owner_aid || previousConsensus?.status !== consensus.status
1718
1755
  || previousConsensus?.relation_version !== consensus.relation_version
1719
1756
  || previousConsensus?.lock !== consensus.lock) {
1720
1757
  logOwnershipEvent('consensus.changed', { subjectAid, ownerAid,
@@ -1758,8 +1795,6 @@ export class OwnerResolver {
1758
1795
  const rootScope = this.options.cachePath?.() ?? ownershipCachePath();
1759
1796
  if (this.rootScope && this.rootScope !== rootScope) {
1760
1797
  this.subjects.clear();
1761
- this.configuredOwners.clear();
1762
- this.configuredOwnerFileRevision.clear();
1763
1798
  this.authorizationChecks.clear();
1764
1799
  }
1765
1800
  this.rootScope = rootScope;
@@ -1838,34 +1873,6 @@ export class OwnerResolver {
1838
1873
  now() {
1839
1874
  return this.options.now?.() ?? Date.now();
1840
1875
  }
1841
- refreshConfiguredOwnersFromDisk(subjectAid) {
1842
- const file = subjectAid === this.daemonAid
1843
- ? resolvePaths().daemonConfig
1844
- : path.join(resolvePaths().agentsDir, subjectAid, 'config.json');
1845
- let revision = 'missing';
1846
- try {
1847
- const stat = fs.statSync(file);
1848
- revision = `${stat.size}:${stat.mtimeMs}`;
1849
- }
1850
- catch { }
1851
- if (this.configuredOwnerFileRevision.get(subjectAid) === revision)
1852
- return;
1853
- const hadFileRevision = this.configuredOwnerFileRevision.has(subjectAid);
1854
- this.configuredOwnerFileRevision.set(subjectAid, revision);
1855
- if (revision === 'missing') {
1856
- if (hadFileRevision)
1857
- this.setConfiguredOwners(subjectAid, []);
1858
- return;
1859
- }
1860
- try {
1861
- const raw = atomicReadJson(file);
1862
- this.setConfiguredOwners(subjectAid, readConfiguredOwnerList(raw));
1863
- }
1864
- catch {
1865
- // The regular config loader reports malformed files; keep this optional
1866
- // compatibility read fail-closed without interrupting ownership checks.
1867
- }
1868
- }
1869
1876
  assertAid(aid) {
1870
1877
  if (!isValidAid(aid) || aid.trim() !== aid)
1871
1878
  throw new OwnershipError('INVALID_AID', `Invalid AID: ${aid}`);
@@ -1988,7 +1995,6 @@ export const getProtocolOwner = (subjectAid) => ownerResolver.owner(subjectAid);
1988
1995
  export const getPrimaryOwner = (subjectAid) => ownerResolver.primaryOwner(subjectAid);
1989
1996
  export const getProtocolOwners = (subjectAid) => ownerResolver.protocolOwners(subjectAid);
1990
1997
  export const getOwners = (subjectAid) => ownerResolver.owners(subjectAid);
1991
- export const getConfiguredOwners = (subjectAid) => ownerResolver.configuredOwnerList(subjectAid);
1992
1998
  export const getDaemonOwners = () => ownerResolver.daemonOwners();
1993
1999
  export function resolveContextOwner(selfAid, directoryOwnerAid) {
1994
2000
  const ownerAid = selfAid ? getProtocolOwner(selfAid) : undefined;
@@ -25,9 +25,9 @@
25
25
  * 为什么不读 `/public` 或名录里的转发关系:那些都是会被拷贝、会变的展示信息;
26
26
  * 协议 owner 归属(`ownerResolver`)才是唯一可信判据。
27
27
  */
28
- import { getDaemonOwners, getProtocolOwner } from './ownership/owner-resolver.js';
29
- import { getRoleRank } from '../config/roles.js';
30
- import { ROLE_RANKS } from '../config/role-ranks.js';
28
+ import { getDaemonOwners, getProtocolOwner } from '../ownership/owner-resolver.js';
29
+ import { getRoleRank } from '../../config/roles.js';
30
+ import { ROLE_RANKS } from '../../config/role-ranks.js';
31
31
  const MANAGING_ROLES = new Set(['owner', 'admin']);
32
32
  /**
33
33
  * 查看档的角色下限:member(rank 300)及以上。
@@ -186,6 +186,8 @@ const PACK_OPERATIONS = {
186
186
  // publish 只能发 `pack.json` 里 owner 已声明的事件(runtime.publish 校验),
187
187
  // 等于执行已授权动作;跨 AID 的接收方准入另行判定。
188
188
  publish: 'call',
189
+ // 原生输出卡片通知:分支内另有「仅本 AID owner」的硬校验,这里按 manage 登记。
190
+ 'native-publish': 'manage',
189
191
  'rules:show': 'view',
190
192
  'rules:add': 'manage',
191
193
  'rules:remove': 'manage',
@@ -209,8 +211,14 @@ const PACK_OPERATIONS = {
209
211
  // AID 级总闸:整机是否对外提供本 AID 的服务。
210
212
  enable: 'switch',
211
213
  disable: 'switch',
214
+ // 宿主模式总闸。与 enable/disable 同档:它虽然不改"接不接活",但决定脚本以
215
+ // 什么隔离形态执行(常驻进程跨调用共享内存),属于整机执行面决策,不是包级配置。
216
+ 'host:enable': 'switch',
217
+ 'host:disable': 'switch',
212
218
  'pack:list': 'view',
213
219
  'pack:add': 'manage',
220
+ // update 与 add 同档:都是往 services/ 写脚本,只是多了一步替换。
221
+ 'pack:update': 'manage',
214
222
  'pack:remove': 'manage',
215
223
  'pack:enable': 'manage',
216
224
  'pack:disable': 'manage',
@@ -223,6 +231,29 @@ const PACK_OPERATIONS = {
223
231
  export function packOperationKey(command, action) {
224
232
  return command === 'pack' ? `pack:${action ?? ''}` : command;
225
233
  }
234
+ /**
235
+ * 命令是否已登记。执行器必须在授权**之前**用它拦下未知命令:否则未知命令按
236
+ * fail-closed 落到 `manage`,再碰上目标 AID 不是自己,就会报出 FULLACCESS_REQUIRED
237
+ * 之类的权限错误——调用方会以为命令存在、只是权限不够。
238
+ */
239
+ export function isKnownPackCommand(domain, command, action) {
240
+ return Object.prototype.hasOwnProperty.call(PACK_OPERATIONS[domain], packOperationKey(command, action));
241
+ }
242
+ /**
243
+ * 托管会话未写 `--aid` 时的默认目标:会话自己的 AID。
244
+ *
245
+ * 不能回落到 daemon AID——那是另一个主体,托管会话不写 `--aid` 就被当成跨 AID
246
+ * 操作:`pack list` 列出的是主机的包,管理类命令则报 FULLACCESS_REQUIRED。
247
+ * 主机终端(local-control)没有会话身份,返回 undefined,由各执行器按原逻辑选。
248
+ */
249
+ export function callerDefaultAid(caller) {
250
+ if (caller?.kind !== 'managed')
251
+ return undefined;
252
+ const aid = String(caller.selfAid ?? '').trim();
253
+ if (!aid)
254
+ return undefined;
255
+ return aid.startsWith('@') ? aid.slice(1) : aid;
256
+ }
226
257
  /** 查表得出该命令的操作档位;未登记的一律 `manage`(fail-closed)。 */
227
258
  export function packOperation(domain, command, action) {
228
259
  return PACK_OPERATIONS[domain][packOperationKey(command, action)] ?? 'manage';