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
@@ -1,57 +1,100 @@
1
1
  ---
2
2
  name: agent-output-cards
3
3
  description: >-
4
- Publish finished Agent deliverables as semantic cards for the Personal Assistant team output panel.
5
- Use after a useful report, document, meeting record, media item, or other durable output is complete.
6
- Cards link to real files under this Agent's output directory and never contain executable UI.
4
+ Publish durable, Owner-facing Personal Assistant panel cards when the Owner asks for a
5
+ persistent entry or when the Agent has useful state that will be maintained over time.
6
+ A card is an optional, user-managed entry, not an automatic receipt for every file.
7
7
  license: MIT
8
8
  ---
9
9
 
10
- # Agent output cards
10
+ # Evol Personal Assistant panel cards
11
11
 
12
- Use this skill when a finished output should be easy for the Owner to discover from the team panel. The output file remains the source of truth; a card only adds a concise title, summary, semantic kind, and links to related files.
12
+ The PA panel is a user-managed card directory and desktop. Publish a card only when the
13
+ Owner requests a durable entry or when your service has useful Owner-facing state that
14
+ will continue to change. Do not publish a card for every report, file, conversation, or
15
+ completed task. A published card appears in the Owner's **Available** directory; it is
16
+ not automatically placed on the panel.
13
17
 
14
- ## Publish
18
+ ## Before publishing
15
19
 
16
- 1. Finish and save every file the card will reference under this Agent's `output/` directory.
17
- 2. Choose one stable, lowercase card id. Reuse it when updating the same deliverable.
18
- 3. Write a JSON manifest file in the current task workspace, then publish it with `ec team cards publish --file <manifest-path>`.
19
- 4. Check the command result. A successful publish validates the schema and all file references. `notified: false` means the card is saved; the App will pick it up the next time it opens or reconnects.
20
+ 1. Confirm that the current Owner asked for a persistent entry, or that the card will
21
+ provide ongoing value beyond a single delivery.
22
+ 2. Check the configured project and catalog with `ec team cards catalog` and
23
+ `ec team cards schema`.
24
+ 3. Save any referenced source files under this Agent's fixed project
25
+ `.output/<selfAid>/`. Use paths relative to that directory. Do not use a session's
26
+ temporary project path, absolute paths, another Agent's partition, or the legacy
27
+ `$EVOLCORE_HOME/agents/<aid>/output/` directory.
28
+ 4. Design the card with HTML/CSS. Save a complete self-contained HTML file in
29
+ `.output/<selfAid>/` (at most 256 KiB), declare it as a `kind: file` resource,
30
+ and use `body: { "type": "html", "resourceId": "surface" }`. HTML fills the whole
31
+ card: design its heading, spacing, colors, typography, charts and cover.
32
+ Use inline CSS, inline SVG or data images/fonts. External requests and JavaScript
33
+ are unavailable. Use catalog read-only actions for chat/files/tasks; the App
34
+ shows them outside the document. Native components remain available too.
35
+ 5. Run `ec team cards validate --file <draft.json>`, then publish with
36
+ `ec team cards publish --file <draft.json>`.
20
37
 
21
- Manifest shape:
38
+ The Core writes the published descriptor to `.output/.cards/<selfAid>/`. It validates
39
+ the current Owner, the fixed project binding, component budgets, referenced files, and
40
+ the Agent-specific partition before committing. A successful command means the entry
41
+ was provided. It does not mean the App received the event or that the Owner added it.
42
+ Owner sessions and panel-card queries support both plaintext and encrypted AUN messages.
43
+ Encryption is optional; current verified Owner authorization is still required.
22
44
 
23
- ```json
24
- {
25
- "schemaVersion": 1,
26
- "id": "weekly-product-review",
27
- "kind": "report",
28
- "title": "Weekly product review",
29
- "summary": "Key findings, decisions, and the next actions from this week's review.",
30
- "files": [
31
- { "role": "primary", "path": "reports/weekly-product-review.md", "label": "Read report" },
32
- { "role": "attachment", "path": "data/competitor-pricing.csv", "label": "Pricing data" }
33
- ]
34
- }
45
+ ## Update and remove
46
+
47
+ Reuse the same `id` to update the same long-lived entry. Use the returned
48
+ `contentVersion` with `--expected-version` when replacing a version you have read:
49
+
50
+ ```sh
51
+ ec team cards publish --file <draft.json> --expected-version <contentVersion>
52
+ ec team cards remove --id meeting.latest --expected-version <contentVersion>
35
53
  ```
36
54
 
37
- `path` is relative to this Agent's `output/` directory. Do not include `output/`, absolute paths, `..`, or hidden path components. A card must have exactly one `primary` file and may have up to seven additional references. Supported roles are `primary`, `summary`, `transcript`, `recording`, `attachment`, and `cover`.
55
+ Changing `span` updates that card in place. It does not create a second card. Remove
56
+ only the card descriptor; leave referenced source files in `.output/<selfAid>/`.
57
+ If the same ID is published after removal, the Owner must add it again.
38
58
 
39
- ## Choose a kind
59
+ ## HTML/CSS examples
40
60
 
41
- - `meeting`: a meeting package, such as notes with a transcript or recording.
42
- - `report`: research, analysis, or a status report.
43
- - `document`: a specification, guide, plan, or other authored document.
44
- - `media`: an image, audio, or video deliverable.
45
- - `generic`: an output that does not fit the other kinds.
61
+ Start from `examples/html-surface.json` and `examples/surface.html`. Copy the HTML
62
+ to your project's `.output/<selfAid>/surface.html` before validation. Choose a
63
+ supported span and use the same ID on updates. The App owns the grid rectangle;
64
+ the Agent owns everything drawn inside it. Fit the composition to its span,
65
+ adapt to narrow widths, use relative text sizes, and provide meaningful alt text.
66
+ `--evol-surface`, `--evol-text`, `--evol-muted`, `--evol-text-scale`, `color-scheme`
67
+ and `html[data-evol-theme="dark"]` are available for theme adaptation. The board
68
+ is a preview; opening a card shows its scrollable document and declared actions.
69
+ Do not place secrets in HTML or invent statistics. Publishing makes it Available;
70
+ only the Owner can place it on the board.
46
71
 
47
- The App chooses its own presentation from `kind` and each file's format. Do not provide HTML, scripts, widget descriptions, colors, or layout instructions. Use a concise summary; the App loads and opens the actual files only when needed.
72
+ ## Native examples
48
73
 
49
- ## Update or remove
74
+ Four minimal drafts are in `examples/`: `meeting-latest.json`,
75
+ `meeting-followups.json`, `project-metrics.json`, and `quick-links.json`. They show a
76
+ cover with a file action, a status and follow-up list, metrics with a chart, and safe
77
+ chat/directory actions. Resource paths are relative to this Agent's `.output` partition.
50
78
 
51
- Publishing the same `id` replaces its card. Remove a card when its deliverable is withdrawn or no longer useful:
79
+ For each example, the same command flow applies: validate and publish once; publish
80
+ the same ID with updated content or span to update; remove it by ID to withdraw it.
81
+ Use `--expected-version` when replacing a known version. Do not claim an update or
82
+ removal succeeded unless the command returned a committed result.
52
83
 
53
- ```sh
54
- ec team cards remove --id weekly-product-review
55
- ```
84
+ ## Validation failures
85
+
86
+ - Unknown component, theme, icon, action, or unsupported field: select a value from
87
+ `ec team cards schema` and remove unsupported instructions.
88
+ - Span outside the catalog: choose a listed discrete span. App controls all pixel
89
+ dimensions and rendering.
90
+ - Invalid resource path: place the completed file in `.output/<selfAid>/`, use a
91
+ relative path without hidden or parent segments, then validate again.
92
+ - Project unavailable: ask the Owner to restore or configure this Agent's fixed
93
+ `projects.defaultPath`. Do not fall back to Agent home `output/`.
94
+ - Version conflict: query the latest card and reconcile the change before retrying.
95
+ - Notification unavailable: the card may still be committed. Do not publish again
96
+ solely because `notified` is false; the App reconciles on open or reconnect.
56
97
 
57
- Publish cards only for complete, durable outputs. Do not publish temporary files, intermediate drafts, or a card for every minor edit. The command does not scan the output tree or install anything per Agent.
98
+ Never expose secrets or content from an unrelated Owner context. Keep card contents
99
+ brief and current. For HTML cards, the Agent designs the presentation; the App owns
100
+ grid layout, document isolation, authorization, and safe file opening.
@@ -0,0 +1,11 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "catalog": "evol.cards.v1",
4
+ "id": "project.overview",
5
+ "title": "Project overview",
6
+ "span": {"w": 2, "h": 2},
7
+ "theme": "accent",
8
+ "resources": {"surface": {"kind": "file", "path": "surface.html"}},
9
+ "body": {"type": "html", "resourceId": "surface"},
10
+ "actions": [{"id": "chat", "type": "openChat", "label": "Discuss progress"}]
11
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "catalog": "evol.cards.v1",
4
+ "id": "meeting.followups",
5
+ "title": "Meeting follow-ups",
6
+ "summary": "Actions that still need an Owner or team member to follow up.",
7
+ "span": { "w": 1, "h": 2 },
8
+ "theme": "warning",
9
+ "body": {
10
+ "type": "column",
11
+ "children": [
12
+ { "type": "status", "text": "3 items need attention", "tone": "warning" },
13
+ { "type": "list", "items": ["Confirm the launch date", "Review the interview summary", "Share the decision record"] }
14
+ ]
15
+ }
16
+ }
@@ -0,0 +1,24 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "catalog": "evol.cards.v1",
4
+ "id": "meeting.latest",
5
+ "title": "Latest meeting",
6
+ "summary": "A concise current summary with the complete minutes available on demand.",
7
+ "span": { "w": 2, "h": 2 },
8
+ "theme": "accent",
9
+ "resources": {
10
+ "cover": { "path": "meetings/latest/cover.jpg", "kind": "image" },
11
+ "minutes": { "path": "meetings/latest/minutes.md", "kind": "file" }
12
+ },
13
+ "body": {
14
+ "type": "column",
15
+ "children": [
16
+ { "type": "cover", "resourceId": "cover", "text": "Latest meeting" },
17
+ { "type": "heading", "text": "Decisions and follow-up" },
18
+ { "type": "text", "text": "Replace this text with the latest verified meeting summary." }
19
+ ]
20
+ },
21
+ "actions": [
22
+ { "id": "open-minutes", "type": "openFile", "label": "Open minutes", "resource": "minutes" }
23
+ ]
24
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "catalog": "evol.cards.v1",
4
+ "id": "project.metrics",
5
+ "title": "Project metrics",
6
+ "summary": "A snapshot of current progress, refreshed when source data changes.",
7
+ "span": { "w": 2, "h": 2 },
8
+ "theme": "success",
9
+ "body": {
10
+ "type": "column",
11
+ "children": [
12
+ { "type": "metric", "label": "Reviewed", "value": "18", "unit": "items", "tone": "success" },
13
+ { "type": "chart", "label": "Weekly progress", "points": [3, 5, 4, 8, 7, 11, 13], "tone": "accent" }
14
+ ]
15
+ }
16
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "catalog": "evol.cards.v1",
4
+ "id": "team.quick-links",
5
+ "title": "Quick links",
6
+ "summary": "Open this Agent's conversation or its shared project directory.",
7
+ "span": { "w": 1, "h": 1 },
8
+ "theme": "neutral",
9
+ "body": {
10
+ "type": "shortcutGroup",
11
+ "items": ["Chat with this Agent", "Browse project files"],
12
+ "tone": "accent"
13
+ },
14
+ "actions": [
15
+ { "id": "open-chat", "type": "openChat", "label": "Open chat" },
16
+ { "id": "open-directory", "type": "openDirectory", "label": "Open directory" }
17
+ ]
18
+ }
@@ -0,0 +1,8 @@
1
+ <!doctype html><html lang="en"><head><style>
2
+ body{margin:0;background:#132825;color:#f5f9ec;font-family:system-ui,sans-serif}
3
+ article{min-height:100vh;padding:26px;box-sizing:border-box;position:relative;overflow:hidden;display:flex;flex-direction:column}
4
+ small{font-size:.7rem;letter-spacing:.18em;color:#bfd2b8}h1{font-size:2.3rem;font-weight:500;line-height:1.15;letter-spacing:-.04em;margin:34px 0 14px;position:relative;z-index:1}
5
+ p{font-size:.85rem;line-height:1.6;color:#c7d6c0;max-width:70%;position:relative;z-index:1}
6
+ .orb{position:absolute;width:220px;height:220px;right:-85px;top:80px;border-radius:50%;background:radial-gradient(circle at 30% 22%,#ecf5b5,#a8c28b 25%,#4f8564 50%,#1c493e 73%);box-shadow:inset -15px -20px 35px #001f26}
7
+ footer{margin-top:auto;padding-top:24px;font-size:.7rem;color:#a9c0af}
8
+ </style></head><body><article><small>PROJECT OVERVIEW</small><div class="orb" aria-hidden="true"></div><h1>Make room<br>for what matters.</h1><p>Replace this example with your project's verified progress and next steps.</p><footer>Your project assistant ↗</footer></article></body></html>
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: agent-template-project
3
+ description: >-
4
+ Agent 模板的采集打包、上传分享、发布到平台仓库、下载安装、升级恢复。
5
+ 收到模板分享,或用户要求制作模板、给自己打包、整理模板资料、分享已有模板、发布模板到平台仓库、安装模板、检查模板更新或恢复模板作业时使用。
6
+ 不用于普通项目开发、记忆导出、跨 Host 身份迁移或 EvolCore/npm 本身升级。
7
+ license: MIT
8
+ ---
9
+
10
+ # Agent 模板操作入口
11
+
12
+ 复用 `ec agent template`、Storage、文件授权、消息和平台仓库 service。按任务只读对应分册,不默认全部加载。
13
+
14
+ 收到模板分享后,读取摘要和原始卡片附件,不自动下载或安装。
15
+
16
+ ## 按任务进入
17
+
18
+ | 用户目标 | 必读文档 | 起点与完成结果 |
19
+ | --- | --- | --- |
20
+ | 制作模板、自打包、整理资料 | [采集和打包](references/01-collect-and-pack.md) | 来源与模块 → 可编辑副本 → 最终 packageId/digest |
21
+ | 上传、分享已有包、撤销分享 | [上传和分享](references/02-upload-and-share.md) | packageId 或已有 Storage 对象 → 上传/授权/发卡回执 |
22
+ | 收到模板分享 | [下载和安装](references/03-download-and-install.md) | 读取摘要和原始卡片附件 |
23
+ | 发布到平台仓库 | [发布到平台仓库](references/05-publish-to-platform.md) | 最终包与仓库 AID → 上传/读取授权 → publish → status 确认发行 |
24
+ | 下载、安装、覆盖现有 Agent | [下载和安装](references/03-download-and-install.md) | 下载 → 预览 → 部署 → 检查,按分册中的固定版式反馈 |
25
+ | 检查更新、升级、失败续作 | [升级和恢复](references/04-upgrade-and-recovery.md) | 已安装 Agent 或原作业 ID → 固定发行升级/原作业恢复 |
26
+
27
+ 路径相对于加载回执的 `skillDir`,读取时拼成绝对路径;已有包可从第二或第三部分开始。
28
+
29
+ ## 共用规则
30
+
31
+ 1. 制作前先读已有打包确认清单,沿用适用的选择和授权;首次或有变化时与用户确定用途、来源和具体范围,按第一册持久保存。当前 Owner 已明确要求四轮确认时,必须按第一册分四次逐轮询问、每轮等答后记录,再进入下一轮;不得合并询问或把未答当作同意。每次按来源 Agent 记录其本次选择,后续只沿用仍适用的已确认项。上传前确定 Storage 归属,分享前确定接收方;未指定期限默认72小时,接收方短码与 Host ACL 期限对齐,明确约定的期限优先,仅补问缺项或变化。
32
+ 2. 先查目标 Host 的 `ec agent template capabilities`;短用法查 `<动作> --help`。远程走该 Host 的受鉴权 template Menu,以其版本/schema 为准。
33
+ 如果返回 `DAEMON_OWNER_REQUIRED`,向当前 Agent 的 Owner 汇报来源、进度和阻塞,请 Owner 在与其 Agent 的私聊中发起所需操作;该会话仍须核验 Owner 是否为目标主机的 DaemonOwner。若不是,由目标主机 DaemonOwner 发起。不要在原 Agent-Agent 会话中重复重试。
34
+ 3. 临时文件放当前会话 `$TMPDIR`,长期包主动放项目目录。已有 `.ectpl` 直接 `preview --path PATH`。Storage 分享用 `pull --input-file FILE [--path PATH]`,省略 `--path` 时由 Host 在受管 TMPDIR 分配临时文件。仓库发行统一使用 `download RELEASE_ID --store AID --path PATH`,成功后直接 preview,无需再 pull。下载和安装不建立独立包缓存/索引;pack/push/publish 保留原有成品和 packageId 机制。仓库统一用 `--store AID`;身份按当前可信入口自动确定,详见下载和发布分册。
35
+ 4. 保存各阶段 requestId/jobId/结果,成功后再进入依赖步骤。退出码 0 可能只表示受理;按 status/phase/seq 跟踪,异常见第四部分。
36
+ 5. 只编辑采集副本,不改来源;排除记忆、会话、私钥、Provider 凭证及运行数据。按第一册逐类判断删除、变量替换、样例化或保留,保存处理约定;pack 检测不能代替内容分析。
37
+ 6. Agent 代办优先使用当前执行 Agent 自身 Storage,Owner Storage 主要通过 Evol App 完成;已有明确归属直接沿用。对外上传、分享或发布前,按第二册完成最终包与对外范围的 Owner 确认。上传、授权、消息回执分别核验。消息走当前会话 delegated sender。
38
+
39
+ inspect/collect/pack/push 与远程 pull 的 CLI 通式(替换动作、文件名和独立请求 ID):
40
+
41
+ ```bash
42
+ ec agent template <动作> --input-file "$TMPDIR/agent-template/<动作>.json" --request-id '<本次请求ID>' --format json
43
+ ```
44
+
45
+ ## 交付口径
46
+
47
+ 按实际阶段报告已封包/上传/授权/消息受理/安装,附摘要、位置、对应 ID 和未完成项。收到分享不自动安装;安装、升级按用户授权执行,消息成功不代表安装成功。
48
+
49
+ 平台仓库发布以业务任务 `state=completed` 且 `ok=true` 为准,交付真实 releaseId、版本、摘要和仓库位置。
50
+
51
+ 通用命令参考:`$KITS_DOCS/evolcore/agent.md`、`$KITS_DOCS/evolcore/storage.md`、`$KITS_DOCS/evolcore/fs.md`。按当前包根解析文档路径,内置和本机覆盖安装使用同一份命令文档。
@@ -0,0 +1,174 @@
1
+ # 采集和打包
2
+
3
+ 入口:[SKILL.md](../SKILL.md)。本册生成最终包,已有包转[上传和分享](02-upload-and-share.md)。
4
+
5
+ ## 1. 与用户明确用途和来源
6
+
7
+ 先读取下节约定的已有打包确认清单,沿用仍适用的决定;首次制作再了解模板给谁用、用于什么任务、复用哪些能力和资料,以及本次只制作本地包还是还需上传/分享。支持当前或同 Host Agent、schema 支持的模板目录;Agent 采集须通过操作者的 DaemonOwner 与来源 Agent 协议 Owner 核验。
8
+
9
+ 用户只说“帮我打包”时,不默认所有模块和整个项目全选。先根据用途提出建议,用实际候选补齐下节清单;已有明确选择和授权直接沿用。
10
+
11
+ 每个实际成员必须采集 config/profile,其余按需选择,不强制包含 project:
12
+
13
+ | 模块 | 内容与 collect 的 include |
14
+ | --- | --- |
15
+ | config | 行为配置、默认基座的 Provider/模型/推理强度引用;`{baseagents:[默认基座]}`,不打包其他基座配置或 access 访问设置 |
16
+ | profile | agent.md 展示字段、头像原 URL、welcome;`{}` |
17
+ | soul | 常驻设定分册;`{files:[分册名]}`,空说明文件不代表成熟人格 |
18
+ | skill | 仅选中技能的开关与附属资源;`{skills:[技能名]}`,不自动附带内置或继承开关 |
19
+ | trigger | Trigger 定义与脚本;`{triggers:[ID]}` |
20
+ | event | 事件包;`{events:[ID]}` |
21
+ | service | 服务包;`{services:[ID]}` |
22
+ | project | 项目知识、代码、素材和样例;`{}`,另需 selectionIndex |
23
+
24
+ ### Owner 要求的四轮确认
25
+
26
+ 当前 Owner 已明确要求模板范围分四轮逐项确认。首次制作或选择有变化时,inspect 后按以下顺序分四次询问;每次只提出当前一轮,等 Owner 回答并将决定写入本次 `pack-plan.md` 后,再进入下一轮。不能把四轮合并成一份总确认,也不能把摘要、未回答或上一轮的“确认”当作后续轮次的同意。既有、仍适用的偏好可以在该轮明确列为沿用项,请 Owner 确认是否有变化。
27
+
28
+ | 轮次 | 必须展示的实际候选与选择 |
29
+ | --- | --- |
30
+ | 1. 基础设置 | 对照 capabilities/schema 列出支持的 baseagent、来源实际基座、模型与推理强度、支持平台/操作系统;跨主机模板默认移除来源 Provider ID,且不包含凭证。逐项列出盘点值和可选变更。 |
31
+ | 2. 名片与 soul | 列出名片每个可采集字段及实际值;逐份列出所有 soul 文档、是否有有效正文及其主题,区分空分册、填写指南和可复用设定,说明拟保留、变量化或排除的内容。 |
32
+ | 3. 自主任务、技能、事件包与服务包 | 分别列出每个自主任务/Trigger、技能及其用途和依赖、事件包、服务包;技能须区分文件来源、最终启用状态和开关生效层级,本机共享不等于来源 Agent 显式启用。没有候选的类别明确写“无”。逐项给出纳入或排除选项,不用数量汇总代替清单。 |
33
+ | 4. 项目目录 | 展示来源实际项目路径、与用途相关的目录/文件清单、候选文件和依赖;共享目录逐项核对归属,归属未明的内容不自动纳入。明确整目录或逐项范围、排除项、目标包内落点及路径变量处理。不能只用“项目目录”概括。 |
34
+
35
+ 操作系统展示为 Linux、macOS、Windows,字段仍使用 `linux`、`darwin`、`win32`。来源基座(如 `dsh`)不在当前 schema 支持范围,或平台声明被拒时,说明具体限制并确认取舍;不得自行映射成另一基座或缩减平台后继续对外交付。来源系统不代表其他平台已经实测。
36
+
37
+ 每次模板制作都要以来源 Agent AID 和模板 ID 标明偏好归属,将四轮答案、未选项、确认时间及消息/话题依据写入该次 `pack-plan.md`;在 `$AGENT_DIR/index/INDEX.md` 建立按来源 Agent 可查的入口。不同来源 Agent 的选择不得混用。将过往选择沿用为默认之前,核实来源和资源仍匹配,并区分可复用偏好与该模板的一次性授权;有变化只询问受影响的轮次,保留变更记录。
38
+
39
+ ## 2. 按模块 inspect → 确定采集范围 → collect
40
+
41
+ 每模块独立 inspect,以下 JSON 替换来源和成员 key,保存为 `$TMPDIR/agent-template/inspect.json`,按入口通式执行:
42
+
43
+ ```json
44
+ {"module":"profile","members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}
45
+ ```
46
+
47
+ inspect 是只读盘点,可以先执行。确认 succeeded,保存 jobId、result.inventoryDigest 和候选资源,再向用户说明具体建议:
48
+
49
+ | 确认事项 | 需要确定的内容 |
50
+ | --- | --- |
51
+ | 来源和成员 | 哪个 Host、哪些 Agent/目录及成员 key;不得混淆执行者与来源 |
52
+ | 模块和资源 | 默认基座沿用来源配置;除必需 config/profile 外选哪些模块、soul 分册、技能、Trigger、事件包、服务包;project 选哪些目录/文件 |
53
+ | 排除和脱敏 | 私有资料及不分享的内容,个人/组织信息保留或替换的范围;凭证和运行数据始终排除,不展示原始秘密 |
54
+ | 模板信息 | ID、显示名、版本、平台;尚不能确定的平台须核实依赖后补齐 |
55
+
56
+ 每轮用简短清单列出本轮已有选择、推荐项和待定项,只询问会影响本轮结果的缺项;不能把建议或未回答当作同意。按轮次盘点并确认,相关范围明确并获授权后再 collect。用户已委托在指定范围内自行取舍时,按授权执行并报告选择。上传归属、接收方及期限按[第二册](02-upload-and-share.md)确定,已明确的无需重复询问。
57
+
58
+ ### 保存并复用打包确认清单
59
+
60
+ - 确认后将决定持久保存为执行 Agent 的 `$AGENT_DIR/output/agent-template/<templateId>/pack-plan.md`,在其索引登记并告知用户位置;不能只留在聊天或 `$TMPDIR`。已约定其他持久位置时沿用,并在索引保留入口。
61
+ - 保存用途、来源 Host/Agent/目录及成员 key、所选模块和具体资源、项目整选/部分选择与排除项、脱敏约定、模板元数据/版本规则、依赖与平台;记录确认人、时间、确认消息或话题引用及授权适用范围。待定项明确标记,上传/分享的选择随确认补齐,不保存凭证或访问短码。
62
+ - 下次先读清单,再用本次 inspect 核对来源和资源是否仍适用;适用项直接执行,只询问缺项、冲突或超出原约定的变化。目录整选沿用原递归规则,范围内新增合格文件不逐个重问;未约定纳入的模块或资源不自动全选。
63
+ - 用户确认变更后更新原清单并保留简短变更记录。每次重新生成绑定当前 inspect 的 selectionIndex 和请求,旧 jobId、摘要或授权回执仅用于追溯,不能代替本次盘点及权限核验。
64
+ - 清单是制作约定,采集副本、作业回执和包摘要另行保存;该清单默认排除在分享包外,不写入 `team.json`,不把其中的私人信息带入模板。
65
+
66
+ skill 模块的 member.skills 只包含 include.skills 选中项。编辑副本删除某项声明后,pack 沿用声明筛选资源,不携带该技能目录;不展开来源 Host 的默认技能开关。
67
+
68
+ config 模块的行为配置只采集来源 defaults.json 与 Agent config.json 中的显式设置,不写入 Schema 自动补出的默认值。部分配置只保留已设置的子字段;显式值即使与默认值相同也保留。未设置的行为参数由安装目标的默认配置生效。
69
+
70
+ collect 引用原 inspect,模块/成员 key 一致。例如 profile 的 collect.json:
71
+
72
+ ```json
73
+ {"module":"profile","inspectionJobId":"<实际inspect作业ID>","inventoryDigest":"<实际sha256摘要>","members":{"writer":{"include":{}}}}
74
+ ```
75
+
76
+ inspect 不冻结;collect.freeze 默认 false,可活跃自打包。显式 true 只冻结采集期,忙碌报 AGENT_BUSY。各模块独立 jobId,失败只重做对应模块;全部所选模块 succeeded 才可 pack。
77
+
78
+ ## 3. project 的选择索引
79
+
80
+ 仅 project 需要本节。inspect 不返回全量文件树,按需通过 file.list 或本地受鉴权入口浏览,展示相关候选及缺项。
81
+
82
+ 将具体目录/文件、整选或部分选择、排除项纳入第二节的范围清单;用户未选择时,不默认整选项目。
83
+
84
+ 索引保存在当前 `$TMPDIR`,格式如下;成员 key 必须完整,不带资料的成员 entries=[]:
85
+
86
+ ```json
87
+ {
88
+ "schemaVersion":1,
89
+ "inspectionJobId":"<实际project inspect作业ID>",
90
+ "inventoryDigest":"<实际sha256摘要>",
91
+ "members":{"writer":{
92
+ "projectRevision":"<实际projectRevision>",
93
+ "entries":[{"path":"docs","type":"directory"},{"path":"examples/demo.json","type":"file"}]
94
+ }}
95
+ }
96
+ ```
97
+
98
+ 整选目录递归采集当前合格文件,部分选择只列所选项;展开浏览不改变选择。删除跳过、修改读当前内容,非空选择最终无文件报 PROJECT_FILES_EMPTY。索引最多 8 MiB、每成员 20,000 项,以 capabilities 为准。
99
+
100
+ 按 UTF-8 实际字节算 size 和 sha256,上传索引:
101
+
102
+ ```bash
103
+ ec storage upload <当前AgentAID> "$TMPDIR/agent-template/selection.json" /template-input/selection.json --format json
104
+ ```
105
+
106
+ 核实上传后定向授权来源 Host(见[第二部分](02-upload-and-share.md)),project collect 额外传:
107
+
108
+ ```json
109
+ {"selectionIndex":{"location":{"aid":"<索引Storage所有者AID>","path":"/template-input/selection.json"},"download":{"shareId":"<实际十位短码>"},"digest":"<索引sha256摘要>","size":123}}
110
+ ```
111
+
112
+ 这段合入 collect 请求,不单独发送;size 替换为实际值。project 的 include 为 `{}`,不传 include.files;soul 的 include.files 仍有效。
113
+
114
+ ## 4. 阅读分析并修改副本
115
+
116
+ 成功 collect 的本机 result.workspace 或远端 workspaceRef 指向副本,远端经受鉴权文件入口访问。每模块有 `<workspace>/<memberKey>/member.json` 和 `files/`;project 资料在 `files/workspace/<memberKey>/`,其 member.json 为空对象。
117
+
118
+ ### 4.1 按用途和语义决定处理动作
119
+
120
+ 先读已保存清单,再实际阅读所选内容。对每类信息依次判断:是否为模板用途所需、是否应随安装对象变化、是否包含凭证或未经约定分享的资料。长文分段阅读;不能仅按文件名或字符串外形判定。
121
+
122
+ | 内容及语义 | 处理规则 |
123
+ | --- | --- |
124
+ | 私钥、密码、Token、Cookie、连接凭证、带凭证的链接 | 移除真实值;不使用部分遮罩保留秘密。配置中的凭证字段整体删除;跨主机模板默认删除来源 Provider 引用,保留模型、推理强度及必要参数,由目标环境选择可用 Provider。已明确约定保留的引用除外,凭证始终不携带;脚本确需凭证时按下节改成目标程序实际支持的读取方式 |
125
+ | 表示“本 Agent / 当前 Owner / 当前 Host”的身份引用 | 使用相应模板变量;表示团队内部成员时使用真实成员 key 的成员变量。复核权限、投递对象和个人资料中的语义,不能把作者或外部服务身份一律当作安装目标 |
126
+ | 来源项目绝对路径、本机工具和环境依赖 | 项目内路径优先改为正确的相对路径,确需项目根目录时用支持的路径变量;外部工具路径改用可配置方式并说明要求,不能用项目变量替代所有绝对路径 |
127
+ | 姓名、电话、地址、账号、订单及客户记录等私人信息 | 用途不需要则删除;仅为说明结构或流程时换成一致的合成样例,例如“示例客户”,不保留可拼回原信息的遮罩片段;确需真实资料时沿用明确的分享范围,缺少决定只询问该项 |
128
+ | 内部业务资料、组织信息、非公开代码或素材 | 按已确认用途和分享范围选择保留、概括或样例化;不相关或明确不分享的内容排除。改写须保持技术含义、数据结构和必要约束 |
129
+ | soul 的人格、职责、行为规则及 welcome | 保留可复用设定;将只属于来源 Owner 的私有关系和经历按约定删除或泛化。改变核心人格、职责或功能时说明影响并确认差异 |
130
+ | 外部联系人、第三方服务地址、公开文档及素材链接 | 必需且在约定范围内的固定依赖保留并说明用途;无关私有联系人删除。原公开头像 URL 保留来源地址,含临时凭证或私有授权的 URL 改用获准公开链接或省略 |
131
+ | 图片、PDF、Office 文档、压缩包、二进制或非 UTF-8 文件 | 用相应工具检查可见内容、嵌入内容和元数据;其中个人信息按上述规则处理。无法检查的内容标明未核实,不能以 pack 未报错认定已脱敏;依照已确认范围处理,必要取舍只询问该项 |
132
+
133
+ 始终排除 `.git`、`.claude`、`.env*`、node_modules、密钥、运行数据库和会话、日志及 `.template-work`。collect 会按已知来源值替换部分身份/路径,仍须复核替换后的语义;公开地址不等于其中所有内容均适合本次分享。
134
+
135
+ ### 4.2 使用确实可解析的替换方式
136
+
137
+ | 替换方式 | 适用范围与约束 |
138
+ | --- | --- |
139
+ | `{{agent.aid}}`、`{{owner.aid}}`、`{{host.aid}}`、`{{project.path}}` | 模板内当前 Agent、Owner、Host 和项目根目录,安装时由目标上下文渲染 |
140
+ | `{{members.writer.aid}}`、`{{members.writer.project}}` | 团队成员引用;writer 是示例,须换为本次实际声明的成员 key,成员改名时同步引用 |
141
+ | 环境变量或目标程序的配置入口 | 仅在目标组件实际支持时使用。Shell 示例 `API_KEY=${OWNER_API_KEY}`,Node 脚本可读取 `process.env.OWNER_API_KEY`;目标环境需另行配置,模板系统不自动注入这些值 |
142
+ | 合成样例或说明文字 | 用于文档和样例数据,明确其示例性质;不能放进执行字段冒充有效身份、路径、凭证或地址 |
143
+
144
+ 不能自行发明 `{{API_KEY}}`、`{{客户名称}}` 等自动填值变量。JSON 按结构修改字符串值,保留类型和转义;脚本按其语言读取配置,不能把 `${ENV}` 当作所有文件通用的插值语法。配置中的禁用凭证字段即使填入占位符也会被拒绝,不能靠更名、编码或拆分隐藏真实值。
145
+
146
+ ### 4.3 保存规则并复核结果
147
+
148
+ - 将处理约定写回 `pack-plan.md`:适用的文件/字段和语义角色、删除/变量化/样例化/保留动作、使用的变量或样例、必要保留理由、目标需补齐的配置,以及确认依据。不记录原始秘密,后续按规则处理新内容,只询问超出原约定的差异。
149
+ - 逐项检查关联说明、样例、脚本和资源引用是否一致,变量是否可解析,删改是否破坏语法、结构、依赖或业务含义。明确外部工具、平台及安装后需提供的配置。
150
+ - 保持模块目录边界,新增资料进 project;缺依赖须补采对应模块,新增模块或扩大文件范围先确认变化。符合已确认规则的常规处理直接完成。
151
+ - pack 对 UTF-8 明文按凭证特征拦截,主要包括密钥前缀、私钥头及部分密钥赋值形式;会跳过二进制/非 UTF-8 内容,不替 Agent 判断普通个人或业务信息。命中后回到副本按语义处理,不反复改写来绕过规则;未命中也不等于脱敏完成。
152
+
153
+ 没有 scan-report/review-scan、findingId 放行或 artifact 管理步骤。
154
+
155
+ ## 5. pack 并核实结果
156
+
157
+ 封包前对照已保存清单核对实际所含模块/资源、删改和脱敏摘要、外部依赖及 ID/显示名/版本/共同支持的平台。符合已确认范围即可继续;有影响用途或范围的变化,只确认差异并更新清单后再 pack,不要求用户重复批准原清单。目标已有不同内容的同版本包时须改版本。
158
+
159
+ 保存 pack JSON,collections 引用成功 collect 作业,不引用 inspect 作业:
160
+
161
+ ```json
162
+ {
163
+ "metadata":{"id":"writer","name":"写作助理","version":"1.0.0","platforms":["linux"]},
164
+ "members":{"writer":{"collections":[{"jobId":"<config collect作业ID>"},{"jobId":"<profile collect作业ID>"}]}}
165
+ }
166
+ ```
167
+
168
+ 同成员的模块须同来源、同成员 key。多成员扩展 members,外部联系人用 memberReferences.external,参数查 capabilities。pack 从编辑副本重新算摘要,不重采集,产出 v1 包。
169
+
170
+ 后续要发布到平台仓库时,在 pack 顶层指定 `"publisherIdentity":"agent"` 或 `"host"`,由 Core 读取真实连接身份写入 PACKAGE.publisher.aid;与后续 publish 的第三个参数保持一致。agent 是当前执行 Agent,host 是当前 daemon 的控制身份。未指定仍沿用原操作者署名;publish 不修改已封包署名,不匹配时需重新 pack。记录原选择供后续沿用;metadata 和成员版本仍按现有要求明确填写,不自动继承或接受空值。
171
+
172
+ 封包自动移除 team.json 顶层及成员层的 resources 盘点字段;文件清单/摘要由包内 MANIFEST.json 生成,安装配置与技能状态等声明保留。
173
+
174
+ 确认 succeeded,保存 packageId/path/digest/size/metadata/memberKeys;push/publish 沿用 packageId,本机 preview 使用 result.path,后续映射取真实 memberKeys。SENSITIVE_CONTENT 仅返回路径/行号,改副本后新 pack,详见[恢复](04-upgrade-and-recovery.md)。交付列出所含模块、排除项和外部依赖。
@@ -0,0 +1,109 @@
1
+ # 上传和分享
2
+
3
+ 入口:[SKILL.md](../SKILL.md)。packageId 可直接上传;已有 Storage 包核实位置/摘要/元数据后直接分享。
4
+
5
+ 需要正式发行时,转[发布到平台仓库](05-publish-to-platform.md),继续执行 publish 和 status 核验。
6
+
7
+ 对外上传、分享或发布前,向 Owner 展示最终包的 packageId、digest、size、所含内容、平台、验证结果、Storage 归属、准确的接收方或仓库 AID,以及适用的授权期限。默认 72 小时也须明确写出。取得针对该包和本次对外范围的确认后再执行;相同摘要与范围的已有确认可沿用,包或范围变化只确认差异。仅制作模板不代表已授权对外操作。
8
+
9
+ 最终包先按[第三册](03-download-and-install.md)做 preview,报告兼容性提示与未解决项;无法预览时说明原因,由 Owner 决定是否继续。需要 deploy 自测时仅在已获授权的隔离环境执行,不能默认创建或覆盖真实 Agent;未做部署或业务验证如实标明。核对接收方使用明确授权的 AID,`firstContact=true` 本身不代表越权,也不要求先加入联系人。
10
+
11
+ ## 1. 选择存储归属并上传
12
+
13
+ Agent 代办制作、上传和分享时,未另有明确约定,优先上传到当前执行 Agent 自身 Storage,并由其完成授权分享;无需再为默认存储路线单独询问。为其他 Agent 打包时,默认仍使用执行者自身空间。将实际存储所有者 AID 和所选路线写入 `pack-plan.md`,后续沿用。
14
+
15
+ 用户明确选择 Owner Storage 或使用 Evol App 的 Owner 上传流程时,保留该路线,由 App 完成 Owner 侧授权和分享。分享已有包时沿用其实际存储位置,无需为适配默认路线重新上传。
16
+
17
+ | 路线 | 实际上传者与前置授权 | 分享由谁执行 |
18
+ | --- | --- | --- |
19
+ | 当前执行 Agent Storage(Agent 代办优先) | 当前 Agent 的真实连接上传自身空间 | 当前 Agent 的 storage share 与 fs ACL |
20
+ | Owner Storage(主要由 Evol App 完成) | Owner App 授予来源 Host 模板目录 rw,Agent 发起 push,Host 上传 | Owner App 使用 Owner SDK |
21
+
22
+ location.aid 是 Storage 所有者,非接收人或投稿仓库。跨 AID 上传须授权 Host,给 Agent 授权不能替代;托管 storage share 只操作自身,不能填 Owner AID 代办 Owner 分享。
23
+
24
+ push JSON 的路径必须符合 metadata 的 ID/版本:
25
+
26
+ ```json
27
+ {"packageId":"<实际packageId>","location":{"aid":"<选定Storage所有者AID>","path":"/templates/writer/writer-1.0.0.ectpl"}}
28
+ ```
29
+
30
+ 按入口通式 push,确认 succeeded,保存 location/digest/size/metadata。Owner 路线交接 App 创建授权和卡片;以下用于 Agent 自身 Storage。
31
+
32
+ 需要回读或取得卡片元数据时:
33
+
34
+ ```bash
35
+ ec fs cp <当前AgentAID>:/templates/writer/writer-1.0.0.ectpl "$TMPDIR/agent-template/download.ectpl" --format json
36
+ ```
37
+
38
+ 比对 SHA-256;确需覆盖加 --overwrite。从本地包读取 PACKAGE.json 与成员 profile 展示字段;包结构校验见[第三部分](03-download-and-install.md)。
39
+
40
+ ## 2. 授权接收方及安装 Host
41
+
42
+ 将私有短码请求保存为 `$TMPDIR/agent-template/share.json`:
43
+
44
+ ```json
45
+ {"action":"create","requestId":"<本次分享请求ID>","path":"/templates/writer/writer-1.0.0.ectpl","allowedAids":["recipient.agentid.cn"],"expireInSeconds":259200,"maxUses":0}
46
+ ```
47
+
48
+ ```bash
49
+ ec storage share <当前AgentAID> --input-file "$TMPDIR/agent-template/share.json" --format json
50
+ ```
51
+
52
+ 核实退出码 0、state=succeeded、有效 result.share_id。接收方可在 App 选择 Host 时,另授予其直接 Host 条件读 ACL:
53
+
54
+ ```bash
55
+ ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -m '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}},"perms":"r","max_uses":0}' --expires '<实际到期Unix秒>' --format json
56
+ ```
57
+
58
+ 替换身份、路径和到期值。未指定期限时默认72小时(259200秒),ACL 取与短码对齐的到期 Unix 秒;明确约定的期限优先,明确永久才两者均填 0。expireInSeconds 为时长,expires_at/--expires 为到期时间,不能照抄数值;有限 max_uses 在整条规则内共享。
59
+
60
+ 规则使用 Ownership direct AND 可信 card.type=[host]、perms=r,Storage 动态核验归属。核实退出码 0、ok=true 和实际规则回执;两授权均成功才发卡,接收人不匹配 Host 条件,仍需短码。
61
+
62
+ 仅指定 Host 时,allowedAids 填实际 Host,无需动态 ACL;交付 location/shareId/digest/授权对象/期限。
63
+
64
+ project 索引临时分享同样使用 create,将 allowedAids 限定为实际来源 Host;不发送模板卡片。
65
+
66
+ ## 3. 发送 v2 模板卡片
67
+
68
+ 保存对象本身到 `$TMPDIR/agent-template/template-share-card.json`;替换示例值,expires_at 占位须换数值,不包外层 payload:
69
+
70
+ ```json
71
+ {
72
+ "type":"agent.template.share","schema_version":2,
73
+ "share_id":"tshare-<本次卡片UUID>","chat_id":"<实际chat_id>","text":"Agent 模板:写作助理",
74
+ "location":{"aid":"sender.agentid.cn","path":"/templates/writer/writer-1.0.0.ectpl"},
75
+ "publisher":{"aid":"sender.agentid.cn","name":"分享者"},
76
+ "recipient_download":{"aid":"recipient.agentid.cn","shareId":"<真实十位短码>","url":"<真实回执url>","share_url":"<真实回执share_url>"},
77
+ "template":{"id":"writer","version":"1.0.0","name":"写作助理","description":"模板简介","digest":"<实际sha256摘要>","size":12345,"compat":{"platforms":["linux"],"baseagents":["codex"]}},
78
+ "expires_at":<实际到期Unix秒>,"note":""
79
+ }
80
+ ```
81
+
82
+ - template 取真实封包结果/PACKAGE.json,avatar 取包内 profile,可选值缺失则省略。
83
+ - recipient_download 取真实短码和 URL 回执;publisher 为实际发送者,不改包内 publisher。
84
+ - expires_at 取两授权最早到期秒,均永久才为 0;每接收方独立业务 share_id,发送重试保留,勿混用 Storage 短码。
85
+ - chat_id 取实际会话;投递由 --to/--thread 决定。
86
+
87
+ ```bash
88
+ ecmsg send --thread main:<本端AID>:<接收方AID> --payload-file "$TMPDIR/agent-template/template-share-card.json" --encrypt yes --format json
89
+ ```
90
+
91
+ 单独发送并核验回执;App v2 渲染、真实动态 ACL 按实际联调情况说明,不能用模拟测试证明对端可安装。
92
+
93
+ 接收方为 Agent 时,同一张卡片由 Core 校验后进入私聊模型会话,展示发送方、模板名称、版本、摘要和有效期;完整卡片保存为该 Agent 的 JSON 附件,入模文本和历史保留文件引用。无需另发一条通知,卡片也不附加要求通知 Owner 的指令。联系人准入及私聊提及规则仍生效;AUN `delivered` 只证明传输送达,不能代替对端处理确认。下载权限及拒绝后的处理见[下载和安装](03-download-and-install.md)。
94
+
95
+ 需要附件交付时单独发送本地包,附件不替代授权:
96
+
97
+ ```bash
98
+ ecmsg send --file "$TMPDIR/agent-template/download.ectpl" --as file --text 'Agent 模板包'
99
+ ```
100
+
101
+ ## 4. 撤销与部分成功
102
+
103
+ 撤销接收方短码使用 `ec storage share` 的 `action=revoke`、独立 requestId、原 shareId。撤销动态 Host ACL:
104
+
105
+ ```bash
106
+ ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -x '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}}}' --format json
107
+ ```
108
+
109
+ 分别核验两项撤销。同对象同接收方的 ACL 被多卡共用,撤销影响这些卡片;撤销不会删除已下载副本。部分成功与未知结果见[恢复](04-upgrade-and-recovery.md)。