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.
- package/CHANGELOG.md +97 -0
- package/bin/ecmsg.js +9 -4
- package/dist/ability/caller/authorization.js +21 -0
- package/dist/ability/caller/command.js +164 -0
- package/dist/ability/caller/contract.js +102 -0
- package/dist/ability/caller/daemon.js +158 -0
- package/dist/ability/caller/service.js +380 -0
- package/dist/ability/command-contract.js +5 -0
- package/dist/ability/daemon.js +5 -1
- package/dist/ability/interop-v1.js +10 -3
- package/dist/ability/management.js +1 -0
- package/dist/agent-template/jobs.js +173 -1
- package/dist/agent-template/runtime.js +285 -8
- package/dist/agent-template/service.js +1159 -40
- package/dist/agent-template/types.js +2 -1
- package/dist/agents/baseagent-availability.js +27 -3
- package/dist/agents/baseagent-capability-adapter.js +102 -0
- package/dist/agents/baseagent-plugin-descriptor.js +274 -0
- package/dist/agents/baseagent-plugin-loader.js +145 -0
- package/dist/agents/baseagent.js +68 -2
- package/dist/agents/claude-gateway/agent-registration.js +389 -0
- package/dist/agents/claude-gateway/binding.js +96 -0
- package/dist/agents/claude-gateway/inbox.js +138 -0
- package/dist/agents/claude-gateway/index.js +125 -0
- package/dist/agents/claude-gateway/listing.js +330 -0
- package/dist/agents/claude-gateway/router.js +328 -0
- package/dist/agents/claude-gateway/sessions.js +128 -0
- package/dist/agents/claude-gateway/terminal.js +250 -0
- package/dist/agents/claude-gateway/transcript.js +272 -0
- package/dist/agents/claude-gateway/types.js +14 -0
- package/dist/agents/claude-runner.js +6 -10
- package/dist/agents/codex-runner.js +9 -2
- package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
- package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
- package/dist/agents/gemini/index.js +51 -0
- package/dist/aun/aid/control-aid.js +52 -32
- package/dist/aun/group/invite-service.js +6 -36
- package/dist/aun/group/operations.js +6 -0
- package/dist/aun/msg/mention-schema.js +1 -1
- package/dist/aun/msg/p2p.js +31 -2
- package/dist/aun/msg/upload.js +126 -3
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +1175 -457
- package/dist/cli/ability-command.js +42 -0
- package/dist/cli/agent-command.js +20 -1
- package/dist/cli/agent-create.js +78 -18
- package/dist/cli/agent-template.js +5 -3
- package/dist/cli/agent.js +91 -0
- package/dist/cli/aun-commands.js +92 -34
- package/dist/cli/bench.js +5 -2
- package/dist/cli/config.js +22 -6
- package/dist/cli/daemon-commands.js +245 -101
- package/dist/cli/directory.js +6 -1
- package/dist/cli/ecmsg-gateway.js +11 -9
- package/dist/cli/index.js +30 -5
- package/dist/cli/init.js +39 -63
- package/dist/cli/managed-command-guard.js +3 -0
- package/dist/cli/menu-client.js +32 -7
- package/dist/cli/model.js +20 -5
- package/dist/cli/pay-command.js +30 -0
- package/dist/cli/provider-command.js +6 -2
- package/dist/cli/quota.js +89 -0
- package/dist/cli/restart-monitor.js +2 -2
- package/dist/cli/role.js +1 -0
- package/dist/cli/services-command.js +12 -9
- package/dist/cli/team-workspace-command.js +56 -2
- package/dist/cli/thread-command.js +78 -12
- package/dist/config/access-policy.js +16 -3
- package/dist/config/config-field-policy.js +88 -9
- package/dist/config/config-manager.js +97 -47
- package/dist/config/config-operation-service.js +22 -1
- package/dist/config/gateway-config.js +9 -8
- package/dist/config/owner-config.js +0 -16
- package/dist/config/peer-role-resolver.js +1 -7
- package/dist/config/providers-config.js +107 -20
- package/dist/config/providers-management.js +45 -21
- package/dist/config/resolved-config-op.js +4 -44
- package/dist/config/schema-migration.js +78 -5
- package/dist/config/schema-registry.js +52 -7
- package/dist/config-store.js +1309 -17
- package/dist/core/agent-application-service.js +220 -1
- package/dist/core/agent-ipc-registration.js +19 -2
- package/dist/core/agent-reload-coordinator.js +5 -0
- package/dist/core/agent-runtime.js +198 -54
- package/dist/core/auth/agent-delegation.js +14 -0
- package/dist/core/auth/delegation-authorization.js +33 -26
- package/dist/core/auth/operation-authorizer.js +16 -1
- package/dist/core/auth/operation-catalog.js +59 -7
- package/dist/core/baseagent-loader.js +30 -3
- package/dist/core/capability/capability-manager.js +16 -7
- package/dist/core/channel-runtime.js +4 -2
- package/dist/core/command/agent-control.js +20 -2
- package/dist/core/command/agent-template-menu.js +4 -3
- package/dist/core/command/cli-intent-parser.js +28 -0
- package/dist/core/command/command-handler.js +45 -2
- package/dist/core/command/menu-catalog.js +20 -4
- package/dist/core/command/menu-file-path.js +70 -0
- package/dist/core/command/menu-handler.js +97 -73
- package/dist/core/command/menu-protocol.js +29 -0
- package/dist/core/command/menu-query-batch.js +2 -2
- package/dist/core/command/private-mention-menu.js +71 -0
- package/dist/core/command/remote-shell.js +565 -0
- package/dist/core/command/slash-handler.js +17 -26
- package/dist/core/command/team-workspace-bootstrap.js +2 -1
- package/dist/core/command/topic-slash.js +7 -1
- package/dist/core/daemon-bootstrap.js +0 -4
- package/dist/core/daemon-control.js +58 -1
- package/dist/core/daemon-lifecycle.js +29 -7
- package/dist/core/evolagent-registry.js +18 -9
- package/dist/core/handoff/runtime.js +1 -1
- package/dist/core/host-snapshot.js +8 -3
- package/dist/core/initialization/service.js +3 -0
- package/dist/core/interaction-router.js +130 -0
- package/dist/core/ipc-registration.js +5 -0
- package/dist/core/memory/consolidation-context.js +2 -1
- package/dist/core/memory/consolidation.js +35 -64
- package/dist/core/message/aun-ipc-sender.js +213 -74
- package/dist/core/message/aun-request-registry.js +31 -0
- package/dist/core/message/contact-admission.js +91 -6
- package/dist/core/message/contact-pending-inbound.js +113 -0
- package/dist/core/message/contact-thread-approval.js +212 -0
- package/dist/core/message/im-renderer.js +40 -1
- package/dist/core/message/message-admission.js +5 -39
- package/dist/core/message/message-bridge.js +197 -45
- package/dist/core/message/message-log.js +32 -0
- package/dist/core/message/message-queue.js +102 -18
- package/dist/core/message/peer-mode.js +15 -4
- package/dist/core/message/response-engine.js +174 -26
- package/dist/core/message/send-options.js +37 -3
- package/dist/core/message/send-routing.js +11 -7
- package/dist/core/model/config-scope.js +6 -14
- package/dist/core/model/model-catalog.js +5 -5
- package/dist/core/model/model-diagnostics.js +19 -0
- package/dist/core/model/model-fallback.js +13 -2
- package/dist/core/ownership/owner-resolver.js +12 -86
- package/dist/core/pack-auth.js +7 -0
- package/dist/core/pack-install.js +1 -1
- package/dist/core/permission/ec-command-parser.js +288 -77
- package/dist/core/permission/protected-paths.js +64 -9
- package/dist/core/permission/services-path-acl.js +458 -0
- package/dist/core/permission/tool-policy.js +26 -10
- package/dist/core/relation/peer-identity.js +13 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
- package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
- package/dist/core/session/session-manager.js +47 -10
- package/dist/core/session/session-mapper.js +16 -0
- package/dist/core/skill/index-generator.js +2 -3
- package/dist/core/skill/switch-resolver.js +3 -0
- package/dist/core/task/task-recovery-service.js +1 -0
- package/dist/core/thread/command-parser.js +4 -1
- package/dist/core/thread/ipc-operation.js +4 -2
- package/dist/core/thread/thread-operation.js +25 -10
- package/dist/core/thread/thread-service.js +294 -55
- package/dist/core/thread/topic-id.js +67 -2
- package/dist/core/thread/types.js +15 -1
- package/dist/directory/owner-directory-admission.js +11 -8
- package/dist/directory/owner-directory-cache.js +19 -0
- package/dist/directory/owner-directory-markdown.js +1 -1
- package/dist/directory/owner-directory-policy.js +5 -30
- package/dist/directory/owner-directory-request-operation.js +5 -2
- package/dist/eck/kit-renderer.js +3 -2
- package/dist/eck/message-renderer.js +28 -5
- package/dist/ecweb/basic-settings-service.js +5 -9
- package/dist/ecweb/providers-service.js +4 -2
- package/dist/ecweb/runtime/supervisor.js +36 -8
- package/dist/event-center/center-config.js +9 -5
- package/dist/event-center/dispatcher.js +10 -1
- package/dist/event-center/ipc-operation.js +19 -0
- package/dist/event-center/registry.js +20 -5
- package/dist/event-center/runtime.js +10 -7
- package/dist/index.js +120 -41
- package/dist/ipc.js +83 -3
- package/dist/outputs/authorization.js +16 -0
- package/dist/outputs/cards.js +336 -0
- package/dist/outputs/events.js +3 -2
- package/dist/outputs/protocol.js +1 -0
- package/dist/outputs/service.js +2 -15
- package/dist/paths.js +48 -1
- package/dist/pay/command.js +38 -0
- package/dist/pay/protocol.js +136 -0
- package/dist/pay/runtime.js +188 -0
- package/dist/pay/service.js +384 -0
- package/dist/pay/store.js +81 -0
- package/dist/response-system/engines/v1/proactive-flow.js +29 -2
- package/dist/services/dispatcher.js +23 -5
- package/dist/services/host/main.js +388 -0
- package/dist/services/host/protocol.js +118 -0
- package/dist/services/host/resident.js +310 -0
- package/dist/services/host-client.js +386 -0
- package/dist/services/host-deploy.js +180 -0
- package/dist/services/host-launch.js +117 -0
- package/dist/services/host-recycle.js +203 -0
- package/dist/services/host-runtime.js +802 -0
- package/dist/services/idempotency.js +44 -86
- package/dist/services/index-generator.js +4 -3
- package/dist/services/index.js +204 -22
- package/dist/services/ipc-operation.js +288 -44
- package/dist/services/pack-manager.js +1 -0
- package/dist/services/script-runner.js +515 -83
- package/dist/services/service-payload.js +13 -7
- package/dist/services/validation.js +109 -4
- package/dist/stats/budget.js +1 -1
- package/dist/stats/model-resolver.js +2 -2
- package/dist/stats/quota-query.js +95 -0
- package/dist/trigger/application-service.js +6 -4
- package/dist/trigger/local-files.js +19 -9
- package/dist/trigger/scheduler.js +22 -12
- package/dist/trigger/script-sandbox.js +51 -8
- package/dist/utils/aid-bind.js +3 -0
- package/dist/utils/atomic-write.js +22 -8
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +173 -1
- package/dist/utils/logger.js +2 -2
- package/dist/utils/media-cache.js +190 -43
- package/dist/utils/npm-ops.js +43 -8
- package/dist/utils/restart-safety.js +14 -1
- package/dist/utils/system-memory.js +113 -25
- package/dist/utils/systemd-lifecycle.js +154 -0
- package/dist/utils/windows-shell-trust.js +7 -3
- package/dist/workbench/service.js +1 -1
- package/kits/docs/INDEX.md +3 -2
- 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
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/evolcore/INDEX.md +9 -6
- package/kits/docs/evolcore/agent.md +36 -1
- package/kits/docs/evolcore/aid.md +45 -3
- package/kits/docs/evolcore/config.md +5 -2
- package/kits/docs/evolcore/directory.md +8 -9
- package/kits/docs/evolcore/group.md +2 -1
- package/kits/docs/evolcore/memory-tags.md +2 -0
- package/kits/docs/evolcore/menu-client.md +3 -3
- package/kits/docs/evolcore/menu-protocol.md +7 -0
- package/kits/docs/evolcore/model.md +3 -0
- package/kits/docs/evolcore/msg.md +77 -10
- package/kits/docs/evolcore/pay.md +34 -0
- package/kits/docs/evolcore/provider.md +22 -1
- package/kits/docs/evolcore/quota.md +54 -0
- package/kits/docs/evolcore/role.md +3 -0
- package/kits/docs/evolcore/services.md +46 -18
- package/kits/docs/evolcore/stats.md +2 -0
- package/kits/docs/evolcore/thread-chain.md +2 -0
- package/kits/docs/evolcore/tool-authorization.md +10 -0
- package/kits/docs/evolcore/trigger.md +2 -0
- package/kits/rules/01-overview.md +11 -32
- package/kits/rules/02-navigation.md +7 -0
- package/kits/rules/06-channel.md +3 -3
- package/kits/schemas/_meta.json +38 -5
- package/kits/schemas/agent-config.schema.20.json +24 -0
- package/kits/schemas/agent-config.schema.21.json +974 -0
- package/kits/schemas/agent-config.schema.22.json +977 -0
- package/kits/schemas/agent-config.schema.23.json +958 -0
- package/kits/schemas/daemon.schema.10.json +373 -0
- package/kits/schemas/daemon.schema.9.json +12 -0
- package/kits/schemas/defaults.schema.7.json +472 -0
- package/kits/schemas/providers.schema.3.json +18 -2
- package/kits/schemas/relation-config.schema.13.json +289 -0
- package/kits/skills/.switches.json +17 -1
- package/kits/skills/ability/SKILL.md +229 -34
- package/kits/skills/ability/STRUCTURE.md +333 -0
- package/kits/skills/ability/references/cli.md +208 -0
- package/kits/skills/ability/references/development.md +107 -37
- package/kits/skills/ability/references/management.md +106 -46
- package/kits/skills/ability/references/runtime-protocol.md +65 -63
- package/kits/skills/agent-output-cards/SKILL.md +64 -0
- package/kits/skills/ec-group/SKILL.md +8 -6
- package/kits/skills/ec-group/TASK.md +186 -0
- package/kits/skills/ec-group/WORKLOG.md +180 -0
- package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
- package/kits/skills/ec-pay/SKILL.md +101 -0
- package/kits/skills/ec-pay/references/pay-cli.md +110 -0
- package/kits/skills/ec-provider/SKILL.md +58 -9
- package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
- package/kits/skills/ec-service-call/SKILL.md +135 -0
- package/kits/skills/ec-service-pack/SKILL.md +277 -0
- package/kits/skills/ec-trigger/SKILL.md +1 -1
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/workflow.md +46 -0
- package/kits/templates/roles/visitor.json +1 -0
- package/kits/templates/system-fragments/channel.md +13 -4
- package/kits/templates/system-fragments/commands.md +5 -3
- package/kits/templates/system-fragments/directory-contacts.md +3 -4
- package/kits/templates/system-fragments/reply.md +1 -0
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +27 -128
- package/kits/templates/system-fragments/venue.md +27 -0
- package/package.json +4 -5
- package/scripts/agent-template/inspect.mjs +79 -29
- package/scripts/agent-template/overlay.mjs +20 -2
- package/scripts/agent-template/shared/common.mjs +24 -6
- package/scripts/agent-template/shared/team-schema.json +23 -5
- package/scripts/agent-template/shared/template-contract.mjs +107 -17
- package/scripts/agent-template/shared/template-package.mjs +254 -29
- package/scripts/agent-template/shared/template-runtime.mjs +145 -2
- package/scripts/agent-template/shared/template.mjs +67 -9
- package/scripts/agent-template/team-pack.mjs +132 -41
- package/scripts/agent-template/team-preview.mjs +249 -5
- package/kits/docs/aun/ABILITY_CALLING.md +0 -280
- package/kits/docs/evolcore/ability.md +0 -185
- package/kits/skills/ability/references/calling.md +0 -56
- package/kits/skills/ability/references/contract-checklist.md +0 -37
- package/kits/skills/ability/references/recovery.md +0 -27
- /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)
|
|
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 =
|
|
12
|
+
export const IDEMPOTENCY_WINDOW_MS = 15_000;
|
|
10
13
|
function key(from, requestId) {
|
|
11
14
|
return `${from}\u0000${requestId}`;
|
|
12
15
|
}
|
|
13
|
-
/**
|
|
14
|
-
|
|
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 <
|
|
86
|
+
if ((record.expiresAt ?? record.ts + IDEMPOTENCY_WINDOW_MS) < now)
|
|
77
87
|
this.records.delete(entryKey);
|
|
78
88
|
}
|
|
79
89
|
}
|
|
80
90
|
/**
|
|
81
|
-
*
|
|
91
|
+
* 压实:丢掉已过期的行后整体重写。
|
|
82
92
|
*
|
|
83
|
-
*
|
|
84
|
-
*
|
|
85
|
-
* 又给文件大小设了自然上界。归档目标与 `removePack` 的日志归档同在 `logs/` 下。
|
|
93
|
+
* 窗口只有 15 秒,所以这里不再按月归档——一份文件里几乎不可能同时存在两个月的
|
|
94
|
+
* 记录。剩下的问题只是 append-only 会让文件一直变长,按行数触发即可。
|
|
86
95
|
*
|
|
87
|
-
*
|
|
88
|
-
* 定时器只会空转。
|
|
96
|
+
* 失败不影响去重:老文件继续用,下次再试。
|
|
89
97
|
*/
|
|
90
|
-
|
|
91
|
-
if (
|
|
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
|
-
|
|
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
|
-
|
|
106
|
-
|
|
107
|
-
this.
|
|
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
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
this.
|
|
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.
|
|
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
|
|
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 ??
|
|
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('');
|