evolcore 0.0.43-test.6 → 0.0.43-test.7

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 (197) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/bin/ecmsg.js +171 -54
  3. package/dist/agents/baseagent-availability.js +1 -1
  4. package/dist/agents/codex/app-server-client.js +22 -0
  5. package/dist/agents/codex-runner.js +69 -2
  6. package/dist/aun/msg/p2p.js +6 -1
  7. package/dist/channels/aun.js +234 -21
  8. package/dist/cli/agent-create.js +2 -2
  9. package/dist/cli/daemon-commands.js +6 -66
  10. package/dist/cli/daemon-lifecycle-client.js +61 -0
  11. package/dist/cli/ecmsg-gateway.js +35 -2
  12. package/dist/cli/events-command.js +73 -0
  13. package/dist/cli/index.js +31 -14
  14. package/dist/cli/invoke-command.js +182 -0
  15. package/dist/cli/managed-command-guard.js +6 -1
  16. package/dist/cli/restart-monitor.js +45 -47
  17. package/dist/cli/services-command.js +111 -0
  18. package/dist/cli/team-workspace-command.js +134 -0
  19. package/dist/cli/thread-command.js +6 -2
  20. package/dist/cli/watch-msg.js +1 -1
  21. package/dist/config/config-field-policy.js +2 -2
  22. package/dist/config/config-manager.js +0 -7
  23. package/dist/config/invoke-ipc-service.js +118 -0
  24. package/dist/config/schema-migration.js +6 -1
  25. package/dist/config-store.js +2 -1
  26. package/dist/core/agent-reload-coordinator.js +6 -4
  27. package/dist/core/agent-runtime.js +104 -10
  28. package/dist/core/auth/delegation-authorization.js +66 -0
  29. package/dist/core/auth/operation-catalog.js +20 -0
  30. package/dist/core/baseagent-loader.js +60 -130
  31. package/dist/core/channel-loader.js +10 -1
  32. package/dist/core/channel-runtime.js +4 -3
  33. package/dist/core/command/agent-control.js +1 -1
  34. package/dist/core/command/agent-storage-menu.js +1 -1
  35. package/dist/core/command/chatmode-config.js +2 -36
  36. package/dist/core/command/command-handler.js +53 -11
  37. package/dist/core/command/data-root-resolver.js +32 -23
  38. package/dist/core/command/eventcenter-menu.js +338 -0
  39. package/dist/core/command/menu-catalog.js +8 -0
  40. package/dist/core/command/menu-handler.js +198 -84
  41. package/dist/core/command/menu-protocol.js +60 -11
  42. package/dist/core/command/menu-query-batch.js +194 -0
  43. package/dist/core/command/slash-gate.js +1 -1
  44. package/dist/core/command/slash-handler.js +34 -42
  45. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  46. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  47. package/dist/core/command/team-workspace-initializer.js +2 -0
  48. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  49. package/dist/core/command/team-workspace-job-store.js +88 -0
  50. package/dist/core/command/team-workspace-management-service.js +2 -0
  51. package/dist/core/command/team-workspace-management-store.js +96 -0
  52. package/dist/core/command/team-workspace-management.js +265 -0
  53. package/dist/core/command/team-workspace-members-menu.js +88 -0
  54. package/dist/core/command/team-workspace-store.js +612 -0
  55. package/dist/core/command/team-workspace-team.js +193 -0
  56. package/dist/core/daemon-control.js +8 -5
  57. package/dist/core/daemon-lifecycle.js +132 -73
  58. package/dist/core/handoff/runtime.js +3 -3
  59. package/dist/core/invoke/executors/index.js +13 -0
  60. package/dist/core/invoke/executors/media.js +283 -0
  61. package/dist/core/invoke/executors/text.js +198 -0
  62. package/dist/core/invoke/invoke-service.js +157 -0
  63. package/dist/core/invoke/style-router.js +48 -0
  64. package/dist/core/invoke/types.js +19 -0
  65. package/dist/core/ipc-registration.js +46 -7
  66. package/dist/core/memory/consolidation.js +7 -5
  67. package/dist/core/message/aun-ipc-sender.js +147 -17
  68. package/dist/core/message/im-renderer.js +28 -84
  69. package/dist/core/message/message-bridge.js +4 -0
  70. package/dist/core/message/message-utils.js +10 -2
  71. package/dist/core/message/peer-mode.js +7 -34
  72. package/dist/core/message/response-engine.js +157 -54
  73. package/dist/core/message/send-options.js +7 -4
  74. package/dist/core/message/send-routing.js +43 -5
  75. package/dist/core/ownership/owner-resolver.js +7 -0
  76. package/dist/core/permission/ec-command-parser.js +3 -2
  77. package/dist/core/permission/protected-paths.js +12 -2
  78. package/dist/core/permission/shell-environment.js +9 -0
  79. package/dist/core/session/session-file-health.js +243 -0
  80. package/dist/core/session/session-fs-store.js +2 -3
  81. package/dist/core/task/task-recovery-service.js +13 -2
  82. package/dist/core/thread/command-parser.js +9 -2
  83. package/dist/core/thread/thread-operation.js +21 -2
  84. package/dist/core/thread/thread-route.js +13 -2
  85. package/dist/directory/owner-directory-admission.js +40 -53
  86. package/dist/directory/owner-directory-cache.js +89 -113
  87. package/dist/directory/owner-directory-query-operation.js +8 -10
  88. package/dist/eck/kit-renderer.js +7 -5
  89. package/dist/ecweb/basic-settings-service.js +1 -1
  90. package/dist/ecweb/message-context-service.js +0 -4
  91. package/dist/ecweb/runtime/lifecycle.js +6 -2
  92. package/dist/ecweb/runtime/supervisor.js +19 -4
  93. package/dist/event-center/admission-materializer.js +114 -0
  94. package/dist/event-center/bus-gate.js +136 -0
  95. package/dist/event-center/bus-host.js +290 -0
  96. package/dist/event-center/bus-resolver.js +120 -0
  97. package/dist/event-center/center-config.js +100 -0
  98. package/dist/event-center/client-factory.js +50 -0
  99. package/dist/event-center/daemon.js +45 -0
  100. package/dist/event-center/directory-source.js +53 -0
  101. package/dist/event-center/dispatcher.js +157 -0
  102. package/dist/event-center/event-log.js +110 -0
  103. package/dist/event-center/index-generator.js +63 -0
  104. package/dist/event-center/ipc-operation.js +308 -0
  105. package/dist/event-center/ledger.js +52 -0
  106. package/dist/event-center/pack-loader.js +202 -0
  107. package/dist/event-center/pack-manager.js +85 -0
  108. package/dist/event-center/registry.js +238 -0
  109. package/dist/event-center/runtime.js +641 -0
  110. package/dist/event-center/script-runner.js +356 -0
  111. package/dist/event-center/types.js +35 -0
  112. package/dist/event-center/validation.js +413 -0
  113. package/dist/index.js +285 -99
  114. package/dist/ipc.js +66 -12
  115. package/dist/paths.js +20 -0
  116. package/dist/product.js +14 -0
  117. package/dist/proxy/manager.js +5 -1
  118. package/dist/proxy/service-supervisor.js +13 -4
  119. package/dist/response-system/engines/v1/index.js +0 -1
  120. package/dist/response-system/modes/single-session/index.js +1 -1
  121. package/dist/services/dispatcher.js +100 -0
  122. package/dist/services/idempotency.js +90 -0
  123. package/dist/services/identity.js +52 -0
  124. package/dist/services/index-generator.js +70 -0
  125. package/dist/services/index.js +449 -0
  126. package/dist/services/ipc-operation.js +458 -0
  127. package/dist/services/ledger.js +52 -0
  128. package/dist/services/message-log.js +112 -0
  129. package/dist/services/pack-manager.js +204 -0
  130. package/dist/services/reply.js +55 -0
  131. package/dist/services/router.js +95 -0
  132. package/dist/services/script-runner.js +422 -0
  133. package/dist/services/service-payload.js +70 -0
  134. package/dist/services/types.js +18 -0
  135. package/dist/services/validation.js +297 -0
  136. package/dist/trigger/application-service.js +18 -0
  137. package/dist/trigger/event-source.js +1 -1
  138. package/dist/trigger/ipc-service.js +3 -1
  139. package/dist/trigger/script-sandbox.js +118 -22
  140. package/dist/utils/cross-platform.js +24 -10
  141. package/dist/utils/evolcore-version.js +69 -27
  142. package/dist/utils/instance-registry.js +19 -13
  143. package/dist/utils/process-introspect.js +45 -9
  144. package/dist/utils/startup-trace.js +74 -37
  145. package/dist/utils/windows-shell-trust.js +80 -6
  146. package/kits/docs/INDEX.md +2 -2
  147. package/kits/docs/aun/ABILITY_CALLING.md +7 -14
  148. package/kits/docs/context-assembly.md +1 -1
  149. package/kits/docs/evolcore/INDEX.md +2 -0
  150. package/kits/docs/evolcore/ability.md +4 -0
  151. package/kits/docs/evolcore/aid.md +1 -1
  152. package/kits/docs/evolcore/event-center.md +207 -0
  153. package/kits/docs/evolcore/file-navigation.md +10 -264
  154. package/kits/docs/evolcore/fs.md +3 -2
  155. package/kits/docs/evolcore/group.md +1 -1
  156. package/kits/docs/evolcore/memory-architecture.md +2 -0
  157. package/kits/docs/evolcore/menu-protocol.md +21 -0
  158. package/kits/docs/evolcore/msg.md +15 -3
  159. package/kits/docs/evolcore/provider.md +3 -1
  160. package/kits/docs/evolcore/response.md +5 -5
  161. package/kits/docs/evolcore/services.md +277 -0
  162. package/kits/docs/evolcore/task.md +2 -0
  163. package/kits/docs/evolcore/team-workspace.md +41 -0
  164. package/kits/eck_manifest.json +26 -0
  165. package/kits/rules/02-navigation.md +10 -1
  166. package/kits/schemas/_meta.json +17 -6
  167. package/kits/schemas/agent-config.schema.19.json +5 -7
  168. package/kits/schemas/agent-config.schema.20.json +936 -0
  169. package/kits/schemas/relation-config.schema.12.json +2 -3
  170. package/kits/schemas/role-config.schema.2.json +4 -4
  171. package/kits/skills/.switches.json +1 -5
  172. package/kits/skills/ability/SKILL.md +56 -0
  173. package/kits/skills/ability/references/calling.md +56 -0
  174. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  175. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  176. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  177. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  178. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  179. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  180. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  181. package/kits/skills/personal-assistant/SKILL.md +6 -6
  182. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  183. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  184. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  185. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  186. package/kits/templates/system-fragments/channel.md +3 -3
  187. package/kits/templates/system-fragments/commands.md +5 -3
  188. package/kits/templates/system-fragments/reply.md +0 -5
  189. package/kits/templates/system-fragments/thread.md +10 -8
  190. package/package.json +3 -5
  191. package/dist/cli/pa-workspace-command.js +0 -225
  192. package/dist/core/command/pa-workspace-store.js +0 -468
  193. package/dist/core/relation/pa-team.js +0 -132
  194. package/kits/docs/evolcore/pa-workspace.md +0 -51
  195. package/kits/skills/aid-ability/SKILL.md +0 -244
  196. package/kits/skills/ec-ability/SKILL.md +0 -67
  197. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -1,8 +1,12 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { spawnSync } from 'node:child_process';
3
+ import { execFile, spawnSync } from 'node:child_process';
4
+ import { promisify } from 'node:util';
5
+ const execFileAsync = promisify(execFile);
4
6
  const MAX_CACHE_ENTRIES = 128;
5
7
  const signatureCache = new Map();
8
+ const pendingCmdSignatures = new Map();
9
+ let signatureGeneration = 0;
6
10
  /**
7
11
  * The signer name is checked only after Authenticode reports a trusted chain.
8
12
  * Keep this list deliberately small: an unsigned or unknown Bash distribution
@@ -108,8 +112,8 @@ function isAppExecutionAliasPath(value) {
108
112
  function shellQuote(value) {
109
113
  return `'${value.replaceAll("'", "''")}'`;
110
114
  }
111
- function probeAuthenticode(filePath) {
112
- const script = [
115
+ function authenticodeScript(filePath) {
116
+ return [
113
117
  '$ErrorActionPreference = "Stop"',
114
118
  `$p = ${shellQuote(filePath)}`,
115
119
  '$item = Get-Item -LiteralPath $p -Force',
@@ -121,8 +125,10 @@ function probeAuthenticode(filePath) {
121
125
  ' issuer = if ($sig.SignerCertificate) { [string]$sig.SignerCertificate.Issuer } else { "" }',
122
126
  '} | ConvertTo-Json -Compress',
123
127
  ].join('\n');
128
+ }
129
+ function probeAuthenticode(filePath) {
124
130
  const result = spawnSync(systemPowerShellPath(), [
125
- '-NoLogo', '-NoProfile', '-NonInteractive', '-Command', script,
131
+ '-NoLogo', '-NoProfile', '-NonInteractive', '-Command', authenticodeScript(filePath),
126
132
  ], {
127
133
  encoding: 'utf8',
128
134
  env: systemPowerShellEnvironment(),
@@ -132,8 +138,11 @@ function probeAuthenticode(filePath) {
132
138
  });
133
139
  if (result.status !== 0 || result.error || !String(result.stdout || '').trim())
134
140
  return undefined;
141
+ return parseAuthenticode(String(result.stdout));
142
+ }
143
+ function parseAuthenticode(output) {
135
144
  try {
136
- const parsed = JSON.parse(String(result.stdout));
145
+ const parsed = JSON.parse(output);
137
146
  return {
138
147
  status: typeof parsed.status === 'string' ? parsed.status : undefined,
139
148
  subject: typeof parsed.subject === 'string' ? parsed.subject : undefined,
@@ -207,6 +216,10 @@ export function isTrustedWindowsShellExecutable(executable, kind) {
207
216
  export function resolveTrustedWindowsCmdPath(comSpec) {
208
217
  if (process.platform !== 'win32')
209
218
  return comSpec || 'cmd.exe';
219
+ const systemReal = resolveWindowsCmdCandidate(comSpec);
220
+ return systemReal && isTrustedWindowsShellExecutable(systemReal, 'cmd') ? systemReal : undefined;
221
+ }
222
+ function resolveWindowsCmdCandidate(comSpec) {
210
223
  const systemCmd = windowsSystemCmdPath();
211
224
  const candidate = (comSpec || process.env.ComSpec || process.env.COMSPEC || systemCmd).trim();
212
225
  if (!candidate)
@@ -230,9 +243,70 @@ export function resolveTrustedWindowsCmdPath(comSpec) {
230
243
  if (path.win32.normalize(candidateReal).toLowerCase() !== path.win32.normalize(systemReal).toLowerCase()) {
231
244
  return undefined;
232
245
  }
233
- return isTrustedWindowsShellExecutable(systemReal, 'cmd') ? systemReal : undefined;
246
+ return systemReal;
247
+ }
248
+ /** Async probes keep the same system-path and signature policy without blocking I/O callbacks. */
249
+ export async function resolveTrustedWindowsCmdPathAsync(comSpec) {
250
+ if (process.platform !== 'win32')
251
+ return comSpec || 'cmd.exe';
252
+ const systemReal = resolveWindowsCmdCandidate(comSpec);
253
+ if (!systemReal || isAppExecutionAliasPath(systemReal))
254
+ return undefined;
255
+ let stat;
256
+ try {
257
+ stat = fs.statSync(systemReal);
258
+ if (!stat.isFile())
259
+ return undefined;
260
+ }
261
+ catch {
262
+ return undefined;
263
+ }
264
+ const key = cacheKey(systemReal);
265
+ const cached = signatureCache.get(key);
266
+ if (cached && cached.size === stat.size && cached.mtimeMs === stat.mtimeMs) {
267
+ return cached.trusted ? systemReal : undefined;
268
+ }
269
+ const identity = `${key}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
270
+ let pending = pendingCmdSignatures.get(identity);
271
+ if (!pending) {
272
+ const generation = signatureGeneration;
273
+ pending = (async () => {
274
+ try {
275
+ const { stdout } = await execFileAsync(systemPowerShellPath(), [
276
+ '-NoLogo', '-NoProfile', '-NonInteractive', '-Command', authenticodeScript(systemReal),
277
+ ], { encoding: 'utf8', env: systemPowerShellEnvironment(), timeout: 5000, windowsHide: true });
278
+ const current = fs.statSync(systemReal);
279
+ if (generation !== signatureGeneration || !current.isFile()
280
+ || current.size !== stat.size || current.mtimeMs !== stat.mtimeMs || current.ctimeMs !== stat.ctimeMs
281
+ || resolveWindowsCmdCandidate(comSpec) !== systemReal)
282
+ return false;
283
+ const trusted = isTrustedShellSignature('cmd', parseAuthenticode(stdout) ?? {});
284
+ signatureCache.set(key, { size: stat.size, mtimeMs: stat.mtimeMs, trusted });
285
+ while (signatureCache.size > MAX_CACHE_ENTRIES) {
286
+ const oldest = signatureCache.keys().next().value;
287
+ if (!oldest)
288
+ break;
289
+ signatureCache.delete(oldest);
290
+ }
291
+ return trusted;
292
+ }
293
+ catch {
294
+ return false;
295
+ }
296
+ })();
297
+ pendingCmdSignatures.set(identity, pending);
298
+ }
299
+ try {
300
+ return await pending ? systemReal : undefined;
301
+ }
302
+ finally {
303
+ if (pendingCmdSignatures.get(identity) === pending)
304
+ pendingCmdSignatures.delete(identity);
305
+ }
234
306
  }
235
307
  /** Test hook: clear cached signature decisions after a fixture is replaced. */
236
308
  export function clearWindowsShellTrustCache() {
309
+ signatureGeneration++;
237
310
  signatureCache.clear();
311
+ pendingCmdSignatures.clear();
238
312
  }
@@ -18,9 +18,9 @@
18
18
  | 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
19
19
  | SDK 文档指引 | `aun/SDK.md` | AUN SDK 文档位置(`$AUN_SDK_DOCS`)、结构与常用入口;四语言版本共用同一份协议文档 |
20
20
  | 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
21
- | Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、JSON 文件调用、设备状态收集、ACK/等待与超时诊断 |
21
+ | Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、payload、设备状态收集和请求关联的协议参考;实际流程用 `ability` 技能 |
22
22
 
23
- EvolCore 能力插件体系的实施设计位于源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md`。该设计尚未实现,不是当前可用的 Ability 插件命令手册。
23
+ AUN Ability 规范与按任务选择提供、发现、管理和调用流程,统一从 `ability` 技能进入(`ec skill load ability`)。EvolCore 能力插件的现行命令语法见 `evolcore/ability.md`;源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md` 提供实施设计与交付状态,不代替随包命令手册。
24
24
 
25
25
  ## EvolCore 命令
26
26
 
@@ -1,11 +1,13 @@
1
- # AUN Ability 调用
1
+ # AUN Ability 调用
2
2
 
3
- 本文是 EvolCore 当前实现下的通用 AID Ability Caller 规程。它描述能力发现、原始 JSON
3
+ 本文是 EvolCore 当前实现下的通用 AID Ability Caller 协议与 transport 参考。它描述能力发现、原始 JSON
4
4
  传输和请求结果查询,不定义任何具体 Provider 的能力。Caller 从 Provider 发布的索引或在线发现
5
5
  结果中选择能力设备,再通过 AUN 传输层定向;EvolCore 不替 Caller 选择设备,也不提供 runtime 或 slot 寻址。
6
6
 
7
7
  与当前 EvolApp 互调采用 `aid-ability/2`、`aun.ability.index.v1` 和 `aun.ability.release.v1`。双方是独立 Provider/Caller;调用和 ACK/result 使用加密私聊,能力寻址为 Provider AID + path,设备只由 transport 选择。
8
8
 
9
+ 理解 AUN Ability 规范并选择提供、管理或调用流程时统一使用 `ability` 技能(`ec skill load ability`),仅按当前任务读取相应指南。本文是当前通用 Caller 协议与 transport 的事实参考;payload 中的 `aid-ability/2` 仅为 wire 协议版本标识。CLI 参数见 `$KITS_DOCS/evolcore/msg.md`、`$KITS_DOCS/evolcore/fs.md`、`$KITS_DOCS/evolcore/storage.md`,本地插件实例命令见 `$KITS_DOCS/evolcore/ability.md`。
10
+
9
11
  ## 边界
10
12
 
11
13
  EvolCore 负责:
@@ -31,7 +33,7 @@ EvolCore 不负责:
31
33
  推荐按三层发现:
32
34
 
33
35
  ```text
34
- L1 https://<provider-aid>/ability/index.json
36
+ L1 <provider-aid>:/ability/index.json
35
37
  发布者能力快照,可缓存但可能过期
36
38
 
37
39
  L2 protocol/discover
@@ -41,22 +43,13 @@ L3 detail_ref 指向的 JSON
41
43
  不可变能力契约,包含参数、结果、安全和幂等要求
42
44
  ```
43
45
 
44
- Provider 是当前 AUN 私聊对端时,托管会话直接读取明确的公开文本路径:
46
+ 通过 `ec fs cat` 读取该 Provider 发布的 L1 索引:
45
47
 
46
48
  ```text
47
49
  ec fs cat <provider-aid>:/ability/index.json
48
50
  ```
49
51
 
50
- 该入口只允许 `cat` 当前私聊对端,不开放目录枚举、其他 AID 或写操作;personal storage 仍按
51
- public/ACL 鉴权。单次读取预算默认及最高为 128 KiB,超限返回 FS_CAT_TOO_LARGE,不返回截断正文。
52
- 文件超出预算、Provider 不是当前私聊对端、文件非文本或者当前运行时尚不支持该入口时,
53
- 回退到下载,并把临时文件放在当前会话的 `$TMPDIR`:
54
-
55
- ```text
56
- ec storage download <self-aid> https://<provider-aid>/ability/index.json $TMPDIR/ability-index.json
57
- ```
58
-
59
- 能力发现不能依赖目录枚举;只读取明确的 `index.json` 和 `detail_ref`。
52
+ 能力发现不能依赖目录枚举;只读取明确的 `index.json` 和契约给出的 `detail_ref`。
60
53
 
61
54
  L1/L2/L3 中用于机器决策的字段只有结构化字段:
62
55
 
@@ -49,7 +49,7 @@ evolcore 收到消息 → 构造一份 **vars**(运行时变量,见下)→
49
49
  渲染时按 `session.sessionType`(缺省 `'main'`)依次查:`sessionManifests` 覆盖 → 内置映射 → `eck_manifest.json`(`resolveSessionManifest`)。bootstrapping 阶段固定用 `eck_manifest.json`。
50
50
  **每个 manifest 文件各自两级合并**(`$KITS/<file>` + `$ECK/<file>`),互不干扰。
51
51
 
52
- `chatMode=paactive` 是私聊文本展示分支,不是新的 `sessionType` 或独立上下文体系。active AUN 人类 Owner 私聊(含话题)继续使用按现有生命周期、sessionType 和 `sessionManifests` 选择的 system/message manifest,并复用基础 vars;`chatMode` 保持 `paactive`。派生变量 `activePush=true` 表示正式回复使用托管发送,供共用模板复用发送说明。Proactive 工具门禁变量仅在 proactive 任务注入。群聊固定 proactive;interactive 和 paactive 仅适用于私聊。
52
+ `chatMode` 只支持 interactive/proactive,均复用按生命周期、sessionType 和 sessionManifests 选择的 system/message manifest 与基础 vars。派生变量 `activePush` 仅在 proactive 时为 true,工具门禁变量也按 proactive 注入。PA 身份不改变 Agent 可见的模式、manifest 或 vars;仅在 active AUN 人类 Owner 私聊主会话及话题中,将 PA 的 proactive activity 经 message.send 可靠投递。其他 proactive 场景使用 thought.put,群聊固定 proactive。
53
53
 
54
54
  ## section 字段
55
55
 
@@ -83,6 +83,8 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
83
83
  | `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
84
84
  | `ec trigger` | 定时与事件触发器管理(创建用 `create`,`set` 为兼容别名) | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
85
85
  | `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
86
+ | `ec events` | AUN 事件中心:注册/发布/订阅事件,事件到达跑脚本 | 事件中心/注册事件/发布事件/订阅事件/事件包/pack.json/center.json/事件处理脚本/AUN 事件 | `event-center.md` |
87
+ | `ec services` | 服务路由:服务包状态/诊断/重载,对端 describe/schema/call | 服务路由/服务包/提供接口/被对端调用/service.json/services.call/服务节点 | `services.md` |
86
88
  | `ec task` | 恢复暂停或异常中断的会话任务 | 任务恢复/异常中断/继续任务/resume | `task.md` |
87
89
  | `ec skill` | EC 技能管理(新建/安装/删除/启用/禁用/校验/查路径) | 创建技能/新建 skill/安装技能/装个 skill/删除技能/禁用技能/启用技能/看看有哪些技能/技能为什么没生效 | `ec-capabilities.md` |
88
90
  | `ec pa-workspace` | 在 Owner 的 AUN 私聊中查看和维护 PA 工作区入口导航 | 个人助理工作区/工作区入口调整/产物入口/报告入口/任务入口/隐藏入口/改名入口/排序入口 | `pa-workspace.md` |
@@ -2,6 +2,10 @@
2
2
 
3
3
  本手册描述已经实现的 CLI。默认输出 JSON;每条 `ec` 命令单独执行。下列 `<...>` 为实际运行结果或用户指定值,不能原样提交。
4
4
 
5
+ `ability` 技能介绍 AUN Ability 规范并组织提供、发现、管理和调用任务(`ec skill load ability`);本手册只维护 EvolCore 插件开发、实例管理与本地调用命令的语法和行为。远端 AUN 发现与调用协议见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。
6
+
7
+ `ec ability invoke` 调用宿主内可管理的已安装实例,不是远端 AUN 调用。当前没有 `ec ability remote` 命令;远端发现、设备选择和调用由同一技能衔接 `$KITS_DOCS/aun/ABILITY_CALLING.md` 与 `ec fs`/`ec msg`,无需另装 Caller 技能。
8
+
5
9
  ## 身份与命令发现
6
10
 
7
11
  ```text
@@ -139,7 +139,7 @@ Owner 目录同步在连接可用时建立单条核验和暂态故障退避链
139
139
 
140
140
  Ownership 任务事件、修改本地 Owner 配置、相关名片或 Owner 关系材料变更只失效缓存,不主动发起复核。连接首次就绪、断线恢复和缓存到期均不触发提前刷新;下次实际消息、查询或授权需要 Owner 时才等待核验。相同任务事件和连接通知去重,无关对端、普通文件变更不触发失效。远端 Owner 的 Storage 事件只在本机确实收到时生效,不能假定事件完整覆盖远端变化。Owner 绑定提交前及修改 Owner 的授权仍要求显式核验成功。
141
141
 
142
- 生命周期有效的普通 Agent(包括已经 `active` 的存量 Agent)在 AUN 连接就绪后,优先取根级 `config.json.owner`,缺失时兼容旧 `owners` 数组的首个非空 AID;沿用首个配置 Owner 的选择规则,不向数组内所有 AID 发送邀约。没有绑定目标或生命周期无效时静默跳过。存在绑定目标且新鲜协议状态为 `unbound`、`released` 或 `single_sided` 时,每个 Agent 对同一 Owner 在本进程内最多自动提交一次绑定邀约,`active` 不再阻断启动补绑定。已有协议共识时不提交,也不自动转让 Owner。提交前记录 INFO 日志 `Submitting configured Owner binding invitation`,包含主体、目标 Owner 和协议状态;提交结果与失败继续记录 `EC_OWNERSHIP` 的 `bind.result` / `bind.failed`。等待确认、提交失败或回执不明均不定时重发,断线重连和渠道重建也不会再次提交;需要重发时显式执行绑定命令。自动尝试记录只保存在内存,不持久化;进程重启后重新检查并允许再自动提交一次。
142
+ 处于 `created`、`ownerpending` 或 `bootstrapping` 生命周期的普通 Agent 在 AUN 连接就绪后,优先取根级 `config.json.owner`,缺失时兼容旧 `owners` 数组的首个非空 AID;沿用首个配置 Owner 的选择规则,不向数组内所有 AID 发送邀约。没有绑定目标、生命周期无效或已经 `active` 时静默跳过,不因遗留配置重新绑定。存在绑定目标且新鲜协议状态为 `unbound`、`released` 或 `single_sided` 时,每个 Agent 对同一 Owner 在本进程内最多自动提交一次绑定邀约。已有协议共识时不提交,也不自动转让 Owner。提交前记录 INFO 日志 `Submitting configured Owner binding invitation`,包含主体、目标 Owner 和协议状态;提交结果与失败继续记录 `EC_OWNERSHIP` 的 `bind.result` / `bind.failed`。等待确认、提交失败或回执不明均不定时重发,断线重连和渠道重建也不会再次提交;需要重发时显式执行绑定命令。自动尝试记录只保存在内存,不持久化;进程重启后重新检查并允许再自动提交一次。
143
143
 
144
144
  普通 Agent 的创建、手动绑定、启动补绑定和转让,在提交关系修改前实时读取目标 Owner 的远端已验签名片,要求名片 AID 匹配且 `type: human`;非 human 返回 `INVALID_OWNER`,无法读取、未验签、类型缺失或名片不匹配返回 `OWNER_IDENTITY_UNAVAILABLE`。接受绑定或转让邀约也执行此限制;当前进程没有请求投影时,先从历史消息定位原请求的目标用于类型预检,原请求真实性及固定参与方仍由 SDK 在提交时核验。拒绝邀约不受目标类型限制。该限制面向普通 Agent,不把 daemon Control AID 的身份规则改成 Agent 规则,也不追溯修改已有协议关系。
145
145
 
@@ -0,0 +1,207 @@
1
+ # 事件中心(`ec events`)
2
+
3
+ > 状态:[done]
4
+ > 创建:2026-11-08
5
+ > 对应实现:`src/event-center/` 和 `src/cli/events-command.ts`。
6
+
7
+ Agent 怎么建事件包、写处理脚本、注册/发布/订阅事件。
8
+
9
+ > 完整设计见仓库 `docs/event-center/`;Schema 见 `docs/event-center/schema/`。
10
+ > 本文是运行时知识卡,与 `docs/event-center/usage.md` 保持同步。
11
+
12
+ ## 一、先判断该不该用
13
+
14
+ | 要做的事 | 用什么 |
15
+ | --- | --- |
16
+ | 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是事件中心 |
17
+ | 有事情发生时通知**别的 AID** | 事件中心 |
18
+ | 收到别人的通知后跑确定性逻辑 | 事件中心 |
19
+ | 收到通知后要模型判断、要写报告 | 事件中心 + 脚本里调 `ecmsg` |
20
+ | 消息绝不能丢 | 普通持久消息,**不是**事件 |
21
+
22
+ 事件是 TTL 内的在线通知:TTL 到期、断线、Bus 重启都会丢。没有历史、没有重放、没有业务 ACK。
23
+
24
+ ## 二、目录
25
+
26
+ ```
27
+ $AGENT_DIR/events/
28
+ ├── center.json # 只有"我要当事件中心"时才需要
29
+ └── <包名>/
30
+ ├── pack.json
31
+ ├── ledger.jsonl
32
+ ├── scripts/
33
+ └── logs/
34
+ ```
35
+
36
+ 包名用英文短横线,如 `meeting`、`order-watch`。
37
+
38
+ ## 三、三种角色
39
+
40
+ 一个 `pack.json` 里三类声明互相独立:
41
+
42
+ | 角色 | 写在哪 | 含义 |
43
+ | --- | --- | --- |
44
+ | 登记 | `register[]` | 让本 AID 成为这个事件的事件中心 |
45
+ | 发布 | `publish[]` | 往别人的事件中心发 |
46
+ | 订阅 | `subscribe[]` | 收别人的事件,收到就跑脚本 |
47
+
48
+ 只订阅时不需要 `center.json`。
49
+
50
+ ## 四、pack.json
51
+
52
+ ```json
53
+ {
54
+ "v": 1,
55
+ "name": "会议通知",
56
+ "register": [
57
+ { "event": "meeting.created", "description": "新会议", "ttl": 30 }
58
+ ],
59
+ "publish": [
60
+ { "bus": "$owner", "event": "meeting.created" }
61
+ ],
62
+ "subscribe": [
63
+ {
64
+ "bus": "$owner",
65
+ "event": "meeting.created",
66
+ "handler": { "script": "scripts/on-created.mjs", "runtime": "node", "timeoutMs": 15000 }
67
+ }
68
+ ]
69
+ }
70
+ ```
71
+
72
+ ### bus 写什么
73
+
74
+ `bus` **不写字面 AID**,写占位符:
75
+
76
+ | 写法 | 指向 |
77
+ | --- | --- |
78
+ | `$self` | 本 AID 自己的事件中心 |
79
+ | `$owner` | 本 Agent 的 Owner(Evol App 往这里发) |
80
+ | `$pa` | 本 Owner 的个人助理 |
81
+ | `$pa.<role>` | PA Team 里担任 `<role>` 的人 |
82
+ | `"a.b.agentid.cn"` | 字面 AID,只在对方明确给了地址时用 |
83
+
84
+ 包之所以写占位符:包是拿来拷给别的 Agent 的,写死 AID 拷过去就指向错的人。
85
+
86
+ 约束:
87
+
88
+ - `$pa.<role>` 匹配多个时,取 AID 字典序第一个,不报错。同一个包在不同 Agent 上解析结果稳定。
89
+ - `subscribe[]` 内部同一个 `(bus, event)` 只能出现一次(同理 `publish[]`);publish 与 subscribe 之间互不冲突,可以既发又订同一事件。
90
+ - `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接。
91
+ - `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断,推断不出即校验失败。
92
+ - 一个包校验失败只废这个包,其余照常启动。
93
+ - 占位符解析失败时按顶层 `busResolve` 处理:`strict`(缺省)停该包,`keep-last` 沿用上次结果。
94
+
95
+ ## 五、center.json
96
+
97
+ ```json
98
+ {
99
+ "v": 1,
100
+ "enabled": true,
101
+ "authMode": "allowlist",
102
+ "allowlist": {
103
+ "meeting.created": {
104
+ "allow": {
105
+ "publish": ["bus.example.cn"],
106
+ "subscribe": []
107
+ }
108
+ }
109
+ }
110
+ }
111
+ ```
112
+
113
+ `allow.publish` / `allow.subscribe` 为**空数组表示不额外限制**,非空则只放行列出的 AID;可再加 `deny`(命中即拒,优先于 `allow`)。不接受旧写法 `publish_aids` / `subscribe_aids`,也不接受 `"*"` 通配。白名单放行不等于能发——最终还要叠加联系人准入。
114
+
115
+ `enabled=false`(缺省)时本 AID 只作订阅方/发布方,不承接任何人的事件。同一个 AID 不能在两台机器上同时开事件中心(`DEVICE_CONFLICT`)。
116
+
117
+ 白名单**不写进 pack.json**:包会被拷走,白名单不能跟着走。
118
+
119
+ ## 六、脚本契约
120
+
121
+ ### stdin(一个 JSON)
122
+
123
+ ```json
124
+ {
125
+ "v": 1,
126
+ "pack": { "name": "meeting", "dir": "…/events/meeting" },
127
+ "bus": "bus.example.cn",
128
+ "event": {
129
+ "name": "meeting.created",
130
+ "id": "01J…",
131
+ "publisher": "bus.example.cn",
132
+ "receivedAt": 1794115720000,
133
+ "data": { "title": "周会" }
134
+ },
135
+ "agent": { "aid": "self.agentid.cn", "dir": "…" },
136
+ "paths": { "ledger": "…/ledger.jsonl", "logs": "…/logs" }
137
+ }
138
+ ```
139
+
140
+ **判断"谁发的"用 `event.publisher`**。信封上的 from 永远是 Bus 自己。
141
+
142
+ ### 输出
143
+
144
+ | 情况 | 写法 |
145
+ | --- | --- |
146
+ | 正常完成 | 退出码 0 |
147
+ | 无事发生 | 最后一行 `[[NOOP]]`(仍写 `handled` 记录,`outcome:"noop"`) |
148
+ | 有结果 | 最后一行 `{"outcome":"success","text":"…","files":[]}` |
149
+ | 失败 | 退出码非 0 |
150
+
151
+ 末行不是 JSON 也不是 `[[NOOP]]` 时按纯文本结果处理(`text` = 末行)。
152
+
153
+ ### 限制
154
+
155
+ | 项 | 值 |
156
+ | --- | --- |
157
+ | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
158
+ | 输出上限 | stdout+stderr 合计 1 MiB,超出终止 |
159
+ | 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_EVENT` / `EC_EVENT_ID` / `EC_BUS` / `EC_PUBLISHER` |
160
+ | 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
161
+ | 沙箱 | 非 fullaccess 模式走 trigger 同款沙箱(cwd 为 agent 工程目录,脚本被快照执行);fullaccess 下 cwd 为包目录 |
162
+ | Windows | 沙箱模式需预置 codex 沙箱,未预置时报 `SCRIPT_SANDBOX_UNAVAILABLE`;`node` 运行时用本机 node.exe,`.mjs` 可跑 |
163
+
164
+ 事件数据一律从 stdin JSON 读,不要依赖读包目录(`events/` 属 L-class,沙箱下不可读)。
165
+
166
+ ## 七、常用操作
167
+
168
+ ```
169
+ ec events status [<包名>] # 每包状态
170
+ ec events doctor <包名> # 白名单/脚本/路径/租约诊断
171
+ ec events ledger <包名> [--tail 20] # 台账
172
+ ec events tail <包名> # 事件日志
173
+ ec events reload [<包名>] # 手动重载
174
+ ec events allowlist add <event> --publish <aid>
175
+ ec events allowlist remove <event> --publish <aid>
176
+ ec events allowlist show [--event <name>]
177
+ ec events publish <包名> <事件名> --data '<json>'
178
+ ```
179
+
180
+ 改 `pack.json` 后热更新会自动 diff;不确定是否生效就跑 `ec events reload`。
181
+
182
+ ## 八、排查
183
+
184
+ | 症状 | 先看 |
185
+ | --- | --- |
186
+ | 订阅没生效 | `ledger.jsonl` 里 `subscribe` 的 `result` 和 `code` |
187
+ | 收不到事件 | 对方 Bus 的 `allowlist.<event>.allow.subscribe` 有没有放行你;也要看联系人准入 |
188
+ | 收到但脚本没跑 | 日志里 `filtered` 记录(filter 不匹配);或 `received` 后队列满 `dropped` |
189
+ | 脚本失败 | `handled` 记录的 `exit`、`outcome` 和 `cmd` |
190
+ | `DEVICE_CONFLICT` | 同一 AID 是否在别处已经开着事件中心 |
191
+ | `FORBIDDEN` | 目标 Bus 白名单没放行本 AID |
192
+ | 脚本全报 126 | 沙箱不可用:`SCRIPT_SANDBOX_UNAVAILABLE`(Windows 未预置沙箱,或 agent 无工程目录) |
193
+
194
+ ## 九、不要做的事
195
+
196
+ 1. **不要从 `message.received` 里解析事件**。事件只通过 SDK 的 `onEvent` 回调;消息层看到 `app.pubsub.v1` 直接忽略。
197
+ 2. **不要用 `from != self` 判断是不是事件**。自己的 Bus 发给自己时 from 就是自己。
198
+ 3. **不要指望事件重放**。没收到就是没了,要补用持久消息重新问。
199
+ 4. **不要把白名单写进 pack.json**。
200
+ 5. **不要在同一个包里给同一个 `(bus, event)` 写两个 handler**。
201
+
202
+ ## 十、相关文档
203
+
204
+ | 文档 | 用途 |
205
+ | --- | --- |
206
+ | `$KITS_DOCS/evolcore/event.md` | Trigger 的 EventBus 事件目录(**内部事件,不是 AUN 事件**) |
207
+ | `$KITS_DOCS/evolcore/trigger.md` | 定时/事件触发器,到点执行用这个 |