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,550 @@
1
+ /**
2
+ * `ec services` 的 daemon 侧 IPC 操作(services.op)。
3
+ * daemon-control 风格(不走 delegation argv 哈希);CLI 透传 argv,daemon 解析执行。
4
+ *
5
+ * 只做本机运维:status / list / types / ledger / tail / doctor / reload / enable / disable。
6
+ * 对端调用(describe / schema / call)在 CLI 侧直接走 `ec msg send`,不经过这里。
7
+ */
8
+ import fs from 'node:fs';
9
+ import path from 'node:path';
10
+ import { logger } from '../utils/logger.js';
11
+ import { agentServicesDir, resolveRoot } from '../paths.js';
12
+ import { classifyProtectedPath } from '../core/permission/protected-paths.js';
13
+ import { ServiceLedger } from './ledger.js';
14
+ import { ServiceMessageLog } from './message-log.js';
15
+ import { SERVICES_CONFIG_JSON, loadRouterConfig } from './router.js';
16
+ import { PACK_JSON } from './pack-manager.js';
17
+ import { readLocalSelfIdentity } from './identity.js';
18
+ import { createOfflineServiceRouter, listServiceRouterAids, peekServiceRouter, } from './index.js';
19
+ import { isReservedServiceType, RESERVED_TYPES } from './service-payload.js';
20
+ import { getAunRequestRegistry } from '../core/message/aun-request-registry.js';
21
+ import { ServiceError, errorMessage } from './types.js';
22
+ import { authorizePackTarget, isManagingServicesCommand } from '../core/pack-auth.js';
23
+ import { installPack, listPackDirs, removePack } from '../core/pack-install.js';
24
+ const HELP = `ec services — 服务路由运维
25
+
26
+ 用法:
27
+ ec services status [<包名>] [--aid <aid>] [--format json] 每包状态
28
+ ec services types [--aid <aid>] 本 AID 可接的全部 services.* type
29
+ ec services ledger <包名> [--tail N] [--aid <aid>] 台账
30
+ ec services tail <包名> [--tail N] [--aid <aid>] 服务消息日志
31
+ ec services doctor [<包名>] [--aid <aid>] 诊断
32
+ ec services reload [<包名>] [--aid <aid>] 重载
33
+ ec services enable / disable [--aid <aid>] 总闸
34
+
35
+ 安装与卸载(L 类目录只能由 daemon 代写):
36
+ ec services pack add <包名> --from <源目录> [--aid <aid>]
37
+ ec services pack remove <包名> [--aid <aid>] [--purge]
38
+
39
+ add 遇到已安装的包直接报错,先 remove 再装。
40
+ remove 默认把日志与台账归档到 <包>/logs/archive-<时间戳>/;--purge 连归档一起删。
41
+ ec services pack list [--aid <aid>]
42
+
43
+ 对端:
44
+ ec services describe <aid>
45
+ ec services schema <aid> <type>
46
+ ec services call <aid> <type> --data '<json>' [--timeout 30] [--encrypted] [--no-wait]`;
47
+ export function parseServicesArgv(argv) {
48
+ const args = [...argv];
49
+ if (args.length === 0 || args[0] === 'help' || args[0] === '--help')
50
+ return { command: 'help' };
51
+ const command = args.shift();
52
+ const parsed = { command };
53
+ const consumeValue = (flag) => {
54
+ const index = args.indexOf(flag);
55
+ if (index < 0)
56
+ return undefined;
57
+ const value = args[index + 1];
58
+ if (value === undefined)
59
+ return undefined;
60
+ args.splice(index, 2);
61
+ return value;
62
+ };
63
+ parsed.aid = consumeValue('--aid');
64
+ const tailRaw = consumeValue('--tail');
65
+ if (tailRaw !== undefined) {
66
+ const tail = Number(tailRaw);
67
+ if (!Number.isInteger(tail) || tail < 1 || tail > 10_000)
68
+ return { error: '--tail must be a positive integer' };
69
+ parsed.tail = tail;
70
+ }
71
+ const timeoutRaw = consumeValue('--timeout');
72
+ if (timeoutRaw !== undefined) {
73
+ const timeoutMs = parseTimeoutMs(timeoutRaw);
74
+ if (timeoutMs === undefined)
75
+ return { error: `--timeout must be a positive duration (seconds or 30s/2m): ${timeoutRaw}` };
76
+ parsed.timeoutMs = timeoutMs;
77
+ }
78
+ const dataRaw = consumeValue('--data');
79
+ if (dataRaw !== undefined) {
80
+ try {
81
+ const parsedData = JSON.parse(dataRaw);
82
+ if (!parsedData || typeof parsedData !== 'object' || Array.isArray(parsedData)) {
83
+ return { error: '--data must be a JSON object' };
84
+ }
85
+ parsed.data = parsedData;
86
+ }
87
+ catch (error) {
88
+ return { error: `--data is not valid JSON: ${error instanceof Error ? error.message : String(error)}` };
89
+ }
90
+ }
91
+ const requestId = consumeValue('--request-id');
92
+ if (requestId !== undefined)
93
+ parsed.requestId = requestId;
94
+ // `--service <type|包名>` 等价于 describe/schema 的第二个位置参数。
95
+ const serviceFlag = consumeValue('--service');
96
+ if (serviceFlag !== undefined)
97
+ parsed.type = serviceFlag;
98
+ if (args.includes('--encrypted')) {
99
+ parsed.encrypted = true;
100
+ args.splice(args.indexOf('--encrypted'), 1);
101
+ }
102
+ if (args.includes('--no-wait')) {
103
+ parsed.noWait = true;
104
+ args.splice(args.indexOf('--no-wait'), 1);
105
+ }
106
+ parsed.from = consumeValue('--from');
107
+ if (args.includes('--purge')) {
108
+ parsed.purge = true;
109
+ args.splice(args.indexOf('--purge'), 1);
110
+ }
111
+ if (args.includes('--force')) {
112
+ // 覆盖安装已取消:重装前必须先 `pack remove`。识别出来是为了给明确提示。
113
+ return { error: '--force is no longer supported; run "pack remove <包名>" before reinstalling' };
114
+ }
115
+ const positional = args.filter(item => !item.startsWith('-'));
116
+ if (command === 'pack') {
117
+ parsed.action = positional[0];
118
+ parsed.pack = positional[1];
119
+ }
120
+ else {
121
+ parsed.pack = positional[0];
122
+ }
123
+ // `--service` 已给出时不被位置参数覆盖。
124
+ if (parsed.type === undefined)
125
+ parsed.type = positional[1];
126
+ return parsed;
127
+ }
128
+ /** `--timeout 30` / `30s` / `2m` / `500ms` → 毫秒。 */
129
+ function parseTimeoutMs(value) {
130
+ const trimmed = value.trim().toLowerCase();
131
+ const plain = Number(trimmed);
132
+ if (Number.isFinite(plain) && plain > 0)
133
+ return Math.round(plain * 1000);
134
+ const match = /^(\d+(?:\.\d+)?)(ms|s|m)$/.exec(trimmed);
135
+ if (!match)
136
+ return undefined;
137
+ const amount = Number(match[1]);
138
+ if (!Number.isFinite(amount) || amount <= 0)
139
+ return undefined;
140
+ const unit = match[2];
141
+ return Math.round(unit === 'ms' ? amount : unit === 'm' ? amount * 60_000 : amount * 1000);
142
+ }
143
+ function resolveAid(deps, parsed) {
144
+ if (parsed.aid) {
145
+ const live = peekServiceRouter(parsed.aid);
146
+ return { aid: parsed.aid, router: live ?? deps.create(parsed.aid) };
147
+ }
148
+ const aids = deps.listAids?.() ?? [];
149
+ if (aids.length === 1) {
150
+ const live = peekServiceRouter(aids[0]);
151
+ return { aid: aids[0], router: live ?? deps.create(aids[0]) };
152
+ }
153
+ const fallback = deps.defaultAid?.();
154
+ if (fallback) {
155
+ const live = peekServiceRouter(fallback);
156
+ return { aid: fallback, router: live ?? deps.create(fallback) };
157
+ }
158
+ if (aids.length === 0) {
159
+ return { error: { ok: false, code: 'NO_AGENT', error: 'no agent is running services routing; pass --aid <aid>' } };
160
+ }
161
+ return { error: { ok: false, code: 'AGENT_REQUIRED', error: `multiple agents: ${aids.join(', ')}; pass --aid <aid>` } };
162
+ }
163
+ /** 根级 deps:daemon 侧默认用活跃 router 表;CLI 直连时用 offline 实例。 */
164
+ export function createServicesOperationExecutor(deps) {
165
+ const withCreate = {
166
+ listAids: () => deps.listAids?.() ?? listServiceRouterAids(),
167
+ defaultAid: deps.defaultAid,
168
+ daemonAid: deps.daemonAid,
169
+ getChannel: deps.getChannel,
170
+ create: deps.create ?? ((aid) => createOfflineServiceRouter(aid, agentServicesDir(aid), {
171
+ aid,
172
+ identity: () => readLocalSelfIdentity(aid) ?? { aid, type: 'agent', exttype: '' },
173
+ getProjectPath: () => undefined,
174
+ })),
175
+ };
176
+ return async (request) => {
177
+ let parsed;
178
+ try {
179
+ parsed = parseServicesArgv(request.argv ?? []);
180
+ }
181
+ catch (error) {
182
+ return { ok: false, code: 'INVALID_ARGV', error: errorMessage(error) };
183
+ }
184
+ if ('error' in parsed)
185
+ return { ok: false, code: 'INVALID_ARGV', error: parsed.error };
186
+ // 调用方身份随请求传入,不参与 argv 解析(argv 来自 agent,可伪造)。
187
+ parsed.caller = request.caller;
188
+ try {
189
+ return await execute(withCreate, parsed);
190
+ }
191
+ catch (error) {
192
+ if (error instanceof ServiceError)
193
+ return { ok: false, code: error.code, error: error.message };
194
+ const message = errorMessage(error);
195
+ const code = /\b([A-Z][A-Z0-9_]{3,})\b/.exec(message)?.[1] ?? 'INTERNAL_ERROR';
196
+ logger.warn(`[Services] services.op failed: ${code}: ${message}`);
197
+ return { ok: false, code, error: message };
198
+ }
199
+ };
200
+ }
201
+ async function execute(deps, parsed) {
202
+ const { command } = parsed;
203
+ if (command === 'help')
204
+ return { ok: true, result: { help: HELP } };
205
+ const target = resolveAid(deps, parsed);
206
+ if (target.error)
207
+ return target.error;
208
+ const aid = target.aid;
209
+ const router = target.router;
210
+ // 授权:只读与 call 不限;enable/disable/pack 需要本机 owner|admin,
211
+ // 跨 AID 需三重 owner(见 core/pack-auth.ts)。
212
+ const auth = authorizePackTarget({
213
+ caller: parsed.caller ?? { kind: 'local-control' },
214
+ targetAid: aid,
215
+ ...(deps.daemonAid?.() ? { daemonAid: deps.daemonAid() } : {}),
216
+ requiresManagement: isManagingServicesCommand(command),
217
+ });
218
+ if (!auth.allowed)
219
+ return { ok: false, code: auth.code, error: auth.error };
220
+ const snapshot = router.snapshot();
221
+ const servicesDir = agentServicesDir(aid);
222
+ switch (command) {
223
+ case 'call':
224
+ case 'describe':
225
+ case 'schema':
226
+ return await runCall(deps, aid, parsed);
227
+ case 'status': {
228
+ if (parsed.pack) {
229
+ const found = statusForPack(snapshot, parsed.pack);
230
+ if (!found)
231
+ return { ok: false, code: 'PACK_NOT_FOUND', error: `pack not found or invalid: ${parsed.pack}` };
232
+ return { ok: true, result: { aid, pack: found } };
233
+ }
234
+ return {
235
+ ok: true,
236
+ result: {
237
+ aid,
238
+ enabled: snapshot.enabled,
239
+ identity: snapshot.identity,
240
+ routerErrors: snapshot.routerErrors,
241
+ packs: snapshot.packs.activePacks.map(pack => statusForPack(snapshot, pack.id)),
242
+ skipped: snapshot.packs.skippedPacks,
243
+ disabled: snapshot.packs.disabledPacks,
244
+ invalid: snapshot.packs.invalidPacks,
245
+ conflicts: snapshot.packs.conflicts,
246
+ },
247
+ };
248
+ }
249
+ case 'types': {
250
+ const types = new Set();
251
+ for (const pack of snapshot.packs.activePacks) {
252
+ for (const entry of pack.listen)
253
+ types.add(entry.type);
254
+ }
255
+ for (const reserved of RESERVED_TYPES)
256
+ types.add(reserved);
257
+ return { ok: true, result: { aid, enabled: snapshot.enabled, types: [...types].sort() } };
258
+ }
259
+ case 'ledger': {
260
+ if (!parsed.pack)
261
+ return { ok: false, code: 'INVALID_ARGV', error: 'ledger requires <pack>' };
262
+ const ledgerPath = path.join(servicesDir, parsed.pack, 'ledger.jsonl');
263
+ return { ok: true, result: { aid, pack: parsed.pack, lines: new ServiceLedger(ledgerPath).tail(parsed.tail ?? 20) } };
264
+ }
265
+ case 'tail': {
266
+ if (!parsed.pack)
267
+ return { ok: false, code: 'INVALID_ARGV', error: 'tail requires <pack>' };
268
+ const logsDir = path.join(servicesDir, parsed.pack, 'logs');
269
+ return { ok: true, result: { aid, pack: parsed.pack, lines: new ServiceMessageLog(logsDir).tail(parsed.tail ?? 20) } };
270
+ }
271
+ case 'doctor':
272
+ return { ok: true, result: { aid, findings: doctor(aid, router, parsed.pack) } };
273
+ case 'reload': {
274
+ const live = peekServiceRouter(aid);
275
+ if (live)
276
+ live.reload();
277
+ else
278
+ router.reload();
279
+ return { ok: true, result: { aid, reloaded: parsed.pack ?? '*', enabled: router.enabled } };
280
+ }
281
+ case 'enable':
282
+ case 'disable':
283
+ return setRouterEnabled(aid, command === 'enable');
284
+ case 'pack': {
285
+ const servicesDirForPack = agentServicesDir(aid);
286
+ if (parsed.action === 'list') {
287
+ return { ok: true, result: { aid, servicesDir: servicesDirForPack, packs: listPackDirs(servicesDirForPack, PACK_JSON) } };
288
+ }
289
+ if (!parsed.pack)
290
+ return { ok: false, code: 'INVALID_ARGV', error: `pack ${parsed.action ?? ''} requires <包名>` };
291
+ if (parsed.action === 'add') {
292
+ if (!parsed.from)
293
+ return { ok: false, code: 'INVALID_ARGV', error: 'pack add requires --from <源目录>' };
294
+ const installed = installPack({
295
+ sourceDir: parsed.from,
296
+ targetRoot: servicesDirForPack,
297
+ name: parsed.pack,
298
+ manifestFile: PACK_JSON,
299
+ legacyManifestFile: 'service.json',
300
+ });
301
+ // 装包后若还没有 services-config.json,顺手建一份 enabled=true 的总闸:
302
+ // 没有它所有 services.* 请求都被静默丢弃,包"active"却调不通。
303
+ const routerPath = path.join(servicesDirForPack, SERVICES_CONFIG_JSON);
304
+ let createdRouter = false;
305
+ if (!fs.existsSync(routerPath)) {
306
+ fs.mkdirSync(servicesDirForPack, { recursive: true });
307
+ fs.writeFileSync(routerPath, `${JSON.stringify({
308
+ v: 1,
309
+ enabled: true,
310
+ rateLimit: {
311
+ builtin: { perMinute: 20, perHour: 200 },
312
+ service: { perMinute: 50, perHour: 1000 },
313
+ },
314
+ }, null, 2)}
315
+ `, 'utf8');
316
+ createdRouter = true;
317
+ }
318
+ const live = peekServiceRouter(aid);
319
+ if (live)
320
+ live.reload();
321
+ else
322
+ router.reload();
323
+ return { ok: true, result: { aid, ...installed, ...(createdRouter ? { createdRouter: true } : {}) } };
324
+ }
325
+ if (parsed.action === 'remove') {
326
+ const removed = removePack({ pack: parsed.pack, targetRoot: servicesDirForPack, purge: parsed.purge === true });
327
+ const live = peekServiceRouter(aid);
328
+ if (live)
329
+ live.reload();
330
+ else
331
+ router.reload();
332
+ return { ok: true, result: { aid, ...removed } };
333
+ }
334
+ return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown pack action: ${parsed.action ?? '(none)'}
335
+ ${HELP}` };
336
+ }
337
+ default:
338
+ return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown services command: ${command}\n${HELP}` };
339
+ }
340
+ }
341
+ /**
342
+ * 对端调用(call / describe / schema)。
343
+ *
344
+ * 回程不靠 CLI 订阅消息:请求登记进 `AunRequestRegistry`,应答由 AUN 入站的
345
+ * services.*.result 分支交给 `resolveIncoming` 落盘,这里只等记录终态。
346
+ * 因此 CLI 中途被杀也不丢结果。
347
+ */
348
+ async function runCall(deps, selfAid, parsed) {
349
+ // 查询已发出的请求:ec services call <self-aid> --request-id <id>
350
+ if (parsed.requestId) {
351
+ const record = getAunRequestRegistry().get(selfAid, parsed.requestId);
352
+ if (!record)
353
+ return { ok: false, code: 'REQUEST_NOT_FOUND', error: `no request ${parsed.requestId}` };
354
+ return { ok: true, result: summarizeRecord(record) };
355
+ }
356
+ const targetAid = parsed.pack;
357
+ if (!targetAid)
358
+ return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires <aid>` };
359
+ const channel = deps.getChannel?.(selfAid);
360
+ if (!channel?.sendDaemonMsg) {
361
+ return { ok: false, code: 'NOT_CONFIGURED', error: `no AUN channel is connected for ${selfAid}` };
362
+ }
363
+ // 三个子命令对应三种内置查询:describe 无 type 时列清单,有 type 时问细节。
364
+ const requestType = parsed.command === 'call'
365
+ ? parsed.type
366
+ : parsed.command === 'schema'
367
+ ? 'services.schema'
368
+ : parsed.type
369
+ ? 'services.describe'
370
+ : 'services.list';
371
+ if (!requestType)
372
+ return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires <type>` };
373
+ const data = parsed.command === 'call'
374
+ ? { ...(parsed.data ?? {}) }
375
+ : parsed.type
376
+ ? { service: parsed.type }
377
+ : {};
378
+ const timeoutMs = parsed.timeoutMs ?? 30_000;
379
+ const registry = getAunRequestRegistry();
380
+ let prepared;
381
+ try {
382
+ prepared = registry.prepare({
383
+ selfAid,
384
+ targetAid,
385
+ payload: { type: requestType, ...data },
386
+ timeoutMs,
387
+ });
388
+ }
389
+ catch (error) {
390
+ return { ok: false, code: error.code ?? 'REQUEST_REGISTRATION_FAILED', error: errorMessage(error) };
391
+ }
392
+ registry.markSending(selfAid, prepared.requestId);
393
+ const sent = await channel.sendDaemonMsg({
394
+ to: targetAid,
395
+ payload: prepared.payload,
396
+ ...(parsed.encrypted !== undefined ? { encrypt: parsed.encrypted } : {}),
397
+ service: { type: requestType, requestId: prepared.requestId },
398
+ });
399
+ if (!sent.ok) {
400
+ registry.markFailed(selfAid, prepared.requestId, sent.error ?? 'send failed');
401
+ return {
402
+ ok: false,
403
+ code: sent.code === undefined ? 'SEND_FAILED' : String(sent.code),
404
+ error: sent.error ?? 'service call send failed',
405
+ result: { request_id: prepared.requestId },
406
+ };
407
+ }
408
+ if (sent.message_id)
409
+ registry.markTransportAccepted(selfAid, prepared.requestId, sent.message_id, sent.status);
410
+ if (parsed.noWait) {
411
+ return { ok: true, result: { request_id: prepared.requestId, message_id: sent.message_id, state: 'pending' } };
412
+ }
413
+ const record = await registry.wait(selfAid, prepared.requestId, timeoutMs);
414
+ if (!record) {
415
+ return { ok: false, code: 'NO_RESULT', error: 'request record disappeared', result: { request_id: prepared.requestId } };
416
+ }
417
+ const summary = summarizeRecord(record);
418
+ if (record.state === 'completed' && record.responsePayload) {
419
+ return { ok: true, result: { ...summary, response: record.responsePayload } };
420
+ }
421
+ if (record.state === 'failed') {
422
+ return { ok: false, code: 'REQUEST_FAILED', error: `request ${prepared.requestId} failed`, result: summary };
423
+ }
424
+ return {
425
+ ok: false,
426
+ code: 'NO_RESULT',
427
+ error: `no result before timeout; request_id=${prepared.requestId} (the service may have executed)`,
428
+ result: summary,
429
+ };
430
+ }
431
+ function summarizeRecord(record) {
432
+ return {
433
+ request_id: record.requestId,
434
+ state: record.state,
435
+ message_id: record.outboundMessageId,
436
+ target: record.targetAid,
437
+ ...(record.responseMessageId ? { response_message_id: record.responseMessageId } : {}),
438
+ };
439
+ }
440
+ function statusForPack(snapshot, packId) {
441
+ const pack = snapshot.packs.activePacks.find(candidate => candidate.id === packId);
442
+ if (pack) {
443
+ return {
444
+ id: pack.id,
445
+ name: pack.name,
446
+ status: 'active',
447
+ listens: pack.listen.map(entry => entry.type),
448
+ unmatched: pack.unmatched,
449
+ replyAllowed: pack.reply.allowed,
450
+ revision: pack.revision,
451
+ };
452
+ }
453
+ const skipped = snapshot.packs.skippedPacks.find(item => item.id === packId);
454
+ if (skipped)
455
+ return { id: skipped.id, status: 'skipped', reason: skipped.reason };
456
+ if (snapshot.packs.disabledPacks.includes(packId))
457
+ return { id: packId, status: 'disabled' };
458
+ const invalid = snapshot.packs.invalidPacks.find(item => item.id === packId);
459
+ if (invalid)
460
+ return { id: invalid.id, status: 'invalid', errors: invalid.errors };
461
+ return undefined;
462
+ }
463
+ /** 七项诊断(design.md §十六)。 */
464
+ function doctor(aid, router, only) {
465
+ const findings = [];
466
+ const snapshot = router.snapshot();
467
+ if (!snapshot.packs.activePacks.length && !snapshot.packs.skippedPacks.length && !snapshot.packs.invalidPacks.length) {
468
+ findings.push({ level: 'warn', check: 'packs', detail: 'no service packs found under services/' });
469
+ }
470
+ if (!snapshot.enabled) {
471
+ findings.push({ level: 'warn', check: SERVICES_CONFIG_JSON, detail: 'services/services-config.json enabled=false; all services.* messages are dropped' });
472
+ }
473
+ for (const error of snapshot.routerErrors) {
474
+ findings.push({ level: 'error', check: SERVICES_CONFIG_JSON, detail: error });
475
+ }
476
+ const packs = only
477
+ ? snapshot.packs.activePacks.filter(pack => pack.id === only)
478
+ : snapshot.packs.activePacks;
479
+ for (const pack of packs) {
480
+ // 1. requires 与名片不符(对被过滤掉的包在 skipped 里单独报)。
481
+ findings.push({ level: 'ok', check: `${pack.id}.requires`, detail: `satisfied by ${snapshot.identity.type}/${snapshot.identity.exttype || '-'}` });
482
+ // 2. 保留字遮蔽:listen.type 命中 services.<保留字> 的两段形式。
483
+ for (const entry of pack.listen) {
484
+ if (isReservedServiceType(entry.type)) {
485
+ findings.push({
486
+ level: 'warn',
487
+ check: `${pack.id}.listen`,
488
+ detail: `${entry.type} is a reserved builtin type and will never reach this pack`,
489
+ });
490
+ }
491
+ }
492
+ // 5. type=services 但无激活包。
493
+ if (snapshot.identity.type === 'services' && snapshot.packs.activePacks.length === 0) {
494
+ findings.push({ level: 'warn', check: 'identity', detail: 'agent.md type=services but no active service pack' });
495
+ }
496
+ }
497
+ for (const item of snapshot.packs.skippedPacks) {
498
+ if (only && item.id !== only)
499
+ continue;
500
+ findings.push({ level: 'warn', check: `${item.id}.requires`, detail: `pack skipped: ${item.reason}` });
501
+ }
502
+ for (const item of snapshot.packs.invalidPacks) {
503
+ if (only && item.id !== only)
504
+ continue;
505
+ findings.push({ level: 'error', check: `${item.id}.pack.json`, detail: item.errors.join('; ') });
506
+ }
507
+ for (const conflict of snapshot.packs.conflicts) {
508
+ findings.push({ level: 'error', check: 'listen.type', detail: `${conflict.type} declared by ${conflict.packs.join(', ')}` });
509
+ }
510
+ // 6. services/ 未进 L_CLASS(由 protected-paths 的运行时常量核对)。
511
+ findings.push(lClassFinding());
512
+ return findings;
513
+ }
514
+ /** 运行期核对 L_CLASS 是否覆盖每个 agent 的 services 目录。 */
515
+ function lClassFinding() {
516
+ try {
517
+ const probe = path.join(resolveRoot(), 'agents', 'probe-aid', 'services', 'x');
518
+ const cls = classifyProtectedPath(probe);
519
+ return cls === 'l-path'
520
+ ? { level: 'ok', check: 'l-class', detail: 'agents/*/services is protected' }
521
+ : { level: 'error', check: 'l-class', detail: `agents/*/services is NOT protected (got ${String(cls)}); arbitrary code execution risk` };
522
+ }
523
+ catch (error) {
524
+ return { level: 'warn', check: 'l-class', detail: `cannot verify: ${errorMessage(error)}` };
525
+ }
526
+ }
527
+ /** enable / disable 只改 services-config.json 的 enabled 字段;v 与其他字段原样保留。 */
528
+ function setRouterEnabled(aid, enabled) {
529
+ const servicesDir = agentServicesDir(aid);
530
+ const filePath = path.join(servicesDir, SERVICES_CONFIG_JSON);
531
+ const loaded = loadRouterConfig(servicesDir);
532
+ const base = loaded.exists
533
+ ? JSON.parse(fs.readFileSync(filePath, 'utf8'))
534
+ : { v: 1, rateLimit: { builtin: { perMinute: 20, perHour: 200 }, service: { perMinute: 50, perHour: 1000 } } };
535
+ if (base.v !== 1)
536
+ base.v = 1;
537
+ base.enabled = enabled;
538
+ try {
539
+ fs.mkdirSync(servicesDir, { recursive: true });
540
+ fs.writeFileSync(filePath, `${JSON.stringify(base, null, 2)}\n`, 'utf8');
541
+ }
542
+ catch (error) {
543
+ return { ok: false, code: 'ROUTER_WRITE_FAILED', error: errorMessage(error) };
544
+ }
545
+ const live = peekServiceRouter(aid);
546
+ if (live)
547
+ live.reload();
548
+ return { ok: true, result: { aid, enabled, path: filePath } };
549
+ }
550
+ export { HELP as SERVICES_HELP };
@@ -0,0 +1,52 @@
1
+ /**
2
+ * 服务包台账(ledger.jsonl):append-only,只记生命周期,不记消息正文。
3
+ * 与 src/event-center/ledger.ts 同构。
4
+ */
5
+ import fs from 'node:fs';
6
+ import path from 'node:path';
7
+ export class ServiceLedger {
8
+ filePath;
9
+ constructor(filePath) {
10
+ this.filePath = filePath;
11
+ }
12
+ /** 追加一行;IO 失败吞掉(台账不应中断运行时)。 */
13
+ append(line) {
14
+ const { ts, action, ...rest } = line;
15
+ const full = { ts: ts ?? Date.now(), action, ...rest };
16
+ try {
17
+ fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
18
+ fs.appendFileSync(this.filePath, `${JSON.stringify(full)}\n`, 'utf8');
19
+ }
20
+ catch {
21
+ // 台账写失败不致命:运行继续,`ec services ledger` 读不到时再排查磁盘。
22
+ }
23
+ }
24
+ /** 读最后 N 行(CLI tail 用)。 */
25
+ tail(count) {
26
+ let text;
27
+ try {
28
+ text = fs.readFileSync(this.filePath, 'utf8');
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ const lines = text.split('\n').filter(Boolean).slice(-count);
34
+ const out = [];
35
+ for (const line of lines) {
36
+ try {
37
+ out.push(JSON.parse(line));
38
+ }
39
+ catch {
40
+ // 跳过坏行
41
+ }
42
+ }
43
+ return out;
44
+ }
45
+ }
46
+ export function packLedger(pack) {
47
+ return new ServiceLedger(pack.paths.ledger);
48
+ }
49
+ /** services/ 根级动作(router.load)的台账。 */
50
+ export function routerLedger(servicesDir) {
51
+ return new ServiceLedger(path.join(servicesDir, '.router-ledger.jsonl'));
52
+ }