evolcore 0.0.43-test.6 → 0.0.43-test.8

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 (249) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/bin/ecmsg.js +188 -58
  3. package/dist/agent-template/jobs.js +62 -0
  4. package/dist/agent-template/runtime.js +214 -0
  5. package/dist/agent-template/service.js +465 -0
  6. package/dist/agent-template/tool-runner.js +45 -0
  7. package/dist/agent-template/types.js +5 -0
  8. package/dist/agents/baseagent-availability.js +1 -1
  9. package/dist/agents/claude-runner.js +1 -1
  10. package/dist/agents/codex/app-server-client.js +22 -0
  11. package/dist/agents/codex-runner.js +69 -2
  12. package/dist/aun/aid/agentmd.js +56 -1
  13. package/dist/aun/aid/client.js +3 -1
  14. package/dist/aun/menu/client.js +3 -2
  15. package/dist/aun/msg/p2p.js +6 -1
  16. package/dist/channels/aun.js +277 -49
  17. package/dist/cli/agent-command.js +5 -0
  18. package/dist/cli/agent-create.js +7 -3
  19. package/dist/cli/agent-template.js +124 -0
  20. package/dist/cli/aun-commands.js +2 -2
  21. package/dist/cli/ctl-command.js +2 -1
  22. package/dist/cli/daemon-commands.js +11 -66
  23. package/dist/cli/daemon-lifecycle-client.js +61 -0
  24. package/dist/cli/ecmsg-gateway.js +35 -2
  25. package/dist/cli/events-command.js +109 -0
  26. package/dist/cli/index.js +60 -14
  27. package/dist/cli/invoke-command.js +182 -0
  28. package/dist/cli/managed-command-guard.js +6 -1
  29. package/dist/cli/net-check.js +1 -1
  30. package/dist/cli/restart-monitor.js +160 -83
  31. package/dist/cli/services-command.js +137 -0
  32. package/dist/cli/team-workspace-command.js +134 -0
  33. package/dist/cli/thread-command.js +103 -13
  34. package/dist/cli/watch-msg.js +1 -1
  35. package/dist/config/boot-log.js +8 -8
  36. package/dist/config/config-field-policy.js +2 -2
  37. package/dist/config/config-manager.js +0 -7
  38. package/dist/config/invoke-ipc-service.js +118 -0
  39. package/dist/config/schema-migration.js +45 -15
  40. package/dist/config-store.js +2 -1
  41. package/dist/core/agent-ipc-registration.js +25 -4
  42. package/dist/core/agent-reload-coordinator.js +6 -4
  43. package/dist/core/agent-runtime.js +106 -10
  44. package/dist/core/auth/delegation-authorization.js +66 -0
  45. package/dist/core/auth/operation-authorizer.js +2 -0
  46. package/dist/core/auth/operation-catalog.js +29 -0
  47. package/dist/core/baseagent-loader.js +60 -130
  48. package/dist/core/channel-loader.js +10 -1
  49. package/dist/core/channel-runtime.js +20 -12
  50. package/dist/core/command/agent-control.js +12 -2
  51. package/dist/core/command/agent-storage-menu.js +1 -1
  52. package/dist/core/command/agent-template-menu.js +147 -0
  53. package/dist/core/command/chatmode-config.js +2 -36
  54. package/dist/core/command/command-handler.js +80 -17
  55. package/dist/core/command/data-root-resolver.js +32 -23
  56. package/dist/core/command/eventcenter-menu.js +468 -0
  57. package/dist/core/command/menu-catalog.js +15 -0
  58. package/dist/core/command/menu-handler.js +216 -90
  59. package/dist/core/command/menu-protocol.js +71 -13
  60. package/dist/core/command/menu-query-batch.js +194 -0
  61. package/dist/core/command/slash-gate.js +1 -1
  62. package/dist/core/command/slash-handler.js +34 -42
  63. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  64. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  65. package/dist/core/command/team-workspace-initializer.js +2 -0
  66. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  67. package/dist/core/command/team-workspace-job-store.js +88 -0
  68. package/dist/core/command/team-workspace-management-service.js +2 -0
  69. package/dist/core/command/team-workspace-management-store.js +96 -0
  70. package/dist/core/command/team-workspace-management.js +265 -0
  71. package/dist/core/command/team-workspace-members-menu.js +88 -0
  72. package/dist/core/command/team-workspace-store.js +612 -0
  73. package/dist/core/command/team-workspace-team.js +193 -0
  74. package/dist/core/daemon-control.js +22 -5
  75. package/dist/core/daemon-lifecycle.js +323 -191
  76. package/dist/core/handoff/runtime.js +45 -13
  77. package/dist/core/invoke/executors/index.js +13 -0
  78. package/dist/core/invoke/executors/media.js +283 -0
  79. package/dist/core/invoke/executors/text.js +198 -0
  80. package/dist/core/invoke/invoke-service.js +157 -0
  81. package/dist/core/invoke/style-router.js +48 -0
  82. package/dist/core/invoke/types.js +19 -0
  83. package/dist/core/ipc-registration.js +50 -7
  84. package/dist/core/legacy-rename.js +41 -0
  85. package/dist/core/memory/consolidation.js +7 -5
  86. package/dist/core/message/aun-ipc-sender.js +252 -17
  87. package/dist/core/message/im-renderer.js +116 -85
  88. package/dist/core/message/message-bridge.js +4 -0
  89. package/dist/core/message/message-queue.js +66 -15
  90. package/dist/core/message/message-utils.js +10 -2
  91. package/dist/core/message/peer-mode.js +7 -34
  92. package/dist/core/message/pending-hints.js +29 -5
  93. package/dist/core/message/response-engine.js +194 -61
  94. package/dist/core/message/send-options.js +7 -4
  95. package/dist/core/message/send-routing.js +50 -5
  96. package/dist/core/ownership/owner-resolver.js +7 -0
  97. package/dist/core/pack-auth.js +94 -0
  98. package/dist/core/pack-install.js +194 -0
  99. package/dist/core/permission/ec-command-parser.js +51 -17
  100. package/dist/core/permission/protected-paths.js +12 -2
  101. package/dist/core/permission/shell-environment.js +9 -0
  102. package/dist/core/rate-window.js +48 -0
  103. package/dist/core/relation/peer-identity.js +28 -0
  104. package/dist/core/session/session-file-health.js +243 -0
  105. package/dist/core/session/session-fs-store.js +67 -28
  106. package/dist/core/session/session-idle-monitor.js +59 -19
  107. package/dist/core/session/session-manager.js +13 -4
  108. package/dist/core/task/task-recovery-service.js +13 -2
  109. package/dist/core/thread/command-parser.js +9 -2
  110. package/dist/core/thread/thread-operation.js +21 -2
  111. package/dist/core/thread/thread-route.js +13 -2
  112. package/dist/core/thread/thread-service.js +52 -3
  113. package/dist/directory/owner-directory-admission.js +40 -53
  114. package/dist/directory/owner-directory-cache.js +89 -113
  115. package/dist/directory/owner-directory-query-operation.js +8 -10
  116. package/dist/eck/kit-renderer.js +7 -5
  117. package/dist/eck/message-renderer.js +2 -0
  118. package/dist/ecweb/basic-settings-service.js +1 -1
  119. package/dist/ecweb/message-context-service.js +0 -4
  120. package/dist/ecweb/runtime/lifecycle.js +6 -2
  121. package/dist/ecweb/runtime/supervisor.js +19 -4
  122. package/dist/event-center/admission-materializer.js +124 -0
  123. package/dist/event-center/bus-gate.js +154 -0
  124. package/dist/event-center/bus-host.js +307 -0
  125. package/dist/event-center/bus-resolver.js +120 -0
  126. package/dist/event-center/center-config.js +127 -0
  127. package/dist/event-center/daemon.js +44 -0
  128. package/dist/event-center/directory-source.js +55 -0
  129. package/dist/event-center/dispatcher.js +157 -0
  130. package/dist/event-center/event-log.js +110 -0
  131. package/dist/event-center/index-generator.js +73 -0
  132. package/dist/event-center/ipc-operation.js +423 -0
  133. package/dist/event-center/ledger.js +52 -0
  134. package/dist/event-center/pack-loader.js +207 -0
  135. package/dist/event-center/pack-manager.js +85 -0
  136. package/dist/event-center/registry.js +463 -0
  137. package/dist/event-center/runtime.js +837 -0
  138. package/dist/event-center/script-runner.js +356 -0
  139. package/dist/event-center/types.js +51 -0
  140. package/dist/event-center/validation.js +435 -0
  141. package/dist/index.js +424 -135
  142. package/dist/ipc.js +106 -12
  143. package/dist/paths.js +20 -0
  144. package/dist/product.js +14 -0
  145. package/dist/proxy/manager.js +5 -1
  146. package/dist/proxy/service-supervisor.js +13 -4
  147. package/dist/response-system/engines/v1/index.js +0 -1
  148. package/dist/response-system/engines/v1/proactive-flow.js +4 -2
  149. package/dist/response-system/modes/single-session/index.js +1 -1
  150. package/dist/services/dispatcher.js +100 -0
  151. package/dist/services/idempotency.js +90 -0
  152. package/dist/services/identity.js +52 -0
  153. package/dist/services/index-generator.js +70 -0
  154. package/dist/services/index.js +449 -0
  155. package/dist/services/ipc-operation.js +550 -0
  156. package/dist/services/ledger.js +52 -0
  157. package/dist/services/message-log.js +112 -0
  158. package/dist/services/pack-manager.js +215 -0
  159. package/dist/services/reply.js +55 -0
  160. package/dist/services/router.js +98 -0
  161. package/dist/services/script-runner.js +422 -0
  162. package/dist/services/service-payload.js +70 -0
  163. package/dist/services/types.js +18 -0
  164. package/dist/services/validation.js +297 -0
  165. package/dist/trigger/application-service.js +18 -0
  166. package/dist/trigger/event-source.js +1 -1
  167. package/dist/trigger/ipc-service.js +3 -1
  168. package/dist/trigger/scheduler.js +38 -0
  169. package/dist/trigger/script-sandbox.js +170 -24
  170. package/dist/utils/cross-platform.js +24 -10
  171. package/dist/utils/evolcore-version.js +69 -27
  172. package/dist/utils/instance-registry.js +19 -13
  173. package/dist/utils/npm-ops.js +2 -1
  174. package/dist/utils/package-version-info.js +6 -3
  175. package/dist/utils/process-introspect.js +45 -9
  176. package/dist/utils/startup-trace.js +74 -37
  177. package/dist/utils/windows-shell-trust.js +80 -6
  178. package/kits/docs/INDEX.md +2 -2
  179. package/kits/docs/aun/ABILITY_CALLING.md +9 -15
  180. package/kits/docs/context-assembly.md +1 -1
  181. package/kits/docs/evolcore/INDEX.md +3 -1
  182. package/kits/docs/evolcore/ability.md +4 -0
  183. package/kits/docs/evolcore/agent.md +22 -1
  184. package/kits/docs/evolcore/aid.md +1 -1
  185. package/kits/docs/evolcore/event-center.md +227 -0
  186. package/kits/docs/evolcore/file-navigation.md +10 -264
  187. package/kits/docs/evolcore/fs.md +5 -3
  188. package/kits/docs/evolcore/group.md +1 -1
  189. package/kits/docs/evolcore/memory-architecture.md +2 -0
  190. package/kits/docs/evolcore/menu-protocol.md +28 -1
  191. package/kits/docs/evolcore/msg.md +21 -9
  192. package/kits/docs/evolcore/provider.md +3 -1
  193. package/kits/docs/evolcore/response.md +5 -5
  194. package/kits/docs/evolcore/services.md +294 -0
  195. package/kits/docs/evolcore/task.md +2 -0
  196. package/kits/docs/evolcore/team-workspace.md +41 -0
  197. package/kits/docs/evolcore/thread-chain.md +15 -3
  198. package/kits/eck_manifest.json +26 -0
  199. package/kits/rules/02-navigation.md +10 -1
  200. package/kits/rules/06-channel.md +1 -0
  201. package/kits/schemas/_meta.json +17 -6
  202. package/kits/schemas/agent-config.schema.19.json +5 -7
  203. package/kits/schemas/agent-config.schema.20.json +936 -0
  204. package/kits/schemas/relation-config.schema.12.json +2 -3
  205. package/kits/schemas/role-config.schema.2.json +4 -4
  206. package/kits/skills/.switches.json +1 -5
  207. package/kits/skills/ability/SKILL.md +56 -0
  208. package/kits/skills/ability/references/calling.md +56 -0
  209. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  210. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  211. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  212. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  213. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  214. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  215. package/kits/skills/ec-group/SKILL.md +5 -8
  216. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  217. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  218. package/kits/skills/ec-trigger/SKILL.md +4 -4
  219. package/kits/skills/personal-assistant/SKILL.md +6 -6
  220. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  221. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  222. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  223. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  224. package/kits/skills/thread-ops/SKILL.md +10 -10
  225. package/kits/templates/message-fragments/item.md +1 -1
  226. package/kits/templates/system-fragments/channel.md +3 -3
  227. package/kits/templates/system-fragments/commands.md +5 -3
  228. package/kits/templates/system-fragments/reply.md +1 -5
  229. package/kits/templates/system-fragments/thread.md +13 -10
  230. package/package.json +5 -6
  231. package/scripts/agent-template/index.mjs +40 -0
  232. package/scripts/agent-template/inspect.mjs +240 -0
  233. package/scripts/agent-template/overlay.mjs +71 -0
  234. package/scripts/agent-template/pack.mjs +169 -0
  235. package/scripts/agent-template/shared/common.mjs +235 -0
  236. package/scripts/agent-template/shared/evolcore.mjs +75 -0
  237. package/scripts/agent-template/shared/plan.mjs +129 -0
  238. package/scripts/agent-template/shared/team-schema.json +70 -0
  239. package/scripts/agent-template/shared/template-contract.mjs +154 -0
  240. package/scripts/agent-template/shared/template-package.mjs +265 -0
  241. package/scripts/agent-template/shared/template-runtime.mjs +80 -0
  242. package/scripts/agent-template/shared/template.mjs +142 -0
  243. package/dist/cli/pa-workspace-command.js +0 -225
  244. package/dist/core/command/pa-workspace-store.js +0 -468
  245. package/dist/core/relation/pa-team.js +0 -132
  246. package/kits/docs/evolcore/pa-workspace.md +0 -51
  247. package/kits/skills/aid-ability/SKILL.md +0 -244
  248. package/kits/skills/ec-ability/SKILL.md +0 -67
  249. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -0,0 +1,85 @@
1
+ /**
2
+ * 包合并与冲突检测:所有 enabled 包的 register 合并为事件目录;
3
+ * 事件名冲突 → 冲突各方全部 invalid(不静默覆盖)。
4
+ */
5
+ /** 从加载结果构建运行时状态。disabled 包不参与目录与冲突检测。 */
6
+ export function buildPackState(packs, invalidPacks, previousRevision = 0) {
7
+ const enabled = packs.filter(pack => pack.enabled);
8
+ const disabledPacks = packs.filter(pack => !pack.enabled).map(pack => pack.id);
9
+ const eventOwners = new Map();
10
+ for (const pack of enabled) {
11
+ for (const entry of pack.register) {
12
+ const owners = eventOwners.get(entry.event) ?? [];
13
+ owners.push(pack.id);
14
+ eventOwners.set(entry.event, owners);
15
+ }
16
+ }
17
+ const conflicts = [];
18
+ const conflictPackIds = new Set();
19
+ for (const [event, packIds] of eventOwners) {
20
+ if (packIds.length > 1) {
21
+ conflicts.push({ event, packs: packIds });
22
+ for (const id of packIds)
23
+ conflictPackIds.add(id);
24
+ }
25
+ }
26
+ const conflictInvalid = [];
27
+ for (const pack of enabled) {
28
+ if (!conflictPackIds.has(pack.id))
29
+ continue;
30
+ const events = conflicts.filter(item => item.packs.includes(pack.id)).map(item => item.event);
31
+ conflictInvalid.push({
32
+ id: pack.id,
33
+ errors: [`register event name conflict: ${events.join(', ')} (also registered by ${[...conflictPackIds].filter(id => id !== pack.id).join(', ')})`],
34
+ });
35
+ }
36
+ const enabledPacks = enabled.filter(pack => !conflictPackIds.has(pack.id));
37
+ const catalog = [];
38
+ for (const pack of enabledPacks) {
39
+ for (const entry of pack.register) {
40
+ if ((eventOwners.get(entry.event) ?? []).length > 1)
41
+ continue;
42
+ catalog.push({
43
+ event: entry.event,
44
+ ...(entry.description !== undefined ? { description: entry.description } : {}),
45
+ ttl: entry.ttl,
46
+ ...(entry.maxTtl !== undefined ? { maxTtl: entry.maxTtl } : {}),
47
+ ...(entry.schemaVersion !== undefined ? { schemaVersion: entry.schemaVersion } : {}),
48
+ ...(entry.contentSchema !== undefined ? { contentSchema: entry.contentSchema } : {}),
49
+ sourcePackId: pack.id,
50
+ });
51
+ }
52
+ }
53
+ return {
54
+ enabledPacks,
55
+ disabledPacks,
56
+ invalidPacks: [...invalidPacks, ...conflictInvalid],
57
+ catalog,
58
+ conflicts,
59
+ revision: previousRevision + 1,
60
+ };
61
+ }
62
+ /** catalog → SDK start/updateConfig 的 catalog 参数(字段名对照旧 bus-config-store.toSdkConfig)。 */
63
+ export function toSdkCatalog(catalog) {
64
+ const out = {};
65
+ for (const entry of catalog) {
66
+ out[entry.event] = {
67
+ ...(entry.description ? { description: entry.description } : {}),
68
+ schema_version: entry.schemaVersion ?? 1,
69
+ ...(entry.contentSchema !== undefined ? { content_schema: entry.contentSchema } : {}),
70
+ default_ttl_seconds: entry.ttl,
71
+ max_ttl_seconds: entry.maxTtl ?? Math.max(300, entry.ttl),
72
+ };
73
+ }
74
+ return out;
75
+ }
76
+ /** events-config.json 的 rules(物化后)→ SDK start/updateConfig 的 allowlist 参数。 */
77
+ export function toSdkAllowlist(config) {
78
+ const out = {};
79
+ for (const [event, entry] of Object.entries(config.rules)) {
80
+ const publish = entry.allow.publish.filter(aid => !entry.deny.publish.includes(aid));
81
+ const subscribe = entry.allow.subscribe.filter(aid => !entry.deny.subscribe.includes(aid));
82
+ out[event] = { publish_aids: [...publish], subscribe_aids: [...subscribe] };
83
+ }
84
+ return out;
85
+ }
@@ -0,0 +1,463 @@
1
+ /**
2
+ * per-aid 事件中心单元注册表:加载 → 解析 → 运行时,生命周期跟随 Trigger 调度器。
3
+ * 包级失败隔离:坏包只废自己(pack.invalid),不影响其它包与 Bus。
4
+ */
5
+ import fs from 'node:fs';
6
+ import path from 'node:path';
7
+ import { logger } from '../utils/logger.js';
8
+ import { agentEventsDir } from '../paths.js';
9
+ import { resolvePeerRoleDetail } from '../config/peer-role-resolver.js';
10
+ import { BusResolveState, isBusPlaceholder, resolvePackBuses } from './bus-resolver.js';
11
+ import { CenterConfigStore } from './center-config.js';
12
+ import { EventDispatcher } from './dispatcher.js';
13
+ import { writeEventsIndex } from './index-generator.js';
14
+ import { Ledger, centerLedger, packLedger } from './ledger.js';
15
+ import { buildPackState } from './pack-manager.js';
16
+ import { EVENTS_CONFIG_JSON, loadCenterConfig, loadPacks, PACK_JSON } from './pack-loader.js';
17
+ import { EventRuntime } from './runtime.js';
18
+ import { materializeAllowlist } from './admission-materializer.js';
19
+ import { ScriptRunner } from './script-runner.js';
20
+ import { errorMessage } from './types.js';
21
+ import { readBusResolverContext } from './directory-source.js';
22
+ /** 旧方案残留的订阅 Trigger(labels.kind=bus-subscription),启动时一次性清理。 */
23
+ const LEGACY_SUBSCRIPTION_KIND = 'bus-subscription';
24
+ /** 解析上下文签名:只有 owner/pa/paRoles 三要素参与(fetchedAt 等时间戳字段不参与,
25
+ * 否则目录每次同步 rewrite 都会触发无意义 reload)。 */
26
+ function resolverSignatureOf(context) {
27
+ const roles = {};
28
+ for (const key of Object.keys(context.paRoles ?? {}).sort()) {
29
+ roles[key] = [...(context.paRoles[key] ?? [])].sort();
30
+ }
31
+ return JSON.stringify({ owner: context.owner ?? null, pa: context.pa ?? null, paRoles: roles });
32
+ }
33
+ export class EventCenterRegistry {
34
+ options;
35
+ units = new Map();
36
+ starts = new Map();
37
+ /** 台账去重:aid → (packId#kind → 签名)。watcher/contacts 触发的 reload 会高频重扫,
38
+ * 相同 revision/错误的重复行(pack.load / pack.invalid / bus.resolve.*)只记一次。 */
39
+ scanLedgerSigs = new Map();
40
+ /** reload 串行队列:aid → 队尾 promise。 */
41
+ reloadQueues = new Map();
42
+ /** 签名未变则跳过 append。 */
43
+ ledgerOnce(aid, key, sig, append) {
44
+ let sigs = this.scanLedgerSigs.get(aid);
45
+ if (!sigs) {
46
+ sigs = new Map();
47
+ this.scanLedgerSigs.set(aid, sigs);
48
+ }
49
+ if (sigs.get(key) === sig)
50
+ return;
51
+ append();
52
+ sigs.set(key, sig);
53
+ }
54
+ constructor(options) {
55
+ this.options = options;
56
+ }
57
+ get(aid) {
58
+ return this.units.get(aid);
59
+ }
60
+ /** ECK 的 hasEventPacks:是否有已启用且无冲突的包。读内存状态,不扫目录。 */
61
+ hasActivePacks(aid) {
62
+ return (this.units.get(aid)?.state.enabledPacks.length ?? 0) > 0;
63
+ }
64
+ values() {
65
+ return this.units.values();
66
+ }
67
+ ensureStarted(aid) {
68
+ const existing = this.starts.get(aid);
69
+ if (existing)
70
+ return existing;
71
+ const starting = this.start(aid).catch(error => {
72
+ logger.error(`[EventCenter] start failed for ${aid}: ${errorMessage(error)}`);
73
+ }).finally(() => {
74
+ this.starts.delete(aid);
75
+ });
76
+ this.starts.set(aid, starting);
77
+ return starting;
78
+ }
79
+ /**
80
+ * 热更新:增量重配,不重建 AUN 连接。
81
+ *
82
+ * 早期实现是整停整起(remove + ensureStarted),但 Bus 是单设备租约:
83
+ * 关掉 client 后服务端要几十秒才释放,立刻重开必然 DEVICE_CONFLICT;而订阅侧
84
+ * 在同一时刻对一个还没起来的 Bus 做 authorize 会超时,之后不再重试。结果是
85
+ * 「改完文件 Bus 挂着、订阅丢了」。因此这里复用现有 unit 的 runtime,
86
+ * 由 `reconfigure()` 按 bus 做差集(设计 §8 的热更新表)。
87
+ *
88
+ * 同一 aid 的 reload 串行排队:CLI、watcher、contacts 预检都可能触发,
89
+ * 并发跑 scan/reconfigure 会让 unit.state 与 runtime 内部状态交错。
90
+ */
91
+ async reload(aid) {
92
+ const prev = this.reloadQueues.get(aid) ?? Promise.resolve();
93
+ const run = prev.then(() => this.reloadNow(aid));
94
+ this.reloadQueues.set(aid, run);
95
+ try {
96
+ await run;
97
+ }
98
+ finally {
99
+ if (this.reloadQueues.get(aid) === run)
100
+ this.reloadQueues.delete(aid);
101
+ }
102
+ }
103
+ async reloadNow(aid) {
104
+ const unit = this.units.get(aid);
105
+ if (!unit) {
106
+ await this.ensureStarted(aid);
107
+ return;
108
+ }
109
+ const scanned = this.scan(aid, 'daemon.reload');
110
+ writeEventsIndex(scanned.eventsDir, scanned.state.enabledPacks, scanned.resolutions);
111
+ // deregister:reload 后消失的包,它登记过的事件不再存在于 catalog。
112
+ // 记账到中心台账——包目录可能已被归档删除,包级 ledger 不再可靠。
113
+ const nextIds = new Set(scanned.state.enabledPacks.map(pack => pack.id));
114
+ for (const pack of unit.state.enabledPacks) {
115
+ if (nextIds.has(pack.id))
116
+ continue;
117
+ const events = pack.register.map(entry => entry.event);
118
+ if (events.length === 0)
119
+ continue;
120
+ centerLedger(scanned.eventsDir).append({
121
+ action: 'deregister', result: 'ok', events, actor: 'daemon.reload', reason: `pack ${pack.id} removed`,
122
+ });
123
+ }
124
+ // bus.rebind:占位符解析结果变了的包(典型场景:Owner / PA 换了,$owner / $pa
125
+ // 指向新 AID)。记下 old → new,否则"订阅突然收不到"只能靠猜。
126
+ const previousResolutions = unit.resolutions;
127
+ for (const [packId, next] of scanned.resolutions) {
128
+ const previous = previousResolutions.get(packId);
129
+ if (!previous)
130
+ continue; // 新包:由 subscribe 台账覆盖
131
+ const moved = [];
132
+ for (const [ref, to] of next) {
133
+ const from = previous.get(ref);
134
+ if (from && from !== to)
135
+ moved.push({ ref, from, to });
136
+ }
137
+ if (moved.length === 0)
138
+ continue;
139
+ centerLedger(scanned.eventsDir).append({
140
+ action: 'bus.rebind', result: 'ok', actor: 'daemon.reload',
141
+ ...(moved[0] ? { bus: moved[0].to } : {}),
142
+ reason: moved.map(item => `${item.ref}: ${item.from} → ${item.to}`).join('; ').slice(0, 500),
143
+ });
144
+ }
145
+ // state / resolutions 是 unit 的原地字段:onEvent 闭包与 dispatcher 都从这里
146
+ // 读最新包集合与占位符解析结果,必须一起替换。
147
+ unit.state = scanned.state;
148
+ unit.resolutions = scanned.resolutions;
149
+ unit.contactsWatch = scanned.contactsWatch;
150
+ unit.resolverSignature = scanned.resolverSignature;
151
+ await unit.runtime.reconfigure({
152
+ state: scanned.state,
153
+ center: scanned.center,
154
+ resolutions: scanned.resolutions,
155
+ materializedAllowlist: scanned.materializedAllowlist,
156
+ contactsWatch: scanned.contactsWatch,
157
+ });
158
+ }
159
+ async remove(aid) {
160
+ const pending = this.starts.get(aid);
161
+ if (pending)
162
+ await pending;
163
+ const unit = this.units.get(aid);
164
+ this.units.delete(aid);
165
+ this.scanLedgerSigs.delete(aid);
166
+ if (!unit)
167
+ return;
168
+ this.detachEventsWatcher(unit);
169
+ await Promise.allSettled([unit.runtime.close(), unit.dispatcher.close()]);
170
+ }
171
+ async closeAll() {
172
+ await Promise.allSettled([...this.units.keys()].map(aid => this.remove(aid)));
173
+ }
174
+ /**
175
+ * 扫描 + 校验 + 占位符解析 + center 读取。start 与 reload 共用。
176
+ * 台账副作用(pack.invalid / pack.load / bus.resolve.*)按签名去重:reload 可能由
177
+ * watcher/contacts 高频触发,相同内容重复行没有信息量还刷盘。
178
+ */
179
+ scan(aid, ledgerActor = 'daemon.start') {
180
+ const agentDirPath = this.options.agentDir(aid);
181
+ const eventsDir = (this.options.eventsDir ?? agentEventsDir)(aid);
182
+ // ① 扫描 + 校验。
183
+ const loaded = loadPacks(eventsDir);
184
+ const state = buildPackState(loaded.valid, loaded.invalid.map(item => ({ id: item.packId, errors: item.errors })));
185
+ // ② 台账:invalid / load(签名去重)。
186
+ for (const item of loaded.invalid) {
187
+ const reason = item.errors.join('; ').slice(0, 500);
188
+ this.ledgerOnce(aid, `${item.packId}#invalid`, reason, () => {
189
+ const ledger = new Ledger(path.join(item.dir, 'ledger.jsonl'));
190
+ ledger.append({ action: 'pack.invalid', result: 'failed', reason });
191
+ });
192
+ }
193
+ for (const pack of state.enabledPacks) {
194
+ this.ledgerOnce(aid, `${pack.id}#load`, pack.revision, () => {
195
+ packLedger(pack).append({ action: 'pack.load', result: 'ok', actor: ledgerActor, revision: pack.revision });
196
+ });
197
+ // register:本包往 catalog 里登记了哪些事件。与 pack.load 同一时机、同一 revision
198
+ // 去重——包内容没变就不重复记,否则每次 reload 都刷一遍。
199
+ if (pack.register.length > 0) {
200
+ this.ledgerOnce(aid, `${pack.id}#register`, pack.revision, () => {
201
+ packLedger(pack).append({
202
+ action: 'register', result: 'ok', events: pack.register.map(entry => entry.event),
203
+ actor: ledgerActor, revision: pack.revision,
204
+ });
205
+ });
206
+ }
207
+ }
208
+ // ③ 占位符解析(strict 失败 → 该包退出运行;keep-last 沿用上次结果)。
209
+ const context = readBusResolverContext(aid, agentDirPath);
210
+ const resolveState = BusResolveState.forEventsDir(eventsDir);
211
+ resolveState.load();
212
+ const resolutions = new Map();
213
+ const runnablePacks = [];
214
+ let wantsResolveRefresh = false;
215
+ for (const pack of state.enabledPacks) {
216
+ const refs = [...pack.publish.map(entry => entry.bus), ...pack.subscribe.map(entry => entry.bus)];
217
+ if (refs.length === 0) {
218
+ runnablePacks.push(pack);
219
+ continue;
220
+ }
221
+ const last = resolveState.get(pack.id);
222
+ const resolution = resolvePackBuses(refs, context, pack.busResolve, last);
223
+ if (resolution.failures.length > 0 || resolution.degraded.length > 0)
224
+ wantsResolveRefresh = true;
225
+ if (resolution.failures.length > 0) {
226
+ const sig = resolution.failures.map(failure => `${failure.ref}:${failure.code}`).join(';');
227
+ this.ledgerOnce(aid, `${pack.id}#resolve`, sig, () => {
228
+ for (const failure of resolution.failures) {
229
+ packLedger(pack).append({ action: 'pack.invalid', result: 'failed', reason: `bus resolve failed: ${failure.ref} (${failure.code}: ${failure.message})`, revision: pack.revision });
230
+ }
231
+ });
232
+ }
233
+ if (resolution.degraded.length > 0) {
234
+ const sig = resolution.degraded.map(degraded => `${degraded.ref}=${degraded.lastAid}`).sort().join(';');
235
+ this.ledgerOnce(aid, `${pack.id}#degraded`, sig, () => {
236
+ for (const degraded of resolution.degraded) {
237
+ packLedger(pack).append({ action: 'bus.resolve.degraded', result: 'ok', bus: degraded.lastAid, reason: `${degraded.ref} unresolved; keep-last`, revision: pack.revision });
238
+ }
239
+ });
240
+ }
241
+ if (resolution.failures.length > 0 && pack.busResolve === 'strict')
242
+ continue;
243
+ resolutions.set(pack.id, resolution.resolved);
244
+ resolveState.set(pack.id, resolution.resolved);
245
+ runnablePacks.push(pack);
246
+ }
247
+ resolveState.save();
248
+ const runtimeState = { ...state, enabledPacks: runnablePacks };
249
+ // ④ events-config.json。
250
+ const centerResult = loadCenterConfig(eventsDir);
251
+ for (const error of centerResult.errors) {
252
+ logger.warn(`[EventCenter] ${aid} events-config.json: ${error}`);
253
+ }
254
+ const materialized = materializeAllowlist(centerResult.config, agentDirPath, aid, runtimeState.catalog.map(entry => entry.event));
255
+ // contacts 监听需求:包里有占位符引用(含被解析淘汰的包——它们在 enabledPacks 里)
256
+ // 或上次解析有失败/degraded(等 contacts 到位后重解析)。
257
+ const usesPlaceholderRefs = loaded.valid.some(pack => [...pack.publish, ...pack.subscribe].some(entry => isBusPlaceholder(entry.bus)));
258
+ return {
259
+ agentDirPath,
260
+ eventsDir,
261
+ state: runtimeState,
262
+ resolutions,
263
+ center: centerResult.config,
264
+ // 首次启动没有"上一份 allowlist",物化失败必须 fail-closed 等下次重物化。
265
+ materializedAllowlist: materialized.degraded ? {} : materialized.allowlist,
266
+ contactsWatch: usesPlaceholderRefs || wantsResolveRefresh,
267
+ resolverSignature: resolverSignatureOf(context),
268
+ };
269
+ }
270
+ async start(aid) {
271
+ // 已有单元时先关掉:否则新单元会覆盖 units 里的旧条目,而旧 runtime 的
272
+ // Bus/Sub/Pub 三条连接没人关闭——同一进程出现两条 role=bus 的连接,
273
+ // 服务端按"Connection replaced by new session"互相踢,形成 60 秒一次的
274
+ // DEVICE_CONFLICT 循环。ensureStarted 的 starts 去重只挡住并发调用,
275
+ // 挡不住"先后两次 ensureStarted"(例如调度器 started 事件 + pack add)。
276
+ // 关闭已有单元,避免同一 AID 出现两条 Bus 连接(服务端按
277
+ // "Connection replaced by new session" 互相踢,形成 60 秒 DEVICE_CONFLICT 循环)。
278
+ //
279
+ // 注意**不能调 this.remove(aid)**:remove() 会 `await this.starts.get(aid)`,
280
+ // 而 starts 里登记的正是本次 start() 的 Promise —— 自等待死锁,startSubscribers
281
+ // 永远不会执行(现象:Bus running 但从不写 `subscribed`)。这里就地清理。
282
+ const existingUnit = this.units.get(aid);
283
+ if (existingUnit) {
284
+ this.units.delete(aid);
285
+ await Promise.allSettled([existingUnit.runtime.close(), existingUnit.dispatcher.close()]);
286
+ }
287
+ this.cleanupLegacySubscriptionTriggers(aid);
288
+ const scanned = this.scan(aid);
289
+ const { agentDirPath, eventsDir, state: runtimeState, resolutions, center: centerConfig } = scanned;
290
+ const centerStore = new CenterConfigStore({ eventsDir });
291
+ const scriptRunner = new ScriptRunner({
292
+ aid,
293
+ getProjectPath: () => this.options.getProjectPath(aid),
294
+ // bypass + owner 才免沙箱;角色取发布方(事件正文的 publisher)。解析失败按未知处理。
295
+ resolvePeerRole: publisher => {
296
+ try {
297
+ return resolvePeerRoleDetail({
298
+ selfAid: aid,
299
+ channelKey: `aun#${aid}#main`,
300
+ channelType: 'aun',
301
+ chatType: 'private',
302
+ actorId: publisher,
303
+ conversationId: publisher,
304
+ }).effectiveRole;
305
+ }
306
+ catch {
307
+ return undefined;
308
+ }
309
+ },
310
+ });
311
+ const dispatcher = new EventDispatcher(scriptRunner);
312
+ const runtime = new EventRuntime({
313
+ aid,
314
+ getClient: this.options.getClient,
315
+ contactsPath: path.join(agentDirPath, 'directory', 'contacts.json'),
316
+ onContactsChanged: () => this.handleContactsChanged(aid),
317
+ materializeAllowlist: (center, registeredEvents) => materializeAllowlist(center, agentDirPath, aid, registeredEvents),
318
+ onBusRequestRejected: entry => centerLedger(eventsDir).append({
319
+ action: 'bus.request.rejected', result: 'failed', aid: entry.aid, operation: entry.operation,
320
+ ...(entry.event ? { event: entry.event } : {}), ...(entry.action ? { direction: entry.action } : {}),
321
+ reason: entry.reason, code: 'FORBIDDEN',
322
+ }),
323
+ onGateStatus: installed => centerLedger(eventsDir).append({
324
+ action: installed ? 'gate.installed' : 'gate.degraded', result: installed ? 'ok' : 'failed', actor: 'daemon',
325
+ ...(installed ? {} : { reason: 'sdk_request_handler_unavailable' }),
326
+ }),
327
+ // 热更新退订:包被删/事件被删时记录,否则"什么时候开始收不到"无从追溯。
328
+ onUnsubscribe: ({ busAid, events }) => {
329
+ const live = this.units.get(aid);
330
+ if (!live)
331
+ return;
332
+ const revision = live.state.enabledPacks
333
+ .find(pack => pack.subscribe.some(entry => entry.event === events[0]))?.revision;
334
+ centerLedger(eventsDir).append({
335
+ action: 'unsubscribe', result: 'ok', bus: busAid, events, actor: 'daemon.reload',
336
+ ...(revision ? { revision } : {}),
337
+ });
338
+ },
339
+ // Bus 进出 running 的时间线——排查 DEVICE_CONFLICT / 订阅失效时唯一的依据。
340
+ onBusTransition: ({ from, to, detail }) => {
341
+ const entering = to === 'running' && from !== 'running';
342
+ const leaving = from === 'running' && to !== 'running';
343
+ if (!entering && !leaving)
344
+ return;
345
+ centerLedger(eventsDir).append({
346
+ action: entering ? 'bus.start' : 'bus.stop',
347
+ result: 'ok',
348
+ bus: aid,
349
+ actor: 'daemon',
350
+ ...(detail ? { reason: detail } : {}),
351
+ });
352
+ },
353
+ // 读 unit 上的实时字段:reload 会原地替换 state / resolutions,
354
+ // 闭包若捕获初值,热更新后仍按旧包集合派发。
355
+ onEvent: event => {
356
+ const live = this.units.get(aid);
357
+ if (live)
358
+ dispatcher.handleEvent(live.state.enabledPacks, live.resolutions, event);
359
+ },
360
+ });
361
+ // 索引与包集合同步重建;空集删除,交给 manifest 的 optional 判缺失。
362
+ writeEventsIndex(eventsDir, runtimeState.enabledPacks, resolutions);
363
+ const unit = {
364
+ aid, agentDir: agentDirPath, eventsDir, state: runtimeState, centerStore, runtime, dispatcher, resolutions,
365
+ contactsWatch: scanned.contactsWatch,
366
+ resolverSignature: scanned.resolverSignature,
367
+ };
368
+ this.units.set(aid, unit);
369
+ this.attachEventsWatcher(unit);
370
+ await runtime.start({
371
+ state: runtimeState,
372
+ center: centerConfig,
373
+ resolutions,
374
+ materializedAllowlist: scanned.materializedAllowlist,
375
+ contactsWatch: scanned.contactsWatch,
376
+ });
377
+ }
378
+ // ── M2:contacts 变化 → 预检后 reload ─────────────────────────────────
379
+ // runtime 的 contacts watcher(2s 去抖)在 allowlist 重物化之外回调这里。
380
+ // 预检:重读 contacts 比对 owner/pa/paRoles 签名——没变就跳过(目录同步周期性
381
+ // rewrite 同内容文件,fetchedAt/updatedAtMs 每次都变,不能一见写入就 reload)。
382
+ handleContactsChanged(aid) {
383
+ const unit = this.units.get(aid);
384
+ if (!unit || !unit.contactsWatch)
385
+ return;
386
+ let context;
387
+ try {
388
+ context = readBusResolverContext(aid, unit.agentDir);
389
+ }
390
+ catch {
391
+ return;
392
+ }
393
+ if (resolverSignatureOf(context) === unit.resolverSignature)
394
+ return;
395
+ this.reload(aid).catch(error => {
396
+ logger.warn(`[EventCenter] ${aid} contacts-triggered reload failed: ${errorMessage(error)}`);
397
+ });
398
+ }
399
+ // ── M3:events/ 目录监听(改 pack.json/center.json 自动 reload)────────
400
+ // 原生 recursive fs.watch(win32 单句柄;chokidar 在 Windows 有句柄爆炸教训)。
401
+ // 只认包清单与 center.json:.index.md 在监听目录内(reload 自己写,会自触发),
402
+ // ledger/logs/scripts 是运行产物,全排除。error 即降级拆除,回到手动 reload。
403
+ attachEventsWatcher(unit) {
404
+ if (unit.eventsWatcher || this.options.watchEvents === false)
405
+ return;
406
+ // 旧名文件(center.json / 关注的事件.json)首次加载时就地迁移成规范名,磁盘上不再出现,无需监听。
407
+ const watched = new Set([PACK_JSON, EVENTS_CONFIG_JSON]);
408
+ try {
409
+ const watcher = fs.watch(unit.eventsDir, { recursive: true }, (_kind, filename) => {
410
+ const base = filename ? path.basename(filename.toString()) : '';
411
+ if (!watched.has(base))
412
+ return;
413
+ if (unit.eventsReloadTimer)
414
+ clearTimeout(unit.eventsReloadTimer);
415
+ unit.eventsReloadTimer = setTimeout(() => {
416
+ unit.eventsReloadTimer = undefined;
417
+ this.reload(unit.aid).catch(error => {
418
+ logger.warn(`[EventCenter] ${unit.aid} watcher reload failed: ${errorMessage(error)}`);
419
+ });
420
+ }, 2_000);
421
+ unit.eventsReloadTimer.unref?.();
422
+ });
423
+ watcher.on('error', () => this.detachEventsWatcher(unit));
424
+ unit.eventsWatcher = watcher;
425
+ }
426
+ catch {
427
+ // 目录缺失或平台不支持 recursive:不监听即可,手动 reload 仍可用。
428
+ }
429
+ }
430
+ detachEventsWatcher(unit) {
431
+ if (unit.eventsReloadTimer)
432
+ clearTimeout(unit.eventsReloadTimer);
433
+ unit.eventsReloadTimer = undefined;
434
+ try {
435
+ unit.eventsWatcher?.close();
436
+ }
437
+ catch {
438
+ // 已失效。
439
+ }
440
+ unit.eventsWatcher = undefined;
441
+ }
442
+ /** 一次性清理旧事件总线遗留的订阅 Trigger(事件源 bus:event 已无人发布,纯残留)。 */
443
+ cleanupLegacySubscriptionTriggers(aid) {
444
+ const scheduler = this.options.getScheduler?.(aid);
445
+ if (!scheduler)
446
+ return;
447
+ try {
448
+ const orphans = scheduler.list({ all: true }).filter(trigger => trigger.labels?.kind === LEGACY_SUBSCRIPTION_KIND);
449
+ for (const trigger of orphans) {
450
+ try {
451
+ scheduler.delete(trigger.id);
452
+ logger.info(`[EventCenter] ${aid} removed legacy bus-subscription trigger ${trigger.id}`);
453
+ }
454
+ catch {
455
+ // 单个删除失败不影响其它。
456
+ }
457
+ }
458
+ }
459
+ catch {
460
+ // 清理是尽力而为。
461
+ }
462
+ }
463
+ }