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,837 @@
1
+ /**
2
+ * 单个 agent 的事件中心运行时:Bus 宿主(可选)+ 订阅 client + 发布 client。
3
+ * 回调先注册、后 authorize、再 subscribe(避免订阅生效到回调注册之间漏事件);
4
+ * 包级 / Bus 级失败全部隔离,不互相阻塞。
5
+ */
6
+ import { logger } from '../utils/logger.js';
7
+ import fs from 'node:fs';
8
+ import path from 'node:path';
9
+ import { BusHost } from './bus-host.js';
10
+ import { isBusPlaceholder } from './bus-resolver.js';
11
+ import { packLedger } from './ledger.js';
12
+ import { toSdkAllowlist, toSdkCatalog } from './pack-manager.js';
13
+ import { eventListenerOff, EventCenterError, errorCode, errorMessage } from './types.js';
14
+ import { evaluateEventBusRequest } from './bus-gate.js';
15
+ import { RateWindow } from '../core/rate-window.js';
16
+ /** SDK app.pubsub.v1 事件载荷 → 归一化事件。 */
17
+ export function toReceivedEvent(busAid, payload) {
18
+ const eventName = typeof payload.event_name === 'string' ? payload.event_name : '';
19
+ const eventId = typeof payload.event_id === 'string' ? payload.event_id : '';
20
+ const publisher = typeof payload.publisher_aid === 'string' ? payload.publisher_aid : '';
21
+ if (!eventName || !eventId || !publisher)
22
+ return null;
23
+ return {
24
+ busAid,
25
+ eventName,
26
+ eventId,
27
+ publisher,
28
+ receivedAt: Date.now(),
29
+ ...(payload.schema_version !== undefined ? { schemaVersion: Number(payload.schema_version) } : {}),
30
+ data: payload.data,
31
+ };
32
+ }
33
+ /** Bus 配置是否等价:catalog 与 allowlist 都是 JSON 对象,序列化比较足够(不含函数/时间戳)。 */
34
+ function sameBusConfig(left, right) {
35
+ if (left === null || right === null)
36
+ return left === right;
37
+ return JSON.stringify(left.catalog) === JSON.stringify(right.catalog)
38
+ && JSON.stringify(left.allowlist) === JSON.stringify(right.allowlist);
39
+ }
40
+ export class EventRuntime {
41
+ options;
42
+ busHost;
43
+ /** 共享主 client(sub/pub 角色共用;bus 宿主同源)。 */
44
+ client;
45
+ /** state_change 监听摘除器:client 换代/停机时摘掉,避免共享连接上累积监听。 */
46
+ clientReadyOff;
47
+ clientReadyHandler;
48
+ unsubscribers = [];
49
+ current;
50
+ rematerializeTimer;
51
+ contactsWatchers = [];
52
+ contactsRefreshTimer;
53
+ lastGateStatus;
54
+ closed = false;
55
+ /** 已生效的订阅:busAid → 事件名集合。reconfigure 用它算差集。 */
56
+ registeredSubBuses = new Map();
57
+ /** 已授权的发布:busAid → 事件名集合。 */
58
+ registeredPubBuses = new Map();
59
+ /** onEvent 回调已挂载的 bus。挂载与"订阅完全成功"是两件事:authorize 成功后回调即挂,
60
+ * 若 subscribe 失败重试,不能重复挂(真 SDK 上回调会累积)。生命周期同 unsubscribers。 */
61
+ handlerBuses = new Set();
62
+ /** 接入失败待重试的目标:`sub:<busAid>` / `pub:<busAid>` / `client` → 连续失败次数。 */
63
+ pendingRetry = new Map();
64
+ reconcileTimer;
65
+ reconciling = false;
66
+ /** 发布限流:按发布方 AID 独立计数(events-config.json 的 rateLimit)。 */
67
+ publishLimiter = new RateWindow();
68
+ constructor(options) {
69
+ this.options = options;
70
+ this.busHost = new BusHost({
71
+ aid: options.aid,
72
+ getClient: options.getClient,
73
+ requestGate: (senderAid, request, service) => this.gateRemoteRequest(senderAid, request, service),
74
+ // bus.start / bus.stop:只在进入 / 离开 running 时通知,中间态(starting、
75
+ // 自愈退避)不入台账——记了只会淹没真事件。写入由调用方(registry)负责。
76
+ onTransition: ({ from, to, detail }) => this.options.onBusTransition?.({
77
+ from, to, ...(detail ? { detail } : {}),
78
+ }),
79
+ });
80
+ }
81
+ get packs() { return this.current?.state.enabledPacks ?? []; }
82
+ get resolutions() { return this.current?.resolutions ?? new Map(); }
83
+ get center() { return this.current?.center; }
84
+ /** 启动:Bus(可选)→ 订阅 → 发布。任何一侧失败只记日志/台账,不影响其它侧。 */
85
+ async start(input) {
86
+ this.closed = false;
87
+ this.current = input;
88
+ this.configureRematerializeTimer();
89
+ this.configureContactsWatcher();
90
+ // 1. Bus 宿主(center.enabled 且目录非空)。
91
+ if (input.center.enabled && input.state.catalog.length > 0) {
92
+ try {
93
+ await this.busHost.ensureRunning({
94
+ catalog: toSdkCatalog(input.state.catalog),
95
+ allowlist: input.materializedAllowlist ?? this.options.materializeAllowlist?.(input.center, input.state.catalog.map(entry => entry.event))?.allowlist ?? toSdkAllowlist(input.center),
96
+ });
97
+ this.busHost.refreshGate();
98
+ this.reportGateStatus();
99
+ }
100
+ catch (error) {
101
+ logger.warn(`[EventCenter] ${this.options.aid} bus start deferred: ${errorMessage(error)} (自愈重试中)`);
102
+ }
103
+ }
104
+ // 2. 订阅(先回调、后鉴权、再订阅)。
105
+ await this.startSubscribers(input);
106
+ // 3. 发布授权。
107
+ await this.startPublishers(input);
108
+ }
109
+ async updateCenter(center, materialized) {
110
+ if (!this.current)
111
+ return;
112
+ this.current = { ...this.current, center, materializedAllowlist: materialized.allowlist };
113
+ if (center.enabled && this.current.state.catalog.length > 0 && !materialized.degraded) {
114
+ await this.busHost.apply({ catalog: toSdkCatalog(this.current.state.catalog), allowlist: materialized.allowlist });
115
+ }
116
+ else if (!center.enabled || this.current.state.catalog.length === 0) {
117
+ await this.busHost.apply(null);
118
+ }
119
+ this.configureRematerializeTimer();
120
+ this.configureContactsWatcher();
121
+ this.busHost.refreshGate();
122
+ this.reportGateStatus();
123
+ }
124
+ configureRematerializeTimer() {
125
+ if (this.rematerializeTimer) {
126
+ clearInterval(this.rematerializeTimer);
127
+ this.rematerializeTimer = undefined;
128
+ }
129
+ const interval = this.current?.center.admission.rematerializeMs;
130
+ if (this.options.materializeAllowlist && Number.isInteger(interval) && (interval ?? 0) > 0) {
131
+ this.rematerializeTimer = setInterval(() => { void this.rematerialize(); }, interval);
132
+ this.rematerializeTimer.unref?.();
133
+ }
134
+ }
135
+ async rematerialize() {
136
+ const current = this.current;
137
+ const materializer = this.options.materializeAllowlist;
138
+ if (!current || !materializer || !current.center.enabled || current.state.catalog.length === 0)
139
+ return;
140
+ try {
141
+ const result = materializer(current.center, current.state.catalog.map(entry => entry.event));
142
+ if (result.degraded) {
143
+ logger.warn(`[EventCenter] ${this.options.aid} admission materialization degraded: ${result.reason ?? 'unknown'}`);
144
+ return;
145
+ }
146
+ await this.busHost.apply({ catalog: toSdkCatalog(current.state.catalog), allowlist: result.allowlist });
147
+ if (this.current === current)
148
+ this.current = { ...current, materializedAllowlist: result.allowlist };
149
+ this.busHost.refreshGate();
150
+ this.reportGateStatus();
151
+ }
152
+ catch (error) {
153
+ logger.warn(`[EventCenter] ${this.options.aid} admission rematerialization failed: ${errorMessage(error)}`);
154
+ }
155
+ }
156
+ /** 热更新:P0 采用整停整起(退订 → 关闭 → 重新 start)。 */
157
+ async restart(input) {
158
+ await this.stopConnections();
159
+ await this.start(input);
160
+ }
161
+ /**
162
+ * 热更新(增量):不重建任何 AUN 连接,只在现有连接上做 diff。
163
+ *
164
+ * 为什么不能用 `restart()`:Bus 是单设备租约,关掉 client 后服务端要几十秒
165
+ * 才释放,立刻重开必然 DEVICE_CONFLICT;而订阅侧刚建好的 sub client 也会因为
166
+ * 对端 Bus 不可用而 authorize 超时,之后不再重试。结果是"文件改了、Bus 挂着、
167
+ * 订阅丢了"。设计 §8 的热更新表本来就要求:改 handler / args / timeout 只换本地
168
+ * 映射不动订阅,加事件才重新 authorize + subscribe,删事件才 unsubscribe。
169
+ */
170
+ async reconfigure(input) {
171
+ const previous = this.current;
172
+ this.closed = false;
173
+ this.current = input;
174
+ this.configureRematerializeTimer();
175
+ this.configureContactsWatcher();
176
+ // 配置已变(新包集合/新解析结果):接入重试从头计退避,随后 diff 自会重排队列。
177
+ this.pendingRetry.clear();
178
+ this.clearReconcileTimer();
179
+ // ① Bus:只有 center 配置或 catalog 变了才动;运行中走 updateConfig(不重启 client)。
180
+ const nextBus = input.center.enabled && input.state.catalog.length > 0
181
+ ? {
182
+ catalog: toSdkCatalog(input.state.catalog),
183
+ allowlist: input.materializedAllowlist
184
+ ?? this.options.materializeAllowlist?.(input.center, input.state.catalog.map(entry => entry.event))?.allowlist
185
+ ?? toSdkAllowlist(input.center),
186
+ }
187
+ : null;
188
+ if (!previous || !sameBusConfig(this.busConfigOf(previous), nextBus)) {
189
+ try {
190
+ await this.busHost.apply(nextBus);
191
+ this.busHost.refreshGate();
192
+ this.reportGateStatus();
193
+ }
194
+ catch (error) {
195
+ logger.warn(`[EventCenter] ${this.options.aid} bus apply failed: ${errorMessage(error)}`);
196
+ }
197
+ }
198
+ // ② 订阅:按 bus 求差集。已有 bus 只增删事件,回调与 client 都复用。
199
+ await this.diffSubscribers(input);
200
+ // ③ 发布:新增 bus 或新增事件都要整批重新 authorize(SDK 续期不自动扩 scope)。
201
+ await this.diffPublishers(input);
202
+ }
203
+ /** 当前 bus 配置(未启用或无 catalog 时为 null),用于判定是否需要 apply。 */
204
+ busConfigOf(input) {
205
+ if (!input.center.enabled || input.state.catalog.length === 0)
206
+ return null;
207
+ return {
208
+ catalog: toSdkCatalog(input.state.catalog),
209
+ allowlist: input.materializedAllowlist
210
+ ?? this.options.materializeAllowlist?.(input.center, input.state.catalog.map(entry => entry.event))?.allowlist
211
+ ?? toSdkAllowlist(input.center),
212
+ };
213
+ }
214
+ // ── 失败驱动的对账重试(M1)─────────────────────────────────────────────
215
+ // 设计:接入(authorize/subscribe/建连接)失败的目标进 pendingRetry;单个
216
+ // unref 定时器仅在 pending 非空时存在,触发时只跑订阅/发布差集(稳态零
217
+ // RPC/零日志/零台账),成功即出队,失败指数退避。SDK 的 recover() 只救
218
+ // "authorize 成功过"的会话,初次失败的洞由这里补。
219
+ /** 对账入口:只做差集,不重建连接、不动 Bus/定时器/watcher(与 reconfigure 的区别)。 */
220
+ async reconcile() {
221
+ if (this.closed || !this.current || this.reconciling)
222
+ return;
223
+ this.reconciling = true;
224
+ try {
225
+ this.prunePendingKeys();
226
+ await this.diffSubscribers(this.current, 'daemon.reconcile');
227
+ await this.diffPublishers(this.current);
228
+ }
229
+ finally {
230
+ this.reconciling = false;
231
+ if (this.pendingRetry.size === 0)
232
+ this.clearReconcileTimer();
233
+ }
234
+ }
235
+ /** 丢掉已不在期望集合里的重试目标(包删了/改了 bus),否则空差集会空转重试。 */
236
+ prunePendingKeys() {
237
+ const current = this.current;
238
+ if (!current)
239
+ return;
240
+ const subs = new Set(this.subscriptionTargets(current).map(target => target.busAid));
241
+ const pubs = new Set(this.publisherTargets(current).map(target => target.busAid));
242
+ for (const key of this.pendingRetry.keys()) {
243
+ if (key === 'client')
244
+ continue;
245
+ const [kind, ...rest] = key.split(':');
246
+ const busAid = rest.join(':');
247
+ if (kind === 'sub' && !subs.has(busAid))
248
+ this.pendingRetry.delete(key);
249
+ else if (kind === 'pub' && !pubs.has(busAid))
250
+ this.pendingRetry.delete(key);
251
+ }
252
+ if (this.pendingRetry.size === 0)
253
+ this.clearReconcileTimer();
254
+ }
255
+ /**
256
+ * 获取(并缓存)agent 主 client。连接不归事件中心所有,但 AUN 渠道会在重连/复权时
257
+ * 整个换掉 client 对象——换代即视为全新会话:旧监听摘除、订阅/发布差集基线清空
258
+ * (新连接上没有任何 authorize/subscribe 痕迹),下一次差集自然全量重建。
259
+ * 渠道未就绪返回 undefined(进退避重试;ready 事件会提前唤醒)。
260
+ */
261
+ async ensureClient() {
262
+ let fresh;
263
+ try {
264
+ fresh = await this.options.getClient(this.options.aid) ?? undefined;
265
+ }
266
+ catch (error) {
267
+ // 渠道读取异常按"未就绪"处理:进退避,不向 reconcile/publish 传播成未处理拒绝。
268
+ logger.warn(`[EventCenter] ${this.options.aid} client lookup failed: ${errorMessage(error)}`);
269
+ this.scheduleReconcileRetry('client');
270
+ return undefined;
271
+ }
272
+ if (!fresh) {
273
+ this.scheduleReconcileRetry('client');
274
+ return undefined;
275
+ }
276
+ if (fresh !== this.client) {
277
+ this.forgetClient('replaced');
278
+ }
279
+ if (!this.clientReadyOff) {
280
+ const handler = (value) => {
281
+ if (value?.state === 'ready' && this.pendingRetry.size > 0)
282
+ void this.reconcile();
283
+ };
284
+ this.clientReadyHandler = handler;
285
+ const subscription = fresh.on('state_change', handler);
286
+ this.clientReadyOff = eventListenerOff(fresh, 'state_change', subscription, handler);
287
+ this.client = fresh;
288
+ }
289
+ return fresh;
290
+ }
291
+ /** 摘监听、清差集基线。`reason` 只用于日志口径:replaced(换连接)/ stopped(停机)。 */
292
+ forgetClient(reason) {
293
+ this.clientReadyOff?.();
294
+ this.clientReadyOff = undefined;
295
+ this.clientReadyHandler = undefined;
296
+ this.client = undefined;
297
+ for (const off of this.unsubscribers.splice(0)) {
298
+ try {
299
+ off();
300
+ }
301
+ catch { /* 已失效 */ }
302
+ }
303
+ // 新连接/停机后差集基线必须清空:否则"事件看起来已注册过"会跳过 authorize,
304
+ // 后续 publish/subscribe 在全新会话上必失败。基线描述的是当前连接上的事实。
305
+ this.registeredSubBuses.clear();
306
+ this.registeredPubBuses.clear();
307
+ this.handlerBuses.clear();
308
+ void reason;
309
+ }
310
+ scheduleReconcileRetry(key) {
311
+ if (this.closed)
312
+ return;
313
+ this.pendingRetry.set(key, (this.pendingRetry.get(key) ?? 0) + 1);
314
+ const attempts = this.pendingRetry.get(key);
315
+ const base = Math.max(1, this.options.reconcileBaseMs ?? 5_000);
316
+ const max = Math.max(base, this.options.reconcileMaxMs ?? 60_000);
317
+ const delay = Math.min(max, base * 2 ** Math.min(attempts - 1, 4));
318
+ if (this.reconcileTimer)
319
+ return; // 已有定时器:到点统一对账,失败各自续退避
320
+ this.reconcileTimer = setTimeout(() => {
321
+ this.reconcileTimer = undefined;
322
+ void this.reconcile();
323
+ }, delay);
324
+ this.reconcileTimer.unref?.();
325
+ }
326
+ clearReconcileTimer() {
327
+ if (this.reconcileTimer)
328
+ clearTimeout(this.reconcileTimer);
329
+ this.reconcileTimer = undefined;
330
+ }
331
+ /** 订阅增量:新增 bus 走完整接入;已有 bus 只补新增事件、退掉删除事件。 */
332
+ async diffSubscribers(input, actor = 'daemon.reload') {
333
+ const desired = new Map();
334
+ for (const target of this.subscriptionTargets(input)) {
335
+ const set = desired.get(target.busAid) ?? new Set();
336
+ for (const event of target.events)
337
+ set.add(event);
338
+ desired.set(target.busAid, set);
339
+ }
340
+ if (desired.size === 0 && this.registeredSubBuses.size === 0)
341
+ return;
342
+ const handle = await this.ensureClient();
343
+ if (!handle)
344
+ return; // 渠道未就绪:已排退避重试,ready 事件可提前唤醒。
345
+ const client = handle.EventService;
346
+ // 退订:已注册但当前包不再需要的 bus / 事件。
347
+ for (const [busAid, events] of [...this.registeredSubBuses]) {
348
+ const wanted = desired.get(busAid);
349
+ const removed = [...events].filter(event => !wanted?.has(event));
350
+ if (removed.length > 0) {
351
+ try {
352
+ await client.unsubscribe(busAid, removed);
353
+ for (const event of removed)
354
+ events.delete(event);
355
+ logger.info(`[EventCenter] ${this.options.aid} unsubscribed ${busAid}: ${removed.join(', ')}`);
356
+ this.options.onUnsubscribe?.({ busAid, events: removed });
357
+ }
358
+ catch (error) {
359
+ logger.warn(`[EventCenter] ${this.options.aid} unsubscribe ${busAid} failed: ${errorMessage(error)}`);
360
+ }
361
+ }
362
+ if (events.size === 0) {
363
+ this.registeredSubBuses.delete(busAid);
364
+ }
365
+ }
366
+ // 订阅:新 bus 完整接入;旧 bus 只补新增事件。
367
+ for (const [busAid, events] of desired) {
368
+ const registered = this.registeredSubBuses.get(busAid);
369
+ const added = [...events].filter(event => !registered?.has(event));
370
+ if (added.length === 0)
371
+ continue;
372
+ try {
373
+ // authorize 必须整批带上前面的全部事件:SDK 续期不会自动扩 scope。
374
+ await client.authorize(busAid, 'sub', 'allowlist', [...events]);
375
+ if (!this.handlerBuses.has(busAid)) {
376
+ const off = client.onEvent(busAid, payload => {
377
+ const event = toReceivedEvent(busAid, payload);
378
+ if (event)
379
+ this.options.onEvent(event);
380
+ });
381
+ this.unsubscribers.push(() => { off(); });
382
+ this.handlerBuses.add(busAid);
383
+ }
384
+ await client.subscribe(busAid, added);
385
+ this.registeredSubBuses.set(busAid, new Set(events));
386
+ this.pendingRetry.delete(`sub:${busAid}`);
387
+ for (const target of this.subscriptionTargets(input).filter(item => item.busAid === busAid)) {
388
+ packLedger(target.pack).append({ action: 'subscribe', result: 'ok', bus: busAid, events: target.events, actor, revision: target.pack.revision });
389
+ }
390
+ logger.info(`[EventCenter] ${this.options.aid} subscribed ${busAid}: ${added.join(', ')}`);
391
+ }
392
+ catch (error) {
393
+ logger.warn(`[EventCenter] ${this.options.aid} subscribe ${busAid} failed: ${errorMessage(error)}`);
394
+ this.scheduleReconcileRetry(`sub:${busAid}`);
395
+ }
396
+ }
397
+ }
398
+ /** 发布增量:新 bus 或新事件都要重新 authorize(整批,不是只授权新增的那个)。 */
399
+ async diffPublishers(input) {
400
+ const desired = new Map();
401
+ for (const target of this.publisherTargets(input)) {
402
+ const set = desired.get(target.busAid) ?? new Set();
403
+ for (const event of target.events)
404
+ set.add(event);
405
+ desired.set(target.busAid, set);
406
+ }
407
+ if (desired.size === 0)
408
+ return;
409
+ const handle = await this.ensureClient();
410
+ if (!handle)
411
+ return; // 渠道未就绪:已排退避重试。
412
+ const client = handle.EventService;
413
+ for (const [busAid, events] of desired) {
414
+ const registered = this.registeredPubBuses.get(busAid);
415
+ const added = [...events].filter(event => !registered?.has(event));
416
+ if (added.length === 0)
417
+ continue;
418
+ try {
419
+ await client.authorize(busAid, 'pub', 'allowlist', [...events]);
420
+ this.registeredPubBuses.set(busAid, new Set(events));
421
+ this.pendingRetry.delete(`pub:${busAid}`);
422
+ logger.info(`[EventCenter] ${this.options.aid} publish authorized ${busAid}: ${[...events].join(', ')}`);
423
+ }
424
+ catch (error) {
425
+ logger.warn(`[EventCenter] ${this.options.aid} publish authorize ${busAid} failed: ${errorMessage(error)}`);
426
+ this.scheduleReconcileRetry(`pub:${busAid}`);
427
+ }
428
+ }
429
+ }
430
+ /** publish 目标按 bus 聚合(reconfigure 与 startPublishers 共用)。 */
431
+ publisherTargets(input) {
432
+ const byBus = new Map();
433
+ for (const pack of input.state.enabledPacks) {
434
+ for (const entry of pack.publish) {
435
+ const busAid = input.resolutions.get(pack.id)?.get(entry.bus) ?? entry.busResolved;
436
+ if (!busAid)
437
+ continue;
438
+ const key = `${busAid}\u0000${pack.id}`;
439
+ const group = byBus.get(key) ?? { pack, busAid, events: new Set() };
440
+ group.events.add(entry.event);
441
+ byBus.set(key, group);
442
+ }
443
+ }
444
+ return [...byBus.values()].map(group => ({ pack: group.pack, busAid: group.busAid, events: [...group.events] }));
445
+ }
446
+ resolvedBus(pack, ref, resolutions) {
447
+ return resolutions.get(pack.id)?.get(ref) ?? pack.subscribe.find(entry => entry.bus === ref)?.busResolved;
448
+ }
449
+ subscriptionTargets(input) {
450
+ const byBus = new Map();
451
+ for (const pack of input.state.enabledPacks) {
452
+ for (const entry of pack.subscribe) {
453
+ const busAid = input.resolutions.get(pack.id)?.get(entry.bus) ?? entry.busResolved;
454
+ if (!busAid)
455
+ continue;
456
+ const key = `${busAid}\u0000${pack.id}`;
457
+ const group = byBus.get(key) ?? { pack, busAid, events: new Set() };
458
+ group.events.add(entry.event);
459
+ byBus.set(key, group);
460
+ }
461
+ }
462
+ return [...byBus.values()].map(group => ({ pack: group.pack, busAid: group.busAid, events: [...group.events] }));
463
+ }
464
+ async startSubscribers(input) {
465
+ const targets = this.subscriptionTargets(input);
466
+ if (targets.length === 0)
467
+ return;
468
+ const handle = await this.ensureClient();
469
+ if (!handle) {
470
+ // 渠道未就绪:整批记台账(对齐旧 client create 失败的口径),退避重试。
471
+ for (const target of targets) {
472
+ packLedger(target.pack).append({ action: 'subscribe', result: 'failed', bus: target.busAid, events: target.events, code: 'CLIENT_UNAVAILABLE', reason: 'agent AUN client unavailable', actor: 'daemon.start', revision: target.pack.revision });
473
+ }
474
+ return;
475
+ }
476
+ const service = handle.EventService;
477
+ // 同一 Bus 聚合订阅集(跨包共享一条连接,角色绑定 per (client, bus))。
478
+ const busEvents = new Map();
479
+ for (const target of targets) {
480
+ const set = busEvents.get(target.busAid) ?? new Set();
481
+ for (const event of target.events)
482
+ set.add(event);
483
+ busEvents.set(target.busAid, set);
484
+ }
485
+ for (const [busAid, events] of busEvents) {
486
+ // ① 鉴权必须先做:SDK 的 onEvent 走 client(bus_aid, 'sub'),而 client() 要求该 bus
487
+ // 已绑定;绑定发生在 authorize() 内部的 bindBus。首次接入某个 bus 时若先调 onEvent,
488
+ // 必然抛 BUS_NOT_BOUND,订阅虽然成功但回调永远挂不上(事件被静默吞掉)。
489
+ try {
490
+ await service.authorize(busAid, 'sub', 'allowlist', [...events]);
491
+ }
492
+ catch (error) {
493
+ const code = errorCode(error);
494
+ for (const target of targets.filter(item => item.busAid === busAid)) {
495
+ packLedger(target.pack).append({
496
+ action: code === 'FORBIDDEN' ? 'authorize.failed' : 'subscribe',
497
+ result: 'failed', bus: busAid, events: [...events], code, reason: errorMessage(error), actor: 'daemon.start', revision: target.pack.revision,
498
+ });
499
+ }
500
+ logger.warn(`[EventCenter] ${this.options.aid} subscribe ${busAid} failed: ${code}: ${errorMessage(error)}`);
501
+ this.scheduleReconcileRetry(`sub:${busAid}`);
502
+ continue;
503
+ }
504
+ // ② 回调注册(SDK 按 bus 串行派发,此处必须非阻塞)。
505
+ try {
506
+ if (!this.handlerBuses.has(busAid)) {
507
+ const off = service.onEvent(busAid, payload => {
508
+ const event = toReceivedEvent(busAid, payload);
509
+ if (event)
510
+ this.options.onEvent(event);
511
+ });
512
+ this.unsubscribers.push(() => { off(); });
513
+ this.handlerBuses.add(busAid);
514
+ }
515
+ }
516
+ catch (error) {
517
+ const code = errorCode(error);
518
+ for (const target of targets.filter(item => item.busAid === busAid)) {
519
+ packLedger(target.pack).append({
520
+ action: 'subscribe', result: 'failed', bus: busAid, events: [...events], code, reason: `onEvent: ${errorMessage(error)}`, actor: 'daemon.start', revision: target.pack.revision,
521
+ });
522
+ }
523
+ logger.warn(`[EventCenter] ${this.options.aid} onEvent(${busAid}) register failed: ${code}: ${errorMessage(error)}`);
524
+ this.scheduleReconcileRetry(`sub:${busAid}`);
525
+ continue;
526
+ }
527
+ // ③ 订阅;失败记台账(FORBIDDEN 等),继续其它 Bus。
528
+ try {
529
+ await service.subscribe(busAid, [...events]);
530
+ this.registeredSubBuses.set(busAid, new Set(events));
531
+ this.pendingRetry.delete(`sub:${busAid}`);
532
+ for (const target of targets.filter(item => item.busAid === busAid)) {
533
+ packLedger(target.pack).append({ action: 'subscribe', result: 'ok', bus: busAid, events: [...events], actor: 'daemon.start', revision: target.pack.revision });
534
+ }
535
+ logger.info(`[EventCenter] ${this.options.aid} subscribed ${busAid}: ${[...events].join(', ')}`);
536
+ }
537
+ catch (error) {
538
+ const code = errorCode(error);
539
+ for (const target of targets.filter(item => item.busAid === busAid)) {
540
+ packLedger(target.pack).append({
541
+ action: code === 'FORBIDDEN' ? 'authorize.failed' : 'subscribe',
542
+ result: 'failed', bus: busAid, events: [...events], code, reason: errorMessage(error), actor: 'daemon.start', revision: target.pack.revision,
543
+ });
544
+ }
545
+ logger.warn(`[EventCenter] ${this.options.aid} subscribe ${busAid} failed: ${code}: ${errorMessage(error)}`);
546
+ this.scheduleReconcileRetry(`sub:${busAid}`);
547
+ }
548
+ }
549
+ }
550
+ async startPublishers(input) {
551
+ const targets = new Map();
552
+ for (const pack of input.state.enabledPacks) {
553
+ for (const entry of pack.publish) {
554
+ const busAid = input.resolutions.get(pack.id)?.get(entry.bus) ?? entry.busResolved;
555
+ if (!busAid)
556
+ continue;
557
+ const group = targets.get(busAid) ?? { packs: [], events: new Set() };
558
+ group.packs.push(pack);
559
+ group.events.add(entry.event);
560
+ targets.set(busAid, group);
561
+ }
562
+ }
563
+ if (targets.size === 0)
564
+ return;
565
+ const handle = await this.ensureClient();
566
+ if (!handle) {
567
+ this.scheduleReconcileRetry('client');
568
+ return;
569
+ }
570
+ for (const [busAid, group] of targets) {
571
+ try {
572
+ await handle.EventService.authorize(busAid, 'pub', 'allowlist', [...group.events]);
573
+ this.registeredPubBuses.set(busAid, new Set(group.events));
574
+ this.pendingRetry.delete(`pub:${busAid}`);
575
+ logger.info(`[EventCenter] ${this.options.aid} publish authorized ${busAid}: ${[...group.events].join(', ')}`);
576
+ }
577
+ catch (error) {
578
+ const code = errorCode(error);
579
+ for (const pack of group.packs) {
580
+ packLedger(pack).append({ action: 'authorize.failed', result: 'failed', bus: busAid, code, reason: errorMessage(error), actor: 'daemon.start', revision: pack.revision });
581
+ }
582
+ logger.warn(`[EventCenter] ${this.options.aid} publish authorize ${busAid} failed: ${code}: ${errorMessage(error)}`);
583
+ this.scheduleReconcileRetry(`pub:${busAid}`);
584
+ }
585
+ }
586
+ }
587
+ /** 发布事件(CLI/IPC 入口)。 */
588
+ async publish(packId, eventName, data, ttlSeconds, publisherAid) {
589
+ const pack = this.packs.find(candidate => candidate.id === packId);
590
+ if (!pack)
591
+ throw new EventCenterError('PACK_NOT_FOUND', `pack not found or invalid: ${packId}`);
592
+ const entry = pack.publish.find(candidate => candidate.event === eventName);
593
+ if (!entry)
594
+ throw new EventCenterError('EVENT_NOT_FOUND', `pack "${packId}" has no publish entry for "${eventName}"`);
595
+ const busAid = this.resolutions.get(packId)?.get(entry.bus) ?? entry.busResolved;
596
+ if (!busAid)
597
+ throw new EventCenterError('BUS_UNRESOLVED', `bus "${entry.bus}" unresolved for pack "${packId}"`);
598
+ // 每次发布都经 ensureClient 刷新引用:渠道可能已换代(重连重建 client),
599
+ // 缓存的旧引用上发布必然失败。对象未变时这只是一次轻量的 provider 读取。
600
+ const handle = await this.ensureClient();
601
+ if (!handle)
602
+ throw new EventCenterError('PUB_NOT_CONFIGURED', 'agent AUN client unavailable; publish not possible yet');
603
+ // 限流:保护订阅方脚本,不是保护传输。超限不回包——事件本身没有应答语义,
604
+ // 调用方拿到明确错误码才知道被限了。
605
+ const quota = this.current?.center.rateLimit ?? { perMinute: 60, perHour: 600 };
606
+ const decision = this.publishLimiter.consume(publisherAid ?? this.options.aid, quota);
607
+ if (!decision.allow) {
608
+ throw new EventCenterError('RATE_LIMITED', `publish rate limited; retry after ${decision.retryAfter ?? 60}s`, {
609
+ retryAfter: decision.retryAfter ?? 60,
610
+ });
611
+ }
612
+ return await handle.EventService.publish(busAid, eventName, data, ttlSeconds !== undefined ? { ttlSeconds } : undefined);
613
+ }
614
+ async stopConnections() {
615
+ if (this.rematerializeTimer) {
616
+ clearInterval(this.rematerializeTimer);
617
+ this.rematerializeTimer = undefined;
618
+ }
619
+ this.stopContactsWatcher();
620
+ // ① 注销回调 ② 退订 ③ 释放远程 bus 上的 sub/pub 角色绑定 ④ 停 Bus 宿主。
621
+ for (const off of this.unsubscribers.splice(0)) {
622
+ try {
623
+ off();
624
+ }
625
+ catch { /* 已失效 */ }
626
+ }
627
+ const client = this.client;
628
+ if (client && this.current) {
629
+ const busEvents = new Map();
630
+ for (const target of this.subscriptionTargets(this.current)) {
631
+ busEvents.set(target.busAid, [...new Set([...(busEvents.get(target.busAid) ?? []), ...target.events])]);
632
+ }
633
+ for (const [busAid, events] of busEvents) {
634
+ try {
635
+ await client.EventService.unsubscribe(busAid, events);
636
+ }
637
+ catch { /* 对端可能已不可达 */ }
638
+ // 远程 bus 上的 sub/pub 角色绑定显式关闭(停 renew 定时器与待发布队列)。
639
+ // 自有 bus 跳过:EventService.close(busAid) 会连 bus 宿主绑定一起关,
640
+ // 那是 BusHost 的生命周期,见 ④。
641
+ if (busAid !== this.options.aid) {
642
+ try {
643
+ await client.EventService.close(busAid);
644
+ }
645
+ catch { /* 未绑定或已失效 */ }
646
+ }
647
+ }
648
+ for (const busAid of this.registeredPubBuses.keys()) {
649
+ if (busAid !== this.options.aid) {
650
+ try {
651
+ await client.EventService.close(busAid);
652
+ }
653
+ catch { /* 同上 */ }
654
+ }
655
+ }
656
+ }
657
+ // 主连接不归事件中心所有,不能 close;只摘自己的 state_change 监听并清差集基线
658
+ //(下次接入是全新会话,不是增量)。
659
+ this.forgetClient('stopped');
660
+ this.pendingRetry.clear();
661
+ this.clearReconcileTimer();
662
+ await this.busHost.close().catch(() => { });
663
+ this.reportGateStatus();
664
+ }
665
+ async close() {
666
+ this.closed = true;
667
+ await this.stopConnections();
668
+ this.current = undefined;
669
+ }
670
+ gateRemoteRequest(senderAid, request, service) {
671
+ const current = this.current;
672
+ const materializer = this.options.materializeAllowlist;
673
+ if (!current || !materializer)
674
+ return;
675
+ if (!current.center.enabled) {
676
+ const decision = { allowed: false, operation: String(request.op ?? 'unknown'), reason: 'bus_disabled' };
677
+ this.rejectBusRequest(senderAid, decision);
678
+ throw Object.assign(new Error('event bus is disabled'), { code: 'FORBIDDEN' });
679
+ }
680
+ let materialized;
681
+ try {
682
+ materialized = materializer(current.center, current.state.catalog.map(entry => entry.event));
683
+ }
684
+ catch (error) {
685
+ logger.warn(`[EventCenter] ${this.options.aid} L2 gate check failed; continuing with SDK allowlist: ${errorMessage(error)}`);
686
+ return;
687
+ }
688
+ if (materialized.degraded) {
689
+ logger.warn(`[EventCenter] ${this.options.aid} L2 gate unavailable (${materialized.reason ?? 'unknown'}); continuing with SDK allowlist`);
690
+ return;
691
+ }
692
+ const decision = evaluateEventBusRequest(senderAid, request, materialized, service);
693
+ if (decision.allowed)
694
+ return;
695
+ this.rejectBusRequest(senderAid, decision);
696
+ throw Object.assign(new Error(`event request rejected: ${decision.reason ?? 'admission'}`), { code: 'FORBIDDEN' });
697
+ }
698
+ rejectBusRequest(senderAid, decision) {
699
+ this.options.onBusRequestRejected?.({
700
+ aid: senderAid,
701
+ operation: decision.operation,
702
+ ...(decision.event ? { event: decision.event } : {}),
703
+ ...(decision.action ? { action: decision.action } : {}),
704
+ reason: decision.reason ?? 'admission',
705
+ });
706
+ logger.warn(`[EventCenter] ${this.options.aid} rejected remote ${decision.operation}`
707
+ + `${decision.event ? ` ${decision.event}` : ''} from ${senderAid}: ${decision.reason ?? 'admission'}`);
708
+ }
709
+ reportGateStatus() {
710
+ const installed = this.busHost.gateInstalled;
711
+ if (this.lastGateStatus === installed)
712
+ return;
713
+ this.lastGateStatus = installed;
714
+ this.options.onGateStatus?.(installed);
715
+ }
716
+ configureContactsWatcher() {
717
+ this.stopContactsWatcher();
718
+ const current = this.current;
719
+ const contactsPath = this.options.contactsPath;
720
+ // 监听条件:bus 宿主活动(allowlist 重物化需要)或 已启用包用占位符($pa 等重解析需要);
721
+ // registry 可通过 input.contactsWatch 强制开(解析失败的包不在 enabledPacks 里,runtime 推导不到)。
722
+ const busHostActive = Boolean(current?.center.enabled) && (current?.state.catalog.length ?? 0) > 0;
723
+ const usesPlaceholders = (current?.state.enabledPacks ?? []).some(pack => [...pack.publish, ...pack.subscribe].some(entry => isBusPlaceholder(entry.bus)));
724
+ const shouldWatch = current?.contactsWatch ?? (busHostActive || usesPlaceholders);
725
+ if (!contactsPath || !current || !shouldWatch)
726
+ return;
727
+ const contactsDir = path.dirname(contactsPath);
728
+ const agentDir = path.dirname(contactsDir);
729
+ const queueRefresh = () => {
730
+ if (this.contactsRefreshTimer)
731
+ clearTimeout(this.contactsRefreshTimer);
732
+ this.contactsRefreshTimer = setTimeout(() => {
733
+ this.contactsRefreshTimer = undefined;
734
+ // 联系人变化会影响两件事,不能只做一件:
735
+ // ① 准入集合(allowlist 物化)—— 这里直接重算,立即可见;
736
+ // ② `$owner` / `$pa` 这类占位符的解析结果 —— 必须重扫包集合才知道,
737
+ // 交给调用方(registry)做整轮重扫;它内部同样会重算 ①。
738
+ // 只做 ① 会让订阅继续挂在旧 Bus 上,直到下一次 reload 才纠正。
739
+ void this.rematerialize();
740
+ this.options.onContactsChanged?.();
741
+ }, 2_000);
742
+ this.contactsRefreshTimer.unref?.();
743
+ };
744
+ const attachContactsWatcher = () => {
745
+ for (const watcher of this.contactsWatchers.splice(1))
746
+ watcher.close();
747
+ try {
748
+ const watcher = fs.watch(contactsDir, (_event, filename) => {
749
+ if (!filename || filename.toString() === path.basename(contactsPath))
750
+ queueRefresh();
751
+ });
752
+ this.contactsWatchers.push(watcher);
753
+ watcher.on('error', error => logger.debug(`[EventCenter] ${this.options.aid} contacts watcher: ${errorMessage(error)}`));
754
+ }
755
+ catch {
756
+ // The parent watcher and periodic refresh remain available if directory/ is absent.
757
+ }
758
+ };
759
+ try {
760
+ const parentWatcher = fs.watch(agentDir, (_event, filename) => {
761
+ if (!filename || filename.toString() === path.basename(contactsDir))
762
+ attachContactsWatcher();
763
+ });
764
+ this.contactsWatchers.push(parentWatcher);
765
+ parentWatcher.on('error', error => logger.debug(`[EventCenter] ${this.options.aid} contacts parent watcher: ${errorMessage(error)}`));
766
+ }
767
+ catch {
768
+ // Periodic materialization is the fallback on filesystems without watch support.
769
+ }
770
+ attachContactsWatcher();
771
+ }
772
+ stopContactsWatcher() {
773
+ if (this.contactsRefreshTimer)
774
+ clearTimeout(this.contactsRefreshTimer);
775
+ this.contactsRefreshTimer = undefined;
776
+ for (const watcher of this.contactsWatchers.splice(0))
777
+ watcher.close();
778
+ }
779
+ /** 状态快照(CLI status 用)。 */
780
+ /**
781
+ * 运行时状态。
782
+ *
783
+ * `subscriptions` 只列**真正建立**的订阅(`registeredSubBuses`),不是包声明。
784
+ * 这个区分很重要:声明态在"Bus running 但订阅没建起来"时照样显示有订阅,
785
+ * 会把排查引向错误方向(实测踩过:start() 自等待死锁时 status 显示正常)。
786
+ * 包声明里尚未生效的部分单独列在 `pendingSubscriptions`。
787
+ */
788
+ status() {
789
+ const subscriptions = new Map();
790
+ const activeByBus = new Map();
791
+ for (const [busAid, events] of this.registeredSubBuses)
792
+ activeByBus.set(busAid, new Set(events));
793
+ const pending = new Map();
794
+ const publishers = new Map();
795
+ if (this.current) {
796
+ for (const target of this.subscriptionTargets(this.current)) {
797
+ const active = activeByBus.get(target.busAid);
798
+ const bucket = pending;
799
+ const pendingEvents = target.events.filter(event => !active?.has(event));
800
+ if (pendingEvents.length > 0) {
801
+ const entry = bucket.get(target.busAid) ?? { events: new Set(), packs: new Set() };
802
+ for (const event of pendingEvents)
803
+ entry.events.add(event);
804
+ entry.packs.add(target.pack.id);
805
+ bucket.set(target.busAid, entry);
806
+ }
807
+ }
808
+ for (const [busAid, events] of activeByBus) {
809
+ const entry = subscriptions.get(busAid) ?? { events: new Set(), packs: new Set() };
810
+ for (const event of events)
811
+ entry.events.add(event);
812
+ for (const target of this.subscriptionTargets(this.current)) {
813
+ if (target.busAid === busAid && target.events.some(event => events.has(event)))
814
+ entry.packs.add(target.pack.id);
815
+ }
816
+ subscriptions.set(busAid, entry);
817
+ }
818
+ for (const pack of this.current.state.enabledPacks) {
819
+ for (const item of pack.publish) {
820
+ const busAid = this.current.resolutions.get(pack.id)?.get(item.bus) ?? item.busResolved;
821
+ if (!busAid)
822
+ continue;
823
+ const entry = publishers.get(busAid) ?? { events: new Set(), packs: new Set() };
824
+ entry.events.add(item.event);
825
+ entry.packs.add(pack.id);
826
+ publishers.set(busAid, entry);
827
+ }
828
+ }
829
+ }
830
+ return {
831
+ bus: { status: this.busHost.status, statusDetail: this.busHost.statusDetail },
832
+ subscriptions: [...subscriptions.entries()].map(([busAid, entry]) => ({ busAid, events: [...entry.events], packs: [...entry.packs] })),
833
+ pendingSubscriptions: [...pending.entries()].map(([busAid, entry]) => ({ busAid, events: [...entry.events], packs: [...entry.packs] })),
834
+ publishers: [...publishers.entries()].map(([busAid, entry]) => ({ busAid, events: [...entry.events], packs: [...entry.packs] })),
835
+ };
836
+ }
837
+ }