evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -1,20 +1,20 @@
1
1
  /**
2
- * 包内幂等(.idempotency.jsonl):按 (fromAid, request_id) 去重,窗口 24 小时。
2
+ * 包内幂等(.idempotency.jsonl):按 (fromAid, request_id) 去重,默认窗口 15 秒。
3
3
  *
4
4
  * 与 `claimInboundMessage` 是两层不同的东西:后者管传输层 `message_id` 重投,
5
5
  * 这里管对端用同一 `request_id` 重试。命中时回上次结果,脚本不再执行。
6
+ *
7
+ * 窗口是**调用窗口的余量**,不是独立策略:服务请求走 volatile TTL(默认 12 秒),
8
+ * 15 秒 = 12 秒等待期 + 3 秒;更长调用保留至执行截止后 3 秒。
6
9
  */
7
10
  import fs from 'node:fs';
8
11
  import path from 'node:path';
9
- export const IDEMPOTENCY_WINDOW_MS = 24 * 60 * 60 * 1000;
12
+ export const IDEMPOTENCY_WINDOW_MS = 15_000;
10
13
  function key(from, requestId) {
11
14
  return `${from}\u0000${requestId}`;
12
15
  }
13
- /** `YYYY-MM`(本地时区,与 `logs/messages-YYYYMMDD.jsonl` 的日期口径一致)。 */
14
- function monthKey(ts) {
15
- const date = new Date(ts);
16
- return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`;
17
- }
16
+ /** 文件行数超过这个值就重写一次,丢掉已过期记录。 */
17
+ const COMPACT_THRESHOLD_LINES = 500;
18
18
  export class IdempotencyStore {
19
19
  filePath;
20
20
  records = new Map();
@@ -29,12 +29,18 @@ export class IdempotencyStore {
29
29
  /** 同上,键 → 完成信号触发器。与 `inFlight` 同生命周期。 */
30
30
  releasers = new Map();
31
31
  loadedMtimeMs = -1;
32
+ /**
33
+ * 文件当前的行数(含已过期的行)。
34
+ *
35
+ * 压实判据必须是**文件行数**而不是 `records.size`:`ensureLoaded` 读完就先
36
+ * `evict`,内存表里只剩窗口内的那几条,拿它比阈值永远够不到,文件只增不减。
37
+ */
38
+ fileLines = 0;
32
39
  constructor(filePath) {
33
40
  this.filePath = filePath;
34
41
  }
35
42
  /** 按文件 mtime 懒加载;文件被外部改动时重读。 */
36
43
  ensureLoaded(now = Date.now()) {
37
- this.rotateIfMonthChanged(now);
38
44
  let mtimeMs = 0;
39
45
  try {
40
46
  mtimeMs = fs.statSync(this.filePath).mtimeMs;
@@ -44,14 +50,17 @@ export class IdempotencyStore {
44
50
  }
45
51
  if (mtimeMs === this.loadedMtimeMs) {
46
52
  this.evict(now);
53
+ this.compactIfNeeded(now);
47
54
  return;
48
55
  }
49
56
  this.records.clear();
57
+ let lines = 0;
50
58
  try {
51
59
  const text = fs.readFileSync(this.filePath, 'utf8');
52
60
  for (const line of text.split('\n')) {
53
61
  if (!line)
54
62
  continue;
63
+ lines++;
55
64
  try {
56
65
  const record = JSON.parse(line);
57
66
  if (typeof record.from === 'string' && typeof record.requestId === 'string'
@@ -68,98 +77,41 @@ export class IdempotencyStore {
68
77
  // 读失败按空表处理,下次调用再试。
69
78
  }
70
79
  this.loadedMtimeMs = mtimeMs;
80
+ this.fileLines = lines;
71
81
  this.evict(now);
82
+ this.compactIfNeeded(now);
72
83
  }
73
84
  evict(now) {
74
- const cutoff = now - IDEMPOTENCY_WINDOW_MS;
75
85
  for (const [entryKey, record] of this.records) {
76
- if (record.ts < cutoff)
86
+ if ((record.expiresAt ?? record.ts + IDEMPOTENCY_WINDOW_MS) < now)
77
87
  this.records.delete(entryKey);
78
88
  }
79
89
  }
80
90
  /**
81
- * 跨月就把当前文件滚进 `logs/idempotency-<YYYY-MM>.jsonl`。
91
+ * 压实:丢掉已过期的行后整体重写。
82
92
  *
83
- * 为什么按自然月而不是按大小:去重窗口只有 24 小时,上个月的记录在本月启动时
84
- * 已经完全没用,留着只是让文件无限长。按月切既保住了"能翻回去查"的审计价值,
85
- * 又给文件大小设了自然上界。归档目标与 `removePack` 的日志归档同在 `logs/` 下。
93
+ * 窗口只有 15 秒,所以这里不再按月归档——一份文件里几乎不可能同时存在两个月的
94
+ * 记录。剩下的问题只是 append-only 会让文件一直变长,按行数触发即可。
86
95
  *
87
- * 懒触发(每次 `ensureLoaded` 顺手看一眼 mtime),不引定时器:进程可能长期空闲,
88
- * 定时器只会空转。
96
+ * 失败不影响去重:老文件继续用,下次再试。
89
97
  */
90
- rotateIfMonthChanged(now = Date.now()) {
91
- if (!fs.existsSync(this.filePath))
92
- return; // 没什么可滚的。
93
- // 判据是**最新一条记录的时间**,不是文件 mtime:mtime 表示"最后一次写入",
94
- // 一次补写或外部拷贝都会把它拉到别的月份,那时按它切会把还在窗口内的记录误归档。
95
- this.ensureLoadedFresh(now);
96
- if (this.records.size === 0)
98
+ compactIfNeeded(now) {
99
+ if (this.fileLines < COMPACT_THRESHOLD_LINES)
97
100
  return;
98
- const newest = Math.max(...[...this.records.values()].map(record => record.ts));
99
- if (monthKey(newest) === monthKey(now))
100
- return;
101
- const archiveDir = path.join(path.dirname(this.filePath), 'logs');
102
- const archivePath = path.join(archiveDir, `idempotency-${monthKey(newest)}.jsonl`);
103
- let carried = [];
101
+ this.evict(now);
104
102
  try {
105
- // 先把"仍在 24h 窗口内"的记录挑出来。跨月那一刻它们可能只有几分钟岁数,
106
- // 直接搬走会让这些请求重放时找不到缓存、再跑一遍脚本。
107
- this.ensureLoadedFresh(now);
108
- carried = [...this.records.values()].filter(record => record.ts >= now - IDEMPOTENCY_WINDOW_MS);
109
- fs.mkdirSync(archiveDir, { recursive: true });
110
- // 目标已存在(外部拷贝可能造成)就跟在后面追加,不覆盖——覆盖等于丢掉已归档的历史。
111
- if (fs.existsSync(archivePath)) {
112
- fs.appendFileSync(archivePath, fs.readFileSync(this.filePath, 'utf8'), 'utf8');
113
- fs.rmSync(this.filePath, { force: true });
114
- }
115
- else {
116
- fs.renameSync(this.filePath, archivePath);
117
- }
118
- // 仍有效的记录写回新文件:归档要归档,但去重语义不能因为跨月断掉。
103
+ const kept = [...this.records.values()];
104
+ const text = kept.map(record => `${JSON.stringify(record)}\n`).join('');
105
+ const temp = `${this.filePath}.tmp`;
119
106
  fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
120
- const text = carried.map(record => `${JSON.stringify(record)}\n`).join('');
121
- if (text)
122
- fs.writeFileSync(this.filePath, text, 'utf8');
123
- this.records.clear();
124
- for (const record of carried)
125
- this.records.set(key(record.from, record.requestId), record);
126
- this.loadedMtimeMs = text ? fs.statSync(this.filePath).mtimeMs : 0;
127
- }
128
- catch {
129
- // 滚动失败不影响去重:继续用当前文件,下次再试。
130
- }
131
- }
132
- /**
133
- * 直接重读文件、不触发滚动(滚动过程中要用,否则递归)。
134
- *
135
- * 只在跨月那一刻调用一次,不必在意"mtime 没变就跳过"的优化。
136
- */
137
- ensureLoadedFresh(now) {
138
- this.records.clear();
139
- try {
140
- for (const line of fs.readFileSync(this.filePath, 'utf8').split('\n')) {
141
- if (!line)
142
- continue;
143
- try {
144
- const record = JSON.parse(line);
145
- if (typeof record.from === 'string' && typeof record.requestId === 'string'
146
- && Number.isFinite(record.ts) && record.result && typeof record.result === 'object') {
147
- this.records.set(key(record.from, record.requestId), record);
148
- }
149
- }
150
- catch {
151
- // 跳过坏行
152
- }
153
- }
107
+ fs.writeFileSync(temp, text, 'utf8');
108
+ fs.renameSync(temp, this.filePath);
109
+ this.loadedMtimeMs = fs.statSync(this.filePath).mtimeMs;
110
+ this.fileLines = kept.length;
154
111
  }
155
112
  catch {
156
- // 读失败按空表处理。
113
+ // 压实失败不影响去重:继续用当前文件。
157
114
  }
158
- this.loadedMtimeMs = now;
159
- }
160
- /** 幂等文件的月度归档路径(CLI / 排查用)。 */
161
- static archivePathFor(filePath, month) {
162
- return path.join(path.dirname(filePath), 'logs', `idempotency-${month}.jsonl`);
163
115
  }
164
116
  /** 命中的上次结果;未命中返回 undefined。 */
165
117
  lookup(from, requestId, now = Date.now()) {
@@ -167,7 +119,7 @@ export class IdempotencyStore {
167
119
  const record = this.records.get(key(from, requestId));
168
120
  if (!record)
169
121
  return undefined;
170
- if (record.ts < now - IDEMPOTENCY_WINDOW_MS) {
122
+ if ((record.expiresAt ?? record.ts + IDEMPOTENCY_WINDOW_MS) < now) {
171
123
  this.records.delete(key(from, requestId));
172
124
  return undefined;
173
125
  }
@@ -202,17 +154,23 @@ export class IdempotencyStore {
202
154
  resolve?.();
203
155
  }
204
156
  /** 记录一次成功执行的结果。IO 失败吞掉:去重是优化,不是正确性前提。 */
205
- record(from, requestId, result, now = Date.now()) {
157
+ record(from, requestId, result, now = Date.now(), deadlineAt) {
206
158
  this.ensureLoaded(now);
207
- const record = { ts: now, from, requestId, result };
159
+ const expiresAt = Math.max(now + IDEMPOTENCY_WINDOW_MS, Math.min(deadlineAt ?? now, now + 300_000) + 3000);
160
+ const record = { ts: now, from, requestId, result, expiresAt };
208
161
  this.records.set(key(from, requestId), record);
209
162
  try {
210
163
  fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
211
164
  fs.appendFileSync(this.filePath, `${JSON.stringify(record)}\n`, 'utf8');
212
165
  this.loadedMtimeMs = fs.statSync(this.filePath).mtimeMs;
166
+ this.fileLines++;
213
167
  }
214
168
  catch {
215
169
  // 写失败不影响本次回复,只是下次重试会再执行一遍。
170
+ return;
216
171
  }
172
+ // 压实放在写入之后:`loadedMtimeMs` 刚刚对齐,下一次 `ensureLoaded` 会走
173
+ // "mtime 未变"的短路分支,不在这里判就永远轮不到。
174
+ this.compactIfNeeded(now);
217
175
  }
218
176
  }
@@ -9,6 +9,7 @@
9
9
  import fs from 'node:fs';
10
10
  import path from 'node:path';
11
11
  import { logger } from '../utils/logger.js';
12
+ import { DEFAULT_HANDLER_TIMEOUT_MS } from './validation.js';
12
13
  export const SERVICES_INDEX_FILE = '.index.md';
13
14
  /**
14
15
  * @param servicesDir `$AGENT_DIR/services`
@@ -34,7 +35,7 @@ export function writeServicesIndex(servicesDir, selfAid, activePacks) {
34
35
  lines.push('');
35
36
  lines.push('调用方式(对端视角):');
36
37
  lines.push(` ec services describe <本AID> 查看完整参数与示例`);
37
- lines.push(` ec services call <本AID> <type> --data '<json>'`);
38
+ lines.push(` ec services call --aid <本AID> --type <type> --data '<json>'`);
38
39
  lines.push('');
39
40
  // 分档写出:各档权限不同,混成一行会让模型以为 enable 和 status 一样随手可调,
40
41
  // 试一次被拒才发现(详见 $KITS_DOCS/evolcore/services.md §十)。
@@ -47,12 +48,12 @@ export function writeServicesIndex(servicesDir, selfAid, activePacks) {
47
48
  for (const pack of activePacks) {
48
49
  lines.push(`- ${pack.id}(${pack.name})`);
49
50
  for (const entry of pack.listen) {
50
- const timeoutMs = entry.handler.timeoutMs ?? 30_000;
51
+ const timeoutMs = entry.handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
51
52
  lines.push(` ${entry.type} ${entry.handler.script} timeout ${formatTimeout(timeoutMs)}`);
52
53
  }
53
54
  const first = pack.listen[0];
54
55
  if (first) {
55
- lines.push(` 示例: ec services call ${selfAid} ${exampleType(first.type)} --data '{}'`);
56
+ lines.push(` 示例: ec services call --aid ${selfAid} --type ${exampleType(first.type)} --data '{}'`);
56
57
  }
57
58
  }
58
59
  lines.push('');