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.
- package/CHANGELOG.md +95 -0
- package/bin/ecmsg.js +188 -58
- package/dist/agent-template/jobs.js +62 -0
- package/dist/agent-template/runtime.js +214 -0
- package/dist/agent-template/service.js +465 -0
- package/dist/agent-template/tool-runner.js +45 -0
- package/dist/agent-template/types.js +5 -0
- package/dist/agents/baseagent-availability.js +1 -1
- package/dist/agents/claude-runner.js +1 -1
- package/dist/agents/codex/app-server-client.js +22 -0
- package/dist/agents/codex-runner.js +69 -2
- package/dist/aun/aid/agentmd.js +56 -1
- package/dist/aun/aid/client.js +3 -1
- package/dist/aun/menu/client.js +3 -2
- package/dist/aun/msg/p2p.js +6 -1
- package/dist/channels/aun.js +277 -49
- package/dist/cli/agent-command.js +5 -0
- package/dist/cli/agent-create.js +7 -3
- package/dist/cli/agent-template.js +124 -0
- package/dist/cli/aun-commands.js +2 -2
- package/dist/cli/ctl-command.js +2 -1
- package/dist/cli/daemon-commands.js +11 -66
- package/dist/cli/daemon-lifecycle-client.js +61 -0
- package/dist/cli/ecmsg-gateway.js +35 -2
- package/dist/cli/events-command.js +109 -0
- package/dist/cli/index.js +60 -14
- package/dist/cli/invoke-command.js +182 -0
- package/dist/cli/managed-command-guard.js +6 -1
- package/dist/cli/net-check.js +1 -1
- package/dist/cli/restart-monitor.js +160 -83
- package/dist/cli/services-command.js +137 -0
- package/dist/cli/team-workspace-command.js +134 -0
- package/dist/cli/thread-command.js +103 -13
- package/dist/cli/watch-msg.js +1 -1
- package/dist/config/boot-log.js +8 -8
- package/dist/config/config-field-policy.js +2 -2
- package/dist/config/config-manager.js +0 -7
- package/dist/config/invoke-ipc-service.js +118 -0
- package/dist/config/schema-migration.js +45 -15
- package/dist/config-store.js +2 -1
- package/dist/core/agent-ipc-registration.js +25 -4
- package/dist/core/agent-reload-coordinator.js +6 -4
- package/dist/core/agent-runtime.js +106 -10
- package/dist/core/auth/delegation-authorization.js +66 -0
- package/dist/core/auth/operation-authorizer.js +2 -0
- package/dist/core/auth/operation-catalog.js +29 -0
- package/dist/core/baseagent-loader.js +60 -130
- package/dist/core/channel-loader.js +10 -1
- package/dist/core/channel-runtime.js +20 -12
- package/dist/core/command/agent-control.js +12 -2
- package/dist/core/command/agent-storage-menu.js +1 -1
- package/dist/core/command/agent-template-menu.js +147 -0
- package/dist/core/command/chatmode-config.js +2 -36
- package/dist/core/command/command-handler.js +80 -17
- package/dist/core/command/data-root-resolver.js +32 -23
- package/dist/core/command/eventcenter-menu.js +468 -0
- package/dist/core/command/menu-catalog.js +15 -0
- package/dist/core/command/menu-handler.js +216 -90
- package/dist/core/command/menu-protocol.js +71 -13
- package/dist/core/command/menu-query-batch.js +194 -0
- package/dist/core/command/slash-gate.js +1 -1
- package/dist/core/command/slash-handler.js +34 -42
- package/dist/core/command/team-workspace-bootstrap.js +350 -0
- package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
- package/dist/core/command/team-workspace-initializer.js +2 -0
- package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
- package/dist/core/command/team-workspace-job-store.js +88 -0
- package/dist/core/command/team-workspace-management-service.js +2 -0
- package/dist/core/command/team-workspace-management-store.js +96 -0
- package/dist/core/command/team-workspace-management.js +265 -0
- package/dist/core/command/team-workspace-members-menu.js +88 -0
- package/dist/core/command/team-workspace-store.js +612 -0
- package/dist/core/command/team-workspace-team.js +193 -0
- package/dist/core/daemon-control.js +22 -5
- package/dist/core/daemon-lifecycle.js +323 -191
- package/dist/core/handoff/runtime.js +45 -13
- package/dist/core/invoke/executors/index.js +13 -0
- package/dist/core/invoke/executors/media.js +283 -0
- package/dist/core/invoke/executors/text.js +198 -0
- package/dist/core/invoke/invoke-service.js +157 -0
- package/dist/core/invoke/style-router.js +48 -0
- package/dist/core/invoke/types.js +19 -0
- package/dist/core/ipc-registration.js +50 -7
- package/dist/core/legacy-rename.js +41 -0
- package/dist/core/memory/consolidation.js +7 -5
- package/dist/core/message/aun-ipc-sender.js +252 -17
- package/dist/core/message/im-renderer.js +116 -85
- package/dist/core/message/message-bridge.js +4 -0
- package/dist/core/message/message-queue.js +66 -15
- package/dist/core/message/message-utils.js +10 -2
- package/dist/core/message/peer-mode.js +7 -34
- package/dist/core/message/pending-hints.js +29 -5
- package/dist/core/message/response-engine.js +194 -61
- package/dist/core/message/send-options.js +7 -4
- package/dist/core/message/send-routing.js +50 -5
- package/dist/core/ownership/owner-resolver.js +7 -0
- package/dist/core/pack-auth.js +94 -0
- package/dist/core/pack-install.js +194 -0
- package/dist/core/permission/ec-command-parser.js +51 -17
- package/dist/core/permission/protected-paths.js +12 -2
- package/dist/core/permission/shell-environment.js +9 -0
- package/dist/core/rate-window.js +48 -0
- package/dist/core/relation/peer-identity.js +28 -0
- package/dist/core/session/session-file-health.js +243 -0
- package/dist/core/session/session-fs-store.js +67 -28
- package/dist/core/session/session-idle-monitor.js +59 -19
- package/dist/core/session/session-manager.js +13 -4
- package/dist/core/task/task-recovery-service.js +13 -2
- package/dist/core/thread/command-parser.js +9 -2
- package/dist/core/thread/thread-operation.js +21 -2
- package/dist/core/thread/thread-route.js +13 -2
- package/dist/core/thread/thread-service.js +52 -3
- package/dist/directory/owner-directory-admission.js +40 -53
- package/dist/directory/owner-directory-cache.js +89 -113
- package/dist/directory/owner-directory-query-operation.js +8 -10
- package/dist/eck/kit-renderer.js +7 -5
- package/dist/eck/message-renderer.js +2 -0
- package/dist/ecweb/basic-settings-service.js +1 -1
- package/dist/ecweb/message-context-service.js +0 -4
- package/dist/ecweb/runtime/lifecycle.js +6 -2
- package/dist/ecweb/runtime/supervisor.js +19 -4
- package/dist/event-center/admission-materializer.js +124 -0
- package/dist/event-center/bus-gate.js +154 -0
- package/dist/event-center/bus-host.js +307 -0
- package/dist/event-center/bus-resolver.js +120 -0
- package/dist/event-center/center-config.js +127 -0
- package/dist/event-center/daemon.js +44 -0
- package/dist/event-center/directory-source.js +55 -0
- package/dist/event-center/dispatcher.js +157 -0
- package/dist/event-center/event-log.js +110 -0
- package/dist/event-center/index-generator.js +73 -0
- package/dist/event-center/ipc-operation.js +423 -0
- package/dist/event-center/ledger.js +52 -0
- package/dist/event-center/pack-loader.js +207 -0
- package/dist/event-center/pack-manager.js +85 -0
- package/dist/event-center/registry.js +463 -0
- package/dist/event-center/runtime.js +837 -0
- package/dist/event-center/script-runner.js +356 -0
- package/dist/event-center/types.js +51 -0
- package/dist/event-center/validation.js +435 -0
- package/dist/index.js +424 -135
- package/dist/ipc.js +106 -12
- package/dist/paths.js +20 -0
- package/dist/product.js +14 -0
- package/dist/proxy/manager.js +5 -1
- package/dist/proxy/service-supervisor.js +13 -4
- package/dist/response-system/engines/v1/index.js +0 -1
- package/dist/response-system/engines/v1/proactive-flow.js +4 -2
- package/dist/response-system/modes/single-session/index.js +1 -1
- package/dist/services/dispatcher.js +100 -0
- package/dist/services/idempotency.js +90 -0
- package/dist/services/identity.js +52 -0
- package/dist/services/index-generator.js +70 -0
- package/dist/services/index.js +449 -0
- package/dist/services/ipc-operation.js +550 -0
- package/dist/services/ledger.js +52 -0
- package/dist/services/message-log.js +112 -0
- package/dist/services/pack-manager.js +215 -0
- package/dist/services/reply.js +55 -0
- package/dist/services/router.js +98 -0
- package/dist/services/script-runner.js +422 -0
- package/dist/services/service-payload.js +70 -0
- package/dist/services/types.js +18 -0
- package/dist/services/validation.js +297 -0
- package/dist/trigger/application-service.js +18 -0
- package/dist/trigger/event-source.js +1 -1
- package/dist/trigger/ipc-service.js +3 -1
- package/dist/trigger/scheduler.js +38 -0
- package/dist/trigger/script-sandbox.js +170 -24
- package/dist/utils/cross-platform.js +24 -10
- package/dist/utils/evolcore-version.js +69 -27
- package/dist/utils/instance-registry.js +19 -13
- package/dist/utils/npm-ops.js +2 -1
- package/dist/utils/package-version-info.js +6 -3
- package/dist/utils/process-introspect.js +45 -9
- package/dist/utils/startup-trace.js +74 -37
- package/dist/utils/windows-shell-trust.js +80 -6
- package/kits/docs/INDEX.md +2 -2
- package/kits/docs/aun/ABILITY_CALLING.md +9 -15
- package/kits/docs/context-assembly.md +1 -1
- package/kits/docs/evolcore/INDEX.md +3 -1
- package/kits/docs/evolcore/ability.md +4 -0
- package/kits/docs/evolcore/agent.md +22 -1
- package/kits/docs/evolcore/aid.md +1 -1
- package/kits/docs/evolcore/event-center.md +227 -0
- package/kits/docs/evolcore/file-navigation.md +10 -264
- package/kits/docs/evolcore/fs.md +5 -3
- package/kits/docs/evolcore/group.md +1 -1
- package/kits/docs/evolcore/memory-architecture.md +2 -0
- package/kits/docs/evolcore/menu-protocol.md +28 -1
- package/kits/docs/evolcore/msg.md +21 -9
- package/kits/docs/evolcore/provider.md +3 -1
- package/kits/docs/evolcore/response.md +5 -5
- package/kits/docs/evolcore/services.md +294 -0
- package/kits/docs/evolcore/task.md +2 -0
- package/kits/docs/evolcore/team-workspace.md +41 -0
- package/kits/docs/evolcore/thread-chain.md +15 -3
- package/kits/eck_manifest.json +26 -0
- package/kits/rules/02-navigation.md +10 -1
- package/kits/rules/06-channel.md +1 -0
- package/kits/schemas/_meta.json +17 -6
- package/kits/schemas/agent-config.schema.19.json +5 -7
- package/kits/schemas/agent-config.schema.20.json +936 -0
- package/kits/schemas/relation-config.schema.12.json +2 -3
- package/kits/schemas/role-config.schema.2.json +4 -4
- package/kits/skills/.switches.json +1 -5
- package/kits/skills/ability/SKILL.md +56 -0
- package/kits/skills/ability/references/calling.md +56 -0
- package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
- package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
- package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
- package/kits/skills/ec-agent-create/SKILL.md +0 -1
- package/kits/skills/ec-group/SKILL.md +5 -8
- package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
- package/kits/skills/ec-service-proxy/SKILL.md +34 -5
- package/kits/skills/ec-trigger/SKILL.md +4 -4
- package/kits/skills/personal-assistant/SKILL.md +6 -6
- package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
- package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
- package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
- package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
- package/kits/skills/thread-ops/SKILL.md +10 -10
- package/kits/templates/message-fragments/item.md +1 -1
- package/kits/templates/system-fragments/channel.md +3 -3
- package/kits/templates/system-fragments/commands.md +5 -3
- package/kits/templates/system-fragments/reply.md +1 -5
- package/kits/templates/system-fragments/thread.md +13 -10
- package/package.json +5 -6
- package/scripts/agent-template/index.mjs +40 -0
- package/scripts/agent-template/inspect.mjs +240 -0
- package/scripts/agent-template/overlay.mjs +71 -0
- package/scripts/agent-template/pack.mjs +169 -0
- package/scripts/agent-template/shared/common.mjs +235 -0
- package/scripts/agent-template/shared/evolcore.mjs +75 -0
- package/scripts/agent-template/shared/plan.mjs +129 -0
- package/scripts/agent-template/shared/team-schema.json +70 -0
- package/scripts/agent-template/shared/template-contract.mjs +154 -0
- package/scripts/agent-template/shared/template-package.mjs +265 -0
- package/scripts/agent-template/shared/template-runtime.mjs +80 -0
- package/scripts/agent-template/shared/template.mjs +142 -0
- package/dist/cli/pa-workspace-command.js +0 -225
- package/dist/core/command/pa-workspace-store.js +0 -468
- package/dist/core/relation/pa-team.js +0 -132
- package/kits/docs/evolcore/pa-workspace.md +0 -51
- package/kits/skills/aid-ability/SKILL.md +0 -244
- package/kits/skills/ec-ability/SKILL.md +0 -67
- 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
|
+
}
|