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,157 @@
1
+ /**
2
+ * 事件分发:SDK 事件 → 匹配包订阅 → received 日志 → filter → 队列 → 并发执行脚本 → handled 日志。
3
+ * 队列键 = 包:事件,每队列独立容量;全局并发上限。
4
+ */
5
+ import { logger } from '../utils/logger.js';
6
+ import { matchTriggerEvent } from '../trigger/event-source.js';
7
+ import { EventLog } from './event-log.js';
8
+ export const DEFAULT_DISPATCHER_LIMITS = { maxConcurrency: 5, queueSize: 100 };
9
+ /**
10
+ * 包内一条 subscribe 条目实际指向的 bus AID。
11
+ * 顺序与 handleEvent 一致:resolutions(占位符解析结果)→ busResolved → 字面 bus。
12
+ */
13
+ function resolveEntryBus(resolutions, packId, entry) {
14
+ return resolutions.get(packId)?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
15
+ }
16
+ export class EventDispatcher {
17
+ scriptRunner;
18
+ limits;
19
+ queues = new Map();
20
+ running = 0;
21
+ closed = false;
22
+ idleResolvers = [];
23
+ constructor(scriptRunner, limits = DEFAULT_DISPATCHER_LIMITS) {
24
+ this.scriptRunner = scriptRunner;
25
+ this.limits = limits;
26
+ }
27
+ setLimits(limits) {
28
+ this.limits = { ...this.limits, ...limits };
29
+ }
30
+ /** SDK onEvent 回调入口;必须非阻塞(SDK 内按 bus 串行派发)。 */
31
+ handleEvent(packs, resolutions, event) {
32
+ if (this.closed)
33
+ return;
34
+ for (const pack of packs) {
35
+ for (const entry of pack.subscribe) {
36
+ const busAid = resolutions.get(pack.id)?.get(entry.bus) ?? entry.busResolved;
37
+ if (busAid !== event.busAid || entry.event !== event.eventName)
38
+ continue;
39
+ const log = EventLog.forPack(pack);
40
+ // 写前日志:received 一定先落盘。
41
+ log.writeReceived(event);
42
+ if (entry.filter && !this.matches(entry.filter, event)) {
43
+ log.writeFiltered(event, 'filter_mismatch');
44
+ continue;
45
+ }
46
+ const key = `${pack.id}\u0000${entry.event}`;
47
+ const queue = this.queues.get(key) ?? [];
48
+ if (queue.length >= this.limits.queueSize) {
49
+ log.writeDropped(event, 'queue_full');
50
+ continue;
51
+ }
52
+ queue.push({ pack, event, resolutions });
53
+ this.queues.set(key, queue);
54
+ void this.tick();
55
+ }
56
+ }
57
+ }
58
+ /** filter 求值复用 trigger 语义:伪事件 = 事件正文字段展开 + type=事件名(type 保留,正文里的同名键被覆盖)。 */
59
+ matches(filter, event) {
60
+ const pseudo = typeof event.data === 'object' && event.data !== null && !Array.isArray(event.data)
61
+ ? { ...event.data, type: event.eventName }
62
+ : { type: event.eventName };
63
+ return matchTriggerEvent({ type: 'event', eventPattern: '*', filter }, pseudo).matched;
64
+ }
65
+ async tick() {
66
+ while (this.running < this.limits.maxConcurrency) {
67
+ const item = this.dequeue();
68
+ if (!item)
69
+ break;
70
+ this.running++;
71
+ try {
72
+ await this.execute(item);
73
+ }
74
+ finally {
75
+ this.running--;
76
+ }
77
+ }
78
+ if (this.running === 0 && this.isEmpty()) {
79
+ const waiters = [...this.idleResolvers];
80
+ this.idleResolvers.length = 0;
81
+ for (const resolve of waiters)
82
+ resolve();
83
+ }
84
+ }
85
+ dequeue() {
86
+ for (const [key, queue] of this.queues) {
87
+ if (queue.length === 0)
88
+ continue;
89
+ const item = queue.shift();
90
+ if (queue.length === 0)
91
+ this.queues.delete(key);
92
+ return item;
93
+ }
94
+ return null;
95
+ }
96
+ isEmpty() {
97
+ for (const queue of this.queues.values()) {
98
+ if (queue.length > 0)
99
+ return false;
100
+ }
101
+ return true;
102
+ }
103
+ async execute(item) {
104
+ const log = EventLog.forPack(item.pack);
105
+ // 热重载后订阅 handler 可能已变:从当前包配置重新取 handler。
106
+ //
107
+ // bus 的解析结果在 `resolutions` 里,`$self` / `$owner` 这类占位符**不会**写回
108
+ // `entry.busResolved`。只比 `busResolved` 会让占位符写法的包全部匹配失败,
109
+ // 表现是 received 有、handled 没有、脚本静默不跑。这里用与 handleEvent 相同的
110
+ // `resolutions → busResolved → bus` 链路解析。
111
+ const entry = item.pack.subscribe.find(candidate => resolveEntryBus(item.resolutions, item.pack.id, candidate) === item.event.busAid
112
+ && candidate.event === item.event.eventName);
113
+ if (!entry)
114
+ return; // 包已改,事件不再处理(received 已落盘)
115
+ try {
116
+ const outcome = await this.scriptRunner.run(item.pack, entry.handler, item.event);
117
+ log.writeHandled(item.event, {
118
+ cmd: outcome.cmd,
119
+ exit: outcome.exitCode,
120
+ ms: outcome.durationMs,
121
+ outcome: outcome.outcome,
122
+ ...(outcome.error ? { reason: `${outcome.error.code}: ${outcome.error.message}`.slice(0, 240) } : {}),
123
+ // 无沙箱执行必须留痕:事后排查「这个脚本为什么能读到不该读的东西」靠它。
124
+ ...(outcome.sandboxAbsent ? { sandboxAbsent: outcome.sandboxAbsent } : {}),
125
+ });
126
+ if (outcome.outcome === 'error' || outcome.outcome === 'timeout') {
127
+ logger.warn(`[EventCenter] ${item.pack.id} handler for ${item.event.eventName} ${outcome.outcome}: ${outcome.error?.code ?? ''} ${outcome.error?.message ?? ''}`);
128
+ }
129
+ }
130
+ catch (error) {
131
+ // 执行器自身异常(不应发生):按 error 记,不中断队列。
132
+ log.writeHandled(item.event, {
133
+ cmd: 'unavailable',
134
+ exit: -1,
135
+ ms: 0,
136
+ outcome: 'error',
137
+ reason: `DISPATCHER_ERROR: ${error instanceof Error ? error.message : String(error)}`.slice(0, 240),
138
+ });
139
+ }
140
+ }
141
+ /** 关闭:停止接收;已排队事件丢弃(volatile 语义),等待运行中脚本结束。 */
142
+ async close(drainTimeoutMs = 5_000) {
143
+ this.closed = true;
144
+ this.queues.clear();
145
+ if (this.running > 0) {
146
+ await Promise.race([
147
+ new Promise(resolve => {
148
+ this.idleResolvers.push(resolve);
149
+ }),
150
+ new Promise(resolve => {
151
+ const timer = setTimeout(resolve, drainTimeoutMs);
152
+ timer.unref?.();
153
+ }),
154
+ ]);
155
+ }
156
+ }
157
+ }
@@ -0,0 +1,110 @@
1
+ /**
2
+ * 事件日志(logs/events-YYYYMMDD.jsonl):写前日志,先 received 再执行脚本,结束补 handled。
3
+ * 行结构按 docs/event-center/schema/event-log.schema.json(additionalProperties: false)。
4
+ * P0 恒落 data 原文(dataHash 逻辑留接口)。
5
+ */
6
+ import fs from 'node:fs';
7
+ import path from 'node:path';
8
+ /** data 只在是 JSON 对象时按原样落盘(Schema 要求 object),其它形态包成 {@raw: string}。 */
9
+ function normalizeData(data) {
10
+ if (data !== null && typeof data === 'object' && !Array.isArray(data))
11
+ return data;
12
+ return { '@raw': JSON.stringify(data) };
13
+ }
14
+ export class EventLog {
15
+ logsDir;
16
+ constructor(logsDir) {
17
+ this.logsDir = logsDir;
18
+ }
19
+ static forPack(pack) {
20
+ return new EventLog(pack.paths.logsDir);
21
+ }
22
+ writeReceived(event) {
23
+ this.write({
24
+ ts: Date.now(),
25
+ kind: 'received',
26
+ eventId: event.eventId,
27
+ event: event.eventName,
28
+ bus: event.busAid,
29
+ publisher: event.publisher,
30
+ data: normalizeData(event.data),
31
+ });
32
+ }
33
+ writeHandled(event, detail) {
34
+ this.write({
35
+ ts: Date.now(),
36
+ kind: 'handled',
37
+ eventId: event.eventId,
38
+ event: event.eventName,
39
+ bus: event.busAid,
40
+ cmd: detail.cmd,
41
+ exit: detail.exit,
42
+ ms: detail.ms,
43
+ outcome: detail.outcome,
44
+ ...(detail.reason !== undefined ? { reason: detail.reason } : {}),
45
+ ...(detail.sandboxAbsent !== undefined ? { sandbox_absent: detail.sandboxAbsent } : {}),
46
+ });
47
+ }
48
+ writeDropped(event, reason) {
49
+ this.write({
50
+ ts: Date.now(),
51
+ kind: 'dropped',
52
+ eventId: event.eventId,
53
+ event: event.eventName,
54
+ bus: event.busAid,
55
+ reason,
56
+ });
57
+ }
58
+ writeFiltered(event, reason) {
59
+ this.write({
60
+ ts: Date.now(),
61
+ kind: 'filtered',
62
+ eventId: event.eventId,
63
+ event: event.eventName,
64
+ bus: event.busAid,
65
+ reason,
66
+ });
67
+ }
68
+ /** 按天分文件(本地日期);IO 失败吞掉。 */
69
+ write(line) {
70
+ const now = new Date();
71
+ const date = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}${String(now.getDate()).padStart(2, '0')}`;
72
+ try {
73
+ fs.mkdirSync(this.logsDir, { recursive: true });
74
+ fs.appendFileSync(path.join(this.logsDir, `events-${date}.jsonl`), `${JSON.stringify(line)}\n`, 'utf8');
75
+ }
76
+ catch {
77
+ // 日志写失败不中断事件处理。
78
+ }
79
+ }
80
+ /** 读某包最近的事件日志行(CLI tail 用)。 */
81
+ tail(count) {
82
+ let files;
83
+ try {
84
+ files = fs.readdirSync(this.logsDir).filter(name => /^events-\d{8}\.jsonl$/.test(name)).sort();
85
+ }
86
+ catch {
87
+ return [];
88
+ }
89
+ const lines = [];
90
+ for (const file of [...files].reverse()) {
91
+ try {
92
+ const text = fs.readFileSync(path.join(this.logsDir, file), 'utf8');
93
+ lines.unshift(...text.split('\n').filter(Boolean));
94
+ }
95
+ catch {
96
+ break;
97
+ }
98
+ if (lines.length >= count)
99
+ break;
100
+ }
101
+ return lines.slice(-count).map(line => {
102
+ try {
103
+ return JSON.parse(line);
104
+ }
105
+ catch {
106
+ return { ts: 0, kind: 'dropped', reason: 'unparseable log line' };
107
+ }
108
+ });
109
+ }
110
+ }
@@ -0,0 +1,73 @@
1
+ /**
2
+ * 生成 `$AGENT_DIR/events/.index.md`:本机已启用事件包的订阅/发布清单。
3
+ *
4
+ * 只列 enabled 且无冲突的包(PackState.enabledPacks)。空集时删除文件而不是写空文件——
5
+ * 让 manifest 的 `optional` 判定与文件存在性始终一致。
6
+ *
7
+ * 格式见 docs/eck/services-and-events-manifest.md §五。
8
+ */
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+ import { logger } from '../utils/logger.js';
12
+ export const EVENTS_INDEX_FILE = '.index.md';
13
+ /**
14
+ * @param eventsDir `$AGENT_DIR/events`
15
+ * @param enabledPacks 已启用且无冲突的包
16
+ * @param resolutions 包 → (bus 引用 → 解析后的 AID);用于把 `$owner` 等占位符渲染成真实值
17
+ */
18
+ export function writeEventsIndex(eventsDir, enabledPacks, resolutions) {
19
+ const filePath = path.join(eventsDir, EVENTS_INDEX_FILE);
20
+ if (enabledPacks.length === 0) {
21
+ try {
22
+ if (fs.existsSync(filePath)) {
23
+ fs.unlinkSync(filePath);
24
+ logger.debug(`[events-index] ${EVENTS_INDEX_FILE} 已删除(无启用事件包)`);
25
+ }
26
+ }
27
+ catch (error) {
28
+ logger.warn(`[events-index] cannot remove stale index: ${error instanceof Error ? error.message : String(error)}`);
29
+ }
30
+ return;
31
+ }
32
+ const lines = [];
33
+ lines.push(`[events] 本 Agent 已启用 ${enabledPacks.length} 个事件包,订阅以下事件。`);
34
+ lines.push('');
35
+ lines.push('事件是 TTL 内的在线通知,可能丢失;需要不丢的语义用普通消息。');
36
+ lines.push('');
37
+ for (const pack of enabledPacks) {
38
+ lines.push(`- ${pack.id}(${pack.name})`);
39
+ const resolution = resolutions?.get(pack.id);
40
+ for (const entry of pack.subscribe) {
41
+ const bus = resolution?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
42
+ lines.push(` 订阅: ${bus} 的 ${entry.event} → ${entry.handler.script}`);
43
+ }
44
+ for (const entry of pack.publish) {
45
+ const bus = resolution?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
46
+ lines.push(` 发布: ${bus} 的 ${entry.event}(本机可发)`);
47
+ }
48
+ if (pack.subscribe.length === 0 && pack.publish.length === 0) {
49
+ lines.push(' (仅登记事件目录,无订阅或发布)');
50
+ }
51
+ }
52
+ lines.push('');
53
+ lines.push('本机管理: ec events status / ledger / tail / reload');
54
+ lines.push('');
55
+ try {
56
+ fs.mkdirSync(eventsDir, { recursive: true });
57
+ // 内容未变则跳过写盘:reload 可能由 contacts/watcher 高频触发,.index.md 又在
58
+ // events/ 目录内(被 watcher 监听),重复写会既刷盘又自触发。
59
+ const content = lines.join('\n');
60
+ try {
61
+ if (fs.readFileSync(filePath, 'utf8') === content)
62
+ return;
63
+ }
64
+ catch {
65
+ // 读不到(尚不存在等)按需写。
66
+ }
67
+ fs.writeFileSync(filePath, content, 'utf8');
68
+ logger.debug(`[events-index] ${EVENTS_INDEX_FILE} 已生成(${enabledPacks.length} 个包)`);
69
+ }
70
+ catch (error) {
71
+ logger.warn(`[events-index] cannot write index: ${error instanceof Error ? error.message : String(error)}`);
72
+ }
73
+ }